@zhushanwen/pi-subagent-workflow 7.4.0 → 8.1.0

package/src/interface/tool-workflow.ts

@@ -1,16 +1,15 @@
 /**
- * Workflow Extension — workflow tool（5 actions，FR-5 tool 收口）。
+ * Workflow Extension — workflow tool（3 actions，FR-5 tool 收口）。
  *
  * 合并原 tool-workflow.ts + tool-workflow-run.ts 为单 tool。
  *
  * Actions:
  * - run: registry.get → runWorkflow（直接启动，无需用户确认）
  * - status: 列出 runs（deps.runs）
- * - pause: 调 pauseRun
- * - resume: 调 resumeRun
  * - abort: 调 abortRun
  *
- * **restart 不包含**（D-9 废弃）。
+ * **restart 不包含**（D-9 废弃）；**pause/resume 不包含**（一次性生命周期——run
+ * 不可挂起，提前停止用 abort，要新结果开新 run）。
  *
  * 层归属：Interface。依赖 Pi SDK + Engine lifecycle/launcher + helpers。
  *
@@ -35,8 +34,7 @@ import { type Static, Type } from "typebox";
 import { SLUG_MAX_LENGTH } from "../execution/execute-options-mapper.ts";
 import { THINKING_ORDER } from "../execution/model-resolver.ts";
 import type { LauncherDeps } from "../orchestration/launcher.ts";
-import { ArgsValidationError } from "../orchestration/args-validator.ts";
-import { abortRun, pauseRun, resumeRun, runWorkflow } from "../orchestration/lifecycle.ts";
+import { abortRun, runWorkflow } from "../orchestration/lifecycle.ts";
 import type { RunStore } from "../orchestration/models/ports.ts";
 import type { WorkflowRun } from "../orchestration/models/workflow-run.ts";
 import { mapRunIcon, mapRunStatus, toGuiCtx } from "./gui-mappers.ts";
@@ -54,15 +52,11 @@ import { formatElapsed, renderTextFallback } from "./views/format.ts";
 export type WorkflowAction =
   | "run"
   | "status"
-  | "pause"
-  | "resume"
   | "abort";
 
 const WORKFLOW_ACTIONS: readonly WorkflowAction[] = [
   "run",
   "status",
-  "pause",
-  "resume",
   "abort",
 ];
 
@@ -80,7 +74,7 @@ const WorkflowParams = Type.Object({
     }),
   ),
   runId: Type.Optional(
-    Type.String({ description: "Workflow run ID (pause/resume/abort)" }),
+    Type.String({ description: "Workflow run ID (abort action)" }),
   ),
   args: Type.Optional(
     Type.Record(Type.String(), Type.Unknown(), {
@@ -96,7 +90,7 @@ const WorkflowParams = Type.Object({
     description: "Run-level model override in 'provider/modelId' format. When set, all agents spawned by this run inherit it by default (unless a per-call agent() opts.model is set). Omit to inherit the main agent's model.",
   })),
   thinkingLevel: Type.Optional(StringEnum(THINKING_ORDER, {
-    description: "Run-level thinkingLevel override (off/minimal/low/medium/high/xhigh/max). All agents in this run inherit it by default. Omit to inherit the main agent's thinking level.",
+    description: "Run-level thinkingLevel override (off/minimal/low/medium/high/xhigh/max). All agents in this run inherit it by default. Omit to default each agent to its model's highest available level.",
   })),
 });
 
@@ -229,7 +223,7 @@ interface RunSummary {
 export type WorkflowToolDetails =
   | { action: "run"; runId: string; status: "running" | "not_found" | "invalid_args"; name: string; slug?: string; stateFile?: string; __gui__?: GuiRenderResult }
   | { action: "status"; runs: RunSummary[]; __gui__?: GuiRenderResult }
-  | { action: "pause" | "resume" | "abort"; runId: string; status: string; reason?: string; __gui__?: GuiRenderResult };
+  | { action: "abort"; runId: string; status: string; reason?: string; __gui__?: GuiRenderResult };
 
 /** Result returned by the `workflow` tool's execute. */
 export interface ToolResult {
@@ -255,8 +249,9 @@ function withGui(
 /** 按 WorkflowToolDetails 构造对应的 GuiComponent。 */
 export function buildWorkflowGui(details: WorkflowToolDetails) {
   if (details.action === "run") {
-    // not_found 是脚本未找到的逻辑错误（isError:true），不能走通用 mapper 的 done/check 成功映射。
-    // 短路为 danger severity 的 stats-line，与 isError 文案一致。
+    // not_found 曾是「isError:true + not_found details」的错误形态（W4 前返回值 isError 被
+    // pi 丢弃）；W4 后该错误改为 throw（details 不再产出此形态），本分支保留消费历史
+    // session entry / 防御性渲染，不能走通用 mapper 的 done/check 成功映射。
     if (details.status === "not_found") {
       return guiComponent("stats-line", {
         items: [{ label: "run", value: "not found", severity: "danger" as const }],
@@ -283,14 +278,12 @@ export function buildWorkflowGui(details: WorkflowToolDetails) {
       }),
     });
   }
-  // pause/resume/abort
-  // abort 是破坏性终止、pause 是挂起（非成功完成），用 warn 区分；resume 保留 ok
-  const severity = details.action === "abort" || details.action === "pause" ? "warn" as const : "ok" as const;
+  // abort（唯一 lifecycle action）：破坏性终止非成功完成，用 warn 与成功区分
   return guiComponent("stats-line", {
     items: [{
       label: details.action,
       value: details.runId.slice(0, RUNID_SHORT),
-      severity,
+      severity: "warn" as const,
     }],
   });
 }
@@ -298,7 +291,8 @@ export function buildWorkflowGui(details: WorkflowToolDetails) {
 // ── Tool registration ────────────────────────────────────────
 
 /**
- * 注册 workflow tool（5 actions: run / status / pause / resume / abort）。
+ * 注册 workflow tool（3 actions: run / status / abort；pause/resume 已随一次性
+ * 生命周期移除——enum 拒绝由 pi 核心校验拦截，见 F3）。
  *
  * @param pi ExtensionAPI
  * @param deps LauncherDeps（LifecycleDeps + registry）
@@ -318,9 +312,9 @@ export function registerWorkflowTool(
     name: "workflow",
     label: "Workflow",
     description:
-      "Execute and control workflows: run (start), status, pause, resume, abort.\n" +
+      "Execute and control workflows: run (start), status, abort.\n" +
       "Replaces workflow + workflow-run tools.",
-    promptSnippet: "Run, pause, resume, abort, or check workflow status",
+    promptSnippet: "Run, abort, or check workflow status",
     promptGuidelines: [
       "PRIORITY: When user says 'workflow', 'run workflow', try run action FIRST.",
       "All listed workflows run DIRECTLY with action:run — refs/descriptions come from " +
@@ -329,10 +323,11 @@ export function registerWorkflowTool(
       "workflow-script generate for patterns already covered by available workflows.",
       "run: pass the absolute .js path from <available_workflows> <location> as name, then start in background (no user confirmation needed).",
       "Do NOT poll status after starting — results appear automatically via notifyDone.",
+      "Runs are one-shot: there is no pause/resume — to stop a run early use abort; for a fresh result start a new run.",
       "Call shapes (JSON): " +
       "- run: {\"action\":\"run\",\"name\":\"<script>\",\"args\":{...},\"tokens\":N,\"time\":N,\"model\":\"<provider/modelId>\",\"thinkingLevel\":\"<level>\"}. " +
       "- status: {\"action\":\"status\"}. " +
-      "- pause/resume/abort: {\"action\":\"pause\",\"runId\":\"<id>\"} (abort optional: ,\"error\":\"<reason>\"}).",
+      "- abort: {\"action\":\"abort\",\"runId\":\"<id>\"} (optional: {\"error\":\"<reason>\"}).",
       "Budget: Do NOT set tokens/time unless the user explicitly requests a limit. Built-in workflows run unlimited by default.",
       "Model/thinkingLevel: omit by default (inherit main agent's model). Only set model/thinkingLevel when the user explicitly requests a specific model or thinking depth for this run.",
       "Anti-patterns: Flattening args sub-fields (task/items/...) to the top level — they belong inside args. Calling {\"action\":\"run\"} without name.",
@@ -351,11 +346,13 @@ export function registerWorkflowTool(
     ): Promise<ToolResult> {
  // P1-2: Honor abort signal up-front
       if (signal?.aborted) {
-        return textResult("Operation aborted before start", true);
+        // throw（W4b）：pi 只对 execute throw 置 isError:true，返回值里的 isError
+        // 被 agent-loop 丢弃（agent-loop.js:453-483）——文案原样进 toolResult。
+        throw new Error("Operation aborted before start");
       }
- // P1-6: Reentry guard
+ // P1-6: Reentry guard（acquire 失败时尚未持有 guard，throw 前无需 release）
       if (!acquireReentryGuard(reentryRef)) {
-        return textResult(REENTRY_BUSY_MESSAGE, true);
+        throw new Error(REENTRY_BUSY_MESSAGE);
       }
       try {
         let result: ToolResult;
@@ -369,19 +366,13 @@ export function registerWorkflowTool(
           case "status":
             result = actionStatus(deps);
             break;
-          case "pause":
-            result = await actionLifecycle("pause", params, deps);
-            break;
-          case "resume":
-            result = await actionLifecycle("resume", params, deps);
-            break;
           case "abort":
             result = await actionLifecycle("abort", params, deps);
             break;
           default: {
             // Exhaustiveness check — 新增 WorkflowAction 成员时未补 case，tsc 在此报错。
             const _exhaustive: never = action;
-            return textResult(`Unknown action: ${String(_exhaustive)}`, true);
+            throw new Error(`Unknown action: ${String(_exhaustive)}`);
           }
         }
         // GUI 协议：RPC 模式下附加 __gui__ 到 details
@@ -428,30 +419,27 @@ export async function actionRun(
 ): Promise<ToolResult> {
   const name = params.name;
   if (!name) {
-    return textResult("run requires 'name' parameter (absolute .js path from <available_workflows> <location>). Correct: {\"action\":\"run\",\"name\":\"<ref>\",\"args\":{...}}", true);
+    throw new Error("run requires 'name' parameter (absolute .js path from <available_workflows> <location>). Correct: {\"action\":\"run\",\"name\":\"<ref>\",\"args\":{...}}");
   }
   // 弱模型常见误用（P0 静默失败）：把 task/items 等 args 子字段平铺到 workflow params
   // 顶层（缺 args 嵌套）。args ?? {} 会静默 args={}，启动缺参 run 不报错——比 subagent
   // 平铺事故更严重。m6：先 registry.getPath（动态参数集来源——schema 即 SSOT），
   // not_found 优先返回；平铺检测报错带 Correct 正例纠正。
   const script = await deps.registry.getPath(name);
-  if (!script) {
- // 模糊匹配建议
+  // W4c：config-loader 的 toCachedMeta 对不可读/不存在文件返回 available:false 的
+  // stub（非 undefined），仅判 !script 会绕过 not_found → 空 sourceCode 假启动
+  //（W4b verifier 探针实测复现）。与下方 suggestions 分支的 wf.available 过滤口径对齐。
+  if (!script || !script.available) {
+ // 模糊匹配建议。throw（W4）：pi 只对 execute throw 置 isError:true，
+ // 返回值里的 isError 被 agent-loop 丢弃（agent-loop.js:453-483）——文案原样进 toolResult。
     const all = await deps.registry.loadAll();
     const available = all.filter((wf) => wf.available);
     const suggestions = available
       .map((wf) => `  - ${wf.name}: ${wf.meta.description || "(no description)"}`)
       .join("\n");
-    return {
-      content: [
-        {
-          type: "text",
-          text: `Workflow '${name}' not found. Available:\n${suggestions || "  (none)"}\nUse <location> from <available_workflows> for the absolute .js path.`,
-        },
-      ],
-      details: { action: "run", runId: "", status: "not_found", name },
-      isError: true,
-    };
+    throw new Error(
+      `Workflow '${name}' not found. Available:\n${suggestions || "  (none)"}\nUse <location> from <available_workflows> for the absolute .js path.`,
+    );
   }
 
   // m6：动态参数集（schema 即 SSOT）→ 平铺检测；无 parameters → 单次 warn + 跳过
@@ -466,17 +454,15 @@ export async function actionRun(
   }
   const flattened = findFlattenedArgKeys(params, knownKeys, knownPatterns);
   if (flattened.length > 0) {
-    return textResult(
+    throw new Error(
       `Detected ${flattened.join(", ")} at top level — they belong inside 'args'. ` +
       `Correct: {"action":"run","name":"${name}","args":{${flattened.map((k) => `"${k}": "<value>"`).join(", ")}}}`,
-      true,
     );
   }
   // slug 运行时护栏（与 subagent startHandler 对称的纵深防御；schema maxLength 是第一道关卡）
   if (params.slug !== undefined && params.slug.length > SLUG_MAX_LENGTH) {
-    return textResult(
+    throw new Error(
       `slug exceeds ${SLUG_MAX_LENGTH} chars (got ${params.slug.length}). Shorten to a kebab-case label, e.g. "fix-login", "extract-urls".`,
-      true,
     );
   }
   const args = params.args ?? {};
@@ -484,36 +470,25 @@ export async function actionRun(
   const time = params.time;
 
  // 构建 RunSpec + 启动（m3：parameters 从 script.meta 拷贝——chokepoint 校验用；
- // 校验失败 → isError ToolResult 带 §5.3 指引，非 ArgsValidationError 保持传播）
-  let runId: string;
-  try {
-    runId = await runWorkflow(
-      {
-        scriptSource: script.toExecutable(),
-        args,
-        budgetTokens: tokens,
-        budgetTimeMs: time,
-        scriptName: script.name,
-        slug: params.slug,
-        scriptPath: script.path,
-        description: script.meta.description,
-        parameters: script.meta.parameters,
-        model: params.model,
-        thinkingLevel: params.thinkingLevel,
-      },
-      deps,
-      signal,
-    );
-  } catch (err) {
-    if (err instanceof ArgsValidationError) {
-      return {
-        content: [{ type: "text", text: err.message }],
-        details: { action: "run", runId: "", status: "invalid_args", name: script.name },
-        isError: true,
-      };
-    }
-    throw err;
-  }
+ // 校验失败 → ArgsValidationError 直接 throw 给 pi（W4：err.message 含 §5.3 指引，
+ // pi catch 后原文案进 toolResult content 并置 isError:true），其他错误保持传播）
+  const runId = await runWorkflow(
+    {
+      scriptSource: script.toExecutable(),
+      args,
+      budgetTokens: tokens,
+      budgetTimeMs: time,
+      scriptName: script.name,
+      slug: params.slug,
+      scriptPath: script.path,
+      description: script.meta.description,
+      parameters: script.meta.parameters,
+      model: params.model,
+      thinkingLevel: params.thinkingLevel,
+    },
+    deps,
+    signal,
+  );
 
   return {
     content: [
@@ -551,33 +526,28 @@ function actionStatus(deps: LauncherDeps): ToolResult {
   };
 }
 
-// ── pause/resume/abort lifecycle actions ─────────────────────
+// ── abort lifecycle action ────────────────────────────────────
 
+// 一次性生命周期：abort 是唯一的提前停止方式（pause/resume 已随 D-2 移除），
+// action 参数保留字面量类型与 WorkflowAction 单成员分发对齐。
 async function actionLifecycle(
-  action: "pause" | "resume" | "abort",
+  action: "abort",
   params: WorkflowToolParams,
   deps: LauncherDeps,
 ): Promise<ToolResult> {
   const runId = params.runId;
   if (!runId) {
-    return textResult(`'runId' is required for ${action}. Correct: {"action":"${action}","runId":"<id>"} (use action:"status" to find runId)`, true);
+    throw new Error(`'runId' is required for ${action}. Correct: {"action":"${action}","runId":"<id>"} (use action:"status" to find runId)`);
   }
   const run = deps.runs.get(runId);
   if (!run) {
-    return textResult(
+    throw new Error(
       `Workflow '${runId}' not found. Use action:status to list active runs and their runIds.`,
-      true,
     );
   }
   try {
     const oldStatus = run.state.status;
-    if (action === "pause") {
-      await pauseRun(runId, deps);
-    } else if (action === "resume") {
-      await resumeRun(runId, deps);
-    } else {
-      await abortRun(runId, deps, params.error);
-    }
+    await abortRun(runId, deps, params.error);
     const newStatus = run.state.status;
     const reasonSuffix = run.state.reason ? ` (${run.state.reason})` : "";
     return {
@@ -590,8 +560,9 @@ async function actionLifecycle(
       details: { action, runId, status: newStatus, reason: run.state.reason },
     };
   } catch (err) {
+    // throw（W4b）：abortRun 失败改 throw（原 return isError 被 pi 丢弃），"Error: " 前缀保持
     const msg = err instanceof Error ? err.message : String(err);
-    return textResult(`Error: ${msg}`, true);
+    throw new Error(`Error: ${msg}`);
   }
 }
 
@@ -612,10 +583,6 @@ function toRunSummary(run: WorkflowRun, store: RunStore): RunSummary {
   };
 }
 
-function textResult(text: string, isError = false): ToolResult {
-  return {
-    content: [{ type: "text", text }],
-    details: undefined,
-    isError: isError || undefined,
-  };
-}
+// W4b：原 textResult(text, isError) helper 已删除——23 处错误路径全部改 throw
+// （pi 只对 execute throw 置 isError:true，返回值里的 isError 被 agent-loop 丢弃，
+// agent-loop.js:453-483），且本文件无非错误纯文本结果用途，无残留调用方。

package/src/interface/views/WorkflowsView.ts

@@ -17,9 +17,9 @@
  *
  * 关键实现点：(a) overlay 第二参数必须传，否则 view 不全屏；(b) trace 必须 per-render
  * 重读（run.state.trace.toArray 返回内部数组引用，trace.append 后下次 render 可见），
- * 配 1s tick invalidate + requestRender 保证运行中刷新；(c) 's' save 模式无条件可用
- * （saveWorkflow 内部对非 tmp workflow 返回错误消息）；(d) pause/resume/abort 失败时
- * notify 反馈，不静默吞。
+ * 配条件失效 tick（签名比对，IF11）+ requestRender 保证运行中刷新；(c) 's' save 模式无条件可用
+ * （saveWorkflow 内部对非 tmp workflow 返回错误消息）；(d) abort 失败时 notify 反馈，
+ * 不静默吞（run 一次性生命周期——无 pause/resume，abort 是唯一提前停止方式）。
  */
 
 import { promises as fsPromises } from "node:fs";
@@ -30,12 +30,14 @@ import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import { Key, matchesKey } from "@earendil-works/pi-tui";
 
 import {
+  countAllToolCalls,
   getAllToolCalls,
   projectLiveProgress,
 } from "../../execution/execution-record.ts";
 import type { ExecutionTraceNode } from "../../orchestration/models/types.ts";
 import type { WorkflowRun } from "../../orchestration/models/workflow-run.ts";
 import { saveWorkflow } from "../../orchestration/workflow-files.ts";
+import { displayAgentName } from "../../shared/agent-ref.ts";
 import {
   BOX_BORDER_CHARS,
   BUDGET_TOKENS_DIVISOR,
@@ -122,14 +124,75 @@ interface TuiLike {
 
 /**
  * view 可触发的 lifecycle 操作（由调用方注入，避免 view 直接依赖 Engine 函数）。
- * 每个 action 接收 runId；调用方绑到 pauseRun/resumeRun/abortRun。
+ * 每个 action 接收 runId；调用方绑到 abortRun（一次性生命周期——仅 abort）。
  */
 export interface ViewActions {
-  pause: (runId: string) => Promise<void>;
-  resume: (runId: string) => Promise<void>;
   abort: (runId: string) => Promise<void>;
 }
 
+// ── 渲染签名（IF11/TC7/DM6：tick 条件失效的判据，渲染动态字段 SSOT）──────
+
+/**
+ * computeRenderSignature — 渲染输出中全部动态决定字段的签名（now 参数化，供测试）。
+ *
+ * 纯度说明：now 是显式参数，但 live 节点的 elapsedSeconds 经 projectLiveProgress
+ * 内的 computeElapsedSeconds 现算（record.endedAt 缺省时取 Date.now()）——即使两次
+ * 调用传同一 now，跨秒的真实时钟也会使签名变。该内含实时源只朝「多失效」方向
+ * 偏离（多失效、不多绘、更不漏绘），对「签名同 → 跳过重绘」的单向判据安全。
+ *
+ * 用途：200ms tick 用它与上次签名比对——相同则该帧内容无可见变化，跳过清缓存 +
+ * requestRender（纯等待场景零重建零重绘）；不同则走现状失效路径。可见行为逐帧
+ * 等价的前提 = 签名字段集覆盖当前渲染的全部动态字段（漏字段 = 该字段渲染滞后一拍，
+ * ES7；签名取原始值时粒度细于显示量化值，只多失效不多绘不漏绘）。
+ *
+ * **字段核对表**（每字段 ↔ 渲染消费点 file:line，完备性唯一证据——测试只能证
+ * 「已入字段变 → 签名变」，不能证无漏字段）：
+ *
+ * | 签名字段 | 消费点 |
+ * |---|---|
+ * | run.state.status | WorkflowsView.ts renderHeader :652 / detail-content.ts :75（statusDotStr+statusLabel）/ renderFooter :695-699 |
+ * | 秒桶 Math.floor(now/1000) | renderHeader :651 formatElapsed（现算 elapsed）+ detail-content.ts :69-72（now 参与未完成节点 elapsed）|
+ * | completed/total（节点 status 推导）| renderHeader :649-652 |
+ * | budget 量化值（tokens round-k + cost toFixed(4)=BUDGET_COST_DECIMALS，与 :654 同精度——第 3-4 位小数变化是可见变化）| renderHeader :654 / saveTraceToFile :942 |
+ * | run.state.errorLogs 指纹 = length+末条 level:message（errorLogs 仅经 push + slice(-MAX_ERROR_LOGS) 变异——append-only + 前向淘汰、条目不可变；封顶后 length 不变内容移，单取 length 会漏失效，而任何可见变化必伴随 length 变或末条变，故 length+末条是完备且最小的指纹）| detail-content.ts :174-191（renderWorkerLogSection：total 标签 + 末 20 条）|
+ * | 节点 stepIndex | nodeParts 首字段（trace 数组序参与拼接，节点重排→签名变）/ saveTraceToFile :947（trace 导出 `### [#stepIndex]` 标题）|
+ * | 节点 sessionFile | detail-content.ts :314-317（renderSessionSection）|
+ * | 节点 status | 节点行 :832 statusDotStr / detail :75 |
+ * | live.totalTokens | 节点行 :836 / detail :79 / :275 |
+ * | 工具计数（签名路径用 countAllToolCalls 免克隆计数，与 getAllToolCalls(node.live).length 恒等——projectLiveProgress 投影无 toolCallCount 字段，不得引用）| 节点行 :837 / detail :80 / :223 |
+ * | live.elapsedSeconds | 节点行 :838 / detail :81 / :276 |
+ * | live.turns | detail :224 / :276 |
+ * | live.eventLog.length（append-only，长度变化即尾部窗口右移出新事件）| detail :222（filter turn_end）+ :231-235 |
+ * | live.currentActivity（type+label 均入签名）| detail :227-228 |
+ * | live.lastError（内容入签名，防同存在性不同文本漏绘）| detail :277-278 |
+ *
+ * 维护约定（DS8）：WorkflowsView/detail-content 新增任何动态展示字段必须同步
+ * 并入本签名并更新上表，否则该字段渲染滞后一拍。本文件编辑会使表内 WorkflowsView
+ * 行号漂移——改动核对表下方代码后必须 grep 实际位置刷新本表。
+ */
+/** 秒桶宽度（ms）：签名取 Math.floor(now / SECOND_MS)，秒桶推进 = 可见 elapsed 变化。 */
+const SECOND_MS = 1000;
+
+export function computeRenderSignature(run: WorkflowRun, now: number): string {
+  const traceArr = run.state.trace.toArray();
+  const completed = traceArr.filter((n) => n.status === "completed").length;
+  const budget = run.state.budget;
+  // budget 量化串与 renderHeader budgetStr 同源同精度（round-k token / toFixed(4) cost）
+  const budgetPart = `${Math.round(budget.usedTokens / BUDGET_TOKENS_DIVISOR)}k/${budget.maxTokens ? `${Math.round(budget.maxTokens / BUDGET_TOKENS_DIVISOR)}k` : "∞"}::$${budget.usedCost.toFixed(BUDGET_COST_DECIMALS)}`;
+  // errorLogs 指纹：detail 只渲染 total 标签 + 末 20 条（renderWorkerLogSection），
+  // 而 errorLogs 仅经 push + slice(-MAX_ERROR_LOGS) 变异（append-only + 前向淘汰、
+  // 条目不可变）——封顶后 length 不变内容移，单取 length 漏失效；任何可见变化必
+  // 伴随「length 变」或「末条变」，故 length+末条（level:message）是完备最小指纹。
+  const logs = run.state.errorLogs;
+  const lastLog = logs && logs.length > 0 ? `${logs[logs.length - 1].level}:${logs[logs.length - 1].message}` : "-";
+  const errorLogsPart = `${logs?.length ?? 0}:${lastLog}`;
+  const nodeParts = traceArr.map((n) => {
+    const live = n.live ? projectLiveProgress(n.live) : undefined;
+    return `${n.stepIndex}:${n.status}:${n.sessionFile ?? "-"}:${live?.totalTokens ?? -1}:${n.live ? countAllToolCalls(n.live) : -1}:${live?.elapsedSeconds ?? -1}:${live?.turns ?? -1}:${live?.eventLog.length ?? -1}:${live?.currentActivity ? `${live.currentActivity.type}:${live.currentActivity.label}` : "-"}:${live?.lastError ?? "-"}`;
+  });
+  return [run.state.status, Math.floor(now / SECOND_MS), `${completed}/${traceArr.length}`, budgetPart, errorLogsPart, ...nodeParts].join("|");
+}
+
 // ── View state ────────────────────────────────────────────────
 
 interface ViewState {
@@ -181,7 +244,7 @@ function createInitialState(): ViewState {
  * @param run WorkflowRun 聚合根（读 state.status/spec/trace/meta）
  * @param theme ThemeLike（避免直接 import Pi runtime）
  * @param ctx ExtensionContext（调 ui.custom 渲染 + ui.notify 错误反馈）
- * @param actions lifecycle 操作（pause/resume/abort），由调用方注入
+ * @param actions lifecycle 操作（abort），由调用方注入
  */
 export function createWorkflowsView(
   run: WorkflowRun,
@@ -212,10 +275,17 @@ export function createWorkflowsView(
     const requestRender = () => tui.requestRender();
 
  // ── 轮询 tick：engine 无事件推送，view 自轮询 trace 变化 ──
- // 每 200ms 重绘，保证 header 动态数据（elapsed/tokens）实时更新。
- // 行数固定后，diff-redraw 引擎能正确逐行对比，不会出现残影。
+ // 每 200ms 条件失效（IF11/TC7）：先算渲染签名（computeRenderSignature，
+ // 覆盖 header/节点行/L2 detail 全部动态字段），与上次相同 → 该帧内容无可见
+ // 变化，直接 return（不清 cache、不 requestRender——纯等待场景零重建零重绘）；
+ // 不同 → 现状路径（清缓存 + requestRender）。lastSignature 初始 undefined，
+ // 首 tick 必失效（保证首绘）。签名计算 O(N)（N=trace 节点数）远低于全量 render。
+    let lastSignature: string | undefined;
     const tick = setInterval(() => {
       if (state.disposed) return;
+      const signature = computeRenderSignature(run, Date.now());
+      if (signature === lastSignature) return;
+      lastSignature = signature;
       cache.key = undefined;
       cache.lines = undefined;
       requestRender();
@@ -358,21 +428,9 @@ export function createWorkflowsView(
         return;
       }
 
- // ── Lifecycle shortcuts (no restart per D-9) ──
-      if (data === "p") {
-        if (run.state.status === "running") {
-          void actions.pause(run.runId)
-            .then(() => { cache.key = undefined; requestRender(); })
-            .catch((err: Error) => ctx.ui.notify(`Pause failed: ${err.message}`, "error"));
-        } else if (run.state.status === "paused") {
-          void actions.resume(run.runId)
-            .then(() => { cache.key = undefined; requestRender(); })
-            .catch((err: Error) => ctx.ui.notify(`Resume failed: ${err.message}`, "error"));
-        }
-        return;
-      }
+ // ── Lifecycle shortcuts (no restart per D-9; no pause/resume — one-shot) ──
       if (data === "a") {
-        if (run.state.status === "running" || run.state.status === "paused") {
+        if (run.state.status === "running") {
           void actions.abort(run.runId)
             .then(() => { cache.key = undefined; requestRender(); })
             .catch((err: Error) => ctx.ui.notify(`Abort failed: ${err.message}`, "error"));
@@ -498,7 +556,7 @@ export function createWorkflowsView(
 // │ ● 2 deploy 0/1 │ ● tester model ... │
 // │ (pad) │ (pad) │
 // ╰───────────────────────────────────────────────────╯
-// ↑↓ phase · ⏎ enter · p pause · a abort · s save · esc back ← footer (框外)
+// ↑↓ phase · ⏎ enter · a abort · s save · esc back ← footer (框外)
 //
 // body = sidebar(SIDEBAR_WIDTH) │ main(rest)
 // save overlay 活跃时居中覆盖 body。
@@ -621,10 +679,8 @@ function renderFooter(
       ? "↑↓ agent · ⏎ detail"
       : "↑↓ agent · ⏎ prompt · PgUp/PgDn scroll";
   const actionParts: string[] = [];
-  const status = run.state.status;
-  if (status === "running" || status === "paused") {
+  if (run.state.status === "running") {
     actionParts.push("a abort");
-    actionParts.push(status === "paused" ? "p resume" : "p pause");
   }
   actionParts.push("s save");
   actionParts.push("S trace");
@@ -765,7 +821,7 @@ function renderLevel1(
       const tokStr = live.totalTokens > 0 ? `${Math.round(live.totalTokens / BUDGET_TOKENS_DIVISOR)}k tok` : "";
       const tcCount = getAllToolCalls(node.live).length;
       const elapsed = formatElapsedSeconds(live.elapsedSeconds);
-      rightLines.push(`${pointer}${dot} ${node.agent}    ${node.model}    ${tokStr} · ${tcCount} tools · ${elapsed}`);
+      rightLines.push(`${pointer}${dot} ${displayAgentName(node.agent)}    ${node.model}    ${tokStr} · ${tcCount} tools · ${elapsed}`);
     } else {
       const elapsed = formatElapsed(
         node.startedAt,
@@ -774,7 +830,7 @@ function renderLevel1(
       const tok = node.result?.usage;
       const tokStr = tok ? `${Math.round((tok.input + tok.output) / BUDGET_TOKENS_DIVISOR)}k tok` : "";
       const tcCount = node.result?.toolCalls?.length ?? 0;
-      rightLines.push(`${pointer}${dot} ${node.agent}    ${node.model}    ${tokStr} · ${tcCount} tools · ${elapsed}`);
+      rightLines.push(`${pointer}${dot} ${displayAgentName(node.agent)}    ${node.model}    ${tokStr} · ${tcCount} tools · ${elapsed}`);
     }
   }
   state.agentScrollOffset = agentStart;
@@ -808,9 +864,10 @@ function renderLevel2(
     const a = agents[i];
     const pointer = i === state.agentIdx ? "❯ " : "  ";
     const maxNameWidth = SIDEBAR_WIDTH - AGENT_NAME_BUDGET;
-    const agentName = visibleLen(a.agent) > maxNameWidth
-      ? a.agent.slice(0, maxNameWidth - 1) + ELLIPSIS
-      : a.agent;
+    const agentRef = displayAgentName(a.agent);
+    const agentName = visibleLen(agentRef) > maxNameWidth
+      ? agentRef.slice(0, maxNameWidth - 1) + ELLIPSIS
+      : agentRef;
     leftLines.push(`${pointer}${agentName}`);
   }