dsh-plugin-teamflow 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 > 本插件首次公开发布版本为 **v0.1.0**；发布前的内部迭代（v0.3~v0.13）记录于 `AGENTS.md` §5，对外统一归到 v0.1.0。
 
+## [0.1.6] - 2026-09-07
+
+### 新增
+- **评测层 L1+L2（prompt/注入改动收益评测）**：每次改 prompt/注入后可直接验证收益——L1 行为级契约测试（直接调用 prompt 工厂断言产出锚点，29 条契约分 HOST-ENFORCED/policy/structural 三级，改 prompt 一眼看出断了哪条、丢哪级保障）+ L2 回放语料一致性门禁（冻结真实形状的 QA-REPORT/ACCEPTANCE/dev 回复/蓝图产物，喂宿主真实解析器做 golden corpus 回归，零 LLM 成本）。语料只增不改，防评测过拟合
+- **dev/qaFix 验证证据块**：开发回复末尾强制「[Verification evidence]」块（命令+退出码+断言计数+失败行引用，或显式 N/A），host 提取存证、阶段详情可见、可与命令日志交叉核对——开发阶段从「单方宣称全绿」升级为「可审计的具体自述」
+- **代码级英文化（为 UI i18n 铺路）**：代码判断/命名全英文（阶段键 prd/design/scaffold/tech/dev/qa/acceptance、任务结构化键 taskKey），中文只留展示层；存量数据提供迁移脚本
+
+### 改进
+- **resume 断点续跑状态机化**：两级状态（大阶段 + 子图任务）聚合判定——有 done 尝试的任务即成功（历史失败不算失败），resume 只补跑「聚合后未成功」任务、复用已完成产物；不再读 backlog 子卡（残留失败卡不再污染判定）；dev 部分成功时起点精确回开发补跑未完成，全 done 时正确落在 QA/验收
+- **输出单轨制**：QA/验收的完整报告只写在任务夹文件（QA-REPORT.md/ACCEPTANCE.md），子代理回复仅摘要+路径——host 直接导入文件（缺陷表/核对表），杜绝「回复与文件不一致」的双轨问题
+- **验收结论契约强度**：验收报告结论行必须为字面量模板（✅/⚠️/❌/📝 四档）且为文件最后一行；无结论行/空结论行 → 需人工确认（不再默认通过，防质量门禁漏报）
+- **prompt 约束分级**：区分 [HOST-ENFORCED]（host 真实强制，如单轨产物/结论行）与 [policy]（自律 + 轻提醒），prompt 内不再自称 hard constraint
+- **重试诊断包**：重试时把上次失败详情（outcome/护栏原因/拒绝词命中点/产出尾部）附进 prompt——盲试 → 带因重试；stalled（挂死/空转）不再自动重试
+
+### 修复
+- **token 计量适配宿主 session v2**：宿主新版会话已无 `events` 属性，计量读不到 → 流水线卡与图卡无「TOKEN · 官方口径」。修复：多源回退（snapshotEvents/ownEvents）+ usage 双路径（含 stream 内嵌），新 run 计量恢复
+- **护栏挂死误杀**：QA 子代理正常干活却被判「10 分钟无事件」（宿主事件视图失明）——事件读取多源回退 + agent 活动守卫（非 idle 且已动手即不中止）
+- **任务卡 token 统计**：子卡 usage 按 stage 引用直写（并发下不再错位/超计）
+- **存量迁移脚本 taskKey 误判**：合法中文括号结尾的任务键不再被当作历史残留（幂等无损但计数虚高）
+- **验收空结论行/裸否定词漏报**：四档词白名单校验覆盖 accepted 分支
+
+### 其他
+- AGENTS.md 注入面瘦身 64%；dsh 0.1.3-alpha.1 兼容性核对（依赖包名更新）
+
 ## [0.1.5] - 2026-09-01
 
 ### 新增

package/README.md

@@ -119,6 +119,16 @@ dsh-plugin-teamflow/
 - Node.js ≥ 22.18；
 - 依赖宿主提供的 `@deepseek-ai/dsh-*` 与 `react`（peerDependencies，宿主注入，无需单独安装）。
 
+opencode### 版本锚定（dsh 宿主兼容性）
+
+本插件开发与验证基于 **dsh git master（2026-09-04，≈ 0.1.3-alpha.1 发布线）**；npm 侧最新发布线 `0.1.2-rc.1`（next tag；`latest` 标签滞后为 0.0.1-rc.1，勿以 latest 判断）。`peerDependencies` 保持 `*`（宿主注入，宽松兼容）。
+
+2026-09-04 兼容性核对（dsh 0.1.3-alpha.1）：session 持久化 v2（write-lease/JSONL 快照/版本化导出）、attachment/file-upload 收口、Windows 子进程隐藏、workspace 全限定路径硬化——**全部兼容，插件无需调整**。
+
+插件侧契约约束（dsh 升级后若行为异常先核对本段；锚定版本变更会在此更新）：
+- 插件注入的 session 事件（`tool-workflow/agent-start`、`user/message` 带 `source.kind='plugin'`）均在 released 词表内；**未来新增自定义事件类型须带 `ignorable: true`**，已知类型载荷不加 released 词表外键；
+- `@deepseek-ai/dsh-client-modules` 自 0.1.2-rc.1 起替代 `@deepseek-ai/dsh-client-runtime`（后者已从 monorepo 移除）。
+
 ## 安装（对使用者）
 
 ```bash

package/lib/client.js

@@ -308,15 +308,37 @@ window.__ModuleLoader__.load({
 			interrupted: T.warn,
 			superseded: T.text2
 		};
+		/** 阶段英文键 → 图标/中文展示名（2026-09-06 英文化：journal.phase 为英文键，展示名统一走映射——未来 i18n 换表即换语言）。 */
 		const PHASE_ICON = {
-			"PRD 产品需求": "📋",
-			"UI/UX 设计": "🎨",
-			"架构规划": "🏗️",
-			"技术方案": "📐",
-			开发: "💻",
-			"QA 测试": "🧪",
-			"产品验收": "✅"
+			prd: "📋",
+			design: "🎨",
+			scaffold: "🏗️",
+			tech: "📐",
+			dev: "💻",
+			qa: "🧪",
+			acceptance: "✅"
 		};
+		const PHASE_NAME = {
+			prd: "PRD 产品需求",
+			design: "UI/UX 设计",
+			scaffold: "架构规划",
+			tech: "技术方案",
+			dev: "开发",
+			qa: "QA 测试",
+			acceptance: "产品验收"
+		};
+		const phaseNameOf = (p) => PHASE_NAME[p] || p || "—";
+		const phaseIconOf = (p) => PHASE_ICON[p] || "⚙️";
+		/** phase 归一：英文键直通；存量中文映射（防御性——新数据全英文）。 */
+		const phaseKeyOf = (p) => ({
+			"PRD 产品需求": "prd",
+			"UI/UX 设计": "design",
+			"架构规划": "scaffold",
+			"技术方案": "tech",
+			"开发": "dev",
+			"QA 测试": "qa",
+			"产品验收": "acceptance"
+		})[p] || String(p || "");
 		const RUN_STATUS_TEXT = {
 			pending: "等待中",
 			running: "进行中",
@@ -642,7 +664,20 @@ window.__ModuleLoader__.load({
 					textOverflow: "ellipsis",
 					whiteSpace: "nowrap"
 				}
-			}, s.label), chip(stText(s.status), color, { dot: true }), h("span", { style: {
+			}, s.__taskKey || s.label), s.attempts && s.attempts.length > 1 ? h("span", {
+				title: `重试 ${s.attempts.length - 1} 次（共 ${s.attempts.length} 次尝试）`,
+				style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					fontWeight: 800,
+					color: T.warn,
+					background: `color-mix(in srgb, ${T.warn} 14%, transparent)`,
+					borderRadius: 999,
+					padding: "0 6px",
+					lineHeight: "15px",
+					flex: "0 0 auto"
+				}
+			}, `↻${s.attempts.length - 1}`) : null, chip(stText(s.status), color, { dot: true }), h("span", { style: {
 				color: T.text2,
 				fontSize: 11,
 				opacity: .5
@@ -724,12 +759,12 @@ window.__ModuleLoader__.load({
 				fontWeight: 700,
 				background: `linear-gradient(90deg, color-mix(in srgb, ${g.headColor} 13%, transparent), color-mix(in srgb, ${g.headColor} 5%, transparent))`,
 				border: `1px solid color-mix(in srgb, ${g.headColor} 30%, transparent)`
-			} }, h("span", { style: { fontSize: 13.5 } }, PHASE_ICON[g.phase] || "⚙️"), h("span", { style: {
+			} }, h("span", { style: { fontSize: 13.5 } }, phaseIconOf(g.phase)), h("span", { style: {
 				flex: 1,
 				overflow: "hidden",
 				textOverflow: "ellipsis",
 				whiteSpace: "nowrap"
-			} }, g.phase), g.stages.length > 1 ? h("span", { style: {
+			} }, phaseNameOf(g.phase)), g.stages.length > 1 ? h("span", { style: {
 				fontFamily: MONO,
 				fontSize: 10,
 				fontWeight: 800,
@@ -752,26 +787,32 @@ window.__ModuleLoader__.load({
 				paddingTop: 10
 			} }, g.stages.map((s) => FlowStageCard(s, s.seq, onOpen))));
 		}
-		/** 阶段详情抽屉（卡片点击打开；浮于画布右侧，不参与拖动/缩放）。 */
+		/** 阶段详情抽屉（卡片点击打开；浮于画布右侧，不参与拖动/缩放）。
+		* 2026-09-06 状态机化：同任务多次尝试 → 顶部尝试时间线 + 选中展开（默认最新）；
+		* 单次尝试保持现状（不渲染时间线）。 */
 		function StageDetailDrawer({ det, onClose, sessionId, sessions }) {
+			const [sel, setSel] = react.default.useState(null);
 			const st = det.stage;
 			const d = det.data;
+			const attempts = d && d.attempts && d.attempts.length > 1 ? d.attempts : null;
+			const selIdx = attempts ? sel === null ? attempts.length - 1 : sel : null;
+			const cur = attempts ? attempts[selIdx] || d : d;
 			const color = st && st.status ? stColor(st.status) : T.text2;
 			const ownerSession = d && d.ownerSession ? String(d.ownerSession) : null;
 			const mySession = sessionId ? String(sessionId) : null;
 			const crossSession = !!ownerSession && !!mySession && ownerSession !== mySession;
-			const hasChild = !!(!crossSession && d && d.childId && sessions && typeof sessions.openSubagent === "function");
+			const hasChild = !!(!crossSession && cur && cur.childId && sessions && typeof sessions.openSubagent === "function");
 			const openChild = () => {
 				if (crossSession || !hasChild) return;
 				try {
 					sessions.openSubagent({
 						parentSessionId: ownerSession || sessionId,
-						childSessionId: d.childId,
+						childSessionId: cur.childId,
 						mode: "one-shot"
 					});
 				} catch (e) {}
 			};
-			const outText = d && d.output ? d.output : d && d.summary ? `（该 run 未保存完整正文，展示摘要）\n\n${d.summary}` : det.err ? `⚠ 加载失败：${det.err}` : det.loading ? "加载中…" : "（无产物正文）";
+			const outText = cur && cur.output ? cur.output : cur && cur.summary ? `（该 run 未保存完整正文，展示摘要）\n\n${cur.summary}` : det.err ? `⚠ 加载失败：${det.err}` : det.loading ? "加载中…" : "（无产物正文）";
 			const closeBtn = {
 				font: "inherit",
 				width: 26,
@@ -820,7 +861,7 @@ window.__ModuleLoader__.load({
 				padding: "12px 14px",
 				borderBottom: `1px solid ${T.border}`,
 				background: `linear-gradient(135deg, color-mix(in srgb, ${color} 14%, transparent), transparent 62%)`
-			} }, h("span", { style: { fontSize: 17 } }, PHASE_ICON[st && st.phase] || "⚙️"), h("div", { style: {
+			} }, h("span", { style: { fontSize: 17 } }, phaseIconOf(st && st.phase)), h("div", { style: {
 				flex: 1,
 				minWidth: 0
 			} }, h("div", {
@@ -864,7 +905,66 @@ window.__ModuleLoader__.load({
 				fontFamily: MONO,
 				color: T.text,
 				lineHeight: 1.65
-			} }, usageDetail(d || st || {}))), h("div", { style: {
+			} }, usageDetail(cur || st || {}))), attempts ? h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 5
+			} }, h("span", { style: {
+				fontSize: 10.5,
+				fontWeight: 700,
+				color: T.text2,
+				letterSpacing: .3
+			} }, `↻ 尝试历史（${attempts.length} 次 · 点击查看该次详情）`), h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 4
+			} }, attempts.map((a, idx) => {
+				const aColor = a.status === "done" ? T.success : a.status === "failed" ? T.error : T.warn;
+				const sel = idx === selIdx;
+				return h("div", {
+					key: a.seq,
+					onClick: () => setSel(idx),
+					title: (a.summary || a.outcome || "").slice(0, 200),
+					style: {
+						cursor: "pointer",
+						borderRadius: 9,
+						padding: "6px 9px",
+						display: "flex",
+						gap: 7,
+						alignItems: "center",
+						border: `1px solid ${sel ? color : T.border}`,
+						background: sel ? `color-mix(in srgb, ${color} 10%, transparent)` : T.layer1
+					}
+				}, h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10.5,
+					color: T.text2,
+					flex: "0 0 52px"
+				} }, `#${a.seq}`), h("span", { style: {
+					fontSize: 11,
+					color: aColor,
+					flex: "0 0 64px",
+					fontWeight: 700
+				} }, a.status === "done" ? "✅ 成功" : a.status === "failed" ? `❌ ${a.outcome || "失败"}` : "⏳ 进行中"), h("span", { style: {
+					flex: 1,
+					minWidth: 0,
+					fontSize: 10.5,
+					color: T.text2,
+					overflow: "hidden",
+					textOverflow: "ellipsis",
+					whiteSpace: "nowrap"
+				} }, (a.summary || a.outcome || "（无摘要）").slice(0, 80)), h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					color: T.text2,
+					flex: "0 0 auto"
+				} }, a.startedAt ? fmtDur(a.startedAt, a.endedAt) : "—"), h("span", { style: {
+					fontFamily: MONO,
+					fontSize: 10,
+					color: T.text2,
+					flex: "0 0 auto"
+				} }, a.usage ? fmtTokens(totalTokens(a.usage)) : ""));
+			}))) : null, h("div", { style: {
 				display: "flex",
 				flexDirection: "column",
 				gap: 5
@@ -898,7 +998,37 @@ window.__ModuleLoader__.load({
 				color: T.text2,
 				textAlign: "center",
 				lineHeight: 1.55
-			} }, "跳转成功后，请切「对话」tab 查看该子代理的完整会话轨迹") : null), h("div", { style: {
+			} }, "跳转成功后，请切「对话」tab 查看该子代理的完整会话轨迹") : null), st && phaseKeyOf(st.phase) === "dev" ? h("div", { style: {
+				display: "flex",
+				flexDirection: "column",
+				gap: 5
+			} }, h("span", { style: {
+				fontSize: 10.5,
+				fontWeight: 700,
+				color: T.text2,
+				letterSpacing: .3
+			} }, "🔬 验证证据"), cur && cur.verifyEvidence ? h("div", { style: {
+				whiteSpace: "pre-wrap",
+				wordBreak: "break-word",
+				fontSize: 11.5,
+				lineHeight: 1.62,
+				color: T.text,
+				background: `color-mix(in srgb, ${T.layer2} 55%, transparent)`,
+				border: `1px solid ${T.border}`,
+				borderRadius: 10,
+				padding: "10px 12px",
+				maxHeight: 180,
+				overflowY: "auto",
+				fontFamily: MONO
+			} }, cur.verifyEvidence) : h("div", { style: {
+				fontSize: 11,
+				color: T.warn,
+				background: `color-mix(in srgb, ${T.warn} 8%, transparent)`,
+				border: `1px dashed color-mix(in srgb, ${T.warn} 45%, transparent)`,
+				borderRadius: 10,
+				padding: "8px 12px",
+				lineHeight: 1.55
+			} }, "（缺失——契约未兑现，host 已记警告；可与 logs/teamflow/<runId>/ 命令输出日志对照）")) : null, h("div", { style: {
 				display: "flex",
 				flexDirection: "column",
 				gap: 5
@@ -932,6 +1062,7 @@ window.__ModuleLoader__.load({
 				marginBottom: 8
 			} }, "🏭"), "暂无运行中的流水线——让模型调用 teamflow_start，或在上方输入需求");
 			const groups = [];
+			const taskKeyOf = (s) => String(s.taskKey || String(s.label || "").replace(/^开发 · /, "").replace(/（(?:第 \d+ 次重试|补跑)）$/, "").trim());
 			for (const st of active.stages || []) {
 				let g = groups.length ? groups[groups.length - 1] : null;
 				if (!g || g.phase !== st.phase) {
@@ -941,7 +1072,31 @@ window.__ModuleLoader__.load({
 					};
 					groups.push(g);
 				}
-				g.stages.push(st);
+				const key = taskKeyOf(st);
+				const prev = g.stages.find((x) => x.__taskKey === key);
+				if (prev) {
+					prev.attempts = prev.attempts || [prev];
+					prev.attempts.push(st);
+					if ((st.seq || 0) > (prev.seq || 0)) {
+						for (const f of [
+							"status",
+							"outcome",
+							"usage",
+							"output",
+							"summary",
+							"childId",
+							"startedAt",
+							"endedAt",
+							"verifyEvidence"
+						]) prev[f] = st[f];
+						prev.seq = st.seq;
+						prev.label = st.label;
+					}
+				} else g.stages.push({
+					...st,
+					__taskKey: key,
+					attempts: [st]
+				});
 			}
 			const wrapRef = react.default.useRef(null);
 			const [vw, setVw] = react.default.useState(900);