diff --git a/docs/internal-extension-distribution.md b/docs/internal-extension-distribution.md
index ee34115..c82cba2 100644
--- a/docs/internal-extension-distribution.md
+++ b/docs/internal-extension-distribution.md
@@ -76,6 +76,20 @@ The pipeline uses the tag as the release version. Recommended format: `0.MMDD.N`
 5. Select the unzipped `dist/` folder.
 6. Confirm the extension ID is `pkjopdibdnomhogjheclhnknmejccffg`.
 
+## One-Time Bridge Upgrade
+
+Some coworkers may still be using an older unpacked build whose popup cannot read the COS update manifest and only shows:
+
+- `暂时无法检查更新`
+
+For those users, ask them to do one manual bridge upgrade with the newest ZIP:
+
+1. Download the newest `star-chart-search-enhancer-internal.zip`.
+2. Unzip it and get the new `dist/` folder.
+3. Re-load that `dist/` folder in `chrome://extensions`.
+
+After this one-time bridge upgrade, future updates should continue using the same `dist/` layout.
+
 ## Notes
 
 - Keep `.local/extension-key.pem` private and backed up internally.
diff --git a/docs/【给同事】从Git下载使用说明.md b/docs/【给同事】从Git下载使用说明.md
index 339237b..0f097ca 100644
--- a/docs/【给同事】从Git下载使用说明.md
+++ b/docs/【给同事】从Git下载使用说明.md
@@ -111,6 +111,22 @@ git pull
 - 然后重新点击 **"加载已解压的扩展程序"**
 - 再次选择 `dist` 文件夹
 
+## ♻️ 老用户一次性升级说明
+
+如果你之前已经装过比较早的旧版本，而且插件弹窗里一直显示：
+
+- `暂时无法检查更新`
+
+那通常说明你本地还是旧的更新机制，建议先手动完成一次升级：
+
+1. 先获取我发出的最新压缩包
+2. 解压后得到新的 `dist` 文件夹
+3. 打开 `chrome://extensions`
+4. 删除旧插件，或重新执行一次 **"加载已解压的扩展程序"**
+5. 重新选择新的 `dist` 文件夹
+
+完成这一次后，后续再更新时，就可以继续沿用统一的 `dist` 目录方式。
+
 ---
 
 ## ❓ 常见问题
@@ -124,6 +140,9 @@ A: 请确认下载的是最新版本，可以重新执行 `git pull` 并重新
 **Q: 加载后扩展 ID 不对？**
 A: 请检查是否选择了 `dist` 文件夹，而不是外层文件夹。
 
+**Q: 我已经在用这个插件了，还需要再用压缩包更新一次吗？**
+A: 不一定。只有那些当前弹窗仍然只显示 `暂时无法检查更新` 的旧用户，才建议手动用最新压缩包重新装一次 `dist` 来完成过桥升级。已经能正常发现新版本的同事，继续按普通更新流程走即可。
+
 ---
 
 ## 📞 需要帮助？
diff --git a/docs/【超简单版】插件安装使用指南.md b/docs/【超简单版】插件安装使用指南.md
index cfd4689..66a14e4 100644
--- a/docs/【超简单版】插件安装使用指南.md
+++ b/docs/【超简单版】插件安装使用指南.md
@@ -140,6 +140,24 @@ https://xingtu.cn/ad/creator/market
 - 然后重新点击 **"加载已解压的扩展程序"**
 - 再次选择新解压出来的 `dist` 文件夹
 
+## ♻️ 老用户一次性升级说明
+
+如果你之前安装的是较早的旧版本，并且插件弹窗里一直显示：
+
+- `暂时无法检查更新`
+
+那通常说明你本地还在使用“旧更新机制”的插件包。
+
+这种情况下，需要**手动用一次最新压缩包升级**：
+
+1. 下载最新的 `star-chart-search-enhancer-internal.zip`
+2. 解压后得到新的 `dist` 文件夹
+3. 打开 `chrome://extensions`
+4. 删除旧插件，或重新点击 **"加载已解压的扩展程序"**
+5. 重新选择新的 `dist` 文件夹
+
+完成这一次“过桥升级”后，后面再看到新版本时，就可以继续按统一的 `dist` 更新方式操作。
+
 ---
 
 ## ❓ 常见问题
@@ -156,6 +174,9 @@ A: 检查浏览器的下载列表，文件可能已经下好了
 ### Q: 不小心把文件夹删了？
 A: 重新解压压缩包，然后到 `chrome://extensions` 点"重新加载"
 
+### Q: 我已经在用插件了，还需要再用一次压缩包更新吗？
+A: 如果你当前弹窗能正常显示 `发现新版本`，就不需要额外做特殊处理，按普通更新步骤走即可。如果弹窗一直只显示 `暂时无法检查更新`，建议手动用最新压缩包重新安装一次 `dist`，完成一次性升级。
+
 ---
 
 ## ✅ 每日使用 checklist