helixlife-v5-cli 1.2.4 → 1.2.5

package/lib/cli.js

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

package/package.json

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

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

@@ -50,19 +50,30 @@
 # ① 定页
 helixlife-v5-cli --raw eval "location.pathname"
 
-# ② 统一入口（WorkBuddy 默认只跑这一条；改脚本内 userIntent）
+# ② 统一入口（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
 ```
 
-脚本内按 `pathname` 自动路由；**outline 页**走 `hover → 编辑 → 重新生成`，**绝不**点「添加子级」。若当前页为 proofread / writing，脚本返回应使用的子脚本名，**仍禁止**点「添加子级」。
+工作区无 `scripts/` 时 CLI **自动回退**到 `node_modules/helixlife-v5-cli/scripts/` 同名文件；**禁止**复制脚本到 WorkBuddy 目录再改 `userIntent`。
 
-**子脚本（由 dispatch 内部或返回值指定，勿手写 click 提纲树）**
+脚本内按 `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` |
-| `…/jova/writing` | `扩写 前言` / `翻译 前言` | `workbench-jova-writing-tool.js` |
 
 细则与按钮对照表：下文 **WB-1 · 用户说法与脚本路由**。
 
@@ -460,20 +471,21 @@ div.side-menu--item[to='/edu/courses']
 
 ```bash
 helixlife-v5-cli --raw eval "location.pathname"
+# PowerShell: $env:HELIX_JOVA_INTENT='扩写前言'
 helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 ```
 
-（改 dispatch 内 `userIntent`；outline 页在 dispatch 内直接完成，禁止点「添加子级」。）
+（用 `HELIX_JOVA_INTENT` 传用户说法；outline/writing 在 dispatch 内直接完成，禁止点「添加子级」。工作区无 `scripts/` 时 CLI 自动用 npm 包内脚本。）
 
 **1 · 说法 → 脚本（jova 综述）**
 
 | 当前 `pathname` | 用户说法（示例） | 脚本（工作区 `scripts/`） | Agent 改动的变量 |
 | --- | --- | --- | --- |
-| `…/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` |
+| `…/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` |
 
-执行：`helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js`（**首选**）
+执行：`HELIX_JOVA_INTENT='扩写前言' helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js`（**唯一首选**；**禁止**成功后手工 hover/click/fill）
 
 **2 · outline 页：扩写 ≠ 添加子级（反模式）**
 
@@ -510,8 +522,9 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 
 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*="操作区"` + 章节文案匹配）。
+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 · 执行命令模板**
 
@@ -519,11 +532,12 @@ helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 # ① 定页（不可跳过）
 helixlife-v5-cli --raw eval "location.pathname"
 
-# ② 按上表改脚本内 intent / action 后执行，示例：
-helixlife-v5-cli run-code --filename=scripts/workbench-jova-outline-regenerate-node.js
+# ② 一条命令完成（示例 PowerShell）
+$env:HELIX_JOVA_INTENT='扩写前言'
+helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
 ```
 
-脚本路径相对于**打开浏览器时的工作区根**（helix-cli 仓库即 `scripts/...`）。
+`--filename=scripts/...` 相对于 cwd；cwd 无该文件时自动解析为 `node_modules/helixlife-v5-cli/scripts/...`。
 
 ---
 

package/scripts/workbench-jova-dispatch.js

@@ -5,12 +5,14 @@
  * outline 页「扩写前言」等：本脚本内直接执行（hover → 编辑，禁止添加子级）。
  *
  * 用法：
+ *   set HELIX_JOVA_INTENT=扩写前言
  *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-dispatch.js
+ *
+ * WorkBuddy 等工作区无 scripts/ 时，CLI 自动回退到 npm 包内同名脚本；勿复制到 WorkBuddy 目录。
  */
 async page => {
-  // ── Agent 只改这一行（原样粘贴用户说法，如「扩写前言」）──
-  const userIntent = '扩写前言';
-  const action = null; // proofread/writing 子流程用；outline 忽略
+  const userIntent = (process.env.HELIX_JOVA_INTENT || '扩写前言').trim();
+  const action = process.env.HELIX_JOVA_ACTION?.trim() || null;
 
   const pathname = new URL(page.url()).pathname;
   const FORBIDDEN_BUTTONS = ['添加子级', '添加同级'];
@@ -30,18 +32,6 @@ async page => {
     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,
@@ -159,16 +149,201 @@ async page => {
   }
 
   if (pathname.includes('/jova/writing')) {
+    const WRITING_TOOLS = ['校对', '文风', '润色', '降重', '翻译', '改写', '扩写', '缩写', '文献列表'];
+
+    function parseWritingIntent(raw) {
+      const text = raw.trim();
+      for (const tool of WRITING_TOOLS) {
+        if (text === tool || text.startsWith(`${tool} `) || text.startsWith(tool)) {
+          const sectionTitle = text.slice(tool.length).trim();
+          return { tool, sectionTitle: sectionTitle || null };
+        }
+      }
+      for (const verb of outlineVerbs) {
+        if (text.startsWith(verb)) {
+          const sectionTitle = text.slice(verb.length).trim();
+          if (sectionTitle) return { tool: verb === '优化' ? '润色' : verb, sectionTitle };
+        }
+      }
+      return { tool: null, sectionTitle: null };
+    }
+
+    const { tool, sectionTitle } = parseWritingIntent(userIntent);
+    if (!tool || !WRITING_TOOLS.includes(tool)) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        pathname,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: `writing 页无法解析工具，支持：${WRITING_TOOLS.join('、')} 或 ${outlineVerbs.join('/')} + 章节`,
+      };
+    }
+    if (tool !== '文献列表' && !sectionTitle) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        pathname,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: '请指定章节，如「扩写前言」或「翻译 前言」',
+      };
+    }
+
+    const main = page.locator('main');
+
+    async function closeWritingPanel() {
+      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().catch(() => false)) {
+          await icon.click();
+          await page.waitForTimeout(400);
+        }
+      }
+    }
+
+    async function selectWritingSection(title) {
+      if (title) {
+        const toc = main.locator('[class*="cursor-pointer"]').getByText(title, { exact: true });
+        if ((await toc.count()) > 0) {
+          await toc.first().click({ timeout: 5000 }).catch(() => {});
+          await page.waitForTimeout(500);
+        }
+        const heading = main.getByRole('heading', { name: title, exact: true }).first();
+        if ((await heading.count()) > 0) {
+          await heading.scrollIntoViewIfNeeded();
+          await page.waitForTimeout(300);
+        }
+      }
+      const selected = await page.evaluate(t => {
+        const editor = document.querySelector('main [role="textbox"]');
+        if (!editor) return { ok: false, reason: '未找到富文本编辑器' };
+        if (!t) {
+          const range = document.createRange();
+          range.selectNodeContents(editor);
+          const sel = window.getSelection();
+          sel?.removeAllRanges();
+          sel?.addRange(range);
+          return { ok: true };
+        }
+        const headings = [...editor.querySelectorAll('h1,h2,h3,h4,h5,h6')];
+        const idx = headings.findIndex(h => h.textContent?.trim() === t);
+        if (idx < 0) return { ok: false, reason: `编辑器内未找到章节「${t}」` };
+        const start = headings[idx];
+        const level = parseInt(start.tagName[1], 10);
+        let end = null;
+        for (let i = idx + 1; i < headings.length; i++) {
+          if (parseInt(headings[i].tagName[1], 10) <= level) {
+            end = headings[i];
+            break;
+          }
+        }
+        const range = document.createRange();
+        range.setStartBefore(start);
+        range.setEndBefore(end || editor.lastChild || editor);
+        const sel = window.getSelection();
+        sel?.removeAllRanges();
+        sel?.addRange(range);
+        return { ok: true, sectionText: range.toString().slice(0, 200) };
+      }, title);
+      await page.waitForTimeout(400);
+      return selected;
+    }
+
+    await closeWritingPanel();
+    const selected = await selectWritingSection(sectionTitle);
+    if (!selected.ok) {
+      return {
+        ok: false,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        reason: selected.reason,
+      };
+    }
+
+    if (tool === '文献列表') {
+      await main.getByText(tool, { exact: true }).first().click();
+      await page.waitForTimeout(800);
+      return {
+        ok: true,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        mode: 'list',
+        message: '已打开文献列表面板。',
+        url: page.url(),
+      };
+    }
+
+    await main.getByText(tool, { exact: true }).first().click();
+    await page.waitForTimeout(800);
+    await main.getByText('原文内容', { exact: true }).waitFor({ state: 'visible', timeout: 10000 }).catch(() => {});
+
+    if (tool === '文风') {
+      const refBox = main.getByRole('textbox', { name: '参考文风' });
+      if ((await refBox.count()) > 0 && (await refBox.first().isVisible().catch(() => false))) {
+        const ref =
+          selected.sectionText ||
+          'This review synthesizes molecular subtyping and precision therapeutic strategies in breast cancer.';
+        await refBox.first().fill(ref);
+      }
+    }
+    if (tool === '翻译') {
+      for (const label of ['English', '英文']) {
+        const opt = main.getByText(label, { exact: true });
+        if ((await opt.count()) > 0 && (await opt.first().isVisible().catch(() => false))) {
+          await opt.first().click();
+          await page.waitForTimeout(300);
+          break;
+        }
+      }
+    }
+
+    await main.getByRole('button', { name: '一键生成' }).click();
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    await replaceBtn.waitFor({ state: 'visible', timeout: 120000 });
+    const deadline = Date.now() + 120000;
+    while (Date.now() < deadline) {
+      if (await replaceBtn.isEnabled()) break;
+      await page.waitForTimeout(1000);
+    }
+
+    const shouldReplace = action === 'replace' || outlineVerbs.some(v => userIntent.trim().startsWith(v));
+    if (shouldReplace && (await replaceBtn.isEnabled())) {
+      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,
+        route: 'writing',
+        userIntent,
+        tool,
+        sectionTitle,
+        replaced: true,
+        forbiddenNeverClick: FORBIDDEN_BUTTONS,
+        message: `writing 页已通过「${tool}→一键生成→替换原文」完成「${sectionTitle}」。`,
+        url: page.url(),
+      };
+    }
+
     return {
-      ok: false,
+      ok: true,
       route: 'writing',
       userIntent,
-      pathname,
+      tool,
+      sectionTitle,
+      needsReplaceChoice: true,
       forbiddenNeverClick: FORBIDDEN_BUTTONS,
-      nextScript: 'scripts/workbench-jova-writing-tool.js',
-      setIntent: normalizeWritingIntent(userIntent),
-      setAction: action,
-      message: '请改 writing-tool.js 的 intent 后 run-code；writing 页无添加子级按钮。',
+      message: `「${tool}」已生成；用户确认后再设 HELIX_JOVA_ACTION=replace 或说「替换原文」。`,
+      url: page.url(),
     };
   }