@xiaobuyu/nodesign 0.0.1 → 0.0.2

package/server/lib/board-kind-sizes.js

@@ -1,62 +1,62 @@
-/**
- * board-kind-sizes —— 画布物件身位的服务端镜像（2026-08-14，agent 摆位批）
- *
- * read_board / arrange_on_board / create_on_board 要在服务端估算卡片矩形
- * （挨着谁摆、会不会压到谁），而身位真相住在前端 `web/src/lib/board-kinds.js`
- * （渲染方）。这里抄一份**常量**，web 侧有 parity 测试钉着两边一致 ——
- * 改那边忘了改这边，测试直接红（跟 binding-types 的双份表同一套纪律）。
- *
- * 文字/涂鸦不在表里：它们的 w/h 是逐条存在 board.json 里的（本体即数据）。
- */
-
-import { KINDS } from './kinds/index.js';
-
-export const DECK_EMBED_W = 640;
-export const ARTIFACT_HEADER_H = 28;
-export const ARTIFACT_PREVIEW_H = { deck: 360, site: 400, docx: 420, browse: 360 };
-
-// file 是 224x32 的细条卡（parity 测试上岗第一天就逮住我猜成 160x120 ——
-// 那是涂鸦的默认身位。别猜，抄表）
-export const KIND_SIZES = {
-  doc: { w: 200, h: 96 },
-  image: { w: 200, h: 176 },
-  video: { w: 240, h: 160 },
-  note: { w: 200, h: 148 },
-  file: { w: 224, h: 32 },
-};
-
-// 前缀表从注册表派生（「写死表家族」第 4 处，2026-08-18 收）：手写
-// `deck|site|docx` 的话加形态必漏，新形态的卡掉到 file 兜底（224×32 细条），
-// agent 摆位按错矩形算。⚠️ 新形态要同步给 ARTIFACT_PREVIEW_H 加一行
-//（两边都有 parity 测试钉着前端那份）。
-const KIND_PREFIX_RE = new RegExp(`^(${Object.keys(KINDS).join('|')}):`);
-
-const IMG_EXT = /\.(png|jpe?g|webp|gif|svg|avif)$/i;
-const VIDEO_EXT = /\.(mp4|webm|mov)$/i;
-
-/**
- * 按 id + board.json 条目估身位。优先条目里存的 w/h（文字/涂鸦，或将来任何
- * 显式尺寸），其次按 id 形态推：kind 前缀 → 产物卡，扩展名 → 图/视频/便签/文件。
- */
-export function estimateSize(id, entry) {
-  if (entry && Number.isFinite(entry.w) && Number.isFinite(entry.h)) {
-    return { w: entry.w, h: entry.h };
-  }
-  const s = String(id || '');
-  if (s.startsWith('doc:')) return KIND_SIZES.doc;
-  // 浏览器卡是**单例**，id 就是 'browse'（没有路径可挂 —— 它背后不是文件）。
-  // 不给这条分支的话它会掉到最后的 file 兜底（224×32 的细条），agent 摆位时
-  // 就会拿一个错的矩形去算"挨着谁摆、会不会压到谁"。
-  if (s === 'browse') {
-    return { w: DECK_EMBED_W, h: ARTIFACT_HEADER_H + ARTIFACT_PREVIEW_H.browse };
-  }
-  const m = KIND_PREFIX_RE.exec(s);
-  if (m) {
-    const t = m[1];
-    return { w: DECK_EMBED_W, h: ARTIFACT_HEADER_H + ARTIFACT_PREVIEW_H[t] };
-  }
-  if (IMG_EXT.test(s)) return KIND_SIZES.image;
-  if (VIDEO_EXT.test(s)) return KIND_SIZES.video;
-  if (/\.(md|txt)$/i.test(s)) return KIND_SIZES.note;
-  return KIND_SIZES.file;
-}
+/**
+ * board-kind-sizes —— 画布物件身位的服务端镜像（2026-08-14，agent 摆位批）
+ *
+ * read_board / arrange_on_board / create_on_board 要在服务端估算卡片矩形
+ * （挨着谁摆、会不会压到谁），而身位真相住在前端 `web/src/lib/board-kinds.js`
+ * （渲染方）。这里抄一份**常量**，web 侧有 parity 测试钉着两边一致 ——
+ * 改那边忘了改这边，测试直接红（跟 binding-types 的双份表同一套纪律）。
+ *
+ * 文字/涂鸦不在表里：它们的 w/h 是逐条存在 board.json 里的（本体即数据）。
+ */
+
+import { KINDS } from './kinds/index.js';
+
+export const DECK_EMBED_W = 640;
+export const ARTIFACT_HEADER_H = 28;
+export const ARTIFACT_PREVIEW_H = { deck: 360, site: 400, docx: 420, browse: 360 };
+
+// file 是 224x32 的细条卡（parity 测试上岗第一天就逮住我猜成 160x120 ——
+// 那是涂鸦的默认身位。别猜，抄表）
+export const KIND_SIZES = {
+  doc: { w: 200, h: 96 },
+  image: { w: 200, h: 176 },
+  video: { w: 240, h: 160 },
+  note: { w: 200, h: 148 },
+  file: { w: 224, h: 32 },
+};
+
+// 前缀表从注册表派生（「写死表家族」第 4 处，2026-08-18 收）：手写
+// `deck|site|docx` 的话加形态必漏，新形态的卡掉到 file 兜底（224×32 细条），
+// agent 摆位按错矩形算。⚠️ 新形态要同步给 ARTIFACT_PREVIEW_H 加一行
+//（两边都有 parity 测试钉着前端那份）。
+const KIND_PREFIX_RE = new RegExp(`^(${Object.keys(KINDS).join('|')}):`);
+
+const IMG_EXT = /\.(png|jpe?g|webp|gif|svg|avif)$/i;
+const VIDEO_EXT = /\.(mp4|webm|mov)$/i;
+
+/**
+ * 按 id + board.json 条目估身位。优先条目里存的 w/h（文字/涂鸦，或将来任何
+ * 显式尺寸），其次按 id 形态推：kind 前缀 → 产物卡，扩展名 → 图/视频/便签/文件。
+ */
+export function estimateSize(id, entry) {
+  if (entry && Number.isFinite(entry.w) && Number.isFinite(entry.h)) {
+    return { w: entry.w, h: entry.h };
+  }
+  const s = String(id || '');
+  if (s.startsWith('doc:')) return KIND_SIZES.doc;
+  // 浏览器卡是**单例**，id 就是 'browse'（没有路径可挂 —— 它背后不是文件）。
+  // 不给这条分支的话它会掉到最后的 file 兜底（224×32 的细条），agent 摆位时
+  // 就会拿一个错的矩形去算"挨着谁摆、会不会压到谁"。
+  if (s === 'browse') {
+    return { w: DECK_EMBED_W, h: ARTIFACT_HEADER_H + ARTIFACT_PREVIEW_H.browse };
+  }
+  const m = KIND_PREFIX_RE.exec(s);
+  if (m) {
+    const t = m[1];
+    return { w: DECK_EMBED_W, h: ARTIFACT_HEADER_H + ARTIFACT_PREVIEW_H[t] };
+  }
+  if (IMG_EXT.test(s)) return KIND_SIZES.image;
+  if (VIDEO_EXT.test(s)) return KIND_SIZES.video;
+  if (/\.(md|txt)$/i.test(s)) return KIND_SIZES.note;
+  return KIND_SIZES.file;
+}

package/server/lib/board-relations.js

@@ -1,133 +1,133 @@
-/**
- * server/lib/board-relations.js — 关系线的 agent 读侧（2026-08-14，切片③）
- *
- * 在此之前 bindings 是**只写不读**的：agent 有 relate_on_board 能画线、用户
- * 在画布上看得见，但没有任何一层把「用户画了什么关系」喂回 agent —— 线是
- * 装饰。这份文件是读侧的唯一实现，两个消费口都从这儿取：
- *
- *   1. UserPromptSubmit 摘要（relationsDigest）：每轮把全图压成 ≤N 行，
- *      用户画的排前面 —— 他专门画的线就是他想让你知道的事。
- *   2. PreToolUse 邻域（fileNeighborhood）：agent 摸某个文件时，只注连着
- *      这个文件的边（摘要被截断时的精确补充）。
- *
- * 端点是画布 id（= kind 前缀 + 工作区相对路径，或画布原生 id `text:`/
- * `scribble:`）。手写字端点渲染**内容本身**——这是「标注作用全局」的关键一步：
- * 用户在画布上写的字经由一条线变成 agent 眼里的上下文。涂鸦端点诚实占位
- * （笔画内容看不见，要看得截图），不假装理解。
- */
-
-import { readBoard } from '../projects/board-store.js';
-import { BINDING_TYPES } from './binding-types.js';
-import { KINDS } from './kinds/index.js';
-
-// ⚠️ **从注册表派生，别手写**（2026-08-18 修）。这行原来写死 `['deck:','site:']`，
-// 于是 docx 上线之后 `docx:` 前缀的卡不在表里 —— **它们身上的关系线 agent 一条也
-// 看不见**（endpointMatchesRel 永远不匹配），而且错得很安静。
-// 这是「加形态时最容易漏的写死处」家族的第三处（前两处是前端 cardIdOf 和
-// BoardCanvas 的 type:'deck'，08-17 已修）。
-const KIND_PREFIXES = Object.keys(KINDS).map(id => `${id}:`);
-
-// 目录型形态的前缀（kind 条目声明了 directory 的那些）。2026-08-18 补修：
-// 下面 endpointMatchesRel 的收敛循环原来写死 `['site:']` —— 上面 KIND_PREFIXES
-// 修掉写死表的同一天，这半个同款病漏掉了：word 文件夹卡（docx:报告）身上的边，
-// agent 摸成员文件（报告/终稿v2.docx）时注不进 fileNeighborhood。
-const DIR_KIND_PREFIXES = Object.entries(KINDS)
-  .filter(([, def]) => def.directory).map(([id]) => `${id}:`);
-
-/** 端点 id → 给 agent 看的一小段描述 */
-export function describeEndpoint(end, board) {
-  const obj = board?.objects?.[end];
-  if (obj?.kind === 'text') {
-    const t = String(obj.data?.t || '').replace(/\s+/g, ' ').trim().slice(0, 80);
-    return `手写字「${t}」`;
-  }
-  if (obj?.kind === 'scribble') return '一笔涂鸦（笔画内容要看得截图画布）';
-  for (const p of KIND_PREFIXES) {
-    if (end.startsWith(p)) {
-      const rel = end.slice(p.length);
-      const kind = p.slice(0, -1);
-      return rel ? `${rel}（${kind}）` : `工作区根上的${kind}`;
-    }
-  }
-  return end;   // 裸文件路径或文件夹路径
-}
-
-/** 一条边 → 一行中文。方向用箭头表达，无向用平线。 */
-export function bindingLine(b, board) {
-  const t = BINDING_TYPES[b.type];
-  const word = b.label || t?.label || b.type;
-  const joint = t?.directed ? `─${word}→` : `─${word}─`;
-  const who = b.by === 'user' ? '〔用户画的〕' : b.by === 'agent' ? '〔你画的〕' : '';
-  return `${describeEndpoint(b.from, board)} ${joint} ${describeEndpoint(b.to, board)}${who}`;
-}
-
-/**
- * 全图摘要。用户画的排前面（他专门画的 = 他想让你知道的），截断报余量。
- * 没有任何线 → null（沉默，不占 prompt）。
- */
-export async function relationsDigest(pid, { limit = 12 } = {}) {
-  if (!pid) return null;
-  const board = await readBoard(pid);
-  const all = Object.values(board.bindings || {});
-  if (!all.length) return null;
-  // 手画的逐条列；自动 ref（内容引用对账出来的底仓）**收拢成每源一行**——
-  // 一个站引三十张图，铺开就把摘要刷没了。优先级 user > agent > auto。
-  const manual = [
-    ...all.filter(b => b.by === 'user'),
-    ...all.filter(b => b.by === 'agent'),
-    ...all.filter(b => b.by !== 'user' && b.by !== 'agent' && !(b.by === 'auto' && b.type === 'ref')),
-  ];
-  const autoRefs = all.filter(b => b.by === 'auto' && b.type === 'ref');
-  const lines = manual.slice(0, limit).map(b => `  ${bindingLine(b, board)}`);
-  const more = manual.length - lines.length;
-  if (more > 0) lines.push(`  …还有 ${more} 条（摸到相关文件时会单独提示）`);
-  if (autoRefs.length) {
-    const bySrc = new Map();
-    for (const b of autoRefs) {
-      if (!bySrc.has(b.from)) bySrc.set(b.from, []);
-      bySrc.get(b.from).push(b.to);
-    }
-    for (const [from, tos] of [...bySrc].slice(0, 4)) {
-      const sample = tos.slice(0, 3).join('、');
-      lines.push(`  ${describeEndpoint(from, board)} ─取材─ ${tos.length} 件素材（自动对账：${sample}${tos.length > 3 ? ' 等' : ''}）`);
-    }
-    if (bySrc.size > 4) lines.push(`  …另有 ${bySrc.size - 4} 件产物的取材清单省略`);
-  }
-  return lines.join('\n');
-}
-
-/** 某个端点 id 是否指向这个工作区相对路径（裸路径或任一 kind 前缀形态）。
- *  导出仅供测试钉规则（fileNeighborhood 是唯一业务调用方）。 */
-export function endpointMatchesRel(end, rel) {
-  if (end === rel) return true;
-  for (const p of KIND_PREFIXES) if (end === p + rel) return true;
-  // 目录型产物的收敛（2026-08-14 根站病族普查补上的）：站点/word 文件夹的边
-  // 挂在**根卡**上，agent 摸的是里面的文件 —— 原来只做精确匹配，等于站点页的
-  // 一跳邻域从来注入不出来。按"住在这个根里"匹配；根站（root=空串）收根层
-  // 散文件（.md 除外）—— 与前端 resolveObjectId 同一条规则，两边别岔开。
-  for (const p of DIR_KIND_PREFIXES) {
-    if (!end.startsWith(p)) continue;
-    const root = end.slice(p.length);
-    if (root === '') {
-      if (!rel.includes('/') && !/\.md$/i.test(rel)) return true;
-      continue;
-    }
-    if (rel === root || rel.startsWith(`${root}/`)) return true;
-  }
-  return false;
-}
-
-/**
- * 一跳邻域：连着某个文件/文件夹的全部边。没有 → null。
- * PreToolUse 注入用 —— agent 正要摸的东西，它身上的线最相关。
- */
-export async function fileNeighborhood(pid, rel, { limit = 6 } = {}) {
-  if (!pid || !rel) return null;
-  const board = await readBoard(pid);
-  const hits = Object.values(board.bindings || {})
-    .filter(b => endpointMatchesRel(b.from, rel) || endpointMatchesRel(b.to, rel));
-  if (!hits.length) return null;
-  const lines = hits.slice(0, limit).map(b => `  ${bindingLine(b, board)}`);
-  if (hits.length > limit) lines.push(`  …还有 ${hits.length - limit} 条`);
-  return lines.join('\n');
-}
+/**
+ * server/lib/board-relations.js — 关系线的 agent 读侧（2026-08-14，切片③）
+ *
+ * 在此之前 bindings 是**只写不读**的：agent 有 relate_on_board 能画线、用户
+ * 在画布上看得见，但没有任何一层把「用户画了什么关系」喂回 agent —— 线是
+ * 装饰。这份文件是读侧的唯一实现，两个消费口都从这儿取：
+ *
+ *   1. UserPromptSubmit 摘要（relationsDigest）：每轮把全图压成 ≤N 行，
+ *      用户画的排前面 —— 他专门画的线就是他想让你知道的事。
+ *   2. PreToolUse 邻域（fileNeighborhood）：agent 摸某个文件时，只注连着
+ *      这个文件的边（摘要被截断时的精确补充）。
+ *
+ * 端点是画布 id（= kind 前缀 + 工作区相对路径，或画布原生 id `text:`/
+ * `scribble:`）。手写字端点渲染**内容本身**——这是「标注作用全局」的关键一步：
+ * 用户在画布上写的字经由一条线变成 agent 眼里的上下文。涂鸦端点诚实占位
+ * （笔画内容看不见，要看得截图），不假装理解。
+ */
+
+import { readBoard } from '../projects/board-store.js';
+import { BINDING_TYPES } from './binding-types.js';
+import { KINDS } from './kinds/index.js';
+
+// ⚠️ **从注册表派生，别手写**（2026-08-18 修）。这行原来写死 `['deck:','site:']`，
+// 于是 docx 上线之后 `docx:` 前缀的卡不在表里 —— **它们身上的关系线 agent 一条也
+// 看不见**（endpointMatchesRel 永远不匹配），而且错得很安静。
+// 这是「加形态时最容易漏的写死处」家族的第三处（前两处是前端 cardIdOf 和
+// BoardCanvas 的 type:'deck'，08-17 已修）。
+const KIND_PREFIXES = Object.keys(KINDS).map(id => `${id}:`);
+
+// 目录型形态的前缀（kind 条目声明了 directory 的那些）。2026-08-18 补修：
+// 下面 endpointMatchesRel 的收敛循环原来写死 `['site:']` —— 上面 KIND_PREFIXES
+// 修掉写死表的同一天，这半个同款病漏掉了：word 文件夹卡（docx:报告）身上的边，
+// agent 摸成员文件（报告/终稿v2.docx）时注不进 fileNeighborhood。
+const DIR_KIND_PREFIXES = Object.entries(KINDS)
+  .filter(([, def]) => def.directory).map(([id]) => `${id}:`);
+
+/** 端点 id → 给 agent 看的一小段描述 */
+export function describeEndpoint(end, board) {
+  const obj = board?.objects?.[end];
+  if (obj?.kind === 'text') {
+    const t = String(obj.data?.t || '').replace(/\s+/g, ' ').trim().slice(0, 80);
+    return `手写字「${t}」`;
+  }
+  if (obj?.kind === 'scribble') return '一笔涂鸦（笔画内容要看得截图画布）';
+  for (const p of KIND_PREFIXES) {
+    if (end.startsWith(p)) {
+      const rel = end.slice(p.length);
+      const kind = p.slice(0, -1);
+      return rel ? `${rel}（${kind}）` : `工作区根上的${kind}`;
+    }
+  }
+  return end;   // 裸文件路径或文件夹路径
+}
+
+/** 一条边 → 一行中文。方向用箭头表达，无向用平线。 */
+export function bindingLine(b, board) {
+  const t = BINDING_TYPES[b.type];
+  const word = b.label || t?.label || b.type;
+  const joint = t?.directed ? `─${word}→` : `─${word}─`;
+  const who = b.by === 'user' ? '〔用户画的〕' : b.by === 'agent' ? '〔你画的〕' : '';
+  return `${describeEndpoint(b.from, board)} ${joint} ${describeEndpoint(b.to, board)}${who}`;
+}
+
+/**
+ * 全图摘要。用户画的排前面（他专门画的 = 他想让你知道的），截断报余量。
+ * 没有任何线 → null（沉默，不占 prompt）。
+ */
+export async function relationsDigest(pid, { limit = 12 } = {}) {
+  if (!pid) return null;
+  const board = await readBoard(pid);
+  const all = Object.values(board.bindings || {});
+  if (!all.length) return null;
+  // 手画的逐条列；自动 ref（内容引用对账出来的底仓）**收拢成每源一行**——
+  // 一个站引三十张图，铺开就把摘要刷没了。优先级 user > agent > auto。
+  const manual = [
+    ...all.filter(b => b.by === 'user'),
+    ...all.filter(b => b.by === 'agent'),
+    ...all.filter(b => b.by !== 'user' && b.by !== 'agent' && !(b.by === 'auto' && b.type === 'ref')),
+  ];
+  const autoRefs = all.filter(b => b.by === 'auto' && b.type === 'ref');
+  const lines = manual.slice(0, limit).map(b => `  ${bindingLine(b, board)}`);
+  const more = manual.length - lines.length;
+  if (more > 0) lines.push(`  …还有 ${more} 条（摸到相关文件时会单独提示）`);
+  if (autoRefs.length) {
+    const bySrc = new Map();
+    for (const b of autoRefs) {
+      if (!bySrc.has(b.from)) bySrc.set(b.from, []);
+      bySrc.get(b.from).push(b.to);
+    }
+    for (const [from, tos] of [...bySrc].slice(0, 4)) {
+      const sample = tos.slice(0, 3).join('、');
+      lines.push(`  ${describeEndpoint(from, board)} ─取材─ ${tos.length} 件素材（自动对账：${sample}${tos.length > 3 ? ' 等' : ''}）`);
+    }
+    if (bySrc.size > 4) lines.push(`  …另有 ${bySrc.size - 4} 件产物的取材清单省略`);
+  }
+  return lines.join('\n');
+}
+
+/** 某个端点 id 是否指向这个工作区相对路径（裸路径或任一 kind 前缀形态）。
+ *  导出仅供测试钉规则（fileNeighborhood 是唯一业务调用方）。 */
+export function endpointMatchesRel(end, rel) {
+  if (end === rel) return true;
+  for (const p of KIND_PREFIXES) if (end === p + rel) return true;
+  // 目录型产物的收敛（2026-08-14 根站病族普查补上的）：站点/word 文件夹的边
+  // 挂在**根卡**上，agent 摸的是里面的文件 —— 原来只做精确匹配，等于站点页的
+  // 一跳邻域从来注入不出来。按"住在这个根里"匹配；根站（root=空串）收根层
+  // 散文件（.md 除外）—— 与前端 resolveObjectId 同一条规则，两边别岔开。
+  for (const p of DIR_KIND_PREFIXES) {
+    if (!end.startsWith(p)) continue;
+    const root = end.slice(p.length);
+    if (root === '') {
+      if (!rel.includes('/') && !/\.md$/i.test(rel)) return true;
+      continue;
+    }
+    if (rel === root || rel.startsWith(`${root}/`)) return true;
+  }
+  return false;
+}
+
+/**
+ * 一跳邻域：连着某个文件/文件夹的全部边。没有 → null。
+ * PreToolUse 注入用 —— agent 正要摸的东西，它身上的线最相关。
+ */
+export async function fileNeighborhood(pid, rel, { limit = 6 } = {}) {
+  if (!pid || !rel) return null;
+  const board = await readBoard(pid);
+  const hits = Object.values(board.bindings || {})
+    .filter(b => endpointMatchesRel(b.from, rel) || endpointMatchesRel(b.to, rel));
+  if (!hits.length) return null;
+  const lines = hits.slice(0, limit).map(b => `  ${bindingLine(b, board)}`);
+  if (hits.length > limit) lines.push(`  …还有 ${hits.length - limit} 条`);
+  return lines.join('\n');
+}