helixlife-v5-cli 1.2.3 → 1.2.4

package/package.json

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

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

@@ -24,6 +24,48 @@
 - **对用户回复的门禁**：在 `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）
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+```
+
+脚本内按 `pathname` 自动路由；**outline 页**走 `hover → 编辑 → 重新生成`，**绝不**点「添加子级」。若当前页为 proofread / writing，脚本返回应使用的子脚本名，**仍禁止**点「添加子级」。
+
+**子脚本（由 dispatch 内部或返回值指定，勿手写 click 提纲树）**
+
+| `pathname` | 示例 userIntent | 子脚本 |
+| --- | --- | --- |
+| `…/jova/outline` | `扩写前言` | （dispatch 内直接执行） |
+| `…/jova/proofread` | `校对 前言` | `workbench-jova-proofread-section.js` |
+| `…/jova/writing` | `扩写 前言` / `翻译 前言` | `workbench-jova-writing-tool.js` |
+
+细则与按钮对照表：下文 **WB-1 · 用户说法与脚本路由**。
+
 #### 用户说法映射
 
 - **深浅色**：用户说「切换颜色 / 换颜色 / 深色浅色 / 外观主题」等，已登录壳下**一律视为切换深浅色模式**（深色 ⇄ 浅色），见 S-16。
@@ -44,6 +86,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 +198,7 @@
 | 对话 · 新建会话 | S-09 |
 | 工作站 · 新建任务弹窗 | S-10 |
 | 工作台 · 进入子工作台 | S-11 |
-| 工作台 · 综述全流程（拟定主题→精修）；**扩写/润色/校对/翻译等必先定页+run-code 脚本** | WB-1 |
+| 工作台 · 综述全流程；**「扩写前言」等必先 dispatch.js，禁止添加子级** | WB-1 |
 | 工作台 · SCI 论著全流程 | WB-2 |
 | 工作台 · 国自然基金全流程 | WB-3 |
 | 工作台 · 临床申请书全流程 | WB-4 |
@@ -394,7 +437,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 +456,24 @@ div.side-menu--item[to='/edu/courses']
 
 **0 · 定页（第一步，不可跳过）**
 
+> 与上文「工作台 · 扩写前言等 · Agent 硬门禁」一致；**WorkBuddy 默认只执行 `workbench-jova-dispatch.js`**，勿手写 click「添加子级」。
+
 ```bash
 helixlife-v5-cli --raw eval "location.pathname"
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 ```
 
+（改 dispatch 内 `userIntent`；outline 页在 dispatch 内直接完成，禁止点「添加子级」。）
+
 **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`**（推荐）或 `workbench-jova-outline-regenerate-node.js` | `userIntent` / `intent` |
+| `…/jova/proofread` | `校对 前言`、`确认校对`、`AI 改写`、`替换原文` | dispatch 返回 → `workbench-jova-proofread-section.js` | `intent` + `action` |
+| `…/jova/writing` | `扩写 前言`、`翻译 前言`、`润色 摘要`、`降重`、`文献列表` | dispatch 返回 → `workbench-jova-writing-tool.js` | `intent` |
 
-执行：`helixlife-v5-cli run-code --filename=scripts/<上表脚本名>`
+执行：`helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js`（**首选**）
 
 **2 · outline 页：扩写 ≠ 添加子级（反模式）**
 
@@ -557,6 +605,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,195 @@
+/**
+ * 综述工作台（jova）· 统一入口（WorkBuddy 默认只用本脚本）
+ *
+ * 改 userIntent 一行；自动按 pathname 路由。
+ * outline 页「扩写前言」等：本脚本内直接执行（hover → 编辑，禁止添加子级）。
+ *
+ * 用法：
+ *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+ */
+async page => {
+  // ── Agent 只改这一行（原样粘贴用户说法，如「扩写前言」）──
+  const userIntent = '扩写前言';
+  const action = null; // proofread/writing 子流程用；outline 忽略
+
+  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 };
+  }
+
+  function normalizeWritingIntent(raw) {
+    const text = raw.trim();
+    const tools = ['校对', '文风', '润色', '降重', '翻译', '改写', '扩写', '缩写', '文献列表'];
+    for (const tool of tools) {
+      if (text === tool || text.startsWith(`${tool} `) || text.startsWith(tool)) {
+        const sectionTitle = text.slice(tool.length).trim();
+        return sectionTitle ? `${tool} ${sectionTitle}` : tool;
+      }
+    }
+    return 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')) {
+    return {
+      ok: false,
+      route: 'writing',
+      userIntent,
+      pathname,
+      forbiddenNeverClick: FORBIDDEN_BUTTONS,
+      nextScript: 'scripts/workbench-jova-writing-tool.js',
+      setIntent: normalizeWritingIntent(userIntent),
+      setAction: action,
+      message: '请改 writing-tool.js 的 intent 后 run-code；writing 页无添加子级按钮。',
+    };
+  }
+
+  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 解析规则（动词与章节可连写或空格）：