DSH Plugin market 目录为什么不是实时：插件市场缓存、刷新时机与旧数据判断

打开 DSH Plugin market 看到旧列表时，很多人的第一反应是市场坏了，其实更常见的情况是你看到的只是一份快照。 市场目录由远端索引、CDN 分发、本地索引缓存与客户端渲染共同决定，任何一环滞后都会表现成「插件少了」或「版本旧了」。 下面把这条链路拆开，讲清刷新发生在哪些环节，以及看到旧数据时该先查什么。

DSH Plugin market 目录为什么不是实时快照

市场目录不是远端实时的全量列表，而是客户端在某个时刻取到的一份索引副本。

远端索引由市场侧维护，条目的名称、版本、描述和更新时间先写进索引，再通过分发网络送到离你最近的节点。 客户端打开市场时拿到的是节点上的那一份，它不会为了你的一次点击去回源重建整份目录。 所以「实时」只存在于远端索引刚重建完的那一刻，之后每一次展示都带有不同程度的延迟。 索引重建本身也不是瞬时完成的，条目多时更需要时间。

真正决定你看到什么的是三个时间点：发布者提交更新、索引完成重建、客户端完成拉取。 三者之间没有对外承诺的固定间隔，网络状况和节点缓存都会把间隔拉长或缩短。 把市场当成数据库实时查询，是大多数误判的起点。 这也是为什么不同地区的人在同一时间看到的条目可能不一样。

DSH Plugin market 的刷新发生在哪些环节

刷新发生在远端索引、CDN 节点、本地缓存和界面渲染四个位置，它们并不是同一个动作。

远端索引的重建由市场侧触发，新条目要先进入索引，才可能被任何客户端看到。 CDN 节点按自己的缓存策略保留副本，节点没有过期时，即使源站已经更新，你仍可能拿到旧内容。 源站更新与节点过期之间，存在一段谁都不确定的时间差。

客户端启动或手动刷新时才会重新请求，界面上的刷新按钮通常只重绘已经取到的数据。 本地索引缓存决定离线或弱网时还能不能打开市场，也决定陈旧数据会停留多久。 客户端版本则决定它能否识别新字段和新分类，旧版本遇到新结构时可能直接跳过条目。

三类旧数据：DSH插件看不到、版本旧、装不上

旧数据有三种形态，分别是新条目缺失、版本信息滞后和条目存在却装不上。

• 新条目缺失：包已经发布，但索引还没收录，或者收录了而你的节点还没更新。
• 版本信息滞后：条目一直在，只是详情页的版本号落后于 npm 上的最新发布。
• 条目存在却装不上：可能是客户端不认识新依赖，也可能是目标平台的构建产物缺失。
• 字段没补齐：条目已经收录，但详情页的描述、分类或截图还是空的。

判断形态比急着刷新更重要，因为三种情况对应的处理动作完全不同。 先记下包名，再用独立来源确认包是否存在、最新版本是多少，形态基本就能确定。 如果连包都查不到，问题就不在市场目录，而在发布或包名本身。

看到旧数据时，DSH Plugin market 的排查顺序

排查应从连通性开始，再看缓存、搜索词和客户端版本，不要一上来就清缓存。

1. 连旧条目都加载不出来：问题在网络上，代理、证书和 DNS 比刷新更值得先查。
2. 旧条目在、新条目不在：指向索引缓存，这时界面刷新和重启客户端才有意义。
3. 分类里看得到而搜索搜不到：通常是关键词匹配的问题，换英文名、作者名或更短的词更快。
4. 同账号、同网络的另一台机器能看到：才轮到怀疑本机客户端版本。
5. 验证：每轮只做一个动作并记下结果，才能知道是哪一处起了作用。

把这些判据按顺序走一遍，通常几分钟就能定位问题。 如果每一步都正常，再回头看自己搜的关键词是否过于具体。 排查记录本身也有价值，下一次遇到类似现象可以直接对照。

刷新、重启与清缓存在 DSH Plugin market 里各做什么

界面刷新只重绘已有数据，重启会重新拉取，清 npm 缓存则与目录无关。

界面刷新最轻，适合确认「数据已经拿到但界面没更新」这一类问题。 重启客户端会重新初始化并重新请求目录，能解决大部分本地缓存造成的陈旧。 清索引缓存只在确认缓存损坏时做，具体位置随版本和部署方式变化，照抄固定路径往往找不到。

清 npm 缓存影响的是包下载，不会让市场多出一条目录，把它当刷新手段是常见误区。 重装客户端是最后手段，代价是重新配置 profile 和登录状态。 动手重装前先确认前面几步都无效，否则只是把同一个问题换了个地方重现。 如果只是界面显示问题，清缓存反而会掩盖真正的原因。

用 CLI 对照 DSH Plugin market 的显示结果

命令行能绕开界面缓存，分别确认包是否存在、本机装的是哪一版。

先用 npm 查目标包名和最新版本，确认包在公共源上确实可以解析。 再用 dsh plugin list 看当前 profile 的已装项，把版本号与旧清单逐行对照。 包存在、市场有、本机没装，指向安装问题；包存在、市场没有，才指向索引或客户端。

不要把已装列表当成市场目录，它只能说明本机装了什么，不能说明市场里有什么。 把几条命令的输出一起留档，后续复盘或提 issue 时比口头描述有用得多。 对照时最好换一台同账号的机器再跑一遍，差异点往往就是问题所在。

把目录当成快照而不是实时数据库，很多「市场不更新」的焦虑会小一半。 真正要动手时，先让连通性、缓存与版本各自说清状态，再决定刷新哪一处，DSH插件 的使用体验也会稳定得多。 这套对照不依赖界面状态，换一台机器也能复现。