@xiaobuyu/nodesign 0.0.1 → 0.0.2

package/server/engine/mcp/tools/read-board.js

@@ -1,103 +1,103 @@
-/**
- * mcp/tools/read-board.js —— read_board（2026-08-14，agent 摆位批·读侧）
- *
- * 让 agent **看得见版面**。在这之前它对画布的了解只有关系线摘要 —— 每件东西
- * 坐哪、挨着谁、谁是主角，全是盲区，"摆放"无从谈起。这个工具把 board.json
- * 翻译成一张按层分组、按行排读的座次表。
- *
- * 口径说明（都写进输出，agent 不用猜）：
- *   - 只列**摆过的**：board.json 是稀疏表，刚产出还没排座的产物没有条目
- *     （前端首排后几百毫秒内落盘，通常都在）
- *   - 层归属是服务端近似（zone 字段优先，其次沿路径找已知文件夹）
- *   - 尺寸是形态估算（文字/涂鸦用存档实测值）
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { readBoard } from '../../../projects/board-store.js';
-import { estimateSize } from '../../../lib/board-kind-sizes.js';
-import { layerOf } from '../../../lib/canvas-id.js';
-import { relationsDigest } from '../../../lib/board-relations.js';
-
-/** 同一"行"的 y 容差：入座算法一行内顶对齐，40 世界像素内视作同行 */
-const ROW_TOLERANCE = 40;
-
-function describeEntry(id, entry) {
-  const sz = estimateSize(id, entry);
-  const at = `@(${Math.round(entry.x)},${Math.round(entry.y)}) ${Math.round(sz.w)}x${Math.round(sz.h)}`;
-  if (entry.kind === 'text') {
-    const t = String(entry.data?.t || '').replace(/\s+/g, ' ').slice(0, 24);
-    return `- [手写] 「${t}」 ${at} (id: ${id})${entry.by === 'agent' ? ' ·你写的' : ''}`;
-  }
-  if (entry.kind === 'scribble') return `- [涂鸦] ${at} (id: ${id})`;
-  return `- ${id} ${at}${entry.by === 'agent' ? ' ·你摆的' : ''}`;
-}
-
-export function makeReadBoardTool({ projectId }) {
-  return tool(
-    'read_board',
-    `Read the workbench canvas seating chart: what sits where, row by row, per folder layer.
-
-Use this BEFORE arranging anything (arrange_on_board) or writing notes near things
-(create_on_board) — placement without looking is guessing. Coordinates are world
-pixels; items listed top-to-bottom, left-to-right per row. Only items that have
-been seated appear (freshly produced artifacts get their seat within a second).`,
-    {
-      layer: z.string().max(300).optional()
-        .describe("Folder path to read ('' or omitted = the root desktop plus a folder list)"),
-    },
-    async ({ layer }) => {
-      if (!projectId) {
-        return { content: [{ type: 'text', text: 'No project bound.' }], isError: true };
-      }
-      const board = await readBoard(projectId);
-      const known = new Set(Object.keys(board.zones || {}));
-      const want = typeof layer === 'string' ? layer : '';
-
-      // 分层
-      const byLayer = new Map();
-      for (const [id, entry] of Object.entries(board.objects || {})) {
-        if (!Number.isFinite(entry?.x) || !Number.isFinite(entry?.y)) continue;
-        const l = layerOf(id, entry, known);
-        if (!byLayer.has(l)) byLayer.set(l, []);
-        byLayer.get(l).push({ id, entry });
-      }
-
-      const lines = [];
-      const renderLayer = (l) => {
-        const items = (byLayer.get(l) || []).sort((a, b) =>
-          (a.entry.y - b.entry.y) || (a.entry.x - b.entry.x));
-        if (!items.length) { lines.push('（这一层还没有摆过的东西）'); return; }
-        let rowY = null;
-        for (const { id, entry } of items) {
-          if (rowY === null || Math.abs(entry.y - rowY) > ROW_TOLERANCE) {
-            rowY = entry.y;
-            lines.push(`— 行 y≈${Math.round(rowY)} —`);
-          }
-          lines.push(describeEntry(id, entry));
-        }
-      };
-
-      lines.push(want ? `文件夹「${want}」的座次：` : '桌面（根层）的座次：');
-      renderLayer(want);
-      if (!want) {
-        const folders = Object.keys(board.zones || {}).sort();
-        if (folders.length) {
-          lines.push('', `文件夹卡：${folders.map(f => {
-            const zz = board.zones[f];
-            return `${f}@(${Math.round(zz.x)},${Math.round(zz.y)})`;
-          }).join('、')}`);
-        }
-      }
-      if (board.hero) lines.push('', `★ 显式主角：${board.hero}（arrange_on_board 的 feature/unfeature 管它）`);
-
-      try {
-        const digest = await relationsDigest(projectId, { limit: 16 });
-        if (digest) lines.push('', '关系线：', digest);
-      } catch { /* 关系读不到不挡座次 */ }
-
-      lines.push('', '（口径：稀疏表只列摆过的；层归属为服务端近似；尺寸为形态估算）');
-      return { content: [{ type: 'text', text: lines.join('\n') }] };
-    },
-  );
-}
+/**
+ * mcp/tools/read-board.js —— read_board（2026-08-14，agent 摆位批·读侧）
+ *
+ * 让 agent **看得见版面**。在这之前它对画布的了解只有关系线摘要 —— 每件东西
+ * 坐哪、挨着谁、谁是主角，全是盲区，"摆放"无从谈起。这个工具把 board.json
+ * 翻译成一张按层分组、按行排读的座次表。
+ *
+ * 口径说明（都写进输出，agent 不用猜）：
+ *   - 只列**摆过的**：board.json 是稀疏表，刚产出还没排座的产物没有条目
+ *     （前端首排后几百毫秒内落盘，通常都在）
+ *   - 层归属是服务端近似（zone 字段优先，其次沿路径找已知文件夹）
+ *   - 尺寸是形态估算（文字/涂鸦用存档实测值）
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { readBoard } from '../../../projects/board-store.js';
+import { estimateSize } from '../../../lib/board-kind-sizes.js';
+import { layerOf } from '../../../lib/canvas-id.js';
+import { relationsDigest } from '../../../lib/board-relations.js';
+
+/** 同一"行"的 y 容差：入座算法一行内顶对齐，40 世界像素内视作同行 */
+const ROW_TOLERANCE = 40;
+
+function describeEntry(id, entry) {
+  const sz = estimateSize(id, entry);
+  const at = `@(${Math.round(entry.x)},${Math.round(entry.y)}) ${Math.round(sz.w)}x${Math.round(sz.h)}`;
+  if (entry.kind === 'text') {
+    const t = String(entry.data?.t || '').replace(/\s+/g, ' ').slice(0, 24);
+    return `- [手写] 「${t}」 ${at} (id: ${id})${entry.by === 'agent' ? ' ·你写的' : ''}`;
+  }
+  if (entry.kind === 'scribble') return `- [涂鸦] ${at} (id: ${id})`;
+  return `- ${id} ${at}${entry.by === 'agent' ? ' ·你摆的' : ''}`;
+}
+
+export function makeReadBoardTool({ projectId }) {
+  return tool(
+    'read_board',
+    `Read the workbench canvas seating chart: what sits where, row by row, per folder layer.
+
+Use this BEFORE arranging anything (arrange_on_board) or writing notes near things
+(create_on_board) — placement without looking is guessing. Coordinates are world
+pixels; items listed top-to-bottom, left-to-right per row. Only items that have
+been seated appear (freshly produced artifacts get their seat within a second).`,
+    {
+      layer: z.string().max(300).optional()
+        .describe("Folder path to read ('' or omitted = the root desktop plus a folder list)"),
+    },
+    async ({ layer }) => {
+      if (!projectId) {
+        return { content: [{ type: 'text', text: 'No project bound.' }], isError: true };
+      }
+      const board = await readBoard(projectId);
+      const known = new Set(Object.keys(board.zones || {}));
+      const want = typeof layer === 'string' ? layer : '';
+
+      // 分层
+      const byLayer = new Map();
+      for (const [id, entry] of Object.entries(board.objects || {})) {
+        if (!Number.isFinite(entry?.x) || !Number.isFinite(entry?.y)) continue;
+        const l = layerOf(id, entry, known);
+        if (!byLayer.has(l)) byLayer.set(l, []);
+        byLayer.get(l).push({ id, entry });
+      }
+
+      const lines = [];
+      const renderLayer = (l) => {
+        const items = (byLayer.get(l) || []).sort((a, b) =>
+          (a.entry.y - b.entry.y) || (a.entry.x - b.entry.x));
+        if (!items.length) { lines.push('（这一层还没有摆过的东西）'); return; }
+        let rowY = null;
+        for (const { id, entry } of items) {
+          if (rowY === null || Math.abs(entry.y - rowY) > ROW_TOLERANCE) {
+            rowY = entry.y;
+            lines.push(`— 行 y≈${Math.round(rowY)} —`);
+          }
+          lines.push(describeEntry(id, entry));
+        }
+      };
+
+      lines.push(want ? `文件夹「${want}」的座次：` : '桌面（根层）的座次：');
+      renderLayer(want);
+      if (!want) {
+        const folders = Object.keys(board.zones || {}).sort();
+        if (folders.length) {
+          lines.push('', `文件夹卡：${folders.map(f => {
+            const zz = board.zones[f];
+            return `${f}@(${Math.round(zz.x)},${Math.round(zz.y)})`;
+          }).join('、')}`);
+        }
+      }
+      if (board.hero) lines.push('', `★ 显式主角：${board.hero}（arrange_on_board 的 feature/unfeature 管它）`);
+
+      try {
+        const digest = await relationsDigest(projectId, { limit: 16 });
+        if (digest) lines.push('', '关系线：', digest);
+      } catch { /* 关系读不到不挡座次 */ }
+
+      lines.push('', '（口径：稀疏表只列摆过的；层归属为服务端近似；尺寸为形态估算）');
+      return { content: [{ type: 'text', text: lines.join('\n') }] };
+    },
+  );
+}

package/server/engine/mcp/tools/read-document.js

@@ -1,93 +1,93 @@
-/**
- * mcp/tools/read-document.js — read_document MCP tool（2026-08-07）
- *
- * Word / Excel / PowerPoint 三种格式的读取口。
- *
- * 为什么需要它：用户往上下文托盘里拖一份 .docx（"照这份需求做一版海报"），
- * agent 拿 Read 去读得到的是二进制乱码 —— **而且不报错**，它会当成一份读不懂
- * 的文件继续往下干，交出一个跟需求无关的东西。这是最坏的一种失败：安静的。
- *
- * PDF 不走这里：SDK 的 Read 原生支持，2026-08-07 真跑验过。
- */
-
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { extractDocument, isExtractable, DOC_KINDS, MAX_CHARS } from '../../../lib/doc-extract.js';
-
-const EXT_LIST = Object.keys(DOC_KINDS).join(' / ');
-
-export function makeReadDocumentTool({ workspaceRoot, sharedRoot }) {
-  return tool(
-    'read_document',
-    `Read the text out of a Word / Excel / PowerPoint file (${EXT_LIST}).
-
-The plain Read tool CANNOT read these — they are zip archives, so Read returns
-binary garbage without failing, and you end up working from nothing. Whenever a
-user attaches or points at one of these files, use this tool instead.
-
-(PDF is different: the normal Read tool handles PDFs natively — use Read for those.)
-
-What you get back is text with structure markers, not layout:
-- .docx — the document text, headings/lists/tables flattened in reading order
-- .xlsx — one section per worksheet, rows as tab-separated cells
-- .pptx — one section per slide, in slide order
-
-Layout is deliberately not preserved. You are being asked what the document
-*says*; how it should look is your job to decide.
-
-Long files are cut at ${MAX_CHARS} characters and the result says so.`,
-    {
-      path: z.string().describe(
-        'Path to the file. Relative paths resolve against the session workspace, '
-        + 'then against the shared project dir (e.g. "assets/需求.docx").',
-      ),
-    },
-    async ({ path: rel }) => {
-      const fail = (text) => ({ content: [{ type: 'text', text }], isError: true });
-      try {
-        const raw = String(rel || '').trim();
-        if (!raw) return fail('read_document needs a path.');
-
-        // 绝对路径直接用；相对路径先会话工作区、再项目共享目录
-        const candidates = path.isAbsolute(raw)
-          ? [raw]
-          : [workspaceRoot && path.resolve(workspaceRoot, raw),
-             sharedRoot && path.resolve(sharedRoot, raw)].filter(Boolean);
-
-        let absPath = null;
-        for (const c of candidates) {
-          try { await fs.access(c); absPath = c; break; } catch { /* 下一个 */ }
-        }
-        if (!absPath) {
-          return fail(`File not found: ${raw}\nLooked in:\n${candidates.map(c => `  ${c}`).join('\n')}`);
-        }
-
-        if (!isExtractable(absPath)) {
-          const ext = path.extname(absPath).toLowerCase();
-          return fail(
-            ext === '.pdf'
-              ? 'PDFs are handled by the normal Read tool — call Read on this path instead.'
-              : `read_document only handles ${EXT_LIST}. For "${ext}" try the normal Read tool.`,
-          );
-        }
-
-        const { kind, text, chars, truncated, note } = await extractDocument(absPath);
-        if (!text) {
-          return {
-            content: [{ type: 'text', text: `${kind} ${path.basename(absPath)} 里没有可读的文字${note ? `（${note}）` : ''}。` }],
-          };
-        }
-        const head = [
-          `${kind}：${path.basename(absPath)}`,
-          `${chars} 字${truncated ? `，只给前 ${MAX_CHARS} 字` : ''}`,
-          note,
-        ].filter(Boolean).join(' · ');
-        return { content: [{ type: 'text', text: `${head}\n\n${text}` }] };
-      } catch (err) {
-        return fail(`read_document failed: ${err?.message || String(err)}`);
-      }
-    },
-  );
-}
+/**
+ * mcp/tools/read-document.js — read_document MCP tool（2026-08-07）
+ *
+ * Word / Excel / PowerPoint 三种格式的读取口。
+ *
+ * 为什么需要它：用户往上下文托盘里拖一份 .docx（"照这份需求做一版海报"），
+ * agent 拿 Read 去读得到的是二进制乱码 —— **而且不报错**，它会当成一份读不懂
+ * 的文件继续往下干，交出一个跟需求无关的东西。这是最坏的一种失败：安静的。
+ *
+ * PDF 不走这里：SDK 的 Read 原生支持，2026-08-07 真跑验过。
+ */
+
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { extractDocument, isExtractable, DOC_KINDS, MAX_CHARS } from '../../../lib/doc-extract.js';
+
+const EXT_LIST = Object.keys(DOC_KINDS).join(' / ');
+
+export function makeReadDocumentTool({ workspaceRoot, sharedRoot }) {
+  return tool(
+    'read_document',
+    `Read the text out of a Word / Excel / PowerPoint file (${EXT_LIST}).
+
+The plain Read tool CANNOT read these — they are zip archives, so Read returns
+binary garbage without failing, and you end up working from nothing. Whenever a
+user attaches or points at one of these files, use this tool instead.
+
+(PDF is different: the normal Read tool handles PDFs natively — use Read for those.)
+
+What you get back is text with structure markers, not layout:
+- .docx — the document text, headings/lists/tables flattened in reading order
+- .xlsx — one section per worksheet, rows as tab-separated cells
+- .pptx — one section per slide, in slide order
+
+Layout is deliberately not preserved. You are being asked what the document
+*says*; how it should look is your job to decide.
+
+Long files are cut at ${MAX_CHARS} characters and the result says so.`,
+    {
+      path: z.string().describe(
+        'Path to the file. Relative paths resolve against the session workspace, '
+        + 'then against the shared project dir (e.g. "assets/需求.docx").',
+      ),
+    },
+    async ({ path: rel }) => {
+      const fail = (text) => ({ content: [{ type: 'text', text }], isError: true });
+      try {
+        const raw = String(rel || '').trim();
+        if (!raw) return fail('read_document needs a path.');
+
+        // 绝对路径直接用；相对路径先会话工作区、再项目共享目录
+        const candidates = path.isAbsolute(raw)
+          ? [raw]
+          : [workspaceRoot && path.resolve(workspaceRoot, raw),
+             sharedRoot && path.resolve(sharedRoot, raw)].filter(Boolean);
+
+        let absPath = null;
+        for (const c of candidates) {
+          try { await fs.access(c); absPath = c; break; } catch { /* 下一个 */ }
+        }
+        if (!absPath) {
+          return fail(`File not found: ${raw}\nLooked in:\n${candidates.map(c => `  ${c}`).join('\n')}`);
+        }
+
+        if (!isExtractable(absPath)) {
+          const ext = path.extname(absPath).toLowerCase();
+          return fail(
+            ext === '.pdf'
+              ? 'PDFs are handled by the normal Read tool — call Read on this path instead.'
+              : `read_document only handles ${EXT_LIST}. For "${ext}" try the normal Read tool.`,
+          );
+        }
+
+        const { kind, text, chars, truncated, note } = await extractDocument(absPath);
+        if (!text) {
+          return {
+            content: [{ type: 'text', text: `${kind} ${path.basename(absPath)} 里没有可读的文字${note ? `（${note}）` : ''}。` }],
+          };
+        }
+        const head = [
+          `${kind}：${path.basename(absPath)}`,
+          `${chars} 字${truncated ? `，只给前 ${MAX_CHARS} 字` : ''}`,
+          note,
+        ].filter(Boolean).join(' · ');
+        return { content: [{ type: 'text', text: `${head}\n\n${text}` }] };
+      } catch (err) {
+        return fail(`read_document failed: ${err?.message || String(err)}`);
+      }
+    },
+  );
+}