dsh-workplan 1.7.0 → 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 +68 -0
- package/README.en.md +41 -2
- package/README.md +40 -2
- 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 +5 -16
- package/lib/runtime.js +37 -1
- package/package.json +4 -2
- package/src/host.ts +6 -15
- package/src/runtime.ts +39 -1
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# T8 分级修复清单(1.4.2 快照)
|
|
2
|
+
|
|
3
|
+
> 快照时间:2026-10-27 16:10(Asia/Shanghai)
|
|
4
|
+
> 判定对象:`plugins/dsh-workplan` 源码 `src/client.ts` = 107,626 B / sha256 `3202a90b…4f88`;
|
|
5
|
+
> 构建产物 `client.js` = **114,677 B / sha256 `49d7725…de2d`**(16:08 由 `npm test` 重新构建,与 `dist/client.js` 同哈希);
|
|
6
|
+
> 版本 = **1.4.2**(`package.json` 与 `src/host.ts:328` 一致,1.4.1 的版本漂移已修);
|
|
7
|
+
> 测试 = **79/79 pass**(16:08 实测,4.15 s);
|
|
8
|
+
> 运行服务 = PID **75646**,启动于 **13:36:49**,端口 3080 —— **自 16:08 的 host 重建后仍未重启**。
|
|
9
|
+
>
|
|
10
|
+
> 重要:14:01 与 16:06 两次有并发写入,本清单只对上述哈希的快照成立。若 `src/client.ts` 再变,须重新核对。
|
|
11
|
+
|
|
12
|
+
## 一、结论
|
|
13
|
+
|
|
14
|
+
- **源码层面 P0 已清零**:1.4.1 验收发现的 3 个 P0(图表文字 1.14:1、品牌色小字 2.77–2.80:1、首屏被 4 张图表占满)已全部在 1.4.2 源码中修复,并有探针/公式级证据。
|
|
15
|
+
- **但最终验收仍不能判 PASS**:运行中的服务是 13:36 启动的旧 host;浏览器里到底跑的是哪份字节、修复后观感如何,**一次都没有实测**。这正是全任务的主要矛盾,只是对象换成了 1.4.2。
|
|
16
|
+
- 剩余 **P1 × 2、P2 × 3**,均为「不修也能用、但达不到一目了然/精美绝伦」的项;无阻塞级代码缺陷。
|
|
17
|
+
|
|
18
|
+
## 二、已修核对(我独立验证,不引用他人结论)
|
|
19
|
+
|
|
20
|
+
| 原缺陷 | 现证据 | 我的复核值 |
|
|
21
|
+
|---|---|---|
|
|
22
|
+
| 图表图例/坐标轴浅色 1.14:1 | 取色改读 `document.body`(`src/client.ts:1445`),`--dsw-alias-*` 确由主题包定义在 `body` 上(宿主 CSS 实测 `body{--dsw-alias-label-primary:…}`),`documentElement` 恒取空串 | 浅色 ink = `#0f1115`,对 `#f4f6f8` ≈ **17.4:1** |
|
|
23
|
+
| 品牌色 18px 数字 / 12px 胶囊 2.80、2.77:1 | 新增 `--dsh-wp-done-text/active-text` = `color-mix(in srgb, 品牌色 70%, 主文本色)`(`:362-363`),四处选择器已改用(`:540-541`、`:692-693`) | 浅色 **4.85 / 4.93:1**;深色 **7.43 / 7.53:1**(按 CSS Color 5 srgb 混合 + WCAG 公式计算,非浏览器读数;CHANGELOG 记 7.82/7.86,差异来自背景取 `#1b1c1f` vs `#232324`,两者都 ≥4.5) |
|
|
24
|
+
| 焦点环 2.66:1 | `:focus-visible` 改 `--dsw-alias-label-primary`(`:398`) | ≈ **18:1**(超过 WCAG 3:1) |
|
|
25
|
+
| 同屏两套百分比 | 图表标题写明口径:`chartGroups`=「两类计划数量占比」、`chartLive`=「进行中计划完成度(按工作项)」(`:35-36`) | 文案已含分母 |
|
|
26
|
+
| 「进行中 N」口径矛盾 | 摘要改「未完成 {open} / 已完成 {done}」(`:30-31`) | 与 aria 三态明细一致 |
|
|
27
|
+
| 主题切换图表文字不变色 | `MutationObserver` 监听 `body[data-ds-dark-theme]` 重建(`:1428-1433`) | 机制存在,**未在浏览器验证** |
|
|
28
|
+
| 折叠无自动展开 | 两个布尔依赖 `useEffect`(`:1645-1646`) | 代码路径正确,**未跑运行态用例** |
|
|
29
|
+
| 第 7+ 计划被静默丢弃 | `hiddenBars` + 「另有 {n} 个进行中计划未画入图表」(`:37`、`:1533`) | 不再静默,属可接受降级 |
|
|
30
|
+
| 首屏被图表占满 | `GroupCharts` 移到两组之后(`:1955`) | 已移动,但见 P1-1 |
|
|
31
|
+
| host 版本 1.4.1 ≠ package 1.4.2 | `src/host.ts:328` = `1.4.2` | 一致;但**运行中 host 仍是 13:36 的旧模块** |
|
|
32
|
+
|
|
33
|
+
## 三、P0(本轮无;以下 2 项属「P0 级验收风险」而非代码缺陷)
|
|
34
|
+
|
|
35
|
+
**R1 运行态未证:host 未重启,浏览器未实测。**
|
|
36
|
+
- 影响:用户在屏幕上看到的可能仍是旧 host + 新 client 的混合体;「1.4.2 已修复」目前只有源码与公式证据。
|
|
37
|
+
- 最小动作:重启 `dsh web`(见第五节),硬刷新后取服务端实际发出的 `client.js` 哈希比对。
|
|
38
|
+
- 验收:served `client.js` = 114,677 B / `49d7725…`;宿主 `meta.version` = 1.4.2;面板出现「未完成 N」与底部图表。
|
|
39
|
+
|
|
40
|
+
**R2 并发写入导致基线漂移。**
|
|
41
|
+
- 事实:14:01、16:06 两次在无人冻结的情况下改源码;本清单的哈希只覆盖 16:06 快照。
|
|
42
|
+
- 影响:任何「验收通过」都可能对应一份已经不存在的构建。
|
|
43
|
+
- 动作:复测前确认 `src/client.ts` 连续 60 s 哈希不变,再 build。
|
|
44
|
+
|
|
45
|
+
## 四、P1(2 项)
|
|
46
|
+
|
|
47
|
+
### P1-1 首屏仍可能看不到任务卡(修复只做了一半)
|
|
48
|
+
- **证据**:`GroupCharts` 已移到两组后(`:1955`),但 `Donut` + `TaskBars` 两张卡仍在 `.dsh-wp-overview`(`:1943-1946`),其前还有 5 格 statbar 与 scope note。CHANGELOG 称「打开面板先看到两组的任务卡」,**该断言未被验证,且从 DOM 顺序看仍不成立**。
|
|
49
|
+
- **量化**:按源码节点顺序,第一张任务卡之前仍有 2 张图表卡 + 5 格统计条 + 1 行说明;具体像素未知(无浏览器)。
|
|
50
|
+
- **最小改动**:把 `.dsh-wp-overview` 整块移到两组之后(与 `GroupCharts` 相邻),或折进 `<details>` 默认收起;不改数据结构。
|
|
51
|
+
- **验收**:1280×800 视口、刷新后不滚动,`document.querySelector('article[data-session-id]').getBoundingClientRect().top < 0.7 * innerHeight`;同时首屏可见「进行中」组头。
|
|
52
|
+
- **需主 Agent**:改后 `npm run build` + 重启 + 硬刷新;浏览器实测截图。
|
|
53
|
+
|
|
54
|
+
### P1-2 「已完成」组折叠后不可发现(自动展开已修,但默认态仍藏任务)
|
|
55
|
+
- **证据**:默认折叠逻辑仍在(`:1640` `useState(!(isDone && hasLive))`),1.4.2 只补了「清零/卡片迁移」两种自动展开。
|
|
56
|
+
- **影响**:有进行中任务时,历史完成情况完全不可见,用户需先理解 chevron 才会点开;对「一目了然」是净损失,但属设计既定取舍(§6.4 #1),不算缺陷。
|
|
57
|
+
- **判断**:**不修**。仅要求验收时确认组头有可点提示(chevron + hover 背景),避免「藏了但看不出能点」。
|
|
58
|
+
- **验收**:组头 `:hover` 有背景变化、`aria-expanded=false`、chevron 指向右;点击后卡片出现且 DOM 未卸载。
|
|
59
|
+
|
|
60
|
+
## 五、P2(3 项,后续迭代)
|
|
61
|
+
|
|
62
|
+
### P2-1 两组视觉仍缺区分(设计稿 §6.4 六项中 4 项未达)
|
|
63
|
+
- **证据**:全文件 `✓` 出现 **0 次**(已完成组无对勾);`.dsh-wp-group-ring-arc` 只有一种 `--dsh-wp-done-ink`(`:409`),进行中组也是蓝环;两条导轨仍是 `linear-gradient`(`:391-392`,深色 `:655-656`)。
|
|
64
|
+
- **影响**:组别区分仍主要靠文字与折叠状态,「精美」维度停在能看。
|
|
65
|
+
- **最小改动**:3 行 CSS + 1 个字符:按 `group` 给环换色(live 用 `--dsh-wp-active-text`);导轨改实色;已完成组标题前加 `✓`(`aria-hidden`)。
|
|
66
|
+
- **验收**:渲染树中出现 2 种 `stroke` 值;`✓` 计数 ≥1;导轨 `background-image` 为 `none`。
|
|
67
|
+
|
|
68
|
+
### P2-2 最小字号 11px 与图例缺数量
|
|
69
|
+
- **证据**:环中心百分比 `font-size: 11px`(`:410`),为面板最小字号;环形图 `legend.labels` 只有标签无数量(`:1467`)。
|
|
70
|
+
- **影响**:292px 窄栏下百分比偏小;图例看不出 2/4 这类计数,需靠 aria。
|
|
71
|
+
- **最小改动**:11px → 12px;legend 的 `generateLabels` 或 label 文案拼上数量(已有 aria 计数可直接复用)。
|
|
72
|
+
- **验收**:全面板 `font-size` 最小值 ≥12px;图例文本含数字。
|
|
73
|
+
|
|
74
|
+
### P2-3 `color-mix` 兼容性无兜底
|
|
75
|
+
- **证据**:`:362-363` 依赖 `color-mix()`;Safari <16.2 / Chrome <111 不支持时该声明在计算值阶段失效,`color` 回退为继承色。
|
|
76
|
+
- **影响**:旧浏览器不崩,但状态色丢失(文字仍可读,方向安全);不确认用户浏览器版本,故列 P2。
|
|
77
|
+
- **最小改动**:在 `color-mix` 声明前加一行普通 `color: var(--dsw-alias-label-primary)` 兜底(同选择器内),或 `@supports not (color: color-mix(in srgb, red, blue))` 分支。
|
|
78
|
+
- **验收**:目标浏览器 computed color 非空且对比度 ≥4.5;不合规浏览器下不出现透明/继承异常。
|
|
79
|
+
|
|
80
|
+
## 六、需主 Agent 执行的动作(按顺序,缺一不可)
|
|
81
|
+
|
|
82
|
+
1. **冻结写入**:连续两次(间隔 ≥60 s)`shasum -a 256 plugins/dsh-workplan/src/client.ts`,一致才继续。
|
|
83
|
+
2. **重建 + 测试**:
|
|
84
|
+
`cd <repo> && npm run build && npm test`
|
|
85
|
+
期望:**79/79 pass**;`shasum -a 256 client.js` 记录新值(当前快照为 `49d7725…`)。
|
|
86
|
+
3. **重启**(必须;host 模块 16:08 已重建但进程仍是 13:36 的):
|
|
87
|
+
`kill 75646`,确认 `lsof -nP -iTCP:3080 -sTCP:LISTEN` 为空;
|
|
88
|
+
再以原命令启动:
|
|
89
|
+
`<npm-cache>/_npx/_npx/c8633a242642d858/node_modules/.bin/dsh --profile web --host 127.0.0.1 --port 3080 --trusted-host <your-tailnet-host> --no-open`
|
|
90
|
+
4. **硬刷新**(Cmd+Shift+R),确认加载的 `client.js` 为 114,677 B / `49d7725…`。
|
|
91
|
+
5. **运行态复测**(同一探针口径):
|
|
92
|
+
- `canvas` 节点数 = 2(S3 样本);
|
|
93
|
+
- 图例/刻度颜色 = `#0f1115`(浅)/ `#f9fafb`(深);
|
|
94
|
+
- 组头文案 = 「未完成 N / 已完成 M(完成率 x%)」;
|
|
95
|
+
- 有进行中时已完成组 `aria-expanded="false"`,点击后 `true` 且卡片 DOM 仍在;
|
|
96
|
+
- 7 个进行中计划 → 条形图出现「另有 1 个进行中计划未画入图表」;
|
|
97
|
+
- 首屏第一张 `article[data-session-id]` 的 `top`(P1-1 验收)。
|
|
98
|
+
6. **留存证据**:重启后实际派发字节的哈希、上述 6 项读数、首屏截图(浅色 + 深色)。
|
|
99
|
+
|
|
100
|
+
## 七、未验证 / 风险
|
|
101
|
+
|
|
102
|
+
1. 无浏览器 DOM 与截图:本清单所有颜色为解析式计算,像素位置、首屏可见性均为推断。
|
|
103
|
+
2. 深色主题下 `color-mix` 的实际合成未取样,仅公式计算。
|
|
104
|
+
3. 运行中 host 版本未知(13:36 启动),`/dsh-workplan/*` 路由是否与 1.4.2 client 完全匹配未验证。
|
|
105
|
+
4. 并发写入风险仍在:本文件只对 `3202a90b…` 快照负责。
|