dsh-workplan 1.7.1 → 1.8.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/CHANGELOG.md +39 -0
- package/README.en.md +40 -1
- package/README.md +39 -1
- package/SECURITY.md +109 -0
- package/docs/SBOM.md +113 -0
- package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +97 -0
- package/docs/cc/CC-2026-ASSESSMENT.md +254 -0
- package/docs/cc/SECURITY-TARGET.md +239 -0
- package/docs/collaboration.md +440 -0
- package/docs/collapse-interaction-spec.md +272 -0
- package/docs/defect-report-count-inconsistency.md +370 -0
- package/docs/departments.md +194 -0
- package/docs/design-proposals/state-machine.reference.ts +836 -0
- package/docs/design-proposals/state-machine.test.reference.ts +655 -0
- package/docs/fix-report-derived-counts-1.4.3.md +199 -0
- package/docs/fix-report-phase-percent-1.5.2.md +284 -0
- package/docs/preview/progress-visual-1.5.0.html +683 -0
- package/docs/progress-visualization-clarify-20261028.md +211 -0
- package/docs/progress-visualization-design-20261028.md +607 -0
- package/docs/progress-visualization-locate-20261028.md +159 -0
- package/docs/progress-visualization-report-1.5.0.md +140 -0
- package/docs/release-notes-1.7.0.md +46 -0
- package/docs/release-notes-1.7.1.md +36 -0
- package/docs/release-record-1.5.1-20261028.md +258 -0
- package/docs/release-record-1.5.2-20261029.md +101 -0
- package/docs/release-record-1.7.0-20261030.md +58 -0
- package/docs/release-record-1.7.1-20261030.md +56 -0
- package/docs/repro-count-inconsistency.md +310 -0
- package/docs/review-collaboration-20261030.md +246 -0
- package/docs/root-cause-phase-percent.md +866 -0
- package/docs/state-progress-matrix.md +517 -0
- package/docs/status-grouping-ia.md +789 -0
- package/docs/stuck-review-1.3.0.md +646 -0
- package/docs/t4-contrast-measurement.json +496 -0
- package/docs/t4-contrast-measurement.md +177 -0
- package/docs/t8-fix-prioritization.md +105 -0
- package/docs/version-upgrade-rollback-1.5.0-20261028.md +654 -0
- package/docs/visual-refinement-spec.md +164 -0
- package/lib/host.js +3 -2
- package/lib/runtime.js +21 -0
- package/package.json +4 -2
- package/src/host.ts +3 -1
- package/src/runtime.ts +22 -0
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
# dsh-workplan 1.5.1 发布记录(发布已完成;含发布前基线、失败分支与回滚)
|
|
2
|
+
|
|
3
|
+
- 记录编写:T9 发布后验证与留痕(技术文档工程师),2026-10-28 22:43–22:46 +08:00
|
|
4
|
+
- 记录对象:`dsh-workplan` 1.5.1,提交 `fbe467b`,tag `v1.5.1`
|
|
5
|
+
- 一句话状态:**已对外发布并验证通过**——远端 `main` 与 tag `v1.5.1` 已更新,npm `1.5.1`
|
|
6
|
+
已发布且为 `dist-tags.latest`。§0 是发布后回填的实测结果;§1 起保留发布前的基线快照与预案。
|
|
7
|
+
- 本文所有"实测"均指本记录编写者亲自运行的命令(§0 为主 Agent 于 2026-10-28 22:46–22:50 +08:00
|
|
8
|
+
实测);凡引用他人结论均标注来源与可得性(见 §8)。
|
|
9
|
+
|
|
10
|
+
## 0. 实际发布结果(2026-10-28 22:46–22:50 +08:00 实测,发布后回填)
|
|
11
|
+
|
|
12
|
+
| # | 步骤 | 实测结果 |
|
|
13
|
+
|---|---|---|
|
|
14
|
+
| 1 | `git push origin refs/heads/main:refs/heads/main` | exit 0,`db74d44..fbe467b main -> main`(快进) |
|
|
15
|
+
| 2 | `git push origin refs/tags/v1.5.1:refs/tags/v1.5.1` | exit 0,`* [new tag] v1.5.1 -> v1.5.1` |
|
|
16
|
+
| 3 | `git ls-remote origin`(独立网络查询复核) | `refs/heads/main` = `fbe467b4a632a41a2b341c090e8231071b76b26e`;`refs/tags/v1.5.1` = `120dc2cb60f6380ff624d08bbc1e3cebc753b325`,`^{}` = `fbe467b4a632…`;`rev-list --left-right --count origin/main...HEAD` = `0 0` |
|
|
17
|
+
| 4 | `git worktree add --detach /tmp/dsh-wp-publish-1.5.1 v1.5.1` | 干净快照(`git status --porcelain` 为空),`package.json` = `dsh-workplan 1.5.1`,无 `private` 键,`publishConfig = {"access":"public"}` |
|
|
18
|
+
| 5 | 快照内逐文件比对(防"发的不是 tag 内容") | tar 内 22 个文件的 `git hash-object` 与 `git ls-tree -r v1.5.1` 逐一相同:`checked 22 / mismatch 0`,无多余文件(另 44 个仓库文件按 `files` 白名单正确排除) |
|
|
19
|
+
| 6 | `npm publish --ignore-scripts` | exit 0,`+ dsh-workplan@1.5.1`;`shasum a6f35bd1b3d2630e3a2cf9e9555b58e51b20eaba`;`integrity sha512-AmpYMx55…f0pEwUYOlgdqw==`;22 文件 / 250.6 kB / 解包 843.5 kB |
|
|
20
|
+
| 7 | 传播等待 + 直连复核(`curl`,`Cache-Control: no-cache`) | 22:48:58 HTTP 404 → 22:49:20 HTTP 404 → 22:49:41 **HTTP 200**;`time['1.5.1']` = `2026-10-28T14:49:36.697Z`(22:49:36 +08:00) |
|
|
21
|
+
| 8 | `dist-tags` / `versions` | `latest = 1.5.1`;versions = `0.0.0-stage, 1.4.3, 1.5.0, 1.5.1` |
|
|
22
|
+
| 9 | 下载已发布 tgz 并核验 | 本地 `shasum` = `a6f35bd1…`(与 registry `dist.shasum` 一致);22 文件;`package.json` = 1.5.1;`lib/host.js` 含 `version: '1.5.1'` |
|
|
23
|
+
| 10 | 制品内板块顺序复核 | `src/client.ts`:`h(PlanOverview` 在 1769 行、`h(Guide` 在 1775 行;编译后 `client.js`:`PlanOverview@88070 < Guide@88366` → **新顺序** |
|
|
24
|
+
| 11 | 消费者安装验证 | 空白目录 `npm i dsh-workplan@1.5.1 --prefer-online` → exit 0,装到 1.5.1,`client.js` 138 195 字节 |
|
|
25
|
+
|
|
26
|
+
**结论**:两个渠道均为最终状态,无"远端有 tag 而 npm 没有"的半发布态。§4(未发布原因)、
|
|
27
|
+
§5(发布步骤)、§6(失败分支与回滚)保留为历史记录与回退依据,不再代表当前状态。
|
|
28
|
+
|
|
29
|
+
**两个只在这一步才会暴露的坑(已实测)**:
|
|
30
|
+
1. **npm 元数据缓存**:22:50:04 首次 `npm i dsh-workplan@1.5.1` 返回 `ETARGET No matching version`,
|
|
31
|
+
加 `--prefer-online` 后同一命令成功——是客户端缓存了发布前的 packument,不是包没发上去。
|
|
32
|
+
2. **tar mtime 影响 `shasum`**:同一份内容在原工作树打包 `shasum` 为 `ecb39f0…`、在干净
|
|
33
|
+
`git worktree` 快照上为 `a6f35bd1…`;22 个文件的 blob 哈希逐一相同。实际发布的是干净快照这一份,
|
|
34
|
+
故以 `a6f35bd1…` / `sha512-AmpYMx55…` 为准。
|
|
35
|
+
|
|
36
|
+
## 1. 事实基线(发布前快照,实测于 2026-10-28 22:42–22:43 +08:00 / 14:42–14:43 UTC)
|
|
37
|
+
|
|
38
|
+
| 项 | 实测值 | 判定 |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| 工作目录 | `/Users/open/Documents/Stocks/plugins/dsh-workplan` | — |
|
|
41
|
+
| 本地 HEAD | `fbe467b4a632a41a2b341c090e8231071b76b26e` | 已就绪 |
|
|
42
|
+
| 提交时间 / 作者 | `2026-10-28T22:27:53+08:00` / `abbaababa <abbaababa@users.noreply.github.com>` | — |
|
|
43
|
+
| 本地 tag | `v1.5.1`(annotated,taggerdate `2026-10-28T22:28:51+08:00`,解引用 = `fbe467b`) | 已就绪 |
|
|
44
|
+
| 分支状态 | `## main...origin/main [ahead 1]`,工作树干净 | 本地领先 1 个提交 |
|
|
45
|
+
| 远端 `refs/heads/main` | `db74d44785c2359609906396932013348022152f`(1.5.0 的提交) | 未更新 |
|
|
46
|
+
| 远端 `refs/tags/v1.5.1` | 不存在(`git ls-remote` 无此行) | 未推送 |
|
|
47
|
+
| 远端 `refs/tags/v1.5.0` | `d409ea92ab45ba8eac8bfc24160cef8d1c1c3804` | 对照:远端标签通道可用 |
|
|
48
|
+
| npm `dsh-workplan` latest | `1.5.0` | 未发布 |
|
|
49
|
+
| npm `dsh-workplan@1.5.1` | `E404 No match found for version 1.5.1` | 未发布 |
|
|
50
|
+
| registry 直连 `/dsh-workplan/1.5.1` | `HTTP 404` | 排除客户端缓存 |
|
|
51
|
+
| registry 已有版本 | `0.0.0-stage`, `1.4.3`, `1.5.0` | 无 1.5.1 |
|
|
52
|
+
| registry `time.modified` | `2026-10-28T07:15:19.890Z`(= 15:15:19 +08:00) | 包在本次会话内未被写入 |
|
|
53
|
+
| 工具版本 | npm `12.0.2`,node `v26.9.0` | — |
|
|
54
|
+
|
|
55
|
+
**结论**:这是一个"已提交、已打标签、未推送、未发布"的状态,不存在需要收拾的半发布态
|
|
56
|
+
(不存在"远端有 tag 而 npm 没有"这类不一致)。
|
|
57
|
+
|
|
58
|
+
## 2. 制品(发什么)与校验值
|
|
59
|
+
|
|
60
|
+
在干净的 `v1.5.1` 快照上打包,22 个文件,`size` 250 615 字节,`unpackedSize` 843 535 字节。
|
|
61
|
+
|
|
62
|
+
| 校验类型 | 值 |
|
|
63
|
+
|---|---|
|
|
64
|
+
| npm `shasum`(SHA-1) | `ecb39f063f9aa5e5a7e318d4331a4c130876b47b` |
|
|
65
|
+
| `.tgz` 整文件 SHA-256 | `80f3cba730a1692c10efa8e8cb7d75b28dce41bcfd50554168279ac190279503` |
|
|
66
|
+
| npm `integrity`(SHA-512 SRI) | `sha512-kMpFNuP+vSJj7TmIjShxI1b5G0iEmpYBa6nuuHHd3+V+HU16vl1E6JIh1exz5BFa4XF2JZuD58Gf9ihqWD6VCQ==` |
|
|
67
|
+
|
|
68
|
+
**"制品 = tag 内容"的证明**(不是推断,是逐文件比对):
|
|
69
|
+
|
|
70
|
+
- `git diff v1.5.1 -- .` 为空;
|
|
71
|
+
- 把 `git archive v1.5.1` 解到 `/tmp/t9tag`,对 `npm pack --dry-run --json` 列出的 22 个文件
|
|
72
|
+
逐个算 SHA-256 比对:`checked 22 mismatch 0`。
|
|
73
|
+
- 因此 tag 里就是待发布的制品本身,没有版本漂移。
|
|
74
|
+
|
|
75
|
+
**为什么从 tag 打包而不是从工作树**:`CHANGELOG.md` 在 `package.json` 的 `files` 白名单里,
|
|
76
|
+
本文的回填改动会改变 tgz 的 shasum。所以发布动作必须在干净的 `v1.5.1` 快照上做(§5),
|
|
77
|
+
否则校验值失效、发布后核对会对不上。
|
|
78
|
+
|
|
79
|
+
**反例(实测,2026-10-28 22:46)**:在含本次 CHANGELOG 回填的**工作树**上再打包,
|
|
80
|
+
得到 `shasum` = `45161555ed3f7550557ed7b1248733918f2aa25d`、`size` 251 749 B(仍 22 文件)。
|
|
81
|
+
也就是说,同一份代码只要带上这份文档,指纹就变了——若从这个树发布,§6 的 `dist.integrity`
|
|
82
|
+
核对必然失败。这是 §5 要求用 `git worktree add … v1.5.1` 的直接原因。
|
|
83
|
+
|
|
84
|
+
## 3. 本次实际走的分支
|
|
85
|
+
|
|
86
|
+
| 分支 | 内容 | 本次是否走过 |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| A 正常双渠道发布 | `git push` 提交与标签 → `npm publish` → 发布后外部验证 | **未执行**(需写凭据,见 §4) |
|
|
89
|
+
| B 仅 git 渠道 | 只推标签、npm 记为"不适用" | **不适用**:`dsh-workplan` 已是公共包(1.4.3、1.5.0 均在 npm 上),渠道存在且应更新 |
|
|
90
|
+
| C 替代交付(离线 tgz) | 用 `git archive v1.5.1` 重建 tgz 直接分发 | **仅完成兜底准备**:可从 tag 重建,校验值已固化(§2);但 tgz 尚未交给任何外部使用者 |
|
|
91
|
+
| D 停在"发布前就绪" | 事实固化 + 一次性动作留给主 Agent | **实际停留在此**(本记录就是 D 的产物) |
|
|
92
|
+
|
|
93
|
+
C 之所以不能算"本次走替代交付":最终交付物要求"npm 分发渠道上存在 1.5.1 版本(**或明确记录该渠道
|
|
94
|
+
不适用及原因**)",而该渠道既存在又适用,只是尚未发布。因此 C 只是兜底,不能替代 A。
|
|
95
|
+
|
|
96
|
+
## 4. 发布前为何停在「就绪未发布」(历史记录;2026-10-28 22:46–22:49 已完成发布,见 §0)
|
|
97
|
+
|
|
98
|
+
1. **权限边界**:`npm publish` 是带写凭据的对外写操作;执行本子任务的子 Agent 权限被限定为
|
|
99
|
+
"可验证的只读核查",不能执行带凭据的写操作。
|
|
100
|
+
2. **不可逆性**:npm 版本号一旦发布不可重用;发错了只能 `npm deprecate` 或受政策限制的
|
|
101
|
+
`npm unpublish` 收拾,属于"一次性不可逆动作",必须由具备凭据的主 Agent 执行。
|
|
102
|
+
3. **顺序约束**:必须先确认"制品 = tag"(已实测,§2),再推送与发布;否则容易出现
|
|
103
|
+
"远端有 tag、npm 没有"的半发布态,那是最难收拾的状态。
|
|
104
|
+
4. **现状无需抢修**:npm 侧 1.5.1 完全不存在(404),不存在需要立刻纠正的错误发布。
|
|
105
|
+
|
|
106
|
+
可佐证的凭据侧前置条件(只读探测):`npm whoami` → **exit 0**(本机 npm 已登录;用户名不记录)。
|
|
107
|
+
远端 SSH 只读可达(`git ls-remote` 成功);**远端写权限未验证**(本子任务未尝试写操作)。
|
|
108
|
+
|
|
109
|
+
## 5. 发布步骤(已于 2026-10-28 22:46–22:49 执行完毕,结果见 §0;保留本节供复核与回退对照)
|
|
110
|
+
|
|
111
|
+
推荐顺序:先提交本次文档回填 → 推 main → 推标签 → **从 v1.5.1 快照发布**。
|
|
112
|
+
关键规则只有一条:`npm publish` 必须在干净的 `v1.5.1` 快照上跑,避免把发布后回填的文档打进
|
|
113
|
+
1.5.1 的 tgz。实测补充:干净快照打包得到的 `shasum` 是 `a6f35bd1…`,而原工作树打包是
|
|
114
|
+
`ecb39f0…`,差异仅来自 tar 记录的 mtime,22 个文件内容逐字节相同(见 §0 第 2 条坑)。
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
cd /Users/open/Documents/Stocks/plugins/dsh-workplan
|
|
118
|
+
# 1) 提交本次发布记录回填(纯文档,不触碰 lib/ client.js,CI 的"构建产物未过期"检查不受影响)
|
|
119
|
+
git add CHANGELOG.md docs/release-record-1.5.1-20261028.md
|
|
120
|
+
git commit -m "docs: record the 1.5.1 release state, checksums and rollback"
|
|
121
|
+
|
|
122
|
+
# 2) 推提交与标签(标签指向 fbe467b,不会因步骤 1 的文档提交而移动)
|
|
123
|
+
git push origin main
|
|
124
|
+
git push origin v1.5.1
|
|
125
|
+
|
|
126
|
+
# 3) 在干净的 tag 快照上发布(避免把文档回填打进 1.5.1 的 tgz)
|
|
127
|
+
git worktree add /tmp/publish-1.5.1 v1.5.1
|
|
128
|
+
cd /tmp/publish-1.5.1
|
|
129
|
+
npm publish --access public
|
|
130
|
+
|
|
131
|
+
# 4) 收尾
|
|
132
|
+
cd /Users/open/Documents/Stocks/plugins/dsh-workplan
|
|
133
|
+
git worktree remove /tmp/publish-1.5.1
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
可选(更保险):发布前先空跑一次,确认打包清单与校验值仍是 `ecb39f0…`:
|
|
137
|
+
|
|
138
|
+
```bash
|
|
139
|
+
cd /tmp/publish-1.5.1 && npm pack --dry-run --json | grep -m1 shasum
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
说明:`package.json` 里没有 `prepare` / `prepublishOnly` 脚本(只有 `clean`/`build`/`check`/`test`/
|
|
143
|
+
`verify`/`preview`),所以这个临时 worktree 即使没有 `node_modules` 也能直接发布,不需要先 `npm ci`。
|
|
144
|
+
|
|
145
|
+
## 6. 发布后验证(外部视角,期望输出写死)
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
npm view dsh-workplan@1.5.1 version # 期望:1.5.1
|
|
149
|
+
npm view dsh-workplan dist-tags --json # 期望:{"latest":"1.5.1"}
|
|
150
|
+
npm view dsh-workplan@1.5.1 dist.integrity # 期望:sha512-kMpFNuP+vSJj7…8Gf9ihqWD6VCQ==
|
|
151
|
+
npm view dsh-workplan@1.5.1 dist.tarball # 期望:…/dsh-workplan-1.5.1.tgz
|
|
152
|
+
git ls-remote origin refs/tags/v1.5.1 # 期望:非空(tag 对象 SHA)
|
|
153
|
+
git ls-remote origin refs/heads/main # 期望:包含 fbe467b 或其后的文档提交
|
|
154
|
+
npm pack dsh-workplan@1.5.1 --dry-run # 期望:shasum ecb39f063f9aa5e5a7e318d4331a4c130876b47b
|
|
155
|
+
curl -s -o /dev/null -w '%{http_code}\n' https://registry.npmjs.org/dsh-workplan/1.5.1 # 期望:200
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
判据:八条全部符合才算"对外可见";任何一条不符(尤其 `dist.integrity`)按 §7 处理。
|
|
159
|
+
|
|
160
|
+
## 7. 失败分支与回滚
|
|
161
|
+
|
|
162
|
+
| 阶段 | 失败现象 | 处置 | 可逆性 |
|
|
163
|
+
|---|---|---|---|
|
|
164
|
+
| 仅本地提交/标签 | 任何后续中止 | `git tag -d v1.5.1` + `git reset --hard db74d44`(会丢失 `fbe467b`) | 完全可逆,无外部影响 |
|
|
165
|
+
| push 被拒 | `! [rejected] main -> main (non-fast-forward)` | 先 `git fetch origin`、看 `git log --oneline origin/main..HEAD`;**禁止 force push 到 main** | 可逆 |
|
|
166
|
+
| push 成功、publish 未做 | 远端有 tag、npm 无 | 先补发布;若决定不发,`git push origin :refs/tags/v1.5.1` 删远端标签 + `git revert fbe467b` | 可逆 |
|
|
167
|
+
| publish 报 403 / OTP | `E403`、`need auth`、`one-time password` | `npm whoami` 复核;需 2FA 时 `npm publish --otp=<code>`;token 失效则 `npm login` | 未产生版本 |
|
|
168
|
+
| publish 报版本已存在 | `E409` / `EPUBLISHCONFLICT` | `npm view dsh-workplan@1.5.1` 确认;已存在就**不要改号重发**,先查是谁发的 | 未产生新版本 |
|
|
169
|
+
| publish 成功但 latest 未指向 | `dist-tags.latest` 仍为 1.5.0 | `npm dist-tag add dsh-workplan@1.5.1 latest` | 可逆 |
|
|
170
|
+
| publish 成功但校验值不符 | `dist.integrity` ≠ 上面 SRI | 立即停手:说明发布物与 tag 不一致;`npm deprecate` 兜底,再按流程重置 | 部分可逆 |
|
|
171
|
+
| 已发布且用户可能已安装 | — | 首选发布 1.5.2 修正 + `npm deprecate dsh-workplan@1.5.1 "…"`;`npm unpublish dsh-workplan@1.5.1 --force` 受 npm 官方政策限制(时间窗口、有依赖时不可撤销) | 不可完全撤销 |
|
|
172
|
+
|
|
173
|
+
代码侧回滚(与发布无关时使用):`.backups/pre-1.5.1-20261028-221343/` 下四个文件
|
|
174
|
+
(`package.json`、`package-lock.json`、`CHANGELOG.md`、`src/host.ts`),回滚后必须 `npm run build`。
|
|
175
|
+
|
|
176
|
+
## 8. 证据来源与可得性(逐条交代,不混淆转述与实测)
|
|
177
|
+
|
|
178
|
+
- **T8(外部视角验证,已完成)**:原文完整在本子任务上下文中,本记录 §1 的 npm / registry /
|
|
179
|
+
`ls-remote` 全部条目均与之逐条一致,并由本人于 22:42–22:43 重新实测复现:
|
|
180
|
+
`npm view` → 1.5.0、`@1.5.1` → E404、registry 直连 404、`versions` 三项、`ls-remote` 无 v1.5.1、
|
|
181
|
+
`main` = `db74d44`。T8 记录的"绕过缓存重试""`npm pack 1.5.0` 对照组成功"未重复执行,
|
|
182
|
+
但结论已被本次直连 registry 的 404 独立支持。
|
|
183
|
+
- **T7(发布前预检)**:原文未在本子任务上下文中提供,仅有摘要(记录 shasum `ecb39f0…`、
|
|
184
|
+
sha256 `80f3cba…`、22 文件 250.6 kB、临时目录已删)。**处理方式**:本次重新打包实测,
|
|
185
|
+
三组数值与摘要完全一致,故按"已由本次实测独立复现"引用,不按"引用 T7 原文"标注。
|
|
186
|
+
- **T5**:原文未在本子任务上下文中提供,**其日志未验证**。可间接复核的只有其产物:
|
|
187
|
+
提交 `fbe467b` 的 7 个文件改动(`git show --stat`)、7 处版本号一致(`package.json` 1.5.1)、
|
|
188
|
+
以及 `npm run verify` 的 99/99 测试结论(记录在 `CHANGELOG.md` 1.5.1「验证」节)。
|
|
189
|
+
- **本人本次实跑的命令(原文与结果,时间戳为 2026-10-28 +08:00)**:
|
|
190
|
+
- `22:42:23` `git status --porcelain -b` → `## main...origin/main [ahead 1]`(干净)
|
|
191
|
+
- `22:42:23` `git rev-parse HEAD` → `fbe467b4a632a41a2b341c090e8231071b76b26e`
|
|
192
|
+
- `22:42:23` `git cat-file -t v1.5.1` → `tag`;`git rev-parse v1.5.1^{}` → `fbe467b…`
|
|
193
|
+
- `22:42:23` `git ls-remote origin refs/tags/v1.5.1 refs/tags/v1.5.0 refs/heads/main`
|
|
194
|
+
→ 仅 `db74d44… refs/heads/main`、`d409ea9… refs/tags/v1.5.0`
|
|
195
|
+
- `22:42:48` `npm view dsh-workplan version` → `1.5.0`
|
|
196
|
+
- `22:42:48` `npm view dsh-workplan dist-tags --json` → `latest: 1.5.0`
|
|
197
|
+
- `22:42:48` `npm view dsh-workplan@1.5.1 version` → `E404 No match found for version 1.5.1`
|
|
198
|
+
- `22:43` `curl -o /dev/null -w '%{http_code}' https://registry.npmjs.org/dsh-workplan/1.5.1` → `404`
|
|
199
|
+
- `22:43` `curl https://registry.npmjs.org/dsh-workplan` → `versions [0.0.0-stage, 1.4.3, 1.5.0]`,
|
|
200
|
+
`modified 2026-10-28T07:15:19.890Z`
|
|
201
|
+
- `22:43` `npm pack --dry-run --json` → 22 文件 / 250615 B / `shasum ecb39f0…` / `integrity sha512-kMpF…`
|
|
202
|
+
- `22:43` `npm pack --pack-destination /tmp/t9pack` → sha1 `ecb39f0…`、sha256 `80f3cba…`
|
|
203
|
+
- `22:43` `git archive v1.5.1` 解包后逐文件比对 → `checked 22 mismatch 0`
|
|
204
|
+
- `22:43` `npm whoami` → exit 0(已登录)
|
|
205
|
+
- `22:43` `cat .github/workflows/verify.yml` → 只有 `verify` job,**无 publish job**,
|
|
206
|
+
即发布是手工动作,CI 不会代发
|
|
207
|
+
- `22:45:07` `git status --porcelain`(写入本文与 CHANGELOG 回填后)→ ` M CHANGELOG.md`、
|
|
208
|
+
`?? docs/release-record-1.5.1-20261028.md`
|
|
209
|
+
- 清理:`/tmp/t9pack`、`/tmp/t9tag`、`/tmp/t9tag.tar`、`/tmp/t9work` 已删除(`ls -d /tmp/*t9*`
|
|
210
|
+
无输出);仓库内未留下任何 `.tgz`(`git status` 只显示上面两项文档改动)。
|
|
211
|
+
|
|
212
|
+
## 9. 知识库条目草稿(**未写入,等主 Agent 决定**)
|
|
213
|
+
|
|
214
|
+
> 说明:以下为草稿,未调用任何知识库写入接口。是否收录、是否合并为一条,由主 Agent 决定。
|
|
215
|
+
|
|
216
|
+
### 草稿 1(事实页):dsh-workplan 1.5.1 的发布状态
|
|
217
|
+
|
|
218
|
+
- 标题:`dsh-workplan 1.5.1: published to GitHub (tag v1.5.1) and npm (latest)`
|
|
219
|
+
- 正文要点:1.5.1 是"展开态计划卡里『分步进度』与『先看这三句』位置对换"的补丁版;
|
|
220
|
+
提交 `fbe467b`(2026-10-28 22:27:53 +08:00)与 annotated tag `v1.5.1`(22:28:51 +08:00);
|
|
221
|
+
**2026-10-28 22:46–22:49 已完成发布**:远端 `main` = `fbe467b`、远端标签 `v1.5.1` 已建;
|
|
222
|
+
npm `1.5.1` 已发布(`time['1.5.1']` = `2026-10-28T14:49:36.697Z`),`dist-tags.latest` = `1.5.1`。
|
|
223
|
+
已发布制品指纹见草稿 3(以 `a6f35bd1…` 为准)。发布前"未发布"的状态只属于历史快照(§1)。
|
|
224
|
+
|
|
225
|
+
### 草稿 2(决策/规则):发布顺序与"干净快照"规则
|
|
226
|
+
|
|
227
|
+
- 标题:`Release rule: publish from a clean version tag, never from a dirty tree`
|
|
228
|
+
- 正文要点:`CHANGELOG.md` 在 `package.json` 的 `files` 白名单内,任何发布后文档回填都会改变
|
|
229
|
+
tgz 的 `shasum`;因此发布必须在 `git worktree add … <tag>` 得到的干净快照上执行,
|
|
230
|
+
发布后再提交文档回填。顺序:commit 回填 → push main → push tag → 从 tag 发布 → 外部验证。
|
|
231
|
+
违反该规则会导致"记录的校验值 ≠ 发布的制品",发布后核对会被误判为失败。
|
|
232
|
+
|
|
233
|
+
### 草稿 3(基线数值):1.5.1 制品指纹
|
|
234
|
+
|
|
235
|
+
- 标题:`dsh-workplan@1.5.1 artifact fingerprints`
|
|
236
|
+
- 正文要点:22 文件 / 250 615 B / 解包 843 535 B。
|
|
237
|
+
- **实际发布(干净 `git worktree` 快照,以 registry `dist` 为准)**:`shasum`(SHA-1)
|
|
238
|
+
`a6f35bd1b3d2630e3a2cf9e9555b58e51b20eaba`;`integrity`
|
|
239
|
+
`sha512-AmpYMx55Y0ea2tAc14C4V7t/Pxrho+9nZXZqxz7JtdPYvFRyxS+wzEIUCfATRgq5cogT22lTSf0pEwUYOlgdqw==`。
|
|
240
|
+
- 原工作树打包(同为 22 文件、内容逐字节相同,仅 tar mtime 不同):`shasum ecb39f0…`、
|
|
241
|
+
SHA-256 `80f3cba730a1692c10efa8e8cb7d75b28dce41bcfd50554168279ac190279503`。
|
|
242
|
+
- 证明"制品 = tag 内容":tar 内 22 个文件的 `git hash-object` 与 `git ls-tree -r v1.5.1`
|
|
243
|
+
逐一相同(`checked 22 / mismatch 0`)。
|
|
244
|
+
|
|
245
|
+
### 草稿 4(经验):`npm unpublish` 不是可靠的撤销手段
|
|
246
|
+
|
|
247
|
+
- 标题:`npm rollback: deprecate first, unpublish is constrained`
|
|
248
|
+
- 正文要点:版本一旦发布,优先用 `npm deprecate` 引导用户;`npm unpublish --force` 受官方政策
|
|
249
|
+
限制(可撤销时间窗口、有包依赖时不可撤销),且不能消除已写入 lockfile 的校验值。
|
|
250
|
+
真正可靠的修正是"发 1.5.2 并 deprecate 1.5.1"。
|
|
251
|
+
|
|
252
|
+
## 10. 待办(交给主 Agent)
|
|
253
|
+
|
|
254
|
+
1. ~~按 §5 执行 `git push` + `npm publish`~~ → **已于 2026-10-28 22:46–22:49 完成**(结果见 §0)。
|
|
255
|
+
2. ~~按 §6 逐条验证并回填~~ → 已回填到 §0(含 registry、tgz、消费者安装三路验证)。
|
|
256
|
+
3. 仍待决定:§9 四条草稿是否写入知识库(本条未执行,属主 Agent 的后续判断)。
|
|
257
|
+
4. 剩余可选动作:重启/重载 DSH web profile 后刷新页面,在运行实例里目视确认换序
|
|
258
|
+
(本次发布未重启任何服务)。
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# dsh-workplan 1.5.2 发布记录(发布已完成;含发布前基线、CI 红转绿与回滚)
|
|
2
|
+
|
|
3
|
+
- 记录对象:`dsh-workplan` 1.5.2,提交 `666b0fe`,annotated tag `v1.5.2`
|
|
4
|
+
- 发布时间:2026-10-29 13:21–13:25 +08:00(registry 记录 `2026-10-29T05:24:48.346Z`)
|
|
5
|
+
- 一句话状态:**已对外发布并验证通过**——远端 `main`、tag `v1.5.2`、npm `1.5.2`
|
|
6
|
+
(`dist-tags.latest`)三者一致,无半发布态。
|
|
7
|
+
- 本文所有"实测"均为主 Agent 在本机亲自运行的命令;时间均为 `+08:00`。
|
|
8
|
+
|
|
9
|
+
## 0. 实际发布结果
|
|
10
|
+
|
|
11
|
+
| # | 步骤 | 实测结果 |
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| 1 | `npm run verify`(提交前门禁) | exit 0;`tsc --noEmit` 无输出;`node --test` **120 pass / 0 fail**,4.16 s |
|
|
14
|
+
| 2 | `git add -A && git commit` | `666b0fe fix: ship dsh-workplan 1.5.2 with progress and phase on one source of truth`;22 文件,+4 477 / −114 |
|
|
15
|
+
| 3 | `git tag -a v1.5.2 -m …` | tag 对象 `155c601c73d76f25a97cc0996e53c9e04407ea01` → 提交 `666b0fee483b00714f4ad401af7ffb18c4f2a214` |
|
|
16
|
+
| 4 | `npm run build` 后 `git diff --exit-code -- lib client.js`(CI 同名检查) | 重编译产物与提交逐字节一致,diff 为空;工作树 `git status --porcelain` 为空 |
|
|
17
|
+
| 5 | `git push origin main` | exit 0,`b0e0b76..666b0fe main -> main`(快进) |
|
|
18
|
+
| 6 | `git push origin v1.5.2` | exit 0,`* [new tag] v1.5.2 -> v1.5.2` |
|
|
19
|
+
| 7 | `git ls-remote origin`(独立网络查询复核) | `refs/heads/main` = `666b0fee483b…`;`refs/tags/v1.5.2` = `155c601c73d7…`,`^{}` = `666b0fee483b…` |
|
|
20
|
+
| 8 | `git worktree add --detach /tmp/dsh-wp-1.5.2 v1.5.2` → `npm pack` | 干净快照;`package.json` = `dsh-workplan 1.5.2`、无 `private`、`publishConfig = {"access":"public"}`;22 文件 / 269 264 B / 解包 888 135 B |
|
|
21
|
+
| 9 | `npm publish ./dsh-workplan-1.5.2.tgz --access public --ignore-scripts` | exit 0,`+ dsh-workplan@1.5.2`,tag `latest`,public |
|
|
22
|
+
| 10 | 传播等待 + 直连复核(`curl`) | 404 ×3(约 45 s)→ **HTTP 200**;`time['1.5.2']` = `2026-10-29T05:24:48.346Z` |
|
|
23
|
+
| 11 | `dist-tags` / `versions` | `latest = 1.5.2`;versions = `0.0.0-stage, 1.4.3, 1.5.0, 1.5.1, 1.5.2` |
|
|
24
|
+
| 12 | 下载已发布 tgz 并核验 | `shasum` = `2159024d…`、SHA-256 = `4482f202…`,与本地打包逐字节相同 |
|
|
25
|
+
| 13 | 消费者安装验证 | 空白目录 `npm i dsh-workplan@1.5.2` → `meta = {"name":"dsh-workplan","version":"1.5.2",…}` |
|
|
26
|
+
|
|
27
|
+
## 1. 发布前基线
|
|
28
|
+
|
|
29
|
+
- 工作树:14 个已跟踪文件被修改(+837 / −114)+ 8 个未跟踪文件(3 份根因/矩阵/修复报告、
|
|
30
|
+
3 个脚本、2 个新测试文件),全部随发布提交入库,避免"CHANGELOG 引用的文档在 tag 上 404"。
|
|
31
|
+
- 门禁:`npm run verify` 120/120;构建可复现(`git diff --exit-code -- lib client.js` 为空);
|
|
32
|
+
版本 7 处一致(`package.json`、`package-lock.json` 两处、`src/host.ts`、`lib/host.js`、
|
|
33
|
+
`dist/host.js`、`CHANGELOG.md` 顶部)。
|
|
34
|
+
- 安全快检:10 类高置信度凭据模式 0 命中;运行时依赖 0 个;`npm audit` 0 漏洞;
|
|
35
|
+
`package-lock.json` 逐条锁定版本 + integrity;无 `preinstall/install/postinstall/prepare` 脚本。
|
|
36
|
+
- 回滚资产:`.backups/pre-1.5.2-20261029-125724/`(`package.json`、`package-lock.json`、
|
|
37
|
+
`CHANGELOG.md`、`src/host.ts`,取自 `git show HEAD:`)。
|
|
38
|
+
|
|
39
|
+
## 2. 已发布制品的校验值
|
|
40
|
+
|
|
41
|
+
- npm `shasum`(SHA-1):`2159024d69c05b3aeeefd5e7ff2f208ec05c67a2`
|
|
42
|
+
- npm `integrity`(SHA-512 SRI):
|
|
43
|
+
`sha512-sY7UgT09JwfRFe61HKCOCH7wLz0xbdAxyLla3WO8xoyZ/T6Yxb6H/IqRFf9LEX9EsnW7+z4jcHICms6RKPmTzQ==`
|
|
44
|
+
- 本地 `.tgz` SHA-256:`4482f202d098bbaec35051e54440d0d2be6e0099b6d6606e3c582b88e1aee9fa`
|
|
45
|
+
- 制品 = tag 快照:`.tgz` 在 `git worktree add --detach … v1.5.2` 的干净检出上打包,
|
|
46
|
+
发布的正是这份文件,因此 22 个文件全部取自 `666b0fe`。
|
|
47
|
+
- `dist.fileCount = 22`;`tests/`、`docs/`、`scripts/` 按 `files` 白名单不入包。
|
|
48
|
+
|
|
49
|
+
## 3. CI 红转绿(与 1.5.2 内容无关的既有缺陷)
|
|
50
|
+
|
|
51
|
+
- tag 提交的 verify 运行 `40823115340` = **failure**:20 个用例报
|
|
52
|
+
`cancelledByParent: Promise resolution is still pending but the event loop has already resolved`。
|
|
53
|
+
- 对照 1.5.1 / 1.5.0 / 1.4.3 的推送运行(`40710236377` / `40709317714` / `40646355248`),
|
|
54
|
+
`cancelledByParent` 条数**均为 20** → 属于一直在红的既有 CI 缺陷,不是本次改动引入。
|
|
55
|
+
- 根因:运行时故意把轮次预算 / 空闲 / 硬超时计时器 `unref`(避免关闭中的宿主被它们held住);
|
|
56
|
+
Node 22 在事件循环清空时会取消仍挂起的测试,于是"等超时"的用例在 CI(Node 22)必失败,
|
|
57
|
+
而本机 Node 26 通过。
|
|
58
|
+
- 修复:`9f0de34 test: keep the event loop alive while timeout tests wait`——
|
|
59
|
+
`tests/workplan-budget-pause.test.ts` 与 `tests/workplan-stuck-recovery.test.ts` 在文件作用域
|
|
60
|
+
持有一个 ref 句柄(真实宿主里由 HTTP server 承担),`after()` 钩子释放,60 s 后自动脱落,
|
|
61
|
+
真卡死时仍会失败而不是挂住 CI。
|
|
62
|
+
- 证据:本机 Node **22.23.4** 全量 `node --test dist-tests/tests/*.test.js` → 120/120 pass、
|
|
63
|
+
0 cancelled、4.09 s(修复前同一 Node 22 上 `workplan-budget-pause` 13/13 全部 cancelled、
|
|
64
|
+
`workplan-stuck-recovery` 7 个 cancelled);Node 26 `npm test` → 120/120。
|
|
65
|
+
- 修复后推送 `9f0de34` 的运行 `40823694198` = **success**(Install / Typecheck and test /
|
|
66
|
+
stale-build check 全绿)。
|
|
67
|
+
- CI 修复只改 `tests/`,制品不变:`git diff --stat v1.5.2 -- . ':!tests' ':!docs' ':!scripts'` 为空。
|
|
68
|
+
|
|
69
|
+
## 4. 需注意的生效方式
|
|
70
|
+
|
|
71
|
+
- **npm / git 已完成**:消费者 `npm i dsh-workplan@1.5.2` 即得新代码。
|
|
72
|
+
- **本机 DSH 进程仍是 1.5.1 的内存副本**:`lib/*.js`(host 侧)在 DSH 下次启动时才加载;
|
|
73
|
+
`client.js` 随页面刷新生效。因此界面上的「已完成 / 进行中」对账会在刷新后立刻正确,
|
|
74
|
+
但 `updateStatus`、回放、取消等宿主逻辑要重启 DSH 后才换成 1.5.2。
|
|
75
|
+
- 插件目录以符号链接挂进 profile,重启即生效,无需重新安装。
|
|
76
|
+
|
|
77
|
+
## 5. 回滚
|
|
78
|
+
|
|
79
|
+
- npm:`npm deprecate dsh-workplan@1.5.2 "回滚说明"` 先引导;确需撤销时
|
|
80
|
+
`npm unpublish dsh-workplan@1.5.2 --force`(受 npm unpublish 政策约束,执行前核对官方文档)。
|
|
81
|
+
- git:`git push origin :refs/tags/v1.5.2` 删远端标签,`git revert 666b0fe` 回退提交
|
|
82
|
+
(不要 `push --force` 改写远端 `main` 历史)。
|
|
83
|
+
- 本机:用 `.backups/pre-1.5.2-20261029-125724/` 覆盖四个文件后 `npm run build`
|
|
84
|
+
(运行中的进程不会自动重载 `lib/host.js`,需重启)。
|
|
85
|
+
|
|
86
|
+
## 6. 时间线(+08:00)
|
|
87
|
+
|
|
88
|
+
- 12:46 根因诊断完成(`docs/root-cause-phase-percent.md`)
|
|
89
|
+
- 12:57 版本升 1.5.2(备份 `.backups/pre-1.5.2-20261029-125724/`)
|
|
90
|
+
- 13:11 第二批同类修复 + `tests/phase-percent-invariant.test.ts`、`tests/completion-semantics.test.ts`
|
|
91
|
+
- 13:18–13:23 12 项发布准备子任务(5 项完成,7 项因 subagent 服务不可用受阻;发布动作由主 Agent 执行)
|
|
92
|
+
- 13:20 `npm run verify` 120/120
|
|
93
|
+
- 13:21 提交 `666b0fe` + tag `v1.5.2`
|
|
94
|
+
- 13:22 推送 `main` 与 tag
|
|
95
|
+
- 13:23 CI 运行 `40823115340` 失败(既有 20 cancelled)
|
|
96
|
+
- 13:24 `npm publish` → `+ dsh-workplan@1.5.2`
|
|
97
|
+
- 13:25 registry 200;`dist-tags.latest = 1.5.2`
|
|
98
|
+
- 13:25 消费者安装验证通过
|
|
99
|
+
- 13:26 Node 22 复现 CI 失败并定位到 `unref` 计时器
|
|
100
|
+
- 13:30 CI 修复提交 `9f0de34` 推送
|
|
101
|
+
- 13:33 运行 `40823694198` 全绿
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
# 1.7.0 发布记录(2026-10-30)
|
|
2
|
+
|
|
3
|
+
可复核的一次性时间线。所有值来自发布当时的命令输出,命令可原样重跑。
|
|
4
|
+
|
|
5
|
+
## 版本与提交
|
|
6
|
+
|
|
7
|
+
| 项 | 值 |
|
|
8
|
+
|---|---|
|
|
9
|
+
| 版本 | `1.7.0` |
|
|
10
|
+
| 提交 | `cb40b7a8e0af05378558fba15c629d7ffdc6f368`(`Release 1.7.0: collaboration contract, async dispatch, write guards`) |
|
|
11
|
+
| 标签 | `v1.7.0`(annotated) |
|
|
12
|
+
| 分支 | `main` → `e36eeb9..cb40b7a` |
|
|
13
|
+
| CI | GitHub Actions `verify` 在 `cb40b7a` 上 **success** |
|
|
14
|
+
|
|
15
|
+
## GitHub Release
|
|
16
|
+
|
|
17
|
+
| 项 | 值 |
|
|
18
|
+
|---|---|
|
|
19
|
+
| URL | https://github.com/abbaababa/dsh-workplan/releases/tag/v1.7.0 |
|
|
20
|
+
| 制品 | `dsh-workplan-1.7.0.tgz`,311 709 字节 |
|
|
21
|
+
| 制品 sha256 | `85bdb32f4747bb8c13e5bb0d139b6b4c18b6487d07ef296d97c957a148e886df` |
|
|
22
|
+
| 可用性 | `curl -sIL` → **HTTP 200** |
|
|
23
|
+
|
|
24
|
+
## npm
|
|
25
|
+
|
|
26
|
+
| 项 | 值 |
|
|
27
|
+
|---|---|
|
|
28
|
+
| 包 | `dsh-workplan@1.7.0`(public,24 个文件解包后 1.0 MB) |
|
|
29
|
+
| dist-tags | `latest = 1.7.0`(`npm view dsh-workplan@latest version` → `1.7.0`) |
|
|
30
|
+
| shasum | `fa065c4fbdd53b97e91d7329192419139c28cad7` |
|
|
31
|
+
| integrity | `sha512-90e4AJ5WwbTFojqLCNdLN3ouuEBncJ5ORVskao2aDJRU4IN7fUwwwOwx9YY1vgUdnAGNudsI/21b4y09dgdAGg==` |
|
|
32
|
+
| tarball | https://registry.npmjs.org/dsh-workplan/-/dsh-workplan-1.7.0.tgz |
|
|
33
|
+
|
|
34
|
+
## 索引源(dsh-plugin-catalog)
|
|
35
|
+
|
|
36
|
+
| 项 | 值 |
|
|
37
|
+
|---|---|
|
|
38
|
+
| 上游条目 | `awesome-dsh-plugin/awesome-dsh-plugin` → `data/plugins/abbaababa__dsh-workplan.yml` |
|
|
39
|
+
| 改动 | `tarball:` 由 `v1.5.0/dsh-workplan-1.5.0.tgz` 改为 `v1.7.0/dsh-workplan-1.7.0.tgz` |
|
|
40
|
+
| PR | https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/10528(fork 分支 `bump-dsh-workplan-1.7.0`,提交 `dc2c49b`) |
|
|
41
|
+
| 状态 | **待上游合并**;catalog 的 npm 发版由上游 CI 触发,本仓库无权限 |
|
|
42
|
+
|
|
43
|
+
合并后复验(`s-maxage=43200`,CDN 最长 12 小时):
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
npm view dsh-plugin-catalog@latest version
|
|
47
|
+
curl -s https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json | grep -o '"id":"dsh-workplan"' | head -1
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## 本地与远端一致性
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
git tag -l 'v1.7.0' # v1.7.0
|
|
54
|
+
git rev-parse v1.7.0^{commit} # cb40b7a...
|
|
55
|
+
git status --short # 干净(发布记录这次提交除外)
|
|
56
|
+
npm test # 180 pass / 0 fail
|
|
57
|
+
npm run check # 通过
|
|
58
|
+
```
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# dsh-workplan 1.7.1 发布记录(2026-10-30)
|
|
2
|
+
|
|
3
|
+
补丁版本,只修 1.7.0 的激活失败,不改协作契约。
|
|
4
|
+
|
|
5
|
+
## 做了什么
|
|
6
|
+
|
|
7
|
+
| 项 | 值 |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 提交 | `205fa5e` Release 1.7.1: fix plugin activation by keeping tool schemas inside the host subset |
|
|
10
|
+
| 标签 | `v1.7.1`(annotated,已 push) |
|
|
11
|
+
| 制品 | `dsh-workplan-1.7.1.tgz`,312421 B,sha256 `690773d0402a8a6716760657dc10392f6feb70e0617b652ec1207460271e59ec`,22 files |
|
|
12
|
+
| GitHub Release | https://github.com/abbaababa/dsh-workplan/releases/tag/v1.7.1 |
|
|
13
|
+
| npm | `dsh-workplan@1.7.1`,dist-tag `latest` |
|
|
14
|
+
| 索引源 PR | https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/10528 (head 分支 `bump-dsh-workplan-1.7.0`,提交 `b1595d2`,tarball 指向 v1.7.1) |
|
|
15
|
+
|
|
16
|
+
## 根因
|
|
17
|
+
|
|
18
|
+
`statusToolOutputSchema()` 用 `type: ['number', 'null']` 表达可空耗时,`dsh_workplan_update` 的
|
|
19
|
+
`progress` 用了 `minimum` / `maximum`。宿主的 `assertSupportedJsonSchema` 只接受单一类型字符串、
|
|
20
|
+
且关键字子集不含 `minimum`/`maximum`,于是在**激活阶段**抛 `JsonSchemaError`,整个插件条目被跳过:
|
|
21
|
+
面板没有数据,四个工具全部消失,终端只有一行 `dsh: warning: 1 entry did not activate`。
|
|
22
|
+
|
|
23
|
+
## 修复
|
|
24
|
+
|
|
25
|
+
1. `elapsedMs` → `oneOf: [{ type: 'number' }, { type: 'null' }]`;
|
|
26
|
+
2. `progress` 去掉 `minimum`/`maximum`,范围写进 description;
|
|
27
|
+
3. `cancel` 输出 schema 提为 `cancelToolOutputSchema()`,与其余 schema 共用导出与校验;
|
|
28
|
+
4. 新增 `tests/workplan-host-schema.test.ts`(3 用例,按宿主子集递归校验 parameters / output.schema);
|
|
29
|
+
5. 发布前用宿主真实 `assertSupportedJsonSchema` 校验四个工具(临时脚本,不入依赖)。
|
|
30
|
+
|
|
31
|
+
## 复验命令(可照抄)
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
# 1) 已发布的版本与制品
|
|
35
|
+
npm view dsh-workplan@latest version dist.tarball
|
|
36
|
+
gh release view v1.7.1 --json assets --jq '.assets[] | "\(.name) \(.size)"'
|
|
37
|
+
|
|
38
|
+
# 2) 真正的安装结果
|
|
39
|
+
cd /tmp && rm -rf wp171 && mkdir wp171 && cd wp171 && npm init -y >/dev/null && npm i dsh-workplan@1.7.1
|
|
40
|
+
node -e "console.log(require('./node_modules/dsh-workplan/package.json').version)"
|
|
41
|
+
grep -n "oneOf: \[{ type: 'number' }, { type: 'null' }\]" node_modules/dsh-workplan/lib/runtime.js
|
|
42
|
+
|
|
43
|
+
# 3) 本机 profile 已指向仓库构建(重启 DSH Web 后生效)
|
|
44
|
+
grep -c "oneOf" /Users/open/.dsh/profiles/web/node_modules/dsh-workplan/lib/runtime.js
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 结果
|
|
48
|
+
|
|
49
|
+
- `npm test` 183 通过,`npm run check` 通过,`npm run build` 成功。
|
|
50
|
+
- `/tmp/wp171` 安装 1.7.1 后版本号正确、0 dependencies、`oneOf` 修复在制品中。
|
|
51
|
+
- `npm view dsh-workplan dist-tags` → `latest: 1.7.1`。
|
|
52
|
+
|
|
53
|
+
## 回滚
|
|
54
|
+
|
|
55
|
+
`dsh plugin --profile web add dsh-workplan@1.7.0` 会装回无法激活的版本,不建议;
|
|
56
|
+
如确需回滚,用 `@1.6.0`(1.7 的所有能力随之消失)。
|