================================================================
     TE 产品文档检索 浏览器插件 — 部署说明书  （v0.3.8）
================================================================

这个插件的用途：
  在浏览器里输入 TE 产品编号，自动帮你下载产品的
  「产品图纸」「产品规格」和「CAD文件 (STP)」文档；
  输入 108-/114-/501-/411- 开头的文档编号，会自动改用
  TE 官网「按文档编号搜索」通道，列出并下载全部 PDF 文档。
  勾选「产品图纸」但该料号没有图纸时，插件会自动把料号换算成
  文档编号，再去官网找一次（二次检索）。
  所有文件默认保存到「下载目录\TE Web Download\<编号>\」，
  保存路径与重名处理方式可在插件顶部右侧的「设置」里修改。
  不需要安装任何编程环境，不需要联网到某个服务器，
  只要你的电脑能正常上网、能打开 te.com.cn 即可使用。


----------------------------------------------------------------
一、你需要准备的东西（全部已经在「TE产品文档检索」文件夹里）
----------------------------------------------------------------
  1. manifest.json
  2. background.js
  3. popup.html
  4. popup.css
  5. popup.js
  6. icons 文件夹（里面有 4 张图标）
  7. 本文档（部署说明书.txt）
  重要：请保证上面这些文件和文件夹“原样在一起”，不要
        删改、不要只复制其中几个文件。


----------------------------------------------------------------
二、安装插件（只需做一次）
----------------------------------------------------------------
  第 1 步：打开你电脑上的浏览器
      - 如果你用 Google Chrome：双击桌面上的 Chrome 图标
      - 如果你用 Microsoft Edge：双击桌面上的 Edge 图标
      （两个浏览器都可以，以下步骤几乎一模一样）

  第 2 步：打开“扩展程序”管理页面
      在浏览器最上方的“网址输入框”里，删除原有文字，
      完整输入下面这一行，然后按回车键：
          chrome://extensions
      （如果你用的是 Edge 浏览器，就输入：edge://extensions）

  第 3 步：打开“开发者模式”
      页面右上角有一个写着“开发者模式”的开关，
      用鼠标点一下，让它变成“打开/蓝色”状态。

  第 4 步：加载插件文件夹
      页面左上角（或左上方）会出现一个按钮，
      写着“加载已解压的扩展程序”，用鼠标点它。
      → 在弹出的窗口里，找到并“选中”这个文件夹：
            TE产品文档检索
      （注意：选这一整个文件夹，不要点进去只选某一个文件，
        选完后点窗口右下角的“选择文件夹”按钮）

  第 5 步：确认安装成功
      页面上会出现一个卡片，名字是“TE 产品文档检索”，
      图标是一个橙色的“TE”方块。这就装好了！

  小提示：如果这台电脑以前装过旧版本，请先把旧版卡片
          点“移除”，再按上面步骤加载新版，避免冲突。


----------------------------------------------------------------
三、怎么使用
----------------------------------------------------------------
  1. 点击浏览器右上角的拼图图标（🧩，叫“扩展程序”按钮），
     在里面找到“TE 产品文档检索”，点击它，弹窗就出来了。
     （如果工具栏上已经能看到橙色 TE 图标，直接点那个图标也行）

  2. 在弹窗里勾选你想要下载的类型（可以多选）：
         ☑ 产品图纸      （TE 官方「产品图纸」区块，PDF）
         ☐ 产品规格      （TE 官方「产品规格」区块，PDF）
         ☐ CAD文件(STP)  （只下载后缀为 .3d_stp.zip 的文件）
     勾选状态会被记住，下次打开还是你上次的选择。

  3. 在输入框里输入产品编号，每行一个，例如：
            5-928999-1
            175266-7
     然后点“检索文档”按钮。

  4. 稍等几秒，界面会列出每个编号找到的文件，
     每个文件左上角有一个蓝色标签，标明它在 TE 官网
     属于哪个区块（产品图纸 / 产品规格 / CAD文件(STP)）。
     点“下载”即可保存，同一个编号有多份文件时，
     还可以点“全部下载”一次全存。

  5. 【保存位置与重名处理（v0.3.8 更新）】
     所有文件默认保存到：

         下载目录\TE Web Download\<编号>\<文件名>

     - 每个产品编号/文档编号单独一个文件夹，
       文件夹名就是编号本身。
     - 二次检索找到的文件，也归到产品编号文件夹里。
     - 点击插件顶部右侧的「设置」（金色文字），可打开
       设置面板：
         · 默认保存路径：显示当前子文件夹名，可在输入框
           修改（比如改成 TE Web Download/2026-10 按
           月份分层），点「保存」生效。
         · 重名自动加 (1) 后缀：两种模式可自由切换
           （选择会记住）：
             ○ 重名文件夹（默认）—— 同一个编号第二次及
               以后再下载时，自动放进「编号 (1)」「编号 (2)」
               新文件夹里，文件名保持官网原名不变。
             ○ 重名文件 —— 所有文件都放进同一个编号文件夹，
               遇到同名文件时在文件名后自动加 (1)。
     - 想改“下载根目录”（比如从 C 盘改到 D 盘），
       点击设置面板里的“浏览器下载设置”，在浏览器设置里改，
       插件会自动跟随。
     - 例：你的电脑默认保存到
         C:\Users\KK\Downloads\TE Web Download\1897009-2\…
       其他电脑则保存到该电脑浏览器设置的下载目录下，
       文件夹不存在时浏览器会自动新建。

  6. 【下载全部文档】
     “清空”按钮右边是“下载全部文档”按钮：
     - 检索完成且找到文档后，按钮会变成绿色，表示可以下载；
     - 点一下，本次检索结果显示的所有文档全部自动下载
       （每个文件按各自的编号归到对应文件夹），按钮上会
       显示下载进度，例如“下载中 3/6”，完成后显示
       “已完成（6/6）”。
     注意：第一次使用时浏览器可能询问“是否允许下载
     多个文件”，点“允许”即可。

  7. 【文档编号检索】108-/114-/501-/411- 开头的编号
     这类编号是 TE 的“档案编号”（文档编号），不是产品料号。
     插件会自动识别（无需任何设置），改走 TE 官网
     “工具及资源 → 按文档编号搜索”通道：

       - 检索时插件会在后台自动打开官网搜索页，
         填入编号、点“搜索”，读取结果后自动关闭该页面，
         全程无需你操作，也无需登录（访客模式即可）。
       - 结果只保留 PDF 格式的文档；每个文件下方会显示
         官网标注的“文档类型”（如 Application Specification）。
       - 这类编号不受上方“文档类型”勾选影响，全部列出。
       - 一个输入框里可以混着写产品编号和文档编号，
         每行一个，各自走各自的通道，结果合并显示。
       - 注意：材料声明类文档官网要求登录后才能搜索，
         未登录时这类文档不会出现，属正常现象。

  8. 【二次检索】勾选「产品图纸」但料号没有图纸时
     有些料号在官网产品页上确实没有产品图纸，但它的图纸
     是以「文档编号」的形式存在的。插件会自动帮你再找一次：

       - 触发条件：你勾选了「产品图纸」，且该料号产品页
         没找到产品图纸。（未勾选产品图纸时不会触发）
       - 换算公式：把料号“掐头去尾”得到文档编号
           · 2-2378904-1  →  2378904   （去掉开头的 2- 和结尾的 -1）
           · 1897009-2    →  1897009   （去掉结尾的 -2）
           · 175266-7     →  175266
       - 然后用换算出的编号去官网文档编号通道再搜一次。
       - 二次检索到的文件，类别标签会显示为
         「产品图纸（文档编号）」，方便你识别来源。
       - 如果二次检索也没找到，就按“未找到产品图纸”显示。
       - 说明：命中多个文档时只保留 PDF 格式；如果只命中
         一个文档，则不限格式直接列出。

  9. 【最近检索 的用法】
     弹窗底部有“最近检索”，会记录你查过的编号，点一下即可
     回填到输入框。它的右侧有两个勾选，用来控制“点击编号后
     往输入框里怎么写”：

         ○ 覆盖（默认）—— 点编号后，输入框里的内容会被这个
                            编号「整个替换掉」。
         ○ 叠加         —— 点编号后，输入框会「另起一行」追加
                            这个编号，原来已经写好的编号不会被
                            冲掉。适合连续挑几个编号一起检索。
                            例如输入框是空的：
                              先点 5-928999-1 → 输入框第 1 行 5-928999-1
                              再点 1897009-2  → 输入框第 2 行 1897009-2
                            同一个编号重复点击不会重复添加。

     两个勾选的选择同样会被记住。


----------------------------------------------------------------
四、常见问题（小白必看）
----------------------------------------------------------------
  Q1：菜单里找不到“TE 产品文档检索”图标？
      点浏览器右上角的拼图图标（🧩），在弹出的列表里
      就能看到它；也可以用旁边的“图钉”把它钉到工具栏上。

  Q2：图标还是显示成灰色的“T”？
      这是浏览器缓存。关闭浏览器（右上角 × 关掉），
      重新打开一次，图标就会变成橙色的“TE”。

  Q3：点了下载没反应？
      看看浏览器底部有没有弹出“是否允许下载多个文件”
      的提示，点“允许”。文件会存到“下载/TE Web Download/<编号>/”里。

  Q4：文件没有被归进编号文件夹，直接落在下载根目录？
      这是被其他带下载功能的浏览器插件（如“Marvis 浏览器
      插件”等下载管理类扩展）拦截了文件名。v0.3.8 已通过
      后台文件名认领机制修复，一般不会再出现；若仍遇到，
      可临时停用其他下载类扩展后重试。

  Q5：提示“产品页请求失败 / 未找到文档”？
      多半是编号输错了，或者这个编号在 te.com.cn 上
      确实没有该类型文档。换个正确编号再试。
      提示：产品图纸 与 产品规格 是两种不同的文档，
            有些编号只有规格、没有图纸，这是正常的。

  Q6：我要拷给同事/换另一台电脑用？
      直接把“TE产品文档检索”整个文件夹（或一个 zip 包）
      拷过去，按本说明“第二步”重新加载一次即可。

  Q7：更新插件后，之前勾选的内容会丢吗？
      不会。文档类型、覆盖/叠加、保存路径、重名处理模式
      都存在浏览器本地，更新插件后依然保留。

  Q8：更新到 v0.3.5 时浏览器弹出“已请求其他权限”？
      正常现象。文档编号检索需要“读取标签页”和
      “在网页中执行脚本”两项新权限（只用于 te.com.cn），
      点“接受”即可，之后照常使用。

  Q9：文档编号检索一直转圈/提示未找到搜索框？
      可能是网络较慢，官网页面没加载完。稍后重试一次；
      若仍失败，手动打开官网确认能正常访问后再试。


----------------------------------------------------------------
五、小提醒
----------------------------------------------------------------
  - 每次检索请尽量“少量、正常速度”，不要一次粘几百个编号
    猛刷，避免被网站临时限流。
  - 本插件只在你自己的浏览器里工作，不会把你的数据上传
    到任何服务器，可以放心使用。
  - 请遵守目标网站的使用条款，低频、合理使用。

祝你使用顺利！
