@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/engine/chatai/perform.js

@@ -1,40 +1,40 @@
-/**
- * perform.js —— 一轮完整演出：编译 → 调用 → 落盘 → （必要时）折叠摘要。
- *
- * 这是将来 HTTP 端点的核心；限流、owner 隔离、计量入库都归端点层，
- * 这里只管把一轮跑对。摘要折叠放在回复落盘之后串行执行：它只在每
- * 攒够一批轮次时发生一次，多出的几秒延迟落在「本轮已经拿到回复之后」，
- * 用户无感；换成后台跑要多一套失败通知机制，v1 不值。
- */
-
-import { runChatai } from './index.js';
-import { loadOrchestration, compileContext } from './orchestrate.js';
-import { appendTurn } from './chat-log.js';
-import { maybeSummarize } from './summarize.js';
-
-/**
- * @param {object} opts  dir / userInput / signal / onDelta
- * @returns {{ text, usage, costUsd, model, meta, 摘要: null|object }}
- */
-export async function performTurn({ dir, userInput, signal, onDelta }) {
-  const config = await loadOrchestration(dir);
-  const compiled = await compileContext({ dir, userInput, config });
-  const out = await runChatai({
-    system: compiled.system,
-    messages: compiled.messages,
-    model: compiled.model || undefined,
-    思考: compiled.思考,
-    maxTokens: compiled.maxTokens,
-    signal, onDelta,
-  });
-  await appendTurn(dir, config, String(userInput).trim(), out.text);
-
-  let 摘要 = null;
-  try {
-    摘要 = await maybeSummarize({ dir, config, signal });
-  } catch (err) {
-    // 摘要失败不吞掉本轮回复：边界不动，下一轮还会再试。往上抛消息但带着结果。
-    摘要 = { 失败: err.message };
-  }
-  return { ...out, meta: compiled.meta, 摘要 };
-}
+/**
+ * perform.js —— 一轮完整演出：编译 → 调用 → 落盘 → （必要时）折叠摘要。
+ *
+ * 这是将来 HTTP 端点的核心；限流、owner 隔离、计量入库都归端点层，
+ * 这里只管把一轮跑对。摘要折叠放在回复落盘之后串行执行：它只在每
+ * 攒够一批轮次时发生一次，多出的几秒延迟落在「本轮已经拿到回复之后」，
+ * 用户无感；换成后台跑要多一套失败通知机制，v1 不值。
+ */
+
+import { runChatai } from './index.js';
+import { loadOrchestration, compileContext } from './orchestrate.js';
+import { appendTurn } from './chat-log.js';
+import { maybeSummarize } from './summarize.js';
+
+/**
+ * @param {object} opts  dir / userInput / signal / onDelta
+ * @returns {{ text, usage, costUsd, model, meta, 摘要: null|object }}
+ */
+export async function performTurn({ dir, userInput, signal, onDelta }) {
+  const config = await loadOrchestration(dir);
+  const compiled = await compileContext({ dir, userInput, config });
+  const out = await runChatai({
+    system: compiled.system,
+    messages: compiled.messages,
+    model: compiled.model || undefined,
+    思考: compiled.思考,
+    maxTokens: compiled.maxTokens,
+    signal, onDelta,
+  });
+  await appendTurn(dir, config, String(userInput).trim(), out.text);
+
+  let 摘要 = null;
+  try {
+    摘要 = await maybeSummarize({ dir, config, signal });
+  } catch (err) {
+    // 摘要失败不吞掉本轮回复：边界不动，下一轮还会再试。往上抛消息但带着结果。
+    摘要 = { 失败: err.message };
+  }
+  return { ...out, meta: compiled.meta, 摘要 };
+}

package/server/engine/chatai/summarize.js

@@ -1,79 +1,79 @@
-/**
- * summarize.js —— 滚动前情提要。
- *
- * 长演出的记忆基础设施：活历史（摘要边界之后的轮次）攒到 摘要.触发轮数 就
- * 折叠一次——把「旧提要 + 除最近 保留轮数 外的活轮次」交给 chatai 压成一份
- * 新提要，边界前移。触发轮数 > 保留轮数 的差值就是滞回区间，保证不会每轮
- * 都在摘要，也保证缓存前缀只在折叠瞬间断一次、之后又稳定到下次折叠。
- *
- * 摘要本身是一次独立的 chatai 调用（chatai 没有工具，摘要不可能是 agent 的
- * 副作用），花费单独记在 摘要.json 里，端点计量时要把它加进这轮的账。
- */
-
-import { runChatai } from './index.js';
-import { readLog, readSummary, writeSummary } from './chat-log.js';
-
-const DEFAULT_PROMPT = (长度) => `把下面这段对话压缩成一份前情提要，供后续继续演出时当作记忆。只输出提要本身，不要任何前后缀。
-要求：保留人物与称呼、关系变化、承诺与约定、得到或失去的东西、时间地点的推进、未解决的伏笔；去掉寒暄和过程性描写；用第三人称陈述句；${长度}字以内。
-如果下面给了旧提要，把它和新对话并成一份完整提要，旧提要里仍然有效的信息不能丢。`;
-
-/**
- * 该不该折叠、折叠到哪。纯函数，方便测试。
- * @returns {null | { 至: number, fold: records[] }}  至 = 折叠后的新边界 seq
- */
-export function needsSummary(records, summary, config) {
-  if (!config.摘要.启用) return null;
-  const boundary = summary?.至 ?? 0;
-  const live = records.filter(r => r.seq > boundary);
-  const userIdxs = live.map((r, i) => (r.role === 'user' ? i : -1)).filter(i => i >= 0);
-  if (userIdxs.length < config.摘要.触发轮数) return null;
-  // 保留最近 保留轮数 轮，其余折叠；新边界 = 保留区第一条 user 记录的前一条
-  const keepFrom = userIdxs[userIdxs.length - config.摘要.保留轮数];
-  const fold = live.slice(0, keepFrom);
-  if (!fold.length) return null;
-  return { 至: fold[fold.length - 1].seq, fold };
-}
-
-function renderTranscript(records) {
-  return records
-    .map(r => `${r.role === 'user' ? '用户' : '演出'}：${r.text}`)
-    .join('\n\n');
-}
-
-/**
- * 检查并执行一次折叠。没到触发线 → null；执行了 → 摘要对象（含花费）。
- * 失败直接抛给调用方——摘要失败不该静默，下一轮编译仍按旧边界走，不丢戏。
- */
-export async function maybeSummarize({ dir, config, signal }) {
-  const records = await readLog(dir, config);
-  const prev = await readSummary(dir);
-  const need = needsSummary(records, prev, config);
-  if (!need) return null;
-
-  const parts = [];
-  if (prev) parts.push(`【旧提要】\n${prev.内容.trim()}`);
-  parts.push(`【新对话】\n${renderTranscript(need.fold)}`);
-
-  const out = await runChatai({
-    system: config.摘要.提示 || DEFAULT_PROMPT(config.摘要.长度),
-    messages: [{ role: 'user', content: parts.join('\n\n') }],
-    model: config.摘要.模型 || config.模型 || undefined,
-    // 思考档不继承主配置：没专门给摘要设档就走默认档（最省的那档）。压缩不是创作。
-    思考: config.摘要.思考,
-    maxTokens: Math.max(500, config.摘要.长度 * 2),
-    signal,
-  });
-  const text = out.text.trim();
-  if (!text) throw Object.assign(new Error('摘要调用返回了空文本，边界不动'), { code: 'SUMMARY_EMPTY' });
-
-  const summary = {
-    至: need.至,
-    内容: text,
-    时: new Date().toISOString(),
-    模型: out.model,
-    用量: out.usage,
-    花费: out.costUsd,
-  };
-  await writeSummary(dir, summary);
-  return summary;
-}
+/**
+ * summarize.js —— 滚动前情提要。
+ *
+ * 长演出的记忆基础设施：活历史（摘要边界之后的轮次）攒到 摘要.触发轮数 就
+ * 折叠一次——把「旧提要 + 除最近 保留轮数 外的活轮次」交给 chatai 压成一份
+ * 新提要，边界前移。触发轮数 > 保留轮数 的差值就是滞回区间，保证不会每轮
+ * 都在摘要，也保证缓存前缀只在折叠瞬间断一次、之后又稳定到下次折叠。
+ *
+ * 摘要本身是一次独立的 chatai 调用（chatai 没有工具，摘要不可能是 agent 的
+ * 副作用），花费单独记在 摘要.json 里，端点计量时要把它加进这轮的账。
+ */
+
+import { runChatai } from './index.js';
+import { readLog, readSummary, writeSummary } from './chat-log.js';
+
+const DEFAULT_PROMPT = (长度) => `把下面这段对话压缩成一份前情提要，供后续继续演出时当作记忆。只输出提要本身，不要任何前后缀。
+要求：保留人物与称呼、关系变化、承诺与约定、得到或失去的东西、时间地点的推进、未解决的伏笔；去掉寒暄和过程性描写；用第三人称陈述句；${长度}字以内。
+如果下面给了旧提要，把它和新对话并成一份完整提要，旧提要里仍然有效的信息不能丢。`;
+
+/**
+ * 该不该折叠、折叠到哪。纯函数，方便测试。
+ * @returns {null | { 至: number, fold: records[] }}  至 = 折叠后的新边界 seq
+ */
+export function needsSummary(records, summary, config) {
+  if (!config.摘要.启用) return null;
+  const boundary = summary?.至 ?? 0;
+  const live = records.filter(r => r.seq > boundary);
+  const userIdxs = live.map((r, i) => (r.role === 'user' ? i : -1)).filter(i => i >= 0);
+  if (userIdxs.length < config.摘要.触发轮数) return null;
+  // 保留最近 保留轮数 轮，其余折叠；新边界 = 保留区第一条 user 记录的前一条
+  const keepFrom = userIdxs[userIdxs.length - config.摘要.保留轮数];
+  const fold = live.slice(0, keepFrom);
+  if (!fold.length) return null;
+  return { 至: fold[fold.length - 1].seq, fold };
+}
+
+function renderTranscript(records) {
+  return records
+    .map(r => `${r.role === 'user' ? '用户' : '演出'}：${r.text}`)
+    .join('\n\n');
+}
+
+/**
+ * 检查并执行一次折叠。没到触发线 → null；执行了 → 摘要对象（含花费）。
+ * 失败直接抛给调用方——摘要失败不该静默，下一轮编译仍按旧边界走，不丢戏。
+ */
+export async function maybeSummarize({ dir, config, signal }) {
+  const records = await readLog(dir, config);
+  const prev = await readSummary(dir);
+  const need = needsSummary(records, prev, config);
+  if (!need) return null;
+
+  const parts = [];
+  if (prev) parts.push(`【旧提要】\n${prev.内容.trim()}`);
+  parts.push(`【新对话】\n${renderTranscript(need.fold)}`);
+
+  const out = await runChatai({
+    system: config.摘要.提示 || DEFAULT_PROMPT(config.摘要.长度),
+    messages: [{ role: 'user', content: parts.join('\n\n') }],
+    model: config.摘要.模型 || config.模型 || undefined,
+    // 思考档不继承主配置：没专门给摘要设档就走默认档（最省的那档）。压缩不是创作。
+    思考: config.摘要.思考,
+    maxTokens: Math.max(500, config.摘要.长度 * 2),
+    signal,
+  });
+  const text = out.text.trim();
+  if (!text) throw Object.assign(new Error('摘要调用返回了空文本，边界不动'), { code: 'SUMMARY_EMPTY' });
+
+  const summary = {
+    至: need.至,
+    内容: text,
+    时: new Date().toISOString(),
+    模型: out.model,
+    用量: out.usage,
+    花费: out.costUsd,
+  };
+  await writeSummary(dir, summary);
+  return summary;
+}

package/server/engine/mcp/capability-gate.js

@@ -1,52 +1,52 @@
-/**
- * engine/mcp/capability-gate.js — 工具 × 本机能力位（runtime/capabilities.js）的唯一对照表 + 闸。
- *
- * 两种模式：
- *   - block：能力缺席时工具描述前缀「⛔ CURRENTLY UNAVAILABLE + 装法」（照 roll_film 的先例，agent 看到就不会调），
- *            真调了也在这里拦住，返回同一句话让它转告用户——不让裸的 ENOENT / 500 漏到 agent 面前
- *   - note ：工具仍可用，只在描述末尾加一句降级说明（build_docx 没有 LibreOffice 时仍能出文件，只是没页图）
- * 没探过（capabilityState 为 null：单测 / 脚本直接 import）→ 原样放行，这层不猜。
- */
-
-import { capabilityState } from '../../runtime/capabilities.js';
-
-const CHROMIUM_TOOLS = [
-  'screenshot_canvas', 'screenshot_url', 'list_pages', 'query_elements', 'get_computed_styles', 'explain_style',
-  'profile_scroll', 'trace_motion',
-  'browser_navigate', 'browser_read', 'browser_click', 'browser_screenshot', 'browser_capture', 'browser_computer',
-  'browser_find', 'browser_batch', 'browser_request_help',
-  'artifact_open', 'artifact_computer', 'artifact_find', 'artifact_motion', 'artifact_batch',
-];
-
-/** 工具名 → { cap, mode }。没列的工具不归这层管 */
-export const TOOL_CAPABILITIES = Object.freeze({
-  ...Object.fromEntries(CHROMIUM_TOOLS.map((t) => [t, { cap: 'chromium', mode: 'block' }])),
-  build_docx: { cap: 'libreoffice', mode: 'note' },
-  remove_background: { cap: 'rembg', mode: 'block' },
-  web_search: { cap: 'webSearch', mode: 'block' },
-  generate_image: { cap: 'imageGen', mode: 'block' },
-  publish_site: { cap: 'publish', mode: 'block' },
-});
-
-export function unavailableMessage(c) {
-  return `本机缺 ${c.label}（${c.detail}）。装法：${c.fix}`;
-}
-
-export function withCapabilityGate(toolDef) {
-  const spec = TOOL_CAPABILITIES[toolDef.name];
-  if (!spec) return toolDef;
-  const c = capabilityState(spec.cap);
-  if (!c || c.available) return toolDef;
-  const msg = unavailableMessage(c);
-  if (spec.mode === 'note') {
-    return { ...toolDef, description: `${toolDef.description}\n\n⚠️ ${msg} 本工具仍可用，但依赖它的步骤（页图/体检）会缺席。` };
-  }
-  return {
-    ...toolDef,
-    description: `⛔ CURRENTLY UNAVAILABLE — ${msg} Do not call this tool; tell the user what to install (原话转告，不要重试).\n\n${toolDef.description}`,
-    handler: async () => ({
-      content: [{ type: 'text', text: `${toolDef.name} 不可用：${msg}。把这句话原话转告用户，装好后重启 Nodesign 再试；不要重试本工具。` }],
-      isError: true,
-    }),
-  };
-}
+/**
+ * engine/mcp/capability-gate.js — 工具 × 本机能力位（runtime/capabilities.js）的唯一对照表 + 闸。
+ *
+ * 两种模式：
+ *   - block：能力缺席时工具描述前缀「⛔ CURRENTLY UNAVAILABLE + 装法」（照 roll_film 的先例，agent 看到就不会调），
+ *            真调了也在这里拦住，返回同一句话让它转告用户——不让裸的 ENOENT / 500 漏到 agent 面前
+ *   - note ：工具仍可用，只在描述末尾加一句降级说明（build_docx 没有 LibreOffice 时仍能出文件，只是没页图）
+ * 没探过（capabilityState 为 null：单测 / 脚本直接 import）→ 原样放行，这层不猜。
+ */
+
+import { capabilityState } from '../../runtime/capabilities.js';
+
+const CHROMIUM_TOOLS = [
+  'screenshot_canvas', 'screenshot_url', 'list_pages', 'query_elements', 'get_computed_styles', 'explain_style',
+  'profile_scroll', 'trace_motion',
+  'browser_navigate', 'browser_read', 'browser_click', 'browser_screenshot', 'browser_capture', 'browser_computer',
+  'browser_find', 'browser_batch', 'browser_request_help',
+  'artifact_open', 'artifact_computer', 'artifact_find', 'artifact_motion', 'artifact_batch',
+];
+
+/** 工具名 → { cap, mode }。没列的工具不归这层管 */
+export const TOOL_CAPABILITIES = Object.freeze({
+  ...Object.fromEntries(CHROMIUM_TOOLS.map((t) => [t, { cap: 'chromium', mode: 'block' }])),
+  build_docx: { cap: 'libreoffice', mode: 'note' },
+  remove_background: { cap: 'rembg', mode: 'block' },
+  web_search: { cap: 'webSearch', mode: 'block' },
+  generate_image: { cap: 'imageGen', mode: 'block' },
+  publish_site: { cap: 'publish', mode: 'block' },
+});
+
+export function unavailableMessage(c) {
+  return `本机缺 ${c.label}（${c.detail}）。装法：${c.fix}`;
+}
+
+export function withCapabilityGate(toolDef) {
+  const spec = TOOL_CAPABILITIES[toolDef.name];
+  if (!spec) return toolDef;
+  const c = capabilityState(spec.cap);
+  if (!c || c.available) return toolDef;
+  const msg = unavailableMessage(c);
+  if (spec.mode === 'note') {
+    return { ...toolDef, description: `${toolDef.description}\n\n⚠️ ${msg} 本工具仍可用，但依赖它的步骤（页图/体检）会缺席。` };
+  }
+  return {
+    ...toolDef,
+    description: `⛔ CURRENTLY UNAVAILABLE — ${msg} Do not call this tool; tell the user what to install (原话转告，不要重试).\n\n${toolDef.description}`,
+    handler: async () => ({
+      content: [{ type: 'text', text: `${toolDef.name} 不可用：${msg}。把这句话原话转告用户，装好后重启 Nodesign 再试；不要重试本工具。` }],
+      isError: true,
+    }),
+  };
+}