helixlife-v5-cli 1.2.3 → 1.2.5

package/lib/cli.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const fs = require('node:fs');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
 
@@ -199,11 +200,67 @@ function helixDoctor(options) {
   return helixHome(options);
 }
 
+/** npm 包内 scripts/ 目录（WorkBuddy 等工作区无 scripts/ 时回退） */
+function packageScriptsDir() {
+  return path.join(__dirname, '..', 'scripts');
+}
+
+/**
+ * run-code --filename=scripts/foo.js：cwd 下不存在时，回退到 helixlife-v5-cli 包内 scripts/
+ * @param {string[]} tokens
+ * @returns {string[]}
+ */
+function resolveRunCodeFilename(tokens) {
+  const runIdx = tokens.indexOf('run-code');
+  if (runIdx === -1) {
+    return tokens;
+  }
+
+  const out = [...tokens];
+  for (let i = runIdx + 1; i < out.length; i += 1) {
+    let filePath = null;
+    let mode = null;
+    const t = out[i];
+    if (t.startsWith('--filename=')) {
+      filePath = t.slice('--filename='.length).replace(/^["']|["']$/g, '');
+      mode = 'eq';
+    } else if (t === '--filename' && out[i + 1]) {
+      filePath = out[i + 1].replace(/^["']|["']$/g, '');
+      mode = 'next';
+    }
+    if (!filePath) {
+      continue;
+    }
+
+    const cwdResolved = path.isAbsolute(filePath) ? filePath : path.resolve(process.cwd(), filePath);
+    if (fs.existsSync(cwdResolved)) {
+      continue;
+    }
+
+    const base = path.basename(filePath.replace(/\\/g, '/'));
+    const pkgScript = path.join(packageScriptsDir(), base);
+    if (!fs.existsSync(pkgScript)) {
+      continue;
+    }
+
+    if (mode === 'eq') {
+      out[i] = `--filename=${pkgScript}`;
+    } else {
+      out[i + 1] = pkgScript;
+    }
+    if (process.env.HELIX_DEBUG_SCRIPT_RESOLVE) {
+      console.error(`[${PACKAGE_JSON.name}] run-code: ${filePath} → ${pkgScript}`);
+    }
+  }
+  return out;
+}
+
 async function runPassthroughWithVisual(tokens) {
+  const resolved = resolveRunCodeFilename(tokens);
   let visual;
   let stripped;
   try {
-    ({ tokens: stripped, visual } = parseVisualFlags(tokens));
+    ({ tokens: stripped, visual } = parseVisualFlags(resolved));
   } catch (e) {
     console.error(`[${PACKAGE_JSON.name}] ${e.message}`);
     return 3;
@@ -276,4 +333,6 @@ module.exports = {
   buildChildEnv,
   DEFAULT_OUTPUT_DIR_NAME,
   runPassthroughWithVisual,
+  resolveRunCodeFilename,
+  packageScriptsDir,
 };

package/package.json

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

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

@@ -24,6 +24,59 @@
 - **对用户回复的门禁**：在 `await fr.getByLabel('页码').inputValue()` 严格等于 `String(N)` 之前，禁止向用户输出「已跳到 / 已切换到 / 已完成第 N 页」等成功表述。验收未通过时如实说明未完成，给出读到的 `inputValue()` 或脚本抛错摘要、已执行步骤与下一步建议。
 - **禁止误导性归因**：不得以「跨域 iframe / 同源策略导致父页脚本无法访问子 frame」作为**无法自动化跳页**的结论。父页 JS 同源限制不等于 Playwright 无法在 `fr` 上操作阅读器工具栏。若仍失败应报告**未找到 `fr`、定位超时、语言包下 `aria-label` 变更**等可核验原因，并指向 S-25 与 `scripts/chrome-pdf-enumerate-a11y.js`。
 
+#### 工作台 · 「扩写前言」等章节 AI · Agent 硬门禁（操作前必审 · 与 PDF 跳页同级）
+
+**触发词**（任一命中即适用本门禁）：用户说 **「扩写 / 精简 / 润色 / 改写 / 重写 / 优化 + 章节名」**（如「扩写前言」「润色 1. 乳腺癌…」），或 **「校对 + 章节」**，或 **writing 页工具 + 章节**（如「翻译 前言」「降重 摘要」）。
+
+**语义（最高优先级）**
+
+| 用户说法 | 含义 | **绝不是** |
+| --- | --- | --- |
+| 扩写前言 | AI **重写**「前言」节点的**正文内容** | 提纲树 **添加子级** / **添加同级** |
+| 润色 / 精简 / 改写 + 章节 | 同上，改该节文字 | 在树下 **新增条目** |
+
+`snapshot` 里出现 `添加子级` 按钮 **不代表** 用户要添加子级；该按钮**仅**在用户明确说「加子标题 / 加一条同级提纲 / 添加子级」时使用。
+
+**禁止（违规则视为任务失败，勿向用户报「已完成扩写」）**
+
+- `click` → `getByRole('button', { name: '添加子级' })`
+- `click` → `getByRole('button', { name: '添加同级' })`
+- 在 **未** `run-code` 脚本前，对 outline 提纲树手写 `hover` + `click` 猜图标
+- 因 snapshot 里有「添加子级」文案而推断用户要「扩写」
+
+**必须（唯一合法第一步）**
+
+```bash
+# ① 定页
+helixlife-v5-cli --raw eval "location.pathname"
+
+# ② 统一入口（WorkBuddy 默认只跑这一条；用环境变量传 userIntent，勿改脚本文件）
+# PowerShell: $env:HELIX_JOVA_INTENT='扩写前言'
+# bash:       HELIX_JOVA_INTENT='扩写前言' helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+```
+
+工作区无 `scripts/` 时 CLI **自动回退**到 `node_modules/helixlife-v5-cli/scripts/` 同名文件；**禁止**复制脚本到 WorkBuddy 目录再改 `userIntent`。
+
+脚本内按 `pathname` 自动路由；**outline / writing 页**在 dispatch 内 **一次 run-code 跑完全流程**（含替换原文），**绝不**点「添加子级」。proofread 仍返回子脚本名。
+
+**WorkBuddy · 执行约束（与 PDF 跳页同级）**
+
+1. **只执行一条命令**：上表 `run-code` + `HELIX_JOVA_INTENT`；**禁止**在成功后追加 `hover` / `click e*` / `fill` / `sleep` / `snapshot` 手工重放。
+2. **验收**：读 `Result` JSON 末尾 `"ok": true` → 向用户报完成；`"ok": false` → 只报 `reason`，**禁止**改用手动逐步操作代替。
+3. **禁止**：将脚本复制到 `C:/Users/.../WorkBuddy/.../scripts/` 再编辑；禁止用绝对路径指向 WorkBuddy 副本。
+4. **禁止**：`run-code` 返回 `ok:true` 后仍「深度思考 + snapshot + 逐步 click」——这是导致数分钟慢路径的根因。
+
+**子脚本（仅 proofread 等 dispatch 未内联时）**
+
+| `pathname` | 示例 userIntent | 子脚本 |
+| --- | --- | --- |
+| `…/jova/outline` | `扩写前言` | （dispatch 内直接执行） |
+| `…/jova/writing` | `扩写前言` / `翻译 前言` | （dispatch 内直接执行；扩写类自动替换原文） |
+| `…/jova/proofread` | `校对 前言` | `workbench-jova-proofread-section.js` |
+
+细则与按钮对照表：下文 **WB-1 · 用户说法与脚本路由**。
+
 #### 用户说法映射
 
 - **深浅色**：用户说「切换颜色 / 换颜色 / 深色浅色 / 外观主题」等，已登录壳下**一律视为切换深浅色模式**（深色 ⇄ 浅色），见 S-16。
@@ -44,6 +97,7 @@
   - **定位与多命中**：推荐 `page.locator('main').getByText('部分章节匹配', { exact: true })`；多卡并列时**必须先缩小到目标课程卡片**，避免 strict 或误触（`scripts/hover-partial-chapter-match.js` 的 `cardTitle` 参数可直接用于此场景）。
   - 自测（2026-05-11）：`/edu/search?keywords=…` 课程结果首条 `hover` 后，可见 tooltip 浮层（`helixlife-v5-cli run-code --filename=scripts/hover-partial-chapter-match.js` 返回 `ok: true`，即 `tooltipLikeAfter > tooltipLikeBefore`）。
 - **数据分析 · 详情页 · 上传文件**：用户说「上传文件 / 上传数据 / 换数据文件 / 导入 csv xlsx」等，且 `pathname` 为 `/analysis/{toolId}` 时，**一律走 D-2 三步弹窗流程**（打开弹窗 → 弹窗内选文件 → 弹窗内「确认」），**禁止**把左侧参数卡片底部「确认」（D-6 生成结果）当成上传确认。细则见下文「上传文件 · Agent 硬门禁」。
+- **工作台 · 扩写/润色/精简/改写 + 章节**（如「扩写前言」）：**一律**先 `run-code --filename=scripts/workbench-jova-dispatch.js`（改 `userIntent`），**禁止**点提纲树「添加子级 / 添加同级」。语义是 AI 重写该节正文（outline 上为 **编辑**→重新生成），不是新增子条目。细则见上文「工作台 · 扩写前言等 · Agent 硬门禁」与 WB-1。
 
 #### 任务范围与跨域
 
@@ -155,7 +209,7 @@
 | 对话 · 新建会话 | S-09 |
 | 工作站 · 新建任务弹窗 | S-10 |
 | 工作台 · 进入子工作台 | S-11 |
-| 工作台 · 综述全流程（拟定主题→精修）；**扩写/润色/校对/翻译等必先定页+run-code 脚本** | WB-1 |
+| 工作台 · 综述全流程；**「扩写前言」等必先 dispatch.js，禁止添加子级** | WB-1 |
 | 工作台 · SCI 论著全流程 | WB-2 |
 | 工作台 · 国自然基金全流程 | WB-3 |
 | 工作台 · 临床申请书全流程 | WB-4 |
@@ -394,7 +448,7 @@ div.side-menu--item[to='/edu/courses']
 | 步骤 | `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/outline` | 左侧「论文提纲」树；节点 hover 后出现 **编辑**（AI 扩写/润色/精简）与 **添加同级/添加子级**（仅改树结构，**禁止**用于「扩写前言」）。章节 AI 操作 **必须** `run-code` → `scripts/workbench-jova-dispatch.js` | `返回主题`；`下载提纲`；`生成全文` |
 | 初稿校对 | `/workbench/jova/proofread` | 左目录 + 右正文；段落带「请校对本段内容」提示 | `返回提纲`；`下载文档`；`完成校对` |
 | 初稿精修 | `/workbench/jova/writing` | 左目录 + 中央 `textbox` 富文本；顶栏 **修订模式**（含接受/拒绝修订） | `返回提纲`；`修订模式` 切换钮（文案含 `接受修订` / `拒绝修订`）；`新建论文`；`下载文档` |
 
@@ -413,19 +467,25 @@ div.side-menu--item[to='/edu/courses']
 
 **0 · 定页（第一步，不可跳过）**
 
+> 与上文「工作台 · 扩写前言等 · Agent 硬门禁」一致；**WorkBuddy 默认只执行 `workbench-jova-dispatch.js`**，勿手写 click「添加子级」。
+
 ```bash
 helixlife-v5-cli --raw eval "location.pathname"
+# PowerShell: $env:HELIX_JOVA_INTENT='扩写前言'
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 ```
 
+（用 `HELIX_JOVA_INTENT` 传用户说法；outline/writing 在 dispatch 内直接完成，禁止点「添加子级」。工作区无 `scripts/` 时 CLI 自动用 npm 包内脚本。）
+
 **1 · 说法 → 脚本（jova 综述）**
 
 | 当前 `pathname` | 用户说法（示例） | 脚本（工作区 `scripts/`） | Agent 改动的变量 |
 | --- | --- | --- | --- |
-| `…/jova/outline` | `扩写前言`、`扩写 前言`、`精简结论`、`润色 1. 乳腺癌…` | `workbench-jova-outline-regenerate-node.js` | `intent`（动词+章节；支持连写或空格） |
-| `…/jova/proofread` | `校对 前言`、`确认校对`、`AI 改写`、`替换原文` | `workbench-jova-proofread-section.js` | `intent` + `action` |
-| `…/jova/writing` | `扩写 前言`、`翻译 前言`、`润色 摘要`、`降重`、`文献列表` | `workbench-jova-writing-tool.js` | `intent`（**工具与章节间建议空格**：`扩写 前言`） |
+| `…/jova/outline` | `扩写前言`、`扩写 前言`、`精简结论`、`润色 1. 乳腺癌…` | **`workbench-jova-dispatch.js`** | `HELIX_JOVA_INTENT` |
+| `…/jova/writing` | `扩写前言`、`翻译 前言`、`润色 摘要`、`降重`、`文献列表` | **`workbench-jova-dispatch.js`** | `HELIX_JOVA_INTENT` |
+| `…/jova/proofread` | `校对 前言`、`确认校对`、`AI 改写`、`替换原文` | dispatch 返回 → `workbench-jova-proofread-section.js` | `HELIX_JOVA_INTENT` + `HELIX_JOVA_ACTION` |
 
-执行：`helixlife-v5-cli run-code --filename=scripts/<上表脚本名>`
+执行：`HELIX_JOVA_INTENT='扩写前言' helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js`（**唯一首选**；**禁止**成功后手工 hover/click/fill）
 
 **2 · outline 页：扩写 ≠ 添加子级（反模式）**
 
@@ -462,8 +522,9 @@ helixlife-v5-cli --raw eval "location.pathname"
 
 1. 在 **outline** 页对用户「扩写/润色/精简 + 章节」点「添加子级」或「添加同级」——**永远不对**。
 2. 不 `eval location.pathname` 就在 **proofread / writing** 页找提纲树「编辑」或「添加子级」。
-3. 不用 `run-code --filename=scripts/workbench-jova-*.js`，改用手动 `snapshot` + `click` 拼 hover 才出现的图标按钮。
-4. 同一轮任务内反复 `snapshot` 猜 `e*` ref 定位提纲节点（须脚本内 `aria-label*="操作区"` + 章节文案匹配）。
+3. `run-code` 已返回 `"ok": true` 仍用手动 `snapshot` + `hover` + `click e*` + `fill` + `sleep` 重放（WorkBuddy 慢路径根因）。
+4. 将 `workbench-jova-dispatch.js` **复制到 WorkBuddy 工作区**再改 `userIntent`（应设 `HELIX_JOVA_INTENT`，CLI 自动回退 npm 包内脚本）。
+5. 同一轮任务内反复 `snapshot` 猜 `e*` ref 定位提纲节点（须脚本内 `aria-label*="操作区"` + 章节文案匹配）。
 
 **6 · 执行命令模板**
 
@@ -471,11 +532,12 @@ helixlife-v5-cli --raw eval "location.pathname"
 # ① 定页（不可跳过）
 helixlife-v5-cli --raw eval "location.pathname"
 
-# ② 按上表改脚本内 intent / action 后执行，示例：
-helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+# ② 一条命令完成（示例 PowerShell）
+$env:HELIX_JOVA_INTENT='扩写前言'
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 ```
 
-脚本路径相对于**打开浏览器时的工作区根**（helix-cli 仓库即 `scripts/...`）。
+`--filename=scripts/...` 相对于 cwd；cwd 无该文件时自动解析为 `node_modules/helixlife-v5-cli/scripts/...`。
 
 ---
 
@@ -557,6 +619,7 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-n
 **用户说法映射**
 
 - 「写综述 / 综述工作台」→ WB-1，`getByText('综述工作台')`。
+- **「扩写前言 / 扩写 前言 / 润色摘要 / 精简结论 / 改写 xxx」**→ **禁止**提纲树「添加子级」；**必须** `run-code --filename=scripts/workbench-jova-dispatch.js`（改 `userIntent`）。见上文硬门禁与 WB-1 §2。
 - 「SCI / 英文论文 / 论著工作台」→ WB-2，`getByText('SCI论著工作台')`。
 - 「国自然 / 基金 / 标书」→ WB-3，`getByText('基金工作台')`（**不是**旧称「基金申请书工作台」）。
 - 「临床申请书 / PICOS / 临床工作台」→ WB-4；面包屑为「临床申请书工作台」。

package/scripts/workbench-jova-dispatch.js

@@ -0,0 +1,370 @@
+/**
+ * 综述工作台（jova）· 统一入口（WorkBuddy 默认只用本脚本）
+ *
+ * 改 userIntent 一行；自动按 pathname 路由。
+ * outline 页「扩写前言」等：本脚本内直接执行（hover → 编辑，禁止添加子级）。
+ *
+ * 用法：
+ *   set HELIX_JOVA_INTENT=扩写前言
+ *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+ *
+ * WorkBuddy 等工作区无 scripts/ 时，CLI 自动回退到 npm 包内同名脚本；勿复制到 WorkBuddy 目录。
+ */
+async page => {
+  const userIntent = (process.env.HELIX_JOVA_INTENT || '扩写前言').trim();
+  const action = process.env.HELIX_JOVA_ACTION?.trim() || null;
+
+  const pathname = new URL(page.url()).pathname;
+  const FORBIDDEN_BUTTONS = ['添加子级', '添加同级'];
+
+  const outlineVerbs = ['扩写', '精简', '改写', '润色', '重写', '优化'];
+  const isOutlineVerbIntent = outlineVerbs.some(v => userIntent.trim().startsWith(v));
+  const isProofreadIntent = /^校对/.test(userIntent.trim());
+
+  function parseOutlineIntent(raw) {
+    const text = raw.trim();
+    for (const verb of outlineVerbs) {
+      if (text.startsWith(verb)) {
+        const title = text.slice(verb.length).trim();
+        if (title) return { nodeTitle: title, userRequirement: verb };
+      }
+    }
+    return { nodeTitle: '前言', userRequirement: text };
+  }
+
+  if (!pathname.includes('/workbench/jova/')) {
+    return {
+      ok: false,
+      userIntent,
+      pathname,
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      reason: '当前不在综述工作台 jova 流程页',
+    };
+  }
+
+  // ── outline：扩写/润色/精简 + 章节（禁止添加子级）──
+  if (pathname.includes('/jova/outline') && isOutlineVerbIntent) {
+    const { nodeTitle, userRequirement } = parseOutlineIntent(userIntent);
+    const main = page.locator('main');
+
+    async function resetEditingState() {
+      const closeIcons = main.getByRole('img', { name: 'close' });
+      for (let i = 0; i < (await closeIcons.count()); i++) {
+        const icon = closeIcons.nth(i);
+        if (await icon.isVisible()) {
+          await icon.click();
+          await page.waitForTimeout(400);
+        }
+      }
+      const cancelReplace = main.getByRole('button', { name: '取 消' });
+      if ((await cancelReplace.count()) > 0 && (await cancelReplace.first().isVisible())) {
+        await cancelReplace.first().click();
+        await page.waitForTimeout(400);
+      }
+      const saveBtn = main.getByRole('button', { name: '保 存' });
+      if ((await saveBtn.count()) > 0 && (await saveBtn.first().isVisible())) {
+        await saveBtn.first().click();
+        await page.waitForTimeout(400);
+      }
+    }
+
+    function outlineNode(title) {
+      const base = title.replace(/[：:]\s*$/, '');
+      const titleRe = new RegExp(`^${base.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[：:]?$`);
+      return main
+        .locator('[aria-label*="操作区"]')
+        .filter({
+          has: page.locator(':scope > *').first().filter({ hasText: titleRe }),
+        })
+        .first();
+    }
+
+    await resetEditingState();
+
+    const opArea = outlineNode(nodeTitle);
+    if ((await opArea.count()) === 0) {
+      return {
+        ok: false,
+        route: 'outline',
+        userIntent,
+        nodeTitle,
+        userRequirement,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: `未找到提纲节点「${nodeTitle}」`,
+      };
+    }
+
+    await opArea.hover();
+    await page.waitForTimeout(400);
+    await opArea.getByRole('button', { name: '编辑' }).click();
+
+    const regenTitle = main.getByText('重新生成', { exact: true });
+    await regenTitle.waitFor({ state: 'visible', timeout: 10000 });
+
+    const userReqBox = main.getByRole('textbox', { name: '用户需求' });
+    await userReqBox.waitFor({ state: 'visible', timeout: 5000 });
+    await userReqBox.fill(userRequirement);
+
+    await main.getByRole('button', { name: '一键生成' }).click();
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    await replaceBtn.waitFor({ state: 'visible', timeout: 120000 });
+    await page.waitForTimeout(800);
+
+    await replaceBtn.click();
+    await main.getByText('是否将本次生成结果替换原文？', { exact: true }).waitFor({ state: 'visible', timeout: 10000 });
+    await main.getByRole('button', { name: '确 定' }).click();
+    await page.waitForTimeout(800);
+
+    const saveBtn = main.getByRole('button', { name: '保 存' });
+    await saveBtn.waitFor({ state: 'visible', timeout: 10000 });
+    await saveBtn.click();
+    await page.waitForTimeout(1000);
+
+    return {
+      ok: true,
+      route: 'outline',
+      userIntent,
+      nodeTitle,
+      userRequirement,
+      clickedButton: '编辑',
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      message: `已通过「编辑→重新生成」完成「${userRequirement}」节点「${nodeTitle}」（未使用添加子级）。`,
+      url: page.url(),
+    };
+  }
+
+  // ── proofread / writing：返回子脚本，仍禁止添加子级 ──
+  if (pathname.includes('/jova/proofread') || isProofreadIntent) {
+    return {
+      ok: false,
+      route: 'proofread',
+      userIntent,
+      pathname,
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      nextScript: 'scripts/workbench-jova-proofread-section.js',
+      setIntent: userIntent,
+      setAction: action,
+      message: '请改 proofread-section.js 的 intent/action 后 run-code；禁止点添加子级。',
+    };
+  }
+
+  if (pathname.includes('/jova/writing')) {
+    const WRITING_TOOLS = ['校对', '文风', '润色', '降重', '翻译', '改写', '扩写', '缩写', '文献列表'];
+
+    function parseWritingIntent(raw) {
+      const text = raw.trim();
+      for (const tool of WRITING_TOOLS) {
+        if (text === tool || text.startsWith(`${tool} `) || text.startsWith(tool)) {
+          const sectionTitle = text.slice(tool.length).trim();
+          return { tool, sectionTitle: sectionTitle || null };
+        }
+      }
+      for (const verb of outlineVerbs) {
+        if (text.startsWith(verb)) {
+          const sectionTitle = text.slice(verb.length).trim();
+          if (sectionTitle) return { tool: verb === '优化' ? '润色' : verb, sectionTitle };
+        }
+      }
+      return { tool: null, sectionTitle: null };
+    }
+
+    const { tool, sectionTitle } = parseWritingIntent(userIntent);
+    if (!tool || !WRITING_TOOLS.includes(tool)) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        pathname,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: `writing 页无法解析工具，支持：${WRITING_TOOLS.join('、')} 或 ${outlineVerbs.join('/')} + 章节`,
+      };
+    }
+    if (tool !== '文献列表' && !sectionTitle) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        pathname,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: '请指定章节，如「扩写前言」或「翻译 前言」',
+      };
+    }
+
+    const main = page.locator('main');
+
+    async function closeWritingPanel() {
+      const closeIcons = main.getByRole('img', { name: 'close' });
+      for (let i = 0; i < (await closeIcons.count()); i++) {
+        const icon = closeIcons.nth(i);
+        if (await icon.isVisible().catch(() => false)) {
+          await icon.click();
+          await page.waitForTimeout(400);
+        }
+      }
+    }
+
+    async function selectWritingSection(title) {
+      if (title) {
+        const toc = main.locator('[class*="cursor-pointer"]').getByText(title, { exact: true });
+        if ((await toc.count()) > 0) {
+          await toc.first().click({ timeout: 5000 }).catch(() => {});
+          await page.waitForTimeout(500);
+        }
+        const heading = main.getByRole('heading', { name: title, exact: true }).first();
+        if ((await heading.count()) > 0) {
+          await heading.scrollIntoViewIfNeeded();
+          await page.waitForTimeout(300);
+        }
+      }
+      const selected = await page.evaluate(t => {
+        const editor = document.querySelector('main [role="textbox"]');
+        if (!editor) return { ok: false, reason: '未找到富文本编辑器' };
+        if (!t) {
+          const range = document.createRange();
+          range.selectNodeContents(editor);
+          const sel = window.getSelection();
+          sel?.removeAllRanges();
+          sel?.addRange(range);
+          return { ok: true };
+        }
+        const headings = [...editor.querySelectorAll('h1,h2,h3,h4,h5,h6')];
+        const idx = headings.findIndex(h => h.textContent?.trim() === t);
+        if (idx < 0) return { ok: false, reason: `编辑器内未找到章节「${t}」` };
+        const start = headings[idx];
+        const level = parseInt(start.tagName[1], 10);
+        let end = null;
+        for (let i = idx + 1; i < headings.length; i++) {
+          if (parseInt(headings[i].tagName[1], 10) <= level) {
+            end = headings[i];
+            break;
+          }
+        }
+        const range = document.createRange();
+        range.setStartBefore(start);
+        range.setEndBefore(end || editor.lastChild || editor);
+        const sel = window.getSelection();
+        sel?.removeAllRanges();
+        sel?.addRange(range);
+        return { ok: true, sectionText: range.toString().slice(0, 200) };
+      }, title);
+      await page.waitForTimeout(400);
+      return selected;
+    }
+
+    await closeWritingPanel();
+    const selected = await selectWritingSection(sectionTitle);
+    if (!selected.ok) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: selected.reason,
+      };
+    }
+
+    if (tool === '文献列表') {
+      await main.getByText(tool, { exact: true }).first().click();
+      await page.waitForTimeout(800);
+      return {
+        ok: true,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        mode: 'list',
+        message: '已打开文献列表面板。',
+        url: page.url(),
+      };
+    }
+
+    await main.getByText(tool, { exact: true }).first().click();
+    await page.waitForTimeout(800);
+    await main.getByText('原文内容', { exact: true }).waitFor({ state: 'visible', timeout: 10000 }).catch(() => {});
+
+    if (tool === '文风') {
+      const refBox = main.getByRole('textbox', { name: '参考文风' });
+      if ((await refBox.count()) > 0 && (await refBox.first().isVisible().catch(() => false))) {
+        const ref =
+          selected.sectionText ||
+          'This review synthesizes molecular subtyping and precision therapeutic strategies in breast cancer.';
+        await refBox.first().fill(ref);
+      }
+    }
+    if (tool === '翻译') {
+      for (const label of ['English', '英文']) {
+        const opt = main.getByText(label, { exact: true });
+        if ((await opt.count()) > 0 && (await opt.first().isVisible().catch(() => false))) {
+          await opt.first().click();
+          await page.waitForTimeout(300);
+          break;
+        }
+      }
+    }
+
+    await main.getByRole('button', { name: '一键生成' }).click();
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    await replaceBtn.waitFor({ state: 'visible', timeout: 120000 });
+    const deadline = Date.now() + 120000;
+    while (Date.now() < deadline) {
+      if (await replaceBtn.isEnabled()) break;
+      await page.waitForTimeout(1000);
+    }
+
+    const shouldReplace = action === 'replace' || outlineVerbs.some(v => userIntent.trim().startsWith(v));
+    if (shouldReplace && (await replaceBtn.isEnabled())) {
+      await replaceBtn.click();
+      await main
+        .getByText('是否将本次生成结果替换原文？', { exact: true })
+        .waitFor({ state: 'visible', timeout: 10000 });
+      await main.getByRole('button', { name: '确 定' }).click();
+      await page.waitForTimeout(1000);
+      return {
+        ok: true,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        replaced: true,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        message: `writing 页已通过「${tool}→一键生成→替换原文」完成「${sectionTitle}」。`,
+        url: page.url(),
+      };
+    }
+
+    return {
+      ok: true,
+      route: 'writing',
+      userIntent,
+      tool,
+      sectionTitle,
+      needsReplaceChoice: true,
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      message: `「${tool}」已生成；用户确认后再设 HELIX_JOVA_ACTION=replace 或说「替换原文」。`,
+      url: page.url(),
+    };
+  }
+
+  if (pathname.includes('/jova/outline')) {
+    return {
+      ok: false,
+      route: 'outline',
+      userIntent,
+      pathname,
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      nextScript: 'scripts/workbench-jova-outline-regenerate-node.js',
+      setIntent: userIntent,
+      reason: 'userIntent 未匹配扩写/精简/润色/改写/重写/优化 前缀',
+    };
+  }
+
+  return {
+    ok: false,
+    userIntent,
+    pathname,
+    forbiddenNeverClick: FORBIDDEN_BUTTONS,
+    reason: '当前 jova 步骤页不支持本章 AI 操作（topic/proofread 以外）',
+  };
+};

package/scripts/workbench-jova-outline-regenerate-node.js

@@ -11,7 +11,7 @@
  *   悬停提纲节点 → 编辑（不点添加子级/添加同级）→ 填写「用户需求」→「一键生成」
  *   → 等待「生成结果」→「替换原文」→ Popconfirm「确 定」→「保 存」
  *
- * 用法（仅需改 intent 一行，或显式指定 nodeTitle / userRequirement）：
+ * 用法（WorkBuddy 请优先用 workbench-jova-dispatch.js；本文件为 outline 子脚本）：
  *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
  *
  * intent 解析规则（动词与章节可连写或空格）：