helixlife-v5-cli 1.2.0 → 1.2.2

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

@@ -0,0 +1,308 @@
+/**
+ * 综述工作台（jova）· 初稿精修页 · 右侧 AI 工具
+ *
+ * 支持工具（右侧栏）：校对、文风、润色、降重、翻译、改写、扩写、缩写、文献列表
+ *
+ * Agent 调用约定（严格遵守）：
+ *
+ * 1) 用户说「<工具> <章节>」、未指明后续操作时：
+ *    action = null → 选中章节 → 打开工具 →（文风填参考文风）→ 一键生成
+ *    → 返回 needsReplaceChoice，禁止自动点「替换原文」
+ *    例外：文献列表仅打开列表面板，无生成步骤
+ *
+ * 2) 用户明确说「替换原文」：action = 'replace'
+ *
+ * 3) 自检全部工具：probeAll = true（开发/验收用，依次跑 9 项，不替换原文）
+ *
+ * intent 示例：
+ *   「翻译 前言」  → tool=翻译, sectionTitle=前言
+ *   「文风 摘要」  → tool=文风, sectionTitle=摘要（须 referenceStyle 或自动兜底）
+ *   「文献列表」  → tool=文献列表, sectionTitle 可空（选中全文参考文献）
+ *
+ * 用法：
+ *   helixlife-v5-cli run-code --filename=scripts/workbench-jova-writing-tool.js
+ */
+async page => {
+  const intent = '翻译 前言';
+  const action = null; // null | 'replace'
+  const extraRequirement = ''; // 额外需求（可选）
+  const referenceStyle = ''; // 文风专用；空则从选中段落截取兜底
+  const probeAll = false; // true = 验收 9 个工具（用「关键词」短段）
+
+  const TOOLS = ['校对', '文风', '润色', '降重', '翻译', '改写', '扩写', '缩写', '文献列表'];
+
+  const main = page.locator('main');
+
+  if (!page.url().includes('/workbench/jova/writing')) {
+    return { ok: false, reason: '当前不在初稿精修页 /workbench/jova/writing', intent };
+  }
+
+  function parseIntent(raw) {
+    const text = raw.trim();
+    for (const tool of TOOLS) {
+      if (text === tool || text.startsWith(`${tool} `) || text.startsWith(tool)) {
+        const sectionTitle = text.slice(tool.length).trim();
+        return { tool, sectionTitle: sectionTitle || null };
+      }
+    }
+    return { tool: null, sectionTitle: text || null };
+  }
+
+  async function closePanel() {
+    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);
+      }
+    }
+    const cancel = main.getByRole('button', { name: '取 消' });
+    if ((await cancel.count()) > 0 && (await cancel.first().isVisible().catch(() => false))) {
+      await cancel.first().click();
+      await page.waitForTimeout(300);
+    }
+  }
+
+  async function navigateAndSelectSection(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 body = editor.textContent?.trim() || '';
+        const range = document.createRange();
+        range.selectNodeContents(editor);
+        const sel = window.getSelection();
+        sel?.removeAllRanges();
+        sel?.addRange(range);
+        return { ok: true, textLength: body.length, preview: body.slice(0, 80), wholeDoc: 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);
+
+      const text = range.toString();
+      return {
+        ok: true,
+        textLength: text.length,
+        preview: text.slice(0, 80),
+        sectionText: text.slice(0, 500),
+      };
+    }, title);
+
+    await page.waitForTimeout(400);
+    return selected;
+  }
+
+  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 true;
+      await page.waitForTimeout(1000);
+    }
+    return false;
+  }
+
+  async function fillExtraIfNeeded() {
+    if (!extraRequirement) return;
+    const box = main.getByRole('textbox', { name: '额外需求' });
+    if ((await box.count()) > 0 && (await box.first().isVisible().catch(() => false))) {
+      await box.first().fill(extraRequirement);
+    }
+  }
+
+  async function fillReferenceStyleIfNeeded(selected) {
+    const refBox = main.getByRole('textbox', { name: '参考文风' });
+    if ((await refBox.count()) === 0 || !(await refBox.first().isVisible().catch(() => false))) {
+      return { filled: false };
+    }
+    const ref =
+      referenceStyle ||
+      (selected.sectionText
+        ? selected.sectionText.slice(0, 200)
+        : 'This review synthesizes molecular subtyping and precision therapeutic strategies in breast cancer.');
+    await refBox.first().fill(ref);
+    return { filled: true, referenceStyle: ref.slice(0, 80) };
+  }
+
+  async function pickTranslationLanguage() {
+    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);
+        return label;
+      }
+    }
+    return null;
+  }
+
+  async function openToolAndGenerate(tool, sectionTitle) {
+    await closePanel();
+
+    const selected = await navigateAndSelectSection(sectionTitle);
+    if (!selected.ok) return { ok: false, tool, sectionTitle, ...selected };
+
+    const toolBtn = main.getByText(tool, { exact: true });
+    if ((await toolBtn.count()) === 0) {
+      return { ok: false, tool, sectionTitle, reason: `未找到工具「${tool}」` };
+    }
+    await toolBtn.first().click();
+    await page.waitForTimeout(800);
+
+    if (tool === '文献列表') {
+      const panel = main.getByText('文献列表', { exact: true });
+      const visible = (await panel.count()) > 0;
+      const refLinks = await main.locator('a[href*="pubmed"], a[href*="doi"], a[href*="clmd"]').count();
+      return {
+        ok: visible,
+        tool,
+        sectionTitle,
+        selected,
+        mode: 'list',
+        refLinkCount: refLinks,
+        message: '已打开文献列表面板。',
+      };
+    }
+
+    await main.getByText('原文内容', { exact: true }).waitFor({ state: 'visible', timeout: 10000 }).catch(() => {});
+
+    let refStyle = null;
+    if (tool === '文风') {
+      refStyle = await fillReferenceStyleIfNeeded(selected);
+    }
+    if (tool === '翻译') {
+      await pickTranslationLanguage();
+    }
+    await fillExtraIfNeeded();
+
+    const genBtn = main.getByRole('button', { name: '一键生成' });
+    if ((await genBtn.count()) === 0 || !(await genBtn.first().isVisible().catch(() => false))) {
+      return { ok: false, tool, sectionTitle, reason: '未找到「一键生成」按钮' };
+    }
+    await genBtn.first().click();
+
+    const replaceReady = await waitReplaceReady();
+    return {
+      ok: replaceReady,
+      tool,
+      sectionTitle,
+      selected,
+      refStyle,
+      replaceReady,
+      mode: 'generate',
+    };
+  }
+
+  async function replaceGenerated() {
+    const replaceBtn = main.getByRole('button', { name: '替换原文' });
+    if ((await replaceBtn.count()) === 0 || !(await replaceBtn.isEnabled().catch(() => false))) {
+      return { ok: false, reason: '「替换原文」不可用' };
+    }
+    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 };
+  }
+
+  if (probeAll) {
+    const probeSection = '关键词';
+    const results = [];
+    for (const tool of TOOLS) {
+      const r = await openToolAndGenerate(tool, probeSection);
+      results.push({ tool, ok: r.ok, mode: r.mode, replaceReady: r.replaceReady, reason: r.reason });
+    }
+    return {
+      ok: results.every(r => r.ok),
+      probeAll: true,
+      probeSection,
+      results,
+      url: page.url(),
+    };
+  }
+
+  const { tool, sectionTitle } = parseIntent(intent);
+  if (!tool || !TOOLS.includes(tool)) {
+    return {
+      ok: false,
+      intent,
+      reason: `无法解析工具，支持：${TOOLS.join('、')}`,
+    };
+  }
+  if (tool !== '文献列表' && !sectionTitle) {
+    return { ok: false, intent, reason: '请指定章节标题，如「翻译 前言」' };
+  }
+
+  if (action === 'replace') {
+    const replaced = await replaceGenerated();
+    return {
+      ok: replaced.ok,
+      intent,
+      tool,
+      sectionTitle,
+      action,
+      ...replaced,
+      message: replaced.ok ? '已替换原文。' : replaced.reason,
+      url: page.url(),
+    };
+  }
+
+  const generated = await openToolAndGenerate(tool, sectionTitle);
+
+  if (generated.mode === 'list') {
+    return { ok: generated.ok, intent, tool, sectionTitle, action: null, ...generated, url: page.url() };
+  }
+
+  if (!generated.ok) {
+    return { ok: false, intent, tool, sectionTitle, action: null, ...generated, url: page.url() };
+  }
+
+  return {
+    ok: true,
+    intent,
+    tool,
+    sectionTitle,
+    action: null,
+    needsReplaceChoice: true,
+    availableActions: ['replace'],
+    replaceReady: generated.replaceReady,
+    selected: generated.selected,
+    message: `「${tool}」已生成结果，请在右侧查看；确认后告知我「替换原文」以应用。`,
+    url: page.url(),
+  };
+}

package/lib/automation-overlay.browser.js

@@ -1,76 +0,0 @@
-(() => {
-  const ROOT_ID = '__helix_cli_automation_overlay';
-
-  function ensureOverlay() {
-    if (document.getElementById(ROOT_ID)) {
-      return window.__helixCliOverlay;
-    }
-
-    const root = document.createElement('div');
-    root.id = ROOT_ID;
-    root.setAttribute('data-helix-cli', 'automation-overlay');
-    root.setAttribute('aria-hidden', 'true');
-    root.style.cssText = [
-      'position:fixed',
-      'top:16px',
-      'right:16px',
-      'z-index:2147483647',
-      'pointer-events:none',
-      'box-sizing:border-box',
-      'max-width:280px',
-      'padding:10px 14px',
-      'border-radius:12px',
-      'background:#f5b942',
-      'color:#3d2b00',
-      'font:13px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"PingFang SC","Microsoft YaHei",sans-serif',
-      'box-shadow:0 4px 14px rgba(0,0,0,.18)',
-      'letter-spacing:.01em',
-    ].join(';');
-
-    const title = document.createElement('div');
-    title.dataset.line = 'title';
-    title.style.cssText = 'font-weight:600;margin-bottom:4px;word-break:break-all;';
-
-    const status = document.createElement('div');
-    status.dataset.line = 'status';
-    status.style.cssText = 'opacity:.92;';
-
-    const detail = document.createElement('div');
-    detail.dataset.line = 'detail';
-    detail.style.cssText = 'opacity:.78;margin-top:2px;font-size:12px;';
-
-    root.append(title, status, detail);
-    (document.body || document.documentElement).appendChild(root);
-
-    const api = {
-      update(payload = {}) {
-        const el = document.getElementById(ROOT_ID);
-        if (!el) return;
-        const t = el.querySelector('[data-line="title"]');
-        const s = el.querySelector('[data-line="status"]');
-        const d = el.querySelector('[data-line="detail"]');
-        if (t) t.textContent = payload.title || 'helixlife-v5-cli';
-        if (s) s.textContent = payload.status || '机器自动化';
-        if (d) d.textContent = payload.detail || 'CLI 操作中';
-        el.style.display = payload.hidden ? 'none' : 'block';
-      },
-    };
-
-    window.__helixCliOverlay = api;
-    return api;
-  }
-
-  function boot() {
-    ensureOverlay().update({
-      title: 'helixlife-v5-cli',
-      status: '机器自动化',
-      detail: '会话已就绪',
-    });
-  }
-
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', boot, { once: true });
-  } else {
-    boot();
-  }
-})();

package/lib/automation-overlay.js

@@ -1,238 +0,0 @@
-"use strict";
-
-const fs = require("node:fs");
-const path = require("node:path");
-
-const OVERLAY_SKIP_COMMANDS = new Set([
-  "run-code",
-  "list",
-  "close",
-  "close-all",
-  "kill-all",
-  "detach",
-  "delete-data",
-  "config-print",
-  "cookie-list",
-  "cookie-get",
-  "cookie-set",
-  "cookie-delete",
-  "cookie-clear",
-  "localstorage-list",
-  "localstorage-get",
-  "localstorage-set",
-  "localstorage-delete",
-  "localstorage-clear",
-  "sessionstorage-list",
-  "sessionstorage-get",
-  "sessionstorage-set",
-  "sessionstorage-delete",
-  "sessionstorage-clear",
-  "route-list",
-  "tab-list",
-  "console",
-  "network",
-  "state-save",
-  "state-load",
-  "tracing-start",
-  "tracing-stop",
-  "video-start",
-  "video-stop",
-  "video-chapter",
-  "highlight",
-  "generate-locator",
-  "show",
-]);
-
-const OVERLAY_SESSION_OPEN_COMMANDS = new Set(["open", "attach"]);
-
-let cachedBrowserScript = null;
-
-function isOverlayEnabled() {
-  const flag = process.env.HELIX_AUTOMATION_OVERLAY;
-  if (flag === "0" || flag === "false" || flag === "off") {
-    return false;
-  }
-  return true;
-}
-
-function resolveCliConfigPath() {
-  if (process.env.HELIX_CLI_CONFIG) {
-    return path.resolve(process.env.HELIX_CLI_CONFIG);
-  }
-  const initScriptPath = path.join(__dirname, "automation-overlay.init.js");
-  const runtimeConfigPath = path.join(__dirname, "cli.runtime.config.json");
-  const config = {
-    browser: {
-      initScript: [initScriptPath],
-    },
-  };
-  fs.writeFileSync(
-    runtimeConfigPath,
-    `${JSON.stringify(config, null, 2)}\n`,
-    "utf8",
-  );
-  return runtimeConfigPath;
-}
-
-function getBrowserOverlayScript() {
-  if (!cachedBrowserScript) {
-    cachedBrowserScript = fs.readFileSync(
-      path.join(__dirname, "automation-overlay.browser.js"),
-      "utf8",
-    );
-  }
-  return cachedBrowserScript;
-}
-
-function stripLeadingFlags(tokens) {
-  let i = 0;
-  while (i < tokens.length) {
-    const t = tokens[i];
-    if (t === "--raw" || t === "--json") {
-      i += 1;
-      continue;
-    }
-    if (t.startsWith("-s=")) {
-      i += 1;
-      continue;
-    }
-    break;
-  }
-  return tokens.slice(i);
-}
-
-function truncate(text, max = 48) {
-  const s = String(text || "")
-    .replace(/\s+/g, " ")
-    .trim();
-  if (s.length <= max) return s;
-  return `${s.slice(0, max - 1)}…`;
-}
-
-function describeOverlayPayload(tokens, phase) {
-  const core = stripLeadingFlags(tokens);
-  const command = core[0];
-  if (!command) {
-    return {
-      title: "helixlife-v5-cli",
-      status: phase === "after" ? "已完成" : "执行中...",
-      detail: "CLI自动化操作中",
-    };
-  }
-
-  const args = core.slice(1).filter((t) => !t.startsWith("--"));
-  let title = command;
-  let detail = args.length ? truncate(args.join(" ")) : "CLI自动化操作中";
-
-  switch (command) {
-    case "click":
-    case "dblclick":
-    case "hover":
-    case "check":
-    case "uncheck":
-      title = command;
-      detail = truncate(args[0] || "元素", 40);
-      break;
-    case "fill":
-      title = "fill";
-      detail = truncate(args[0] || "输入框", 40);
-      break;
-    case "type":
-      title = "type";
-      detail = truncate(args[0] || "", 32);
-      break;
-    case "goto":
-    case "open":
-      title = command;
-      detail = truncate(args[0] || "页面", 56);
-      break;
-    case "snapshot":
-      title = "snapshot";
-      detail = "页面验收";
-      break;
-    case "run-code":
-      title = "run-code";
-      detail = truncate(args[0] || "脚本", 40);
-      break;
-    case "press":
-      title = "press";
-      detail = truncate(args[0] || "按键", 24);
-      break;
-    case "select":
-      title = "select";
-      detail = truncate(args.join(" "), 40);
-      break;
-    case "upload":
-      title = "upload";
-      detail = truncate(args[0] || "文件", 40);
-      break;
-    case "eval":
-      title = "eval";
-      detail = "读取页面状态";
-      break;
-    default:
-      title = command;
-      break;
-  }
-
-  return {
-    title,
-    status: phase === "after" ? "已完成" : "执行中...",
-    detail: phase === "after" ? "CLI自动化操作中" : detail || "CLI自动化操作中",
-  };
-}
-
-function shouldUpdateOverlay(tokens) {
-  const core = stripLeadingFlags(tokens);
-  const command = core[0];
-  if (!command) return false;
-  if (OVERLAY_SKIP_COMMANDS.has(command)) return false;
-  return true;
-}
-
-function shouldInjectOpenConfig(tokens) {
-  const core = stripLeadingFlags(tokens);
-  const command = core[0];
-  if (!command || !OVERLAY_SESSION_OPEN_COMMANDS.has(command)) return false;
-  return !tokens.some((t) => t === "--config" || t.startsWith("--config="));
-}
-
-function injectOpenConfig(tokens) {
-  if (!isOverlayEnabled() || !shouldInjectOpenConfig(tokens)) {
-    return tokens;
-  }
-  const configPath = resolveCliConfigPath();
-  const next = [...tokens];
-  const core = stripLeadingFlags(tokens);
-  const insertAt = tokens.indexOf(core[0]);
-  next.splice(insertAt + 1, 0, `--config=${configPath}`);
-  return next;
-}
-
-function buildOverlayRunCode(payload) {
-  const browserScript = getBrowserOverlayScript();
-  const payloadJson = JSON.stringify(payload);
-  return [
-    "async page => {",
-    `  const browserScript = ${JSON.stringify(browserScript)};`,
-    `  const payload = ${payloadJson};`,
-    "  await page.evaluate(({ script, data }) => {",
-    "    // eslint-disable-next-line no-eval",
-    "    eval(script);",
-    "    if (window.__helixCliOverlay) window.__helixCliOverlay.update(data);",
-    "  }, { script: browserScript, data: payload });",
-    "}",
-  ].join("\n");
-}
-
-module.exports = {
-  OVERLAY_SKIP_COMMANDS,
-  isOverlayEnabled,
-  resolveCliConfigPath,
-  stripLeadingFlags,
-  describeOverlayPayload,
-  shouldUpdateOverlay,
-  shouldInjectOpenConfig,
-  injectOpenConfig,
-  buildOverlayRunCode,
-};