dsh plugin market 可更新徽标一直亮：更新失败、索引滞后与重启循环的排查与恢复顺序

徽标亮了一周，点了更新，重启，还是亮——这是更新类问题里最让人烦躁的循环：你做了动作，界面却不给你结果。 在 dsh plugin market 里，可更新徽标只说明「检测到新版本」，不说明更新成功，也不说明版本真的变了（2.2.5 索引）。这篇按恢复优先级排：先分清三种成因，再决定是重启、回退还是刷新索引。更新入口在 DSH Plugin Hub 的已安装列表与市场卡片上。

徽标亮的三种原因：DSH plugin 真更新、旧索引与版本锁定

徽标亮不等于更新失败：它可能是真有条新版本、市场索引没刷新，或你把版本锁住了。 三种情况的处理方式完全不同，先分诊再动手。

1. 打开已安装列表，记下该插件当前版本。
2. 回市场搜同一个插件，记下卡片上的最新版本。
3. 两个版本不同，走正常更新；相同但徽标仍亮，先刷新或重启。
4. 版本被固定在旧版时，先确认这是你有意为之，再决定是否解除。

分诊的关键是「已装版本」和「市场最新版本」这两个数字。只看徽标，你无法判断是更新没生效，还是根本没有新版本可更。

更新确认弹窗之后，为什么要重启 DeepSeek Harness

更新确认弹窗只负责「把新版本写进去」，重启才负责「让运行中的进程用上新版本」。 少了重启这一步，包已经换了，入口还是旧的。

1. 点「可更新」后，先读确认弹窗里的新版本信息，确认这是你要的版本。
2. 确认后等待安装完成，留意通知中心是否出现「待重启」提醒。
3. 完全退出并重启 DeepSeek Harness，不要只刷新页面。
4. 重启后打开插件入口，实际调用一次，确认新版本行为正常。
5. 回已安装列表看版本号，再回市场看徽标是否消失。

重启不是仪式，而是加载时机决定的：插件在启动时按 profile 清单加载，运行中的进程不会因为包被覆盖就自动换模块。看到待重启还继续点更新，只会重复覆盖同一个版本。

更新失败的三级恢复顺序：dsh plugin market 先退哪一步

恢复顺序是「先重启 → 再重试一次 → 最后回退版本」，每一步只改一个变量。 一上来就重装，会把失败现场一起清掉。

1. 第一级：重启。确认不是「待重启」被误判成失败；重启后看版本与入口。
2. 第二级：重试一次。回通知中心确认失败阶段，修掉网络或镜像问题后，只重试一次。
3. 第三级：回退。重试仍失败时，装回上一个已知可用版本，先恢复使用。
4. 第四级：换来源。回退后仍想升级，改用 npm 预构建版本或另一个来源，避开失败通道。
5. 记录：把失败阶段、版本与处理结果写下来，下次更新直接对照。

三级恢复的核心是「先恢复可用，再追求最新」。在坏环境里反复更新，只会让版本状态越来越难判断。回退的具体做法见 更新失败怎么回退。

# 只读检查一：确认当前 profile 里这个插件的实际版本
dsh plugin --profile web list
# 只读检查二：确认加载层在哪个 profile，避免看错环境
dsh --profile web --dump-config | grep -in <插件关键词>

两条命令都不改动任何东西，先确认「你看的是不是同一个 profile、同一个版本」，再谈更新。很多「更新失败」其实是装在一个 profile、看的是另一个 profile。

缓存与索引：dsh plugin market 为什么清了缓存徽标还在

徽标由市场索引与已装版本对比得出，清浏览器缓存不一定能刷新索引。 你清掉的是页面资源，索引数据可能还在服务端或本地配置里。

1. 先重启宿主，让市场重新拉一次索引，再看徽标。
2. 刷新市场页，确认卡片上的最新版本号有没有变化。
3. 如果版本号没变、徽标还在，去已安装列表核对实际版本。
4. 实际版本已经是最新，徽标仍亮，按「旧索引」处理，记录时间点后观察。
5. 不要为了消掉徽标反复卸载重装，那会把插件状态弄乱。

缓存问题最容易引发「假失败」：你以为更新没成功，其实版本已经对了，只是索引没跟上。判断标准始终是「已装版本 vs 市场最新版本」，不是徽标颜色。

版本锁定该不该解除

1. 如果你是为了避开已知问题而锁定，别为了让徽标消失就解除。
2. 如果锁定只是当初临时试用留下的，先确认新版本兼容区间再解除。
3. 解除后按正常更新流程走一次，确认版本真的变化。
4. 再决定要不要重新锁定，并把原因写下来。

怎么判断这次更新真的完成：DSH Plugin Hub 的三处证据

更新完成要看三处：版本号、入口行为、日志无新错误。 徽标消失只能算第四处，而且它可能是索引刷新造成的假象。

1. 版本号：已安装列表里的版本变成目标版本。
2. 入口行为：重启后插件入口能打开，实际调用一次能力正常。
3. 日志：系统日志里没有同一插件的新激活错误或依赖错误。
4. 徽标：以上三处都对上后，再看徽标是否消失；不消失也不影响结论。
5. 记录：把版本、时间与验证结果记进环境笔记。

如果三处里有一处不对，回到本文的分诊表重新判断，不要直接重装。版本被锁定的情况，先看 插件版本怎么固定；更新后必须重启的原因，可以对照 插件更新与重启。