helixlife-v5-cli 1.2.2 → 1.2.3

package/package.json

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

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

@@ -155,7 +155,7 @@
 | 对话 · 新建会话 | S-09 |
 | 工作站 · 新建任务弹窗 | S-10 |
 | 工作台 · 进入子工作台 | S-11 |
-| 工作台 · 综述全流程（拟定主题→精修） | WB-1 |
+| 工作台 · 综述全流程（拟定主题→精修）；**扩写/润色/校对/翻译等必先定页+run-code 脚本** | WB-1 |
 | 工作台 · SCI 论著全流程 | WB-2 |
 | 工作台 · 国自然基金全流程 | WB-3 |
 | 工作台 · 临床申请书全流程 | WB-4 |
@@ -407,6 +407,76 @@ div.side-menu--item[to='/edu/courses']
 
 **取消全文生成弹窗**：同 dialog 内 `getByRole('button', { name: '取 消' })` 或 `Close`。
 
+**WB-1 · 用户说法与脚本路由（Agent 硬门禁）**
+
+> 用户说「扩写前言」却被做成「添加子级」的根因：**同一动词在不同步骤页含义不同**，且 outline 树按钮默认隐藏（须 hover）。**必须先** `eval location.pathname`，**必须优先** `run-code` 下表脚本，禁止从 snapshot 猜「添加子级」。
+
+**0 · 定页（第一步，不可跳过）**
+
+```bash
+helixlife-v5-cli --raw eval "location.pathname"
+```
+
+**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`（**工具与章节间建议空格**：`扩写 前言`） |
+
+执行：`helixlife-v5-cli run-code --filename=scripts/<上表脚本名>`
+
+**2 · outline 页：扩写 ≠ 添加子级（反模式）**
+
+确认提纲页左侧为**提纲树**（非正文）。节点行 `aria-label` 含「操作区」；**移入前**行内按钮不可见。移入后出现：
+
+| 按钮 | 作用 | 用户何时才会要 |
+| --- | --- | --- |
+| **编辑** | 右侧「重新生成」→ 用户需求（扩写/精简/润色等）→ 一键生成 → 替换 → 保存 | **扩写前言、润色某节**等改**节点文字** |
+| 添加同级 | 树结构新增同级节点 | 用户明确说「加同级提纲」 |
+| **添加子级** | 树结构新增子节点 | 用户明确说「加子标题/子条目」 |
+| 删除 | 删节点 | 用户明确说删除 |
+
+**禁止**：将「扩写 / 精简 / 润色 / 改写 + 章节名」映射为「添加子级」或「添加同级」。前者是 **AI 重写该节点正文**（`编辑` 路径），后者只改提纲层级。
+
+`outline-regenerate-node.js` 已实现：定位 `[aria-label*="操作区"]` 且首列文案匹配章节 → hover → **编辑**（不点添加子级）。
+
+**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 --filename=scripts/workbench-jova-*.js`，改用手动 `snapshot` + `click` 拼 hover 才出现的图标按钮。
+4. 同一轮任务内反复 `snapshot` 猜 `e*` ref 定位提纲节点（须脚本内 `aria-label*="操作区"` + 章节文案匹配）。
+
+**6 · 执行命令模板**
+
+```bash
+# ① 定页（不可跳过）
+helixlife-v5-cli --raw eval "location.pathname"
+
+# ② 按上表改脚本内 intent / action 后执行，示例：
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+```
+
+脚本路径相对于**打开浏览器时的工作区根**（helix-cli 仓库即 `scripts/...`）。
+
 ---
 
 ##### WB-2：SCI 论著工作台（`sci`）

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

@@ -1,19 +1,23 @@
 /**
- * 综述工作台（jova）· 确认提纲页 · 节点 AI 重新生成
+ * 综述工作台（jova）· 确认提纲页（/workbench/jova/outline）· 节点 AI 重新生成
  *
- * 典型场景：用户说「扩写前言」「精简结论」「润色 1. xxx」等。
+ * 【页面门禁】仅用于 pathname 含 /workbench/jova/outline；writing 页扩写走 writing-tool.js。
+ *
+ * 【禁止误判】用户「扩写前言」= 本脚本（hover → 编辑 → 重新生成），绝不是提纲树「添加子级」。
+ *
+ * 典型场景：用户说「扩写前言」「扩写 前言」「精简结论」「润色 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=润色
+ * intent 解析规则（动词与章节可连写或空格）：
+ *   「扩写前言」「扩写 前言」 → nodeTitle=前言, userRequirement=扩写
+ *   「精简结论」             → nodeTitle=结论, userRequirement=精简
+ *   「润色摘要：」             → nodeTitle=摘要：, userRequirement=润色
  *   无法解析时整句作为 userRequirement，nodeTitle 回退为「前言」
  */
 async page => {
@@ -26,13 +30,14 @@ async page => {
 
   function parseIntent(raw) {
     const verbs = ['扩写', '精简', '改写', '润色', '重写', '优化'];
+    const text = raw.trim();
     for (const verb of verbs) {
-      if (raw.startsWith(verb)) {
-        const title = raw.slice(verb.length).trim();
+      if (text.startsWith(verb)) {
+        const title = text.slice(verb.length).trim();
         if (title) return { nodeTitle: title, userRequirement: verb };
       }
     }
-    return { nodeTitle: '前言', userRequirement: raw };
+    return { nodeTitle: '前言', userRequirement: text };
   }
 
   const parsed = parseIntent(intent);

package/scripts/workbench-jova-writing-tool.js

@@ -1,5 +1,7 @@
 /**
- * 综述工作台（jova）· 初稿精修页 · 右侧 AI 工具
+ * 综述工作台（jova）· 初稿精修页（/workbench/jova/writing）· 右侧 AI 工具
+ *
+ * 【页面门禁】仅用于 pathname 含 /workbench/jova/writing；outline 页「扩写前言」走 outline-regenerate-node.js。
  *
  * 支持工具（右侧栏）：校对、文风、润色、降重、翻译、改写、扩写、缩写、文献列表
  *