helixlife-v5-cli 1.2.0 → 1.2.2

package/lib/visual.js

@@ -0,0 +1,248 @@
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const INIT_SCRIPT_PATH = path.join(__dirname, 'automation-overlay.init.js');
+const GENERATED_CONFIG_PATH = path.join(__dirname, '.cli.runtime.generated.json');
+
+/** 默认开启页面内视觉反馈；HELIX_VISUAL=0 可全局关闭 */
+const DEFAULT_VISUAL_ENABLED = process.env.HELIX_VISUAL !== '0';
+
+const VISUAL_COMMANDS = {
+  click: { pending: '正在点击', success: '已点击', pendingTone: 'pending', successTone: 'success' },
+  dblclick: { pending: '正在双击', success: '已双击', pendingTone: 'pending', successTone: 'success' },
+  fill: { pending: '正在填写', success: '已填写', pendingTone: 'pending', successTone: 'success' },
+  hover: { pending: '正在悬停', success: '已悬停', pendingTone: 'info', successTone: 'info' },
+  check: { pending: '正在勾选', success: '已勾选', pendingTone: 'pending', successTone: 'success' },
+  uncheck: { pending: '正在取消勾选', success: '已取消勾选', pendingTone: 'pending', successTone: 'info' },
+  select: { pending: '正在选择', success: '已选择', pendingTone: 'pending', successTone: 'success' },
+  drag: { pending: '正在拖拽', success: '已拖拽', pendingTone: 'pending', successTone: 'success' },
+  drop: { pending: '正在放置', success: '已放置', pendingTone: 'pending', successTone: 'success' },
+  upload: { hudOnly: true, pending: '正在上传', success: '已上传', pendingTone: 'pending', successTone: 'success' },
+  press: { hudOnly: true, pending: '按键', success: '按键完成', pendingTone: 'info', successTone: 'success' },
+  type: { hudOnly: true, pending: '正在输入', success: '输入完成', pendingTone: 'pending', successTone: 'success' },
+};
+
+const SESSION_START_COMMANDS = new Set(['open', 'attach']);
+
+function readInitScriptSource() {
+  return fs.readFileSync(INIT_SCRIPT_PATH, 'utf8');
+}
+
+function resolveGeneratedConfigPath() {
+  const payload = {
+    browser: {
+      initScript: [INIT_SCRIPT_PATH.replace(/\\/g, '/')],
+    },
+  };
+  fs.writeFileSync(GENERATED_CONFIG_PATH, JSON.stringify(payload, null, 2), 'utf8');
+  return GENERATED_CONFIG_PATH;
+}
+
+/**
+ * 从 argv 中提取并剥离 --visual / --no-visual / --visual-ms。
+ * @returns {{ tokens: string[], visual: { enabled: boolean, durationMs: number | null } }}
+ */
+function parseVisualFlags(tokens) {
+  const visual = {
+    enabled: DEFAULT_VISUAL_ENABLED,
+    durationMs: null,
+  };
+  const out = [];
+  for (let i = 0; i < tokens.length; i += 1) {
+    const t = tokens[i];
+    if (t === '--visual') {
+      visual.enabled = true;
+    } else if (t === '--no-visual') {
+      visual.enabled = false;
+    } else if (t === '--visual-ms') {
+      visual.durationMs = tokens[i + 1];
+      i += 1;
+    } else if (t.startsWith('--visual-ms=')) {
+      visual.durationMs = t.slice('--visual-ms='.length);
+    } else {
+      out.push(t);
+    }
+  }
+  if (visual.durationMs != null) {
+    const n = Number(visual.durationMs);
+    if (!Number.isFinite(n) || n <= 0) {
+      throw Object.assign(new Error(`--visual-ms 需要正数，收到 ${JSON.stringify(visual.durationMs)}`), { code: 'E_BAD_ARG' });
+    }
+    visual.durationMs = Math.round(n);
+  }
+  return { tokens: out, visual };
+}
+
+function hasConfigFlag(tokens) {
+  return tokens.some((t) => t === '--config' || t.startsWith('--config='));
+}
+
+/**
+ * open / attach 时自动注入 initScript 配置，使新页面预装视觉层。
+ */
+function injectVisualConfig(tokens, visual) {
+  if (!visual.enabled) return tokens;
+  const cmd = resolveCommandName(tokens);
+  if (!SESSION_START_COMMANDS.has(cmd) || hasConfigFlag(tokens)) {
+    return tokens;
+  }
+  const configPath = resolveGeneratedConfigPath();
+  return [...tokens, `--config=${configPath}`];
+}
+
+function resolveCommandName(tokens) {
+  let i = 0;
+  if (tokens[i] === '--raw') i += 1;
+  if (tokens[i] === '--json') i += 1;
+  if (tokens[i] && tokens[i].startsWith('-s=')) i += 1;
+  return tokens[i] || '';
+}
+
+function isElementRef(token) {
+  if (!token || token.startsWith('-')) return false;
+  if (/^e\d+$/.test(token)) return true;
+  if (token.startsWith('"') || token.startsWith("'")) return true;
+  if (token.startsWith('#') || token.startsWith('.')) return true;
+  if (token.startsWith('getBy')) return true;
+  return false;
+}
+
+/**
+ * 从命令参数中提取主要元素 target（用于高亮）。
+ */
+function extractElementTarget(tokens) {
+  const cmd = resolveCommandName(tokens);
+  if (!VISUAL_COMMANDS[cmd]) return null;
+  const def = VISUAL_COMMANDS[cmd];
+  if (def.hudOnly) return null;
+
+  let i = 0;
+  if (tokens[i] === '--raw') i += 1;
+  if (tokens[i] === '--json') i += 1;
+  if (tokens[i] && tokens[i].startsWith('-s=')) i += 1;
+  i += 1; // skip command name
+
+  const positional = [];
+  for (; i < tokens.length; i += 1) {
+    const t = tokens[i];
+    if (t.startsWith('--')) {
+      if (t.includes('=')) continue;
+      const next = tokens[i + 1];
+      if (next !== undefined && !next.startsWith('-')) i += 1;
+      continue;
+    }
+    positional.push(t);
+  }
+
+  if (cmd === 'drag' && positional.length >= 1) return positional[0];
+  if (cmd === 'fill' && positional.length >= 1) return positional[0];
+  if (cmd === 'select' && positional.length >= 1) return positional[0];
+  if (cmd === 'drop' && positional.length >= 1) return positional[0];
+  if (positional.length >= 1 && isElementRef(positional[0])) return positional[0];
+  if (positional.length >= 2 && isElementRef(positional[positional.length - 1])) {
+    return positional[positional.length - 1];
+  }
+  return null;
+}
+
+function buildFlashEval(target, options) {
+  const optsLit = JSON.stringify(options);
+  return [
+    'eval',
+    `el => { const v = window.__helix_visual__; if (!v) return false; return v.flash(el, ${optsLit}); }`,
+    target,
+  ];
+}
+
+function buildHudEval(options) {
+  const optsLit = JSON.stringify(options);
+  return ['eval', `() => { const v = window.__helix_visual__; if (!v) return false; return v.showHud(${optsLit}); }`];
+}
+
+function buildSetOptionsEval(visual) {
+  const payload = JSON.stringify({
+    enabled: visual.enabled,
+    durationMs: visual.durationMs,
+  });
+  return ['eval', `() => { const v = window.__helix_visual__; if (!v) return null; return v.setVisualOptions(${payload}); }`];
+}
+
+function buildInstallEval() {
+  const src = readInitScriptSource();
+  return ['eval', src];
+}
+
+function buildBridgeCheckEval() {
+  return ['eval', '--raw', 'Boolean(window.__helix_visual__)'];
+}
+
+function shouldWrapWithVisual(tokens, visual) {
+  if (!visual.enabled) return false;
+  const cmd = resolveCommandName(tokens);
+  return Boolean(VISUAL_COMMANDS[cmd]);
+}
+
+/**
+ * 在元素交互命令前后注入视觉反馈。
+ * @param {string[]} tokens 已剥离 visual flags 的参数
+ * @param {{ enabled: boolean, durationMs: number | null }} visual
+ * @param {(args: string[], opts?: object) => number} runPassthrough
+ */
+async function runWithVisualFeedback(tokens, visual, runPassthrough) {
+  const cmd = resolveCommandName(tokens);
+  const def = VISUAL_COMMANDS[cmd];
+  const target = extractElementTarget(tokens);
+
+  const runCapture = (args) => runPassthrough(args, { capture: true });
+
+  const check = runCapture(buildBridgeCheckEval());
+  if (String(check.stdout || '').trim() !== 'true') {
+    runCapture(buildInstallEval());
+  }
+  runCapture(buildSetOptionsEval(visual));
+
+  const hudBase = { action: cmd, target: target || '', status: 'pending' };
+  runCapture(buildHudEval({ ...hudBase, detail: def.pending }));
+
+  if (target) {
+    runCapture(buildFlashEval(target, {
+      tone: def.pendingTone || 'pending',
+      label: def.pending,
+      durationMs: visual.durationMs,
+    }));
+  }
+
+  const code = runPassthrough(tokens);
+
+  const successTone = code === 0 ? (def.successTone || 'success') : 'danger';
+  const successLabel = code === 0 ? def.success : '操作失败';
+  runCapture(buildSetOptionsEval(visual));
+  if (target) {
+    runCapture(buildFlashEval(target, {
+      tone: successTone,
+      label: successLabel,
+      durationMs: visual.durationMs,
+    }));
+  }
+  runCapture(buildHudEval({
+    action: cmd,
+    target: target || '',
+    status: code === 0 ? 'success' : 'danger',
+    detail: successLabel,
+  }));
+
+  return code;
+}
+
+module.exports = {
+  INIT_SCRIPT_PATH,
+  VISUAL_COMMANDS,
+  DEFAULT_VISUAL_ENABLED,
+  parseVisualFlags,
+  injectVisualConfig,
+  shouldWrapWithVisual,
+  runWithVisualFeedback,
+  resolveGeneratedConfigPath,
+};

package/package.json

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

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

@@ -0,0 +1,149 @@
+/**
+ * 综述工作台（jova）· 确认提纲页 · 节点 AI 重新生成
+ *
+ * 典型场景：用户说「扩写前言」「精简结论」「润色 1. xxx」等。
+ *
+ * 流程：
+ *   悬停提纲节点 → 编辑 → 填写「用户需求」→「一键生成」
+ *   → 等待「生成结果」→「替换原文」→ Popconfirm「确 定」→「保 存」
+ *
+ * 用法（仅需改 intent 一行，或显式指定 nodeTitle / userRequirement）：
+ *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+ *
+ * intent 解析规则：
+ *   「扩写前言」     → nodeTitle=前言,     userRequirement=扩写
+ *   「精简结论」     → nodeTitle=结论,     userRequirement=精简
+ *   「润色摘要：」   → nodeTitle=摘要：,   userRequirement=润色
+ *   无法解析时整句作为 userRequirement，nodeTitle 回退为「前言」
+ */
+async page => {
+  // ── Agent 通常只改这一行 ──
+  const intent = '扩写前言';
+
+  // 也可显式覆盖（非 null 时优先于 intent 解析）
+  const nodeTitleOverride = null;
+  const userRequirementOverride = null;
+
+  function parseIntent(raw) {
+    const verbs = ['扩写', '精简', '改写', '润色', '重写', '优化'];
+    for (const verb of verbs) {
+      if (raw.startsWith(verb)) {
+        const title = raw.slice(verb.length).trim();
+        if (title) return { nodeTitle: title, userRequirement: verb };
+      }
+    }
+    return { nodeTitle: '前言', userRequirement: raw };
+  }
+
+  const parsed = parseIntent(intent);
+  const nodeTitle = nodeTitleOverride ?? parsed.nodeTitle;
+  const userRequirement = userRequirementOverride ?? parsed.userRequirement;
+
+  const main = page.locator('main');
+
+  if (!page.url().includes('/workbench/jova/outline')) {
+    return {
+      ok: false,
+      reason: '当前不在综述工作台确认提纲页 /workbench/jova/outline',
+      intent,
+      nodeTitle,
+      userRequirement,
+    };
+  }
+
+  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,
+      reason: `未找到提纲节点「${nodeTitle}」`,
+      intent,
+      nodeTitle,
+      userRequirement,
+    };
+  }
+
+  // 1. 悬停 → 编辑
+  await opArea.hover();
+  await page.waitForTimeout(400);
+  await opArea.getByRole('button', { name: '编辑' }).click();
+
+  // 2. 右侧「重新生成」面板
+  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);
+
+  // 3. 一键生成 → 等待「替换原文」可用
+  await main.getByRole('button', { name: '一键生成' }).click();
+  const replaceBtn = main.getByRole('button', { name: '替换原文' });
+  await replaceBtn.waitFor({ state: 'visible', timeout: 120000 });
+  await page.waitForTimeout(800);
+
+  // 4. 替换原文 → Popconfirm「是否将本次生成结果替换原文？」→ 确 定
+  await replaceBtn.click();
+  const confirmPrompt = main.getByText('是否将本次生成结果替换原文？', { exact: true });
+  await confirmPrompt.waitFor({ state: 'visible', timeout: 10000 });
+  await main.getByRole('button', { name: '确 定' }).click();
+  await page.waitForTimeout(800);
+
+  // 5. 左侧内联编辑器「保 存」
+  const saveBtn = main.getByRole('button', { name: '保 存' });
+  await saveBtn.waitFor({ state: 'visible', timeout: 10000 });
+  const inlineEditor = saveBtn.locator('xpath=ancestor::li[1]//textarea | ancestor::li[1]//input[@type="text"] | ancestor::li[1]//*[@role="textbox"]').first();
+  const editorText = (await inlineEditor.inputValue().catch(() => '')) || (await inlineEditor.textContent().catch(() => '')) || '';
+
+  await saveBtn.click();
+  await page.waitForTimeout(1000);
+
+  const panelClosed = !(await regenTitle.isVisible().catch(() => false));
+  const nodePresent = (await outlineNode(nodeTitle).count()) > 0;
+  const contentApplied = editorText.includes(nodeTitle) || editorText.length > 0;
+
+  return {
+    ok: nodePresent && panelClosed && contentApplied,
+    intent,
+    nodeTitle,
+    userRequirement,
+    panelClosed,
+    nodePresent,
+    contentApplied,
+    editorTextLength: editorText.length,
+    url: page.url(),
+  };
+}

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

@@ -0,0 +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,
+  };
+}