@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/engine/agent/hooks/tool-prompts.js

@@ -1,31 +1,31 @@
-/**
- * 工具 prompt lazy 注入文件加载（首调即缓存）。仿 agents/index.js loadPrompt 模式。
- *
- * 用途：cookbook / tweaks-syntax / vision-checker-dispatch 这些 reference 文档
- * 不放系统 prompt 恒驻（每 turn 拖累），改由 PreToolUse hook 在 agent 首次调对应工具时
- * 通过 additionalContext 注入。文件存 prompts/tools/*.md，模块加载时一次性读完缓存到 map。
- *
- * fail-soft：缺失 / 读失败返回 stub 字符串，hook 注入也不至于崩；console.warn 让部署
- * 日志能立刻发现。
- */
-import fsSync from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-// prompts/ 住在 agent/ 层（本模块在 agent/hooks/ 下一层，要往上跳一级）
-const PROMPTS_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'prompts', 'tools');
-
-const TOOL_PROMPT_CACHE = {};
-export function loadToolPrompt(name) {
-  if (TOOL_PROMPT_CACHE[name] !== undefined) return TOOL_PROMPT_CACHE[name];
-  const file = path.join(PROMPTS_DIR, `${name}.md`);
-  try {
-    TOOL_PROMPT_CACHE[name] = fsSync.readFileSync(file, 'utf8');
-  } catch (err) {
-    console.warn(`[hooks] failed to load tool prompt ${name}.md (${err.message}); using stub`);
-    TOOL_PROMPT_CACHE[name] =
-      `(tool prompt ${name}.md not found at ${file}. PreToolUse hook will skip lazy injection — `
-      + `agent fallbacks to whatever guidance lives in SKILL.md core.)`;
-  }
-  return TOOL_PROMPT_CACHE[name];
-}
+/**
+ * 工具 prompt lazy 注入文件加载（首调即缓存）。仿 agents/index.js loadPrompt 模式。
+ *
+ * 用途：cookbook / tweaks-syntax / vision-checker-dispatch 这些 reference 文档
+ * 不放系统 prompt 恒驻（每 turn 拖累），改由 PreToolUse hook 在 agent 首次调对应工具时
+ * 通过 additionalContext 注入。文件存 prompts/tools/*.md，模块加载时一次性读完缓存到 map。
+ *
+ * fail-soft：缺失 / 读失败返回 stub 字符串，hook 注入也不至于崩；console.warn 让部署
+ * 日志能立刻发现。
+ */
+import fsSync from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// prompts/ 住在 agent/ 层（本模块在 agent/hooks/ 下一层，要往上跳一级）
+const PROMPTS_DIR = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'prompts', 'tools');
+
+const TOOL_PROMPT_CACHE = {};
+export function loadToolPrompt(name) {
+  if (TOOL_PROMPT_CACHE[name] !== undefined) return TOOL_PROMPT_CACHE[name];
+  const file = path.join(PROMPTS_DIR, `${name}.md`);
+  try {
+    TOOL_PROMPT_CACHE[name] = fsSync.readFileSync(file, 'utf8');
+  } catch (err) {
+    console.warn(`[hooks] failed to load tool prompt ${name}.md (${err.message}); using stub`);
+    TOOL_PROMPT_CACHE[name] =
+      `(tool prompt ${name}.md not found at ${file}. PreToolUse hook will skip lazy injection — `
+      + `agent fallbacks to whatever guidance lives in SKILL.md core.)`;
+  }
+  return TOOL_PROMPT_CACHE[name];
+}

package/server/engine/agent/hooks/turn-state-memory.js

@@ -1,56 +1,56 @@
-/**
- * hooks/turn-state-memory.js — 每轮状态注入的"上一轮记忆"（2026-08-21）
- *
- * UserPromptSubmit 每轮把工作区状态（素材 / 产物 / 便利贴 / 关系线 / 决策 / tweaks）
- * 注给模型。以前每轮全量，30 轮下来上下文里是十几份几乎一样的块（实测 540~1300
- * token/轮）。现在**首轮全量、之后只报变化**：每节算一个指纹存在这里，下一轮对照。
- *
- * 键按 sessionId（一次对话一份记忆）。两种情况要清掉让下一轮重新全量：
- *   - 上下文压缩之后（PostCompact）：旧的那份已经被摘要吞了，"同上轮"没有所指
- *   - 进程重启：Map 本来就空
- * 上限 300 个会话，LRU 淘汰 —— 会话结束不另外清（多数会话没几轮，留着也就几百字节）。
- */
-
-const MAX_SESSIONS = 300;
-/** sessionId → { sections: Map<key, {hash:string, items:string[]|null}>, turns: number } */
-const memory = new Map();
-
-/** djb2：够用的短指纹，不引 crypto */
-export function fingerprint(text) {
-  let h = 5381;
-  const s = String(text);
-  for (let i = 0; i < s.length; i += 1) h = ((h << 5) + h + s.charCodeAt(i)) | 0;
-  return (h >>> 0).toString(36);
-}
-
-export function getTurnMemory(sessionId) {
-  if (!sessionId) return null;
-  const m = memory.get(sessionId);
-  if (m) { memory.delete(sessionId); memory.set(sessionId, m); }   // LRU 触碰
-  return m || null;
-}
-
-export function setTurnMemory(sessionId, sections) {
-  if (!sessionId) return;
-  const prev = memory.get(sessionId);
-  memory.delete(sessionId);
-  memory.set(sessionId, { sections, turns: (prev?.turns || 0) + 1 });
-  while (memory.size > MAX_SESSIONS) memory.delete(memory.keys().next().value);
-}
-
-/** 压缩后 / 想强制下一轮全量时调 */
-export function resetTurnMemory(sessionId) {
-  if (sessionId) memory.delete(sessionId);
-}
-
-/** 两个清单的差 → { added, removed }（给素材 / 便利贴这种按项报变化的节用） */
-export function diffItems(prevItems, nextItems) {
-  const prev = new Set(prevItems || []);
-  const next = new Set(nextItems || []);
-  return {
-    added: [...next].filter(x => !prev.has(x)),
-    removed: [...prev].filter(x => !next.has(x)),
-  };
-}
-
-export const _memory = memory;   // 测试用
+/**
+ * hooks/turn-state-memory.js — 每轮状态注入的"上一轮记忆"（2026-08-21）
+ *
+ * UserPromptSubmit 每轮把工作区状态（素材 / 产物 / 便利贴 / 关系线 / 决策 / tweaks）
+ * 注给模型。以前每轮全量，30 轮下来上下文里是十几份几乎一样的块（实测 540~1300
+ * token/轮）。现在**首轮全量、之后只报变化**：每节算一个指纹存在这里，下一轮对照。
+ *
+ * 键按 sessionId（一次对话一份记忆）。两种情况要清掉让下一轮重新全量：
+ *   - 上下文压缩之后（PostCompact）：旧的那份已经被摘要吞了，"同上轮"没有所指
+ *   - 进程重启：Map 本来就空
+ * 上限 300 个会话，LRU 淘汰 —— 会话结束不另外清（多数会话没几轮，留着也就几百字节）。
+ */
+
+const MAX_SESSIONS = 300;
+/** sessionId → { sections: Map<key, {hash:string, items:string[]|null}>, turns: number } */
+const memory = new Map();
+
+/** djb2：够用的短指纹，不引 crypto */
+export function fingerprint(text) {
+  let h = 5381;
+  const s = String(text);
+  for (let i = 0; i < s.length; i += 1) h = ((h << 5) + h + s.charCodeAt(i)) | 0;
+  return (h >>> 0).toString(36);
+}
+
+export function getTurnMemory(sessionId) {
+  if (!sessionId) return null;
+  const m = memory.get(sessionId);
+  if (m) { memory.delete(sessionId); memory.set(sessionId, m); }   // LRU 触碰
+  return m || null;
+}
+
+export function setTurnMemory(sessionId, sections) {
+  if (!sessionId) return;
+  const prev = memory.get(sessionId);
+  memory.delete(sessionId);
+  memory.set(sessionId, { sections, turns: (prev?.turns || 0) + 1 });
+  while (memory.size > MAX_SESSIONS) memory.delete(memory.keys().next().value);
+}
+
+/** 压缩后 / 想强制下一轮全量时调 */
+export function resetTurnMemory(sessionId) {
+  if (sessionId) memory.delete(sessionId);
+}
+
+/** 两个清单的差 → { added, removed }（给素材 / 便利贴这种按项报变化的节用） */
+export function diffItems(prevItems, nextItems) {
+  const prev = new Set(prevItems || []);
+  const next = new Set(nextItems || []);
+  return {
+    added: [...next].filter(x => !prev.has(x)),
+    removed: [...prev].filter(x => !next.has(x)),
+  };
+}
+
+export const _memory = memory;   // 测试用