helixlife-v5-cli 1.2.6 → 1.2.8

package/package.json

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

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

@@ -404,10 +404,41 @@ div.side-menu--item[to='/edu/courses']
 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`。
-5. **节点 AI 重写（扩写 / 精简 / 润色 / 改写 / 重写 / 优化）**：用户说「扩写前言」「精简结论」「润色摘要」等时，**严禁**点 `添加子级` / `添加同级`（那只会插入空节点）。正确流程：`hover` 目标提纲节点 → 点该节点行内 `编辑`（铅笔图标）→ 右侧出现「重新生成」面板 → 把**动词**（扩写/精简/…）填入 `getByRole('textbox', { name: '用户需求' })` → `getByRole('button', { name: '一键生成' })` → 等待 `替换原文` 可点 → `click` `替换原文` → Popconfirm「是否将本次生成结果替换原文？」`getByRole('button', { name: '确 定' })` → 左侧内联编辑器 `getByRole('button', { name: '保 存' })`。**意图拆分**：「<动词><节点标题>」→ `节点标题` 用于定位节点、`动词` 填入「用户需求」框；动词集合 = {扩写, 精简, 改写, 润色, 重写, 优化}。已封装为 `scripts/workbench-jova-outline-regenerate-node.js`（改顶部 `intent` 一行即可），优先复用该脚本而非手点。
+5. **节点 AI 重写（扩写 / 精简 / 润色 / 改写 / 重写 / 优化）**：用户说「扩写前言」「**扩写摘要**」「精简结论」「润色 1. xxx」等时，**严禁**点 `添加子级` / `添加同级`（那只会插入空节点）。正确流程：`hover` 目标提纲节点 → 点该节点行内 `编辑`（铅笔图标）→ 右侧出现「重新生成」面板 → 把**动词**（扩写/精简/…）填入 `getByRole('textbox', { name: '用户需求' })` → `getByRole('button', { name: '一键生成' })` → 等待 `替换原文` 可点 → `click` `替换原文` → Popconfirm「是否将本次生成结果替换原文？」`getByRole('button', { name: '确 定' })` → 左侧内联编辑器 `getByRole('button', { name: '保 存' })`。**意图拆分**：「<动词><节点标题>」（动词与标题间可有可无空格）→ `节点标题` 用于定位节点、`动词` 填入「用户需求」框；动词集合 = {扩写, 精简, 改写, 润色, 重写, 优化}。**Agent 硬门禁 · 提纲节点 AI 重写**（细则见下节）：**一律** `run-code --filename=scripts/workbench-jova-outline-regenerate-node.js`，将用户**原话**传入 `HELIX_INTENT`（如 `扩写摘要`）；**禁止**为不同节点标题新建脚本或手点逐步操作。
 
 **取消全文生成弹窗**：同 dialog 内 `getByRole('button', { name: '取 消' })` 或 `Close`。
 
+###### 提纲节点 AI 重写 · Agent 硬门禁（WB-1 / outline · 必读）
+
+> **触发**：`/workbench/jova/outline`（或结构相同的 `sci`/`nsfc-v2`/`clinical` outline 步）且用户指令含 {扩写, 精简, 改写, 润色, 重写, 优化} + 提纲节点名（前言、摘要、结论、1. xxx …）。
+
+| 用户说法示例 | `HELIX_INTENT` | 解析结果 |
+| --- | --- | --- |
+| 扩写前言 | `扩写前言` | 节点=前言，用户需求=扩写 |
+| 扩写摘要 | `扩写摘要` | 节点=摘要，用户需求=扩写 |
+| 精简结论 | `精简结论` | 节点=结论，用户需求=精简 |
+| 润色 1. 乳腺癌… | `润色 1. 乳腺癌…` | 节点=1. 乳腺癌…，用户需求=润色 |
+
+**执行（必用同一脚本，禁止复制改写）**
+
+```powershell
+# PowerShell — 将引号内换成用户原话
+$env:HELIX_INTENT='扩写摘要'; helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+```
+
+```bash
+# Bash / macOS
+HELIX_INTENT='扩写摘要' helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+```
+
+**反模式（常见导致误操作「前言」或重复造脚本）**
+
+- 直接 `run-code` 而不设 `HELIX_INTENT` → 脚本会报错并拒绝执行（勿改脚本内默认值绕过）。
+- 用户说「扩写摘要」却新建 `workbench-jova-outline-regenerate-abstract.js` 等副本 → **禁止**；节点标题差异仅体现在 `HELIX_INTENT`。
+- 用 `添加子级` / `添加同级` 代替 AI 重写 → 只会插入空节点。
+
+**显式拆分（可选）**：`HELIX_NODE_TITLE` + `HELIX_USER_REQUIREMENT` 同时设置时优先于 `HELIX_INTENT`。
+
 ---
 
 ##### WB-2：SCI 论著工作台（`sci`）

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

@@ -1,44 +1,68 @@
 /**
  * 综述工作台（jova）· 确认提纲页 · 节点 AI 重新生成
  *
- * 典型场景：用户说「扩写前言」「精简结论」「润色 1. xxx」等。
+ * 典型场景：用户说「扩写前言」「扩写摘要」「精简结论」「润色 1. xxx」等。
  *
  * 流程：
  *   悬停提纲节点 → 编辑 → 填写「用户需求」→「一键生成」
  *   → 等待「生成结果」→「替换原文」→ Popconfirm「确 定」→「保 存」
  *
- * 用法（仅需改 intent 一行，或显式指定 nodeTitle / userRequirement）：
- *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+ * Agent 调用约定（严格遵守）：
+ *   1) 无论节点标题是「前言」「摘要」「结论」或任意提纲节名，一律复用本脚本，禁止新建同类脚本。
+ *   2) 将用户原话传入 HELIX_INTENT 后执行 run-code（勿依赖脚本内默认 intent）：
+ *        PowerShell: $env:HELIX_INTENT='扩写摘要'; helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+ *        Bash:       HELIX_INTENT='扩写摘要' helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+ *   3) 也可显式拆分：HELIX_NODE_TITLE + HELIX_USER_REQUIREMENT（同时设置时优先于 HELIX_INTENT）
  *
- * intent 解析规则：
+ * intent / HELIX_INTENT 解析规则（<动词><节点标题>，动词与标题间可有可无空格）：
  *   「扩写前言」     → nodeTitle=前言,     userRequirement=扩写
+ *   「扩写摘要」     → nodeTitle=摘要,     userRequirement=扩写
  *   「精简结论」     → nodeTitle=结论,     userRequirement=精简
- *   「润色摘要：」   → nodeTitle=摘要：,   userRequirement=润色
+ *   「润色 1. xxx」  → nodeTitle=1. xxx,   userRequirement=润色
  *   无法解析时整句作为 userRequirement，nodeTitle 回退为「前言」
  */
 async page => {
-  // ── Agent 通常只改这一行 ──
-  const intent = '扩写前言';
+  const intent = (process.env.HELIX_INTENT || '').trim();
 
-  // 也可显式覆盖（非 null 时优先于 intent 解析）
-  const nodeTitleOverride = null;
-  const userRequirementOverride = null;
+  const nodeTitleOverride = process.env.HELIX_NODE_TITLE?.trim() || null;
+  const userRequirementOverride = process.env.HELIX_USER_REQUIREMENT?.trim() || null;
+
+  const VERBS = ['扩写', '精简', '改写', '润色', '重写', '优化'];
 
   function parseIntent(raw) {
-    const verbs = ['扩写', '精简', '改写', '润色', '重写', '优化'];
-    for (const verb of verbs) {
-      if (raw.startsWith(verb)) {
-        const title = raw.slice(verb.length).trim();
+    const normalized = raw.replace(/[：:]\s*$/, '').trim();
+    for (const verb of VERBS) {
+      if (normalized.startsWith(verb)) {
+        const title = normalized.slice(verb.length).trim();
         if (title) return { nodeTitle: title, userRequirement: verb };
       }
     }
-    return { nodeTitle: '前言', userRequirement: raw };
+    return { nodeTitle: '前言', userRequirement: normalized || raw };
   }
 
-  const parsed = parseIntent(intent);
+  if (!intent && !nodeTitleOverride) {
+    return {
+      ok: false,
+      reason:
+        '缺少 HELIX_INTENT（用户原话，如「扩写摘要」）或 HELIX_NODE_TITLE。禁止直接 run-code 而不传意图——否则会误操作默认节点。',
+      hint: "PowerShell: $env:HELIX_INTENT='扩写摘要'; helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js",
+    };
+  }
+
+  const parsed = intent ? parseIntent(intent) : { nodeTitle: '', userRequirement: '' };
   const nodeTitle = nodeTitleOverride ?? parsed.nodeTitle;
   const userRequirement = userRequirementOverride ?? parsed.userRequirement;
 
+  if (!nodeTitle || !userRequirement) {
+    return {
+      ok: false,
+      reason: '无法解析节点或动词。请传 HELIX_INTENT（如「扩写摘要」）或同时传 HELIX_NODE_TITLE + HELIX_USER_REQUIREMENT。',
+      intent,
+      nodeTitle,
+      userRequirement,
+    };
+  }
+
   const main = page.locator('main');
 
   if (!page.url().includes('/workbench/jova/outline')) {

package/scripts/workbench-jova-proofread-section.js

@@ -1,262 +1,262 @@
-/**
- * 综述工作台（jova）· 初稿校对页 · 章节校对 / AI 改写
- *
- * Agent 调用约定（严格遵守）：
- *
- * 1) 用户只说「校对 <章节>」、未指明操作时：
- *    action = null → 仅滚动定位 → 悬停 → 点「点击本段进入编辑校对」或「重新编辑」
- *    → 返回 needsUserChoice，由 Agent 询问用户选「确认校对」或「AI 改写」
- *    → 禁止自动点「确认校对」
- *
- * 2) 用户明确说「确认校对」：action = 'confirm'
- *
- * 3) 用户明确说「AI 改写」：
- *    action = 'ai_rewrite' → 点「AI 改写」→（有额外需求则填写）→「一键重写」→ 等待生成
- *    → 返回 needsReplaceChoice，提醒用户是否替换原文，禁止自动点「替换原文」
- *
- * 4) 用户明确同意替换原文：action = 'replace'
- *
- * 用法：
- *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-proofread-section.js
- */
-async page => {
-  const intent = '校对 1. 乳腺癌分子分型体系及其分子特征';
-  const action = null; // null | 'confirm' | 'ai_rewrite' | 'replace'
-  const extraRequirement = ''; // 仅 ai_rewrite 时可选
-
-  const main = page.locator('main');
-
-  function parseIntent(raw) {
-    const m = raw.match(/^校对\s*(.+)$/);
-    return { sectionTitle: (m ? m[1] : raw).trim() };
-  }
-
-  const { sectionTitle } = parseIntent(intent);
-
-  if (!page.url().includes('/workbench/jova/proofread')) {
-    return {
-      ok: false,
-      reason: '当前不在综述工作台初稿校对页 /workbench/jova/proofread',
-      intent,
-      sectionTitle,
-    };
-  }
-
-  async function dismissPopconfirmOnly() {
-    const cancel = main.getByRole('button', { name: '取 消' });
-    if ((await cancel.count()) > 0 && (await cancel.first().isVisible())) {
-      await cancel.first().click();
-      await page.waitForTimeout(300);
-    }
-  }
-
-  function sectionHeading(title) {
-    return main.getByRole('heading', { name: title, exact: true }).first();
-  }
-
-  function sectionBlock(title) {
-    return sectionHeading(title).locator('xpath=ancestor::div[contains(@class,"group")][1]');
-  }
-
-  async function navigateToSection(title) {
-    const toc = main.locator('[class*="cursor-pointer"]').getByText(title, { exact: true });
-    if ((await toc.count()) > 0) {
-      await toc.first().click({ timeout: 3000 }).catch(() => {});
-      await page.waitForTimeout(500);
-    }
-    const heading = sectionHeading(title);
-    if ((await heading.count()) === 0) {
-      return { ok: false, reason: `未找到章节「${title}」` };
-    }
-    await heading.scrollIntoViewIfNeeded();
-    await page.waitForTimeout(400);
-    return { ok: true };
-  }
-
-  async function detectProofreadStatus(block) {
-    const pending = block.getByText('请校对本段内容', { exact: true });
-    const done = block.getByText('本段完成校对', { exact: true });
-    if ((await pending.count()) > 0) return 'pending';
-    if ((await done.count()) > 0) return 'done';
-    return 'completed_or_editing';
-  }
-
-  async function clickEnterEdit(block) {
-    const enterLabels = [
-      '点击本段进入编辑校对',
-      '点击本段进行校对',
-      '点击本段进行编辑校对',
-    ];
-    for (const label of enterLabels) {
-      const btn = block.getByText(label, { exact: true });
-      if ((await btn.count()) > 0 && (await btn.first().isVisible())) {
-        await btn.first().click();
-        return true;
-      }
-    }
-    return false;
-  }
-
-  async function openSectionEdit(title) {
-    const nav = await navigateToSection(title);
-    if (!nav.ok) return nav;
-
-    const block = sectionBlock(title);
-
-    if ((await block.getByRole('button', { name: '确认校对' }).count()) > 0) {
-      return { ok: true, proofreadStatus: 'already_editing' };
-    }
-
-    const proofreadStatus = await detectProofreadStatus(block);
-
-    if (proofreadStatus === 'pending') {
-      await block.getByText('请校对本段内容', { exact: true }).first().hover();
-      await page.waitForTimeout(600);
-      if (!(await clickEnterEdit(block))) {
-        return { ok: false, reason: '未找到「点击本段进入编辑校对」入口', proofreadStatus };
-      }
-    } else if (proofreadStatus === 'done') {
-      await block.getByText('本段完成校对', { exact: true }).first().hover();
-      await page.waitForTimeout(600);
-      const reEdit = block.getByText('重新编辑', { exact: true });
-      if ((await reEdit.count()) === 0 || !(await reEdit.first().isVisible())) {
-        return { ok: false, reason: '未找到「重新编辑」入口', proofreadStatus };
-      }
-      await reEdit.first().click();
-    } else {
-      await block.hover();
-      await page.waitForTimeout(600);
-      const reEdit = block.getByText('重新编辑', { exact: true });
-      if ((await reEdit.count()) > 0 && (await reEdit.first().isVisible())) {
-        await reEdit.first().click();
-      } else if (await clickEnterEdit(block)) {
-        // ok
-      } else {
-        return { ok: false, reason: '无法进入编辑模式（未找到入口）', proofreadStatus };
-      }
-    }
-
-    await block.getByRole('button', { name: '确认校对' }).waitFor({ state: 'visible', timeout: 10000 });
-    await page.waitForTimeout(400);
-    return { ok: true, proofreadStatus };
-  }
-
-  async function confirmProofread(title) {
-    const block = sectionBlock(title);
-    await block.getByRole('button', { name: '确认校对' }).click();
-    await page.waitForTimeout(1000);
-    return { ok: true };
-  }
-
-  async function waitReplaceReady(timeoutMs = 120000) {
-    const replaceBtn = main.getByRole('button', { name: '替换原文' });
-    await replaceBtn.waitFor({ state: 'visible', timeout: timeoutMs });
-    const deadline = Date.now() + timeoutMs;
-    while (Date.now() < deadline) {
-      if (await replaceBtn.isEnabled()) return replaceBtn;
-      await page.waitForTimeout(1000);
-    }
-    throw new Error('等待「替换原文」可点击超时');
-  }
-
-  async function aiRewriteGenerate(title, extra) {
-    const block = sectionBlock(title);
-    await block.getByRole('button', { name: /AI\s*改写/ }).click();
-    await main.getByText('原文内容', { exact: true }).waitFor({ state: 'visible', timeout: 10000 });
-
-    if (extra) {
-      const extraBox = main.getByRole('textbox', { name: '额外需求' });
-      if ((await extraBox.count()) > 0) await extraBox.fill(extra);
-    }
-
-    await main.getByRole('button', { name: '一键重写' }).click();
-    await waitReplaceReady();
-
-    return { ok: true, generated: true, replaceReady: true };
-  }
-
-  async function aiRewriteReplace() {
-    const replaceBtn = main.getByRole('button', { name: '替换原文' });
-    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, replaced: true };
-  }
-
-  await dismissPopconfirmOnly();
-
-  const needOpenEdit = action === null || action === '' || action === undefined || action === 'confirm' || action === 'ai_rewrite';
-  let opened = { ok: true, proofreadStatus: 'already_editing' };
-
-  if (needOpenEdit && action !== 'replace') {
-    opened = await openSectionEdit(sectionTitle);
-    if (!opened.ok) return { ok: false, intent, sectionTitle, ...opened };
-  }
-
-  if (action === null || action === undefined || action === '') {
-    return {
-      ok: true,
-      needsUserChoice: true,
-      intent,
-      sectionTitle,
-      proofreadStatus: opened.proofreadStatus,
-      availableActions: ['confirm', 'ai_rewrite'],
-      message: '已进入该段编辑模式。请选择：① 确认校对（直接完成本段校对）② AI 改写（AI 重新生成内容）',
-      url: page.url(),
-    };
-  }
-
-  if (action === 'confirm') {
-    await confirmProofread(sectionTitle);
-    const block = sectionBlock(sectionTitle);
-    const afterStatus = await detectProofreadStatus(block);
-    return {
-      ok: true,
-      intent,
-      sectionTitle,
-      action,
-      proofreadStatusBefore: opened.proofreadStatus,
-      proofreadStatusAfter: afterStatus,
-      message: '本段已确认校对完成。',
-      url: page.url(),
-    };
-  }
-
-  if (action === 'ai_rewrite') {
-    const generated = await aiRewriteGenerate(sectionTitle, extraRequirement);
-    return {
-      ok: generated.ok,
-      intent,
-      sectionTitle,
-      action,
-      extraRequirement: extraRequirement || null,
-      generated: true,
-      needsReplaceChoice: true,
-      availableActions: ['replace'],
-      message:
-        'AI 改写结果已生成。请在右侧查看「生成结果」，确认无误后告知我「替换原文」以应用；若不满意可直接在页面调整或重新生成。',
-      url: page.url(),
-    };
-  }
-
-  if (action === 'replace') {
-    const replaced = await aiRewriteReplace();
-    return {
-      ok: replaced.ok,
-      intent,
-      sectionTitle,
-      action,
-      replaced: true,
-      message: '已替换原文。如需完成本段校对，请明确告知「确认校对」。',
-      url: page.url(),
-    };
-  }
-
-  return {
-    ok: false,
-    reason: `未知 action「${action}」，应为 null | confirm | ai_rewrite | replace`,
-    intent,
-    sectionTitle,
-  };
-}
+/**
+ * 综述工作台（jova）· 初稿校对页 · 章节校对 / AI 改写
+ *
+ * Agent 调用约定（严格遵守）：
+ *
+ * 1) 用户只说「校对 <章节>」、未指明操作时：
+ *    action = null → 仅滚动定位 → 悬停 → 点「点击本段进入编辑校对」或「重新编辑」
+ *    → 返回 needsUserChoice，由 Agent 询问用户选「确认校对」或「AI 改写」
+ *    → 禁止自动点「确认校对」
+ *
+ * 2) 用户明确说「确认校对」：action = 'confirm'
+ *
+ * 3) 用户明确说「AI 改写」：
+ *    action = 'ai_rewrite' → 点「AI 改写」→（有额外需求则填写）→「一键重写」→ 等待生成
+ *    → 返回 needsReplaceChoice，提醒用户是否替换原文，禁止自动点「替换原文」
+ *
+ * 4) 用户明确同意替换原文：action = 'replace'
+ *
+ * 用法：
+ *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-proofread-section.js
+ */
+async page => {
+  const intent = '校对 1. 乳腺癌分子分型体系及其分子特征';
+  const action = null; // null | 'confirm' | 'ai_rewrite' | 'replace'
+  const extraRequirement = ''; // 仅 ai_rewrite 时可选
+
+  const main = page.locator('main');
+
+  function parseIntent(raw) {
+    const m = raw.match(/^校对\s*(.+)$/);
+    return { sectionTitle: (m ? m[1] : raw).trim() };
+  }
+
+  const { sectionTitle } = parseIntent(intent);
+
+  if (!page.url().includes('/workbench/jova/proofread')) {
+    return {
+      ok: false,
+      reason: '当前不在综述工作台初稿校对页 /workbench/jova/proofread',
+      intent,
+      sectionTitle,
+    };
+  }
+
+  async function dismissPopconfirmOnly() {
+    const cancel = main.getByRole('button', { name: '取 消' });
+    if ((await cancel.count()) > 0 && (await cancel.first().isVisible())) {
+      await cancel.first().click();
+      await page.waitForTimeout(300);
+    }
+  }
+
+  function sectionHeading(title) {
+    return main.getByRole('heading', { name: title, exact: true }).first();
+  }
+
+  function sectionBlock(title) {
+    return sectionHeading(title).locator('xpath=ancestor::div[contains(@class,"group")][1]');
+  }
+
+  async function navigateToSection(title) {
+    const toc = main.locator('[class*="cursor-pointer"]').getByText(title, { exact: true });
+    if ((await toc.count()) > 0) {
+      await toc.first().click({ timeout: 3000 }).catch(() => {});
+      await page.waitForTimeout(500);
+    }
+    const heading = sectionHeading(title);
+    if ((await heading.count()) === 0) {
+      return { ok: false, reason: `未找到章节「${title}」` };
+    }
+    await heading.scrollIntoViewIfNeeded();
+    await page.waitForTimeout(400);
+    return { ok: true };
+  }
+
+  async function detectProofreadStatus(block) {
+    const pending = block.getByText('请校对本段内容', { exact: true });
+    const done = block.getByText('本段完成校对', { exact: true });
+    if ((await pending.count()) > 0) return 'pending';
+    if ((await done.count()) > 0) return 'done';
+    return 'completed_or_editing';
+  }
+
+  async function clickEnterEdit(block) {
+    const enterLabels = [
+      '点击本段进入编辑校对',
+      '点击本段进行校对',
+      '点击本段进行编辑校对',
+    ];
+    for (const label of enterLabels) {
+      const btn = block.getByText(label, { exact: true });
+      if ((await btn.count()) > 0 && (await btn.first().isVisible())) {
+        await btn.first().click();
+        return true;
+      }
+    }
+    return false;
+  }
+
+  async function openSectionEdit(title) {
+    const nav = await navigateToSection(title);
+    if (!nav.ok) return nav;
+
+    const block = sectionBlock(title);
+
+    if ((await block.getByRole('button', { name: '确认校对' }).count()) > 0) {
+      return { ok: true, proofreadStatus: 'already_editing' };
+    }
+
+    const proofreadStatus = await detectProofreadStatus(block);
+
+    if (proofreadStatus === 'pending') {
+      await block.getByText('请校对本段内容', { exact: true }).first().hover();
+      await page.waitForTimeout(600);
+      if (!(await clickEnterEdit(block))) {
+        return { ok: false, reason: '未找到「点击本段进入编辑校对」入口', proofreadStatus };
+      }
+    } else if (proofreadStatus === 'done') {
+      await block.getByText('本段完成校对', { exact: true }).first().hover();
+      await page.waitForTimeout(600);
+      const reEdit = block.getByText('重新编辑', { exact: true });
+      if ((await reEdit.count()) === 0 || !(await reEdit.first().isVisible())) {
+        return { ok: false, reason: '未找到「重新编辑」入口', proofreadStatus };
+      }
+      await reEdit.first().click();
+    } else {
+      await block.hover();
+      await page.waitForTimeout(600);
+      const reEdit = block.getByText('重新编辑', { exact: true });
+      if ((await reEdit.count()) > 0 && (await reEdit.first().isVisible())) {
+        await reEdit.first().click();
+      } else if (await clickEnterEdit(block)) {
+        // ok
+      } else {
+        return { ok: false, reason: '无法进入编辑模式（未找到入口）', proofreadStatus };
+      }
+    }
+
+    await block.getByRole('button', { name: '确认校对' }).waitFor({ state: 'visible', timeout: 10000 });
+    await page.waitForTimeout(400);
+    return { ok: true, proofreadStatus };
+  }
+
+  async function confirmProofread(title) {
+    const block = sectionBlock(title);
+    await block.getByRole('button', { name: '确认校对' }).click();
+    await page.waitForTimeout(1000);
+    return { ok: true };
+  }
+
+  async function waitReplaceReady(timeoutMs = 120000) {
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    await replaceBtn.waitFor({ state: 'visible', timeout: timeoutMs });
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+      if (await replaceBtn.isEnabled()) return replaceBtn;
+      await page.waitForTimeout(1000);
+    }
+    throw new Error('等待「替换原文」可点击超时');
+  }
+
+  async function aiRewriteGenerate(title, extra) {
+    const block = sectionBlock(title);
+    await block.getByRole('button', { name: /AI\s*改写/ }).click();
+    await main.getByText('原文内容', { exact: true }).waitFor({ state: 'visible', timeout: 10000 });
+
+    if (extra) {
+      const extraBox = main.getByRole('textbox', { name: '额外需求' });
+      if ((await extraBox.count()) > 0) await extraBox.fill(extra);
+    }
+
+    await main.getByRole('button', { name: '一键重写' }).click();
+    await waitReplaceReady();
+
+    return { ok: true, generated: true, replaceReady: true };
+  }
+
+  async function aiRewriteReplace() {
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    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, replaced: true };
+  }
+
+  await dismissPopconfirmOnly();
+
+  const needOpenEdit = action === null || action === '' || action === undefined || action === 'confirm' || action === 'ai_rewrite';
+  let opened = { ok: true, proofreadStatus: 'already_editing' };
+
+  if (needOpenEdit && action !== 'replace') {
+    opened = await openSectionEdit(sectionTitle);
+    if (!opened.ok) return { ok: false, intent, sectionTitle, ...opened };
+  }
+
+  if (action === null || action === undefined || action === '') {
+    return {
+      ok: true,
+      needsUserChoice: true,
+      intent,
+      sectionTitle,
+      proofreadStatus: opened.proofreadStatus,
+      availableActions: ['confirm', 'ai_rewrite'],
+      message: '已进入该段编辑模式。请选择：① 确认校对（直接完成本段校对）② AI 改写（AI 重新生成内容）',
+      url: page.url(),
+    };
+  }
+
+  if (action === 'confirm') {
+    await confirmProofread(sectionTitle);
+    const block = sectionBlock(sectionTitle);
+    const afterStatus = await detectProofreadStatus(block);
+    return {
+      ok: true,
+      intent,
+      sectionTitle,
+      action,
+      proofreadStatusBefore: opened.proofreadStatus,
+      proofreadStatusAfter: afterStatus,
+      message: '本段已确认校对完成。',
+      url: page.url(),
+    };
+  }
+
+  if (action === 'ai_rewrite') {
+    const generated = await aiRewriteGenerate(sectionTitle, extraRequirement);
+    return {
+      ok: generated.ok,
+      intent,
+      sectionTitle,
+      action,
+      extraRequirement: extraRequirement || null,
+      generated: true,
+      needsReplaceChoice: true,
+      availableActions: ['replace'],
+      message:
+        'AI 改写结果已生成。请在右侧查看「生成结果」，确认无误后告知我「替换原文」以应用；若不满意可直接在页面调整或重新生成。',
+      url: page.url(),
+    };
+  }
+
+  if (action === 'replace') {
+    const replaced = await aiRewriteReplace();
+    return {
+      ok: replaced.ok,
+      intent,
+      sectionTitle,
+      action,
+      replaced: true,
+      message: '已替换原文。如需完成本段校对，请明确告知「确认校对」。',
+      url: page.url(),
+    };
+  }
+
+  return {
+    ok: false,
+    reason: `未知 action「${action}」，应为 null | confirm | ai_rewrite | replace`,
+    intent,
+    sectionTitle,
+  };
+}