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 +76 -0
- package/README.en.md +15 -7
- package/README.md +32 -20
- package/README.zh.md +8 -7
- package/client.js +181 -27
- package/docs/release-notes-3.0.3.md +7 -0
- package/docs/release-notes-3.0.9.md +7 -0
- package/lib/approval-gate.js +79 -3
- package/lib/client.js +181 -27
- package/lib/comm-format.js +6 -6
- package/lib/dept-journal.js +223 -6
- package/lib/{three-phase.js → five-step.js} +210 -134
- package/lib/host.js +316 -79
- package/lib/lessons.js +87 -19
- package/lib/llm-rules.js +25 -82
- package/lib/notice-ledger.js +238 -0
- package/lib/plan.js +275 -68
- package/lib/runtime.js +747 -161
- package/lib/understanding.js +85 -6
- package/lib/v3-contract.js +48 -15
- package/package.json +2 -3
- package/src/approval-gate.ts +77 -3
- package/src/client.ts +178 -24
- package/src/comm-format.ts +6 -6
- package/src/dept-journal.ts +219 -7
- package/src/{three-phase.ts → five-step.ts} +236 -169
- package/src/host.ts +316 -79
- package/src/lessons.ts +92 -19
- package/src/llm-rules.ts +30 -101
- package/src/notice-ledger.ts +251 -0
- package/src/plan.ts +276 -66
- package/src/runtime.ts +800 -159
- package/src/understanding.ts +100 -6
- package/src/v3-contract.ts +49 -16
package/lib/host.js
CHANGED
|
@@ -12,8 +12,9 @@ import { fileURLToPath } from 'node:url';
|
|
|
12
12
|
* - the read-only dashboard route.
|
|
13
13
|
*/
|
|
14
14
|
import { applyHardeningHeaders, cancelToolOutputSchema, createWorkplanRuntime, dispatchToolOutputSchema, plannerOutputSchema, replanToolOutputSchema, statusToolOutputSchema, updateToolOutputSchema, } from './runtime.js';
|
|
15
|
-
import { DEPARTMENT_IDS, isRecord } from './plan.js';
|
|
15
|
+
import { DEPARTMENT_IDS, isRecord, START_EVIDENCE_MIN_CHARS_BRIEF } from './plan.js';
|
|
16
16
|
import { autoResumeEnabledFrom } from './auto-resume.js';
|
|
17
|
+
import { pruneJournal } from './dept-journal.js';
|
|
17
18
|
/*
|
|
18
19
|
* [1.8.14] Identity of the modules this process actually loaded (N1).
|
|
19
20
|
*
|
|
@@ -54,6 +55,13 @@ const LOADED_BUILD = (() => {
|
|
|
54
55
|
* "restarted after the fix" from "same process, rebuilt files on disk".
|
|
55
56
|
*/
|
|
56
57
|
const PROCESS_STARTED_AT = Date.now() - Math.round(process.uptime() * 1000);
|
|
58
|
+
/*
|
|
59
|
+
* [3.0.6][第 2 批] 静态图表资产只读一次。
|
|
60
|
+
* 旧实现每次请求都 readFileSync 210KB(看板每次加载都拉一次),在请求路径上
|
|
61
|
+
* 做磁盘 I/O 没有必要:vendor 文件随插件发布、运行期不会变。缓存 Buffer 后
|
|
62
|
+
* 后续请求直接复用;读取失败不缓存,下次仍会重试。
|
|
63
|
+
*/
|
|
64
|
+
let chartVendorBytes = null;
|
|
57
65
|
function phaseLabel(phase) {
|
|
58
66
|
if (phase === 'paused')
|
|
59
67
|
return '本轮预算用尽,可续跑';
|
|
@@ -85,13 +93,13 @@ const PROMPT_SECTION = [
|
|
|
85
93
|
'3.0.0 任务书质量要求(用户要求 3/6):插件派给部门负责人的每个子任务都携带 qualityRequirements(结果质量要求),部门负责人派给专家的每条任务也必须携带 qualityRequirements。负责人→专家缺它平台直接拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING);主 Agent→部门负责人缺它则该子任务在派发时被直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),须 replan 补齐后重派。你审阅计划时先看每个子任务是否写了清楚的质量要求。',
|
|
86
94
|
'3.0.0 极简任务(用户要求 5,用户裁决 A=硬门槛):部门负责人派出的每条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收,单句、≤300 字符、不含「并且/同时/另外/还要/以及/分别/顺便」等并列词;不满足即被拒绝并给出拆分提示(DELEGATE_TASK_NOT_ATOMIC)。',
|
|
87
95
|
'3.0.0 角色与汇报(用户要求 7/8/9/10/11/12):部门组员角色已取消,只保留部门负责人与全球顶尖专家(role 只允许 expert);专家完成后必须以 JSON 汇报(证据块里的 report:keyResults/keyInfo/importantInfo/leadRequirements,精简、禁止重复,F10);部门负责人必须全面汇总本部门全部专家汇报后,以 JSON 交回主 Agent(departmentSummary:keyResults/keyInfo/importantInfo/sources,精简、禁止累赘重复,F11);等所有部门的汇总都交回后,由你再全面、深入整理汇总成最终成果交付给用户(用户要求 12)。',
|
|
88
|
-
'3.0.
|
|
96
|
+
'3.0.9 版本(用户要求 13):本插件当前版本为 3.0.9。涉及版本号的对外表述一律写 3.0.9。',
|
|
89
97
|
/*
|
|
90
|
-
* [
|
|
91
|
-
*
|
|
92
|
-
*
|
|
98
|
+
* [3.0.8] 主 Agent 五步开工证据协议(取代 2.5.1 两轮深度思考,用户已批准):
|
|
99
|
+
* 部门三层执行者已有开工/结算双门禁,主 Agent 自己也必须做到同一协议——
|
|
100
|
+
* 提示词告知 + dispatch 硬门禁(validateStartPhaseEvidence)双保险,与部门层同一哲学。
|
|
93
101
|
*/
|
|
94
|
-
'主 Agent
|
|
102
|
+
'主 Agent 五步开工证据协议(3.0.8 强制,与部门负责人/顶尖专家同一口径):你执行自己的任务时,必须完成五步工作法的前三步——第一步全面、全盘、深入梳理、研究、思考自己的任务(目标与验收、现状与事实、约束、未知、主要矛盾、边界);第二步基于刚才第一步完成好的所有结果,再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率执行、确保完美完成自己任务的方法、流程和步骤(含全程如何少走弯路:先查历史教训、先验证再动手、不重复试错),并写清依据;第三步把资源与工具真正备齐并给出就绪证据。首次调用 dsh_workplan_dispatch 必须随附 startPhases={ planning{ problemAnalysis(第一步任务梳理), resources(第二步资源研究), tools(第二步工具研究), approach(第二步方法流程步骤), approachBasis(第二步基于第一步全部结果的依据对应) }, preparation{ prepared(第三步已备清单), evidence(第三步就绪证据) } },未提交或不合格会被平台硬门禁拒绝(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划产生的新计划是新任务,必须重新完成前三步并提交。派发顺序、督战、验收与交付必须严格按第二步理清的方法、流程、步骤执行,不得静默改道。四角色执行前门禁现已全覆盖:主 Agent 经 dispatch 门禁、负责人经 delegate review 门禁、专家经 phase-0 self_effort+startPhases 门禁(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),未登记合格开工证据一律不进入正式执行。',
|
|
95
103
|
/*
|
|
96
104
|
* [2.3.10][T2] 用户要求1(P3)提示词双保险:插件已在规划前/派发前自动发送
|
|
97
105
|
* 【规划预告】/【派发预告】(runtime.ts maybePlan / dispatchTool);这里把
|
|
@@ -156,10 +164,10 @@ const PROMPT_SECTION = [
|
|
|
156
164
|
/*
|
|
157
165
|
* [2.0.0] 自我学习与自我迭代(用户 2026-11-05 强制要求)。
|
|
158
166
|
*
|
|
159
|
-
* 部门 Agent
|
|
167
|
+
* 部门 Agent 在第五步收尾必须复盘并落盘为永久记忆;这条提示词让主 Agent 知道
|
|
160
168
|
* 记忆存在、存在哪里、怎么复核,而不是把「会学习」当成不可见的口号。
|
|
161
169
|
*/
|
|
162
|
-
'
|
|
170
|
+
'每个部门完成工作后,必须在第五步收尾提交复盘(问题 / 弯路 / 解决 / 防再犯规则),插件会自动把它写入永久教训记忆文件(默认 ~/.dsh/workplan/lessons.jsonl,可用 DSH_WORKPLAN_LESSONS_FILE 覆盖);下次派发同类子任务时,相关历史教训会自动出现在子 Agent 提示词里。',
|
|
163
171
|
'需要复核「到底记住了什么、哪些错误在重复发生」时,调用 `dsh_workplan_lessons`(action: list / search / stats)。它是只读工具;记忆里反复出现的教训(occurrences ≥ 2)必须在下一次计划里变成明确约束,不能让同类错误第三次发生。',
|
|
164
172
|
].join('\n');
|
|
165
173
|
/**
|
|
@@ -664,8 +672,9 @@ function createEscalateTool(runtime) {
|
|
|
664
672
|
name: 'dsh_workplan_escalate',
|
|
665
673
|
description: '子 Agent 遇阻时向父会话上报请示,并把该子任务置为「待指示」。'
|
|
666
674
|
+ '第三层专家(叶子)同样可用:请示会经 delegate 登记落到所属部门行的第三层台账,由部门负责人用 dsh_workplan_instruct 答复。'
|
|
675
|
+
+ '3.0.5 硬规则:第三层专家上报后,部门负责人禁止另派给其他专家,必须梳理该问题与本部门全部任务执行状态、研究方案后,用 dsh_workplan_instruct 答复原专家,原专家继续执行。'
|
|
667
676
|
+ '遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/同一命令连续两次失败/需要主 Agent 决定方向)时,'
|
|
668
|
-
+ '第一动作是调用本工具,然后停止推进、只做只读核对,等待主 Agent
|
|
677
|
+
+ '第一动作是调用本工具,然后停止推进、只做只读核对,等待主 Agent/负责人指示。'
|
|
669
678
|
+ '不需要外部决定时不要调用;调用后不要自行选定一个选项继续。',
|
|
670
679
|
parameters: {
|
|
671
680
|
type: 'object',
|
|
@@ -718,7 +727,7 @@ function createEscalateTool(runtime) {
|
|
|
718
727
|
return textContent(`${String(result.subtaskId ?? '')} 已登记为「待指示」`
|
|
719
728
|
+ (result.alreadyEscalated ? '(此前已登记,未重复提交)' : '')
|
|
720
729
|
+ `:${String(result.question ?? '')}`
|
|
721
|
-
+ '|现在停止推进,只做只读核对;等待主 Agent
|
|
730
|
+
+ '|现在停止推进,只做只读核对;等待主 Agent/部门负责人指示后再继续。第三层请示在答复前禁止改派给其他专家。');
|
|
722
731
|
},
|
|
723
732
|
},
|
|
724
733
|
async execute(args, exec) {
|
|
@@ -735,7 +744,7 @@ function createEscalateTool(runtime) {
|
|
|
735
744
|
* 相关领域全球顶尖专家(部门组员角色已取消)。」
|
|
736
745
|
*
|
|
737
746
|
* 落地为两步硬流程(服务端校验,提示词绕不过):
|
|
738
|
-
* - `review
|
|
747
|
+
* - `review`:提交「开工证据 + 分工表」(startPhases 五步第 1/2/3 步 +
|
|
739
748
|
* 每位下级的 member/role/task/reasoningEffort);分工表必须同时含
|
|
740
749
|
* ≥1 名 expert(顶尖专家);部门组员角色已取消(3.0.0)。
|
|
741
750
|
* - `dispatch`:未登记 review 产物 ⇒ 硬门禁拒绝;登记后为每位下级派生
|
|
@@ -743,7 +752,8 @@ function createEscalateTool(runtime) {
|
|
|
743
752
|
* 当前模型家族合法集合(qwen→low/medium/xhigh;非qwen→low/high/max)
|
|
744
753
|
* 钳制并留痕,随 agentOptions 全程生效(要求 5)。
|
|
745
754
|
* - `direct`:[2.5.5][T3] low(含未配置视同 low)任务负责人亲自执行登记:
|
|
746
|
-
* 仅收
|
|
755
|
+
* 仅收 startPhases 开工证据(problemAnalysis/approach ≥40 字、approachBasis/
|
|
756
|
+
* resources/prepared/evidence ≥20 字、tools ≥10)+可选 reasoningEffort='low',
|
|
747
757
|
* 拒 consolidation/分工表与复杂档;登记后平台以 low 档接续本会话亲自执行
|
|
748
758
|
* (文档同步,门禁在 runtime/llm-rules)。
|
|
749
759
|
*
|
|
@@ -753,28 +763,29 @@ function createEscalateTool(runtime) {
|
|
|
753
763
|
function createDelegateTool(runtime) {
|
|
754
764
|
return {
|
|
755
765
|
name: 'dsh_workplan_delegate',
|
|
756
|
-
description: '部门负责人专用的第三层派发(用户要求 1/2/3
|
|
757
|
-
+ '
|
|
758
|
-
+ '
|
|
759
|
-
+ '先 action="review"
|
|
766
|
+
description: '部门负责人专用的第三层派发(用户要求 1/2/3,3.0.8 五步工作法单框架):你拥有本部门内再分配权限。执行自己的任务必须先完成五步前三步:'
|
|
767
|
+
+ '第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);'
|
|
768
|
+
+ '第三步把资源与工具真正备齐并给出就绪证据。'
|
|
769
|
+
+ '先 action="review" 提交第 1/2/3 步开工证据(startPhases)'
|
|
760
770
|
// [2.5.4][T4] D1/D2 人数口径同步(与 llm-rules.ts 负责人任务书同源逐字一致)
|
|
761
|
-
+ '(problemAnalysis
|
|
771
|
+
+ '(planning{ problemAnalysis, resources, tools, approach, approachBasis } + preparation{ prepared, evidence },开工证据字数下限:' + START_EVIDENCE_MIN_CHARS_BRIEF + ' + 分工表:每位下级的 member/role/task/reasoningEffort,至少 1 名 expert 顶尖专家(部门组员角色已按用户要求 9 取消);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断;'
|
|
762
772
|
+ '并可用 consolidation.taskReasoningEffort 为整个任务配置整体推理等级,配置后本任务重试/续跑全程沿用;下级档位以成员 self_effort 自配为权威(分工表档仅建议)),'
|
|
763
773
|
+ '再 action="dispatch" 把任务派给本部门相关领域全球顶尖专家(部门组员角色已取消,只保留 expert;固定一层下级、叶子层,第四层一律被拒)。'
|
|
764
774
|
+ '分配必须更简单:每位专家只承担一个动作、一个主产物、一项可独立验收的工作(简单到像 1+1=2:单句、≤300 字符、不含并列词,且每条必须带至少 1 条 qualityRequirements 质量要求;不满足即拒绝派发)。'
|
|
765
775
|
+ 'review 未提交前 dispatch 被硬门禁拒绝。每位下级的推理等级必须按其任务复杂度配置'
|
|
766
776
|
+ '(轻度=low;qwen 中等=medium、非 qwen 中等=high;qwen 非常复杂=xhigh、非 qwen 非常复杂=max),'
|
|
767
777
|
+ '平台按当前模型家族合法集合自动钳制越界档并留痕,等级在其任务全生命周期生效。'
|
|
768
|
-
+ 'action="status"
|
|
769
|
-
+ '
|
|
770
|
-
+ '
|
|
778
|
+
+ 'action="status" 查看登记与下级进度。第三层专家叶子用 action="self_effort" 自配推理等级并提交五步第 1/2/3 步开工证据'
|
|
779
|
+
+ '(先配置+先研究准备后开工:phase-0 以 low 启动,唯一职责=评估自身任务复杂度并提交 reasoningEffort+complexityRationale+startPhases{planning,preparation}+开工前预估 timeNotice{declaredMinutes:正整数分钟,reason?};'
|
|
780
|
+
+ '缺交/不合格开工证据硬拒 START_EVIDENCE_MISSING/START_EVIDENCE_INCOMPLETE、不接续;齐全登记后平台立即以自配档接续同一任务进入 phase-1,正式执行必须按第二步方法流程步骤进行、全程少走弯路;成员自配为权威、分工表档仅建议)。'
|
|
781
|
+
+ '3.0.5 硬规则:任一第三层成员处于待指示(escalated)时,review/dispatch/direct 一律拒绝改派、重派或降级;负责人必须梳理该成员问题与本部门全部任务状态,研究方案后用 dsh_workplan_instruct 答复原成员,原成员继续执行。',
|
|
771
782
|
parameters: {
|
|
772
783
|
type: 'object',
|
|
773
784
|
properties: {
|
|
774
785
|
action: {
|
|
775
786
|
type: 'string',
|
|
776
787
|
enum: ['review', 'dispatch', 'direct', 'status', 'self_effort'],
|
|
777
|
-
description: 'review
|
|
788
|
+
description: 'review=提交开工证据与分工表(负责人):startPhases 五步第 1/2/3 步证据 + 每位下级的 member/role/task/reasoningEffort;dispatch=正式派发给专家(负责人);direct=low 任务负责人亲自执行登记(仅收 startPhases 开工证据,' + START_EVIDENCE_MIN_CHARS_BRIEF + '+可选 reasoningEffort=\'low\';拒 consolidation/分工表与复杂档,防旁路);status=查看登记与进度;self_effort=第三层专家叶子自配推理等级+提交开工证据 startPhases+开工前预估 timeNotice(先配置+先研究准备后开工,缺一硬拒不接续)。',
|
|
778
789
|
},
|
|
779
790
|
reasoningEffort: {
|
|
780
791
|
type: 'string',
|
|
@@ -785,15 +796,33 @@ function createDelegateTool(runtime) {
|
|
|
785
796
|
type: 'string',
|
|
786
797
|
description: 'action="self_effort" 必带(schema 层不强制,缺交将被运行时拒绝 SELF_EFFORT_RATIONALE_MISSING):复杂度依据(为什么你的单项任务是该档:事实/依赖/验证难度)。',
|
|
787
798
|
},
|
|
788
|
-
|
|
799
|
+
startPhases: {
|
|
789
800
|
type: 'object',
|
|
790
|
-
description: 'action="self_effort"
|
|
801
|
+
description: 'action="self_effort" / "review" / "direct" 必填(3.0.8 开工证据硬门禁):五步工作法前三步证据——第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、具体实施方案(方法、流程、步骤,含依据);第三步把资源与工具真正备齐并给出就绪证据。缺交/不合格硬拒(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE),不登记、不接续正式执行;登记后持久化,重派/续跑读档放行。',
|
|
791
802
|
properties: {
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
803
|
+
planning: {
|
|
804
|
+
type: 'object',
|
|
805
|
+
properties: {
|
|
806
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界),至少 1 条、合计 ≥40 字。' },
|
|
807
|
+
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
|
|
808
|
+
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
|
|
809
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清如何一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤,至少 1 条、合计 ≥40 字。' },
|
|
810
|
+
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据:如何基于第一步完成好的所有结果(逐条对应),至少 1 条、合计 ≥20 字。' },
|
|
811
|
+
},
|
|
812
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
813
|
+
additionalProperties: false,
|
|
814
|
+
},
|
|
815
|
+
preparation: {
|
|
816
|
+
type: 'object',
|
|
817
|
+
properties: {
|
|
818
|
+
prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
|
|
819
|
+
evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
|
|
820
|
+
},
|
|
821
|
+
required: ['prepared', 'evidence'],
|
|
822
|
+
additionalProperties: false,
|
|
823
|
+
},
|
|
795
824
|
},
|
|
796
|
-
required: ['
|
|
825
|
+
required: ['planning', 'preparation'],
|
|
797
826
|
additionalProperties: false,
|
|
798
827
|
},
|
|
799
828
|
timeNotice: {
|
|
@@ -808,17 +837,8 @@ function createDelegateTool(runtime) {
|
|
|
808
837
|
},
|
|
809
838
|
consolidation: {
|
|
810
839
|
type: 'object',
|
|
811
|
-
description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE
|
|
840
|
+
description: 'action="review" 必带(schema 层不强制,缺交将被运行时拒绝 DELEGATE_CONSOLIDATION_MISSING / DELEGATE_CONSOLIDATION_INCOMPLETE):第三层分工表(3.0.8 起不再内嵌开工证据——开工证据一律经 startPhases 提交登记)。负责人自己的第 1/2/3 步开工证据未登记前 dispatch 被硬门禁拒绝。action="direct" 禁止携带(direct 不接受分工表)。',
|
|
812
841
|
properties: {
|
|
813
|
-
problemAnalysis: {
|
|
814
|
-
type: 'array',
|
|
815
|
-
items: { type: 'string' },
|
|
816
|
-
description: '第一轮 · 任务深研:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条。',
|
|
817
|
-
},
|
|
818
|
-
constraints: { type: 'array', items: { type: 'string' }, description: '约束条件。' },
|
|
819
|
-
unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项。' },
|
|
820
|
-
approach: { type: 'array', items: { type: 'string' }, description: '第二轮 · 方法流程步骤:基于第一轮全部结果,再全面、全盘、深入梳理、研究、思考后理清的具体一步步执行、完美完成任务的方法、流程和步骤(每步做什么、产出什么、如何证明),至少 1 条。' },
|
|
821
|
-
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二轮依据(必填,至少 1 条):第二轮如何基于第一轮完成好的所有结果——逐条写清第一轮的哪些事实/约束/矛盾决定了第二轮的哪些方法/流程/步骤。' },
|
|
822
842
|
taskReasoningEffort: {
|
|
823
843
|
type: 'string',
|
|
824
844
|
enum: ['low', 'medium', 'high', 'xhigh', 'max'],
|
|
@@ -827,7 +847,7 @@ function createDelegateTool(runtime) {
|
|
|
827
847
|
assignments: {
|
|
828
848
|
type: 'array',
|
|
829
849
|
// [3.0.0] 用户 2026-11-14 第 5/6/9 条:组员角色取消、任务极简、质量要求必填。
|
|
830
|
-
description: '分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low
|
|
850
|
+
description: '分工表:至少 1 名 expert(本部门相关领域全球顶尖专家;部门组员角色已按用户要求 9 取消,role 只允许 expert);low/未配置任务禁止下派——负责人亲自执行,开工证据经 dsh_workplan_delegate(action="direct") 登记(' + START_EVIDENCE_MIN_CHARS_BRIEF + ';可选 reasoningEffort="low");复杂任务(medium/high/xhigh/max)合计不少于 8 人且最多 12 人,少于 8 人硬性阻断。每一条任务必须简单到像 1+1=2:一个动作、一个主产物、一项可独立验收(≤300 字符、单句、不含并列词),且必须带 qualityRequirements(至少 1 条可检查的质量要求);不满足即拒绝派发。',
|
|
831
851
|
items: {
|
|
832
852
|
type: 'object',
|
|
833
853
|
properties: {
|
|
@@ -850,7 +870,7 @@ function createDelegateTool(runtime) {
|
|
|
850
870
|
},
|
|
851
871
|
},
|
|
852
872
|
},
|
|
853
|
-
required: ['
|
|
873
|
+
required: ['assignments'],
|
|
854
874
|
additionalProperties: false,
|
|
855
875
|
},
|
|
856
876
|
},
|
|
@@ -908,12 +928,13 @@ function createDelegateTool(runtime) {
|
|
|
908
928
|
};
|
|
909
929
|
}
|
|
910
930
|
/**
|
|
911
|
-
* [1.13.0]
|
|
931
|
+
* [1.13.0→3.0.8] 第四步(验证阶段)的插件核验工具(用户 2026-11-05;五步口径)。
|
|
912
932
|
*
|
|
913
|
-
*
|
|
914
|
-
*
|
|
915
|
-
*
|
|
916
|
-
*
|
|
933
|
+
* 五步工作法要求部门 Agent 先梳理问题(第一步)、再研究资源/工具/方案(第二步)、
|
|
934
|
+
* 再备齐就绪(第三步)、执行并逐项验证(第四步)、最后收尾与复盘(第五步)。
|
|
935
|
+
* 这个工具只做一件事:接收五步证据并给出核验结论。缺少 planning/preparation
|
|
936
|
+
* /execution 证据时会被 `runtime.verifySubtask` 以 `PHASE_GATE` 拒绝并列出待补项,
|
|
937
|
+
* 避免跳过前三步直接宣称验证通过。
|
|
917
938
|
*
|
|
918
939
|
* 注意(2.0.2 更正):2026-11-05 的「第一、二阶段禁用 dsh-workplan 插件」是
|
|
919
940
|
* 该次优化会话的过程约束,不是对所有后续会话的产品规则;插件不全局禁用。
|
|
@@ -921,10 +942,10 @@ function createDelegateTool(runtime) {
|
|
|
921
942
|
export function createVerifyTool(runtime) {
|
|
922
943
|
return {
|
|
923
944
|
name: 'dsh_workplan_verify',
|
|
924
|
-
description: '部门子 Agent
|
|
925
|
-
+ '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / execution 证据时返回 PHASE_GATE 与待补项;'
|
|
926
|
-
+ '
|
|
927
|
-
+ '核验通过不代表完成:最终仍要在结果块里写同一份 phases
|
|
945
|
+
description: '部门子 Agent 在第四步(验证阶段)使用的插件核验:提交 planning / preparation / execution / verification 五步证据,'
|
|
946
|
+
+ '插件逐项核验并返回 passed 或仍需补齐的 gaps。缺少 planning / preparation / execution 证据时返回 PHASE_GATE 与待补项;'
|
|
947
|
+
+ '只有「前三步开工证据(第一步任务梳理 + 第二步资源/工具/方案研究 + 第三步准备就绪)+ 实际执行步骤」齐全后,才会进入第四步核验。'
|
|
948
|
+
+ '核验通过不代表完成:最终仍要在结果块里写同一份 phases,由主计划按五步契约判定。',
|
|
928
949
|
parameters: {
|
|
929
950
|
type: 'object',
|
|
930
951
|
properties: {
|
|
@@ -938,12 +959,12 @@ export function createVerifyTool(runtime) {
|
|
|
938
959
|
properties: {
|
|
939
960
|
planning: {
|
|
940
961
|
type: 'object',
|
|
941
|
-
description: '
|
|
962
|
+
description: '第一步 + 第二步:全面、全盘、深入梳理、研究、思考自己的任务(问题梳理),再基于第一步全部结果研究资源、工具与实施方案(方法、流程、步骤,含依据)。',
|
|
942
963
|
properties: {
|
|
943
|
-
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '
|
|
964
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界)' },
|
|
944
965
|
constraints: { type: 'array', items: { type: 'string' }, description: '约束条件' },
|
|
945
966
|
unknowns: { type: 'array', items: { type: 'string' }, description: '未知或待确认项' },
|
|
946
|
-
approach: { type: 'array', items: { type: 'string' }, description: '
|
|
967
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:基于第一步全部结果理清的具体一步步执行、完美完成任务的方法、流程和步骤(每一步做什么、产出什么、如何证明)' },
|
|
947
968
|
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步的资源、工具、方案如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤' },
|
|
948
969
|
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:完成本任务需要哪些资源(数据/文件/权限/人/知识/时间),逐项写清用途与获取方式' },
|
|
949
970
|
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么、为什么选它' },
|
|
@@ -986,7 +1007,7 @@ export function createVerifyTool(runtime) {
|
|
|
986
1007
|
requirementCheck: { type: 'string', description: '逐条核对用户原要求的结果' },
|
|
987
1008
|
retrospective: {
|
|
988
1009
|
type: 'object',
|
|
989
|
-
description: '
|
|
1010
|
+
description: '第四步收尾的自我学习复盘:本次遇到的问题、走过的弯路、如何解决、以后如何预防再犯',
|
|
990
1011
|
properties: {
|
|
991
1012
|
problems: { type: 'array', items: { type: 'string' }, description: '本次全过程遇到的问题(现象 + 根因),至少 1 条' },
|
|
992
1013
|
detours: { type: 'array', items: { type: 'string' }, description: '走过的弯路/返工/无效尝试;确实没有就写空数组' },
|
|
@@ -1031,7 +1052,7 @@ export function createVerifyTool(runtime) {
|
|
|
1031
1052
|
+ (gaps ? `|需补齐:${gaps}` : '')
|
|
1032
1053
|
+ '|先修复再回报,不要用 done 收尾。');
|
|
1033
1054
|
}
|
|
1034
|
-
return textContent(`${String(result.subtaskId ?? '')}
|
|
1055
|
+
return textContent(`${String(result.subtaskId ?? '')} 第四步核验通过:${String(result.summary ?? '')}`
|
|
1035
1056
|
+ '|把同一份 phases 写进结果块后提交。');
|
|
1036
1057
|
},
|
|
1037
1058
|
},
|
|
@@ -1044,7 +1065,7 @@ export function createVerifyTool(runtime) {
|
|
|
1044
1065
|
/**
|
|
1045
1066
|
* [2.0.0] 永久教训记忆的只读入口(用户 2026-11-05 自我学习要求)。
|
|
1046
1067
|
*
|
|
1047
|
-
*
|
|
1068
|
+
* 不提供写动作:记忆只能由「第四步复盘通过 → 完成判定」这条链写入,
|
|
1048
1069
|
* 防止主 Agent 事后手写一条“教训”绕过真实复盘证据。
|
|
1049
1070
|
*/
|
|
1050
1071
|
function createLessonsTool(runtime) {
|
|
@@ -1052,7 +1073,7 @@ function createLessonsTool(runtime) {
|
|
|
1052
1073
|
name: 'dsh_workplan_lessons',
|
|
1053
1074
|
description: '查看 dsh-workplan 的永久教训记忆(部门完成工作后自动落盘的复盘):'
|
|
1054
1075
|
+ 'action=list 按部门取最相关教训,action=search 按关键词检索,action=stats 看总数/重复数与文件位置。'
|
|
1055
|
-
+ '
|
|
1076
|
+
+ '只读,不修改计划状态;第四步验证时用它核对记住了什么、哪些同类错误在重复出现。',
|
|
1056
1077
|
parameters: {
|
|
1057
1078
|
type: 'object',
|
|
1058
1079
|
properties: {
|
|
@@ -1115,6 +1136,7 @@ function createInstructTool(runtime) {
|
|
|
1115
1136
|
name: 'dsh_workplan_instruct',
|
|
1116
1137
|
description: '向一条「待指示」子任务下发决定:投递给对应子会话,并把该行恢复为执行中(closure=instructed)。'
|
|
1117
1138
|
+ '根会话可答复第一层部门行;部门负责人可答复自己派出的第三层专家(subtaskId 填自己的部门行 ID 或省略,用 member 或 sessionId 指定目标,二者至少其一)。'
|
|
1139
|
+
+ '3.0.5 硬规则:第三层只能答复已经提交请示的原专家,投递成功后必须原专家继续执行;待指示期间负责人不得 review/dispatch/direct 改派。'
|
|
1118
1140
|
+ '只有目标子会话的直接父会话可调用,非直系一律拒绝;根路径只接受 closure=escalated 的行。'
|
|
1119
1141
|
+ '投递失败时状态不变(仍是待指示),按返回的 hint 重试或改用 dsh_workplan_update 明确放弃。',
|
|
1120
1142
|
parameters: {
|
|
@@ -1252,8 +1274,8 @@ function createReleaseTool(runtime) {
|
|
|
1252
1274
|
return {
|
|
1253
1275
|
name: 'dsh_workplan_release',
|
|
1254
1276
|
description: '解除当前会话计划的「认可闸门」并立即派发:先登记用户认可的留痕(gateHistory,durable 回放不丢),'
|
|
1255
|
-
+ '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/
|
|
1256
|
-
+ '仅当计划处于认可闸门之下时可用;若派发因
|
|
1277
|
+
+ '再调用派发链(与 dsh_workplan_dispatch 同一套闸门:终态/startPhases 等照常生效)。'
|
|
1278
|
+
+ '仅当计划处于认可闸门之下时可用;若派发因 startPhases 等门禁被拒,闸门保持已解除,'
|
|
1257
1279
|
+ '补齐后直接重发 dispatch 即可,认可事实无需重来。仅根会话可用。',
|
|
1258
1280
|
parameters: {
|
|
1259
1281
|
type: 'object',
|
|
@@ -1266,15 +1288,31 @@ function createReleaseTool(runtime) {
|
|
|
1266
1288
|
type: 'string',
|
|
1267
1289
|
description: '用户认可的留痕备注(例如认可的原文摘要),写入 gateHistory。',
|
|
1268
1290
|
},
|
|
1269
|
-
|
|
1291
|
+
startPhases: {
|
|
1270
1292
|
type: 'object',
|
|
1271
|
-
description: '可选:随解除一并提交的主 Agent
|
|
1293
|
+
description: '可选:随解除一并提交的主 Agent 五步第 1/2/3 步开工证据(与 dsh_workplan_dispatch.startPhases 同形状);提供则解除后立即开跑,缺省则派发按 START_EVIDENCE_MISSING 门禁返回补交指引。',
|
|
1272
1294
|
properties: {
|
|
1273
|
-
|
|
1274
|
-
|
|
1275
|
-
|
|
1295
|
+
planning: {
|
|
1296
|
+
type: 'object',
|
|
1297
|
+
properties: {
|
|
1298
|
+
problemAnalysis: { type: 'array', items: { type: 'string' } },
|
|
1299
|
+
resources: { type: 'array', items: { type: 'string' } },
|
|
1300
|
+
tools: { type: 'array', items: { type: 'string' } },
|
|
1301
|
+
approach: { type: 'array', items: { type: 'string' } },
|
|
1302
|
+
approachBasis: { type: 'array', items: { type: 'string' } },
|
|
1303
|
+
},
|
|
1304
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
1305
|
+
},
|
|
1306
|
+
preparation: {
|
|
1307
|
+
type: 'object',
|
|
1308
|
+
properties: {
|
|
1309
|
+
prepared: { type: 'array', items: { type: 'string' } },
|
|
1310
|
+
evidence: { type: 'array', items: { type: 'string' } },
|
|
1311
|
+
},
|
|
1312
|
+
required: ['prepared', 'evidence'],
|
|
1313
|
+
},
|
|
1276
1314
|
},
|
|
1277
|
-
required: ['
|
|
1315
|
+
required: ['planning', 'preparation'],
|
|
1278
1316
|
},
|
|
1279
1317
|
mode: {
|
|
1280
1318
|
type: 'string',
|
|
@@ -1288,7 +1326,7 @@ function createReleaseTool(runtime) {
|
|
|
1288
1326
|
* 为 tools.register() 强制项。schema 覆盖 runtime.releaseTool 的全部返回形
|
|
1289
1327
|
* (ok/gateReleased/planId/note/hold/dispatch/code/error;dispatch 为 dispatchTool
|
|
1290
1328
|
* 的完整结果对象,保持开放对象不裁剪)。render 语义修正:判定「未能解除」
|
|
1291
|
-
* 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但
|
|
1329
|
+
* 以 gateReleased 为准——原实现只看 ok===false,会把「闸门已解除但 startPhases
|
|
1292
1330
|
* 门禁拒派发」误报成未解除(该分支 ok 恰为 false 但闸门已松)。
|
|
1293
1331
|
*/
|
|
1294
1332
|
output: {
|
|
@@ -1508,10 +1546,10 @@ function createDispatchTool(runtime) {
|
|
|
1508
1546
|
name: 'dsh_workplan_dispatch',
|
|
1509
1547
|
description: '派发当前会话尚未执行的任务分解计划。计划显示后必须先调用本工具;wait 会等到本轮结束,'
|
|
1510
1548
|
+ '把 durable 结果写入会话并返回每个子任务的状态/摘要。'
|
|
1511
|
-
+ '【
|
|
1512
|
-
+ '
|
|
1513
|
-
+ '
|
|
1514
|
-
+ '(
|
|
1549
|
+
+ '【3.0.8 主 Agent 五步开工证据协议】执行自己的任务必须先完成前三步:全面、全盘、深入梳理、研究、思考自己的任务(第一步任务梳理),'
|
|
1550
|
+
+ '基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步以最高效率、少走弯路、完美完成任务的方法、流程和步骤(第二步资源/工具/方案研究,含依据),'
|
|
1551
|
+
+ '再把资源与工具真正备齐并给出就绪证据(第三步准备就绪);最后才基于第二步的方法、流程、步骤开始执行:首次派发必须随附 startPhases 开工证据,未提交或不合格被硬门禁拒绝'
|
|
1552
|
+
+ '(START_EVIDENCE_MISSING / START_EVIDENCE_INCOMPLETE);登记后持久化,续跑/重试/重启回放自动读档,无需重复提交;重规划的新计划须重新提交。'
|
|
1515
1553
|
+ '返回值里的 complete=false 表示计划还没做完(可能只是本轮预算用尽),此时必须再次派发续跑,'
|
|
1516
1554
|
+ '不得把当前产物当作最终结果。重复调用是幂等的。',
|
|
1517
1555
|
parameters: {
|
|
@@ -1527,15 +1565,33 @@ function createDispatchTool(runtime) {
|
|
|
1527
1565
|
description: '默认 wait:等本轮结束后返回完整结果。async:立即返回 running,'
|
|
1528
1566
|
+ '本轮结束时自动写入结果消息;期间用 dsh_workplan_status 查看进度。',
|
|
1529
1567
|
},
|
|
1530
|
-
|
|
1568
|
+
startPhases: {
|
|
1531
1569
|
type: 'object',
|
|
1532
|
-
description: '主 Agent
|
|
1570
|
+
description: '主 Agent 五步第 1/2/3 步开工证据(本计划首次派发必填;已登记后续跑/重启自动读档):第一步全面、全盘、深入梳理、研究、思考自己的任务;第二步基于第一步完成好的所有结果再全面、全盘、深入地开展梳理、研究和思考,研究需要哪些资源、哪些工具、理清具体一步步执行、完美完成任务的方法、流程和步骤,并写清第二步基于第一步全部结果的依据;第三步把资源与工具真正备齐并给出就绪证据。派发顺序、督战、验收与交付必须按第二步理清的方法、流程、步骤执行。',
|
|
1533
1571
|
properties: {
|
|
1534
|
-
|
|
1535
|
-
|
|
1536
|
-
|
|
1572
|
+
planning: {
|
|
1573
|
+
type: 'object',
|
|
1574
|
+
properties: {
|
|
1575
|
+
problemAnalysis: { type: 'array', items: { type: 'string' }, description: '第一步 · 任务梳理:全面、全盘、深入梳理、研究、思考自己的任务(目标与验收/现状/事实/约束/未知/主要矛盾/边界逐条写清),至少 1 条、合计 ≥40 字。' },
|
|
1576
|
+
resources: { type: 'array', items: { type: 'string' }, description: '第二步 · 资源研究:基于第一步全部结果,研究需要哪些资源(数据/文件/权限/人/知识/时间),至少 1 项、合计 ≥20 字。' },
|
|
1577
|
+
tools: { type: 'array', items: { type: 'string' }, description: '第二步 · 工具研究:需要哪些工具、每个工具用来做什么,至少 1 项、合计 ≥10 字。' },
|
|
1578
|
+
approach: { type: 'array', items: { type: 'string' }, description: '第二步 · 方法流程步骤:理清的具体一步步执行、完美完成任务的方法、流程和步骤(派发顺序/督战/验收/交付如何做、如何证明),至少 1 条、合计 ≥40 字。' },
|
|
1579
|
+
approachBasis: { type: 'array', items: { type: 'string' }, description: '第二步依据(必填):第二步如何基于第一步完成好的所有结果——第一步的哪些事实/约束/矛盾决定了第二步的哪些资源/工具/步骤,至少 1 条、合计 ≥20 字。' },
|
|
1580
|
+
},
|
|
1581
|
+
required: ['problemAnalysis', 'approach', 'approachBasis', 'resources', 'tools'],
|
|
1582
|
+
additionalProperties: false,
|
|
1583
|
+
},
|
|
1584
|
+
preparation: {
|
|
1585
|
+
type: 'object',
|
|
1586
|
+
properties: {
|
|
1587
|
+
prepared: { type: 'array', items: { type: 'string' }, description: '第三步 · 已备齐的资源与工具清单(每项写清:准备了什么、在哪里、是否可用),至少 1 项、合计 ≥20 字。' },
|
|
1588
|
+
evidence: { type: 'array', items: { type: 'string' }, description: '第三步 · 就绪证据:命令输出/文件路径/配置项/版本号/引用,至少 1 条、合计 ≥20 字。' },
|
|
1589
|
+
},
|
|
1590
|
+
required: ['prepared', 'evidence'],
|
|
1591
|
+
additionalProperties: false,
|
|
1592
|
+
},
|
|
1537
1593
|
},
|
|
1538
|
-
required: ['
|
|
1594
|
+
required: ['planning', 'preparation'],
|
|
1539
1595
|
additionalProperties: false,
|
|
1540
1596
|
},
|
|
1541
1597
|
},
|
|
@@ -1743,7 +1799,47 @@ export function apply(ctx, config = {}) {
|
|
|
1743
1799
|
* 运行上下文(提供 `headlessStartup` 服务)才硬失败,交互式会话不受影响。
|
|
1744
1800
|
*/
|
|
1745
1801
|
failClosedOnIncomplete: failClosedOnIncompleteFrom(config.failClosedOnIncomplete, settingEnv('DSH_WORKPLAN_FAIL_CLOSED_ON_INCOMPLETE')),
|
|
1802
|
+
turnStoppingMaxWaitMs: numericSetting(config.turnStoppingMaxWaitMs, 'DSH_WORKPLAN_TURN_STOPPING_MAX_WAIT_MS', true),
|
|
1746
1803
|
});
|
|
1804
|
+
/*
|
|
1805
|
+
* [3.0.6][第 2 批] 可选留痕清理:默认关闭(0 = 永久保留证据)。
|
|
1806
|
+
* 只有显式配置正数时才启用;启动先跑一次,之后每 24 小时一次。
|
|
1807
|
+
*/
|
|
1808
|
+
const journalRetentionDays = (() => {
|
|
1809
|
+
const configured = numericSetting(config.journalRetentionDays, 'DSH_WORKPLAN_JOURNAL_RETENTION_DAYS', true);
|
|
1810
|
+
return configured !== undefined && configured > 0 ? Math.min(configured, 3650) : 0;
|
|
1811
|
+
})();
|
|
1812
|
+
if (journalRetentionDays > 0) {
|
|
1813
|
+
const prune = () => {
|
|
1814
|
+
const result = pruneJournal({ retentionDays: journalRetentionDays, excludePlanIds: activePlanIdSet(runtime) });
|
|
1815
|
+
if (!result.ok)
|
|
1816
|
+
ctx.logger?.warn?.(`[dsh-workplan] journal 清理失败:${result.error}`);
|
|
1817
|
+
// 删除失败逐条 warn(ok 仍为 true,errors[] 是弱错误通道,不得静默)。
|
|
1818
|
+
if (Array.isArray(result.errors) && result.errors.length > 0) {
|
|
1819
|
+
for (const line of result.errors)
|
|
1820
|
+
console.warn(`[dsh-workplan] journal 清理异常:${String(line)}`);
|
|
1821
|
+
}
|
|
1822
|
+
return result;
|
|
1823
|
+
};
|
|
1824
|
+
ctx.effect(() => {
|
|
1825
|
+
/*
|
|
1826
|
+
* [复审修复] 首次清理从激活同步路径挪到 10s 后:激活是同步路径,不能
|
|
1827
|
+
* 当场扫盘(readdir/stat 大目录会拖住插件注册)。卸载时清除——
|
|
1828
|
+
* journalRetentionTimer 同款的 ctx.effect 清理模式。
|
|
1829
|
+
*/
|
|
1830
|
+
const firstPruneTimer = setTimeout(prune, 10_000);
|
|
1831
|
+
if (typeof firstPruneTimer?.unref === 'function')
|
|
1832
|
+
firstPruneTimer.unref();
|
|
1833
|
+
return () => clearTimeout(firstPruneTimer);
|
|
1834
|
+
});
|
|
1835
|
+
ctx.effect(() => {
|
|
1836
|
+
// 卫生类:不触发只少一次清理,不得拖住正在关闭的宿主。
|
|
1837
|
+
const journalRetentionTimer = setInterval(prune, 24 * 60 * 60 * 1000);
|
|
1838
|
+
if (typeof journalRetentionTimer?.unref === 'function')
|
|
1839
|
+
journalRetentionTimer.unref();
|
|
1840
|
+
return () => clearInterval(journalRetentionTimer);
|
|
1841
|
+
});
|
|
1842
|
+
}
|
|
1747
1843
|
ctx.effect(() => ctx.systemPrompt.section({
|
|
1748
1844
|
name: 'dsh-workplan',
|
|
1749
1845
|
order: PROMPT_ORDER,
|
|
@@ -1768,9 +1864,9 @@ export function apply(ctx, config = {}) {
|
|
|
1768
1864
|
* 计划内某行的部门负责人子会话」硬校验;根会话与第三层叶子会话都会被拒。
|
|
1769
1865
|
*/
|
|
1770
1866
|
ctx.effect(() => ctx.tools.register(createDelegateTool(runtime)));
|
|
1771
|
-
/* [1.13.0]
|
|
1867
|
+
/* [1.13.0→3.0.8] 第四步核验:子会话唯一可用的插件工作能力,前三步会被 PHASE_GATE 拒绝。 */
|
|
1772
1868
|
ctx.effect(() => ctx.tools.register(createVerifyTool(runtime)));
|
|
1773
|
-
/* [2.0.0]
|
|
1869
|
+
/* [2.0.0] 永久教训记忆的只读复核入口(第四步验证用)。 */
|
|
1774
1870
|
ctx.effect(() => ctx.tools.register(createLessonsTool(runtime)));
|
|
1775
1871
|
ctx.effect(() => ctx.tools.register(createInstructTool(runtime)));
|
|
1776
1872
|
/*
|
|
@@ -1847,7 +1943,10 @@ export function apply(ctx, config = {}) {
|
|
|
1847
1943
|
return;
|
|
1848
1944
|
}
|
|
1849
1945
|
try {
|
|
1850
|
-
|
|
1946
|
+
if (!chartVendorBytes) {
|
|
1947
|
+
chartVendorBytes = readFileSync(new URL('../vendor/chart.umd.js', import.meta.url));
|
|
1948
|
+
}
|
|
1949
|
+
const body = chartVendorBytes;
|
|
1851
1950
|
res.statusCode = 200;
|
|
1852
1951
|
res.setHeader('content-type', 'text/javascript; charset=utf-8');
|
|
1853
1952
|
res.setHeader('cache-control', 'public, max-age=3600');
|
|
@@ -1862,10 +1961,16 @@ export function apply(ctx, config = {}) {
|
|
|
1862
1961
|
}));
|
|
1863
1962
|
});
|
|
1864
1963
|
ctx.effect(() => () => runtime.dispose());
|
|
1964
|
+
/*
|
|
1965
|
+
* [3.0.6][复审修复] 把 runtime 句柄交还给调用方:宿主契约不消费本返回值
|
|
1966
|
+
* (清理一律经上方 effect),测试与宿主编排需要观察 state.records /
|
|
1967
|
+
* 替换 startAutoDispatch 时可直接拿到同一实例,不必从工具闭包里挖。
|
|
1968
|
+
*/
|
|
1969
|
+
return runtime;
|
|
1865
1970
|
}
|
|
1866
1971
|
export const meta = {
|
|
1867
1972
|
name,
|
|
1868
|
-
version: '3.0.
|
|
1973
|
+
version: '3.0.9',
|
|
1869
1974
|
promptOrder: PROMPT_ORDER,
|
|
1870
1975
|
routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
|
|
1871
1976
|
};
|
|
@@ -1878,7 +1983,14 @@ export { PROMPT_SECTION, createCancelTool, createDelegateTool, createDispatchToo
|
|
|
1878
1983
|
* 取第一个非空原因,互不覆盖。
|
|
1879
1984
|
*/
|
|
1880
1985
|
export function fileWriteGuardReason(exec, runtime) {
|
|
1881
|
-
|
|
1986
|
+
/*
|
|
1987
|
+
* [复审修复] bash 写保护绕过:shell 类工具的 command 字符串(重定向/heredoc/
|
|
1988
|
+
* tee/sed -i/cp/mv)此前因参数形状不认(无 file_path/path)而整类绕过闸门。
|
|
1989
|
+
* 先解析出 shell 写目标(非 shell 调用为 null),形状闸门与 shell 闸门至少
|
|
1990
|
+
* 命中其一才继续。
|
|
1991
|
+
*/
|
|
1992
|
+
const shellTargets = shellWriteTargets(exec);
|
|
1993
|
+
if (!isWriteShapedCall(exec) && shellTargets === null)
|
|
1882
1994
|
return undefined;
|
|
1883
1995
|
// The three historical write tools pass their arguments through untouched, so
|
|
1884
1996
|
// their behaviour stays exactly as before (argument-shape matching is only an
|
|
@@ -1894,8 +2006,48 @@ export function fileWriteGuardReason(exec, runtime) {
|
|
|
1894
2006
|
if (typeof extra === 'string')
|
|
1895
2007
|
return extra;
|
|
1896
2008
|
}
|
|
2009
|
+
/*
|
|
2010
|
+
* [复审修复] shell 写目标:与上面同一判定出口——只拦「写入已交付文件」,
|
|
2011
|
+
* 纯读命令(cat/grep/less 该路径)解析不出写目标,天然放行。
|
|
2012
|
+
* 启发式局限(保守模式):只认 > / >> 重定向、tee、sed -i、mv/cp/install/dd
|
|
2013
|
+
* 的目标;命令拼接变量(cmd=path; $cmd)、eval、find -delete 等动态写法
|
|
2014
|
+
* 不在解析范围内——见 shellWriteTargets 注释。
|
|
2015
|
+
*/
|
|
2016
|
+
if (shellTargets) {
|
|
2017
|
+
for (const target of shellTargets) {
|
|
2018
|
+
const extra = runtime.presentedWriteDenialReason(exec?.agent, { file_path: target });
|
|
2019
|
+
if (typeof extra === 'string')
|
|
2020
|
+
return extra;
|
|
2021
|
+
}
|
|
2022
|
+
}
|
|
1897
2023
|
return undefined;
|
|
1898
2024
|
}
|
|
2025
|
+
/*
|
|
2026
|
+
* [复审修复] 活跃 planId 集合:pruneJournal 只看 mtime,「活跃但安静」的计划
|
|
2027
|
+
* (久无新留痕、mtime 变旧)会被误删;把当前活跃 planId 传给 excludePlanIds
|
|
2028
|
+
* 即可保住。planning 在途时尚未铸出 planId(planId 在规划完成后才生成,占位
|
|
2029
|
+
* 记录 planId=null),因此 runtime.state.records 就是全部活跃 planId 的事实源。
|
|
2030
|
+
* 导出以便直接单测;读取失败返回空集——宁可少排除,也不让清理路径抛错。
|
|
2031
|
+
*/
|
|
2032
|
+
export function activePlanIdSet(runtime) {
|
|
2033
|
+
const ids = new Set();
|
|
2034
|
+
try {
|
|
2035
|
+
const records = runtime?.state?.records;
|
|
2036
|
+
if (records instanceof Map) {
|
|
2037
|
+
for (const record of records.values()) {
|
|
2038
|
+
const direct = typeof record?.planId === 'string' ? record.planId.trim() : '';
|
|
2039
|
+
const nested = typeof record?.plan?.planId === 'string' ? record.plan.planId.trim() : '';
|
|
2040
|
+
const id = direct !== '' ? direct : (nested !== '' ? nested : null);
|
|
2041
|
+
if (id)
|
|
2042
|
+
ids.add(id);
|
|
2043
|
+
}
|
|
2044
|
+
}
|
|
2045
|
+
}
|
|
2046
|
+
catch {
|
|
2047
|
+
// 同上:名单读取失败不阻断清理。
|
|
2048
|
+
}
|
|
2049
|
+
return ids;
|
|
2050
|
+
}
|
|
1899
2051
|
/**
|
|
1900
2052
|
* [1.12.2] G2: recognise write calls by their argument shape, not by a tool-name
|
|
1901
2053
|
* allow-list. The 1.8.18 version named write/edit/str_replace_editor only, so a
|
|
@@ -1925,3 +2077,88 @@ function isWriteShapedCall(exec) {
|
|
|
1925
2077
|
// Every other write form names a single target: file_path or path.
|
|
1926
2078
|
return typeof args.file_path === 'string' || typeof args.path === 'string';
|
|
1927
2079
|
}
|
|
2080
|
+
/*
|
|
2081
|
+
* [复审修复] shell 类工具的识别:exec.name 为 bash/shell/exec,或以它们为
|
|
2082
|
+
* 前缀且前缀后是 [-_] 分隔符或结尾(bash_exec、shell-tool 等宿主工具名变体)。
|
|
2083
|
+
* 要求分隔符是为了避免 'executor' 这类普通名字被误判进 shell 闸门。
|
|
2084
|
+
*/
|
|
2085
|
+
function isShellLikeToolName(name) {
|
|
2086
|
+
if (typeof name !== 'string' || name === '')
|
|
2087
|
+
return false;
|
|
2088
|
+
if (name === 'bash' || name === 'shell' || name === 'exec')
|
|
2089
|
+
return true;
|
|
2090
|
+
return /^(?:bash|shell|exec)(?:[-_]|$)/.test(name);
|
|
2091
|
+
}
|
|
2092
|
+
/*
|
|
2093
|
+
* [复审修复] 从 shell 调用的 command 字符串解析「写目标路径」。
|
|
2094
|
+
*
|
|
2095
|
+
* 返回 null = 这不是 shell 类调用(或没有 command 参数),调用方据此跳过
|
|
2096
|
+
* shell 闸门;返回数组则可能为空(shell 调用但不含写形态,如纯读的
|
|
2097
|
+
* cat/grep/less)——空数组同样放行。多提取无害:每个候选最终仍走
|
|
2098
|
+
* presentedWriteDenialReason 的「已交付且计划未就绪」判定,普通路径直接
|
|
2099
|
+
* 放行;要防的是漏提取,所以解析宁可宽进。
|
|
2100
|
+
*
|
|
2101
|
+
* 保守模式只认这些强写信号:
|
|
2102
|
+
* - `>` / `>>` 重定向(含 heredoc:`cat <<EOF > path` 的重定向部分);
|
|
2103
|
+
* - `tee [-a] files...`(tee 是纯写管道,必须整组检查);
|
|
2104
|
+
* - `sed -i[.bak] ... files`(段内 -i 之后的全部非选项 token);
|
|
2105
|
+
* - `mv/cp/install 源... 目标`(只取最后一个非选项 token——源是读,只有
|
|
2106
|
+
* 目标是写,全取会把「复制自受保护文件」误拦成写);
|
|
2107
|
+
* - `dd of=path`。
|
|
2108
|
+
*
|
|
2109
|
+
* 启发式局限(有意保守,备查):
|
|
2110
|
+
* - 变量间接(cmd="> $f"; eval、sh -c 嵌套命令)不做展开;
|
|
2111
|
+
* - find -delete、perl -i、crontab 等少见写法不覆盖;
|
|
2112
|
+
* - 引号内带空格的路径按空白截断,不做完整 shell 词法分析;
|
|
2113
|
+
* - 超长命令只解析前 20k 字符。
|
|
2114
|
+
*/
|
|
2115
|
+
const SHELL_COMMAND_PARSE_LIMIT = 20_000;
|
|
2116
|
+
function shellWriteTargets(exec) {
|
|
2117
|
+
if (!isShellLikeToolName(exec?.name))
|
|
2118
|
+
return null;
|
|
2119
|
+
const command = exec?.arguments?.command;
|
|
2120
|
+
if (typeof command !== 'string' || command.trim() === '')
|
|
2121
|
+
return null;
|
|
2122
|
+
const text = command.length > SHELL_COMMAND_PARSE_LIMIT ? command.slice(0, SHELL_COMMAND_PARSE_LIMIT) : command;
|
|
2123
|
+
const targets = new Set();
|
|
2124
|
+
const stripQuotes = (token) => token.replace(/^['"]+|['"]+$/g, '');
|
|
2125
|
+
const isOption = (token) => token === '-' || token.startsWith('-') || token === '--';
|
|
2126
|
+
const add = (token) => {
|
|
2127
|
+
const cleaned = stripQuotes(String(token ?? '')).trim();
|
|
2128
|
+
if (cleaned !== '')
|
|
2129
|
+
targets.add(cleaned);
|
|
2130
|
+
};
|
|
2131
|
+
// > / >> 重定向(兼容 fd 前缀 2>file、1> file;&> 合并重定向跳过——歧义大)。
|
|
2132
|
+
for (const match of text.matchAll(/(?<![&\d])\d*>>?\s*([^\s;|&<>]+)/g))
|
|
2133
|
+
add(match[1]);
|
|
2134
|
+
// 按命令段分隔:; | &&。单 &(2>&1 的合并目标)不拆,避免把 fd 描述切碎。
|
|
2135
|
+
for (const segment of text.split(/&&|[;|]/)) {
|
|
2136
|
+
const trimmed = segment.trim();
|
|
2137
|
+
if (trimmed === '')
|
|
2138
|
+
continue;
|
|
2139
|
+
// tee [-a] files...:tee 之后到段尾的全部 token 都是写目标。
|
|
2140
|
+
const tee = /(?:^|\s)tee(?:\s+-[a-zA-Z]+)*\s+(\S(?:[\s\S]*?))?$/.exec(trimmed);
|
|
2141
|
+
if (tee && /\btee\b/.test(trimmed)) {
|
|
2142
|
+
for (const token of (tee[1] ?? '').split(/\s+/))
|
|
2143
|
+
if (!isOption(token))
|
|
2144
|
+
add(token);
|
|
2145
|
+
}
|
|
2146
|
+
// sed -i[.bak] ...:段内含 sed 且带 -i 选项时,取其后的全部非选项 token。
|
|
2147
|
+
const sed = /(?:^|\s)sed(?:\s+-[a-zA-Z]+)*\s+(-i\S*)(?:\s+([\s\S]*))?$/.exec(trimmed);
|
|
2148
|
+
if (sed) {
|
|
2149
|
+
for (const token of (sed[2] ?? '').split(/\s+/))
|
|
2150
|
+
if (!isOption(token))
|
|
2151
|
+
add(token);
|
|
2152
|
+
}
|
|
2153
|
+
// mv/cp/install 源... 目标:只取最后一个非选项 token(目标是写、源是读)。
|
|
2154
|
+
const mover = /(?:^|\s)(?:mv|cp|install)(?:\s+-[a-zA-Z]+)*\s+([\s\S]+)$/.exec(trimmed);
|
|
2155
|
+
if (mover) {
|
|
2156
|
+
const tokens = (mover[1] ?? '').split(/\s+/).filter((token) => !isOption(token));
|
|
2157
|
+
add(tokens[tokens.length - 1]);
|
|
2158
|
+
}
|
|
2159
|
+
// dd of=path(of= 后到空白为止)。
|
|
2160
|
+
for (const match of trimmed.matchAll(/(?:^|\s)of=([^\s;|&]+)/g))
|
|
2161
|
+
add(match[1]);
|
|
2162
|
+
}
|
|
2163
|
+
return [...targets];
|
|
2164
|
+
}
|