helixlife-v5-cli 1.1.8 → 1.2.0

package/lib/automation-overlay.browser.js

@@ -0,0 +1,76 @@
+(() => {
+  const ROOT_ID = '__helix_cli_automation_overlay';
+
+  function ensureOverlay() {
+    if (document.getElementById(ROOT_ID)) {
+      return window.__helixCliOverlay;
+    }
+
+    const root = document.createElement('div');
+    root.id = ROOT_ID;
+    root.setAttribute('data-helix-cli', 'automation-overlay');
+    root.setAttribute('aria-hidden', 'true');
+    root.style.cssText = [
+      'position:fixed',
+      'top:16px',
+      'right:16px',
+      'z-index:2147483647',
+      'pointer-events:none',
+      'box-sizing:border-box',
+      'max-width:280px',
+      'padding:10px 14px',
+      'border-radius:12px',
+      'background:#f5b942',
+      'color:#3d2b00',
+      'font:13px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"PingFang SC","Microsoft YaHei",sans-serif',
+      'box-shadow:0 4px 14px rgba(0,0,0,.18)',
+      'letter-spacing:.01em',
+    ].join(';');
+
+    const title = document.createElement('div');
+    title.dataset.line = 'title';
+    title.style.cssText = 'font-weight:600;margin-bottom:4px;word-break:break-all;';
+
+    const status = document.createElement('div');
+    status.dataset.line = 'status';
+    status.style.cssText = 'opacity:.92;';
+
+    const detail = document.createElement('div');
+    detail.dataset.line = 'detail';
+    detail.style.cssText = 'opacity:.78;margin-top:2px;font-size:12px;';
+
+    root.append(title, status, detail);
+    (document.body || document.documentElement).appendChild(root);
+
+    const api = {
+      update(payload = {}) {
+        const el = document.getElementById(ROOT_ID);
+        if (!el) return;
+        const t = el.querySelector('[data-line="title"]');
+        const s = el.querySelector('[data-line="status"]');
+        const d = el.querySelector('[data-line="detail"]');
+        if (t) t.textContent = payload.title || 'helixlife-v5-cli';
+        if (s) s.textContent = payload.status || '机器自动化';
+        if (d) d.textContent = payload.detail || 'CLI 操作中';
+        el.style.display = payload.hidden ? 'none' : 'block';
+      },
+    };
+
+    window.__helixCliOverlay = api;
+    return api;
+  }
+
+  function boot() {
+    ensureOverlay().update({
+      title: 'helixlife-v5-cli',
+      status: '机器自动化',
+      detail: '会话已就绪',
+    });
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', boot, { once: true });
+  } else {
+    boot();
+  }
+})();

package/lib/automation-overlay.init.js

@@ -0,0 +1,78 @@
+// Playwright browser init script: inject automation status overlay on every document.
+// Source is duplicated from automation-overlay.browser.js (keep in sync when editing).
+(() => {
+  const ROOT_ID = '__helix_cli_automation_overlay';
+
+  function ensureOverlay() {
+    if (document.getElementById(ROOT_ID)) {
+      return window.__helixCliOverlay;
+    }
+
+    const root = document.createElement('div');
+    root.id = ROOT_ID;
+    root.setAttribute('data-helix-cli', 'automation-overlay');
+    root.setAttribute('aria-hidden', 'true');
+    root.style.cssText = [
+      'position:fixed',
+      'top:16px',
+      'right:16px',
+      'z-index:2147483647',
+      'pointer-events:none',
+      'box-sizing:border-box',
+      'max-width:280px',
+      'padding:10px 14px',
+      'border-radius:12px',
+      'background:#f5b942',
+      'color:#3d2b00',
+      'font:13px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"PingFang SC","Microsoft YaHei",sans-serif',
+      'box-shadow:0 4px 14px rgba(0,0,0,.18)',
+      'letter-spacing:.01em',
+    ].join(';');
+
+    const title = document.createElement('div');
+    title.dataset.line = 'title';
+    title.style.cssText = 'font-weight:600;margin-bottom:4px;word-break:break-all;';
+
+    const status = document.createElement('div');
+    status.dataset.line = 'status';
+    status.style.cssText = 'opacity:.92;';
+
+    const detail = document.createElement('div');
+    detail.dataset.line = 'detail';
+    detail.style.cssText = 'opacity:.78;margin-top:2px;font-size:12px;';
+
+    root.append(title, status, detail);
+    (document.body || document.documentElement).appendChild(root);
+
+    const api = {
+      update(payload = {}) {
+        const el = document.getElementById(ROOT_ID);
+        if (!el) return;
+        const t = el.querySelector('[data-line="title"]');
+        const s = el.querySelector('[data-line="status"]');
+        const d = el.querySelector('[data-line="detail"]');
+        if (t) t.textContent = payload.title || 'helixlife-v5-cli';
+        if (s) s.textContent = payload.status || '机器自动化';
+        if (d) d.textContent = payload.detail || 'CLI 操作中';
+        el.style.display = payload.hidden ? 'none' : 'block';
+      },
+    };
+
+    window.__helixCliOverlay = api;
+    return api;
+  }
+
+  function boot() {
+    ensureOverlay().update({
+      title: 'helixlife-v5-cli',
+      status: '机器自动化',
+      detail: '会话已就绪',
+    });
+  }
+
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', boot, { once: true });
+  } else {
+    boot();
+  }
+})();

package/lib/automation-overlay.js

@@ -0,0 +1,238 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const OVERLAY_SKIP_COMMANDS = new Set([
+  "run-code",
+  "list",
+  "close",
+  "close-all",
+  "kill-all",
+  "detach",
+  "delete-data",
+  "config-print",
+  "cookie-list",
+  "cookie-get",
+  "cookie-set",
+  "cookie-delete",
+  "cookie-clear",
+  "localstorage-list",
+  "localstorage-get",
+  "localstorage-set",
+  "localstorage-delete",
+  "localstorage-clear",
+  "sessionstorage-list",
+  "sessionstorage-get",
+  "sessionstorage-set",
+  "sessionstorage-delete",
+  "sessionstorage-clear",
+  "route-list",
+  "tab-list",
+  "console",
+  "network",
+  "state-save",
+  "state-load",
+  "tracing-start",
+  "tracing-stop",
+  "video-start",
+  "video-stop",
+  "video-chapter",
+  "highlight",
+  "generate-locator",
+  "show",
+]);
+
+const OVERLAY_SESSION_OPEN_COMMANDS = new Set(["open", "attach"]);
+
+let cachedBrowserScript = null;
+
+function isOverlayEnabled() {
+  const flag = process.env.HELIX_AUTOMATION_OVERLAY;
+  if (flag === "0" || flag === "false" || flag === "off") {
+    return false;
+  }
+  return true;
+}
+
+function resolveCliConfigPath() {
+  if (process.env.HELIX_CLI_CONFIG) {
+    return path.resolve(process.env.HELIX_CLI_CONFIG);
+  }
+  const initScriptPath = path.join(__dirname, "automation-overlay.init.js");
+  const runtimeConfigPath = path.join(__dirname, "cli.runtime.config.json");
+  const config = {
+    browser: {
+      initScript: [initScriptPath],
+    },
+  };
+  fs.writeFileSync(
+    runtimeConfigPath,
+    `${JSON.stringify(config, null, 2)}\n`,
+    "utf8",
+  );
+  return runtimeConfigPath;
+}
+
+function getBrowserOverlayScript() {
+  if (!cachedBrowserScript) {
+    cachedBrowserScript = fs.readFileSync(
+      path.join(__dirname, "automation-overlay.browser.js"),
+      "utf8",
+    );
+  }
+  return cachedBrowserScript;
+}
+
+function stripLeadingFlags(tokens) {
+  let i = 0;
+  while (i < tokens.length) {
+    const t = tokens[i];
+    if (t === "--raw" || t === "--json") {
+      i += 1;
+      continue;
+    }
+    if (t.startsWith("-s=")) {
+      i += 1;
+      continue;
+    }
+    break;
+  }
+  return tokens.slice(i);
+}
+
+function truncate(text, max = 48) {
+  const s = String(text || "")
+    .replace(/\s+/g, " ")
+    .trim();
+  if (s.length <= max) return s;
+  return `${s.slice(0, max - 1)}…`;
+}
+
+function describeOverlayPayload(tokens, phase) {
+  const core = stripLeadingFlags(tokens);
+  const command = core[0];
+  if (!command) {
+    return {
+      title: "helixlife-v5-cli",
+      status: phase === "after" ? "已完成" : "执行中...",
+      detail: "CLI自动化操作中",
+    };
+  }
+
+  const args = core.slice(1).filter((t) => !t.startsWith("--"));
+  let title = command;
+  let detail = args.length ? truncate(args.join(" ")) : "CLI自动化操作中";
+
+  switch (command) {
+    case "click":
+    case "dblclick":
+    case "hover":
+    case "check":
+    case "uncheck":
+      title = command;
+      detail = truncate(args[0] || "元素", 40);
+      break;
+    case "fill":
+      title = "fill";
+      detail = truncate(args[0] || "输入框", 40);
+      break;
+    case "type":
+      title = "type";
+      detail = truncate(args[0] || "", 32);
+      break;
+    case "goto":
+    case "open":
+      title = command;
+      detail = truncate(args[0] || "页面", 56);
+      break;
+    case "snapshot":
+      title = "snapshot";
+      detail = "页面验收";
+      break;
+    case "run-code":
+      title = "run-code";
+      detail = truncate(args[0] || "脚本", 40);
+      break;
+    case "press":
+      title = "press";
+      detail = truncate(args[0] || "按键", 24);
+      break;
+    case "select":
+      title = "select";
+      detail = truncate(args.join(" "), 40);
+      break;
+    case "upload":
+      title = "upload";
+      detail = truncate(args[0] || "文件", 40);
+      break;
+    case "eval":
+      title = "eval";
+      detail = "读取页面状态";
+      break;
+    default:
+      title = command;
+      break;
+  }
+
+  return {
+    title,
+    status: phase === "after" ? "已完成" : "执行中...",
+    detail: phase === "after" ? "CLI自动化操作中" : detail || "CLI自动化操作中",
+  };
+}
+
+function shouldUpdateOverlay(tokens) {
+  const core = stripLeadingFlags(tokens);
+  const command = core[0];
+  if (!command) return false;
+  if (OVERLAY_SKIP_COMMANDS.has(command)) return false;
+  return true;
+}
+
+function shouldInjectOpenConfig(tokens) {
+  const core = stripLeadingFlags(tokens);
+  const command = core[0];
+  if (!command || !OVERLAY_SESSION_OPEN_COMMANDS.has(command)) return false;
+  return !tokens.some((t) => t === "--config" || t.startsWith("--config="));
+}
+
+function injectOpenConfig(tokens) {
+  if (!isOverlayEnabled() || !shouldInjectOpenConfig(tokens)) {
+    return tokens;
+  }
+  const configPath = resolveCliConfigPath();
+  const next = [...tokens];
+  const core = stripLeadingFlags(tokens);
+  const insertAt = tokens.indexOf(core[0]);
+  next.splice(insertAt + 1, 0, `--config=${configPath}`);
+  return next;
+}
+
+function buildOverlayRunCode(payload) {
+  const browserScript = getBrowserOverlayScript();
+  const payloadJson = JSON.stringify(payload);
+  return [
+    "async page => {",
+    `  const browserScript = ${JSON.stringify(browserScript)};`,
+    `  const payload = ${payloadJson};`,
+    "  await page.evaluate(({ script, data }) => {",
+    "    // eslint-disable-next-line no-eval",
+    "    eval(script);",
+    "    if (window.__helixCliOverlay) window.__helixCliOverlay.update(data);",
+    "  }, { script: browserScript, data: payload });",
+    "}",
+  ].join("\n");
+}
+
+module.exports = {
+  OVERLAY_SKIP_COMMANDS,
+  isOverlayEnabled,
+  resolveCliConfigPath,
+  stripLeadingFlags,
+  describeOverlayPayload,
+  shouldUpdateOverlay,
+  shouldInjectOpenConfig,
+  injectOpenConfig,
+  buildOverlayRunCode,
+};

package/lib/cli.js

@@ -4,6 +4,13 @@ const path = require('node:path');
 const { spawnSync } = require('node:child_process');
 
 const PACKAGE_JSON = require(path.join(__dirname, '..', 'package.json'));
+const {
+  isOverlayEnabled,
+  injectOpenConfig,
+  shouldUpdateOverlay,
+  describeOverlayPayload,
+  buildOverlayRunCode,
+} = require('./automation-overlay');
 
 /** 默认快照/下载等工作区目录名（相对 cwd），替代引擎默认的 .playwright-cli */
 const DEFAULT_OUTPUT_DIR_NAME = 'helixlife-v5-cli';
@@ -35,9 +42,9 @@ function buildChildEnv() {
  * 将参数原样交给底层浏览器自动化引擎，返回子进程退出码。
  * 使用 node 直接执行入口脚本，避免依赖 npx、Shell 与 PATH，在 Windows / macOS 上一致。
  */
-function runPlaywrightCliPassthrough(args) {
+function runPlaywrightCliPassthrough(args, options = {}) {
   const result = spawnSync(process.execPath, [playwrightCliEntry(), ...args], {
-    stdio: 'inherit',
+    stdio: options.quiet ? ['ignore', 'ignore', 'ignore'] : 'inherit',
     env: buildChildEnv(),
     windowsHide: true,
   });
@@ -51,6 +58,27 @@ function runPlaywrightCliPassthrough(args) {
   return result.status === null || result.status === undefined ? 1 : result.status;
 }
 
+function updateAutomationOverlay(tokens, phase) {
+  if (!isOverlayEnabled() || !shouldUpdateOverlay(tokens)) {
+    return;
+  }
+  const payload = describeOverlayPayload(tokens, phase);
+  const code = buildOverlayRunCode(payload);
+  runPlaywrightCliPassthrough(['run-code', code], { quiet: true });
+}
+
+function runPlaywrightCliWithOverlay(tokens) {
+  const args = injectOpenConfig(tokens);
+  if (isOverlayEnabled() && shouldUpdateOverlay(args)) {
+    updateAutomationOverlay(args, 'before');
+  }
+  const code = runPlaywrightCliPassthrough(args);
+  if (code === 0 && isOverlayEnabled() && shouldUpdateOverlay(args)) {
+    updateAutomationOverlay(args, 'after');
+  }
+  return code;
+}
+
 function parseHelixFlags(tokens, startIndex) {
   const options = {
     headless: false,
@@ -114,6 +142,10 @@ function printHelp() {
   console.log(
     `  HELIX_OUTPUT_DIR / PLAYWRIGHT_MCP_OUTPUT_DIR（默认输出目录 <cwd>/${DEFAULT_OUTPUT_DIR_NAME}）`
   );
+  console.log(
+    '  HELIX_AUTOMATION_OVERLAY（设为 0/false/off 可关闭右上角机器操作浮层，默认开启）'
+  );
+  console.log('  HELIX_CLI_CONFIG（自定义 Playwright CLI 配置文件路径）');
 }
 
 function getBaseUrl() {
@@ -130,12 +162,12 @@ function helixHome(options) {
   if (!options.headless) {
     openArgs.push('--headed');
   }
-  const code = runPlaywrightCliPassthrough(openArgs);
+  const code = runPlaywrightCliWithOverlay(openArgs);
   if (code !== 0) {
     return code;
   }
   console.error(`[${PACKAGE_JSON.name}] opened: ${baseUrl}`);
-  return runPlaywrightCliPassthrough(['eval', 'document.title']);
+  return runPlaywrightCliWithOverlay(['eval', 'document.title']);
 }
 
 function helixDoctor(options) {
@@ -198,7 +230,7 @@ async function main(argv = process.argv) {
     return 2;
   }
 
-  return runPlaywrightCliPassthrough(tokens);
+  return runPlaywrightCliWithOverlay(tokens);
 }
 
 main.printHelp = printHelp;

package/lib/cli.runtime.config.json

@@ -0,0 +1,7 @@
+{
+  "browser": {
+    "initScript": [
+      "C:\\Users\\zouyh\\Desktop\\WorkSpace\\jieluoxuan\\cli\\helix-cli\\lib\\automation-overlay.init.js"
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helixlife-v5-cli",
-  "version": "1.1.8",
+  "version": "1.2.0",
   "description": "Helix（vip.helixlife.cn）精细化浏览器自动化命令行工具。",
   "main": "helix-cli.js",
   "bin": {

package/references/vip.helixlife.cn.site-ops.md

@@ -155,6 +155,11 @@
 | 对话 · 新建会话 | S-09 |
 | 工作站 · 新建任务弹窗 | S-10 |
 | 工作台 · 进入子工作台 | S-11 |
+| 工作台 · 综述全流程（拟定主题→精修） | WB-1 |
+| 工作台 · SCI 论著全流程 | WB-2 |
+| 工作台 · 国自然基金全流程 | WB-3 |
+| 工作台 · 临床申请书全流程 | WB-4 |
+| 工作台 · Meta（未上线） | WB-0 |
 | 应用 · 标准操作（搜索 / 级联分类 / 滚动加载 / 收藏 / 进入详情 / 多块复制 / mindmap） | S-12（细则 AP-1～AP-13 + 规约 A~H） |
 | 应用 · 取消收藏 · 二次确认弹窗 | AP-8（规约 E） |
 | 应用 · 多块输出 · 单块复制 vs 全部复制 | AP-10 / AP-11（规约 F） |
@@ -338,7 +343,154 @@ div.side-menu--item[to='/edu/courses']
 
 #### AI 工作台 `/workbench`
 
-卡片式入口（示例文案）：「SCI论著工作台」「综述工作台」「基金申请书工作台」 → `getByText('SCI论著工作台')` 等精确匹配。
+> **核验日期**：2026-06-02（有头会话 `helixlife-v5-cli`，已逐卡进入并完成各工具主流程点击验收）。下文 **WB-xx** 为可复用步骤编号；**禁止**依赖快照 `e*` 作为长期定位器。
+
+##### 门户与子工具索引（WB-0）
+
+| 首页卡片文案（`getByText(..., { exact: true })`） | 路由 slug | 首屏 `pathname` | 面包屑第二级文案 | 状态 |
+| --- | --- | --- | --- | --- |
+| 综述工作台 | `jova` | `/workbench/jova/topic` | 综述工作台 | 可用 |
+| SCI论著工作台 | `sci` | `/workbench/sci/topic` | SCI论著工作台 | 可用 |
+| 基金工作台 | `nsfc-v2` | `/workbench/nsfc-v2/topic` | 基金工作台 | 可用 |
+| 临床工作台 | `clinical` | `/workbench/clinical/topic` | 临床申请书工作台 | 可用 |
+| Meta工作台 | — | （点击后仍停留 `/workbench`） | — | **未上线**；副文案「Meta工作台正在开发中，敬请期待...」，**勿**当作可进入子路由 |
+
+**进入门户**：S-07 → `div.side-menu--item[to='/workbench']`，或已在站内时面包屑 `getByRole('navigation', { name: '面包屑导航' }).getByText('AI工作台', { exact: true })`。
+
+**进入某一子工具（S-11）**：在 `/workbench` 主内容区 `click` 对应卡片标题（精确匹配上表「首页卡片文案」）。验收：`location.pathname` 为 `/workbench/{slug}/topic`（Meta 除外）。
+
+**各子工具 URL 形态**（`{slug}` 见上表；`{step}` 为下节各工具步骤路径段）：
+
+```text
+/workbench/{slug}/topic
+/workbench/{slug}/outline
+/workbench/{slug}/proofread    # 仅 jova、nsfc-v2、clinical
+/workbench/{slug}/writing
+/workbench/nsfc-v2/hypothesis_confirm   # 基金专用
+```
+
+##### 子工具页通用壳（所有已上线 WB）
+
+| 区域 | 稳定定位 | 说明 |
+| --- | --- | --- |
+| 面包屑 · 回门户 | `getByRole('navigation', { name: '面包屑导航' }).getByText('AI工作台', { exact: true })` | 回到 `/workbench`，**优先**于侧栏再点一次「AI工作台」 |
+| 面包屑 · 回当前工具首页 | `getByRole('navigation', { name: '面包屑导航' }).getByText('<面包屑第二级文案>', { exact: true })` | 一般回到该工具 `topic` 步 |
+| 演示教程 | `getByText('演示教程', { exact: true })` | 打开 `dialog "演示教程"`（内嵌飞书 wiki `iframe`）；关闭：`getByRole('dialog', { name: '演示教程' }).getByRole('button', { name: 'Close' })`。教程打开时**勿**点击被 iframe 遮挡的页面按钮 |
+| 步骤条 | `getByText('<步骤名>', { exact: true })` | 仅展示进度；**不要**用步骤条 `goto` 跳步 |
+| 底栏免责声明 | 正文含 `内容由AI生成，仅供学习参考` | 无交互 |
+
+**页面内 Modal（Ant Design）**：全文生成确认、完成校对确认等须 `getByRole('dialog', { name: '…' })` + `getByRole('button', { name: '…' })`；**禁止** `dialog-accept` / `dialog-dismiss`（仅适用于原生 `alert`/`confirm`）。
+
+**生成等待**：出现「…生成中，请耐心等待 …%」或 Loading 时**禁止**连点主按钮；轮询 `eval` 直至底栏主按钮出现且 loading 文案消失，再 `snapshot` 一次验收。
+
+**下载类按钮**（`下载提纲` / `下载文档`）：会触发浏览器下载；向用户汇报须遵守本文 skill「下载行为 · 强制规则」两行绝对路径格式。
+
+---
+
+##### WB-1：综述工作台（`jova`）
+
+**步骤条（4 步）**：拟定主题 → 确认提纲 → 初稿校对 → 初稿精修。
+
+| 步骤 | `pathname` | 主要表单项 / 区块 | 底栏主按钮（`getByRole('button', …)`） |
+| --- | --- | --- | --- |
+| 拟定主题 | `/workbench/jova/topic` | **生成模式**（三选一，`click` 文案）：`短篇`（6000-10000字）、`中篇`（10000-15000字）、`长篇`（＞15000字）；**示例主题**列表 + `getByText('换一组', { exact: true })`；**综述主题** `getByRole('textbox', { name: '请输入综述主题概要内容' })`（上限 2000 字，界面显示 `0 / 2000`） | `继续编辑本地文档`；`生成提纲` |
+| 确认提纲 | `/workbench/jova/outline` | 左侧「论文提纲」树；节点行内为**无文案图标按钮**（增删改，需时用 `generate-locator` 固化，勿记 `e*`） | `返回主题`；`下载提纲`；`生成全文` |
+| 初稿校对 | `/workbench/jova/proofread` | 左目录 + 右正文；段落带「请校对本段内容」提示 | `返回提纲`；`下载文档`；`完成校对` |
+| 初稿精修 | `/workbench/jova/writing` | 左目录 + 中央 `textbox` 富文本；顶栏 **修订模式**（含接受/拒绝修订） | `返回提纲`；`修订模式` 切换钮（文案含 `接受修订` / `拒绝修订`）；`新建论文`；`下载文档` |
+
+**WB-1 关键动作**
+
+1. **示例主题填入**：`click` → `getByText('<示例标题>', { exact: true })` → 验收 textbox 已填入同标题。
+2. **生成提纲**：填主题后 `click` → `getByRole('button', { name: '生成提纲' })` → 验收 `/workbench/jova/outline`；等待「提纲内容生成中…」结束。
+3. **生成全文（含弹窗）**：`click` → `getByRole('button', { name: '生成全文' })` → `dialog "是否已完成提纲修改，继续生成全文"` 内：`getByText('中文'|'English', { exact: true })`；综述另须 `getByText('是'|'否', { exact: true })`（「需要中文文献」）；`click` → `getByRole('dialog', { name: '是否已完成提纲修改，继续生成全文' }).getByRole('button', { name: '确 认' })`（注意「确」「认」间有空格）。验收：`/workbench/jova/proofread`。
+4. **完成校对 → 精修**：`click` → `getByRole('button', { name: '完成校对' })` → 二次 `dialog` 文案「是否确认完成所有段落内容校对，进入全文编辑模式」→ `getByRole('button', { name: '确认' })`（无空格）。验收：`/workbench/jova/writing`。
+
+**取消全文生成弹窗**：同 dialog 内 `getByRole('button', { name: '取 消' })` 或 `Close`。
+
+---
+
+##### WB-2：SCI 论著工作台（`sci`）
+
+**步骤条（3 步，无「初稿校对」步）**：拟定主题 → 确认提纲 → 初稿精修。
+
+| 步骤 | `pathname` | 主要表单项 / 区块 | 底栏主按钮 |
+| --- | --- | --- | --- |
+| 拟定主题 | `/workbench/sci/topic` | **写作类型**：`SCI论文写作练习` / `SCI论文写作实操`；**文章模板**：`基础` / `临床` / `生信`（卡片，`locator('main').getByText('基础', { exact: true }).first()` 等）；**基础主题** `getByRole('textbox', { name: '请输入基础主题' })`（5000）；**方法和结果（选填）** + `从本地文件中提取方法和结果` / `从推荐文献中提取方法和结果` | `继续编辑本地文档`；`生成提纲` |
+| 确认提纲 | `/workbench/sci/outline` | 提纲树（结构同综述） | `返回主题`；`生成全文`（**无** `下载提纲` 于 2026-06-02 实测底栏，若 UI 恢复则回写） |
+| 初稿精修 | `/workbench/sci/writing` | 生成全文后**直接进入** writing（跳过 proofread 步骤条） | `返回提纲`；`新建论文`；`下载文档` |
+
+**WB-2 关键动作**
+
+1. 选定写作类型 + 模板后填 `请输入基础主题` → `生成提纲` → 验收 `/workbench/sci/outline`。
+2. `生成全文` → dialog「是否已完成提纲修改，继续生成全文」：仅需选 `中文` 或 `English`（**无**「需要中文文献」项）→ `确 认` → 验收 `/workbench/sci/writing`（长耗时，等待 loading 结束）。
+
+---
+
+##### WB-3：国自然基金工作台（`nsfc-v2`）
+
+**步骤条（5 步）**：Step1 生成科学假说 → Step2 确认科学假说 → Step3 生成申请书提纲 → Step4 校对申请书全文 → Step5 精修申请书全文。
+
+| 步骤 | `pathname` | 主要表单项 / 区块 | 底栏主按钮 |
+| --- | --- | --- | --- |
+| 生成科学假说 | `/workbench/nsfc-v2/topic` | **假说来源**：`我没有科学假说，请帮我生成` / `我已有科学假说，立即填写`；**拟申请的项目类型***：`getByRole('radio', { name: '面上项目'|'地区项目'|'青年项目' })`；**您的情况***：`我有前期研究结果` / `我没有前期研究结果`；有前期时 **`button` 上传**「将文件拖到此处，或点击上传」（`.pdf`/`.docx`）；无前期时 **研究主题*** `getByRole('textbox', { name: /请详细描述您想要研究的主题/ })`；有前期时 **疾病名称*** `getByRole('textbox', { name: '例如：乳腺癌' })` | `下一步` |
+| 确认科学假说 | `/workbench/nsfc-v2/hypothesis_confirm` | AI 生成多卡片假说（可选中切换） | `上一步`；`下一步` |
+| 生成申请书提纲 | `/workbench/nsfc-v2/outline` | 国自然提纲树；节点级 `重新生成` | `重新生成提纲`；`下载提纲`；`上一步`；`下一步` |
+| 校对申请书全文 | `/workbench/nsfc-v2/proofread` | 分块正文（含国自然固定章节标题） | `返回提纲`；`下载文档`；`完成校对` |
+| 精修申请书全文 | `/workbench/nsfc-v2/writing` | 全文编辑 | `返回提纲`；`新建论文`；`下载文档` |
+
+**WB-3 关键动作（无前期结果快速路径，已实测）**
+
+1. `click` → `getByText('我没有科学假说，请帮我生成', { exact: true })` → `getByRole('radio', { name: '我没有前期研究结果' })` → 填研究主题 textbox → `下一步` → `/hypothesis_confirm`。
+2. 等待「科学假说生成中…」→ `下一步` → `/outline` → 等待提纲就绪 → `下一步` → `/proofread` → 等待全文生成 → `完成校对` → dialog「进入全文编辑模式」→ `确认` → `/writing`。
+
+**有前期结果路径**：选 `我有前期研究结果` → 上传 PDF/DOCX → 填疾病名称 → `下一步`（其余同上）。
+
+---
+
+##### WB-4：临床申请书工作台（`clinical`）
+
+**步骤条（4 步）**：选题评估 → 四要素校验 → 初稿校对 → 全文精修。
+
+| 步骤 | `pathname` | 主要表单项 / 区块 | 底栏主按钮 |
+| --- | --- | --- | --- |
+| 选题评估 | `/workbench/clinical/topic` | **研究类别***：`疗效`/`病因`/`预后`/`诊断`（radio）；**研究设计***：`队列研究`/`临床试验`；**时间方向***：`前瞻性`/`回顾性`；**中心数***：`单中心`/`多中心`；**Population** `getByRole('textbox', { name: /研究人群/ })`；**Intervention** `getByRole('textbox', { name: /干预/ })`；**Control** `getByRole('textbox', { name: /对照/ })`（选填）；右侧「预检结果」面板 | `清 空`；`预 检`；预检完成后出现 `下一步` |
+| 四要素校验 | `/workbench/clinical/outline` | 自动展开 P/I/C/O/结局/样本量等；块内 `自定义编辑`；样本量区 `立即计算`（按钮文案，部分环境需 `locator('main').getByText('立即计算', { exact: true })` 且注意可见性） | `上一步`；`预 检`；预检通过后 `下一步` |
+| 初稿校对 | `/workbench/clinical/proofread` | 申请书全文（含「请校对本段内容」） | `上一步`；`下一步`；`完成校对` |
+| 全文精修 | `/workbench/clinical/writing` | 全文编辑 | `返回四要素校验`；`新建论文`；`下载文档` |
+
+**WB-4 关键动作**
+
+1. 填 PICOS 必填项 → `预 检` → 右侧出现选题评估文案 → `下一步` → `/outline`。
+2. 等待「四要素生成中…」结束 → （可选）`预 检` 更新右侧结果 → `下一步` → `/proofread`。
+3. 等待「文章内容生成中…」→ `完成校对` → dialog → `确认` → `/writing`。
+
+---
+
+##### WB-0：Meta 工作台（未上线）
+
+- 卡片可点但 **URL 不变**（仍为 `/workbench`）。
+- **禁止**编写 `goto /workbench/meta/...` 或假设存在子路由。
+- 用户若要 Meta 功能：说明「开发中」，改做其他子工具或等待产品上线后回写 slug。
+
+---
+
+##### 跨工具对照（Agent 快查）
+
+| 能力 | jova 综述 | sci 论著 | nsfc-v2 基金 | clinical 临床 |
+| --- | --- | --- | --- | --- |
+| 独立「校对」步骤条 | 有 | **无**（outline→writing） | 有 | 有 |
+| 全文生成前 dialog | 语言 + 中文文献 | 仅语言 | （outline 直接下一步进 proofread） | （outline 下一步进 proofread） |
+| 校对完成二次确认 | `确认` | — | `确认` | `确认` |
+| 精修页「返回」按钮 | `返回提纲` | `返回提纲` | `返回提纲` | `返回四要素校验` |
+| 精修页修订模式 | 有 | 无（实测） | 无（实测） | 无（实测） |
+
+**用户说法映射**
+
+- 「写综述 / 综述工作台」→ WB-1，`getByText('综述工作台')`。
+- 「SCI / 英文论文 / 论著工作台」→ WB-2，`getByText('SCI论著工作台')`。
+- 「国自然 / 基金 / 标书」→ WB-3，`getByText('基金工作台')`（**不是**旧称「基金申请书工作台」）。
+- 「临床申请书 / PICOS / 临床工作台」→ WB-4；面包屑为「临床申请书工作台」。
+- 「Meta / Meta分析工作台」→ WB-0，仅提示未上线。
 
 #### AI 应用 `/application/`（列表 · 详情 · 多块输入输出 · mindmap · 级联分类）
 
@@ -1098,9 +1250,12 @@ async page => {
 
 #### S-11：AI 工作台 · 进入子工作台
 
-1. S-07 → `/workbench`。
-2. `click` → `getByText('SCI论著工作台')`（或目标卡片名称）。
-3. **验收（示例）**：「SCI论著工作台」 → `location.pathname` 为 `/workbench/sci/topic`。
+> **细则**见上文「AI 工作台 `/workbench`」（WB-0～WB-4）。本节为最短路径；进入后按目标工具执行 WB-1～WB-4，**勿**对 Meta 假设子路由。
+
+1. S-07 → `/workbench`（或面包屑回 `AI工作台`）。
+2. `click` → `getByText('<首页卡片文案>', { exact: true })`（见 WB-0 表：综述 / SCI论著 / 基金 / 临床）。
+3. **验收**：`location.pathname === '/workbench/{slug}/topic'`（Meta 除外：点击后仍为 `/workbench`）。
+4. **后续**：综述 → WB-1；SCI → WB-2；基金 → WB-3；临床 → WB-4。
 
 #### S-12：AI 应用 · 标准操作