helixlife-v5-cli 1.2.5 → 1.2.7

package/lib/cli.js

@@ -1,6 +1,5 @@
 'use strict';
 
-const fs = require('node:fs');
 const path = require('node:path');
 const { spawnSync } = require('node:child_process');
 
@@ -200,67 +199,11 @@ 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(resolved));
+    ({ tokens: stripped, visual } = parseVisualFlags(tokens));
   } catch (e) {
     console.error(`[${PACKAGE_JSON.name}] ${e.message}`);
     return 3;
@@ -333,6 +276,4 @@ module.exports = {
   buildChildEnv,
   DEFAULT_OUTPUT_DIR_NAME,
   runPassthroughWithVisual,
-  resolveRunCodeFilename,
-  packageScriptsDir,
 };

package/package.json

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

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

@@ -24,59 +24,6 @@
 - **对用户回复的门禁**：在 `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。
@@ -97,7 +44,6 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
   - **定位与多命中**：推荐 `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。
 
 #### 任务范围与跨域
 
@@ -209,7 +155,7 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 | 对话 · 新建会话 | S-09 |
 | 工作站 · 新建任务弹窗 | S-10 |
 | 工作台 · 进入子工作台 | S-11 |
-| 工作台 · 综述全流程；**「扩写前言」等必先 dispatch.js，禁止添加子级** | WB-1 |
+| 工作台 · 综述全流程（拟定主题→精修） | WB-1 |
 | 工作台 · SCI 论著全流程 | WB-2 |
 | 工作台 · 国自然基金全流程 | WB-3 |
 | 工作台 · 临床申请书全流程 | WB-4 |
@@ -448,7 +394,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` | 左侧「论文提纲」树；节点 hover 后出现 **编辑**（AI 扩写/润色/精简）与 **添加同级/添加子级**（仅改树结构，**禁止**用于「扩写前言」）。章节 AI 操作 **必须** `run-code` → `scripts/workbench-jova-dispatch.js` | `返回主题`；`下载提纲`；`生成全文` |
+| 确认提纲 | `/workbench/jova/outline` | 左侧「论文提纲」树；节点行内为**无文案图标按钮**（仅 `编辑`/`添加同级`/`添加子级`/`删除` 四个**结构**操作，`hover` 后才出现，需时用 `generate-locator` 固化，勿记 `e*`）。**AI 重写（扩写/精简/润色等）不在这些按钮里**，见下方 WB-1 关键动作 5 | `返回主题`；`下载提纲`；`生成全文` |
 | 初稿校对 | `/workbench/jova/proofread` | 左目录 + 右正文；段落带「请校对本段内容」提示 | `返回提纲`；`下载文档`；`完成校对` |
 | 初稿精修 | `/workbench/jova/writing` | 左目录 + 中央 `textbox` 富文本；顶栏 **修订模式**（含接受/拒绝修订） | `返回提纲`；`修订模式` 切换钮（文案含 `接受修订` / `拒绝修订`）；`新建论文`；`下载文档` |
 
@@ -458,86 +404,40 @@ 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 重写（扩写 / 精简 / 润色 / 改写 / 重写 / 优化）**：用户说「扩写前言」「**扩写摘要**」「精简结论」「润色 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`。
 
-**WB-1 · 用户说法与脚本路由（Agent 硬门禁）**
-
-> 用户说「扩写前言」却被做成「添加子级」的根因：**同一动词在不同步骤页含义不同**，且 outline 树按钮默认隐藏（须 hover）。**必须先** `eval location.pathname`，**必须优先** `run-code` 下表脚本，禁止从 snapshot 猜「添加子级」。
-
-**0 · 定页（第一步，不可跳过）**
+###### 提纲节点 AI 重写 · Agent 硬门禁（WB-1 / outline · 必读）
 
-> 与上文「工作台 · 扩写前言等 · Agent 硬门禁」一致；**WorkBuddy 默认只执行 `workbench-jova-dispatch.js`**，勿手写 click「添加子级」。
+> **触发**：`/workbench/jova/outline`（或结构相同的 `sci`/`nsfc-v2`/`clinical` outline 步）且用户指令含 {扩写, 精简, 改写, 润色, 重写, 优化} + 提纲节点名（前言、摘要、结论、1. xxx …）。
 
-```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-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` |
-
-执行：`HELIX_JOVA_INTENT='扩写前言' helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js`（**唯一首选**；**禁止**成功后手工 hover/click/fill）
-
-**2 · outline 页：扩写 ≠ 添加子级（反模式）**
-
-确认提纲页左侧为**提纲树**（非正文）。节点行 `aria-label` 含「操作区」；**移入前**行内按钮不可见。移入后出现：
-
-| 按钮 | 作用 | 用户何时才会要 |
+| 用户说法示例 | `HELIX_INTENT` | 解析结果 |
 | --- | --- | --- |
-| **编辑** | 右侧「重新生成」→ 用户需求（扩写/精简/润色等）→ 一键生成 → 替换 → 保存 | **扩写前言、润色某节**等改**节点文字** |
-| 添加同级 | 树结构新增同级节点 | 用户明确说「加同级提纲」 |
-| **添加子级** | 树结构新增子节点 | 用户明确说「加子标题/子条目」 |
-| 删除 | 删节点 | 用户明确说删除 |
-
-**禁止**：将「扩写 / 精简 / 润色 / 改写 + 章节名」映射为「添加子级」或「添加同级」。前者是 **AI 重写该节点正文**（`编辑` 路径），后者只改提纲层级。
-
-`outline-regenerate-node.js` 已实现：定位 `[aria-label*="操作区"]` 且首列文案匹配章节 → hover → **编辑**（不点添加子级）。
+| 扩写前言 | `扩写前言` | 节点=前言，用户需求=扩写 |
+| 扩写摘要 | `扩写摘要` | 节点=摘要，用户需求=扩写 |
+| 精简结论 | `精简结论` | 节点=结论，用户需求=精简 |
+| 润色 1. 乳腺癌… | `润色 1. 乳腺癌…` | 节点=1. 乳腺癌…，用户需求=润色 |
 
-**3 · writing 页：右侧 AI 工具栏**
+**执行（必用同一脚本，禁止复制改写）**
 
-精修页中央为富文本 `textbox`；**右侧竖栏**文案：校对、文风、润色、降重、翻译、改写、**扩写**、缩写、文献列表。用户「扩写前言」在 **writing** 页时：选章节 → 点栏内 **扩写** → 一键生成（走 `writing-tool.js`），**不是** outline 树操作。
-
-| 工具 | 特殊项 |
-| --- | --- |
-| 文风 | `getByRole('textbox', { name: '参考文风' })` **必填** |
-| 文献列表 | 仅打开列表，无一键生成 |
-| 其余 7 项 | 原文内容 + `getByRole('button', { name: '一键生成' })` + 生成结果 + `替换原文` |
-
-**4 · 生成后门禁**
-
-- 脚本返回 `needsReplaceChoice` 或用户未说「替换原文」：**禁止**自动点「替换原文」。
-- proofread 脚本：用户仅说「校对 xxx」时 **禁止**自动「确认校对」。
-- writing · 文风：`参考文风` 为必填；`writing-tool.js` 会用 `referenceStyle` 或选中段落兜底。
-
-**5 · 禁止的低效路径（导致 Agent 数分钟仍失败）**
-
-1. 在 **outline** 页对用户「扩写/润色/精简 + 章节」点「添加子级」或「添加同级」——**永远不对**。
-2. 不 `eval location.pathname` 就在 **proofread / writing** 页找提纲树「编辑」或「添加子级」。
-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 · 执行命令模板**
+```powershell
+# PowerShell — 将引号内换成用户原话
+$env:HELIX_INTENT='扩写摘要'; helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+```
 
 ```bash
-# ① 定页（不可跳过）
-helixlife-v5-cli --raw eval "location.pathname"
-
-# ② 一条命令完成（示例 PowerShell）
-$env:HELIX_JOVA_INTENT='扩写前言'
-helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+# Bash / macOS
+HELIX_INTENT='扩写摘要' helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
 ```
 
-`--filename=scripts/...` 相对于 cwd；cwd 无该文件时自动解析为 `node_modules/helixlife-v5-cli/scripts/...`。
+**反模式（常见导致误操作「前言」或重复造脚本）**
+
+- 直接 `run-code` 而不设 `HELIX_INTENT` → 脚本会报错并拒绝执行（勿改脚本内默认值绕过）。
+- 用户说「扩写摘要」却新建 `workbench-jova-outline-regenerate-abstract.js` 等副本 → **禁止**；节点标题差异仅体现在 `HELIX_INTENT`。
+- 用 `添加子级` / `添加同级` 代替 AI 重写 → 只会插入空节点。
+
+**显式拆分（可选）**：`HELIX_NODE_TITLE` + `HELIX_USER_REQUIREMENT` 同时设置时优先于 `HELIX_INTENT`。
 
 ---
 
@@ -619,7 +519,6 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 **用户说法映射**
 
 - 「写综述 / 综述工作台」→ 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-outline-regenerate-node.js

@@ -1,154 +1,173 @@
-/**
- * 综述工作台（jova）· 确认提纲页（/workbench/jova/outline）· 节点 AI 重新生成
- *
- * 【页面门禁】仅用于 pathname 含 /workbench/jova/outline；writing 页扩写走 writing-tool.js。
- *
- * 【禁止误判】用户「扩写前言」= 本脚本（hover → 编辑 → 重新生成），绝不是提纲树「添加子级」。
- *
- * 典型场景：用户说「扩写前言」「扩写 前言」「精简结论」「润色 1. xxx」等。
- *
- * 流程：
- *   悬停提纲节点 → 编辑（不点添加子级/添加同级）→ 填写「用户需求」→「一键生成」
- *   → 等待「生成结果」→「替换原文」→ Popconfirm「确 定」→「保 存」
- *
- * 用法（WorkBuddy 请优先用 workbench-jova-dispatch.js；本文件为 outline 子脚本）：
- *   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 = ['扩写', '精简', '改写', '润色', '重写', '优化'];
-    const text = raw.trim();
-    for (const verb of verbs) {
-      if (text.startsWith(verb)) {
-        const title = text.slice(verb.length).trim();
-        if (title) return { nodeTitle: title, userRequirement: verb };
-      }
-    }
-    return { nodeTitle: '前言', userRequirement: text };
-  }
-
-  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(),
-  };
-}
+/**
+ * 综述工作台（jova）· 确认提纲页 · 节点 AI 重新生成
+ *
+ * 典型场景：用户说「扩写前言」「扩写摘要」「精简结论」「润色 1. xxx」等。
+ *
+ * 流程：
+ *   悬停提纲节点 → 编辑 → 填写「用户需求」→「一键生成」
+ *   → 等待「生成结果」→「替换原文」→ Popconfirm「确 定」→「保 存」
+ *
+ * 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 / HELIX_INTENT 解析规则（<动词><节点标题>，动词与标题间可有可无空格）：
+ *   「扩写前言」     → nodeTitle=前言,     userRequirement=扩写
+ *   「扩写摘要」     → nodeTitle=摘要,     userRequirement=扩写
+ *   「精简结论」     → nodeTitle=结论,     userRequirement=精简
+ *   「润色 1. xxx」  → nodeTitle=1. xxx,   userRequirement=润色
+ *   无法解析时整句作为 userRequirement，nodeTitle 回退为「前言」
+ */
+async page => {
+  const intent = (process.env.HELIX_INTENT || '').trim();
+
+  const nodeTitleOverride = process.env.HELIX_NODE_TITLE?.trim() || null;
+  const userRequirementOverride = process.env.HELIX_USER_REQUIREMENT?.trim() || null;
+
+  const VERBS = ['扩写', '精简', '改写', '润色', '重写', '优化'];
+
+  function parseIntent(raw) {
+    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: normalized || raw };
+  }
+
+  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')) {
+    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(),
+  };
+}