@fieldwangai/agentflow 0.1.99 → 0.1.101

package/bin/lib/ui-server.mjs

@@ -128,6 +128,7 @@ import {
   listWorkspaceRunLogs,
   readWorkspaceRunLogEvents,
 } from "./workspace-run-logs.mjs";
+import { createWorkspaceRunController } from "./workspace-run-controller.mjs";
 
 const MIME = {
   ".html": "text/html; charset=utf-8",
@@ -4947,6 +4948,8 @@ async function workspaceGeneratePlannedImplementationMarkdown({
     prompt,
     modelKey,
     agentflowUserId: userCtx?.userId || "",
+    detached: process.platform !== "win32",
+    onChild: onActiveChild,
     extraEnv: runtimeEnvForUser(userCtx, {
       AGENTFLOW_IMPLEMENTATION_REF: implementationPath || "",
       AGENTFLOW_NODE_RUN_DIR: runPackage?.nodeRunDir || "",
@@ -4967,7 +4970,6 @@ async function workspaceGeneratePlannedImplementationMarkdown({
       emit?.({ type: "status", nodeId, line: `优化工具 ${tool || "thinking"}${sub ? ` (${sub})` : ""}` });
     },
   });
-  if (typeof onActiveChild === "function") onActiveChild(handle.child || null);
   try {
     await handle.finished;
   } finally {
@@ -5009,6 +5011,8 @@ async function workspaceGenerateImplementationMarkdown({
     prompt,
     modelKey,
     agentflowUserId: userCtx?.userId || "",
+    detached: process.platform !== "win32",
+    onChild: onActiveChild,
     extraEnv: runtimeEnvForUser(userCtx, {
       AGENTFLOW_IMPLEMENTATION_REF: implementationPath || "",
       AGENTFLOW_NODE_RUN_DIR: runPackage?.nodeRunDir || "",
@@ -5029,7 +5033,6 @@ async function workspaceGenerateImplementationMarkdown({
       emit?.({ type: "status", line: `总结方案工具 ${tool || "thinking"}${sub ? ` (${sub})` : ""}` });
     },
   });
-  if (typeof onActiveChild === "function") onActiveChild(handle.child || null);
   try {
     await handle.finished;
   } finally {
@@ -5994,6 +5997,8 @@ async function workspaceRunToolNodejsScript({
   userCtx,
   envOverlay = {},
   emit,
+  signal,
+  onActiveChild,
 }) {
   const scriptRef = String(instance?.scriptRef || "").trim();
   const scriptAbs = scriptRef ? workspaceResolveFlowFile(scopedRoot, scriptRef, "scriptRef") : "";
@@ -6041,14 +6046,24 @@ async function workspaceRunToolNodejsScript({
 
   const started = Date.now();
   return await new Promise((resolve, reject) => {
+    const processGroup = process.platform !== "win32";
     const child = spawn(command, [], {
       cwd: runPackage.nodeRunDir,
       shell: true,
       stdio: ["ignore", "pipe", "pipe"],
       env,
+      detached: processGroup,
     });
+    if (typeof onActiveChild === "function") onActiveChild(child, { processGroup });
     let stdout = "";
     let stderr = "";
+    let settled = false;
+    const finish = (callback) => {
+      if (settled) return;
+      settled = true;
+      if (typeof onActiveChild === "function") onActiveChild(null);
+      callback();
+    };
     child.stdout.setEncoding("utf-8");
     child.stderr.setEncoding("utf-8");
     child.stdout.on("data", (chunk) => {
@@ -6057,19 +6072,27 @@ async function workspaceRunToolNodejsScript({
     child.stderr.on("data", (chunk) => {
       stderr += String(chunk);
     });
-    child.on("error", reject);
+    child.on("error", (error) => finish(() => reject(error)));
     child.on("close", (code) => {
+      if (signal?.aborted) {
+        finish(() => {
+          const error = new Error("Workspace run stopped");
+          error.code = "WORKSPACE_RUN_ABORTED";
+          reject(error);
+        });
+        return;
+      }
       if (stderr.trim()) {
         emit?.({ type: "natural", kind: "warning", text: `[script stderr]\n${stderr.trim().slice(-4000)}` });
       }
       if (code !== 0) {
-        reject(new Error(`tool_nodejs script exited ${code}${stderr.trim() ? `: ${stderr.trim().slice(-800)}` : ""}`));
+        finish(() => reject(new Error(`tool_nodejs script exited ${code}${stderr.trim() ? `: ${stderr.trim().slice(-800)}` : ""}`)));
         return;
       }
       const elapsedMs = Math.max(0, Date.now() - started);
       emit?.({ type: "status", line: `Timing script: ${elapsedMs}ms`, timing: { label: "script", elapsedMs } });
       const content = stdout.trim() || workspaceEnvelopeFromOutputFiles(outputRefs, runPackage.nodeRunDir);
-      resolve(content);
+      finish(() => resolve(content));
     });
   });
 }
@@ -6691,6 +6714,8 @@ async function runWorkspaceGraph(root, scopedRoot, payload, userCtx = {}, opts =
         userCtx,
         envOverlay: runEnv,
         emit: (event) => emit({ ...event, nodeId }),
+        signal,
+        onActiveChild: opts.onActiveChild,
       });
       const normalizedAgentOutput = workspacePublishAgentOutputFiles(workspaceStructuredAgentOutput(content), runPackage);
       const resultContent = normalizedAgentOutput.result || content;
@@ -6787,6 +6812,8 @@ async function runWorkspaceGraph(root, scopedRoot, payload, userCtx = {}, opts =
           prompt,
           modelKey: nodeModelKey,
           agentflowUserId: userCtx.userId || "",
+          detached: process.platform !== "win32",
+          onChild: opts.onActiveChild,
           extraEnv: runtimeEnv({
             AGENTFLOW_WORKSPACE_TMP_ROOT: runTmpRoot,
             AGENTFLOW_NODE_RUN_DIR: runPackage.nodeRunDir,
@@ -6823,7 +6850,6 @@ async function runWorkspaceGraph(root, scopedRoot, payload, userCtx = {}, opts =
             emit({ type: "status", nodeId, line: `工具 ${tool || "thinking"}${sub ? ` (${sub})` : ""}` });
           },
         });
-        if (typeof opts.onActiveChild === "function") opts.onActiveChild(handle.child || null);
         emitTiming(nodeId, "spawn-agent", spawnStartedAt, { attempt });
         try {
           await handle.finished;
@@ -7395,9 +7421,7 @@ function prdWorkflowReviewRenderTable(lines) {
   ].join("");
 }
 
-function prdWorkflowReviewMarkdownToHtml(markdown) {
-  const { frontmatter, body } = prdWorkflowReviewSplitFrontmatter(markdown);
-  const lines = String(body || "").replace(/\r\n/g, "\n").split("\n");
+function prdWorkflowReviewMarkdownLinesToHtml(lines) {
   const html = [];
   let paragraph = [];
   let list = [];
@@ -7474,11 +7498,147 @@ function prdWorkflowReviewMarkdownToHtml(markdown) {
   }
   if (code) html.push(`<pre><code>${htmlEscapeAttribute(prdWorkflowReviewNormalizeText(code.lines.join("\n")))}</code></pre>`);
   flushBlocks();
-  return [prdWorkflowReviewRenderFrontmatter(frontmatter), ...html].filter(Boolean).join("\n");
+  return html.join("\n");
+}
+
+function prdWorkflowReviewActionLine(line) {
+  const match = String(line || "").match(/^\s*[-*]\s+(?:\[( |x|X)\]\s+)?(A\d+|Action\s*\d+)(?=\s|[（(：:.-]|$)(.*)$/i);
+  if (!match) return null;
+  return {
+    checked: match[1] ? match[1].toLowerCase() === "x" : null,
+    label: match[2].replace(/\s+/g, " ").toUpperCase(),
+    title: String(match[3] || "").replace(/^\s*[-:：]\s*/, "").trim(),
+  };
+}
+
+function prdWorkflowReviewIsActionsHeading(line) {
+  const heading = String(line || "").trim().match(/^(#{1,6})\s+(.+)$/);
+  if (!heading) return null;
+  const title = heading[2].replace(/[*_`]/g, "").trim();
+  if (!/(?:\bTODO\s+Actions?\b|\bActions?\b|待办(?:事项|行动)?|行动项)/i.test(title)) return null;
+  return { level: heading[1].length };
+}
+
+function prdWorkflowReviewRenderActionSection(lines, sectionIndex) {
+  const actionStarts = [];
+  lines.forEach((line, index) => {
+    const action = prdWorkflowReviewActionLine(line);
+    if (action) actionStarts.push({ index, action });
+  });
+  if (!actionStarts.length) return prdWorkflowReviewMarkdownLinesToHtml(lines);
+
+  const ids = new Map();
+  const actions = actionStarts.map(({ index, action }, actionIndex) => {
+    const nextStart = actionStarts[actionIndex + 1]?.index ?? lines.length;
+    let bodyStart = index + 1;
+    const titleParts = [action.title].filter(Boolean);
+    while (bodyStart < nextStart) {
+      const continuation = String(lines[bodyStart] || "");
+      if (!/^\s{2,}\S/.test(continuation) || /^\s*[-*]\s+/.test(continuation) || /^\s*```/.test(continuation)) break;
+      titleParts.push(continuation.trim());
+      bodyStart += 1;
+    }
+    const labelId = action.label.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || actionIndex + 1;
+    const baseId = `action-${labelId}${sectionIndex ? `-${sectionIndex + 1}` : ""}`;
+    const duplicate = ids.get(baseId) || 0;
+    ids.set(baseId, duplicate + 1);
+    return {
+      ...action,
+      id: duplicate ? `${baseId}-${sectionIndex + 1}-${duplicate + 1}` : baseId,
+      title: titleParts.join(" ") || action.label,
+      body: lines.slice(bodyStart, nextStart),
+    };
+  });
+
+  const intro = prdWorkflowReviewMarkdownLinesToHtml(lines.slice(0, actionStarts[0].index));
+  const navigation = actions.length > 1
+    ? `<nav class="action-index" aria-label="Action 快速跳转"><span class="action-index__label">快速跳转</span>${actions.map((action) => `<a href="#${htmlEscapeAttribute(action.id)}">${htmlEscapeAttribute(action.label)}</a>`).join("")}</nav>`
+    : "";
+  const cards = actions.map((action) => {
+    const status = action.checked === null
+      ? ""
+      : `<span class="action-card__status${action.checked ? " is-complete" : ""}">${action.checked ? "已完成" : "待完成"}</span>`;
+    const body = prdWorkflowReviewMarkdownLinesToHtml(action.body);
+    return `<section class="action-card${action.checked ? " is-complete" : ""}" id="${htmlEscapeAttribute(action.id)}">
+  <div class="action-card__header">
+    <span class="action-card__index">${htmlEscapeAttribute(action.label)}</span>
+    <h3 class="action-card__title">${prdWorkflowReviewInlineMarkdown(action.title)}</h3>
+    ${status}
+  </div>
+  <div class="action-card__body">${body}</div>
+</section>`;
+  }).join("\n");
+  return [intro, navigation, cards].filter(Boolean).join("\n");
+}
+
+function prdWorkflowReviewBodyToHtml(body) {
+  const lines = String(body || "").replace(/\r\n/g, "\n").split("\n");
+  const html = [];
+  let cursor = 0;
+  let sectionIndex = 0;
+  while (cursor < lines.length) {
+    const actionsHeading = prdWorkflowReviewIsActionsHeading(lines[cursor]);
+    if (!actionsHeading) {
+      const nextHeading = lines.findIndex((line, index) => index > cursor && prdWorkflowReviewIsActionsHeading(line));
+      const end = nextHeading >= 0 ? nextHeading : lines.length;
+      html.push(prdWorkflowReviewMarkdownLinesToHtml(lines.slice(cursor, end)));
+      cursor = end;
+      continue;
+    }
+    let end = cursor + 1;
+    while (end < lines.length) {
+      const heading = String(lines[end] || "").trim().match(/^(#{1,6})\s+/);
+      if (heading && heading[1].length <= actionsHeading.level) break;
+      end += 1;
+    }
+    html.push(prdWorkflowReviewMarkdownLinesToHtml([lines[cursor]]));
+    html.push(prdWorkflowReviewRenderActionSection(lines.slice(cursor + 1, end), sectionIndex));
+    sectionIndex += 1;
+    cursor = end;
+  }
+  return html.filter(Boolean).join("\n");
+}
+
+export function prdWorkflowReviewMarkdownToHtml(markdown) {
+  const { frontmatter, body } = prdWorkflowReviewSplitFrontmatter(markdown);
+  return [
+    prdWorkflowReviewRenderFrontmatter(frontmatter),
+    prdWorkflowReviewBodyToHtml(body),
+  ].filter(Boolean).join("\n");
+}
+
+function prdWorkflowReviewExtractPageTitle(markdown, fallbackTitle) {
+  const { frontmatter, body } = prdWorkflowReviewSplitFrontmatter(markdown);
+  const lines = String(body || "").replace(/\r\n/g, "\n").split("\n");
+  const firstContentIndex = lines.findIndex((line) => String(line || "").trim());
+  const heading = firstContentIndex >= 0
+    ? String(lines[firstContentIndex] || "").trim().match(/^#\s+(.+)$/)
+    : null;
+  if (!heading) {
+    return {
+      markdown: String(markdown || ""),
+      title: String(fallbackTitle || "PRD Workflow Review"),
+    };
+  }
+
+  lines.splice(firstContentIndex, 1);
+  const markdownTitle = prdWorkflowReviewNormalizeText(heading[1])
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+    .replace(/[`*_~]/g, "")
+    .trim();
+  const bodyWithoutTitle = lines.join("\n").replace(/^\n+/, "");
+  return {
+    markdown: [
+      frontmatter ? `---\n${frontmatter}\n---` : "",
+      bodyWithoutTitle,
+    ].filter(Boolean).join("\n\n"),
+    title: markdownTitle || String(fallbackTitle || "PRD Workflow Review"),
+  };
 }
 
-function prdWorkflowReviewHtml(title, markdown, meta = {}) {
-  const escapedTitle = htmlEscapeAttribute(title || "PRD Workflow Review");
+export function prdWorkflowReviewHtml(title, markdown, meta = {}) {
+  const page = prdWorkflowReviewExtractPageTitle(markdown, title);
+  const escapedTitle = htmlEscapeAttribute(page.title);
   const escapedMeta = htmlEscapeAttribute([
     meta.tapdId ? `TAPD ${meta.tapdId}` : "",
     meta.stage ? `stage ${meta.stage}` : "",
@@ -7492,7 +7652,7 @@ function prdWorkflowReviewHtml(title, markdown, meta = {}) {
     meta.persistence ? `persistence ${meta.persistence}` : "",
   ].filter(Boolean).join(" · ");
   const escapedLifecycle = htmlEscapeAttribute(lifecycle);
-  const renderedMarkdown = prdWorkflowReviewMarkdownToHtml(markdown || "");
+  const renderedMarkdown = prdWorkflowReviewMarkdownToHtml(page.markdown);
   const rawHref = htmlEscapeAttribute(meta.rawHref || "?raw=1");
   return `<!doctype html>
 <html lang="zh-CN" data-theme="dark">
@@ -7504,57 +7664,80 @@ function prdWorkflowReviewHtml(title, markdown, meta = {}) {
     :root {
       color-scheme: dark;
       font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-      --bg: #0b1020;
-      --bg-radial: rgba(124,58,237,.18);
-      --panel: rgba(15,23,42,.68);
-      --panel-strong: rgba(15,23,42,.88);
-      --panel-soft: rgba(30,41,59,.74);
-      --border: rgba(148,163,184,.20);
-      --border-soft: rgba(148,163,184,.14);
+      --bg: #1a1b26;
+      --panel: #1f2335;
+      --panel-strong: #24283b;
+      --panel-soft: #292e42;
+      --border: #3b4261;
+      --border-soft: #30364f;
       --text: #e5e7eb;
-      --heading: #f8fafc;
-      --muted: #94a3b8;
-      --body: #dbe4f0;
-      --link: #c4b5fd;
-      --button: rgba(124,58,237,.16);
-      --button-text: #ddd6fe;
-      --code-bg: rgba(2,6,23,.58);
-      --code-block: rgba(2,6,23,.72);
-      --shadow: rgba(0,0,0,.28);
+      --heading: #f4f4f5;
+      --muted: #8b90a0;
+      --body: #d4d4d8;
+      --link: #7dcfff;
+      --interactive: #7aa2f7;
+      --purple: #bb9af7;
+      --button: #24283b;
+      --button-text: #cbd0da;
+      --code-bg: #292e42;
+      --code-inline: #7dcfff;
+      --code-block: #16161e;
+      --code-block-text: #e5e7eb;
+      --action-bg: #1f2335;
+      --action-header: #24283b;
+      --pending-bg: rgba(224,175,104,.10);
+      --pending-border: rgba(224,175,104,.34);
+      --pending-text: #e0af68;
+      --complete-bg: rgba(158,206,106,.10);
+      --complete-border: rgba(158,206,106,.34);
+      --complete-text: #9ece6a;
+      --shadow: rgba(9,10,15,.28);
       background: var(--bg);
     }
     :root[data-theme="light"] {
       color-scheme: light;
-      --bg: #f8fafc;
-      --bg-radial: rgba(124,58,237,.12);
-      --panel: rgba(255,255,255,.92);
-      --panel-strong: rgba(255,255,255,.98);
-      --panel-soft: rgba(241,245,249,.96);
-      --border: rgba(100,116,139,.24);
-      --border-soft: rgba(100,116,139,.18);
-      --text: #0f172a;
-      --heading: #020617;
-      --muted: #64748b;
-      --body: #1e293b;
-      --link: #6d28d9;
-      --button: rgba(124,58,237,.10);
-      --button-text: #4c1d95;
-      --code-bg: rgba(226,232,240,.76);
-      --code-block: rgba(241,245,249,.92);
-      --shadow: rgba(15,23,42,.10);
+      --bg: #e1e2e7;
+      --panel: #f3f3f5;
+      --panel-strong: #e9e9ed;
+      --panel-soft: #dcdfe7;
+      --border: #c8cad4;
+      --border-soft: #d5d7df;
+      --text: #4c505e;
+      --heading: #343b58;
+      --muted: #7f849c;
+      --body: #4c505e;
+      --link: #007197;
+      --interactive: #2e7de9;
+      --purple: #7847bd;
+      --button: #e7e8ed;
+      --button-text: #4c505e;
+      --code-bg: #dcdfe7;
+      --code-inline: #007197;
+      --code-block: #d5d8e1;
+      --code-block-text: #343b58;
+      --action-bg: #f3f3f5;
+      --action-header: #e9e9ed;
+      --pending-bg: rgba(177,92,0,.08);
+      --pending-border: rgba(177,92,0,.28);
+      --pending-text: #9a5200;
+      --complete-bg: rgba(88,117,57,.10);
+      --complete-border: rgba(88,117,57,.28);
+      --complete-text: #587539;
+      --shadow: rgba(52,59,88,.10);
     }
     *, *::before, *::after { box-sizing: border-box; }
     html, body { overflow-x: hidden; }
-    body { margin: 0; min-height: 100vh; background: radial-gradient(circle at top left, var(--bg-radial), transparent 34rem), var(--bg); color: var(--text); }
-    main { width: min(100%, 1120px); margin: 0 auto; padding: 40px 24px 72px; min-width: 0; }
+    body { margin: 0; min-height: 100vh; background: var(--bg); color: var(--text); }
+    main { width: min(100%, 1180px); margin: 0 auto; padding: 40px 24px 72px; min-width: 0; }
     header { display: flex; align-items: flex-start; justify-content: space-between; gap: 1rem; margin-bottom: 22px; }
-    h1 { margin: 0 0 10px; font-size: clamp(28px, 5vw, 56px); line-height: 1.05; letter-spacing: 0; }
+    h1 { margin: 0 0 10px; font-size: clamp(28px, 4vw, 44px); line-height: 1.12; letter-spacing: -.015em; }
     .meta { margin: 0; color: var(--muted); font-size: 14px; }
     .toolbar { flex: 0 0 auto; display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 10px; }
-    .raw, .theme-toggle { border: 1px solid rgba(124,58,237,.34); border-radius: 999px; color: var(--button-text); background: var(--button); padding: 9px 14px; text-decoration: none; font-size: 13px; font-weight: 800; line-height: 1.2; }
+    .raw, .theme-toggle { border: 1px solid var(--border); border-radius: 999px; color: var(--button-text); background: var(--button); padding: 9px 14px; text-decoration: none; font-size: 13px; font-weight: 800; line-height: 1.2; }
+    .raw:hover, .theme-toggle:hover { border-color: var(--interactive); color: var(--link); }
     .theme-toggle { cursor: pointer; font-family: inherit; }
-    .lifecycle { margin-top: 10px; display: inline-flex; max-width: 100%; border: 1px solid rgba(124,58,237,.30); border-radius: 999px; background: rgba(124,58,237,.12); color: var(--button-text); padding: 6px 10px; font-size: 12px; font-weight: 800; line-height: 1.35; overflow-wrap: anywhere; }
-    article { min-width: 0; border: 1px solid var(--border); border-radius: 14px; background: var(--panel); box-shadow: 0 28px 80px var(--shadow); padding: clamp(20px, 4vw, 34px); }
+    .lifecycle { margin-top: 10px; display: inline-flex; max-width: 100%; border: 1px solid var(--border); border-radius: 999px; background: var(--button); color: var(--muted); padding: 6px 10px; font-size: 12px; font-weight: 800; line-height: 1.35; overflow-wrap: anywhere; }
+    article { min-width: 0; border: 1px solid var(--border); border-radius: 14px; background: var(--panel); box-shadow: 0 18px 50px var(--shadow); padding: clamp(20px, 4vw, 34px); }
     article > *:first-child { margin-top: 0; }
     article > *:last-child { margin-bottom: 0; }
     h2, h3, h4, h5, h6 { margin: 1.7em 0 .65em; line-height: 1.25; letter-spacing: 0; color: var(--heading); overflow-wrap: anywhere; }
@@ -7565,10 +7748,10 @@ function prdWorkflowReviewHtml(title, markdown, meta = {}) {
     ul { margin: .65rem 0 1rem; padding-left: 1.35rem; }
     li { margin: .28rem 0; color: var(--body); }
     li input { margin-right: .38rem; transform: translateY(1px); }
-    code { display: inline; max-width: 100%; border: 1px solid var(--border-soft); border-radius: 6px; background: var(--code-bg); color: var(--heading); padding: .1rem .34rem; font-family: "SFMono-Regular", Consolas, monospace; font-size: .92em; white-space: normal; overflow-wrap: anywhere; word-break: break-word; }
+    code { display: inline; max-width: 100%; border: 1px solid var(--border-soft); border-radius: 6px; background: var(--code-bg); color: var(--code-inline); padding: .1rem .34rem; font-family: "SFMono-Regular", Consolas, monospace; font-size: .92em; white-space: normal; overflow-wrap: anywhere; word-break: break-word; }
     pre { max-width: 100%; overflow: auto; border: 1px solid var(--border); border-radius: 10px; background: var(--code-block); padding: 16px; line-height: 1.65; }
-    pre code { border: 0; background: transparent; padding: 0; white-space: pre; overflow-wrap: normal; word-break: normal; }
-    blockquote { margin: 1rem 0; border-left: 3px solid rgba(124,58,237,.72); background: rgba(124,58,237,.10); padding: .75rem 1rem; color: var(--body); }
+    pre code { border: 0; background: transparent; color: var(--code-block-text); padding: 0; white-space: pre; overflow-wrap: normal; word-break: normal; }
+    blockquote { margin: 1rem 0; border-left: 3px solid var(--purple); background: var(--panel-soft); padding: .75rem 1rem; color: var(--body); }
     a { color: var(--link); text-decoration-thickness: .08em; text-underline-offset: .16em; overflow-wrap: anywhere; }
     .table-wrap { max-width: 100%; overflow-x: auto; margin: 1rem 0 1.25rem; border: 1px solid var(--border-soft); border-radius: 10px; background: var(--panel-strong); }
     table { width: 100%; max-width: 100%; border-collapse: collapse; table-layout: fixed; }
@@ -7580,7 +7763,34 @@ function prdWorkflowReviewHtml(title, markdown, meta = {}) {
     .frontmatter table { min-width: 0; margin-top: .7rem; }
     .frontmatter th { width: min(34%, 12rem); background: var(--panel-soft); color: var(--body); }
     .frontmatter-list { margin: 0; padding-left: 1.1rem; }
-    @media (max-width: 720px) { main { padding: 28px 14px 48px; } header { display: block; } .toolbar { justify-content: flex-start; margin-top: 14px; } article { padding: 18px; } th, td { padding: .58rem .65rem; } }
+    .action-index { position: sticky; top: 10px; z-index: 4; display: flex; align-items: center; flex-wrap: wrap; gap: 8px; margin: 1rem 0 1.25rem; border: 1px solid var(--border); border-radius: 12px; background: var(--panel-strong); box-shadow: 0 8px 22px var(--shadow); padding: 10px 12px; }
+    .action-index__label { margin-right: 2px; color: var(--muted); font-size: 12px; font-weight: 800; }
+    .action-index a { min-width: 38px; border: 1px solid color-mix(in srgb, var(--interactive) 38%, var(--border)); border-radius: 999px; background: color-mix(in srgb, var(--interactive) 10%, var(--button)); color: var(--interactive); padding: 5px 10px; text-align: center; text-decoration: none; font-size: 12px; font-weight: 900; }
+    .action-index a:hover { border-color: var(--link); background: color-mix(in srgb, var(--interactive) 18%, var(--button)); color: var(--link); }
+    .action-card { scroll-margin-top: 78px; margin: 0 0 20px; overflow: hidden; border: 1px solid var(--border); border-radius: 12px; background: var(--action-bg); box-shadow: 0 8px 24px var(--shadow); }
+    .action-card:target { border-color: var(--interactive); box-shadow: 0 0 0 2px color-mix(in srgb, var(--interactive) 18%, transparent), 0 8px 24px var(--shadow); }
+    .action-card__header { display: grid; grid-template-columns: auto minmax(0, 1fr) auto; align-items: start; gap: 12px; border-bottom: 1px solid var(--border-soft); background: var(--action-header); padding: 16px 18px; }
+    .action-card__index { display: inline-grid; place-items: center; min-width: 42px; min-height: 30px; border: 1px solid color-mix(in srgb, var(--interactive) 34%, var(--border)); border-radius: 8px; background: color-mix(in srgb, var(--interactive) 10%, var(--panel-soft)); color: var(--interactive); font: 900 13px/1 "SFMono-Regular", Consolas, monospace; }
+    .action-card__title { margin: 3px 0 0; font-size: 16px; line-height: 1.55; letter-spacing: 0; color: var(--heading); }
+    .action-card__status { margin-top: 2px; border: 1px solid var(--pending-border); border-radius: 999px; background: var(--pending-bg); color: var(--pending-text); padding: 5px 9px; font-size: 11px; font-weight: 900; white-space: nowrap; }
+    .action-card__status.is-complete { border-color: var(--complete-border); background: var(--complete-bg); color: var(--complete-text); }
+    .action-card__body { padding: 15px 20px 20px; }
+    .action-card__body > *:first-child { margin-top: 0; }
+    .action-card__body > *:last-child { margin-bottom: 0; }
+    .action-card__body > ul { margin: 0 0 1rem; padding-left: 1.3rem; }
+    .action-card__body > ul > li { margin: .55rem 0; padding-left: .15rem; }
+    .action-card__body pre { margin: .9rem 0 1.1rem; }
+    @media (max-width: 720px) {
+      main { padding: 28px 14px 48px; }
+      header { display: block; }
+      .toolbar { justify-content: flex-start; margin-top: 14px; }
+      article { padding: 18px; }
+      th, td { padding: .58rem .65rem; }
+      .action-index { top: 6px; }
+      .action-card__header { grid-template-columns: auto minmax(0, 1fr); padding: 14px; }
+      .action-card__status { grid-column: 2; justify-self: start; }
+      .action-card__body { padding: 14px 16px 18px; }
+    }
   </style>
 </head>
 <body>
@@ -9026,6 +9236,14 @@ function workspaceRunEntryKey(scopeKey, runId) {
   return `${scopeKey}:${String(runId || "").trim() || runLedgerId("workspace")}`;
 }
 
+function workspaceRunControl(abortController) {
+  return createWorkspaceRunController({
+    abortController,
+    gracefulTimeoutMs: 3_000,
+    forceTimeoutMs: 1_500,
+  });
+}
+
 function workspaceRuntimeNodeLabel(graph, nodeId, fallback = "Workspace Run") {
   const id = String(nodeId || "").trim();
   const instance = graph?.instances && typeof graph.instances === "object" ? graph.instances[id] : null;
@@ -9463,11 +9681,12 @@ async function runWorkspaceScheduledEntry(root, entry) {
   }
 
   const controller = new AbortController();
+  const runControl = workspaceRunControl(controller);
   const runKey = workspaceRunEntryKey(scopeKey, runId);
   const runEntry = {
     scopeKey,
     controller,
-    child: null,
+    runControl,
     runId,
     userId: userCtx.userId,
     username: String(authUser.username || entry.username || userCtx.userId),
@@ -9478,11 +9697,6 @@ async function runWorkspaceScheduledEntry(root, entry) {
     plannedNodeIds,
     startedAt: Date.now(),
     scheduled: true,
-    stopChild() {
-      if (this.child && !this.child.killed) {
-        try { this.child.kill("SIGTERM"); } catch (_) {}
-      }
-    },
   };
   activeWorkspaceRuns.set(runKey, runEntry);
   appendWorkspaceRunStarted(runEntry);
@@ -9496,9 +9710,8 @@ async function runWorkspaceScheduledEntry(root, entry) {
     timezone: config.timezone,
     lastError: "",
   });
-  const setActiveChild = (child) => {
-    runEntry.child = child || null;
-    if (controller.signal.aborted) runEntry.stopChild();
+  const setActiveChild = (child, childOptions = {}) => {
+    runControl.setChild(child, childOptions);
   };
   try {
     const result = await runWorkspaceGraph(root, scoped.root, {
@@ -9531,23 +9744,28 @@ async function runWorkspaceScheduledEntry(root, entry) {
   } catch (e) {
     const endedAt = Date.now();
     const error = (e && e.message) || String(e);
-    appendWorkspaceRunFinished({ ...runEntry, endedAt, durationMs: endedAt - runEntry.startedAt }, "failed");
-    appendWorkspaceRunLogEvent(runLog.runId, { type: "error", error, ts: endedAt });
-    finishWorkspaceRunLogSession(runLog.runId, "failed", {
+    const stopped = isWorkspaceRunAbortError(e) || controller.signal.aborted;
+    const finalStatus = stopped ? "stopped" : "failed";
+    appendWorkspaceRunFinished({ ...runEntry, endedAt, durationMs: endedAt - runEntry.startedAt }, finalStatus);
+    appendWorkspaceRunLogEvent(runLog.runId, stopped
+      ? { type: "stopped", message: "Workspace run stopped", ts: endedAt }
+      : { type: "error", error, ts: endedAt });
+    finishWorkspaceRunLogSession(runLog.runId, finalStatus, {
       endedAt,
       durationMs: endedAt - runEntry.startedAt,
       runNodeId: targetRunNodeId,
-      error,
+      error: stopped ? "" : error,
     });
     updateWorkspaceScheduleEntry(entry.key, {
       nextRunAt: computeNext(config),
       lastFinishedAt: endedAt,
-      lastStatus: "failed",
-      lastError: error,
-      lastErrorAt: endedAt,
+      lastStatus: finalStatus,
+      lastError: stopped ? "" : error,
+      ...(stopped ? {} : { lastErrorAt: endedAt }),
     });
-    log.info(`[workspace-scheduler] failed ${entry.flowId}/${targetRunNodeId}: ${error}`);
+    if (!stopped) log.info(`[workspace-scheduler] failed ${entry.flowId}/${targetRunNodeId}: ${error}`);
   } finally {
+    runControl.finish(controller.signal.aborted ? "stopped" : "finished");
     if (activeWorkspaceRuns.get(runKey) === runEntry) activeWorkspaceRuns.delete(runKey);
   }
 }
@@ -11516,13 +11734,14 @@ export function startUiServer({
           return;
         }
         const controller = new AbortController();
+        const runControl = workspaceRunControl(controller);
         const runId = String(payload.runSessionId || payload.runId || "").trim() || runLedgerId("workspace");
         const runKey = workspaceRunEntryKey(scopeKey, runId);
         const runAlias = String(payload.runAlias || "").trim() || workspaceRuntimeNodeLabel(runtimeGraph, runNodeId, "Workspace Run");
         const runEntry = {
           scopeKey,
           controller,
-          child: null,
+          runControl,
           runId,
           userId: String(userCtx.userId || ""),
           username: String(authUser?.username || userCtx.userId || ""),
@@ -11532,11 +11751,6 @@ export function startUiServer({
           flowSource: scoped.flowSource || payload.flowSource || "user",
           plannedNodeIds,
           startedAt: Date.now(),
-          stopChild() {
-            if (this.child && !this.child.killed) {
-              try { this.child.kill("SIGTERM"); } catch (_) {}
-            }
-          },
         };
         const runLog = createWorkspaceRunLogSession({
           runId,
@@ -11553,11 +11767,11 @@ export function startUiServer({
         });
         activeWorkspaceRuns.set(runKey, runEntry);
         appendWorkspaceRunStarted(runEntry);
-        const setActiveChild = (child) => {
-          runEntry.child = child || null;
-          if (controller.signal.aborted) runEntry.stopChild();
+        const setActiveChild = (child, childOptions = {}) => {
+          runControl.setChild(child, childOptions);
         };
-        const clearActiveRun = () => {
+        const clearActiveRun = (status = "finished") => {
+          runControl.finish(status);
           if (activeWorkspaceRuns.get(runKey) === runEntry) activeWorkspaceRuns.delete(runKey);
         };
         if (wantsStream) {
@@ -11626,7 +11840,7 @@ export function startUiServer({
             }
             res.end();
           } finally {
-            clearActiveRun();
+            clearActiveRun(controller.signal.aborted ? "stopped" : "finished");
           }
           return;
         }
@@ -11684,7 +11898,7 @@ export function startUiServer({
             throw e;
           }
         } finally {
-          clearActiveRun();
+          clearActiveRun(controller.signal.aborted ? "stopped" : "finished");
         }
       } catch (e) {
         json(res, 500, { error: (e && e.message) || String(e) });
@@ -11750,6 +11964,7 @@ export function startUiServer({
       const entry = entries[0] || null;
       json(res, 200, {
         running: entries.length > 0,
+        state: entry?.runControl?.state || (entries.length > 0 ? "running" : "idle"),
         flowId,
         flowSource,
         runNodeId: entry?.runNodeId || "",
@@ -11762,6 +11977,7 @@ export function startUiServer({
           startedAt: item?.startedAt || null,
           plannedNodeIds: Array.isArray(item?.plannedNodeIds) ? item.plannedNodeIds : [],
           scheduled: item?.scheduled === true,
+          state: item?.runControl?.state || "running",
         })),
       });
       return;
@@ -11792,9 +12008,38 @@ export function startUiServer({
         json(res, 404, { error: "该 Workspace 未在运行" });
         return;
       }
-      try { entry.controller?.abort(); } catch (_) {}
-      try { entry.stopChild?.(); } catch (_) {}
-      json(res, 200, { ok: true, stopped: true });
+      appendWorkspaceRunLogEvent(entry.runId, {
+        type: "stop-requested",
+        runNodeId: entry.runNodeId || "",
+        ts: Date.now(),
+      });
+      const result = await entry.runControl.stop();
+      if (!result.stopped) {
+        appendWorkspaceRunLogEvent(entry.runId, {
+          type: "stop-failed",
+          runNodeId: entry.runNodeId || "",
+          reason: result.timedOut ? "timeout" : "unknown",
+          ts: Date.now(),
+        });
+        json(res, 409, {
+          error: "停止请求已发送，但运行进程未能退出",
+          ok: false,
+          stopped: false,
+          state: entry.runControl.state,
+        });
+        return;
+      }
+      appendWorkspaceRunLogEvent(entry.runId, {
+        type: "stop-completed",
+        runNodeId: entry.runNodeId || "",
+        forced: result.forced === true,
+        ts: Date.now(),
+      });
+      json(res, 200, {
+        ok: true,
+        stopped: true,
+        forced: result.forced === true,
+      });
       return;
     }