dsh-workplan 1.7.1 → 1.8.1

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.
Files changed (45) hide show
  1. package/CHANGELOG.md +72 -0
  2. package/README.en.md +42 -1
  3. package/README.md +43 -1
  4. package/SECURITY.md +120 -0
  5. package/docs/SBOM.md +113 -0
  6. package/docs/cc/AVA-VULNERABILITY-ANALYSIS.md +97 -0
  7. package/docs/cc/CC-2026-ASSESSMENT.md +266 -0
  8. package/docs/cc/SECURITY-TARGET.md +244 -0
  9. package/docs/collaboration.md +440 -0
  10. package/docs/collapse-interaction-spec.md +272 -0
  11. package/docs/defect-report-count-inconsistency.md +370 -0
  12. package/docs/departments.md +194 -0
  13. package/docs/design-proposals/state-machine.reference.ts +836 -0
  14. package/docs/design-proposals/state-machine.test.reference.ts +655 -0
  15. package/docs/fix-report-derived-counts-1.4.3.md +199 -0
  16. package/docs/fix-report-phase-percent-1.5.2.md +284 -0
  17. package/docs/preview/progress-visual-1.5.0.html +683 -0
  18. package/docs/progress-visualization-clarify-20261028.md +211 -0
  19. package/docs/progress-visualization-design-20261028.md +607 -0
  20. package/docs/progress-visualization-locate-20261028.md +159 -0
  21. package/docs/progress-visualization-report-1.5.0.md +140 -0
  22. package/docs/release-notes-1.7.0.md +46 -0
  23. package/docs/release-notes-1.7.1.md +36 -0
  24. package/docs/release-notes-1.8.0.md +80 -0
  25. package/docs/release-notes-1.8.1.md +69 -0
  26. package/docs/release-record-1.5.1-20261028.md +258 -0
  27. package/docs/release-record-1.5.2-20261029.md +101 -0
  28. package/docs/release-record-1.7.0-20261030.md +58 -0
  29. package/docs/release-record-1.7.1-20261030.md +56 -0
  30. package/docs/repro-count-inconsistency.md +310 -0
  31. package/docs/review-collaboration-20261030.md +246 -0
  32. package/docs/root-cause-phase-percent.md +866 -0
  33. package/docs/state-progress-matrix.md +517 -0
  34. package/docs/status-grouping-ia.md +789 -0
  35. package/docs/stuck-review-1.3.0.md +646 -0
  36. package/docs/t4-contrast-measurement.json +496 -0
  37. package/docs/t4-contrast-measurement.md +177 -0
  38. package/docs/t8-fix-prioritization.md +105 -0
  39. package/docs/version-upgrade-rollback-1.5.0-20261028.md +654 -0
  40. package/docs/visual-refinement-spec.md +164 -0
  41. package/lib/host.js +20 -3
  42. package/lib/runtime.js +21 -0
  43. package/package.json +4 -2
  44. package/src/host.ts +20 -2
  45. package/src/runtime.ts +22 -0
@@ -0,0 +1,159 @@
1
+ # T1 定位报告 — dsh-workplan「画圈进度区」(2026-10-28)
2
+
3
+ 状态:**定位完成,未改动任何代码。**
4
+ 插件根:`<repo>`,当前版本 **1.4.3**。
5
+ 运行侧:`~/.dsh/profiles/web/package.json:18` 以 `link:<repo>` 挂载,`:44` bundles 启用;`node_modules/dsh-workplan` 为指向该目录的符号链接(`package.json` 版本同为 1.4.3)。
6
+
7
+ ---
8
+
9
+ ## 0. 证据与前提
10
+
11
+ - 用户截图:`~/.dsh/attachments/v1/objects/84/848e3c3789bb1a6e997f5cc311b55748c183e93f158a8aae35320371a0e40228`
12
+ JPEG 1320×2665,mtime 2026-10-28 13:34,早于本会话开始(13:35),画面内容与任务描述「画圈」一致。
13
+ **该截图未随子任务正文下发,归属未由用户直接逐字确认**(按时间 + 内容匹配判定)。
14
+ - 视口推断:1320 / 3 = **440 CSS px**(DPR 3),命中 `@media (max-width: 600px)`,故统计条 2 列、计划卡单列。
15
+ - 截图中统计条:2 个任务 / 12 分配工作 / 0 做好了 / 2 正在做 / 0 卡住了。
16
+ - 红色手绘圈 3 处,对应关系见 §2。截图中文字与 1.4.3 布局一致;**未逐字节验证截图对应的构建产物**。
17
+
18
+ ---
19
+
20
+ ## 1. 版本与构建事实
21
+
22
+ | 项 | 路径 / 值 |
23
+ |---|---|
24
+ | 版本号(包) | `package.json:3` → `1.4.3` |
25
+ | 版本号(代码内) | `src/host.ts:328` → `version: '1.4.3'`;`lib/host.js:297` 同值 |
26
+ | 类型 | 全部源码为 TypeScript:`src/client.ts`、`src/plan.ts`、`src/runtime.ts`、`src/host.ts`、`src/watchdog.ts`、`src/globals.d.ts` |
27
+ | 编译 | `tsconfig.json`:`strict: true`、`target ES2022`、`module/moduleResolution NodeNext`、`rootDir src`、`outDir dist` |
28
+ | 构建 | `npm run build` = `tsc` → 复制 `dist/client.js` 到根 `client.js`,`dist/{plan,runtime,host,watchdog}.js` 到 `lib/` |
29
+ | 依赖 | `chart.js ^4.6.1`(已存在,非新增候选) |
30
+ | 仓库 | 插件目录**无 .git**;备份走 `.backups/*.tar.gz` |
31
+ | 当前快照哈希 | `package.json` 8f865285…f6912e;`src/client.ts` 62aa22fe…d8937f3;`client.js` 0c3ffd34…5acd15d;`lib/host.js` f87b9eab…f6912e |
32
+
33
+ ---
34
+
35
+ ## 2. 画圈区域 → 源码映射(核心结论)
36
+
37
+ 三处圈都是**折叠态计划卡的 meta 行**与**组头摘要/空态**,不是图表本身。
38
+
39
+ | 圈 | 截图内容 | DOM / 组件 | 源码位置 | 当前形态 |
40
+ |---|---|---|---|---|
41
+ | ① | 第 1 张卡「dsh 插件多通道版本发布一致性方案…」下的「本计划 0/8 做好了」+「0 卡住了」 | `SessionCard` → `Collapse` 折叠头 `.dsh-wp-collapse-meta` | `src/client.ts:1356-1361`(scope 1357、迷你条 1358-1360、blocked 1361) | 12px 次要色文字 + 54×5px 迷你条(0% 时不可见) |
42
+ | ② | 第 2 张卡「核查 1.1.9 是否已进入 CDN 插件索引」下的「本计划 0/4 做好了」+「0 卡住了」 | 同上 | 同上 | 同上 |
43
+ | ③ | 「已完成」组组头「未完成 0 / 已完成 0(完成率暂无数据)」+ 空态「还没有完成的任务」 | `SessionGroup` 组头摘要 + 空态 | 摘要 `src/client.ts:1671-1673`、渲染 1698;空态 1732 | 12px 次要色文字(nowrap + ellipsis)+ 13px 空态文字;右侧 44px 环显示「—」 |
44
+
45
+ > 圈①的红线压到了标题末行(「不执行发布)」),但从笔画包围范围与两圈一致性看,主体是标题下方的进度 meta 行;这一点**建议主 Agent 向用户复述确认一次**。
46
+
47
+ ---
48
+
49
+ ## 3. 渲染管线(从挂载到画圈元素)
50
+
51
+ 1. **面板挂载**:`src/client.ts:2148-2155` `ctx.slots.inject('main')` → `key: 'workplan'` → `GuardedDashboard`(注册于 2119)。
52
+ 2. **数据轮询**:`Dashboard`(1832)→ `usePlans`(1176)→ `fetchPlans`(1161-1174)请求 `GET /dsh-workplan/plans`,4s 一轮。
53
+ 3. **顶部统计条**:`src/client.ts:1947-1952`,5 格**纯数字**(任务数 / 工作项 / 做好了 / 正在做 / 卡住了);1948-1952。
54
+ 4. **分组**:`src/client.ts:1957-1959` 渲染 `SessionGroup('live')` 与 `SessionGroup('done')`。
55
+ 5. **组头**:`SessionGroup`(1646-1734):
56
+ - 聚合 `groupTotals(list)`(1668 → 1574-1600);
57
+ - 摘要句 `summaryText`(1671-1673);
58
+ - 组头 children(1687-1698):圆点、标题、计数、告警、**`GroupRing`(1694)**、chevron、**摘要 span(1698)**;
59
+ - 空态(1732):`groupDoneEmpty` / `groupLiveEmpty`。
60
+ 6. **计划卡**:`SessionCard`(1336-1409):`stats`/`percent`(1344-1347)→ `Collapse`(1349)→ **meta 数组(1356-1361)**;展开后才有 `Progress`(1374)与「总体进度 X%」(1375-1378)。
61
+ 7. **折叠容器**:`Collapse`(1088-1176):按钮 1134-1152 内依次是 chevron、title、**meta(1145)**、badge;面板 `hidden: !open`(1155-1157)——默认折叠,所以画圈 meta 就是用户第一眼看到的全部进度信息。
62
+ 8. **图表(在两组之后)**:`Dashboard` 1963-1966 的 `Donut`(1736-1799,132px SVG)+ `TaskBars`(1800-1831,8px 横向条);1969 的 `GroupCharts`(1425-1553,动态加载 `/dsh-workplan/vendor/chart.umd.js` 的 Chart.js 4.6.1,含 fallback)。
63
+
64
+ **结论:截图中 440×888 的首屏只包含「5 格数字 + 两行说明 + 组头(含 44px 环)+ 计划卡 meta 文本」;真正的 Chart.js 图表在两组之后,首屏不可见。**
65
+
66
+ ---
67
+
68
+ ## 4. 当前进度数据结构
69
+
70
+ 服务端 `serialisePlan`(`src/runtime.ts:848` 起)每 4s 下发的关键字段:
71
+
72
+ ```ts
73
+ // src/plan.ts:1111
74
+ interface StatusEntry { subtaskId; stageId; title; department; role; status; progress; childId; startedAt; finishedAt; summary; error }
75
+ // src/plan.ts:1128
76
+ interface Stats { total; done; blocked; inProgress; pending; progress }
77
+ // src/plan.ts:1147
78
+ interface PlanSnapshot { statuses: StatusEntry[]; stats: Stats; departments: DepartmentSummary[] }
79
+ ```
80
+
81
+ - `serialisePlan` 顶层返回(`src/runtime.ts:872` 起):`sessionId / planId / title / phase / degraded / error / errors / createdAt / updatedAt / createdTurn / plan / statuses / stats / heartbeatAt / resumeCount / resumeLimit / resumeAvailable / dispatchElapsedMs / departments / taskUnderstanding / contradictions / stages / risks / verification`。
82
+ - `stats` 由 `derivePlanSnapshot(statuses)` **单次派生**(1.4.3 起无缓存,`record.stats` 已删除);`stats.progress` 是加权进度,`done/total` 是完成计数,两者不等价。
83
+ - 前端 `groupTotals`(`src/client.ts:1574-1600`)只读各会话 `session.stats` 求和:
84
+ `open = total - done`(1594);`percent = total > 0 ? Math.round(done/total*100) : null`(1595)。
85
+ - 卡片 `percent = Math.round(done/total*100)`(1347),仅在迷你条的 `title` 属性中出现(1358)与 fill 宽度(1359)。
86
+ - 空组 → `percent === null` → 走 `groupSummaryNoRate`(「完成率暂无数据」),即圈③文案来源。
87
+ - `GET /dsh-workplan/plans` 需登录态;未登录返回 401 `{"ok":false,"error":"未授权的请求"}`。
88
+
89
+ ---
90
+
91
+ ## 5. 为什么「不醒目」——基于代码事实
92
+
93
+ 1. **迷你条轨道与折叠按钮同色**:`.dsh-wp-mini` 轨道 `background: var(--dsw-alias-bg-layer-2)`(`src/client.ts:626`),折叠按钮底色同为 `var(--dsw-alias-bg-layer-2)`(`:759`)。0% 时 fill 宽度 0,整条 54×5px 轨道与按钮底色重合 → **肉眼完全不可见**(与截图一致)。
94
+ 2. **尺寸极小**:54×5px(623-624),无任何文字标注;百分比只写在 `title`(1358),触屏无 hover,永远看不到。
95
+ 3. **文字是 12px 次要色**:`.dsh-wp-collapse-meta`(783)`font-size:12px; color: label-secondary`;「本计划 0/8 做好了」是直白文本,没有图形比例、没有百分比。
96
+ 4. **组摘要同为 12px 次要色且尾部截断风险**:`.dsh-wp-group-sub`(432)`12px; nowrap; ellipsis`,完成率 `{pct}%` 恰在句尾(1671-1673),窄屏先被省略号吃掉。
97
+ 5. **组头环太小且 0% 无弧**:`.dsh-wp-group-ring` 44×44px、label 11px(408-412),`aria-hidden`;0% 时弧长 0,只剩灰轨道 +「0%」/「—」。
98
+ 6. **图表在第一屏之外**:`GroupCharts` 固定排在两组之后(1967-1969),移动端首屏看不到;首屏唯一图形是组头环。
99
+ 7. **顶部统计条无完成率**:1947-1952 只有 5 个数字,没有百分比/图形;「0 做好了」与「2 正在做」只能靠颜色和数字自行换算。
100
+ 8. **空组摘要语义噪声**:空「已完成」组仍渲染「未完成 0 / 已完成 0(完成率暂无数据)」(1671-1673 + 1732),圈③正是这一行——对用户没有信息量却占据组头位置。
101
+
102
+ 补充(非画圈直接原因,但影响观感):`linear-gradient` 尚有 9 处、`.dsh-wp-group--done { opacity: .97 }`(659),与 `docs/visual-refinement-spec.md` 的零渐变/禁 opacity 目标态不一致。
103
+
104
+ ---
105
+
106
+ ## 6. 现有图表资产与依赖策略事实
107
+
108
+ - **Chart.js 4.6.1 已是依赖**,由 `GroupCharts` 动态 import `/dsh-workplan/vendor/chart.umd.js`(1425 起;canvas 1526、1543),并有纯 HTML fallback 条并存策略(443-445)。
109
+ - **零依赖图形已存在**:`GroupRing`(内联 SVG 双圆,1609-1644)、`Donut`(1736)、`TaskBars`(1800)、`Progress`(1023)。
110
+ - 因此后续改造**不需要新增第三方依赖**(Chart.js 或内联 SVG 均可),但「图表形式/放置位置」属需求决策,须由用户确认(T2)。
111
+
112
+ ---
113
+
114
+ ## 7. 复核命令(可直接复制)
115
+
116
+ ```bash
117
+ cd <repo>
118
+
119
+ # 1) 版本与挂载
120
+ node -e "const p=require('./package.json');console.log(p.version,p.main)"
121
+ grep -n "version: '1.4.3'" src/host.ts lib/host.js
122
+
123
+ # 2) 画圈①:卡片 meta(scope / mini / blocked)
124
+ sed -n '1356,1361p' src/client.ts
125
+
126
+ # 3) 迷你条轨道与按钮同色(两处都应为 --dsw-alias-bg-layer-2)
127
+ sed -n '621,630p;749,760p' src/client.ts
128
+
129
+ # 4) 画圈③:组摘要与空态
130
+ sed -n '1671,1673p;1694,1698p;1730,1733p' src/client.ts
131
+
132
+ # 5) 图表位置(在两组之后)
133
+ sed -n '1957,1969p' src/client.ts
134
+
135
+ # 6) 类型检查(不产生构建产物)
136
+ npm run check
137
+
138
+ # 7) 截图文件与时间(用于复核圈选区域)
139
+ ls -l ~/.dsh/attachments/v1/objects/84/848e3c3789bb1a6e997f5cc311b55748c183e93f158a8aae35320371a0e40228
140
+ ```
141
+
142
+ ---
143
+
144
+ ## 8. 未验证 / 待用户确认
145
+
146
+ 1. **截图归属**:未随任务消息下发,按时间与内容匹配;需主 Agent 复述三处圈选区域,请用户确认。
147
+ 2. **图表形式与位置**:内联 SVG 环/条 vs 复用 Chart.js;放在卡片折叠头、组头,还是顶部统计条;是否保留纯文本百分比(可访问性冗余)——属 T2 需求澄清。
148
+ 3. **是否顺带改顶部统计条/总览区**:用户未圈,不能擅自扩大范围。
149
+ 4. **截图对应构建版本**:布局与 1.4.3 源码一致,但未对运行中实例做 DOM 级核验。
150
+ 5. **运行实例的改动生效方式**:插件通过 link 挂载,构建后是否需重启 DSH Web / 刷新页面,由主 Agent 按运行环境确认(该步骤不在本子任务权限内)。
151
+
152
+ ---
153
+
154
+ ## 9. 建议改造落点(仅供 T2 决策,本子任务未实施)
155
+
156
+ - **主落点**:`SessionCard` 折叠头 meta(`src/client.ts:1356-1361`)——加可见百分比 + 更高对比度/更大尺寸的进度条或环,0% 时轨道也必须可见。
157
+ - **次落点**:`SessionGroup` 摘要(1698)——用图形化比例替代/伴随 12px 文本;空组隐藏「完成率暂无数据」。
158
+ - **可选**:把总览图表的轻量版(如每计划条)上移到首屏可用位置;需用户确认,避免整体重排。
159
+ - **约束**:百分比必须有文本(WCAG 1.4.1 冗余编码);沿用现有 CSS 变量支持深/浅主题;不改服务端 stats 语义;版本号必须递增(当前 1.4.3)。
@@ -0,0 +1,140 @@
1
+ # dsh-workplan 1.5.0 改造说明:让执行进度一眼可见
2
+
3
+ > 版本:1.5.0(1.4.3 → 1.5.0,minor)
4
+ > 日期:2026-10-28(Asia/Shanghai)
5
+ > 范围:只改进度**展示层**(`src/client.ts` + 测试 + 版本文件 + 文档),`plan.ts` / `runtime.ts` 零改动,顶部 5 格统计条与两组之后的图表原样保留。
6
+ > 证据:`npm run check` exit 0;`npm test` **99 / 99 通过**;离线对比页 `docs/preview/progress-visual-1.5.0.html`;回滚快照 `.backups/v1.4.3-progress-viz-code-20261028-142153.tar.gz`(SHA-256 `c79513f5c0279e3bb291d536fba7a631fa8018e27bc7d4fca500fbabd9e602da`)。
7
+
8
+ ---
9
+
10
+ ## 1. 问题(用户截图的三处红圈)
11
+
12
+ 截图里被圈出的文字分别是:
13
+
14
+ 1. 进行中计划卡:`本计划 0/8 做好了` / `0 卡住了`
15
+ 2. 第二张计划卡:`本计划 0/4 做好了`
16
+ 3. 已完成组头:`未完成 0 / 已完成 0(完成率暂无数据)` + `还没有完成的任务`
17
+
18
+ 问题不是「数据不对」,而是「**看不见进度**」。改前实测的四个成因(全部可在 1.4.3 源码里复核):
19
+
20
+ | 成因 | 1.4.3 的事实 |
21
+ |---|---|
22
+ | 没有图形,只有一行 12px 灰字 | `.dsh-wp-collapse-meta` 是 `font-size: 12px`、`label-secondary` 颜色 |
23
+ | 0% 时进度条整条消失 | `.dsh-wp-mini-fill` 宽度 = `percent%`,0% 时宽度 0;轨道用的 `--dsw-alias-bg-layer-2` 与折叠按钮底色是**同一个 token**,肉眼等于没有轨道 |
24
+ | 百分比只存在于 `title` 提示里 | `h('span', { className: 'dsh-wp-mini', title: '0%' })`,不悬停看不到 |
25
+ | 迷你条太小 | `54×5px`,放在 44px 高的折叠按钮里几乎不可见 |
26
+
27
+ 所以「0/8 做好了」在屏幕上和「0/4 做好了」长得一样,用户无法在扫视时判断“到底动了没有”。
28
+
29
+ ## 2. 改了什么(四层可见信号,折叠状态就看得见)
30
+
31
+ 折叠卡头部(默认状态)现在是**四层冗余信号**,任何一层失效都还有另外三层:
32
+
33
+ 1. **44px 圆环 + 24px 大号百分比**:`0%` 以 24px/700 常量数字显示在环旁,不再依赖悬停;
34
+ 2. **四段构成条(8px 高、整行宽)**:做好了 / 正在做 / 卡住了 / 还没开始 各占一段,**0% 时整条是灰色「还没开始」,不会消失**(轨道 `rgba(148,163,184,.22)`,0% 计划另加 `data-zero="true"` 用深一档轨道 `rgba(100,116,139,.80)`);
35
+ 3. **11px 状态图例**:`做好了 0 · 正在做 1 · 卡住了 0 · 还没开始 7`,数字是文本,可读屏、可复制;
36
+ 4. **6px 阶段步进条**:每个阶段一段,当前阶段有橙色描边、`data-current="true"`;卡住阶段用错误色内描边。
37
+
38
+ 再补一行 **现在在做什么**:`正在做 · 改客户端`(有卡住则优先显示 `卡住了 · 标题`),回答“它现在到底在干嘛”。
39
+
40
+ 展开后多一块 **分步进度 / Step progress**:每个阶段一行(7px 状态点 + 阶段名 + 48px 细条 + `2/3` + `正在做`),当前阶段橙色底。
41
+
42
+ 组头(第二处 + 第三处红圈):
43
+
44
+ - 组环在 0 条工作时加粗轨道并放大百分比(`data-zero="true"`),不再是一个空环;
45
+ - **0/0 的组不再输出「未完成 0 / 已完成 0(完成率暂无数据)」这句话**(用户选择:去掉这行,只留清晰空态),保留 `data-percent="none"` 与环里的 `—` 作为机器可读标识;
46
+ - 有数据的组保留原文案(`未完成 3 / 已完成 1(完成率 25%)`),测试仍覆盖。
47
+
48
+ ### 数据映射(全部由既有字段派生,无新增接口)
49
+
50
+ ```
51
+ total = max(0, Number(stats.total) || 0)
52
+ done = clamp(done, 0, total)
53
+ blocked = clamp(blocked, 0, total - done)
54
+ active = clamp(stats.inProgress, 0, total - done - blocked)
55
+ pending = max(0, total - done - blocked - active)
56
+ percent = total > 0 ? Math.round(done / total * 100) : null // null 显示为 —
57
+ ```
58
+
59
+ ## 3. 改前 / 改后对照
60
+
61
+ 离线对比页(同一份 CSS、同一套数据夹具,左旧右新):
62
+
63
+ ```
64
+ 打开文件:docs/preview/progress-visual-1.5.0.html
65
+ 重新生成:npm run preview
66
+ ```
67
+
68
+ | 场景 | 1.4.3 看到什么 | 1.5.0 看到什么 |
69
+ |---|---|---|
70
+ | 0/8 刚开始 | `本计划 0/8 做好了` + 一条看不见的条 | `0%` 大号 + 灰色整条 + 图例全灰 + 第一个阶段橙色描边 + `正在做 · 列出文件` |
71
+ | 3/8 进行中 | `本计划 3/8 做好了` + 54×5px 小条 | `38%` + 蓝/橙/红/灰四段构成条 + 4 项图例计数 + 阶段步进条 |
72
+ | 有卡住 | `1 卡住了` 字样 | 红色 `卡住了 · 改客户端` 胶囊(`data-alarm="true"`)+ 该阶段红色内描边 |
73
+ | 已完成组 0 项 | `未完成 0 / 已完成 0(完成率暂无数据)` | 不再出现该句;环里 `—`,空态文案保留 |
74
+
75
+ ## 4. 怎么看到效果(必须做这一步)
76
+
77
+ 插件前端是 `client.js`,**DSH Web 启动时加载并缓存**,所以:
78
+
79
+ ```bash
80
+ # 1) 重启 DSH Web(在运行 DSH 的终端按 Ctrl+C,再重新启动同一条命令)
81
+ # 2) 浏览器强制刷新 http://127.0.0.1:3080 (⌘⇧R)
82
+ # 3) 打开左侧栏「任务进度」,看折叠卡头部即可
83
+ ```
84
+
85
+ 不想重启也可以先看离线对比页(`docs/preview/progress-visual-1.5.0.html`,双击即可用浏览器打开,无需服务器)。
86
+
87
+ ## 5. 验证记录(真实输出,可复跑)
88
+
89
+ | 项目 | 命令 | 结果 |
90
+ |---|---|---|
91
+ | 类型检查 | `npm run check` | exit 0 |
92
+ | 全量测试 | `npm test` | `tests 99 / pass 99 / fail 0`(基线 90 + `progress-visual` 8 + `version-sync` 1) |
93
+ | 一键校验 | `npm run verify` | check + test 均通过 |
94
+ | 对比页重生成 | `npm run preview` | 写出 `docs/preview/progress-visual-1.5.0.html`,输出 `OK: 0/0 组不再出现「完成率暂无数据」` |
95
+ | 版本一致性 | `tests/version-sync.test.ts` | `package.json` = `package-lock.json`(两处)= `src/host.ts` 的 `meta.version` |
96
+ | 版本点人工复核 | `grep -n "1.5.0"` | 7 处:`package.json:3`、`package-lock.json:3`、`:9`、`src/host.ts:328`、`lib/host.js:297`、`dist/host.js:297`、`CHANGELOG.md:1` |
97
+
98
+ 自动化验收项(`tests/progress-visual.test.ts`,8 项):
99
+
100
+ 1. 0/8:`data-percent="0"`、`data-zero="true"`、文本含 `本计划 0/8 做好了`、`data-kind="pending" data-count="7"`、**不含** `strokeDasharray`;
101
+ 2. 3/8:`data-percent="38"`,四段计数之和 = 8;
102
+ 3. 有卡住:`data-alarm="true"`、文本 `1 卡住了`、含 `卡住了 · 改客户端`、对应阶段 `data-tone="blocked"`;
103
+ 4. 三阶段:恰好一个 `data-current="true"`;
104
+ 5. 图例恰好 4 项,顺序与计数 `[0,1,0,7]`;
105
+ 6. 折叠状态**不挂载**展开面板(源码断言 `open === true ? h(PlanOverview`);
106
+ 7. 脏数据(负数、缺字段、字符串数字)不出现 `NaN`/`Infinity`/`undefined`,百分比 ≤ 100;
107
+ 8. 折叠卡头部不含 `canvas`/`Chart.`(图表仍只在两组之后,未抢主视觉)。
108
+
109
+ ## 6. 版本、变更记录与回滚
110
+
111
+ - 版本:`1.4.3` → **`1.5.0`**(minor:用户可见的新增能力,对外载荷不变);产物已重建(`client.js` 138195 字节、`lib/host.js` 14384 字节)。
112
+ - 变更记录:`CHANGELOG.md` 顶部 `## 1.5.0 — 2026-10-28`,含“零新增依赖”的真实表述(`node_modules` 里 `chart.js@4.6.1` 是 extraneous 残留,不参与构建;运行时图表库来自 `vendor/chart.umd.js`)。
113
+ - 回滚(二选一,都需要重建):
114
+ ```bash
115
+ # A. git(仓库有 tag v1.4.3、跟踪 origin/main)
116
+ git checkout -- . # 放弃未提交改动
117
+ # B. 快照(覆盖未跟踪文件与构建产物)
118
+ tar -xzf .backups/v1.4.3-progress-viz-code-20261028-142153.tar.gz -C .
119
+ # 两者之后都执行:
120
+ npm run build && npm run verify
121
+ ```
122
+ 完整策略见 `docs/version-upgrade-rollback-1.5.0-20261028.md`。
123
+
124
+ ## 7. 已知限制(如实说明,不掩饰)
125
+
126
+ 1. **没有浏览器截图**:本机 `qlmanage -t` 被沙箱拒绝(`sandbox initialization failed: Operation not permitted`),`/Applications` 下只有 Safari、无 Chrome/Chromium,GUI `http://127.0.0.1:3080` 未带凭据返回 HTTP 401。因此“改前/改后”证据是**同一份 CSS 渲染出的自包含 HTML 对比页**,不是 GUI 截图;GUI 里的最终目视效果需要用户刷新后确认。
127
+ 2. **改动未提交**:`commit` / `tag` / `npm publish` 都**没有执行**(未获授权)。工作区当前是 1.5.0 的完整状态,可随时审阅或回滚。
128
+ 3. **样式依赖宿主 token**:`--dsw-alias-*` 由 DSH Web 主题提供;离线对比页里用 14 个等价浅色值替代,深色主题下的对比由 `--dsh-wp-*` 自有 token 与 `state-*` 语义色保证,但未逐主题截图。
129
+
130
+ ## 8. 文件清单
131
+
132
+ | 文件 | 变更 |
133
+ |---|---|
134
+ | `src/client.ts` | 新增 `PlanRing`/`PlanLegend`/`PlanSegments`/`PlanStepper`/`PlanViz`/`PlanOverview` 与 `planCounts`/`planStageRows`/`planNow` 等纯函数;`SessionCard` 接新头部;组头 0/0 不再输出“完成率暂无数据”;组环 0 值加粗;CSS 新增 `.dsh-wp-planviz*`/`.dsh-wp-stepper*`/`.dsh-wp-planoverview*`/`.dsh-wp-planrow*` 与 2 个 token;zh/en 各 2 个文案键 |
135
+ | `tests/progress-visual.test.ts` | 新增 8 项验收测试 |
136
+ | `tests/version-sync.test.ts` | 新增版本一致性测试 |
137
+ | `tests/group-summary.test.ts`、`tests/session-collapse.test.ts` | 同步新文案与新结构断言 |
138
+ | `scripts/render-preview.ts`、`scripts/fixtures/old-header-1.4.3.html` | 对比页生成器与旧版标记夹具 |
139
+ | `package.json`、`package-lock.json`、`src/host.ts`、`client.js`、`lib/host.js`、`dist/host.js` | 1.5.0 版本与重建产物;新增 `preview` 脚本 |
140
+ | `CHANGELOG.md`、`README.md`、`README.en.md`、本文、`docs/preview/progress-visual-1.5.0.html` | 变更记录、使用说明、对比证据 |
@@ -0,0 +1,46 @@
1
+ # v1.7.0 — 协作契约版
2
+
3
+ 这是 **dsh-workplan** 自 1.6.0 以来最大的一次协作语义升级。1.6.0 让「这一轮到底有没有在跑」变准;
4
+ 1.7.0 让「派出去的部门到底做了什么、凭什么算做完、改判以谁为准」有了机器可核对的答案。
5
+
6
+ ## 装这一版
7
+
8
+ ```bash
9
+ dsh plugin --profile web add dsh-workplan@1.7.0
10
+ ```
11
+
12
+ 装完重启 DSH Web(或重新载入页面)。要求 Node.js 22+,无第三方运行时依赖。
13
+
14
+ ## 你直接能感觉到的变化
15
+
16
+ - **派发不再让主 Agent 干等。** `dsh_workplan_dispatch` 支持 `mode:"async"` 立刻返回,后台继续跑;
17
+ 随时用新的只读工具 `dsh_workplan_status` 问「做到哪了」——刷新页面、重启进程后依然答得出。
18
+ - **「假完成」被堵住。** 子 Agent 要在输出末尾回传结构化证据(验收逐条结果、产物、协作需求)。
19
+ 只完成一半、验收有失败、证据块坏了,都判受阻;只有全部通过才直接采信。结果消息会单独列出
20
+ 「未验证」「自检失败」「声明产物缺失」,主 Agent 不会再把半成品当完成。
21
+ - **产物不存在就不解锁下游。** 声明为文件的产物会被逐个核实,缺失的写进计划,下游明确停在
22
+ 「上游 T1「产出接口清单」受阻,缺失 docs/api.md」这种可执行的信息上。
23
+ - **改判不会互相覆盖。** 运行中的子任务默认拒绝改判(`TASK_RUNNING`);基于旧状态的写入返回
24
+ `STALE_WRITE`;人工改判会落盘,刷新后仍在。
25
+ - **跨部门不再只能靠猜。** 每个子 Agent 都能看到兄弟部门的只读一览(谁、做什么、产出什么、已完成摘要),
26
+ 需要协作就写 `needs`,结果消息汇总成「跨部门待转达」交给主 Agent 逐条处理。
27
+
28
+ ## 兼容性
29
+
30
+ 旧会话不需要迁移:没有证据块的旧结果按 `legacy` 读作「完成但未验证」,并提示主 Agent 复核。
31
+ `strict: false`、`artifactGate: false` 两条回滚通道保留旧判定。`PLAN_VERSION` 仍为 1,
32
+ `dispatch` 默认仍是 `wait`,既有调用行为不变。
33
+
34
+ ## 质量
35
+
36
+ - 180 个测试全绿(`npm test`),新增 7 个测试文件覆盖证据契约、派发模式、写保护、产物门禁、
37
+ 跨部门 brief、重试回灌与工具 schema。
38
+ - `npm run check` 通过;`lib/` 与 `client.js` 由构建生成并入库,可用 `npm run build && git diff --exit-code` 复现。
39
+ - 完整变更:[CHANGELOG.md](https://github.com/abbaababa/dsh-workplan/blob/main/CHANGELOG.md);
40
+ 发布流程:[RELEASING.md](https://github.com/abbaababa/dsh-workplan/blob/main/RELEASING.md)。
41
+
42
+ ## 文档
43
+
44
+ - [协作契约](https://github.com/abbaababa/dsh-workplan/blob/main/docs/collaboration.md) — 角色、数据契约、状态机、失败恢复、写者所有权
45
+ - [部门职责与交接](https://github.com/abbaababa/dsh-workplan/blob/main/docs/departments.md) — 12 个部门的边界与逐部门交接清单
46
+ - [协作机制审查](https://github.com/abbaababa/dsh-workplan/blob/main/docs/review-collaboration-20261030.md) — 17 条断点的证据
@@ -0,0 +1,36 @@
1
+ # dsh-workplan 1.7.1
2
+
3
+ **修复 1.7.0 无法激活的问题**(如果你升级到 1.7.0 后重启 DSH Web,终端出现
4
+ `JsonSchemaError: ... elapsedMs.type must be a single type string`,任务面板和四个工具都消失,就是这个 bug)。
5
+
6
+ ## 你升级后要做的
7
+
8
+ ```bash
9
+ dsh plugin --profile web add dsh-workplan@1.7.1
10
+ # 然后重启 DSH Web
11
+ ```
12
+
13
+ 如果 1.7.0 已经装坏、插件加载不起来,上面的命令会直接覆盖成 1.7.1;不需要先卸载。
14
+
15
+ ## 修了什么
16
+
17
+ | 问题 | 修复 |
18
+ | --- | --- |
19
+ | `elapsedMs` 用 `type: ['number','null']` 表达可空,宿主只接受单一类型字符串,激活即抛错 | 改为 `oneOf: [{type:'number'},{type:'null'}]` |
20
+ | `dsh_workplan_update` 的 `progress` 用了宿主不支持的 `minimum`/`maximum` | 去掉这两个关键字,范围写进参数说明 |
21
+ | `cancel` 的输出 schema 内联在 host 里,容易漏检 | 提取为 `cancelToolOutputSchema()`,与其余 schema 共用一套校验 |
22
+
23
+ ## 为什么之前没测出来
24
+
25
+ 宿主的 schema 校验是**运行期**才跑的,本地 `npm test` 只校验我们自己的逻辑。
26
+ 现在新增了 `tests/workplan-host-schema.test.ts`:按宿主允许的关键字子集递归校验四个工具的
27
+ `parameters` 与 `output.schema`,并锁死「可空标量只能用 `oneOf`,不能写 type 数组」。
28
+ 另外发布前用宿主真实的 `assertSupportedJsonSchema` 对四个工具各跑一遍。
29
+
30
+ ## 升级清单
31
+
32
+ - 183 个测试通过(1.7.0 是 179,新增 3 个 schema 用例 + 版本同步断言)。
33
+ - 1.7.0 的全部协作能力不变:结构化证据契约、异步派发、写保护、产物门禁、跨部门 brief/needs、重试回灌。
34
+ - 无破坏性改动,无依赖变化(0 runtime dependencies)。
35
+
36
+ 完整变更见 [CHANGELOG.md](https://github.com/abbaababa/dsh-workplan/blob/main/CHANGELOG.md)。
@@ -0,0 +1,80 @@
1
+ ## 1.8.0 — 把"安全"从形容词变成证据链
2
+
3
+ > **一句话**:这一版给了你一份**按国际安全标准结构写出来、能被任何人 5 条命令复核**的材料,并且**明确告诉你它没有证书**。
4
+ >
5
+ > **One line**: this release ships security material **structured by an international security standard, verifiable by anyone in 5 commands**, and it **tells you plainly that there is no certificate**.
6
+
7
+ ---
8
+
9
+ ## 🌍 为什么"通过 ISO/IEC 15408"这句话不能随便说
10
+
11
+ ISO/IEC 15408(简称 **CC**,通用准则)是国际安全标准,最新版是 **2026 年版**。它的规矩是三方分工:
12
+
13
+ **写代码的人交材料 → 独立实验室按 ISO/IEC 18045 去测 → 国家认证机构发证书。**
14
+
15
+ 证书由第三方签发,**软件不能给自己发**。所以任何"本插件完全满足/已通过 ISO/IEC 15408"却没有**证书编号**的说法,都是不实陈述。
16
+
17
+ **本插件没有证书,所以我们不这么写。** 我们做的是把 CC 要的材料按标准结构真做出来、公开出来。
18
+
19
+ CC splits the work three ways: **developer supplies evidence → accredited lab evaluates → national scheme issues the certificate**. Software cannot certify itself. This plugin has no certificate, so it makes no such claim — instead it publishes the evidence, in the standard's own structure.
20
+
21
+ ---
22
+
23
+ ## ✅ 这一版新增了什么
24
+
25
+ | 材料 | 对应标准 | 内容 |
26
+ |---|---|---|
27
+ | [docs/cc/CC-2026-ASSESSMENT.md](https://github.com/abbaababa/dsh-workplan/blob/main/docs/cc/CC-2026-ASSESSMENT.md) | 自评估 | 按保证类逐类判定(ASE/ADV/AGD/ALC/ATE/AVA),**EAL1 就绪度矩阵**(14 项组件:11 就绪 / 2 部分 / 1 必须靠外部实验室),未修复差距逐条写明原因 |
28
+ | [docs/cc/SECURITY-TARGET.md](https://github.com/abbaababa/dsh-workplan/blob/main/docs/cc/SECURITY-TARGET.md) | 安全目标 ST | 首行即写 **"Conformance claim: NONE"**;7 条威胁、3 条假设、3 条组织策略、8 个功能要求组件,逐条映射到实现与验证命令 |
29
+ | [docs/cc/AVA-VULNERABILITY-ANALYSIS.md](https://github.com/abbaababa/dsh-workplan/blob/main/docs/cc/AVA-VULNERABILITY-ANALYSIS.md) | 脆弱性评定 | 攻击面穷举(2 条只读路由 + 4 个工具 + 1 个随包文件)、威胁→对策→残留风险、8 项缺陷(5 项本次修掉,3 项写明接受理由) |
30
+ | [docs/SBOM.md](https://github.com/abbaababa/dsh-workplan/blob/main/docs/SBOM.md) | 生命周期 ALC | 运行时 **0** 依赖;6 个开发依赖;1 个随包第三方文件(Chart.js 4.6.1 MIT,附 SHA-256) |
31
+ | [SECURITY.md](https://github.com/abbaababa/dsh-workplan/blob/main/SECURITY.md) | 安全策略 | 漏洞私密报告渠道与时限、攻击面、部署建议、**5 条"我们不做/不宣称"** |
32
+ | 187 项自动化测试 | 测试 ATE | `npm run verify` 一条命令复跑(1.7.1 为 183 项) |
33
+
34
+ ## 🔧 实现层修复
35
+
36
+ - `src/runtime.ts`:新增冻结常量 `HARDENING_HEADERS`(`x-content-type-options: nosniff`、`referrer-policy: no-referrer`)与 `applyHardeningHeaders()`,在 `route()` 入口统一应用。
37
+ - `src/host.ts`:chart 静态文件路由同样应用,避免两条路由策略不一致。
38
+ - 新增 `tests/security-headers.test.ts`(4 项),锁死上述行为并断言两条路由都调用了加固助手。
39
+ - `package.json` 的 `files` 增加 `SECURITY.md` 与 `docs`,npm 包内即可查阅全部合规材料。
40
+
41
+ ## 📦 安装(30 秒,小白版)
42
+
43
+ ```bash
44
+ dsh plugin --profile web add dsh-workplan@1.8.0
45
+ ```
46
+
47
+ 装完**重启一次 DSH Web**,刷新 <http://127.0.0.1:3080> 即可。
48
+
49
+ > Node.js 需要 **22 或更高**(`node -v` 自查)。
50
+
51
+ ## 🔍 自己验证(不用相信我们)
52
+
53
+ ```bash
54
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
55
+ npm ci
56
+ npm run verify # 期望:tests 187 / pass 187 / fail 0
57
+
58
+ # 复核"无危险 API"这一条
59
+ grep -RInE "child_process|execSync|eval\(|new Function|writeFileSync|appendFileSync|mkdirSync|https?\.request" src || echo "0 命中(预期)"
60
+
61
+ # 复核硬化响应头确实生效
62
+ grep -n "HARDENING_HEADERS" src/runtime.ts
63
+ ```
64
+
65
+ ## ⚠️ 我们不宣称的事
66
+
67
+ 1. 没有 CC 证书,没有通过任何实验室评测。
68
+ 2. 不是"完全满足 ISO/IEC 15408"的产品。
69
+ 3. 不提供多租户隔离、加密存储、独立审计日志服务。
70
+ 4. 不替代 DSH 自身的身份认证与权限体系。
71
+ 5. 认证需要外部实验室与费用,**不是改代码能解决的**——所以这份材料的目标是"可复核",不是"冒充已认证"。
72
+
73
+ ## 升级须知
74
+
75
+ - 无破坏性变更,无新增运行时依赖。
76
+ - 反向代理后部署请仍按 `SECURITY.md` §6 自行加 TLS 与认证。
77
+
78
+ ---
79
+
80
+ **English summary**: Added a public self-assessment structured on ISO/IEC 15408:2026 (CC) — class-by-class mapping, EAL1 readiness matrix, a Security Target draft whose first line says `Conformance claim: NONE`, a vulnerability analysis with an enumerated attack surface, an SBOM (zero runtime dependencies), and a security policy with a private reporting channel. Hardened HTTP responses with `nosniff` and `no-referrer`, added 4 tests (183 → 187). No certificate is claimed, and none should be implied.
@@ -0,0 +1,69 @@
1
+ # dsh-workplan 1.8.1 — 自我更正版 / Self-correction release
2
+
3
+ **2026-10-30 | 补丁版 | 无新功能,无新主张,只修"说错的话"**
4
+
5
+ ---
6
+
7
+ ## 一句话
8
+
9
+ 1.8.0 发布后我们做了独立复核,发现**文档有三处说得比代码多**。讲安全的文档说错话,比不写文档更糟,所以单独发一个补丁版把话改对,并把改的过程也公开。
10
+
11
+ > 本版**没有**新增任何安全主张。仍然没有 CC 证书,仍然不宣称"通过"或"完全满足"。
12
+
13
+ ---
14
+
15
+ ## 改了什么(三条,都是文档)
16
+
17
+ | # | 之前怎么写 | 实际上 | 现在怎么写 |
18
+ |---|---|---|---|
19
+ | 1 | 图表库路由(`/dsh-workplan/vendor/chart.umd.js`)"同上鉴权" | 该路由从来没调用 `connection.requestRejection`;一条 `curl` 就能证伪 | 明说:这是**公开静态资源**(随包固定的 Chart.js 4.6.1,MIT,不含任何会话数据),只答 GET/HEAD,**不鉴权**;带数据的 `/dsh-workplan/plans` 才鉴权 |
20
+ | 2 | 自测覆盖"鉴权分支、方法限制、响应截断" | `tests/` 里 401/403、405、2.5 MB 截断**没有**逐分支用例 | 如实列出已覆盖项,并把缺口登记为安全目标草案 §9 的已声明缺口 |
21
+ | 3 | EAL1 矩阵里 `ASE_CCL.1` = ✅ | 同一份文档开头写着 "Conformance claim: NONE",自相矛盾 | 改为 🟡;就绪度合计 **11 项 → 10 项**(10 就绪 / 3 部分 / 1 必须外部实验室) |
22
+
23
+ ## 改了什么(一处代码)
24
+
25
+ - `src/host.ts`:图表库路由补上方法限制 —— 非 GET/HEAD 返回 `405` 并带 `allow: GET, HEAD`;HEAD 只回头不回体。路径仍是常量(不由请求 URL 拼接),依旧没有写盘、子进程、出站请求。
26
+
27
+ ## 补了什么(一处测试)
28
+
29
+ - `tests/security-headers.test.ts` 新增 1 项:断言图表路由的 405 与 GET/HEAD 限制确实存在,防止文档与实现再次各说各话。**187 → 188 项。**
30
+
31
+ ## 补了一句必须说的话
32
+
33
+ **ISO/IEC 15408:2026 是现行国际标准,但认证体系还在用 2022 版。** 截至 2026 年,JISEC、波兰 NASK 与欧盟 CC 证书报告都仍要求 **CC/CEM:2022 Release 1**(含 2025-10-15 勘误 v1.2)。也就是说:我们参照的是最新版标准的结构,而**真实评估会先按 2022 版受理**。这是标准版本与认证实践之间的时差,不是插件的缺陷——但不说清楚就是误导,所以写进了自评估报告(差距 N-07)。
34
+
35
+ ---
36
+
37
+ ## 自己验证(复制即用)
38
+
39
+ ```bash
40
+ git clone https://github.com/abbaababa/dsh-workplan.git && cd dsh-workplan
41
+ git checkout v1.8.1
42
+ npm ci && npm run verify # 期望:tests 188 / pass 188 / fail 0
43
+
44
+ # 1) 带数据的路由:有鉴权、有 405
45
+ grep -n "requestRejection\|allow: 'GET, HEAD'" src/runtime.ts
46
+
47
+ # 2) 静态资源路由:有 405,没有 requestRejection
48
+ awk '/vendor\/chart.umd.js/,/^ },/' src/host.ts | grep -n "405\|requestRejection"
49
+ ```
50
+
51
+ 第二条命令的输出里,`405` 命中、`requestRejection` 不命中 —— 这正是文档现在说的样子。
52
+
53
+ ---
54
+
55
+ ## English summary
56
+
57
+ **1.8.1 is a self-correction release with no new features and no new claims.**
58
+
59
+ After publishing 1.8.0 we ran an independent review and found three places where the documentation promised more than the code delivered:
60
+
61
+ 1. `SECURITY.md` / `docs/cc/SECURITY-TARGET.md` claimed the vendored Chart.js route ran the same auth check as `/dsh-workplan/plans`. It never did. The docs now state the asymmetry plainly: the asset route is public, fixed, session-data-free, GET/HEAD only and **not** auth-checked; the data route is.
62
+ 2. `SECURITY-TARGET.md` claimed the test suite covered the auth, method-restriction and truncation branches. It does not. The docs now list what is covered and register the gap in §9 of the Security Target draft.
63
+ 3. The EAL1 matrix marked `ASE_CCL.1` as ready while the same document opens with `Conformance claim: NONE`. Corrected to partial; readiness is now **10 ready / 3 partial / 1 external-lab-only**.
64
+
65
+ One code change (the asset route now returns `405` for non-GET/HEAD with `allow: GET, HEAD`, and answers HEAD without a body) and one new test that pins it. The suite went from 187 to 188 tests.
66
+
67
+ One correction of substance: **ISO/IEC 15408:2026 is the current standard, but certification schemes still accept CC:2022 Release 1** (JISEC, NASK, and EU CC certificate reports as of 2026, including erratum v1.2 of 2025-10-15). Our material follows the 2026 structure; a real evaluation would be accepted under the 2022 edition first. That is a timing gap between standard and practice, not a plugin defect — but leaving it unsaid would mislead, so it is now recorded as gap N-07.
68
+
69
+ **Still true, unchanged:** no certificate, no lab evaluation, no EAL rating, no claim of "full compliance". What we publish is evidence anyone can re-run.