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

这个插件的用途：
  在浏览器里输入 TE 产品编号，自动帮你下载产品的
  「产品图纸」「产品规格」和「CAD文件 (STP)」文档；
  输入 108-/114-/501-/411- 开头的文档编号，会自动改用
  TE 官网「按文档编号搜索」通道，列出并下载全部 PDF 文档。
  勾选「产品图纸」但该料号没有图纸时，插件会自动把料号换算成
  文档编号，再去官网找一次（二次检索）。
  同时识别产品状态（有效/试产…），显示在结果编号右侧；
  显示首张产品图的缩略预览，点击缩略图可放大查看全图，
  放大后可左右切换查看该编号的全部产品图（也支持键盘 ←/→），
  并可下载"当前这张"或把该编号的全部产品图打包成
  PIC_<编号>.ZIP（压缩包内命名为 编号_P1、_P2…，连续编号）。
  ★「下载产品图数量」可设置：
     · 首张（默认）→ 每个编号只下载第 1 张，**不打包、直接下载**，
                     文件名就是「编号.扩展名」（不带 _P 序号）；
     · 全部        → 每个编号的全部产品图打包为 PIC_<编号>.ZIP。
  所有文件默认保存到「下载目录\TE Web Download\<编号>\」，
  保存路径、重名处理、下载产品图方式与数量、预览开关，都可在
  插件顶部右侧的「设置」里修改。
  （v0.5.3 新增）关闭弹窗再打开时，会自动保留上一次的检索结果
  和输入内容；只有点「清空」才会真正清空。
  不需要安装任何编程环境，不需要联网到某个服务器，
  只要你的电脑能正常上网、能打开 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”方块。这就装好了！

  小提示：如果这台电脑以前装过旧版本，请先把旧版卡片
          点“移除”，再按上面步骤加载新版，避免冲突。
          （v0.5.1 及以后各版的文件名完全相同，不移除旧版
            会继续运行旧代码。）


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

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

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

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

  4a.【产品状态徽章（v0.5.0 新增）】
     每个编号的标题右侧会显示官网标注的产品状态，
     例如绿底的「有效」、灰底的「试产」。官网没有状态
     时不显示，不影响文档下载。状态与文档解析共用一次
     页面请求，不会因此变慢。

  4b.【产品图预览与打包（v0.5.0 新增，v0.5.1 调整命名）】
     编号标题右侧（开启预览时）会显示该编号第一张产品图
     的小缩略图；点击缩略图会弹出灯箱显示该图的完整版，
     灯箱内提供「下载此图」按钮，可单独下载当前这一张
     （保存为 下载目录\TE Web Download\<编号>\编号_P<序号>.png，
     与压缩包内命名一致）。关闭灯箱：点 ✕、点灯箱外的
     空白处或按 Esc。缩略图不再直接触发打包下载。
     每个编号的图片行（编号下方）有一个按钮：

       「下载产品图(N张/ZIP)」
         把该编号的全部产品图打包成一个压缩包，保存为
             下载目录\TE Web Download\<编号>\<编号>.ZIP
         压缩包里的文件名依次为：
             编号_P1.png、编号_P2.png、编号_P3.png …
         （序号从 1 起，连续编号、不跳号）

       「未发现产品图」
         如果该编号官网没有产品图，按钮位置会变成
         灰色文字「未发现产品图」，表示无图可打包。

     下载按钮区（“下载全部文档”/“清空”所在的两行按钮）：
       · 独立模式下多出一个「下载全部产品图」按钮，
         点一次把本次检索到的所有编号各打成一个
         <编号>.ZIP；检索到有图的编号后该按钮变绿并显示
         总张数；一个产品图都没有时按钮置灰、显示
         「未发现产品图」不可点击。
       · 关联模式下「清空」按钮会移到「检索文档」右侧，
         「下载全部文档」独占一整行，文案变为
         「下载全部文档（包含产品图）」，点击后先下载文档、
         再自动接着打包各编号的产品图。
       · 两种模式在「设置 → 下载产品图」里切换。
       · 「下载全部文档」「下载全部产品图」全部下载成功后，
         按钮会置灰冻结为「已完成（n/N）」，直到下次检索或
         点「清空」才复位；个别失败时按钮恢复可重试。
     说明：产品图打包失败不会影响文档的下载结果，
           两者分别统计。

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

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

     - 每个产品编号/文档编号单独一个文件夹，
       文件夹名就是编号本身。
     - 二次检索找到的文件，也归到产品编号文件夹里。
     - 点击插件顶部右侧的「设置」（金色文字），可打开
       设置面板，面板分四块区域（自上而下）：
         · 上块（深色区）：默认保存路径 —— 标题橙色加粗，
           显示当前子文件夹名，右侧有「修改」按钮，
           点「修改」才展开输入框（比如改成
           TE Web Download/2026-10 按月份分层），
           点「保存」生效；底部附说明文字。
         · 第 2 块（浅色区）：重名自动加 (1) 后缀 —— 两种
           模式同一行可自由切换（选择会记住）：
             ○ 重名文件夹 —— 下载前会实时检查
               TE Web Download 里该编号的文件夹是否还存在：
               若不存在（含你已手动删除的情况）则直接用
               「编号」；仍存在才依次用「编号 (1)」「编号 (2)」。
               文件本身保持官网原名不变。
             ○ 重名文档 —— 所有文档都放进同一个编号文件夹，
               下载前会检查该编号文件夹里是否已有同名文档：
               没有则用官网原名；已有则自动加（1）（2）（3）……
               后缀（例：ENG_CD_929454_C29 (1).pdf）。
               判重只在本编号文件夹内进行，不会受其他编号影响。
         · 第 3 块（浅色区，v0.5.2 新增）：下载产品图方式（单行显示）——
              ○ 独立按钮 —— 下载按钮区显示独立的
                「下载全部产品图」按钮，点它一次打包全部编号。
              ○ 关联 下载全部文档 按钮 —— 隐藏独立按钮，
                点「下载全部文档」时先下载文档、再自动接着
                打包各编号的产品图（一次点击两件事都做完）。
           切换即时生效，选择会被记住。
         · 第 4 块（浅色区）：显示产品图预览 ——
              ○ 是 —— 结果卡片编号右侧显示该编号
                首张产品图的缩略图（点击查看大图并可单独下载）。
              ○ 否 —— 不显示缩略图。
           v0.5.2 起，设置面板所有「（默认）」字样已移除，
           各块标题为橙色加粗，默认勾选不变。
           缩略图恒用官网最轻的版本（实测约 1.9 KB），
           不会拖慢检索。切换即时生效，选择会被记住。
     - ★ 重要提醒（v0.4.2）：本插件的「重名文件夹 / 重名文档」
       判重由插件自己完成，**不依赖浏览器**。但如果你的浏览器里
       同时装了**其他带下载管理功能的扩展**（例如「Marvis 浏览器
       插件」等），它们会抢走下载文件名的决定权，从而**破坏文件夹
       归类与重名后缀**，表现为「设置了却不生效、时对时错」。
       遇到这种情况，请在浏览器扩展管理页里**停用其他下载类扩展**，
       再重试即可。（本插件已尽力对抗，但浏览器规定多个扩展同时
       声明文件名时以最后一个为准，插件无法强制胜过对方。）
     - 想改“下载根目录”（比如从 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 已通过
      后台文件名认领机制修复，一般不会再出现；若仍遇到，
      可临时停用其他下载类扩展后重试。
      ★ 特别提醒（v0.4.2）：如果你发现「设置了重名文件夹却按
        重名文档执行」、或文件夹归类/后缀时对时错，几乎可以
        确定是同类问题。排查方法：打开浏览器扩展管理页
        （edge://extensions 或 chrome://extensions），逐个
        **临时停用**带下载管理功能的扩展（尤其名字里带
        「下载」「Download」「Marvis」的），每停用一个就重新
        下载一次。停到哪一个之后立刻正常了，那一个就是元凶。
        本插件无法在代码层面强制胜过它——浏览器规定多个扩展
        同时决定文件名时以最后一个为准。

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

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

  Q7：更新插件后，之前勾选的内容会丢吗？
      不会。文档类型、覆盖/叠加、保存路径、重名处理模式、
      产品图下载方式、产品图预览开关，都存在浏览器本地，
      更新插件后依然保留。
      （v0.4.1 起：重名处理模式的切换会“立即生效”，
        v0.5.1 起：产品图下载方式与预览开关同样“立即生效”，
        都不必等它存盘完成即可放心下载。）

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

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

  Q10：我明明选了「重名文件夹」，下载时却按「重名文档」执行？
      v0.4.1.1 已根治。原因是「恢复上次偏好」与「本次点选」之间存在
      时序竞争：打开弹窗时，插件会异步去读取你上次保存的模式并回填；
      如果你读取得比较慢，而这个回填动作发生在你点选【之后】，
      它就会把你刚选的模式悄悄改回上次的旧模式——于是界面显示的是
      你选的、实际执行的却是旧的（且因回填快慢不同而时对时错）。
      现在的做法是：一旦你手动点选过，任何"恢复旧偏好"的动作都会被
      直接拒绝（连内存里的决策值也不允许被回填覆盖），因此你的选择
      永远优先。如仍遇到，关掉弹窗重新打开一次即可。

  Q11：产品图压缩包里为什么是 编号_P1、_P2 这样的名字？
      v0.5.1 起统一改为这种命名：以产品编号打头，后面跟 _P1、
     _P2…（按官网 t1→tN 的原始顺序，从 1 起连续编号、不跳号）。
     这样文件名一眼可知属于哪个编号、是第几张，排序也整齐。
     压缩包内的扩展名沿用官网图片地址的后缀（多为 .png）。

  Q12：为什么有的编号显示「未发现产品图」？
     说明该编号在 TE 官网上确实没有产品图片（不是插件出错）。
     此时不能打包，按钮或提示位置会显示灰色文字「未发现产品图」。
     这与文档是否有图纸无关——有的编号有图纸但没产品图，
     有的编号有产品图但没图纸，都是正常现象。

  Q13：「下载全部产品图」按钮没有出现 / 变成了灰色？
     两种情况：
       ① 你在「设置 → 下载产品图」里选了
          「关联『下载全部文档』」——此时独立按钮会被隐藏，
          改为点「下载全部文档」时自动一并打包产品图。
          想让它出现，切回「独立按钮」即可。

       · v0.5.2.2 布局微调：
         独立模式按钮区为两行 —— 第一行「检索文档 | 清空」，
         第二行「下载全部文档 | 下载全部产品图」；
         关联模式为「检索文档 | 清空」+「下载全部文档（包含产品图）」独占一行。
       · 设置面板标题用色调整为亮橙（黄相更重），
         修正常见的"橙色目视像红色"的问题。
       ② 按钮显示「未发现产品图」并置灰——说明本次检索到的
          编号都没有产品图，无图可打包。

  Q14：产品图预览缩略图显示为空白或不见了？
     两种情况：
       ① 你在「设置 → 显示产品图预览」里选了「否」；
       ② 该图片临时加载失败（网络波动），插件会自动把它隐藏，
          不影响「下载产品图」功能，重试或重开弹窗即可。

  Q15：点击缩略图为什么不再直接打包下载 ZIP？
       v0.5.2 起，点击缩略图改为弹出灯箱查看该图完整版；
       想下载图片时在灯箱内点「下载此图」（只下载这一张，
       自动归档到该编号文件夹，命名 编号_P序号）。
       打包整包请用「下载产品图(N张/ZIP)」按钮或
       「下载全部产品图」。批量按钮下载成功后会置灰冻结，
       下次检索或点「清空」后恢复。

  Q16：打开插件就弹出一个白色方块（图片处显示"产品图"占位、
       还有个「下载此图」按钮），还关不掉？
       这是 v0.5.2 的一个缺陷，v0.5.2.1 已修复。
       原因：产品图灯箱自身用了 ID 级样式声明 display，优先级
       高于通用的 .hidden 隐藏规则，导致"该隐藏却没隐藏"，
       灯箱从弹窗打开起就常驻在界面上。
       修复：给 .hidden 加 !important（隐藏语义最高优先），
       并给灯箱补一条显式隐藏规则，今后同类问题不会再出现。
       如果你遇到该现象，请把插件更新到 v0.5.2.1 或更高版本。
     缩略图用的是官网最轻的图片版本（约 1.9 KB），
     不会明显影响弹窗速度。

  Q17：为什么关闭插件再打开，上次搜到的东西还会在？怎么彻底清掉？
       （v0.5.3 新增功能）这是有意设计的。
       以前只要鼠标点到弹窗外面的空白处，弹窗就会关闭，再打开时
       上一次的结果全部消失，需要重新输编号、重新检索一遍，很麻烦。
       v0.5.3 起，插件会把"上一次的检索画面"临时记在浏览器的
       会话内存里（chrome.storage.session），所以你再次打开弹窗时
       会自动把上次的结果、输入框内容、按钮状态原样恢复，
       并在状态栏提示一句「已恢复上次检索结果」。
       想真正清空时，点界面上的「清空」按钮即可 —— 它会同时
       清掉画面和这份临时记忆，之后再打开就是干净的空白界面。
       两点补充说明：
       · 这份记忆只存在"本次浏览器会话"里，浏览器一关就自动消失，
         不会长期占用磁盘，也不会跨浏览器重启复活；
       · 恢复画面不需要联网（检索结果是本地缓存的），断网也能看到
         上次的结果列表（但点下载仍需联网）。

  Q18：恢复上次结果时，会不会盖掉我正在操作的内容？
       不会。插件带了"用户操作守卫"：如果在你打开弹窗后、恢复动作
       落地前，你已经自己点了「检索文档」或「清空」，插件会放弃
       这次恢复，绝不覆盖你刚做的事。

  Q19：「下载产品图数量」的「首张」和「全部」到底有什么区别？
       这是 v0.5.4 新增的设置，默认是「首张」。
       · 首张：每个产品编号只下载**第 1 张**产品图，而且**不打包**，
         直接下载一张图片文件，文件名就是「编号.扩展名」
         （例如 1488991-1.png），**不带 _P1 后缀**。
       · 全部：每个编号的全部产品图打包成一个压缩包，命名规则为
         PIC_<编号>.ZIP（例如 PIC_1488991-1.zip），
         包内文件名为 编号_P1、_P2…（连续编号）。
       该设置会同时作用于两个批量入口：
         「下载全部产品图」按钮 和
         「下载全部文档和产品图」按钮（集成模式）。
       注意：无论选「首张」还是「全部」，在放大图灯箱里点
       「下载产品图(ZIP)」时**始终是压缩包**（这是刻意保留的，
       方便对某一个编号整包下载）。

  Q20：为什么按钮上的文字带了括号数字？
       这是 v0.5.4 的新提示，方便你下载前就知道量级：
       · 独立按钮模式：「下载全部文档（3 份）」——括号里是
         本次检索到的文档总数；
       · 集成按钮模式：「下载全部文档和产品图（文档3份/图片5张）」
         ——同时给出文档份数与产品图张数。

  Q21：放大产品图后，能看这个编号的其他图片吗？
       可以。v0.5.4 起，点击缩略图进入放大视图后：
       · 图片左右两侧各有一个「‹」「›」按钮，点击可切换上一张/下一张；
       · 也可以直接用键盘的 ← / → 方向键切换；
       · 标题会显示「编号 · 第 n / N 张产品图」；
       · 点「下载此图」会下载**当前显示的这一张**，
         文件名保留序号后缀（编号_P1、编号_P2…），不打包；
       · 点右侧的「下载产品图(ZIP · N张)」则把该编号的全部产品图
         打包为 PIC_<编号>.ZIP。
       （卡片上的「下载产品图(N张/ZIP)」按钮已在 v0.5.4 移入放大视图，
         卡片区更简洁；卡片内只保留缩略图 + 无图时的灰字提示。）

  Q24：放大视图里，为什么以前只有第 1 张清晰、第 2 张之后发虚？（已修复）
       · 现象：点开产品图放大后，第 1 张很清楚，往后翻的第 2、3、4… 张明显糊。
       · 原因：官网产品页对第 1 张图给出的是"高清版"（2880×2160），
         但对第 2 张及之后只给出"缩略版"（只有 100×75 像素）。
         放大视图把小缩略图等比拉伸到全屏大小，像素不够自然就发虚。
       · v0.5.6 修法：插件把图片地址里的"版本段"统一改写成高清版地址
         （实测每一张都能取到 2880×2160 的原图），放大时优先加载高清原图；
         为保证打开瞬间就有画面，先显示小图占位，高清图加载完成后再无缝替换。
         另外增加了"帧令牌"保护：快速左右连续切换时，晚到的高清图不会错写到
         当前这一张上（杜绝串图）。
       · 附带好处：这条高清通道也用于"首张直下"和"打包下载"，所以
         你下载到本地的产品图同样是最清晰的版本（不再是 100×75 的小图）。
       · 小提示：高清原图单张约 55~250 KB，首次加载会比小图稍慢一点点，
         但一经缓存后续翻页都是秒出。
  Q23：弹窗可以调大吗？为什么放大页的左右切换按钮以前会跑出窗口？
       · 弹窗尺寸上限：浏览器对插件弹窗（Manifest V3）强制限制最大 800×600 像素，
         插件无法突破。v0.5.5 已把弹窗宽度由 380px 加宽到 520px，并设置高度上限
         580px（内容多时在弹窗内滚动），加宽与加长同时生效，整体比例更协调、不再显得"扁"。
       · 切换按钮跑出窗口的原因：放大视图里"左按钮 + 间隙 + 图片300px + 间隙 + 右按钮"
         共需 368px，而旧弹窗宽 380px 减去遮罩内边距只剩 352px，右侧按钮就被挤出去了。
       · v0.5.5 修法：切换按钮改为固定在遮罩左右两侧（不再参与宽度分配），
         中间的图片显示框自动占满剩余空间；图片改用等比缩放（contain）填满显示框。
       · 副作用（好的）：第 2 张及之后的产品图过去因为原图较小而显示得偏小，
         现在统一按显示框等比放大，和首张一样大。
  Q22：下载按钮上的「组」是什么意思？按钮字样会变吗？
       v0.5.5 起，下载按钮的字样会跟随「下载产品图数量」设置自动变化：
       · 独立按钮：
         - 选「首张」→「下载首张产品图（N 组）」
         - 选「全部」→「下载全部产品图（M 张/N 组）」
       · 集成按钮（下载全部文档和产品图）：
         - 选「首张」→「下载全部文档和产品图（文档X份/N组+图片N组）」
         - 选「全部」→「下载全部文档和产品图（文档X份&图片M张/N组）」
       其中「N 组」= 本次检索结果里有产品图的编号个数（一个编号算一组）。
       切换设置后按钮字样会立即刷新，不用重新检索。
       另外，顶部提示语已改为「输入产品编号/文档编号」。


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

祝你使用顺利！
