dsh-update-status 0.4.7 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.zh.md CHANGED
@@ -17,7 +17,7 @@
17
17
  <a href="#更新检查">更新检查</a> ·
18
18
  <a href="#受监督的重启">受监督的重启</a> ·
19
19
  <a href="#局域网非回环页面访问">局域网访问</a> ·
20
- <a href="#兼容性">兼容性</a> ·
20
+ <a href="#可加载性与更新提示">可加载性</a> ·
21
21
  <a href="#配置">配置</a> ·
22
22
  <a href="#故障排查">故障排查</a> ·
23
23
  <a href="#安全边界">安全边界</a> ·
@@ -25,9 +25,9 @@
25
25
  <a href="docs/RELEASING.md">发布指南</a>
26
26
  </p>
27
27
 
28
- > DSH Update Status 是 DeepSeek Harness 社区插件。它不修改 DSH 核心,不会安装或升级 DSH、回滚 DSH 包、下载 release 或替换 DSH 文件;只有你显式安装并接管了当前 DSH Web 的用户级后台服务后,它才会请求一次受限的安全重启。
28
+ > DSH Update Status 是 DeepSeek Harness 社区插件。它不修改 DSH 核心,不会安装或升级 DSH、回滚 DSH 包、下载 release 或替换 DSH 文件,也绝不会自行安装更新或自行重启 DSH;只有你显式安装并接管了当前 DSH Web 的用户级后台服务后,它才会请求一次受限的安全重启。
29
29
 
30
- 插件只把展开侧栏中的品牌名称换成适配 24px 品牌行的 `DeepSeek + 版本芯片`,官方鱼标保持不变。版本号旁的**绿点**表示正在运行的版本就是 npm 上最新的那一版;**橙色呼吸圆点**表示线上有更新的版本——无论是稳定版、RC 还是 Alpha。点击芯片即可看到当前运行版本、更新的版本、本插件是否验证过它、钉在该确切版本上的“仅复制”升级命令,以及只有装好用户级监督后才会出现的**重启**按钮。
30
+ 插件只把展开侧栏中的品牌名称换成适配 24px 品牌行的 `DeepSeek + 版本芯片`,官方鱼标保持不变。版本号旁的**绿点**表示线上没有更新的版本;**橙色呼吸圆点**表示线上至少有一个更新的版本——无论是稳定版、RC 还是 Alpha。点击芯片即可看到当前运行版本、每个更新版本一张卡片(各带自己的“仅复制”升级命令),以及只有装好用户级监督后才会出现的**重启**按钮。
31
31
 
32
32
  <p align="center">
33
33
  <img src="./assets/update-panel.zh.png" width="400" alt="DSH 更新状态面板:缓存时长、正在运行的 0.2.1-alpha.1 显示已是最新与上次检查时间、检查更新/发布说明/重启三个操作,以及“只有受用户级服务监督时才允许安全重启”的说明">
@@ -38,22 +38,25 @@
38
38
  - **侧栏版本状态**:展开侧栏显示当前 DSH 版本。收起侧栏时不渲染任何入口——DSH 的 `sidebar.footer.action` 是「设置」上方的一格 36px 位置,第二个注册者会把这一行撑破(实测把相邻插件的入口顶出了屏幕左缘),所以品牌行芯片是唯一入口。
39
39
  - **安静的更新提示**:有新版本时**不改变版本 Badge 的背景**,只在版本号旁保留一个带小光晕的橙色圆点做放大缩小的呼吸动画(`prefers-reduced-motion` 下停用动画),让新版本表现为一盏小灯,而不是整条品牌行换色。
40
40
  - **一眼三态**:没有可做的事时,版本号旁是**纯绿色小圆圈**(取主题 success 色,不再跟随文字色——暗色外壳下不会再出现一个看起来像「熄灭」的深色点);检查中是中性灰呼吸点;有新版本才是橙色光晕呼吸点。只有更新态会动、会发光,也只有状态读取失败才会把 Badge 重绘成红色。
41
- - **中性版本底框**:Badge 在明暗两套主题下都用灰色二级面(浅色 `#f1f3f5` / 深色 `#353638`)配主题常规文字色,所以暗色下是「深灰底 + 白字」,不再是会把橙色光晕吃掉的白框;只有状态读取失败时才会重绘成红色。
41
+ - **中性版本底框**:Badge 在明暗两套主题下都用灰色二级面(浅色 `#f1f3f5` / 深色 `#353638`)配主题常规文字色,所以暗色下是「深灰底 + 白字」,不再是会把橙色光晕吃掉的白框。
42
42
  - **浅色 / 深色 / 跟随系统,自动适配**:插件渲染的每个颜色都是 DSH 语义令牌,Badge、圆点、光晕与面板都按 DSH 当前外观解析。DSH 设为浅色、深色或跟随系统,插件就跟着切换——插件侧没有自己的主题开关,也没有需要同步的媒体查询。hover 在两个方向上都是「抬起」:浅色下压深、深色下提亮(把主题文字色按比例混进底色实现)。
43
- - **只有一条发布线、零配置**:一次 registry 请求读取 npm 的全部 dist-tags,只保留其中最新的版本——稳定版、RC、Alpha 一视同仁。没有需要关注的通道,也没有需要做的选择。
44
- - **诚实的预发布比较**:运行版本与线上最新版本按 SemVer 排序,因此 `0.2.1-rc.3` 高于 `0.2.0-rc.2`,而 RC 仍然低于它自己的正式版。
45
- - **兼容性标识**:本插件验证过的版本显示“已验证兼容”;没验证过的更新版本显示“尚未验证兼容”,不冒充安全升级,而且这条提示永远不会重绘芯片。
46
- - **仅复制命令**:根据安装来源,为**找到的那个确切版本**生成命令,不用会移动的 dist-tag,也从不执行。
43
+ - **一个可升级版本一张卡片**:凡是严格新于当前运行版本的已发布版本,各占一张卡片,最新的排在最上面;每张卡片带的是**该版本自己的**只复制命令。没有任何更新版本时不显示卡片,面板直接说明当前版本最新。
44
+ - **只有最新那张卡片被强调**:最高版本用琥珀色描边加**最新**标签突出,其余卡片保持中性。没有手动排序控件:顺序就是版本顺序,只有最上面那张被强调。
45
+ - **只有一条发布线、零配置**:一次 registry 请求读取 npm 的全部 dist-tags,保留所有比当前运行版本更新的版本——稳定版、RC、Alpha 一视同仁。没有需要关注的通道,也没有需要做的选择。
46
+ - **诚实的预发布比较**:运行版本与每个候选版本按 SemVer 排序,因此 `0.2.1-rc.4` 高于 `0.2.0-rc.2`,而 RC 仍然低于它自己的正式版。
47
+ - **按版本给命令,只复制不执行**:每张卡片上的命令都钉在该卡片的确切版本上,不用会移动的 dist-tag,插件也从不执行它。
48
+ - **不再维护兼容台账**:面板不再声称某个 DeepSeek Harness 版本“与本构建一起测过”。能不能加载由 DSH 自己按声明的引擎范围与 `@deepseek-ai/dsh-settings` peer 范围判定。
47
49
  - **缓存但不轮询**:Host 挂载时检查一次,缓存可设为 30–1,440 分钟并合并并发请求;前端没有轮询,只有“检查更新”按钮绕过缓存。
48
50
  - **移动端可靠**:详情使用浏览器 modal top layer;底部 sheet 可滚动、适配 safe area,并保持在 DSH 抽屉上方。
49
51
  - **受监督的安全重启**:一次性装好后台服务后,面板就能替你重启 DSH——它会先提醒会中断哪些工作,而终端直启或桌面应用托管的 DSH 会被直接拒绝。
52
+
50
53
  ## 安装
51
54
 
52
55
  要求:
53
56
 
54
57
  - 带 Web profile 的 DeepSeek Harness
58
+ - DeepSeek Harness `>=0.1.7-alpha.2 <0.3.0`——这是插件在 `dsh.engines.dsh` 中声明的范围,`@deepseek-ai/dsh-settings` peer 范围与之相同。超出范围的 bundle 会在 profile 加载时被 DSH 拒绝。没有“已验证发布清单”需要你对照:在范围内,插件不需要等某个版本被“批准”。
55
59
  - Node.js 20 或更新版本
56
- - 已验证的 DSH 版本:`0.2.1-rc.3`(当前)、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1` 与 `0.1.7-alpha.2`
57
60
 
58
61
  已经安装 `dsh` 命令:
59
62
 
@@ -83,18 +86,18 @@ dsh plugin --profile web add "link:$(pwd)"
83
86
 
84
87
  1. 打开 DSH 左侧抽屉。官方鱼标仍在;名称行显示 `DeepSeek + 当前版本 Badge`。
85
88
  2. 点击 Badge。面板打开时不会触发外层“新建会话”按钮。
86
- 3. 看当前运行版本。当它就是 npm 上最新的那一版时,面板会直接说明,并且不提供任何要执行的命令。
87
- 4. 当线上有更新的版本——稳定版、RC 或 Alpha 都一样——面板会给出它的版本号、发布时间,以及本插件是否验证过它。
88
- 5. 复制生成的命令(已钉在该确切版本上),在**运行 DSH 的那台电脑**的终端中自行执行。
89
+ 3. 看当前运行版本。线上没有更新的版本时,面板会说明当前就是最新版本,并且没有任何卡片可点。
90
+ 4. 否则每个更新的已发布版本各有一张卡片,最新的在最上面。卡片显示版本号、承载它的 dist-tag(npm 有报告时)、所属发布线和发布时间。
91
+ 5. 复制你想装的那张卡片上的命令(每条都钉在该卡片的确切版本上),在**运行 DSH 的那台电脑**的终端中自行执行。
89
92
  6. 包管理器命令完成后,只有已完成[受监督的重启](#受监督的重启)接管时才使用面板里的**重启**;否则仍由你自行重启 DSH。
90
93
 
91
- 全局安装时可能生成:
94
+ 全局安装时,卡片上的命令可能长这样:
92
95
 
93
96
  ```sh
94
- npm install -g @deepseek-ai/dsh@0.2.1-rc.3
97
+ npm install -g @deepseek-ai/dsh@0.2.1-rc.4
95
98
  ```
96
99
 
97
- 插件只显示一条与检测到的安装方式匹配、并写明所查到确切版本号的命令,不会运行它。
100
+ 每张卡片只显示一条与检测到的安装方式匹配、并写明该卡片确切版本号的命令,插件不会运行它。当这种安装方式给不出包管理器命令时(例如源码检出),面板只在整块面板上给一次说明,而不是给每张卡片配一个复制按钮去编造命令。
98
101
 
99
102
  ### 圆点含义
100
103
 
@@ -102,10 +105,10 @@ npm install -g @deepseek-ai/dsh@0.2.1-rc.3
102
105
 
103
106
  | 圆点 | 状态 | 含义 |
104
107
  | --- | --- | --- |
105
- | 绿色小圆圈 | 已是最新 | 正在运行的版本就是 npm 上最新的那一版,芯片保持原底色。 |
108
+ | 绿色小圆圈 | 已是最新 | 线上没有更新的已发布版本,芯片保持原底色。 |
106
109
  | 灰点呼吸 | 检查中 | 状态读取正在进行(首次挂载,或点了**检查更新**)。 |
107
- | 橙色圆点 + 光晕 | 有更新 | 线上有更新的版本。自行复制命令、执行,然后重启 DSH。 |
108
- | 芯片变红 | 读取失败 | 插件无法判定状态:registry 读取失败,或两个版本无法按 SemVer 比较。**未验证兼容**的更新版本不属于这一档——它只是面板里的提示。 |
110
+ | 橙色圆点 + 光晕 | 有更新 | 线上至少有一个更新的版本。复制某张卡片的命令、自行执行,然后重启 DSH。 |
111
+ | 芯片变红 | 读取失败 | 插件无法判定状态:registry 读取失败,或两个版本无法按 SemVer 比较。 |
109
112
 
110
113
  <p align="center">
111
114
  <img src="./assets/sidebar-chip.png" width="300" alt="版本芯片在浅色外壳(浅灰底、深色字)与深色外壳(深灰底、白字)下的样子,右侧都是表示已是最新的绿点">
@@ -115,15 +118,14 @@ npm install -g @deepseek-ai/dsh@0.2.1-rc.3
115
118
 
116
119
  ## 更新检查
117
120
 
118
- 插件按缓存周期向 npm registry 请求一次 `@deepseek-ai/dsh`,取出**所有 dist-tag 指向的最新版本**,再与正在运行的版本比较。`latest`、`next`、`alpha` 是 npm 自己的记账方式,不是需要用户做的选择:哪个 tag 上挂着更新的版本,就报哪个。
119
-
120
- - 取 SemVer 最高者(含预发布):因此跑到稳定版前面的 `alpha` 会被提示,而不是被藏起来。
121
- - 比较是精确的:`0.2.1-rc.3` 比 `0.2.0-rc.2` 新,两者都低于 `0.2.1`。
122
- - 插件没听说过的 dist-tag 同样计入——读取的是 npm 返回的全部 tag,不是写死的三个。
123
- - 只有本插件验证过的版本才标注“已验证兼容”;没验证过的更新版本会带上“尚未验证兼容”的提示(`notice`,永远不会重绘芯片)。
124
- - 详情面板渲染唯一答案;升级命令写明所查到的确切版本。
121
+ 插件按缓存周期向 npm registry 请求一次 `@deepseek-ai/dsh`,收集所有被 dist-tag 指向的已发布版本,保留严格新于当前运行版本的那些,并按从新到旧列出。`latest`、`next`、`alpha` 是 npm 自己的记账方式,不是需要用户做的选择:哪个 tag 上挂着更新的版本,就计入哪个。
125
122
 
126
- 这里不会安装任何东西。跟随某条通道——以及保存它的 `channel` 偏好——已在 `0.2.0` 移除。
123
+ - npm 返回的每个 tag 都算,包括插件没听说过的 tag。同一个版本可能带多个 tag,卡片上只显示一个,按 `latest`、`next`、`alpha`、`beta`、`rc`、其他的顺序取。
124
+ - 按 SemVer 从高到低排列(含预发布):因此跑到稳定版前面的 `alpha` 会被列出,而不是被藏起来。
125
+ - 比较是精确的:`0.2.1-rc.4` 比 `0.2.0-rc.2` 新,两者都低于 `0.2.1`。
126
+ - 列表以当前运行版本为准:升级 DSH 后重新检查,卡片会变少;装回旧版本则会变多。
127
+ - npm 网页只在包首页显示 `latest` 那个 tag,其他 tag 上的版本要到 Versions 页面才看得到。面板不照搬这个简化,它们都会被列出。
128
+ - 这里不会安装任何东西,也不会自动应用任何更新。跟随某条通道——以及保存它的 `channel` 偏好——已在 `0.2.0` 移除。
127
129
 
128
130
  ## 受监督的重启
129
131
 
@@ -160,79 +162,91 @@ dsh plugin --profile web exec dsh-update-status-service activate
160
162
 
161
163
  ## 局域网(非回环页面)访问
162
164
 
163
- 较早的 DSH 会把非回环页面的设置表单限制为仅内存状态。DSH `0.2.1-rc.3` 的表单快照不再提供该 `mode` 字段,官方按条目寻址的表单直接调用设置 Remote。不能仅根据页面来源判断当前的持久化或授权行为;写入是否获准由正在运行的 Host 设置策略决定。
165
+ 较早的 DSH 会把非回环页面的设置表单限制为仅内存状态。DSH `0.2.1-rc.3` 及之后的表单快照不再提供该 `mode` 字段,官方按条目寻址的表单直接调用设置 Remote。不能仅根据页面来源判断当前的持久化或授权行为;写入是否获准由正在运行的 Host 设置策略决定。
164
166
 
165
167
  从 `0.1.2` 起,本插件在局域网页面同样可用:
166
168
 
167
- - **版本/更新状态**照常读取。早先的版本把整个功能压在 `connection.isLoopback === true` 上,于是经局域网转发(`dsh-bridge`、`dsh-lan-proxy` 等)打开的页面从不发送 `POST /api/dsh-update-status.get-status`、详情面板打不开,还会把本包声明的兼容版本当成"当前运行版本"显示。该判断已移除——Connection RPC 本身是已认证的,Host 路由也是本插件自己的路由。
169
+ - **版本/更新状态**照常读取。早先的版本把整个功能压在 `connection.isLoopback === true` 上,于是经局域网转发(`dsh-bridge`、`dsh-lan-proxy` 等)打开的页面从不发送 `POST /api/dsh-update-status.get-status`、详情面板打不开,还会把本包构建时所针对的版本当成"当前运行版本"显示。该判断已移除——Connection RPC 本身是已认证的,Host 路由也是本插件自己的路由。
168
170
  - **偏好设置**(`sidebarEnabled`、`cacheTtlMinutes`)继续读写 Host 上共享的那一份 `dsh-update-status` 设置条目,走的是与官方设置表单相同的公开 Remote(`settings.describe` / `settings.mutate`)。写入仍受 revision 栅栏保护,被拒时明确提示冲突而不会静默覆盖。直连通道只在官方表单报 `unavailable` 时才打开,所以回环页面仍走官方路径,不会多发一次线上读取。
169
171
 
170
172
  局域网转发必须保留 DSH 的已认证传输和 Host 授权策略。本插件不会修改转发配置或授予设置访问权;Host 拒绝访问时,应由部署维护者处理。
171
173
 
172
- ## 兼容性
173
-
174
- 当前发布:插件 **`0.4.7`** 已针对 DeepSeek Harness **`0.2.1-rc.3`**(当前发布版)、**`0.2.1-rc.2`**、**`0.2.1-alpha.5`**、**`0.2.1-alpha.4`**、**`0.2.1-alpha.3`**、**`0.2.1-alpha.1`**、**`0.2.0-rc.2`**、**`0.2.0-rc.1`**、**`0.1.7-rc.2`**、**`0.1.7-rc.1`** 与 **`0.1.7-alpha.2`** 验证。
175
-
176
- ### 插件版本与 DeepSeek Harness 版本的对应关系
177
-
178
- | 插件版本 | 已验证的 DeepSeek Harness | npm 发布状态 | 该版本是什么 |
179
- | --- | --- | --- | --- |
180
- | **`0.4.7`** | `0.2.1-rc.3`、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | `latest` | 移除重复的设置菜单;安装后默认显示版本与更新提示,详情统一由侧栏版本芯片打开 |
181
- | **`0.4.6`** | `0.2.1-rc.3`、`0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 验证 DSH `0.2.1-rc.3`;后台维护和启动中的终端也需重启确认,并恢复重启风暴的原因与恢复指引 |
182
- | **`0.4.5`** | `0.2.1-rc.2`、`0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 为 DSH `0.2.1-rc.2` 追加兼容声明;功能代码不变,中英文 README 一并核对,npm 包内容也与仓库比对过 |
183
- | **`0.4.4`** | `0.2.1-alpha.5`、`0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 为 DSH `0.2.1-alpha.5` 追加兼容声明;功能代码不变,中英文 README 的版本号一并核对过 |
184
- | **`0.4.3`** | `0.2.1-alpha.4`、`0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 为 DSH `0.2.1-alpha.4` 追加兼容声明;功能代码不变,面板会将当前运行版显示为已验证兼容 |
185
- | **`0.4.2`** | `0.2.1-alpha.3`、`0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 为 DSH `0.2.1-alpha.3` 追加兼容声明;功能代码不变,面板会将当前运行版显示为已验证兼容 |
186
- | **`0.4.1`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 安装服务时保存当时使用的 PATH,不论工具由哪种包管理器安装,受托管后仍能找到 |
187
- | **`0.4.0`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 重启变得靠得住:服务连续失败会停下而不是无限重启;按钮要求系统服务真正托管当前进程;禁用时会给出两条可复制的恢复命令。设置页还能看到服务启动时间 |
188
- | **`0.3.2`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 只改文档:版本对照表和历史发布说明都改成人话。功能与 `0.3.1` 完全一样 |
189
- | **`0.3.1`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 小补丁:设置页也说明了重启前提,长任务名不再把按钮挤走。 |
190
- | **`0.3.0`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 面板新增**重启**,以及它需要的那条服务安装命令;没装服务时按钮保持禁用并说明原因。 |
191
- | **`0.2.1`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 隐藏版本芯片后,品牌行恢复成 DSH 官方的名称与鱼标,而不是变成空白。 |
192
- | **`0.2.0`** | `0.2.1-alpha.1`、`0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 从「通道目录」改成「一条发布线」:面板只报 npm 上最新的版本,没有需要配置的东西。 |
193
- | **`0.1.12`** | `0.2.0-rc.2`、`0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 把 DSH `0.2.0-rc.2` 加入已验证清单;代码无改动。 |
194
- | **`0.1.11`** | `0.2.0-rc.1`、`0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 声明 DSH `0.2.0` 线并放宽支持范围,避免更新的 DSH 一声不响地把插件丢掉。 |
195
- | **`0.1.10`** | `0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 收起侧栏的窄轨里不再放按钮——那里放不下,还会把相邻插件的图标挤开。 |
196
- | `0.1.9` | `0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 修复升级 DSH 后插件消失(安装目录里残留的共享库副本会把它带崩);设置页现在会告诉你要删哪个目录。 |
197
- | `0.1.8` | `0.1.7-rc.2`、`0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 把 DSH `0.1.7-rc.2` 加入已验证清单;代码无改动。 |
198
- | `0.1.7` | `0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 英文界面不再混入中文:状态提示改由浏览器按自己的语言渲染。 |
199
- | `0.1.6` | `0.1.7-rc.1`、`0.1.7-alpha.2` | 已发布 | 适配 DSH 0.1.7:插件的两个偏好改存成它自己的设置条目。 |
200
- | `0.1.5` | `0.1.6-alpha.2`、`0.1.6-alpha.1`、`0.1.5-rc.1` | 已发布 | 一颗圆点承载全部状态(绿=最新、灰=检查中、橙=有更新),提示性说明不再重绘芯片。 |
201
- | `0.1.4` | `0.1.6-alpha.1`、`0.1.5-rc.1` | 已发布 | 修复「正在运行的版本」显示成不可选。 |
202
- | `0.1.3` | `0.1.6-alpha.1`、`0.1.5-rc.1` | 已发布 | 带上局域网页面的修复,并在 DSH 0.1.6 上复验。 |
203
- | `0.1.2` | `0.1.5-rc.1` | **未发布** | 去掉「仅回环」的限制,局域网页面也能用。 |
204
- | `0.1.1` | `0.1.5-rc.1` | 已发布 | 此前的 npm 最新版;局域网页面上插件不工作。 |
205
- | `0.1.0` | `0.1.2-rc.1` | 已发布 | 首个版本。 |
206
- - **哪个版本配哪个 DSH?** `0.1.6`–`0.1.10` 用于 DSH `0.1.7` 线;`0.1.11` 及以后同时声明 `0.2.0` 线。DSH 0.1.7 改了插件设置的存储方式,所以在更早的 DSH(含 `0.1.6-alpha.2`)上请留在插件 **`0.1.5`**。
207
- - **「已验证」** 指这个版本确实和那个 DSH 发布版一起测过。清单里没有的版本会标成「尚未验证兼容」——只是面板里的提示,绝不会重绘芯片,所以 DSH 先升、插件后跟是安全的。真遇到不兼容,请禁用或卸载插件,不要去改 DSH 本体。(这份清单存放在 `package.json` 与 `src/shared/types.ts`,有测试保证两者一致。)
174
+ ## 可加载性与更新提示
175
+
176
+ 本插件不为任何 DeepSeek Harness 版本背书。能不能加载由 DSH 决定,而 DSH 只看两处声明:`dsh.engines.dsh` 是 `>=0.1.7-alpha.2 <0.3.0`,`@deepseek-ai/dsh-settings` 的 peer 范围与之相同。在这个范围内,你想跑哪个 DSH 版本都行,不需要插件再发一版来“批准”它。
177
+
178
+ `0.5.0` 把原来那套机制整个删掉了:没有已验证发布清单、没有 `dsh.compatibility` 元数据、面板里没有“已验证兼容/尚未验证兼容”标签,也不会因为某个 DSH 版本没被测过而给出提示。插件的职责只有一条——告诉你有更新的版本,以及怎么升级;维护兼容台账本来就不在范围内,而它 13 天里发过六个以兼容声明为标题的版本。
179
+
180
+ 剩下的就是更新提示:每个比当前运行版本新的版本各一张卡片,各带自己的命令。插件对某个版本知道的信息只有 npm 公布的那些——版本号、tag、发布时间——它不对“这个版本对你是否合适”下结论。
181
+
182
+ 下表中 `0.5.0` 以下的行仍会提到那份已删除的清单,那是历史,现在已经没有版本需要等某个清单收录。
183
+
184
+ ### npm 上的插件版本
185
+
186
+ | 插件版本 | npm 发布状态 | 该版本是什么 |
187
+ | --- | --- | --- |
188
+ | **`0.5.0`** | `latest` | 一个可升级版本一张卡片、各带自己的只复制命令;已验证发布机制被删除,能否加载只由 DSH 的引擎范围与 peer 范围决定 |
189
+ | **`0.4.8`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-rc.4` 追加条目——那套机制已在本次发布删除;功能代码不变 |
190
+ | **`0.4.7`** | 已发布 | 移除重复的设置菜单;安装后默认显示版本与更新提示,详情统一由侧栏版本芯片打开 |
191
+ | **`0.4.6`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-rc.3` 追加条目;后台维护和启动中的终端也需重启确认,并恢复重启风暴的原因与恢复指引 |
192
+ | **`0.4.5`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-rc.2` 追加条目;功能代码不变 |
193
+ | **`0.4.4`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-alpha.5` 追加条目;功能代码不变 |
194
+ | **`0.4.3`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-alpha.4` 追加条目;功能代码不变 |
195
+ | **`0.4.2`** | 已发布 | 在当时那份已验证清单中为 DSH `0.2.1-alpha.3` 追加条目;功能代码不变 |
196
+ | **`0.4.1`** | 已发布 | 安装服务时保存当时使用的 PATH,不论工具由哪种包管理器安装,受托管后仍能找到 |
197
+ | **`0.4.0`** | 已发布 | 重启变得靠得住:服务连续失败会停下而不是无限重启;按钮要求系统服务真正托管当前进程;禁用时会给出两条可复制的恢复命令 |
198
+ | **`0.3.2`** | 已发布 | 只改文档:版本对照表和历史发布说明都改成人话。功能与 `0.3.1` 完全一样 |
199
+ | **`0.3.1`** | 已发布 | 小补丁:面板也说明了重启前提,长任务名不再把按钮挤走。 |
200
+ | **`0.3.0`** | 已发布 | 面板新增**重启**,以及它需要的那条服务安装命令;没装服务时按钮保持禁用并说明原因。 |
201
+ | **`0.2.1`** | 已发布 | 隐藏版本芯片后,品牌行恢复成 DSH 官方的名称与鱼标,而不是变成空白。 |
202
+ | **`0.2.0`** | 已发布 | 从「通道目录」改成「一条发布线」:面板只报 npm 上最新的已发布版本,没有需要配置的东西。 |
203
+ | **`0.1.12`** | 已发布 | 把 DSH `0.2.0-rc.2` 加入当时那份已验证清单;代码无改动。 |
204
+ | **`0.1.11`** | 已发布 | 声明 DSH `0.2.0` 线并放宽支持范围,避免更新的 DSH 一声不响地把插件丢掉。 |
205
+ | **`0.1.10`** | 已发布 | 收起侧栏的窄轨里不再放按钮——那里放不下,还会把相邻插件的图标挤开。 |
206
+ | `0.1.9` | 已发布 | 修复升级 DSH 后插件消失(安装目录里残留的共享库副本会把它带崩);面板现在会告诉你要删哪个目录。 |
207
+ | `0.1.8` | 已发布 | 把 DSH `0.1.7-rc.2` 加入当时那份已验证清单;代码无改动。 |
208
+ | `0.1.7` | 已发布 | 英文界面不再混入中文:状态提示改由浏览器按自己的语言渲染。 |
209
+ | `0.1.6` | 已发布 | 适配 DSH 0.1.7:插件的两个偏好改存成它自己的设置条目。 |
210
+ | `0.1.5` | 已发布 | 一颗圆点承载全部状态(绿=最新、灰=检查中、橙=有更新),提示性说明不再重绘芯片。 |
211
+ | `0.1.4` | 已发布 | 修复「正在运行的版本」显示成不可选。 |
212
+ | `0.1.3` | 已发布 | 带上局域网页面的修复,并在当时的 DSH 0.1.6 上核对过。 |
213
+ | `0.1.2` | **未发布** | 去掉「仅回环」的限制,局域网页面也能用。 |
214
+ | `0.1.1` | 已发布 | 此前的 npm 最新版;局域网页面上插件不工作。 |
215
+ | `0.1.0` | 已发布 | 首个版本。 |
216
+
217
+ - **哪个版本配哪个 DSH?** `0.1.6`–`0.1.10` 是为 DSH `0.1.7` 线构建的;`0.1.11` 及以后同时接纳 `0.2.0` 线。DSH 0.1.7 改了插件设置的存储方式,所以在更早的 DSH(含 `0.1.6-alpha.2`)上请留在插件 **`0.1.5`**。
218
+ - **能不能加载由 DSH 判定,不看标签。** 如果某个 DSH 版本拒绝加载本插件,请禁用或卸载插件,不要去改 DSH 本体——也请顺手反馈。现在已经没有“已测清单”,也没有清单条目可等。
208
219
  - **npm 发布状态** 指 `dsh plugin --profile web add dsh-update-status@latest` 实际会装到的版本;只存在于仓库、尚未发布的版本属于开发状态。
209
220
 
210
- - 需要精确对应时显式指定版本:
221
+ - 需要固定插件版本时显式指定:
211
222
 
212
223
  ```sh
213
- dsh plugin --profile web add dsh-update-status@0.4.7 # DSH 0.2.1-rc.3、0.2.1-rc.2、0.2.1-alpha.5、0.2.1-alpha.4、0.2.1-alpha.3、0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
214
- dsh plugin --profile web add dsh-update-status@0.4.5 # DSH 0.2.1-rc.2、0.2.1-alpha.5、0.2.1-alpha.4、0.2.1-alpha.3、0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
215
- dsh plugin --profile web add dsh-update-status@0.4.4 # DSH 0.2.1-alpha.5、0.2.1-alpha.4、0.2.1-alpha.3、0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
216
- dsh plugin --profile web add dsh-update-status@0.4.3 # DSH 0.2.1-alpha.4、0.2.1-alpha.3、0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
217
- dsh plugin --profile web add dsh-update-status@0.4.2 # DSH 0.2.1-alpha.3、0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
218
- dsh plugin --profile web add dsh-update-status@0.3.2 # DSH 0.2.1-alpha.1
219
- dsh plugin --profile web add dsh-update-status@0.2.0 # DSH 0.2.1-alpha.1、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
220
- dsh plugin --profile web add dsh-update-status@0.1.12 # DSH 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
221
- dsh plugin --profile web add dsh-update-status@0.1.11 # DSH 0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
222
- dsh plugin --profile web add dsh-update-status@0.1.10 # DSH 0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
223
- dsh plugin --profile web add dsh-update-status@0.1.9 # DSH 0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
224
- dsh plugin --profile web add dsh-update-status@0.1.8 # DSH 0.1.7-rc.2、0.1.7-rc.1 或 0.1.7-alpha.2
225
- dsh plugin --profile web add dsh-update-status@0.1.7 # DSH 0.1.7-rc.1 或 0.1.7-alpha.2
226
- dsh plugin --profile web add dsh-update-status@0.1.6 # DSH 0.1.7-rc.1 或 0.1.7-alpha.2
227
- dsh plugin --profile web add dsh-update-status@0.1.5 # DSH 0.1.6-alpha.2、0.1.6-alpha.1 或 0.1.5-rc.1
228
- dsh plugin --profile web add dsh-update-status@0.1.4 # DSH 0.1.6-alpha.1 或 0.1.5-rc.1
229
- dsh plugin --profile web add dsh-update-status@0.1.0 # 仅 DSH 0.1.2-rc.1
224
+ dsh plugin --profile web add dsh-update-status@0.5.0
225
+ dsh plugin --profile web add dsh-update-status@0.4.8
226
+ dsh plugin --profile web add dsh-update-status@0.4.7
227
+ dsh plugin --profile web add dsh-update-status@0.4.6
228
+ dsh plugin --profile web add dsh-update-status@0.4.5
229
+ dsh plugin --profile web add dsh-update-status@0.4.4
230
+ dsh plugin --profile web add dsh-update-status@0.4.3
231
+ dsh plugin --profile web add dsh-update-status@0.4.2
232
+ dsh plugin --profile web add dsh-update-status@0.3.2
233
+ dsh plugin --profile web add dsh-update-status@0.2.0
234
+ dsh plugin --profile web add dsh-update-status@0.1.12
235
+ dsh plugin --profile web add dsh-update-status@0.1.11
236
+ dsh plugin --profile web add dsh-update-status@0.1.10
237
+ dsh plugin --profile web add dsh-update-status@0.1.9
238
+ dsh plugin --profile web add dsh-update-status@0.1.8
239
+ dsh plugin --profile web add dsh-update-status@0.1.7
240
+ dsh plugin --profile web add dsh-update-status@0.1.6
241
+ dsh plugin --profile web add dsh-update-status@0.1.5
242
+ dsh plugin --profile web add dsh-update-status@0.1.4
243
+ dsh plugin --profile web add dsh-update-status@0.1.0
230
244
  ```
231
245
 
232
- - 有两处声明让已验证的版本线能正常加载,并由测试守住:
233
- - `dsh.engines.dsh` 与 `peerDependencies['@deepseek-ai/dsh-settings']` 都声明 `>=0.1.7-alpha.2 <0.3.0`,十一个已验证版本都在范围内。下界特意写成这个 alpha:按 node-semver 默认的预发布规则,`>=0.1.6-0 <0.2.0` 这样的范围**并不接纳** `0.1.7-alpha.2`。上界在 `0.1.11` 从 `<0.2.0` 放宽到 `<0.3.0` 是同一件事的镜像:DSH 会在 profile 加载时拒绝不兼容的 bundle,而裸的 `<0.2.0` 恰好排除 `0.2.0` 正式版——DSH `0.2.0` 发布当天插件就会被静默丢弃。DSH 判定时使用 `includePrerelease: true`,所以 `0.2.0-rc.2` 本来就在这个范围内,`0.1.12` 无需再动范围;反过来说,把范围写成 `... || 0.2.0-rc.1 || >=0.2.0 <0.3.0` 这类枚举的插件会因为 `>=0.2.0` 不接纳 `0.2.0` 预发布而被 rc.2 拒载。
246
+ - 有两处声明决定插件能不能加载,DSH 在 profile 加载时会检查:
247
+ - `dsh.engines.dsh` 与 `peerDependencies['@deepseek-ai/dsh-settings']` 都声明 `>=0.1.7-alpha.2 <0.3.0`。下界特意写成这个 alpha:按 node-semver 默认的预发布规则,`>=0.1.6-0 <0.2.0` 这样的范围**并不接纳** `0.1.7-alpha.2`。上界在 `0.1.11` 从 `<0.2.0` 放宽到 `<0.3.0` 是同一件事的镜像:DSH 会在 profile 加载时拒绝不兼容的 bundle,而裸的 `<0.2.0` 恰好排除 `0.2.0` 正式版——DSH `0.2.0` 发布当天插件就会被静默丢弃。DSH 判定时使用 `includePrerelease: true`,所以 `0.2.0-rc.2` 本来就在这个范围内。这两个边界只决定能否加载,并不表示范围内的每个版本都被测过。
234
248
  - `@deepseek-ai/schemastery` 是 **peer**,不是普通依赖:DSH 0.1.7 只从运行安装解析 link 插件的 peer 依赖,否则 `link:` 安装会连 Host 半边都 import 失败。
235
- - 每个版本的中英文详细说明(改了什么、影响谁、需要做什么)手写后直接作为 GitHub Release 正文:[`v0.4.7`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.7.md) · [`v0.4.6`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.6.md) · [`v0.4.5`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.5.md) · [`v0.4.4`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.4.md) · [`v0.4.3`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.3.md) · [`v0.4.2`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.2.md) · [`v0.4.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.1.md) · [`v0.4.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.0.md) · [`v0.3.2`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.2.md) · [`v0.3.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.1.md) · [`v0.3.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.0.md) · [`v0.2.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.2.1.md) · [`v0.2.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.2.0.md) · [`v0.1.12`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.12.md) · [`v0.1.11`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.11.md) · [`v0.1.10`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.10.md) · [`v0.1.9`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.9.md) · [`v0.1.8`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.8.md) · [`v0.1.7`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.7.md) · [`v0.1.6`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.6.md) · [`v0.1.5`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.5.md) · [`v0.1.4`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.4.md) · [`v0.1.3`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.3.md)(含从未发布的 `0.1.2`)。
249
+ - 每个版本的中英文详细说明(改了什么、影响谁、需要做什么)手写后直接作为 GitHub Release 正文:[`v0.5.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.5.0.md) · [`v0.4.8`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.8.md) · [`v0.4.7`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.7.md) · [`v0.4.6`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.6.md) · [`v0.4.5`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.5.md) · [`v0.4.4`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.4.md) · [`v0.4.3`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.3.md) · [`v0.4.2`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.2.md) · [`v0.4.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.1.md) · [`v0.4.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.4.0.md) · [`v0.3.2`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.2.md) · [`v0.3.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.1.md) · [`v0.3.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.3.0.md) · [`v0.2.1`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.2.1.md) · [`v0.2.0`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.2.0.md) · [`v0.1.12`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.12.md) · [`v0.1.11`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.11.md) · [`v0.1.10`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.10.md) · [`v0.1.9`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.9.md) · [`v0.1.8`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.8.md) · [`v0.1.7`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.7.md) · [`v0.1.6`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.6.md) · [`v0.1.5`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.5.md) · [`v0.1.4`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.4.md) · [`v0.1.3`](https://github.com/idoall/dsh-update-status/blob/main/docs/releases/v0.1.3.md)(含从未发布的 `0.1.2`)。
236
250
 
237
251
  ## 配置
238
252
 
@@ -248,7 +262,7 @@ dsh plugin --profile web exec dsh-update-status-service activate
248
262
  ## 故障排查
249
263
 
250
264
  **胶囊显示的版本不是我刚装的,而且点了没有反应。**
251
- 这是插件 `0.1.1` 及更早版本的 `connection.isLoopback` 门控:在非回环页面(如 `dsh-bridge`、`dsh-lan-proxy` 这类局域网转发)上整个插件会失效,胶囊退回显示本包声明的兼容版本。先确认已装版本再升级:
265
+ 这是插件 `0.1.1` 及更早版本的 `connection.isLoopback` 门控:在非回环页面(如 `dsh-bridge`、`dsh-lan-proxy` 这类局域网转发)上整个插件会失效,胶囊显示的是本包构建时所针对的版本,而不是正在运行的版本。先确认已装版本再升级:
252
266
 
253
267
  ```sh
254
268
  node -p "require(process.env.HOME + '/.dsh/profiles/web/node_modules/dsh-update-status/package.json').version" # 需要 0.1.3 或更新
@@ -256,13 +270,14 @@ dsh plugin --profile web add dsh-update-status@latest
256
270
  ```
257
271
 
258
272
  **升级 DSH 之后芯片变红了。**
259
- 在 `0.1.5` 及更新版本上,红色只代表一件事:插件无法判定状态——registry 读取失败,或两个版本无法按 SemVer 比较。`0.1.4` 及更早版本的判定更宽:客户端把**任何**警告都当成故障,而「这个预览版尚未验证与本插件兼容」正是 DSH 版本比插件清单更新时必然产生的警告。所以「DSH 先升级、插件还没跟上」就会把芯片涂红,哪怕读取其实成功了。`0.1.5` 把两者分开——`failure` 仍然重绘,提示只留在面板——因此长期让 DSH 领先的用法请升级:
273
+ 在 `0.1.5` 及更新版本上,红色只代表一件事:插件无法判定状态——registry 读取失败,或两个版本无法按 SemVer 比较。`0.1.4` 及更早版本的判定更宽:客户端把**任何**警告都当成故障,所以当 DSH 比插件清单更新时,哪怕读取其实成功了,芯片也会被涂红。`0.1.5` 把两者分开——`failure` 仍然重绘,提示只留在面板;`0.5.0` 则把那条提示彻底删除,所以更新的 DSH 版本再也不会产生它:
260
274
 
261
275
  ```sh
262
276
  dsh plugin --profile web add dsh-update-status@latest
263
277
  ```
264
278
 
265
- 在那之前这条提示无害:它只出现在面板里,等后续插件版本把你正在使用的 DSH 版本列入已验证清单后就会自动消失。
279
+ **明明知道有更新的 DSH,面板却一张卡片都没有。**
280
+ 列表是检查那一刻按 npm 上已发布的版本、与你正在运行的版本比较得出的。点**检查更新**重新读一次。如果某个版本只存在于插件看不到的 registry,或者你运行的版本已经是已发布的最高版本,那就没有卡片可显示——不显示卡片正是正确答案。
266
281
 
267
282
  **版本一直不变。**
268
283
  Host 会缓存一次 registry 响应,默认 360 分钟,且只有普通读取才会判断到期。点**检查更新**可立即刷新,或调小 `cacheTtlMinutes`。检查失败时会保留上一次成功缓存,并在版本号旁显示警告。
@@ -285,7 +300,7 @@ rm -rf ~/.dsh/profiles/<profile>/node_modules/dsh-update-status/node_modules
285
300
  - 插件代码不会启动 npm/pnpm 子进程。
286
301
  - `canApplyInPlace` 恒为 `false`。
287
302
  - 插件不会安装、升级、回滚或替换 DSH 文件。单独、显式执行的服务 CLI 只会落盘当前用户的服务定义,绝不会杀掉占用端口的 DSH。
288
- - 重启是只接受 POST 的已认证 Connection RPC,并由服务端同时检查明确的原生服务标记与平台身份;终端直启、桌面版、未知环境或无法完整检查活动工作时均拒绝退出。
303
+ - 重启只接受 POST 的已认证 Connection RPC,并由服务端同时检查明确的原生服务标记与平台身份;终端直启、桌面版、未知环境或无法完整检查活动工作时均拒绝退出。
289
304
  - 刷新失败时保留最后一次成功缓存并显示警告;冷启动失败也会保留本地版本信息。
290
305
 
291
306
  ## 卸载
package/docs/RELEASING.md CHANGED
@@ -39,27 +39,27 @@ Write it in the layout the DeepSeek Harness release pages use, for example [dsh-
39
39
  ```markdown
40
40
  [中文](#cn-v0.1.3) | [English](#en-v0.1.3)
41
41
 
42
- <h3 id="cn-v0.1.3">插件 0.1.3 — 已验证 DeepSeek Harness 0.1.6-alpha.1</h3>
42
+ <h3 id="cn-v0.1.3">插件 0.1.3 — 一句话说明这个版本改了什么</h3>
43
43
 
44
- ### 版本对应 <!-- plugin version ↔ verified DSH version ↔ npm status -->
44
+ ### 版本对应 <!-- plugin version ↔ what it is ↔ npm status -->
45
45
  ### 问题修复 <!-- what was broken, for whom, and what changed -->
46
46
  ### 改进 <!-- behaviour and test improvements -->
47
- ### 兼容性与升级 <!-- verified DSH releases, exact upgrade command, limits -->
47
+ ### 可加载性与升级 <!-- declared DSH range, exact upgrade command, limits -->
48
48
 
49
- <h3 id="en-v0.1.3">Plugin 0.1.3 — verified against DeepSeek Harness 0.1.6-alpha.1</h3>
49
+ <h3 id="en-v0.1.3">Plugin 0.1.3 — one line on what changed</h3>
50
50
 
51
51
  ### Version matrix
52
52
  ### Bug Fixes
53
53
  ### Improvements
54
- ### Compatibility and upgrade
54
+ ### Loadability and upgrade
55
55
  ```
56
56
 
57
57
  Rules:
58
58
 
59
59
  - The two `<h3 id="cn-…">` / `<h3 id="en-…">` anchors are mandatory and must match the tag: the gate greps for `<h3 id="cn-vX.Y.Z">` and `<h3 id="en-vX.Y.Z">`.
60
60
  - Chinese section first, English section second; both must carry the same facts — not a summary of the other language.
61
- - Lead with the version matrix: which plugin version was verified against which DeepSeek Harness release, and which of them are actually on npm.
62
- - Write every entry as *what changed → who is affected → what the user must do*. State the verified DSH release, the exact upgrade command, and any remaining limitation explicitly.
61
+ - Lead with the version matrix: plugin version, what that version is, and whether it is on npm. Do not add a "verified DSH release" column — the project no longer publishes a per-release verified list.
62
+ - Write every entry as *what changed → who is affected → what the user must do*. State the DSH range the plugin declares, the exact upgrade command, and any remaining limitation explicitly.
63
63
  - A never-published version has no release page of its own. When a published version carries an unpublished one's fix, document both in the shipped release's notes (see `v0.1.3`, which covers the unpublished `0.1.2`).
64
64
  - Keep the same facts in `CHANGELOG.md`; the release notes may be longer and user-facing, but they must not contradict it.
65
65
 
@@ -68,8 +68,8 @@ Rules:
68
68
  Never release an uncommitted worktree or reuse a published npm version.
69
69
 
70
70
  1. Write `docs/releases/vX.Y.Z.md` (bilingual, hand-written — see above) **and** the matching `CHANGELOG.md` entry in the same commit.
71
- 2. Update the version matrix in `README.md` and `README.zh.md`: the verified DeepSeek Harness release(s), the npm status of every version, and which version a user on which DSH release should install.
72
- 3. Bump `package.json` and `dsh.compatibility.dshReleases` together with `VERIFIED_DSH_VERSIONS` in `src/shared/types.ts`.
71
+ 2. Update the version matrix in `README.md` and `README.zh.md`: the npm status of every version and what each version changed. Do not reintroduce a verified-release list, a verified/unverified label, or a count of tested DSH releases — that mechanism was removed in `0.5.0`.
72
+ 3. Bump the version in `package.json`. There is no compatibility list to sync: `dsh.engines.dsh` and the peer ranges change only when the plugin genuinely needs a different DSH range, and they are not updated per DSH release.
73
73
  4. Verify:
74
74
 
75
75
  ```sh
@@ -133,7 +133,7 @@ The final command must print:
133
133
  dsh-update-status X.Y.Z web
134
134
  ```
135
135
 
136
- Then install the package in a disposable DSH profile and manually verify the sidebar badge, its three dot states (green when up to date, grey pulse while checking, amber halo when a newer release exists — the chip fill itself must not change), the panel, release-channel selection, cache-duration setting, and mobile drawer behavior:
136
+ Then install the package in a disposable DSH profile and manually verify the sidebar badge, its three dot states (green when up to date, grey pulse while checking, amber halo when a newer release exists — the chip fill itself must not change), the panel (one card per version newer than the running one, newest first, the amber border and **Newest** pill on the top card only, and no cards at all when nothing is newer), the cache-duration setting, and mobile drawer behavior:
137
137
 
138
138
  ```sh
139
139
  TEST_HOME="$(mktemp -d)"