dsh-knj-workflow 2026.9.70 → 2026.9.73

package/lib/client.js

@@ -503,6 +503,20 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 .knj-archive-list{flex:1;padding:14px 16px;overflow-y:auto}
 .knj-arch-row{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);border-radius:10px;padding:12px 14px;display:flex;align-items:center;gap:12px;margin-bottom:10px}
 .knj-arch-meta{margin-left:auto;font-size:12px;color:var(--dsw-alias-label-tertiary)}
+/* ===== 流程运行面板：状态对比增强 + 运行中呼吸脉冲 =====
+   只对「正在运行」这一主信号加动画（其余状态保持静态），脉冲柔和克制、契合 DSH 原生风格。
+   色值为既有语义色（RUN_STATUS/STAGE_META），未新增调色板。 */
+@keyframes knjRunPulse{0%,100%{opacity:.9}50%{opacity:.25}}
+@keyframes knjRunBreath{0%,100%{box-shadow:0 0 0 3px rgba(47,107,255,.22)}50%{box-shadow:0 0 0 9px rgba(47,107,255,.05)}}
+@keyframes knjBarStrip{to{background-position:14px 0}}
+.knj-run-glow{animation:knjRunPulse 2s ease-in-out infinite}
+.knj-node-dot.running{animation:knjRunBreath 1.6s ease-in-out infinite}
+.knj-node-card.running{border-color:#2f6bff;background:var(--dsw-alias-bg-base)}
+.knj-node-card.done{border-color:var(--dsw-alias-state-success-primary)}
+.knj-node-card.pending{border-color:var(--dsw-alias-border-l2);opacity:.85}
+.knj-node-card.failed{border-color:var(--dsw-alias-state-error-primary)}
+.knj-node-card.skipped{opacity:.55}
+.knj-progress.animated>div{background-image:linear-gradient(90deg,var(--dsw-alias-state-business-primary) 0 62%,rgba(47,107,255,.5) 62% 100%);background-size:14px 100%;animation:knjBarStrip .9s linear infinite}
 `;
 
 		function toast(msg) {
@@ -1141,7 +1155,7 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 							]),
 							sec('行为 prompt（task 节点）', [
 								'本节点让 AI 做什么，写清楚目标和约束。',
-								'可引用：${inputDescription}（任务需求描述）、${inputTitle}（标题）、${上游编码.字段}（上游输出，如 ${analyze.description}）、${inputs.参数名}（任务输入）。',
+								'可引用：${inputDescription}（任务需求描述）、${inputTitle}（标题）、${taskId}（任务 id，流程实例唯一标识；同任务续跑/重跑 id 不变，可拼产出路径隔离产物）、${上游编码.字段}（上游输出，如 ${analyze.description}）、${inputs.参数名}（任务输入）。',
 								'执行方式：single 一个 AI 完成；parallel 派多个 AI 并行（结果合并为数组）。',
 								'最大执行次数：本节点在一轮任务里最多执行几次（默认 3）。驳回重做 / 循环连线会重复执行节点，超过上限本轮失败——自动防死循环，无需其他配置。',
 							]),
@@ -1195,7 +1209,7 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 							]),
 							sec('行为 prompt（task 节点）', [
 								'本节点让 AI 做什么，写清目标与约束。',
-								'可引用：${inputDescription}（任务需求描述）、${inputTitle}（标题）、${storyCode}（用户故事编码）、${cwd}（任务工作目录）、${inputs.参数名}（任务输入）。',
+								'可引用：${inputDescription}（任务需求描述）、${inputTitle}（标题）、${storyCode}（用户故事编码）、${cwd}（任务工作目录）、${taskId}（任务 id，同任务续跑/重跑 id 不变，产出路径用它拼接可隔离各实例产物）、${inputs.参数名}（任务输入）。',
 								'运行时每个 task 节点会自动声明任务工作目录（所有文件/命令操作都在其中）。',
 								'需要 skill 时在 prompt 里直接写「先调用 skill 工具加载 skill「xxx」」。',
 								'上游输出引用（${上游编码.字段}）：',
@@ -1702,7 +1716,7 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 					fieldLabel('节点编码（id）', '节点唯一标识：下游用 ${编码.字段} 引用（如 ${analyze.description}），网关用字段值做分支判断。修改后 prompt 里旧的 ${旧编码.字段} 引用需手动更新。', '下游用 ${编码.字段} 引用，如 ${analyze.description}'),
 					react.createElement('input', { className: 'knj-input', style: { marginBottom: 8 }, placeholder: '如：analyze', defaultValue: node.id || '', onBlur: (e) => this.patchNodeId(node.id, e.target.value.trim()) }),
 					isTask ? react.createElement('div', null,
-						fieldLabel('行为 prompt（主体）', '本节点让 AI 做什么，写清目标与约束。\n可引用：\n${inputDescription}（任务需求描述）\n${inputTitle}（标题）\n${storyCode}（用户故事编码，可选）\n${cwd}（任务工作目录；运行时还会自动向 subagent 声明该目录）\n${inputs.参数名}（任务输入）\n\n上游输出引用（${上游编码.字段}）：\n' + this.buildRefsText(node) + '\n\n注意：XOR 分支未执行的节点引用为空；整节点输出用 ${节点id}；${ctx.前缀写法仍兼容。', '让 AI 做什么；可引用 ${inputDescription}、${storyCode}、${cwd}、${上游编码.字段}（ⓘ 看完整清单）'),
+						fieldLabel('行为 prompt（主体）', '本节点让 AI 做什么，写清目标与约束。\n可引用：\n${inputDescription}（任务需求描述）\n${inputTitle}（标题）\n${storyCode}（用户故事编码，可选）\n${cwd}（任务工作目录；运行时还会自动向 subagent 声明该目录）\n${taskId}（任务 id，流程实例唯一标识；同任务续跑/重跑 id 不变——产出路径可写 ${cwd}/out/${taskId}/ 按实例隔离产物）\n${inputs.参数名}（任务输入）\n\n上游输出引用（${上游编码.字段}）：\n' + this.buildRefsText(node) + '\n\n注意：XOR 分支未执行的节点引用为空；整节点输出用 ${节点id}；${ctx.前缀写法仍兼容。', '让 AI 做什么；可引用 ${inputDescription}、${storyCode}、${cwd}、${上游编码.字段}（ⓘ 看完整清单）'),
 						react.createElement('textarea', { className: 'knj-textarea', style: { minHeight: 140 }, placeholder: '如：根据需求 ${inputDescription} 输出功能描述与验收标准', value: node.body?.prompt || '', onChange: (e) => this.patchNode(node.id, { body: { ...node.body, prompt: e.target.value } }) }),
 						fieldLabel('执行方式', 'single：一个 AI 完成本阶段，输出单个对象。\nparallel：派多个 AI 并行做同一件事，结果合并为数组（配合「最大执行次数」外的 parallelItems 使用，见输出说明）。', 'single：单个 AI 完成；parallel：多个 AI 并行，结果合并为数组'),
 						react.createElement('select', { className: 'knj-input', value: node.body?.mode || 'single', onChange: (e) => this.patchNode(node.id, { body: { ...node.body, mode: e.target.value } }) },
@@ -2893,7 +2907,7 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 					kids.push(react.createElement('rect', { key: 'b', x: n.x - 31, y: n.y - 18, width: 62, height: 36, rx: 18, fill: 'var(--dsw-alias-bg-base)', stroke: isSkipped ? '#b6bdc7' : (status === 'pending' ? '#8b95a5' : c), strokeWidth: 1.4, strokeDasharray: isSkipped ? '4 3' : undefined, opacity: dim }));
 					kids.push(react.createElement('text', { key: 't', x: n.x, y: n.y + 4, fontSize: 12, textAnchor: 'middle', fill: 'var(--dsw-alias-label-secondary)' }, n.type === 'start' ? '开始' : '结束'));
 				} else {
-					kids.push(react.createElement('rect', { key: 'b', x: n.x - w / 2, y: n.y - hh / 2, width: w, height: hh, rx: 9, fill: n.type === 'human' ? '#f3efff' : 'var(--dsw-alias-bg-base)', stroke: 'var(--dsw-alias-border-l2)', strokeWidth: 1, opacity: dim }));
+					kids.push(react.createElement('rect', { key: 'b', x: n.x - w / 2, y: n.y - hh / 2, width: w, height: hh, rx: 9, fill: n.type === 'human' ? '#f3efff' : (status === 'running' ? '#e7efff' : status === 'done' ? '#f0faf3' : 'var(--dsw-alias-bg-base)'), stroke: isSkipped ? '#b6bdc7' : (status === 'pending' ? 'var(--dsw-alias-border-l2)' : c), strokeWidth: status === 'running' ? 2.1 : 1, opacity: dim }));
 					kids.push(react.createElement('rect', { key: 'bar', x: n.x - w / 2 + 1, y: n.y - hh / 2 + 1, width: 3.5, height: hh - 2, rx: 1.75, fill: isSkipped ? '#9aa3af' : c, strokeDasharray: isSkipped ? '3 2' : undefined }));
 					kids.push(react.createElement('text', { key: 'tt', x: n.x + 5, y: n.y - 1, fontSize: 13, fontWeight: 600, textAnchor: 'middle', fill: 'var(--dsw-alias-label-primary)', style: { userSelect: 'none' } }, (n.title || n.id).length > 11 ? (n.title || n.id).slice(0, 11) + '…' : (n.title || n.id)));
 					const sub = status === 'running' ? '运行中' : status === 'waiting' ? '等待人工审批' : (status === 'passed' ? '已过' : meta.label);
@@ -2907,8 +2921,8 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 						else if (status === 'skipped') kids.push(react.createElement('path', { key: 'ic2', d: `M ${ix - 3.2} ${iy} h 6.4`, stroke: '#fff', strokeWidth: 1.6, strokeLinecap: 'round' }));
 						else if (status === 'waiting') kids.push(react.createElement('circle', { key: 'ic2', cx: ix, cy: iy - 1.5, r: 2.2, fill: 'none', stroke: '#fff', strokeWidth: 1.2 }), react.createElement('path', { key: 'ic3', d: `M ${ix - 3.6} ${iy + 4.6} c 0 -2.1 1.7 -3.1 3.6 -3.1 s 3.6 1 3.6 3.1`, stroke: '#fff', strokeWidth: 1.2, fill: 'none', strokeLinecap: 'round' }));
 					}
-					// running 光环（静态两层，替代动画，避免依赖注入 keyframes）
-					if (status === 'running') kids.push(react.createElement('circle', { key: 'halo', cx: n.x, cy: n.y, r: 33, fill: 'none', stroke: '#2f6bff', strokeWidth: 1.6, opacity: 0.35 }));
+					// running 光环：贴合节点矩形的呼吸光边（非圆环；仅运行节点=当前主信号上动画）
+					if (status === 'running') kids.push(react.createElement('rect', { key: 'halo', className: 'knj-run-glow', x: n.x - w / 2 - 5, y: n.y - hh / 2 - 5, width: w + 10, height: hh + 10, rx: 13, fill: 'rgba(47,107,255,.1)', stroke: '#2f6bff', strokeWidth: 2.2 }));
 				}
 				const isSel = sel;
 				const hit = react.createElement('rect', { x: n.x - 70, y: n.y - 38, width: 140, height: 76, rx: 12, fill: 'transparent', onClick: (e) => { e.stopPropagation(); this.setState({ graphSel: n.id }); const stage = (this.props.task.stageStates || []).find((x) => x.id === n.id); if (stage && stage.status === 'done' && this.resultFor(n.id) == null) this.loadStageResult(n.id); }, style: { cursor: 'pointer' } });
@@ -2935,9 +2949,9 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 					: s.status === 'skipped' ? '–'
 					: s.status === 'failed' ? icon('x')
 					: (i + 1);
-				return react.createElement('div', { key: s.id, className: 'knj-node-card' },
+				return react.createElement('div', { key: s.id, className: 'knj-node-card' + (isRunning ? ' running' : s.status === 'done' ? ' done' : s.status === 'pending' ? ' pending' : s.status === 'failed' ? ' failed' : s.status === 'skipped' ? ' skipped' : '') },
 					react.createElement('div', { className: 'knj-node-head', onClick: () => hasDetail && this.toggle(s.id) },
-						react.createElement('div', { className: 'knj-node-dot', style: { background: meta.color, ...(isRunning ? { boxShadow: '0 0 0 4px rgba(37,99,235,.2)' } : {}) } }, statusIcon),
+						react.createElement('div', { className: 'knj-node-dot' + (isRunning ? ' running' : ''), style: { background: meta.color } }, statusIcon),
 						react.createElement('div', { style: { flex: 1, minWidth: 0 } },
 							react.createElement('div', { className: 'knj-node-title' }, s.title),
 							react.createElement('div', { className: 'knj-node-sub' }, dur ? `${dur} · ${meta.label}` : meta.label),
@@ -3233,7 +3247,7 @@ table.knj-tbl{width:100%;border-collapse:collapse;table-layout:fixed}
 						task.model ? react.createElement('span', { className: 'knj-badge', style: { background: '#5b6472' }, title: '该任务固定的执行模型（创建时指定）' }, task.model) : null,
 					),
 					// 整体进度条 + 摘要
-					react.createElement('div', { className: 'knj-progress', style: { width: '100%', marginTop: 12 } },
+					react.createElement('div', { className: 'knj-progress' + (task.status === 'running' ? ' animated' : ''), style: { width: '100%', marginTop: 12 } },
 						react.createElement('div', { style: { width: pct + '%' } }),
 					),
 					react.createElement('div', { className: 'sub', style: { marginTop: 4 } }, `进度 ${pct}% · 完成 ${doneCount}/${relevant.length} 阶段${steps.length - relevant.length ? `（跳过 ${steps.length - relevant.length}）` : ''}`),

package/lib/index.js

@@ -627,6 +627,18 @@ export class WorkflowBridge {
             // sessionIds 无限增长（每次续跑 +N 条重复 id）
             const ids = s.sessionIds || [];
             if (!ids.includes(childId)) s.sessionIds = [...ids, childId];
+            // 真实执行信号：主体 subagent 启动 = 本节点正在跑。多轮复用同一节点时
+            // （如人工驳回 → fix 重做 → 再驳回 → fix 再重做），上一轮 done 会挡死状态：
+            // onPhase 只把 pending/skipped→running，onAgentEnd 只把 running→done，
+            // done 阶段被再次执行时永远停留在旧 done/旧 finishedAt（task-mtu18nd3 实测：
+            // 显示 fix 已完成 12:06，实际 checkpoint 12:31 才落盘）。这里以 agent-start
+            // 为唯一事实源强制置回 running：清 finishedAt、刷新 startedAt 为本轮纪元。
+            if (s.status !== 'running') {
+              s.status = 'running';
+              s.startedAt = nowIso();
+              s.finishedAt = undefined;
+              s.error = undefined;
+            }
           }
         }
       }).catch(() => {});

package/lib/orchestrator.js

@@ -36,6 +36,12 @@ let humanFeedback = null;   // 人工意见：注入去向目标节点（仅一
 // 直接走其最后去向（目标已在 initialResults 则被 skipSet 跳过；否则正常执行）。
 // 没有它，两个顺序 human 的任务会在 H1/H2 之间无限振荡（H2 的决策被 H1 的重新暂停吞掉）。
 const decidedMap = args.decided || {};
+// 本轮已放行过一次去向的 human（消费当前决策 / 重放历史决策都算放行）。
+// 去向把流程带回同一个 human（如驳回 → fix → submit → 同一 human 的回环）时，再次到达
+// = 新一轮审批，必须暂停等人工，不能再用 decidedMap 里的旧决策放行第二次——
+// 否则 fix/submit 被反复重执行直到 maxRuns 超限报错，人工节点永远无法重新触发
+// （task-mttp8q71/task-mttz5ok7 实测：驳回后 fix/submit 空转 → 任务卡 running/失败）。
+const humanReleased = new Set();
 
 /** 节点最大执行次数：显式配置 maxRuns 优先，默认 3（首次 + 最多 2 次重跑）。 */
 function maxRunsOf(node) {
@@ -182,7 +188,11 @@ const BUILTIN_ACTIONS = {
 function getCtx() {
   // 任务级变量：inputDescription（新建任务需求描述）、inputTitle（标题）、storyCode（用户故事编码）、
   // cwd（工作目录）、inputs（参数映射）并列，工作流任意 prompt/hook 参数可引用。
+  // taskId = task.id（流程实例唯一标识；同任务 resume/rerun 不变）——节点产出文件路径可用它拼接，
+  // 让不同任务实例的产物互相隔离（等价写法 ${task.id}）。
   return {
+    task: { id: task.id },
+    taskId: task.id,
     inputs: args.inputs || {},
     inputDescription: task.description || '',
     inputTitle: task.title || '',
@@ -351,12 +361,16 @@ async function executeUntil(nodeId, joinId) {
         const route = matchRoute(node, decision.value);
         if (decision.feedback) humanFeedback = decision.feedback;
         skipSet.delete(route.to); // 去向目标应重新执行（接受人工意见），避免被断点跳过
+        humanReleased.add(node.id); // 本 walk 已放行过一次 → 回访即暂停（新一轮审批）
         current = route.to;
-      } else if (decidedMap[node.id]) {
+      } else if (decidedMap[node.id] && !humanReleased.has(node.id)) {
         // 历史决策重放：这个 human 已审批过（如顺序两个 human，后一个决策触发 resume 重走图）。
         // 直接走最后去向：目标已在 initialResults → skipSet 跳过；未执行过 → 正常执行。
         // 不注入意见（当初决策后的执行已带过意见）。
+        // 每个 human 每轮 walk 只重放一次：去向若把流程带回同一 human（驳回回环），
+        // 第二次到达意味着要重新审批，直接暂停而不是再次放行旧决策（见 humanReleased 注释）。
         const route = matchRoute(node, decidedMap[node.id]);
+        humanReleased.add(node.id);
         current = route.to;
       } else {
         return { ok: true, current: null, paused: true, pausedAt: node.id };

package/lib/orchestrator.test.js

@@ -694,6 +694,27 @@ test('orchestrator: 用户故事编码 storyCode 可引用（${storyCode}）', a
   assert.ok(!capturedPrompt.includes('${storyCode}'), capturedPrompt);
 });
 
+test('orchestrator: task.id 可引用（${taskId} 与 ${task.id}），可拼产出路径隔离实例产物', async () => {
+  const wf = {
+    id: 'wf-taskid', nodes: [
+      { id: 'start', type: 'start' },
+      { id: 'a', type: 'task', title: 'A', inputs: [], body: { prompt: '产物目录：${cwd}/out/${taskId}/，别名：${task.id}', mode: 'single', output: {} } },
+      { id: 'end', type: 'end' },
+    ],
+    edges: [{ from: 'start', to: 'a' }, { from: 'a', to: 'end' }],
+  };
+  let capturedPrompt = null;
+  const { result } = await runOrchestrator(wf, (label, prompt) => {
+    if (label === 'A') capturedPrompt = prompt;
+    return { ok: true };
+  }, { task: { id: 'task-mt1uc64i', title: 'T', taskDir: '.tasks/task-mt1uc64i', cwd: 'D:/ws/proj' } });
+  // 两种写法都解析为 task.id，拼接出的产出路径按实例隔离
+  assert.ok(capturedPrompt.includes('产物目录：D:/ws/proj/out/task-mt1uc64i/'), capturedPrompt);
+  assert.ok(capturedPrompt.includes('别名：task-mt1uc64i'), capturedPrompt);
+  assert.ok(!capturedPrompt.includes('${task'), capturedPrompt);
+  assert.equal(result.current, 'end');
+});
+
 test('orchestrator: human reject 带 feedback → rejectTo 节点 prompt 含人工意见', async () => {
   let capturedPrompt = null;
   const { result, agentCalls } = await runOrchestrator(humanWorkflow(), (label, prompt) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-knj-workflow",
-  "version": "2026.9.70",
+  "version": "2026.9.73",
   "description": "KNJ 开发任务编排插件：配置驱动的工作流 + 开发任务管理 + 可视化阶段进度（DeepSeek Harness）",
   "author": "knj",
   "license": "MIT",
@@ -37,12 +37,13 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-commands": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-workflow": "0.1.2-rc.1"
+    "@deepseek-ai/dsh-agent": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/dsh-commands": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/dsh-session": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/dsh-tools": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/dsh-workflow": ">=0.1.1-rc.2 <0.1.2-0 || >=0.1.2-rc.1 <0.1.3-0",
+    "@deepseek-ai/schemastery": ">=3.18.0 <4.0.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",