@xiaobuyu/nodesign 0.0.1 → 0.0.2

package/server/engine/mcp/tools/lookup-tags.js

@@ -1,59 +1,59 @@
-/**
- * mcp/tools/lookup-tags.js — lookup_tags MCP tool（2026-08-20）
- *
- * danbooru 系模型（noobai / noobai-eps / pony）的标签写错不报错、只静默失效。
- * 08-18 起 paint_still **画完之后**会体检；这个工具把查的动作挪到**画之前**，
- * 配手册里的起手纪律：先从用户的话里理解要画什么 → 把每个概念想成候选标签 →
- * 一次 lookup_tags 拿真实收录量和候选替换 → 再 paint_still。
- *
- * 薄壳：逻辑全在 lib/danbooru-tags.js（和体检共用一份，别分叉）。
- * fail-open：danbooru 查不到就明说查不到，不挡出图。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { lookupTags, formatLookup } from '../../../lib/danbooru-tags.js';
-
-export function makeLookupTagsTool() {
-  return tool(
-    'lookup_tags',
-    `Check danbooru tags BEFORE painting with noobai / noobai-eps / pony
-(paint_still). These models only understand danbooru tags; a misspelled or
-unused tag fails SILENTLY — the model receives nothing and you burn a whole
-batch before anyone notices.
-
-Workflow: read what the user wants → list the concepts (subject, look,
-clothing, pose/expression, scene, lighting) → for each, write the danbooru
-tags you BELIEVE exist → call this ONCE with all of them in "tags" → keep the
-ones with post_count >= 1000, swap weak ones for the suggested candidates,
-then paint. Re-rolls of the same scene do not need another lookup.
-
-- tags:    exact names to verify (spaces or underscores both fine). Weak or
-           missing ones come back with real candidates ranked by post_count.
-- search:  free words when you do not know the tag at all ("makeup", "lick")
-           → matching tags ranked by post_count.
-- explain: tag names whose meaning you want (first lines of the danbooru wiki)
-           — useful to pick between near-synonyms.
-
-post_count < 1000 means WEAK, not forbidden: for mainstream needs pick the
-stronger candidate; when the user's taste is itself niche, use the weak tag and
-reinforce it with a related stronger one. Artist names always need checking.
-Results are hints — the prompt wording stays your call.`,
-    {
-      tags: z.array(z.string().min(1).max(80)).max(60).optional()
-        .describe('tag names to verify, e.g. ["long hair", "smeared lipstick", "artist:dairi"]'),
-      search: z.array(z.string().min(2).max(40)).max(10).optional()
-        .describe('free words to search tags by, e.g. ["makeup", "lick"]'),
-      explain: z.array(z.string().min(1).max(80)).max(8).optional()
-        .describe('tag names to get the wiki meaning of'),
-    },
-    async ({ tags = [], search = [], explain = [] }) => {
-      try {
-        const r = await lookupTags({ tags, search, explain });
-        return { content: [{ type: 'text', text: formatLookup(r) }] };
-      } catch (err) {
-        return { content: [{ type: 'text', text: `lookup_tags 失败（不挡出图，照手册词表写）：${err.message}` }], isError: true };
-      }
-    },
-  );
-}
+/**
+ * mcp/tools/lookup-tags.js — lookup_tags MCP tool（2026-08-20）
+ *
+ * danbooru 系模型（noobai / noobai-eps / pony）的标签写错不报错、只静默失效。
+ * 08-18 起 paint_still **画完之后**会体检；这个工具把查的动作挪到**画之前**，
+ * 配手册里的起手纪律：先从用户的话里理解要画什么 → 把每个概念想成候选标签 →
+ * 一次 lookup_tags 拿真实收录量和候选替换 → 再 paint_still。
+ *
+ * 薄壳：逻辑全在 lib/danbooru-tags.js（和体检共用一份，别分叉）。
+ * fail-open：danbooru 查不到就明说查不到，不挡出图。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { lookupTags, formatLookup } from '../../../lib/danbooru-tags.js';
+
+export function makeLookupTagsTool() {
+  return tool(
+    'lookup_tags',
+    `Check danbooru tags BEFORE painting with noobai / noobai-eps / pony
+(paint_still). These models only understand danbooru tags; a misspelled or
+unused tag fails SILENTLY — the model receives nothing and you burn a whole
+batch before anyone notices.
+
+Workflow: read what the user wants → list the concepts (subject, look,
+clothing, pose/expression, scene, lighting) → for each, write the danbooru
+tags you BELIEVE exist → call this ONCE with all of them in "tags" → keep the
+ones with post_count >= 1000, swap weak ones for the suggested candidates,
+then paint. Re-rolls of the same scene do not need another lookup.
+
+- tags:    exact names to verify (spaces or underscores both fine). Weak or
+           missing ones come back with real candidates ranked by post_count.
+- search:  free words when you do not know the tag at all ("makeup", "lick")
+           → matching tags ranked by post_count.
+- explain: tag names whose meaning you want (first lines of the danbooru wiki)
+           — useful to pick between near-synonyms.
+
+post_count < 1000 means WEAK, not forbidden: for mainstream needs pick the
+stronger candidate; when the user's taste is itself niche, use the weak tag and
+reinforce it with a related stronger one. Artist names always need checking.
+Results are hints — the prompt wording stays your call.`,
+    {
+      tags: z.array(z.string().min(1).max(80)).max(60).optional()
+        .describe('tag names to verify, e.g. ["long hair", "smeared lipstick", "artist:dairi"]'),
+      search: z.array(z.string().min(2).max(40)).max(10).optional()
+        .describe('free words to search tags by, e.g. ["makeup", "lick"]'),
+      explain: z.array(z.string().min(1).max(80)).max(8).optional()
+        .describe('tag names to get the wiki meaning of'),
+    },
+    async ({ tags = [], search = [], explain = [] }) => {
+      try {
+        const r = await lookupTags({ tags, search, explain });
+        return { content: [{ type: 'text', text: formatLookup(r) }] };
+      } catch (err) {
+        return { content: [{ type: 'text', text: `lookup_tags 失败（不挡出图，照手册词表写）：${err.message}` }], isError: true };
+      }
+    },
+  );
+}

package/server/engine/mcp/tools/navigate-to-page.js

@@ -1,60 +1,60 @@
-/**
- * mcp/tools/navigate-to-page.js — navigate_to_page MCP tool
- *
- * 让 agent 主动把前端 canvas 切到第 N 页。典型场景：agent 在分析多页 deck，
- * 一边讲一边切；或者用户问"第 3 页那个图怎么改"，agent 先切过去再选元素。
- *
- * 实现：纯 emit run.canvas_navigate 事件 → 已订阅 '*' 的 ws bridge 自动转发，
- * 前端 ProjectWorkspace 收到后调 SlideNavigator setActivePage / iframe 内
- * scrollIntoView 对应 section[data-page="N"]。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-
-/**
- * @param {object} deps
- * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
- */
-export function makeNavigateToPageTool({ ctx }) {
-  return tool(
-    'navigate_to_page',
-    `Switch the canvas in the user's frontend to a specific page (1-based).
-
-Use this when:
-- You're explaining/changing page N and want the user to see the same page
-- The user asks about "page 3" — switch to it before discussing
-- After editing a non-current page so the user sees the result
-
-The frontend will scroll to <section data-page="N"> and update the page nav.`,
-    {
-      index: z
-        .number()
-        .int()
-        .min(1)
-        .describe('Target page number (1-based, matches data-page="N")'),
-    },
-    async ({ index }) => {
-      try {
-        ctx?.emit?.({
-          type: 'run.canvas_navigate',
-          page: index,
-        });
-        return {
-          content: [{
-            type: 'text',
-            text: `Navigated frontend canvas to page ${index}.`,
-          }],
-        };
-      } catch (err) {
-        return {
-          content: [{
-            type: 'text',
-            text: `navigate_to_page failed: ${err?.message || String(err)}`,
-          }],
-          isError: true,
-        };
-      }
-    },
-  );
-}
+/**
+ * mcp/tools/navigate-to-page.js — navigate_to_page MCP tool
+ *
+ * 让 agent 主动把前端 canvas 切到第 N 页。典型场景：agent 在分析多页 deck，
+ * 一边讲一边切；或者用户问"第 3 页那个图怎么改"，agent 先切过去再选元素。
+ *
+ * 实现：纯 emit run.canvas_navigate 事件 → 已订阅 '*' 的 ws bridge 自动转发，
+ * 前端 ProjectWorkspace 收到后调 SlideNavigator setActivePage / iframe 内
+ * scrollIntoView 对应 section[data-page="N"]。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+
+/**
+ * @param {object} deps
+ * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
+ */
+export function makeNavigateToPageTool({ ctx }) {
+  return tool(
+    'navigate_to_page',
+    `Switch the canvas in the user's frontend to a specific page (1-based).
+
+Use this when:
+- You're explaining/changing page N and want the user to see the same page
+- The user asks about "page 3" — switch to it before discussing
+- After editing a non-current page so the user sees the result
+
+The frontend will scroll to <section data-page="N"> and update the page nav.`,
+    {
+      index: z
+        .number()
+        .int()
+        .min(1)
+        .describe('Target page number (1-based, matches data-page="N")'),
+    },
+    async ({ index }) => {
+      try {
+        ctx?.emit?.({
+          type: 'run.canvas_navigate',
+          page: index,
+        });
+        return {
+          content: [{
+            type: 'text',
+            text: `Navigated frontend canvas to page ${index}.`,
+          }],
+        };
+      } catch (err) {
+        return {
+          content: [{
+            type: 'text',
+            text: `navigate_to_page failed: ${err?.message || String(err)}`,
+          }],
+          isError: true,
+        };
+      }
+    },
+  );
+}

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

@@ -1,64 +1,64 @@
-/**
- * mcp/tools/organize-board.js —— organize_board（2026-08-14，用户提议）
- *
- * 画布语言的收纳动词：把散在桌面上的产物（生成图 / 文件 / 文件夹）归进
- * 文件夹。在这之前 agent 只能裸 Bash mv —— 能用，但它不知道搬家的画布语义
- * （id=路径，搬=换身份，关系线端点要跟着走），裸 mv 只靠每轮 commit 对账
- * 兜底，窗口期里剪枝器还可能把正在改名的东西连坐剪掉。
- *
- * 实现 = **和用户拖拽「移动到…」同一份核心**（projects/move-entry.js）：
- * 磁盘先行、画布身份同步、转发表记账，一个字不重写。
- *
- * 批量制（同 roll_film / paint_still）：≤16 件、串行、**中途失败即停**
- * （后面的不动，报告哪件停的）。目标夹不存在就建 —— 归纳常配新夹。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { moveEntry, MoveError } from '../../../projects/move-entry.js';
-import { Events } from '../../agent/events.js';
-
-export function makeOrganizeBoardTool({ projectId, ctx }) {
-  return tool(
-    'organize_board',
-    `Tidy the workbench canvas: move artifacts (generated images, files, folders) into a folder. Same semantics as the user dragging a card into a folder — the file really moves on disk, and its canvas identity (position, relation lines) follows automatically.
-
-Use for: grouping generated images into a folder, collecting a site's materials into <site>/assets/, un-cluttering the desktop root. Sticky notes (notes/*.md) may move too, but they become plain .md file cards outside notes/ — lose the flippable sticky form.
-Not for: site roots as destination (they are artifacts, not storage — a site takes materials in its assets/ subfolder).
-
-Batch: up to 16 items, moved in order, stops at first failure.`,
-    {
-      items: z.array(z.string().min(1)).min(1).max(16)
-        .describe('Workspace-relative paths to move (files or folders), e.g. ["assets/generated/a.png", "旧稿.html"]'),
-      into: z.string()
-        .describe('Destination folder (workspace-relative), e.g. "素材" or "观察日志/assets". Created if missing. "" = workspace root (un-nest).'),
-    },
-    async ({ items, into }) => {
-      const lines = [];
-      let moved = 0;
-      for (const item of items) {
-        try {
-          const out = await moveEntry(projectId, item, into, { createFolder: true });
-          moved += 1;
-          lines.push(out.moved ? `✓ ${out.from} → ${out.to}` : `· ${out.from}（已在原地）`);
-          if (out.moved) {
-            try {
-              // 补一发 file_changed（MCP 写盘不走 PostToolUse 直发）：前端产物
-              // 清单重拉 + 在场精灵的挂账路径补射都吃这个
-              ctx?.emit?.(Events.fileChanged(out.to, 'rename'));   // 工作区相对路径=正字法
-            } catch { /* fail-soft */ }
-          }
-        } catch (err) {
-          const why = err instanceof MoveError ? err.message : (err?.message || String(err));
-          lines.push(`✗ ${item}：${why}`);
-          lines.push(`（后面 ${items.length - moved - 1} 件没动 —— 修正后重调）`);
-          break;
-        }
-      }
-      try {
-        if (moved > 0) ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `归纳了 ${moved} 件到 ${into || '桌面根'}` });
-      } catch { /* fail-soft */ }
-      return { content: [{ type: 'text', text: lines.join('\n') }] };
-    },
-  );
-}
+/**
+ * mcp/tools/organize-board.js —— organize_board（2026-08-14，用户提议）
+ *
+ * 画布语言的收纳动词：把散在桌面上的产物（生成图 / 文件 / 文件夹）归进
+ * 文件夹。在这之前 agent 只能裸 Bash mv —— 能用，但它不知道搬家的画布语义
+ * （id=路径，搬=换身份，关系线端点要跟着走），裸 mv 只靠每轮 commit 对账
+ * 兜底，窗口期里剪枝器还可能把正在改名的东西连坐剪掉。
+ *
+ * 实现 = **和用户拖拽「移动到…」同一份核心**（projects/move-entry.js）：
+ * 磁盘先行、画布身份同步、转发表记账，一个字不重写。
+ *
+ * 批量制（同 roll_film / paint_still）：≤16 件、串行、**中途失败即停**
+ * （后面的不动，报告哪件停的）。目标夹不存在就建 —— 归纳常配新夹。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { moveEntry, MoveError } from '../../../projects/move-entry.js';
+import { Events } from '../../agent/events.js';
+
+export function makeOrganizeBoardTool({ projectId, ctx }) {
+  return tool(
+    'organize_board',
+    `Tidy the workbench canvas: move artifacts (generated images, files, folders) into a folder. Same semantics as the user dragging a card into a folder — the file really moves on disk, and its canvas identity (position, relation lines) follows automatically.
+
+Use for: grouping generated images into a folder, collecting a site's materials into <site>/assets/, un-cluttering the desktop root. Sticky notes (notes/*.md) may move too, but they become plain .md file cards outside notes/ — lose the flippable sticky form.
+Not for: site roots as destination (they are artifacts, not storage — a site takes materials in its assets/ subfolder).
+
+Batch: up to 16 items, moved in order, stops at first failure.`,
+    {
+      items: z.array(z.string().min(1)).min(1).max(16)
+        .describe('Workspace-relative paths to move (files or folders), e.g. ["assets/generated/a.png", "旧稿.html"]'),
+      into: z.string()
+        .describe('Destination folder (workspace-relative), e.g. "素材" or "观察日志/assets". Created if missing. "" = workspace root (un-nest).'),
+    },
+    async ({ items, into }) => {
+      const lines = [];
+      let moved = 0;
+      for (const item of items) {
+        try {
+          const out = await moveEntry(projectId, item, into, { createFolder: true });
+          moved += 1;
+          lines.push(out.moved ? `✓ ${out.from} → ${out.to}` : `· ${out.from}（已在原地）`);
+          if (out.moved) {
+            try {
+              // 补一发 file_changed（MCP 写盘不走 PostToolUse 直发）：前端产物
+              // 清单重拉 + 在场精灵的挂账路径补射都吃这个
+              ctx?.emit?.(Events.fileChanged(out.to, 'rename'));   // 工作区相对路径=正字法
+            } catch { /* fail-soft */ }
+          }
+        } catch (err) {
+          const why = err instanceof MoveError ? err.message : (err?.message || String(err));
+          lines.push(`✗ ${item}：${why}`);
+          lines.push(`（后面 ${items.length - moved - 1} 件没动 —— 修正后重调）`);
+          break;
+        }
+      }
+      try {
+        if (moved > 0) ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `归纳了 ${moved} 件到 ${into || '桌面根'}` });
+      } catch { /* fail-soft */ }
+      return { content: [{ type: 'text', text: lines.join('\n') }] };
+    },
+  );
+}