dsh-workplan 3.0.2 → 3.0.6
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 +58 -0
- package/README.en.md +15 -7
- package/README.md +18 -8
- package/README.zh.md +8 -7
- package/client.js +181 -27
- package/docs/release-notes-3.0.3.md +7 -0
- package/lib/approval-gate.js +79 -3
- package/lib/client.js +181 -27
- package/lib/comm-format.js +11 -9
- package/lib/dept-journal.js +223 -6
- package/lib/host.js +215 -12
- package/lib/lessons.js +83 -15
- package/lib/llm-rules.js +3 -2
- package/lib/notice-ledger.js +238 -0
- package/lib/plan.js +122 -5
- package/lib/runtime.js +446 -34
- package/lib/three-phase.js +78 -25
- package/lib/understanding.js +85 -6
- package/lib/v3-contract.js +45 -12
- package/package.json +1 -1
- package/src/approval-gate.ts +77 -3
- package/src/client.ts +178 -24
- package/src/comm-format.ts +10 -9
- package/src/dept-journal.ts +219 -7
- package/src/host.ts +215 -12
- package/src/lessons.ts +88 -15
- package/src/llm-rules.ts +3 -2
- package/src/notice-ledger.ts +251 -0
- package/src/plan.ts +126 -5
- package/src/runtime.ts +488 -32
- package/src/three-phase.ts +96 -27
- package/src/understanding.ts +100 -6
- package/src/v3-contract.ts +46 -13
package/lib/lessons.js
CHANGED
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
* 本模块不依赖 harness 服务,只做纯函数 + 同步文件读写,便于离线回放与测试。
|
|
19
19
|
*/
|
|
20
20
|
import { createHash } from 'node:crypto';
|
|
21
|
-
import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
21
|
+
import { appendFileSync, chmodSync, copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
|
|
22
22
|
import { homedir } from 'node:os';
|
|
23
23
|
import { dirname, join } from 'node:path';
|
|
24
24
|
export const LESSON_VERSION = 1;
|
|
@@ -141,17 +141,18 @@ export function resolveLessonsFile(env = process.env) {
|
|
|
141
141
|
return override;
|
|
142
142
|
return join(homedir(), '.dsh', 'workplan', 'lessons.jsonl');
|
|
143
143
|
}
|
|
144
|
-
function
|
|
144
|
+
function readJsonLinesSnapshot(file) {
|
|
145
145
|
if (!existsSync(file))
|
|
146
|
-
return [];
|
|
146
|
+
return { rows: [], corrupt: [], readError: null };
|
|
147
147
|
let text = '';
|
|
148
148
|
try {
|
|
149
149
|
text = readFileSync(file, 'utf8');
|
|
150
150
|
}
|
|
151
|
-
catch {
|
|
152
|
-
return [];
|
|
151
|
+
catch (readError) {
|
|
152
|
+
return { rows: [], corrupt: [], readError };
|
|
153
153
|
}
|
|
154
154
|
const rows = [];
|
|
155
|
+
const corrupt = [];
|
|
155
156
|
for (const line of text.split('\n')) {
|
|
156
157
|
const trimmed = line.trim();
|
|
157
158
|
if (!trimmed)
|
|
@@ -160,12 +161,18 @@ function readJsonLines(file) {
|
|
|
160
161
|
const parsed = JSON.parse(trimmed);
|
|
161
162
|
if (isRecord(parsed))
|
|
162
163
|
rows.push(parsed);
|
|
164
|
+
else
|
|
165
|
+
corrupt.push(trimmed);
|
|
163
166
|
}
|
|
164
167
|
catch {
|
|
165
|
-
//
|
|
168
|
+
// 单行损坏不能拖垮整份记忆:读端跳过该行,写端原样保留。
|
|
169
|
+
corrupt.push(trimmed);
|
|
166
170
|
}
|
|
167
171
|
}
|
|
168
|
-
return rows;
|
|
172
|
+
return { rows, corrupt, readError: null };
|
|
173
|
+
}
|
|
174
|
+
function readJsonLines(file) {
|
|
175
|
+
return readJsonLinesSnapshot(file).rows;
|
|
169
176
|
}
|
|
170
177
|
function coerceRecord(raw) {
|
|
171
178
|
if (!isRecord(raw))
|
|
@@ -196,12 +203,54 @@ export function readLessons(file = resolveLessonsFile()) {
|
|
|
196
203
|
.map(coerceRecord)
|
|
197
204
|
.filter((item) => item !== null);
|
|
198
205
|
}
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
206
|
+
/**
|
|
207
|
+
* [3.0.3] 防符号链接投毒:写入前确认目标不是符号链接,否则抛错拒绝
|
|
208
|
+
* (风格同 LESSONS_READ_FAILED)。攻击者把教训文件或临时文件路径换成
|
|
209
|
+
* 符号链接后,一次「原子重写」就会被重定向去覆盖无关文件。
|
|
210
|
+
*/
|
|
211
|
+
function assertLessonsWriteTarget(file, what) {
|
|
212
|
+
let stat;
|
|
213
|
+
try {
|
|
214
|
+
stat = lstatSync(file);
|
|
215
|
+
}
|
|
216
|
+
catch {
|
|
217
|
+
return; // 不存在:正常新写。
|
|
218
|
+
}
|
|
219
|
+
if (stat.isSymbolicLink()) {
|
|
220
|
+
throw new Error(`LESSONS_WRITE_REFUSED: 拒绝向符号链接${what}写入 ${file},以免被重定向覆盖无关文件`);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
function writeLessonsAtomic(file, records, corrupt = []) {
|
|
224
|
+
assertLessonsWriteTarget(file, '');
|
|
225
|
+
assertLessonsWriteTarget(`${file}.bak`, '备份');
|
|
226
|
+
mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
|
|
227
|
+
const lines = [
|
|
228
|
+
...records.map((item) => JSON.stringify(item)),
|
|
229
|
+
// 坏行原样留在文件末尾:下次读端仍会跳过,但绝不会因为一次重写就消失。
|
|
230
|
+
...corrupt,
|
|
231
|
+
];
|
|
232
|
+
const body = lines.length > 0 ? `${lines.join('\n')}\n` : '';
|
|
233
|
+
// 覆盖前留一代备份;备份失败不阻断主写入(主写入仍走临时文件 + 原子改名)。
|
|
234
|
+
if (existsSync(file)) {
|
|
235
|
+
try {
|
|
236
|
+
copyFileSync(file, `${file}.bak`);
|
|
237
|
+
}
|
|
238
|
+
catch {
|
|
239
|
+
// 备份是尽力而为:权限不足等情况下,主写入的失败会由调用方显式上报。
|
|
240
|
+
}
|
|
241
|
+
}
|
|
202
242
|
const tmp = `${file}.tmp-${process.pid}`;
|
|
203
|
-
|
|
243
|
+
assertLessonsWriteTarget(tmp, '临时文件');
|
|
244
|
+
writeFileSync(tmp, body, { encoding: 'utf8', mode: 0o600 });
|
|
204
245
|
renameSync(tmp, file);
|
|
246
|
+
// 已存在文件收紧到 0o600(rename 覆盖了同名符号链接之外的目标时,
|
|
247
|
+
// 权限可能带着旧文件的宽松位):best-effort,文件系统不支持时不断写。
|
|
248
|
+
try {
|
|
249
|
+
chmodSync(file, 0o600);
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
// best-effort。
|
|
253
|
+
}
|
|
205
254
|
}
|
|
206
255
|
/**
|
|
207
256
|
* 把一次复盘写入永久记忆。
|
|
@@ -221,7 +270,22 @@ export function recordLesson(input) {
|
|
|
221
270
|
problems: retro.problems,
|
|
222
271
|
prevention: retro.prevention,
|
|
223
272
|
});
|
|
224
|
-
const
|
|
273
|
+
const snapshot = readJsonLinesSnapshot(file);
|
|
274
|
+
/*
|
|
275
|
+
* 数据安全红线:读失败 ≠ 没有历史。
|
|
276
|
+
* 以前这里把 EACCES/EMFILE/EIO 当成空数组,随后「读-改-写」会把整份永久记忆
|
|
277
|
+
* 覆盖成刚写入的这一条。现在读失败直接抛错,由 runtime 的 catch 记录到状态里;
|
|
278
|
+
* 坏行则原样带回写端,重写时不会丢。
|
|
279
|
+
*/
|
|
280
|
+
if (snapshot.readError) {
|
|
281
|
+
const message = snapshot.readError instanceof Error
|
|
282
|
+
? snapshot.readError.message
|
|
283
|
+
: String(snapshot.readError);
|
|
284
|
+
throw new Error(`LESSONS_READ_FAILED: 无法读取 ${file},已拒绝写入以免覆盖历史教训(${message})`);
|
|
285
|
+
}
|
|
286
|
+
const records = snapshot.rows
|
|
287
|
+
.map(coerceRecord)
|
|
288
|
+
.filter((item) => item !== null);
|
|
225
289
|
const sameRow = records.findIndex((item) => item.planId === input.planId && item.subtaskId === input.subtaskId);
|
|
226
290
|
const sameIssue = records.findIndex((item) => item.fingerprint === fingerprint && item.department === input.department);
|
|
227
291
|
const base = {
|
|
@@ -262,11 +326,15 @@ export function recordLesson(input) {
|
|
|
262
326
|
// 时间正序保留最近 N 条;id 冲突(同一毫秒重复)时无需特殊处理,读端按行。
|
|
263
327
|
const kept = records.slice(Math.max(0, records.length - MAX_LESSON_RECORDS));
|
|
264
328
|
try {
|
|
265
|
-
writeLessonsAtomic(file, kept);
|
|
329
|
+
writeLessonsAtomic(file, kept, snapshot.corrupt);
|
|
266
330
|
}
|
|
267
|
-
catch {
|
|
331
|
+
catch (error) {
|
|
332
|
+
// 符号链接投毒是拒绝不是故障:不上 append 兜底,直接向上抛。
|
|
333
|
+
if (error instanceof Error && error.message.startsWith('LESSONS_WRITE_REFUSED'))
|
|
334
|
+
throw error;
|
|
268
335
|
try {
|
|
269
|
-
mkdirSync(dirname(file), { recursive: true });
|
|
336
|
+
mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
|
|
337
|
+
assertLessonsWriteTarget(file, '');
|
|
270
338
|
appendFileSync(file, `${JSON.stringify(base)}\n`, 'utf8');
|
|
271
339
|
}
|
|
272
340
|
catch {
|
package/lib/llm-rules.js
CHANGED
|
@@ -111,11 +111,12 @@ export function buildLlmRulesBrief(info = {}) {
|
|
|
111
111
|
* 与代码门禁同源(planDelegations 的 checkAtomicAssignment、comm-format 的
|
|
112
112
|
* F10/F11),提示词只是把代码已经在执行的规则提前说清楚。
|
|
113
113
|
*/
|
|
114
|
-
lines.push('- 极简任务硬门槛(用户要求 5,用户裁决 A=硬门槛):你派出的每一条任务必须简单到像 1+1=2
|
|
114
|
+
lines.push('- 极简任务硬门槛(用户要求 5,用户裁决 A=硬门槛):你派出的每一条任务必须简单到像 1+1=2——一个动作、一个主产物、一项可独立验收;出现「并且/并/同时/另外/还要/以及/分别/顺便/然后/接着/再」或分号并列、或一个任务里写了多句(含英文句点分隔的多句)、或超过 300 字符,平台直接拒绝派发(DELEGATE_TASK_NOT_ATOMIC)并给出拆分提示,实例:不要派「分析并修复并写测试」,要拆成「读 X 定位原因」「按原因改 Y」「写 Z 用例」三条。');
|
|
115
115
|
lines.push('- 质量要求硬门槛(用户要求 6):每一条分派都必须带 qualityRequirements(至少 1 条、每条 ≤400 字符、最多 8 条),写清「成果必须达到什么要求、什么算合格、怎么算不合格」;缺它平台拒绝派发(DELEGATE_QUALITY_REQUIREMENTS_MISSING)。任务书会把这块原文交给专家。');
|
|
116
116
|
lines.push('- 专家汇报必须精简且是 JSON(用户要求 7):专家完成后在证据块里给出 report(keyResults/keyInfo/importantInfo/leadRequirements 四个字符串数组,每数组 ≤6 条、每条 ≤200 字符,禁止重复);你收到后逐条核对,缺项或重复会被格式门禁退回(F10)。');
|
|
117
117
|
lines.push('- 你的汇总必须精简且是 JSON(用户要求 8/10/11):汇总本部门全部专家汇报后,在证据块里给出 departmentSummary(keyResults/keyInfo/importantInfo/sources 四个字符串数组,sources 必须覆盖全部已派发专家,禁止累赘重复);不合格会被退回(F11)。汇总完成后直接交回主 Agent,不需要另建文件。');
|
|
118
118
|
lines.push('- 执行时间与验收:你和每位全球顶尖专家均没有总时长、单次时长、空闲或回执硬截止。开工预估及其汇总只用于协调与告知,未报齐时如实显示部分和,但不构成分钟判据;不得以耗时、预估超额或未经时间批准为由拒绝 done,extendMs 已停用。完成只由真实结果、产物、结构化证据和质量验收决定;用户显式取消与真实错误仍然有效。');
|
|
119
|
+
lines.push('- 专家遇阻处置(3.0.5 硬规则,机制已强制):任何专家调用 dsh_workplan_escalate 后,禁止用 review/dispatch/direct 把该问题改派、重派或降级给其他专家;你必须先用 action="status" 全面梳理该成员的问题与本部门全部 delegates 执行状态,再研究形成解决方案,最后用 dsh_workplan_instruct 答复原 member;平台在该成员待指示期间会硬拒一切改派动作,投递成功后强制原专家继续执行。');
|
|
119
120
|
}
|
|
120
121
|
return lines.join('\n');
|
|
121
122
|
}
|
|
@@ -449,7 +450,7 @@ export function buildDelegateePrompt(input) {
|
|
|
449
450
|
'- 开工前必须先预估本人任务耗时(整数分钟)并经 self_effort 的 timeNotice={ declaredMinutes: 正整数分钟, reason? } 上报部门负责人,未上报不接续(T6/D9 硬门禁:ESTIMATE_MISSING/ESTIMATE_INVALID);该上报只是协调信息,必须如实预估。你和部门负责人执行任务均没有总时长、单次时长、空闲或回执硬截止;预估或实际耗时不会触发延期、超时接手,也不影响 done 验收。',
|
|
450
451
|
'- 必须在确保自身任务完成品质非常高的前提下,完美、超高效率地执行;严禁低效执行与浪费 token。',
|
|
451
452
|
'- 你是第三层叶子执行者:不得派生任何第四层 Agent/子会话;无法完成时在结论首行写 BLOCKED: 原因 并说明缺什么,不要空转。',
|
|
452
|
-
'-
|
|
453
|
+
'- 遇阻上报通道(3.0.5 四步闭环):遇阻(缺权限/缺输入/依赖产物缺失/需求自相矛盾/无法验证/需要负责人决定方向)时,第一动作是调用 dsh_workplan_escalate({ "question": "需要负责人回答的单个问题", "options": ["可选方向"], "needs": ["需要谁提供什么"] })。流程必须严格为:你先向部门负责人报告具体问题→负责人全面梳理你的问题与本部门全部已派发任务执行状态→负责人研究形成解决方案→负责人用 dsh_workplan_instruct 把方案告诉你→你继续执行原任务。平台禁止负责人在你待指示期间把你改派给其他专家;你必须是继续执行的人。调用 escalate 成功后停止推进、只做只读核对,不要自行选定一个选项继续。',
|
|
453
454
|
'- 完成后把结论与逐项证据(命令输出/文件/引用)用简洁中文回报给部门负责人会话;同时把同一份结构化结论写入 reports/wp-member-<你的成员名>-<任务代号>.json(相对工作目录,目录不存在就创建)作为结算兜底。',
|
|
454
455
|
`- 结果块契约:以 ${EVIDENCE_MARKER_BEGIN} 开头、${EVIDENCE_MARKER_END} 结尾,内含合法 JSON(status ∈ done/blocked/partial、phases 三阶段、acceptance 逐条带证据)。`,
|
|
455
456
|
'',
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* [3.0.6][第 3 批②] dsh-workplan 专用通知台账(notice ledger)。
|
|
3
|
+
*
|
|
4
|
+
* 审计病根:插件通知唯一的持久可见通道是 user/message,与用户真实输入混在同
|
|
5
|
+
* 一条事件流里(source.kind 虽可区分,但没有任何插件侧权威台账可供工具/前端
|
|
6
|
+
* 直接消费)。
|
|
7
|
+
*
|
|
8
|
+
* 官方约束(dsh-agent-preset/skills/dsh-doc/references/practices.md:21):
|
|
9
|
+
* 1. 禁止给 Session 新增自定义事件类型——live Session.append 无法打
|
|
10
|
+
* ignorable 标记,重启后 Session 会拒绝重新打开;
|
|
11
|
+
* 2. appendPluginRecord() 保留给 DSH 实验包,本插件不得使用;
|
|
12
|
+
* 3. 插件自有数据应放在插件自己的存储里。
|
|
13
|
+
*
|
|
14
|
+
* 因此 v1 专用通道 = 插件自有 JSONL 台账(默认 ~/.dsh/workplan/notices.jsonl,
|
|
15
|
+
* 可用 DSH_WORKPLAN_NOTICES_FILE 覆盖):
|
|
16
|
+
* - appendUserMessage 每次成功落盘一条 workplan 通知后,同步追加一行台账;
|
|
17
|
+
* - 台账行自带 sessionId/planId/kind/form/summary/text,是机器可读的权威
|
|
18
|
+
* 通知流(区别于用户真实输入——真实输入永远不会进本文件);
|
|
19
|
+
* - 写入失败不拖垮通知投递(user/message 才是模型的权威通道,且已通过
|
|
20
|
+
* 回读校验):失败行进内存环形缓冲,下一次写入时先行补落,尽最大努力
|
|
21
|
+
* 不丢、且绝不静默。
|
|
22
|
+
*
|
|
23
|
+
* 纪律与 lessons.ts(第 1 批)一致:同步读写、整行 JSON、坏行读端跳过/写端
|
|
24
|
+
* 原样保留。审计证据默认永久保留,不做轮转(与 journalRetentionDays 默认 0
|
|
25
|
+
* 的裁决一致)。
|
|
26
|
+
*
|
|
27
|
+
* [复审修复][第 4 批] 治理与安全加固:
|
|
28
|
+
* - 行数上限 NOTICE_LEDGER_MAX_LINES(默认 5000,可被正整数环境变量
|
|
29
|
+
* DSH_WORKPLAN_NOTICES_MAX_LINES 覆盖):超限即重写为「最新 N 行」
|
|
30
|
+
* (读全 → 取末 N → tmp+rename 原子替换),重写失败 best-effort 不拖垮写入;
|
|
31
|
+
* - 权限:目录 0o700、文件 0o600(新建以 mode 落盘、既有文件 best-effort chmod);
|
|
32
|
+
* - 防符号链接投毒:写/重写前 lstatSync 目标文件,是符号链接则跳过写入并
|
|
33
|
+
* console.warn(不抛错),绝不跟随链接写任意路径。
|
|
34
|
+
*/
|
|
35
|
+
import { appendFileSync, chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
|
|
36
|
+
import { homedir } from 'node:os';
|
|
37
|
+
import { dirname, join } from 'node:path';
|
|
38
|
+
export const NOTICE_LEDGER_VERSION = 1;
|
|
39
|
+
/** 写失败时的内存环形缓冲上限(尽最大努力补落,绝不清空丢弃)。 */
|
|
40
|
+
export const NOTICE_LEDGER_OVERFLOW_MAX = 100;
|
|
41
|
+
/** 台账行数上限:超过即重写为「最新 N 行」。可被 DSH_WORKPLAN_NOTICES_MAX_LINES(正整数)覆盖。 */
|
|
42
|
+
export const NOTICE_LEDGER_MAX_LINES = 5000;
|
|
43
|
+
function errorText(error) {
|
|
44
|
+
const text = error instanceof Error ? error.message : String(error);
|
|
45
|
+
return text.slice(0, 500);
|
|
46
|
+
}
|
|
47
|
+
/** 解析行数上限(env 优先,沿用 resolveNoticeLedgerFile 的解析风格)。 */
|
|
48
|
+
function resolveNoticeLedgerMaxLines(env = process.env) {
|
|
49
|
+
const raw = typeof env?.DSH_WORKPLAN_NOTICES_MAX_LINES === 'string'
|
|
50
|
+
? env.DSH_WORKPLAN_NOTICES_MAX_LINES.trim()
|
|
51
|
+
: '';
|
|
52
|
+
if (!raw)
|
|
53
|
+
return NOTICE_LEDGER_MAX_LINES;
|
|
54
|
+
const parsed = Number(raw);
|
|
55
|
+
return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : NOTICE_LEDGER_MAX_LINES;
|
|
56
|
+
}
|
|
57
|
+
/** 统计文本中的行数(按换行计;本模块写盘恒以 \n 结尾,行数 == \n 数)。 */
|
|
58
|
+
function countNewlines(text) {
|
|
59
|
+
let count = 0;
|
|
60
|
+
for (let i = 0; i < text.length; i += 1) {
|
|
61
|
+
if (text.charCodeAt(i) === 10)
|
|
62
|
+
count += 1;
|
|
63
|
+
}
|
|
64
|
+
return count;
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* 行数治理:写后若总行数超过上限,重写为「最新 N 行」。
|
|
68
|
+
* 全程 best-effort:任何失败只 console.warn,绝不抛错、绝不拖垮已成功的写入。
|
|
69
|
+
*/
|
|
70
|
+
function enforceNoticeLedgerCap(file, maxLines) {
|
|
71
|
+
if (!Number.isSafeInteger(maxLines) || maxLines <= 0)
|
|
72
|
+
return;
|
|
73
|
+
let text;
|
|
74
|
+
try {
|
|
75
|
+
text = readFileSync(file, 'utf8');
|
|
76
|
+
}
|
|
77
|
+
catch (error) {
|
|
78
|
+
console.warn(`dsh-workplan: notice 台账行数统计失败(不重写)file=${file}(${errorText(error)})`);
|
|
79
|
+
return;
|
|
80
|
+
}
|
|
81
|
+
const total = countNewlines(text);
|
|
82
|
+
if (total <= maxLines)
|
|
83
|
+
return;
|
|
84
|
+
// 防符号链接投毒:重写前再确认目标是普通文件(TOCTOU 缩小面;rename 只换链接本身也不跟随,但按纪律跳过)。
|
|
85
|
+
try {
|
|
86
|
+
if (lstatSync(file).isSymbolicLink()) {
|
|
87
|
+
console.warn(`dsh-workplan: notice 台账是符号链接,跳过重写 file=${file}`);
|
|
88
|
+
return;
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
catch (error) {
|
|
92
|
+
console.warn(`dsh-workplan: notice 台账重写前 lstat 失败(不重写)file=${file}(${errorText(error)})`);
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
const kept = text.split('\n').filter((line) => line.trim() !== '').slice(-maxLines);
|
|
96
|
+
const body = kept.length > 0 ? `${kept.join('\n')}\n` : '';
|
|
97
|
+
const tmp = `${file}.tmp-${process.pid}`;
|
|
98
|
+
try {
|
|
99
|
+
writeFileSync(tmp, body, { encoding: 'utf8', mode: 0o600 });
|
|
100
|
+
renameSync(tmp, file);
|
|
101
|
+
}
|
|
102
|
+
catch (error) {
|
|
103
|
+
console.warn(`dsh-workplan: notice 台账超限重写失败(保留原文件)file=${file}(${errorText(error)})`);
|
|
104
|
+
try {
|
|
105
|
+
unlinkSync(tmp);
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
/* 临时文件清理失败可忽略。 */
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
/** 台账文件位置:默认用户主目录,跨项目保留;测试可用环境变量覆盖。 */
|
|
113
|
+
export function resolveNoticeLedgerFile(env = process.env) {
|
|
114
|
+
const override = typeof env?.DSH_WORKPLAN_NOTICES_FILE === 'string'
|
|
115
|
+
? env.DSH_WORKPLAN_NOTICES_FILE.trim()
|
|
116
|
+
: '';
|
|
117
|
+
if (override)
|
|
118
|
+
return override;
|
|
119
|
+
return join(homedir(), '.dsh', 'workplan', 'notices.jsonl');
|
|
120
|
+
}
|
|
121
|
+
function isRecord(value) {
|
|
122
|
+
return !!value && typeof value === 'object' && !Array.isArray(value);
|
|
123
|
+
}
|
|
124
|
+
function coerceRecord(raw) {
|
|
125
|
+
if (!isRecord(raw))
|
|
126
|
+
return null;
|
|
127
|
+
return {
|
|
128
|
+
version: Number(raw.version) || NOTICE_LEDGER_VERSION,
|
|
129
|
+
at: Number(raw.at) || 0,
|
|
130
|
+
sessionId: typeof raw.sessionId === 'string' ? raw.sessionId : '',
|
|
131
|
+
planId: typeof raw.planId === 'string' ? raw.planId : '',
|
|
132
|
+
kind: typeof raw.kind === 'string' ? raw.kind : '',
|
|
133
|
+
form: typeof raw.form === 'string' ? raw.form : '',
|
|
134
|
+
summary: typeof raw.summary === 'string' ? raw.summary : '',
|
|
135
|
+
text: typeof raw.text === 'string' ? raw.text : '',
|
|
136
|
+
surfaceSeq: Number.isSafeInteger(Number(raw.surfaceSeq)) ? Number(raw.surfaceSeq) : -1,
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
/** 读端:坏行跳过不拖垮整份台账。 */
|
|
140
|
+
export function readNoticeLedger(file = resolveNoticeLedgerFile()) {
|
|
141
|
+
if (!existsSync(file))
|
|
142
|
+
return [];
|
|
143
|
+
let text = '';
|
|
144
|
+
try {
|
|
145
|
+
text = readFileSync(file, 'utf8');
|
|
146
|
+
}
|
|
147
|
+
catch {
|
|
148
|
+
return [];
|
|
149
|
+
}
|
|
150
|
+
const out = [];
|
|
151
|
+
for (const line of text.split('\n')) {
|
|
152
|
+
const trimmed = line.trim();
|
|
153
|
+
if (!trimmed)
|
|
154
|
+
continue;
|
|
155
|
+
try {
|
|
156
|
+
const parsed = coerceRecord(JSON.parse(trimmed));
|
|
157
|
+
if (parsed)
|
|
158
|
+
out.push(parsed);
|
|
159
|
+
}
|
|
160
|
+
catch {
|
|
161
|
+
// 单行损坏跳过:append-only 文件不做重写,坏行原样留在盘上。
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
return out;
|
|
165
|
+
}
|
|
166
|
+
/** 内存补落缓冲:文件写入失败时暂存,下一次写入先行补落。 */
|
|
167
|
+
let overflow = [];
|
|
168
|
+
/** 取出当前积压的补落行数(可观测性/测试用)。 */
|
|
169
|
+
export function noticeLedgerOverflowSize() {
|
|
170
|
+
return overflow.length;
|
|
171
|
+
}
|
|
172
|
+
function textOfMessage(message) {
|
|
173
|
+
const content = message?.content;
|
|
174
|
+
if (typeof content === 'string')
|
|
175
|
+
return content;
|
|
176
|
+
if (Array.isArray(content)) {
|
|
177
|
+
return content
|
|
178
|
+
.map((block) => (typeof block?.text === 'string' ? block.text : ''))
|
|
179
|
+
.filter(Boolean)
|
|
180
|
+
.join('\n');
|
|
181
|
+
}
|
|
182
|
+
return '';
|
|
183
|
+
}
|
|
184
|
+
/**
|
|
185
|
+
* 追加一行通知台账(同步、尽力而为)。
|
|
186
|
+
*
|
|
187
|
+
* @returns 是否写入(含补落)成功;失败行留在内存环形缓冲等待下次补落。
|
|
188
|
+
*/
|
|
189
|
+
export function appendNoticeLedger(sessionId, message, file = resolveNoticeLedgerFile(), now = Date.now()) {
|
|
190
|
+
const source = isRecord(message?.source) ? message.source : {};
|
|
191
|
+
const record = {
|
|
192
|
+
version: NOTICE_LEDGER_VERSION,
|
|
193
|
+
at: now,
|
|
194
|
+
sessionId: String(sessionId ?? ''),
|
|
195
|
+
planId: typeof source.planId === 'string' ? source.planId
|
|
196
|
+
: (typeof message?.planId === 'string' ? message.planId : ''),
|
|
197
|
+
kind: typeof source.kind === 'string' ? source.kind : 'workplan',
|
|
198
|
+
form: typeof source.form === 'string' ? source.form : 'notice',
|
|
199
|
+
summary: typeof source.summary === 'string' ? source.summary : '',
|
|
200
|
+
text: textOfMessage(message),
|
|
201
|
+
surfaceSeq: typeof message?.seq === 'number' ? message.seq : -1,
|
|
202
|
+
};
|
|
203
|
+
return flushNoticeLedger(file, [JSON.stringify(record)]);
|
|
204
|
+
}
|
|
205
|
+
/** 先补落积压行,再写新行;全部成功才清空缓冲。 */
|
|
206
|
+
function flushNoticeLedger(file, freshLines) {
|
|
207
|
+
const pending = [...overflow, ...freshLines];
|
|
208
|
+
// 防符号链接投毒:目标是符号链接则跳过写入并告警(不抛错,行留缓冲等待下次)。
|
|
209
|
+
try {
|
|
210
|
+
if (lstatSync(file).isSymbolicLink()) {
|
|
211
|
+
console.warn(`dsh-workplan: notice 台账目标是符号链接,跳过写入 file=${file}`);
|
|
212
|
+
overflow = pending.slice(-NOTICE_LEDGER_OVERFLOW_MAX);
|
|
213
|
+
return false;
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
catch {
|
|
217
|
+
/* 文件不存在(ENOENT,首写)或 lstat 失败:交给 appendFileSync 显式成败。 */
|
|
218
|
+
}
|
|
219
|
+
try {
|
|
220
|
+
mkdirSync(dirname(file), { recursive: true, mode: 0o700 });
|
|
221
|
+
appendFileSync(file, `${pending.join('\n')}\n`, { encoding: 'utf8', mode: 0o600 });
|
|
222
|
+
try {
|
|
223
|
+
// 既有文件权限收紧为 0o600(best-effort;新建文件已由 mode 覆盖)。
|
|
224
|
+
chmodSync(file, 0o600);
|
|
225
|
+
}
|
|
226
|
+
catch {
|
|
227
|
+
/* best-effort:权限收紧失败不阻断追加。 */
|
|
228
|
+
}
|
|
229
|
+
overflow = [];
|
|
230
|
+
// 行数治理(best-effort):超限即重写为「最新 N 行」,失败只 warn 不拖垮写入。
|
|
231
|
+
enforceNoticeLedgerCap(file, resolveNoticeLedgerMaxLines());
|
|
232
|
+
return true;
|
|
233
|
+
}
|
|
234
|
+
catch {
|
|
235
|
+
overflow = pending.slice(-NOTICE_LEDGER_OVERFLOW_MAX);
|
|
236
|
+
return false;
|
|
237
|
+
}
|
|
238
|
+
}
|
package/lib/plan.js
CHANGED
|
@@ -6,6 +6,7 @@
|
|
|
6
6
|
* durable message format, and the pure status/graph helpers used by the host
|
|
7
7
|
* runtime and by unit tests.
|
|
8
8
|
*/
|
|
9
|
+
import { appendNoticeLedger } from './notice-ledger.js';
|
|
9
10
|
import { createHash, randomUUID } from 'node:crypto';
|
|
10
11
|
import { DEPARTMENT_CAPABILITIES, DEPARTMENT_EXPERT_STANDARD, departmentCapability } from './departments.js';
|
|
11
12
|
// 历史判据字段只做读取消毒;不再派生或传播时间完成门槛。
|
|
@@ -1611,7 +1612,7 @@ export function buildPlannerPrompt(taskText, cwd, conversationContext = '', budg
|
|
|
1611
1612
|
resumes > 0
|
|
1612
1613
|
? `- 受阻后自动续跑额度 ${resumes} 次;需要时计划会暂停并在下一轮继续。`
|
|
1613
1614
|
: '- 自动续跑额度为 0;计划不会因轮次预算被暂停。',
|
|
1614
|
-
'- [3.0.0][用户要求 3/5] 每个子任务必须写 qualityRequirements(1-8 条字符串):这是主 Agent 派给部门负责人时随任务书一起下达的「结果质量要求」,写清成果必须达到什么要求、什么算合格。缺失质量要求的子任务在派发时会被系统直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),必须 replan 补齐后重新派发。同时子任务必须是简单到 1+1=2
|
|
1615
|
+
'- [3.0.0][用户要求 3/5] 每个子任务必须写 qualityRequirements(1-8 条字符串):这是主 Agent 派给部门负责人时随任务书一起下达的「结果质量要求」,写清成果必须达到什么要求、什么算合格。缺失质量要求的子任务在派发时会被系统直接拒发(DISPATCH_QUALITY_REQUIREMENTS_MISSING,不启动部门 Agent),必须 replan 补齐后重新派发。同时子任务必须是简单到 1+1=2 的单项工作:一个目标、一个主产物、一项可独立验收;不要在一个子任务里塞并列的多件事(出现「并且/并/同时/另外/还要/以及/分别/顺便/然后/接着/再」或多句并列——含英文句点 `.` 分隔的多句——时应拆成多个子任务)。',
|
|
1615
1616
|
'- 每个子任务必须写 estimateMinutes(整数 1-240,如实预估):只用于安排协调与告知用户,仅供参考、非承诺;不会派生执行截止,不会因超过预估算超时,也不影响 done 验收。取值整数与范围校验仅防止离谱输入,缺失不报错。',
|
|
1616
1617
|
/*
|
|
1617
1618
|
* [2.2.0][T13/推理等级] 子 Agent 必须自决推理等级,禁止继承主 Agent。
|
|
@@ -1804,8 +1805,11 @@ function flushPreHeadNotices(session) {
|
|
|
1804
1805
|
if (!surfaceHeadExists(session))
|
|
1805
1806
|
return;
|
|
1806
1807
|
preHeadNoticeQueue.delete(session);
|
|
1807
|
-
for (const message of queue)
|
|
1808
|
+
for (const message of queue) {
|
|
1808
1809
|
session.append('user/message', toJsonSafe(message), { surfaceOp: 'append' });
|
|
1810
|
+
/* [T3][回读校验] 补发直写同样写后读回比对关键字段,不一致即抛(见补丁头部注释)。 */
|
|
1811
|
+
verifySessionAppendReadback(session, message, 'flushPreHeadNotices');
|
|
1812
|
+
}
|
|
1809
1813
|
}
|
|
1810
1814
|
/*
|
|
1811
1815
|
* [2.5.5][治本] 头落地自动补发保险丝:旧实现只在「下一次 appendUserMessage」
|
|
@@ -2129,6 +2133,91 @@ export function toJsonSafe(value, seen) {
|
|
|
2129
2133
|
set.delete(value);
|
|
2130
2134
|
}
|
|
2131
2135
|
}
|
|
2136
|
+
/*
|
|
2137
|
+
* [T3][回读校验·补丁头部注释] 落盘后回读校验(部门负责人 2026-11-17 方案 A 指示)。
|
|
2138
|
+
* 依据来源:reports/wp-member-expert-persist-call-T1.json(写盘点①-⑨)与
|
|
2139
|
+
* reports/wp-member-expert-storage-T1-storage.json(journal/lessons 路径与写入代码),
|
|
2140
|
+
* 辅以 dsh-workplan-patch/dispatch-survey.md §3「落盘丢失+派发照跑」缺口与
|
|
2141
|
+
* reports/T2-hardening-assessment.md H4(落盘后回读校验)。
|
|
2142
|
+
* 覆盖映射(调研报告写盘点 → 本补丁 hunk,一一对应、无新增写盘点):
|
|
2143
|
+
* plan.ts:2284 appendUserMessage 统一会话写入器 → hunk「appendUserMessage 写后校验」
|
|
2144
|
+
* plan.ts:1886 flushPreHeadNotices 暂存队列补发直写 → hunk「flushPreHeadNotices 写后校验」
|
|
2145
|
+
* plan.ts:2540-2606 PLAN_MARKER / runtime.ts:11010-11023、:11018、:11284 计划投递
|
|
2146
|
+
* / plan.ts:4248、2936、3109 + runtime.ts:5897、6048、6874、6202 durable 信封
|
|
2147
|
+
* / plan.ts:2100-2143 合并归档 —— 以上 call_site 全部 funnel 经 appendUserMessage
|
|
2148
|
+
* 落会话日志 → 由「appendUserMessage 写后校验」同一 hunk 全覆盖,不逐点重复插桩
|
|
2149
|
+
* dept-journal.ts:290-308 journal 留痕文件追加 → 本补丁 src/dept-journal.ts hunk
|
|
2150
|
+
* lessons.ts:243-249、328-329 → 负责人硬性要求②明确排除
|
|
2151
|
+
* (非计划持久化写入点),本补丁不覆盖
|
|
2152
|
+
* 行号漂移复核(2026-11-17,grep -n + read 对照当前工作树):plan.ts:1886/2209/2284、
|
|
2153
|
+
* dept-journal.ts:302/303 与 T1 报告一致、无漂移;
|
|
2154
|
+
* dispatch-survey.md 锚点 runtime.ts:9166(dispatchTool)/9597(releaseTool) 一致,
|
|
2155
|
+
* NO_PLAN 报告写 9204、实际 9203(差 1 行),以实际为准。
|
|
2156
|
+
* 语义:会话事件日志 append 成功后立即用 session.eventAt(session.seq - 1) 读回最近
|
|
2157
|
+
* 事件,JSON 解析后比对关键字段(source.kind/form/summary、plan.planId、文本头 120
|
|
2158
|
+
* 字与长度摘要)。不一致或读不到事件 → 抛含会话路径与期望/实际摘要、处置指引
|
|
2159
|
+
* (重试或让主 Agent 手动制定计划)的显式错误,禁止静默(硬性要求③)。
|
|
2160
|
+
* 纯读校验、无副作用、不写盘 → 幂等(硬性要求④)。单线程事件循环内 append 与
|
|
2161
|
+
* eventAt 之间无 await,seq-1 必为本条,无并发错位。
|
|
2162
|
+
*/
|
|
2163
|
+
function sessionAppendKeyDigest(message) {
|
|
2164
|
+
const source = isRecord(message?.source) ? message.source : {};
|
|
2165
|
+
const text = messageText(message) ?? '';
|
|
2166
|
+
return JSON.stringify({
|
|
2167
|
+
kind: String(source.kind ?? ''),
|
|
2168
|
+
form: String(source.form ?? ''),
|
|
2169
|
+
summary: String(source.summary ?? ''),
|
|
2170
|
+
planId: typeof message?.plan?.planId === 'string' ? message.plan.planId : '',
|
|
2171
|
+
textHead: text.slice(0, 120),
|
|
2172
|
+
textLength: text.length,
|
|
2173
|
+
});
|
|
2174
|
+
}
|
|
2175
|
+
function sessionAppendReadbackPath(session) {
|
|
2176
|
+
for (const key of ['file', 'path', 'filePath', 'sessionFile']) {
|
|
2177
|
+
const value = session?.[key];
|
|
2178
|
+
if (typeof value === 'string' && value)
|
|
2179
|
+
return value;
|
|
2180
|
+
}
|
|
2181
|
+
const id = session?.id ?? session?.sessionId;
|
|
2182
|
+
return typeof id === 'string' && id ? `session:${id}` : 'unknown-session';
|
|
2183
|
+
}
|
|
2184
|
+
function normalizeEventData(data) {
|
|
2185
|
+
if (typeof data !== 'string')
|
|
2186
|
+
return data;
|
|
2187
|
+
try {
|
|
2188
|
+
return JSON.parse(data);
|
|
2189
|
+
}
|
|
2190
|
+
catch {
|
|
2191
|
+
return data;
|
|
2192
|
+
}
|
|
2193
|
+
}
|
|
2194
|
+
function verifySessionAppendReadback(session, written, context) {
|
|
2195
|
+
/*
|
|
2196
|
+
* 单元桩会话只有 append、没有事件日志介质(生产宿主必有 eventAt——
|
|
2197
|
+
* reconstructFromSession runtime.ts:4203 依赖它回放计划),无介质可读时不构成
|
|
2198
|
+
* 「落盘内容不一致」,原样放行;生产路径一律严格校验、失败即抛。
|
|
2199
|
+
*/
|
|
2200
|
+
if (typeof session?.eventAt !== 'function')
|
|
2201
|
+
return;
|
|
2202
|
+
let event;
|
|
2203
|
+
try {
|
|
2204
|
+
event = session.eventAt(session.seq - 1);
|
|
2205
|
+
}
|
|
2206
|
+
catch (error) {
|
|
2207
|
+
throw new Error(`dsh-workplan: 会话落档回读校验失败(${context}):读回事件抛错 ${String(error)};`
|
|
2208
|
+
+ `会话路径=${sessionAppendReadbackPath(session)}。请重试;若多次失败请让主 Agent 手动制定计划。`);
|
|
2209
|
+
}
|
|
2210
|
+
/* [T3][R1 修正] 期望摘要必须与落盘口径一致:写入侧落盘的是 toJsonSafe(message),
|
|
2211
|
+
* 读回比对也必须对 toJsonSafe(written) 取摘要。若对原始 message 取摘要,NaN/Date/Map
|
|
2212
|
+
* 等 T2 类负载会被 toJsonSafe 改写后与读回值不符,导致误抛「回读校验失败」。 */
|
|
2213
|
+
const expected = sessionAppendKeyDigest(toJsonSafe(written));
|
|
2214
|
+
const actual = event ? sessionAppendKeyDigest(normalizeEventData(event.data)) : '<读回不到事件>';
|
|
2215
|
+
if (!event || event.type !== 'user/message' || actual !== expected) {
|
|
2216
|
+
throw new Error(`dsh-workplan: 会话落档回读校验失败(${context}):写入内容与读回内容关键字段不一致。`
|
|
2217
|
+
+ `会话路径=${sessionAppendReadbackPath(session)} 期望=${expected.slice(0, 300)}`
|
|
2218
|
+
+ ` 实际=${String(actual).slice(0, 300)}。请重试;若多次失败请让主 Agent 手动制定计划。`);
|
|
2219
|
+
}
|
|
2220
|
+
}
|
|
2132
2221
|
export function appendUserMessage(session, payload, source, opts) {
|
|
2133
2222
|
if (!session || typeof session.append !== 'function')
|
|
2134
2223
|
return undefined;
|
|
@@ -2211,7 +2300,19 @@ export function appendUserMessage(session, payload, source, opts) {
|
|
|
2211
2300
|
flushPreHeadNotices(session);
|
|
2212
2301
|
/* [T2][治本] 写入前净化为纯 JSON:NaN/undefined/Date/Map/Set/循环引用等
|
|
2213
2302
|
* 一律转为可序列化值,杜绝宿主 snapshotJsonValue 校验抛错导致的重试刷屏。 */
|
|
2214
|
-
|
|
2303
|
+
const appended = session.append('user/message', toJsonSafe(message), { surfaceOp: 'append' });
|
|
2304
|
+
/* [T3][回读校验] 写后立即读回比对关键字段,不一致抛显式错误(见补丁头部注释)。 */
|
|
2305
|
+
verifySessionAppendReadback(session, message, 'appendUserMessage');
|
|
2306
|
+
/*
|
|
2307
|
+
* [3.0.6][第 3 批②] 专用通知台账:workplan 通知成功落盘后同步追加一行
|
|
2308
|
+
* 插件自有 JSONL 台账(见 notice-ledger.ts 头部——宿主禁止自定义事件类型,
|
|
2309
|
+
* 故通道是插件存储而非 Session 事件)。台账失败不拖垮投递:失败行进内存
|
|
2310
|
+
* 环形缓冲等待下次补落。真实用户输入不走本函数,因此不会混入台账。
|
|
2311
|
+
*/
|
|
2312
|
+
if (String(message?.source?.kind ?? '').startsWith('workplan')) {
|
|
2313
|
+
appendNoticeLedger(session.id, { ...message, seq: appended?.seq });
|
|
2314
|
+
}
|
|
2315
|
+
return appended;
|
|
2215
2316
|
}
|
|
2216
2317
|
/*
|
|
2217
2318
|
* [2.2.5][T5] 分解期间进度文案与回报器(T3 交互规范 §3 C2/C3、§4 频率规则)。
|
|
@@ -3071,10 +3172,26 @@ export function parseCancelMessage(message) {
|
|
|
3071
3172
|
* 这里用规范化后的包含关系做匹配:允许「必须给出命令与退出码」与
|
|
3072
3173
|
* 「给出命令与退出码」这类措辞差异,但不允许完全不同的一条顶替。
|
|
3073
3174
|
* 短文本(< 6 字)只接受等值,避免 "ok" 命中任意单词。
|
|
3175
|
+
*
|
|
3176
|
+
* [3.0.3] 验收措辞归一化:子 Agent 换个措辞汇报(加标点、大小写、多余
|
|
3177
|
+
* 空格、全角字符、「已完成:」式完成态前缀)就永远 missing → 验收被无限
|
|
3178
|
+
* 退回。比较前对两侧做同一套归一化:
|
|
3179
|
+
* 1. trim;
|
|
3180
|
+
* 2. 全角→半角(U+FF01–FF5E、全角空格 U+3000)——必须在去标点之前做,
|
|
3181
|
+
* 否则全角标点先消失、全角字母数字留着,两边仍然对不上;
|
|
3182
|
+
* 3. 小写化;
|
|
3183
|
+
* 4. 去常见完成态前缀(已完成/完成/已/done/yes)。CJK 前缀允许与正文直接
|
|
3184
|
+
* 相接(「完成接口测试」⇔「已完成:接口测试」);英文 done/yes 必须后随
|
|
3185
|
+
* 标点或空白,避免误吃 yesterday 这类以 yes 开头的词。该步在去标点前
|
|
3186
|
+
* 做,使「已完成:」「已完成:」与「已完成」归一到同一串。
|
|
3074
3187
|
*/
|
|
3075
3188
|
export function normaliseCriterion(value) {
|
|
3076
3189
|
return String(value ?? '')
|
|
3190
|
+
.trim()
|
|
3191
|
+
.replace(/[!-~]/g, (ch) => String.fromCharCode(ch.charCodeAt(0) - 0xFEE0))
|
|
3192
|
+
.replace(/ /g, ' ')
|
|
3077
3193
|
.toLowerCase()
|
|
3194
|
+
.replace(/^(?:已完成|完成|已|done|yes)(?=[\s::,,。.!!??;;、\-—–]|$)|^(?:已完成|完成|已)/i, '')
|
|
3078
3195
|
.replace(/[\s,。;、,.;::!!??"'“”‘’()()\[\]【】《》<>]/g, '')
|
|
3079
3196
|
.replace(/^(必须|需要|应当|应该|请|务必)/, '');
|
|
3080
3197
|
}
|
|
@@ -3943,7 +4060,7 @@ export function adjudicateResult({ output, strict = true, expectedAcceptance = [
|
|
|
3943
4060
|
acceptance,
|
|
3944
4061
|
artifacts,
|
|
3945
4062
|
needs,
|
|
3946
|
-
error:
|
|
4063
|
+
error: `五步证据不完整(未按「任务梳理→资源工具方案研究→准备→执行验证→JSON 交付」回报):${phaseCheck.errors.slice(0, 6).join(';')}`,
|
|
3947
4064
|
phases: null,
|
|
3948
4065
|
};
|
|
3949
4066
|
}
|
|
@@ -6549,7 +6666,7 @@ phaseZeroContinuation = '', }) {
|
|
|
6549
6666
|
'',
|
|
6550
6667
|
'结果回传(必填):在汇报的最后附上一个结构化结果块,主 Agent 会按它逐项核对,不再只依赖自述。',
|
|
6551
6668
|
EVIDENCE_MARKER_BEGIN,
|
|
6552
|
-
'{"status":"done","blockedReason":"","phases":{"planning":{"problemAnalysis":["要解决的问题 1(含现状/约束/未知/主要矛盾)"],"constraints":["..."],"unknowns":["..."],"approach":["第 1 步:做什么 → 产出什么 → 如何证明"]},"execution":{"steps":["实际执行的步骤"],"deviations":[]},"verification":{"allPassed":true,"checks":[{"criterion":"A1","method":"怎么验证","evidence":"命令输出/文件/引用"}],"requirementCheck":"逐条核对用户原要求的结果","retrospective":{"problems":["本次遇到的问题(现象+根因)"],"detours":["走过的弯路/返工/无效尝试;确实没有就写 []"],"resolutions":["最终是如何解决的"],"prevention":["以后如何预防再犯:遇到…先…"]}}},"acceptance":[{"criterion":"A1 把上面的验收标准原文抄在这里","result":"pass","evidence":"用命令输出、文件路径或引用证明"}],"artifacts":[{"kind":"file","ref":"相对工作目录的路径"}],"needs":[],"question":"","options":[],"timeSpentMinutes":0,"finalEstimateMinutes":0}',
|
|
6669
|
+
'{"status":"done","blockedReason":"","phases":{"planning":{"problemAnalysis":["要解决的问题 1(含现状/约束/未知/主要矛盾)"],"constraints":["..."],"unknowns":["..."],"resources":["完成本任务需要的资源:数据/文件/权限/人/知识/时间(逐项写用途与获取方式)"],"tools":["需要的工具及用途(为什么选它)"],"approach":["第 1 步:做什么 → 产出什么 → 如何证明"]},"preparation":{"prepared":["已备齐的资源/工具:准备了什么、在哪里、是否可用"],"evidence":["每项就绪证据:命令输出/文件路径/配置项/版本号/引用"]},"execution":{"steps":["实际执行的步骤"],"deviations":[]},"verification":{"allPassed":true,"checks":[{"criterion":"A1","method":"怎么验证","evidence":"命令输出/文件/引用"}],"requirementCheck":"逐条核对用户原要求的结果","retrospective":{"problems":["本次遇到的问题(现象+根因)"],"detours":["走过的弯路/返工/无效尝试;确实没有就写 []"],"resolutions":["最终是如何解决的"],"prevention":["以后如何预防再犯:遇到…先…"]}}},"acceptance":[{"criterion":"A1 把上面的验收标准原文抄在这里","result":"pass","evidence":"用命令输出、文件路径或引用证明"}],"artifacts":[{"kind":"file","ref":"相对工作目录的路径"}],"needs":[],"question":"","options":[],"timeSpentMinutes":0,"finalEstimateMinutes":0}',
|
|
6553
6670
|
EVIDENCE_MARKER_END,
|
|
6554
6671
|
'- [2.2.9] 盘上结算备份(必做):发送结果块之前,先把同一份 JSON 写入 reports/wp-settlement-<你的子任务 ID>.json(相对工作目录)。收尾消息因异常(error/截断/超时)丢失时,宿主会自动采纳该备份结算,避免「已完成的工作」被误判为「缺失回报」而受阻并级联冻结下游。[2.5.2][T4b] 备份 JSON 顶层必须带 planId 与 subtaskId(childId 若已知也带上),且必须是本次执行新写(覆盖同名旧文件):宿主采纳前会校验新鲜度(文件修改时间不早于本次尝试开始时间)与归属(planId/subtaskId 必须匹配本计划/本子任务),陈旧或跨计划的备份会被拒绝采纳并留审计痕。',
|
|
6555
6672
|
'- status 只能是 done / blocked / partial;partial 会被当作受阻处理。',
|