dsh-workplan 3.0.3 → 3.0.9

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 CHANGED
@@ -1,3 +1,79 @@
1
+ ## 3.0.9 — 2026-11-19
2
+
3
+ - 3.0.9:五步工作法全量审计修复——结果块模板补 approachBasis 字段、全部结算阈值渲染进提示词(消除「40/40/20」简写遮蔽 resources/tools/prepared/evidence 四项下限)、五步证据不完整接入有界回喂(EVIDENCE_INCOMPLETE 闸)、负责人汇总 F11 校验接线生效、缺块/退回改结构化标志(不再依赖错误文案正则);专家汇报回调强制结构化 JSON 结算(非法 JSON 绝不计 done);取消 engines.dsh 版本门槛,各版本 DSH 均可安装使用
4
+
5
+ ## 3.0.8 — 2026-11-18(废除两轮深度思考,五步工作法单框架)
6
+
7
+ - **废除「两轮深度思考」开工门禁**:2.5.1/2.5.2 引入的 deepThink 两轮产物(主 Agent dispatch / 负责人 review+direct / 专家 self_effort 三处硬门禁)与五步工作法(2026-11-17 引入)长期双轨并存——两轮内容本就是五步第 1、2 步的子集,同一内容双份提交、无一致性比对,且模块名/错误信息仍停留在三阶段口径。本版按用户裁决彻底废除 deepThink 双轨,五步工作法成为唯一框架。
8
+ - **开工闸升级**:三处开工门禁统一改查五步第 1/2/3 步证据 `startPhases`(第一步任务梳理 ≥40 字、第二步资源 ≥20 字/工具 ≥10 字/方法 ≥40 字/依据 ≥20 字、第三步准备与就绪证据各 ≥20 字);错误码 `DEEP_THINK_*` / `MAIN_DEEP_THINK_*` → `START_EVIDENCE_MISSING` / `START_EVIDENCE_INCOMPLETE`(direct 动作为 `DELEGATE_DIRECT_START_*`)。
9
+ - **开工-结算一致性比对(新)**:结算时若行级已登记 startPhases,`phases.planning` 各清单条数与合计字符数必须 ≥ 开工登记值——收尾证据不得稀释开工时登记的第 1/2/3 步证据,违反即判 blocked(错误文案「开工-结算证据不一致」)。
10
+ - **consolidation 瘦身**:分工表不再内嵌开工证据,`ConsolidationInput` 只剩 `taskReasoningEffort(+Declared)` + `assignments`;`planDelegations` 删除三道两轮字数闸,开工证据一律经 `startPhases` 提交登记。
11
+ - **三阶段→五步全量改名**:`three-phase.ts` 删除,新模块 `five-step.ts`(契约版本 4);状态字段 `mainDeepThink→mainStartPhases`、`delegateDeepThinks→delegateStartPhases`、`delegates[].deepThink→delegates[].startPhases`(durable 键同步,历史存档零迁移:读不到即回 phase-0 补交);verify 工具与全部提示词口径统一为「第四步核验/五步证据」。
12
+ - **回归**:开工闸(START_EVIDENCE_* 缺交/太薄/边界 40-40-20-20-10-20)、开工-结算一致性比对、consolidation 瘦身、改名回放全链测试全量改写对齐;版本断言随定版升级 3.0.8。
13
+
14
+ ## 3.0.7 — 2026-11-18(用户确认回复:自动放行并派发对应任务)
15
+
16
+ - **事故背景**:用户对计划回复「按你的建议执行」,旧的三类分类器(社交消息 / 空泛追问 / 进度提问)都不认确认回复,它就被当成全新任务——先把原任务在途的后台分解取代中止,再对这句确认本身启动新一轮分解;下一条消息又取代这一轮,任务永远开不了跑(无限取代循环)。本会话 2026-11-18 实测复现。
17
+ - **用户想法(原话)**:「收到用户确认回复后,你应该结合所有上下文全面、深入分析、思考、研究后,开始依据得出的所有结果分配任务」。
18
+ - **新增 `isUserConfirmation`(plan.ts)**:与三个既有分类器同层的纯函数判定。保守、可证三条件——文本 ≤24 字符;含至少一个认可信号词;不含任何否定词,且剥掉全部信号词与填充词后必须一个不剩。任何实质内容都会落选:如「可以,但范围改成X」回落到常规新任务路径——以该消息为最新输入、结合全部上下文**重新分解**(=深入分析)后按新计划分配任务,正是用户裁决的语义,而不是误当纯确认直接开跑旧计划。
19
+ - **用户补充裁决(2026-11-18,同版本吸收)**:「用户确认后,无论任务是否已经生成,都必须结合所有上下文和用户的回复,全面、深入开展分析、思考、研究,然后依据得出的所有结果开始分配任务」——**分析在先、派发现在**。据此,maybePlan 确认分支(runtime.ts)按当时实际状态分三种情形:① 已有计划未派发(含被认可闸门按住的)→ 解除按住(`gateHistory` 落档 `by:'user'`)、刷新 `conversationContext` 为含确认消息的全量上下文,并向主 Agent 下达**分析-派发指令**(必须 deepThink 登记完整分析后 `workplan_dispatch`;分析发现计划需调整则先 `replan` 再派发);本回合标记 activeTurns,主 Agent 若未在回合内派发,收尾闸门拦停 steer 兜底,不留「确认后无人派发」的尾巴。插件不在钩子层不经分析机械开跑。② 后台分解在途 → 标记 `planningEntry.userConfirmed`,原分解不被取代中止;后台分解本身就是结合全量上下文的深入分析,计划一生成即跳过认可闸门、刷新上下文后自动派发(=依据分析结果分配任务)。③ 其余(执行中/无计划/社交场景)→ 原样放行,绝不把确认当成新任务重新分解。plan 模式(先审后执行)下确认只记录不派发,保护不变。
20
+ - **双保险**:`onInboxInserted` 的取代守卫同步排除确认回复,确认消息不会先把原规划中止掉;重复确认只通知一次。
21
+ - **回归**:新增 `tests/workplan-user-confirmation.test.ts` 7 例(事故原句、中英正例全集、含实质内容反例、长度/类型/标点边界);版本断言(package.json / tool-surface fixture / host meta)随定版升级 3.0.7。
22
+
23
+ ## 3.0.6 — 2026-11-18(审计后第 1–4 批:数据安全、并发排队、看板开销、收尾闸门与复审修复)
24
+
25
+ - **永久记忆不再可能被整体清空**:`recordLesson` 读文件失败(EACCES/EMFILE/EIO/路径被目录占用)时直接抛 `LESSONS_READ_FAILED` 并拒绝写入,不再把“读失败”当成“空文件”后覆盖;重写时把无法解析的坏行原样带回文件末尾;覆盖前留一代 `<file>.bak`。
26
+ - **journal 回读不再误报成功为失败**:写后校验从“只看末 5 行”改为全文件定位本次写入,避免并发追加把刚写入的行挤出窗口后误报 `JOURNAL_READBACK_FAILED`、调用方重试又重复写一条。
27
+ - **看板响应上限按字节计**:`body.length` 改为 `Buffer.byteLength`,截断后复检;先减会话数,再丢单会话大块明细,最后只留摘要,任何一级都返回合法 JSON。
28
+ - **鉴权 fail-closed**:`connection.requestRejection` 不存在时返回 503,不再因可选链静默放行全部会话计划。
29
+ - **文档更正**:README 不再声称“不写磁盘”“并发固定 5 个”;如实写明 journal/lessons 两类落盘文件,以及 5 个/轮 + 宿主 `maxActiveSubagents`(默认 8)的真实并发边界。
30
+ - **回归**:新增 4 例(读失败拒写、坏行保留 + `.bak`、字节截断、未超限原样返回);全量 **1218 例:pass 1217 / fail 0 / cancelled 0**(1 例 todo)。
31
+
32
+ ### 第 2 批:并发上限排队、看板轮询合并、静态资源缓存、留痕可选清理
33
+
34
+ - **撞宿主并发上限不再直接判失败**:新增 `startActivationQueued`,三处 `subagents.startActivation`(主导派发、自配档接续、成员派发)撞 `ACTIVATION_LIMIT_REACHED` 时按指数退避(1s→15s)+ 全局冷却等待空位,最多等 10 分钟;等待期间不写失败状态、不消耗子任务 attempt,取消时抛 `ABORTED`,等满才如实报“仍未等到空位”。
35
+ - **看板轮询按会话共享**:同一 `sessionId`(或“全部会话”)只保留一个 4 秒轮询器和一组订阅者,最后一个订阅者卸载时停止;不再每个 `TurnCard` 各发一份请求。
36
+ - **图表库只读一次**:`/dsh-workplan/vendor/chart.umd.js` 首次读取后缓存 Buffer,后续请求不再每次 `readFileSync` 210KB;读取失败不缓存,仍可重试。
37
+ - **留痕可选清理(默认关闭)**:新增 `journalRetentionDays` / `DSH_WORKPLAN_JOURNAL_RETENTION_DAYS`,默认 0 = 永久保留;正数时启动及每 24 小时删除超过该天数未更新的合法 `<planId>.jsonl`(跳过符号链接,单次最多 200 个最旧文件)。
38
+ - **回归**:新增 4 例并发排队 + 5 例留痕清理 + handle-policy 白名单登记;全量 **1227 例:pass 1226 / fail 0 / cancelled 0**(1 例 todo),`npm run build` 已同步 `lib/`。
39
+
40
+ ### 第 3 批:收尾等待上限、专用通知台账、结构化门禁死锁修复
41
+
42
+ - **回合收尾不再无限等待**:`agent/turn-stopping` 等待在途规划/派发新增上限 `turnStoppingMaxWaitMs` / `DSH_WORKPLAN_TURN_STOPPING_MAX_WAIT_MS`(默认 60 分钟,0 = 无限旧行为)。到点不杀任务:计划仍在后台执行、结果照常落盘;交互式按「等待预算耗尽」放行但留痕(`releasedIncomplete.reason='wait-exhausted'` + 每回合至多一条通知),fail-closed(headless)抛 `WORKPLAN_WAIT_EXHAUSTED` 并以错误收尾。只约束收尾等待,不构成部门/专家执行时限。
43
+ - **专用通知台账**:宿主禁止插件新增 Session 事件类型(重启会拒开)且 `appendPluginRecord` 保留给实验包,故通知权威流落在插件自有 JSONL(默认 `~/.dsh/workplan/notices.jsonl`,`DSH_WORKPLAN_NOTICES_FILE` 可覆盖):`appendUserMessage` 每次成功落盘 workplan 通知即同步记一行(sessionId/planId/kind/form/summary/text + 对应 surface seq),与用户真实输入彻底分离;写失败不拖垮投递,失败行进内存环形缓冲(上限 100)下次补落,绝不静默丢弃。
44
+ - **结构化门禁死锁修复**:复杂任务按裁决强制 ≥8 名专家(上限 12),而部门汇总 `sources` 必须逐人覆盖全部已派发专家——旧实现把 `sources` 也卡 6 条精简上限,7–12 人的部门永远交不出合法汇总。现 `sources` 单独放宽到 16 条(其余三个数组仍 6 条),契约文案同步。
45
+ - **回归**:新增 4 例收尾等待上限 + 5 例通知台账 + 1 例 sources 覆盖(12 人通过 / 其余数组仍限 6 条 / 第 17 人仍拒);测试进程全局隔离台账路径;全量 **1237 例:pass 1236 / fail 0 / cancelled 0**(1 例 todo),`npm run build` 已同步 `lib/`。
46
+
47
+ ### 第 4 批:复审修复(自引入回归 + 高危缺口 + 中危加固)
48
+
49
+ **自引入回归(第 1–3 批的收尾)**
50
+ - **journal 回读 O(n²) → O(窗口)**:写后校验不再全文件重读,只读末尾 64KB 窗口内定位本次写入(O_APPEND 保证新行必在末尾);单行体积超窗口的极端情形会在错误信息里如实呈现末 5 行摘要。
51
+ - **通知台账有界且加固**:新增 `NOTICE_LEDGER_MAX_LINES = 5000`(`DSH_WORKPLAN_NOTICES_MAX_LINES` 可覆盖),超限原子重写为最新 N 行;目录 0o700、文件 0o600,写前 lstat 防符号链接投毒(跳过 + warn,不抛错)。
52
+ - **等待耗尽标志按派发实例复位**:三处 `dispatchPromise` 赋值前清零 `turnWaitExhausted`/`waitExhaustedNotifiedTurn`,同一记录再次派发不再被"零预算"秒放行、不再每回合误发上限通知。
53
+ - **F11 文案与门禁同源**:下发部门负责人的 comm-format 文本改为「keyResults/keyInfo/importantInfo 每项最多 6 条;sources 最多 16 条且必须逐人覆盖」,不再与放宽后的门禁相互矛盾。
54
+
55
+ **高危缺口**
56
+ - **僵尸 in_progress 回收**:重启/崩溃回放时,无人调度且失联的 in_progress 行降级为 blocked(留痕 + warn),既有重置/重派路径可接管,不再永远"正在做";cancelled/superseded 计划的历史留痕原样回放不受影响。
57
+ - **salvaged 半截计划不再自动派发**:规划器只抢救出残缺结果时暂停自动执行,给用户一条可见通知,确认后再 `workplan_dispatch`。
58
+ - **bash 写保护绕过封堵**:`fileWriteGuardReason` 新增 shell 命令启发式(`>`/`>>`/heredoc、`tee`、`sed -i`、`mv`/`cp`/`install` 目标位、`dd of=`,按 `&&`/`;`/`|` 分段、去引号、20k 截断),已交付文件不能再用 bash 原地改写;只读命令不拦。
59
+ - **认可闸门否定/引用识别**:命中点前 40 字符窗口内出现否定词(不用/无需/不必/勿/别/禁止…)、制度转述词(原文/制度/规定/条款)或引号包裹时不再误触发,「不用经用户认可再执行」与粘贴的规章原文不再把计划按住。
60
+ - **澄清闸轮次上限**:同一会话连续 2 轮触发澄清后放行进入规划(30 分钟无触发自动归零 + `resetClarifyRounds` 导出),不再「越简短回答越问不出计划」的活锁。
61
+ - **看板三处**:`/plans` 轮询 15 秒超时(超时走错误路径 + 警告横幅,不再永久冻结)、后台标签页暂停轮询(回前台补一轮)、服务端截断标志(`truncated`/`omittedSessions`/`omittedDetail`)不再被前端丢弃,裁剪时看板显示"部分数据已省略"提示。
62
+
63
+ **中危加固**
64
+ - **lessons 仅限根会话**:`dsh_workplan_lessons` 增加根会话硬校验,子 Agent(含其他插件拉起的会话)不再能读全局跨项目经验文件。
65
+ - **本地文件权限收紧**:journal/lessons/notice-ledger 写路径统一 0o600 文件 + 0o700 目录 + 写前符号链接校验(lessons 遇符号链接抛 `LESSONS_WRITE_REFUSED`)。
66
+ - **原子门英文盲区**:句末符补英文句点(后跟空白/结尾才算,版本号 a.ts/1.12.0 不误伤)、并列词补 并/然后/接着/再(否定/频率语境不误伤);报错如实报告截断后长度。
67
+ - **验收措辞归一化**:覆盖匹配前对验收项与子 Agent 文本做全角折叠、完成态前缀剥离(已完成/完成/已/done/yes)、标点空白归一,「换个措辞就永远 missing」的无限退回关闭;three-phase 私有副本同步。
68
+ - **prune 增强**:清理排除当前活跃计划(不再误删"活跃但安静"的审计留痕)、unlink 失败逐条 warn + `errors` 留痕、首次清理挪出激活路径(启动 10 秒后,随插件卸载清除)。
69
+ - **回归**:新增 77 例(journal/ledger 9、wait-cap 1、comm-format 1、client 轮询 7、认可闸门 14、澄清闸 14、原子门 6、验收归一化 8、lessons 守卫 9、zombie 2、salvaged 2、bash 守卫 22、prune 4 等);全量 **1327 例:pass 1326 / fail 0 / cancelled 0**(1 例 todo),`npm test` 内置 build 已同步 `lib/`。
70
+
71
+ ## 3.0.5 — 2026-11-17
72
+
73
+ - **机制改进(用户四步闭环)**:第三层专家遇阻必须 `dsh_workplan_escalate` 向部门负责人请示;负责人在答复前必须全面梳理该问题与本部门全部已派发任务执行状态、研究方案,并用 `dsh_workplan_instruct` 把决定投回原专家;原专家继续执行。
74
+ - **硬闸门**:任一第三层成员待指示时,`dsh_workplan_delegate` 的 `review/dispatch/direct` 一律拒绝改派/重派/降级(`DELEGATE_ESCALATION_OPEN`);`dsh_workplan_instruct` 只允许答复已请示成员(`NOT_ESCALATED`),投递成功后原专家恢复执行。
75
+ - **回归**:新增 `tests/workplan-305-escalation-owner-continuity.test.ts`,并同步负责人 brief、专家任务书、工具描述与版本口径到 3.0.5。
76
+
1
77
  ## 3.0.3 — 2026-11-17
2
78
 
3
79
  - release v3.0.3: latest source + version publish
package/README.en.md CHANGED
@@ -3,12 +3,12 @@
3
3
  > **Two selling points, one line: a full ISO/IEC 15408:2026 evidence pack you can verify with 5 commands, and a one-command install with zero runtime dependencies.**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-3.0.3-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.3)
6
+ [![version](https://img.shields.io/badge/version-3.0.9-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
7
7
 
8
8
  Adds "plan first → dispatch real department subagents → watch progress in the sidebar" to **DeepSeek Harness (DSH)**. No app, no DSH source patch, no page replacement.
9
9
 
10
10
  - A task-decomposition block appears in the conversation first: stages, work items, departments, acceptance criteria
11
- - Up to 5 real subagents run in parallel and write results back into the session
11
+ - Up to 5 department leads start per round; the whole session tree is capped by the host's `maxActiveSubagents` (default 8)
12
12
  - The **Task progress** panel shows who is working, how far, and what is stuck
13
13
 
14
14
  **中文(简体)说明:** [README.md](README.md)
@@ -52,7 +52,7 @@ For every new task with a real goal, the plugin inserts three beats:
52
52
 
53
53
  1. **Plan before acting.** Before the model's first step, it writes a plan: stages → concrete work items → which department owns each one → how to do it → what counts as done → what could go wrong.
54
54
  2. **Show the plan first.** The plan appears in the conversation as a task-decomposition block, so you can see the reasoning and acceptance criteria instead of a one-line promise.
55
- 3. **Dispatch real work.** Each work item is handed to a **real DSH subagent** (up to 5 at a time), and results are written back to the session. The main agent must dispatch and wait for the department results before it continues.
55
+ 3. **Dispatch real work.** Each work item is handed to a **real DSH subagent** (up to 5 leads per round; leads may spawn experts, and the whole tree is capped by the host's `maxActiveSubagents`, default 8), and results are written back to the session. The main agent must dispatch and wait for the department results before it continues.
56
56
 
57
57
  Greetings, thanks, and status questions ("how far along are we?") do not trigger a plan.
58
58
 
@@ -80,7 +80,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
80
80
  ## Install
81
81
 
82
82
  ```bash
83
- dsh plugin --profile web add dsh-workplan@3.0.3
83
+ dsh plugin --profile web add dsh-workplan@3.0.9
84
84
  ```
85
85
 
86
86
  Restart the DSH Web process (or reload the page) so the bundle is picked up.
@@ -151,7 +151,7 @@ A passing retrospective is appended to the **permanent lesson memory** at `~/.ds
151
151
  | Planner stall window | 90 s of missing output after streaming starts; transport health only | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
152
152
  | Planner absolute ceiling | 15 min; planning only | Scales with `…_PLANNER_TIMEOUT_MS` |
153
153
  | Automatic resumes | 2; non-time pause recovery, not an execution clock | `DSH_WORKPLAN_MAX_RESUMES` |
154
- | Subagent concurrency | 5 (fixed) | — |
154
+ | Subagent concurrency | **Up to 5 leads per round**; the whole tree is capped by the host's `maxActiveSubagents` (default 8) | — |
155
155
 
156
156
  Individual model connections, Bash commands, and disposal waits retain their local health checks; they are not department task deadlines. Without automatic time-based termination, genuinely stuck work can keep consuming concurrency and spend, so use the dashboard/`status` and explicitly cancel or redirect it. Legacy deadlines, extension journals, timeout counts, and criterion fields remain readable history but never arm new timers.
157
157
 
@@ -161,10 +161,17 @@ Non-time settings can still be placed in the plugin config:
161
161
  { "maxResumes": 2 }
162
162
  ```
163
163
 
164
+ The plan journal is kept **forever** by default. Only when a positive retention is configured does the plugin prune `<planId>.jsonl` files untouched for that many days, at startup and every 24 hours (at most 200 oldest files per run; active plans keep appending and are never pruned):
165
+
166
+ ```jsonc
167
+ { "journalRetentionDays": 90 }
168
+ // same as DSH_WORKPLAN_JOURNAL_RETENTION_DAYS=90
169
+ ```
170
+
164
171
  ## Security and privacy
165
172
 
166
173
  - **No third-party runtime dependencies** — `dependencies` is empty.
167
- - **No filesystem writes** — no `writeFileSync` / `appendFileSync` / `mkdirSync` in `src/`; results go into the DSH session record.
174
+ - **Writes only two local file families, never your project** — ① `~/.dsh/workplan/journal/<planId>.jsonl` (plan journal); ② `~/.dsh/workplan/lessons.jsonl` (permanent lessons). Both paths can be overridden by env vars; `appendFileSync` / `writeFileSync` appear only in `dept-journal.ts` and `lessons.ts`.
168
175
  - **No outbound traffic** — no `child_process`, no external `fetch`/`http.request`; the one `fetch` is the browser asking its own origin for `/dsh-workplan/plans`.
169
176
  - **The panel route is authenticated** — unauthenticated requests get 401.
170
177
  - **Chart.js is vendored** (`vendor/chart.umd.js`, MIT); no CDN script is loaded.
@@ -173,7 +180,8 @@ Verify it yourself:
173
180
 
174
181
  ```bash
175
182
  npm view dsh-workplan@latest dependencies
176
- grep -RInE "writeFileSync|child_process|eval\(" src
183
+ grep -RInE "child_process|eval\(" src
184
+ grep -RIn "appendFileSync\|writeFileSync" src # only dept-journal.ts and lessons.ts
177
185
  npm audit --omit=dev
178
186
  ```
179
187
 
package/README.md CHANGED
@@ -3,12 +3,12 @@
3
3
  > **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-3.0.3-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.3)
6
+ [![version](https://img.shields.io/badge/version-3.0.9-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
7
7
 
8
8
  给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
9
9
 
10
10
  - 对话里先出【任务分解】:阶段、子任务、部门、验收标准,一样不缺
11
- - 最多 5 个真实子 Agent 并行执行,结果写回会话
11
+ - 每轮最多 5 个部门负责人并行启动;负责人还会再派专家,整棵会话树同时活跃的子 Agent 受宿主 `maxActiveSubagents` 约束(默认 8)
12
12
  - 左侧栏「任务进度」:谁在做、做到哪、哪件卡住了
13
13
 
14
14
  **English (US) — plain-language guide:** [README.en.md](README.en.md)
@@ -54,7 +54,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
54
54
 
55
55
  1. **先排计划**:你发出任务后、AI 真正动手前,它先写一份计划——分几个阶段、每个阶段几件具体工作、每件工作交给哪个部门、怎么做、什么算做完、可能卡在哪。
56
56
  2. **计划先给你看**:这份计划以「任务分解」的形式出现在对话里,包含每一步的依据与验收标准,而不是一句话糊过去。
57
- 3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(最多 5 个同时跑),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
57
+ 3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(每轮最多 5 个负责人同时启动;负责人再派专家,整棵树受宿主上限约束,默认 8),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
58
58
 
59
59
  计划不是装饰品:主 Agent 必须先派发、等到部门结果回来,才能继续往下答。
60
60
 
@@ -62,14 +62,14 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
62
62
 
63
63
  | 要求 | 说明 |
64
64
  |---|---|
65
- | DeepSeek Harness | **≥ 0.2.2-rc.3**(官方 Web 版,`dsh web` / `--profile web` 跑的这套;`engines.dsh` 会拦截过低版本) |
65
+ | DeepSeek Harness | 官方 Web 版(`dsh web` / `--profile web` 跑的这套;自 3.0.9 起对 DSH 版本不作要求,均可安装使用) |
66
66
  | Node.js | **22 或更高**(`node -v` 自查) |
67
67
  | 网络 | 安装时需要能访问 npm registry |
68
68
 
69
69
  ## 一键安装
70
70
 
71
71
  ```bash
72
- dsh plugin --profile web add dsh-workplan@3.0.3
72
+ dsh plugin --profile web add dsh-workplan@3.0.9
73
73
  ```
74
74
 
75
75
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
@@ -113,28 +113,30 @@ dsh plugin --profile web add "$(pwd)"
113
113
  | `dsh_workplan_instruct` | 主 Agent 回答请示并下达指示;失败则挂起,子任务下次激活时注入。60 秒无回执只提示,不按时间判失败或中止。 |
114
114
  | `dsh_workplan_handoff` | 处置跨部门需求:`list` / `assign` / `resolve` / `close`。未处置会拦住交付;对「待指示」的行 `resolve` 会直接把答复投递给子会话。 |
115
115
  | `dsh_workplan_followup` | 给已中止或暂停、但产物已落盘的直接子会话补一条收尾说明。 |
116
- | `dsh_workplan_verify` | 子 Agent 在**阶段三(验证阶段)**提交三阶段证据做核验;阶段一、二调用会返回 `PHASE_GATE`。核验通过≠完成,最终仍由完成判定复核。 |
117
- | `dsh_workplan_lessons` | 只读查看**永久教训记忆**:`list` / `search` / `stats`。它只读文件,不改计划状态;用来核对「到底记住了什么、哪些错误在重复发生」。 |
116
+ | `dsh_workplan_verify` | 子 Agent 在**第四步(验证阶段)**提交五步证据做核验;前三步证据不齐调用会返回 `PHASE_GATE`。核验通过≠完成,最终仍由完成判定复核。 |
117
+ | `dsh_workplan_lessons` | 只读查看**永久教训记忆**:`list` / `search` / `stats`。仅限根会话调用(子 Agent 不能跨项目读取);它只读文件,不改计划状态;用来核对「到底记住了什么、哪些错误在重复发生」。 |
118
118
 
119
119
  在 **plan 模式**下只会给你看计划,`dispatch` 会被明确拦下并说明原因,不会偷偷开跑。
120
120
 
121
- ## 三阶段工作法与自我学习(2.0.2 的核心)
121
+ ## 五步工作法与自我学习(3.0.8 的单框架)
122
122
 
123
- ### 三阶段:规划 → 执行 → 验证
123
+ ### 五步:任务梳理 → 资源/工具/方案研究 → 准备就绪 → 执行与验证 → 收尾复盘
124
124
 
125
- 每个部门 Agent 收到工作后,顺序不可颠倒:
125
+ 3.0.8 起,原「两轮深度思考」开工门禁并入五步工作法(两轮内容本就是第 1、2 步的子集,不再双份提交):每个部门 Agent 收到工作后,顺序不可颠倒,开工前必须完成前三步并登记开工证据 `startPhases`:
126
126
 
127
- | 阶段 | 必须完成的事 | 完成证据 |
127
+ | 步骤 | 必须完成的事 | 证据 |
128
128
  |---|---|---|
129
- | 一 规划 | 先梳理问题(现状/约束/未知/主要矛盾),再形成完整可执行思路(做什么、产出什么、如何证明) | `phases.planning` |
130
- | 二 执行 | 严格按阶段一的思路执行;需要改道必须记录原因 | `phases.execution.steps/deviations` |
131
- | 三 验证 | 逐条验证验收标准与用户原要求,并做**自我学习复盘** | `phases.verification` + `retrospective` |
129
+ | 一 任务梳理 | 全面、深入梳理自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界) | `startPhases.planning.problemAnalysis` + 结算 `phases.planning` |
130
+ | 二 资源/工具/方案 | 基于第一步全部结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据) | `startPhases.planning.resources/tools/approach/approachBasis` |
131
+ | 三 准备就绪 | 把资源与工具真正备齐并给出可复核的就绪证据 | `startPhases.preparation.prepared/evidence` |
132
+ | 四 执行与验证 | 严格按第二步的方法、流程、步骤执行并逐条验证;需要改道必须记录原因 | `phases.execution.steps/deviations` + `phases.verification` |
133
+ | 五 收尾复盘 | 逐条验证验收标准与用户原要求,并做**自我学习复盘** | `phases.verification` + `retrospective` |
132
134
 
133
- **关于「第一、二阶段禁用插件」的更正(2.0.2)**:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则(2.0.1 曾把它写成产品级规则,2.0.2 已更正)。三阶段约束的是部门子 Agent 的交付证据顺序;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。验证工具在缺规划或执行证据时返回 `PHASE_GATE` 并列出待补项——这是防止跳过前两阶段直接「验证通过」的门禁,不是禁用插件。遇阻上报 `dsh_workplan_escalate` 始终可用。
135
+ **关于「前三步禁用插件」的更正(2.0.2)**:这条只适用于 2026-11-05 本次优化会话,不是对所有后续会话的永久规则(2.0.1 曾把它写成产品级规则,2.0.2 已更正)。五步工作法约束的是部门子 Agent 的交付证据顺序;主 Agent 在任何阶段都可以正常使用计划、派发、查询与改判工具。验证工具在缺前三步证据时返回 `PHASE_GATE` 并列出待补项——这是防止跳过前三步直接「验证通过」的门禁,不是禁用插件。遇阻上报 `dsh_workplan_escalate` 始终可用。
134
136
 
135
137
  ### 自我学习与自我迭代:把弯路变成永久记忆
136
138
 
137
- 每次完成工作,阶段三必须提交四项复盘(缺一项就判未完成):
139
+ 每次完成工作,第五步收尾必须提交四项复盘(缺一项就判未完成):
138
140
 
139
141
  1. **problems**:本次全过程遇到的所有问题(现象 + 根因);
140
142
  2. **detours**:走过的弯路、返工与无效尝试(确实没有就写空数组,不编造);
@@ -178,7 +180,9 @@ DSH_WORKPLAN_LESSONS_FILE=/path/x.jsonl # 需要时用环境变量覆盖
178
180
  | 规划器静默判定 | 90 秒(仅规划输出传输健康保护) | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
179
181
  | 规划器绝对上限 | 15 分钟(仅规划器) | 随 `…_PLANNER_TIMEOUT_MS` 等比变化 |
180
182
  | 自动续跑次数 | 2 次(处理可续跑的非时间暂停,不是执行时钟) | `DSH_WORKPLAN_MAX_RESUMES` |
181
- | 并发子 Agent | 5 个(固定) | — |
183
+ | 回合收尾等待上限 | 60 分钟(只约束收尾时"等计划/派发落地"的等待;到点放行或报错但**不杀任务**,部门/专家执行本身仍无时限;0 = 无限旧行为) | `DSH_WORKPLAN_TURN_STOPPING_MAX_WAIT_MS` |
184
+ | 澄清闸轮次上限 | 同一回合对话连续触发 2 轮澄清提问后放行进入规划(30 分钟无触发自动归零) | 固定 |
185
+ | 并发子 Agent | **每轮最多 5 个负责人**;负责人还会再派专家,整棵会话树同时活跃的子 Agent 受宿主 `maxActiveSubagents` 约束(默认 8) | — |
182
186
 
183
187
  单次模型网络请求、单条 Bash 命令和清理等待仍有各自的局部健康保护;它们不是部门任务的总时限,不能用一条慢命令的传输超时替代整个任务 deadline。后台任务也不能绕过用户显式取消。
184
188
 
@@ -191,10 +195,17 @@ DSH_WORKPLAN_LESSONS_FILE=/path/x.jsonl # 需要时用环境变量覆盖
191
195
  { "maxResumes": 2 }
192
196
  ```
193
197
 
198
+ 留痕(`journal`)默认**永久保留**,不自动删除任何审计证据。只有显式配置正数时,才会在启动 10 秒后(不阻塞激活)和之后每 24 小时清理一次“超过该天数未更新”的 `<planId>.jsonl`(单次最多 200 个最旧文件;**当前活跃的计划始终排除**,正在执行的计划也会持续追加,不会被误删;单个文件删除失败会逐条告警留痕):
199
+
200
+ ```jsonc
201
+ { "journalRetentionDays": 90 }
202
+ // 等价环境变量:DSH_WORKPLAN_JOURNAL_RETENTION_DAYS=90
203
+ ```
204
+
194
205
  ## 安全与隐私(可以自己复核)
195
206
 
196
207
  - **没有第三方运行时依赖**:`dependencies` 是空的;装出来的只有这个插件自己的 JS、配置、图标和说明。
197
- - **不写你的磁盘**:源码里没有任何 `writeFileSync` / `appendFileSync` / `mkdirSync`(可 `grep` 验证);结果只写进 DSH 会话记录。
208
+ - **只写三类本地文件,不写你的项目目录**:① `~/.dsh/workplan/journal/<planId>.jsonl`(计划留痕:派发、指示、请示、完成);② `~/.dsh/workplan/lessons.jsonl`(永久教训记忆);③ `~/.dsh/workplan/notices.jsonl`(专用通知台账:workplan 通知的权威机器可读流,与用户真实输入分离)。三者都可用环境变量改到别处,统一 **0o600 文件 / 0o700 目录**权限并拒绝向符号链接写入;台账默认最多保留最新 5000 行(`DSH_WORKPLAN_NOTICES_MAX_LINES` 可改),超限原子重写;源码里的 `appendFileSync` / `writeFileSync` 只出现在留痕/记忆/台账这几个模块。
198
209
  - **不向外发数据**:源码里没有 `child_process`、没有对外 `fetch`/`http.request`;唯一的一次 `fetch` 是浏览器端请求**同源**的 `/dsh-workplan/plans`。
199
210
  - **面板数据要登录**:该路由走 DSH 自己的鉴权,未登录直接返回 401。
200
211
  - **图表库是本地自带**:`vendor/chart.umd.js`(Chart.js 4.6.1,MIT)随包分发,不加载任何 CDN 脚本。
@@ -203,7 +214,8 @@ DSH_WORKPLAN_LESSONS_FILE=/path/x.jsonl # 需要时用环境变量覆盖
203
214
 
204
215
  ```bash
205
216
  npm view dsh-workplan@latest dependencies # 应为空
206
- grep -RInE "writeFileSync|child_process|eval\(" src # 应无命中
217
+ grep -RInE "child_process|eval\(" src # 应无命中
218
+ grep -RIn "appendFileSync\|writeFileSync" src # 只应出现在 dept-journal.ts、lessons.ts 与 notice-ledger.ts
207
219
  npm audit --omit=dev
208
220
  ```
209
221
 
@@ -247,7 +259,7 @@ npm audit --omit=dev
247
259
 
248
260
  DSH 本身自带「子智能体」能力(内置 subagent 工具)。本插件**不替换、也不关闭**它,两者同时存在,请知道这三件事:
249
261
 
250
- 1. **插件的部门负责人/专家**由插件统一派发和管理,走 `dsh_workplan_delegate` 等 11 个工具的全部闸门(事前预估、分工表、两轮深度思考、结算核验、汇报核验)。
262
+ 1. **插件的部门负责人/专家**由插件统一派发和管理,走 `dsh_workplan_delegate` 等 11 个工具的全部闸门(事前预估、分工表、五步开工证据、结算核验、汇报核验)。
251
263
  2. **内置 subagent 工具在这些子会话里仍然可见**。如果模型绕过插件、直接调用内置 `subagent` / `subagent_fork`,那个人会话**不经过插件的任何闸门**(无台账、无核验、无执行管理),产物也不会自动进计划看板。发现看板外多出来路不明的子会话时,对它说「以后派活一律走 dsh_workplan」即可。
252
264
  3. **设置页两个子代理选项对本插件的影响不同**(已核实宿主源码,两条通道互不相干):
253
265
  - 「子代理最大深度」(`subagent.maxDepth`)**只管内置 subagent/subagent_fork 工具**——本插件的三层体系(你 → 部门负责人 → 专家)按派发契约固定申请第 2 层深度,宿主对插件契约单独放行,**该滑块在任何位置都不会影响、也不会拦阻**负责人派发给专家。首次检测到该设置 <2 时插件会一次性说明这一点(无需任何操作;想完全一致可把滑块调到 2,重启后恢复默认);
package/README.zh.md CHANGED
@@ -3,12 +3,12 @@
3
3
  > **两个卖点,一句话:ISO/IEC 15408:2026 全套安全证据,5 条命令自己验;安装一条命令、零第三方运行时依赖。**
4
4
 
5
5
  [![verify](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml/badge.svg)](https://github.com/abbaababa/dsh-workplan/actions/workflows/verify.yml)
6
- [![version](https://img.shields.io/badge/version-3.0.3-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.3)
6
+ [![version](https://img.shields.io/badge/version-3.0.9-blue.svg)](https://github.com/abbaababa/dsh-workplan/releases/tag/v3.0.9)
7
7
 
8
8
  给 **DeepSeek Harness(DSH)** 加一段「先拆计划 → 真派部门子 Agent 去做 → 左侧栏实时看进度」的能力。不装 App、不改 DSH 源码、不换页面。
9
9
 
10
10
  - 对话里先出【任务分解】:阶段、子任务、部门、验收标准,一样不缺
11
- - 最多 5 个真实子 Agent 并行执行,结果写回会话
11
+ - 每轮最多 5 个部门负责人并行启动;负责人还会再派专家,整棵会话树同时活跃的子 Agent 受宿主 `maxActiveSubagents` 约束(默认 8)
12
12
  - 左侧栏「任务进度」:谁在做、做到哪、哪件卡住了
13
13
 
14
14
  **English (US) — plain-language guide:** [README.en.md](README.en.md)
@@ -54,7 +54,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
54
54
 
55
55
  1. **先排计划**:你发出任务后、AI 真正动手前,它先写一份计划——分几个阶段、每个阶段几件具体工作、每件工作交给哪个部门、怎么做、什么算做完、可能卡在哪。
56
56
  2. **计划先给你看**:这份计划以「任务分解」的形式出现在对话里,包含每一步的依据与验收标准,而不是一句话糊过去。
57
- 3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(最多 5 个同时跑),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
57
+ 3. **真的派人去做**:确认后,每一件具体工作交给一个**真实的 DSH 子 Agent** 去执行(每轮最多 5 个负责人同时启动;负责人再派专家,整棵树受宿主上限约束,默认 8),结果写回会话;你在左侧栏「任务进度」里随时能看到谁在做、做到哪、哪件卡住了。
58
58
 
59
59
  计划不是装饰品:主 Agent 必须先派发、等到部门结果回来,才能继续往下答。
60
60
 
@@ -69,7 +69,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
69
69
  ## 一键安装
70
70
 
71
71
  ```bash
72
- dsh plugin --profile web add dsh-workplan@3.0.3
72
+ dsh plugin --profile web add dsh-workplan@3.0.9
73
73
  ```
74
74
 
75
75
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
@@ -139,7 +139,7 @@ dsh plugin --profile web add "$(pwd)"
139
139
  | 规划器静默判定 | 90 秒(输出开始后连一个字都不再来才算卡死) | `DSH_WORKPLAN_PLANNER_IDLE_TIMEOUT_MS` |
140
140
  | 规划器绝对上限 | 15 分钟(= 无进展上限 × 3,有无产出都到此为止) | 随 `…_PLANNER_TIMEOUT_MS` 等比变化 |
141
141
  | 自动续跑次数 | 2 次 | `DSH_WORKPLAN_MAX_RESUMES` |
142
- | 并发子 Agent | 5 个(固定) | — |
142
+ | 并发子 Agent | **每轮最多 5 个负责人**;整棵树受宿主 `maxActiveSubagents` 约束(默认 8) | — |
143
143
 
144
144
  这些规划器时限只保护“生成计划”这一步,不会作用到负责人或专家执行。执行阶段只由真实完成、真实错误、证据/质量门禁或用户取消改变;重试可由真实失败触发,不会因计时器到点触发。
145
145
 
@@ -148,7 +148,7 @@ dsh plugin --profile web add "$(pwd)"
148
148
  ## 安全与隐私(可以自己复核)
149
149
 
150
150
  - **没有第三方运行时依赖**:`dependencies` 是空的;装出来的只有这个插件自己的 JS、配置、图标和说明。
151
- - **不写你的磁盘**:源码里没有任何 `writeFileSync` / `appendFileSync` / `mkdirSync`(可 `grep` 验证);结果只写进 DSH 会话记录。
151
+ - **只写两类本地文件,不写你的项目目录**:① `~/.dsh/workplan/journal/<planId>.jsonl`(计划留痕);② `~/.dsh/workplan/lessons.jsonl`(永久教训记忆)。两者都可用环境变量改到别处;`appendFileSync` / `writeFileSync` 只出现在 `dept-journal.ts` 与 `lessons.ts`。
152
152
  - **不向外发数据**:源码里没有 `child_process`、没有对外 `fetch`/`http.request`;唯一的一次 `fetch` 是浏览器端请求**同源**的 `/dsh-workplan/plans`。
153
153
  - **面板数据要登录**:该路由走 DSH 自己的鉴权,未登录直接返回 401。
154
154
  - **图表库是本地自带**:`vendor/chart.umd.js`(Chart.js 4.6.1,MIT)随包分发,不加载任何 CDN 脚本。
@@ -157,7 +157,8 @@ dsh plugin --profile web add "$(pwd)"
157
157
 
158
158
  ```bash
159
159
  npm view dsh-workplan@latest dependencies # 应为空
160
- grep -RInE "writeFileSync|child_process|eval\(" src # 应无命中
160
+ grep -RInE "child_process|eval\(" src # 应无命中
161
+ grep -RIn "appendFileSync\|writeFileSync" src # 只应出现在 dept-journal.ts 与 lessons.ts
161
162
  npm audit --omit=dev
162
163
  ```
163
164