@xiaobuyu/nodesign 0.0.1 → 0.0.3

package/server/engine/mcp/tools/crystallize-skill.js

@@ -1,168 +1,168 @@
-/**
- * mcp/tools/crystallize-skill.js — crystallize_skill MCP tool
- *
- * 把一次真实探索的**结论**固化成用户自己的 skill，并把作品收进个人橱窗。
- *
- * 为什么不是"存模板"：模板是把成品存下来，换个主题就崩——真正能复用的是判断依据
- * （为什么这个字号阶梯、为什么这个场合压住动效、哪些默认做法在这个气质里必须反掉）。
- * 所以这个工具收的是方法论，不是 HTML。产物写进用户级 plugin 根
- * （~/.nodesign/plugins/<userId>/<name>/），下次开新会话在**这个用户的所有项目**里
- * 都能用（plugin 发现是 startup-time，当前会话不生效）。
- *
- * 跟 record_decision 的分工：决策贴是**这一件作品**的过程档案，随任务走；
- * 这里是跨项目复用的方法论，随用户走。一个是日志，一个是沉淀。
- *
- * 归属：写到**项目 owner** 的目录，不是"当前请求者"——同一个项目谁跑都该产出同一
- * 套资产。owner 查不到就报错，不往共享根写（那是刚修掉的跨用户污染路径）。
- */
-
-import { tool } from '@anthropic-ai/claude-agent-sdk';
-import { z } from 'zod';
-import { getProject } from '../../../projects/store.js';
-import { getUserPluginsRoot } from '../../agent/plugin-loader.js';
-import { installPluginToRoot } from '../../../lib/plugin-install.js';
-import { upsertEntry } from '../../../lib/showcase-store.js';
-import { getActiveArtifact } from '../../../lib/artifact-target.js';
-import { Events } from '../../agent/events.js';
-
-const NAME_RE = /^[a-z0-9][a-z0-9-]{2,39}$/;
-
-function composeSkillMd({ name, title, description, body }) {
-  return [
-    '---',
-    `name: ${name}`,
-    `description: ${description.replace(/\n+/g, ' ').trim()}`,
-    'version: 0.1.0',
-    '---',
-    '',
-    `# ${title.trim()}`,
-    '',
-    body.trim(),
-    '',
-  ].join('\n');
-}
-
-/**
- * @param {object} deps
- * @param {string} [deps.projectId]
- * @param {string} [deps.sessionId]
- * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
- */
-export function makeCrystallizeSkillTool({ projectId, sessionId, ctx }) {
-  return tool(
-    'crystallize_skill',
-    `Distill a style/approach the user and you worked out together into a REUSABLE
-SKILL owned by this user, and put the finished work in their personal showcase.
-
-Call this ONLY when the user asks to keep a style, or explicitly confirms they
-want this approach reusable. Never call it unprompted — a skill the user did not
-ask for is clutter in every future session.
-
-What belongs in \`body\` is the METHODOLOGY, not the artifact:
-- The reasoning behind the choices (why this type scale, why this palette works
-  for this kind of room, why motion was held back here)
-- What the user rejected along the way and why — the negative space is the most
-  reusable part
-- The anti-default list for this style: what the obvious move would have been,
-  and why it was wrong here
-- Where this style BREAKS DOWN — occasions it does not suit. A skill that cannot
-  state its own boundary is a template wearing a methodology costume, and it will
-  produce bad work the first time it is applied off-target.
-
-Do NOT paste HTML/CSS of the finished piece. Concrete values (a specific hex, a
-specific scale) belong in only as illustrations of the reasoning.
-
-The skill lands in the user's personal plugin dir and becomes available in NEW
-sessions across all their projects (plugin discovery happens at session start,
-so it does not apply to the current session).`,
-    {
-      name: z.string()
-        .describe('Skill id, kebab-case, 3-40 chars (e.g. "quiet-editorial-deck"). Becomes the plugin/skill name.'),
-      title: z.string().min(2).max(80)
-        .describe('Human-readable name of the style (e.g. "安静的编辑气质 · 长文型 deck")'),
-      description: z.string().min(20).max(600)
-        .describe('Frontmatter description — the routing signal. MUST say when to use it AND when not to.'),
-      body: z.string().min(200)
-        .describe('The methodology in markdown: reasoning, rejected alternatives, anti-default list, and where the style breaks down.'),
-      showcaseTitle: z.string().max(80).optional()
-        .describe('Title for the showcase card. Defaults to the style title.'),
-      showcaseNote: z.string().max(400).optional()
-        .describe('One line for the showcase card: what occasion this piece was for.'),
-      artifactPath: z.string().optional()
-        .describe('Work to show on the card, relative to workspace (e.g. "canvas.html" or "稿件/主稿.html"). Defaults to the active artifact.'),
-      overwrite: z.boolean().optional()
-        .describe('Replace an existing skill of the same name. Ask the user before setting this.'),
-    },
-    async ({ name, title, description, body, showcaseTitle, showcaseNote, artifactPath, overwrite }) => {
-      const fail = (text) => ({ content: [{ type: 'text', text }], isError: true });
-      try {
-        if (!NAME_RE.test(String(name || ''))) {
-          return fail(`Invalid skill name "${name}" — use kebab-case, 3-40 chars, e.g. "quiet-editorial-deck".`);
-        }
-        if (!projectId) return fail('No project bound; cannot resolve who owns this skill.');
-        const ownerId = getProject(projectId)?.ownerId || null;
-        const root = getUserPluginsRoot(ownerId);
-        if (!root) {
-          return fail('This project has no owner on record, so there is no personal skill library to write to.');
-        }
-
-        const md = composeSkillMd({ name, title, description, body });
-        const result = await installPluginToRoot(Buffer.from(md, 'utf8'), root, { force: !!overwrite });
-        if (result.status === 409) {
-          return fail(`A skill named "${name}" already exists in this user's library `
-            + `(${result.body.existing?.description || 'no description'}). `
-            + 'Ask the user whether to replace it, then call again with overwrite: true.');
-        }
-        if (result.status >= 400) {
-          const errs = (result.body.errors || []).join('; ') || result.body.error;
-          return fail(`Skill rejected by validator: ${errs}`);
-        }
-
-        // 橱窗条目：作品 + 它沉淀出来的 skill
-        // 橱窗条目指向的是**产物的相对路径**。扁平化前还要顺带记一个 taskId
-        // （产物住在哪个任务文件夹里），任务层没了之后这个字段永远是 null ——
-        // 留着列是因为 showcase 表里有存量数据，读的时候还认它。
-        const rel = String(artifactPath || getActiveArtifact(sessionId)?.path || '').replace(/\\/g, '/');
-        const artifactRel = rel || null;
-        let entry = null;
-        try {
-          entry = upsertEntry({
-            userId: ownerId,
-            projectId,
-            taskId: null,
-            artifactRel,
-            skillName: name,
-            title: (showcaseTitle || title).trim(),
-            note: showcaseNote?.trim() || null,
-          });
-        } catch (err) {
-          console.warn('[crystallize_skill] showcase entry failed:', err.message);
-        }
-
-        try {
-          ctx?.emit?.({
-            type: 'run.skill_crystallized',
-            skillName: name,
-            title: title.trim(),
-            showcaseId: entry?.id || null,
-          });
-        } catch { /* emit fail-safe */ }
-
-        const warn = (result.body.warnings || []).length
-          ? ` Warnings: ${result.body.warnings.join('; ')}.` : '';
-        return {
-          content: [{
-            type: 'text',
-            text: `Skill "${name}" saved to the user's personal library`
-              + `${artifactRel ? ` and the work added to their showcase` : ''}.`
-              + ` It becomes available in NEW sessions (not this one).${warn}`
-              + ` Tell the user plainly what you captured and what boundary you wrote,`
-              + ` so they can correct it while it is fresh.`,
-          }],
-        };
-      } catch (err) {
-        return fail(`crystallize_skill failed: ${err?.message || String(err)}`);
-      }
-    },
-  );
-}
+/**
+ * mcp/tools/crystallize-skill.js — crystallize_skill MCP tool
+ *
+ * 把一次真实探索的**结论**固化成用户自己的 skill，并把作品收进个人橱窗。
+ *
+ * 为什么不是"存模板"：模板是把成品存下来，换个主题就崩——真正能复用的是判断依据
+ * （为什么这个字号阶梯、为什么这个场合压住动效、哪些默认做法在这个气质里必须反掉）。
+ * 所以这个工具收的是方法论，不是 HTML。产物写进用户级 plugin 根
+ * （~/.nodesign/plugins/<userId>/<name>/），下次开新会话在**这个用户的所有项目**里
+ * 都能用（plugin 发现是 startup-time，当前会话不生效）。
+ *
+ * 跟 record_decision 的分工：决策贴是**这一件作品**的过程档案，随任务走；
+ * 这里是跨项目复用的方法论，随用户走。一个是日志，一个是沉淀。
+ *
+ * 归属：写到**项目 owner** 的目录，不是"当前请求者"——同一个项目谁跑都该产出同一
+ * 套资产。owner 查不到就报错，不往共享根写（那是刚修掉的跨用户污染路径）。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { getProject } from '../../../projects/store.js';
+import { getUserPluginsRoot } from '../../agent/plugin-loader.js';
+import { installPluginToRoot } from '../../../lib/plugin-install.js';
+import { upsertEntry } from '../../../lib/showcase-store.js';
+import { getActiveArtifact } from '../../../lib/artifact-target.js';
+import { Events } from '../../agent/events.js';
+
+const NAME_RE = /^[a-z0-9][a-z0-9-]{2,39}$/;
+
+function composeSkillMd({ name, title, description, body }) {
+  return [
+    '---',
+    `name: ${name}`,
+    `description: ${description.replace(/\n+/g, ' ').trim()}`,
+    'version: 0.1.0',
+    '---',
+    '',
+    `# ${title.trim()}`,
+    '',
+    body.trim(),
+    '',
+  ].join('\n');
+}
+
+/**
+ * @param {object} deps
+ * @param {string} [deps.projectId]
+ * @param {string} [deps.sessionId]
+ * @param {import('../../agent/context.js').AgentContext} [deps.ctx]
+ */
+export function makeCrystallizeSkillTool({ projectId, sessionId, ctx }) {
+  return tool(
+    'crystallize_skill',
+    `Distill a style/approach the user and you worked out together into a REUSABLE
+SKILL owned by this user, and put the finished work in their personal showcase.
+
+Call this ONLY when the user asks to keep a style, or explicitly confirms they
+want this approach reusable. Never call it unprompted — a skill the user did not
+ask for is clutter in every future session.
+
+What belongs in \`body\` is the METHODOLOGY, not the artifact:
+- The reasoning behind the choices (why this type scale, why this palette works
+  for this kind of room, why motion was held back here)
+- What the user rejected along the way and why — the negative space is the most
+  reusable part
+- The anti-default list for this style: what the obvious move would have been,
+  and why it was wrong here
+- Where this style BREAKS DOWN — occasions it does not suit. A skill that cannot
+  state its own boundary is a template wearing a methodology costume, and it will
+  produce bad work the first time it is applied off-target.
+
+Do NOT paste HTML/CSS of the finished piece. Concrete values (a specific hex, a
+specific scale) belong in only as illustrations of the reasoning.
+
+The skill lands in the user's personal plugin dir and becomes available in NEW
+sessions across all their projects (plugin discovery happens at session start,
+so it does not apply to the current session).`,
+    {
+      name: z.string()
+        .describe('Skill id, kebab-case, 3-40 chars (e.g. "quiet-editorial-deck"). Becomes the plugin/skill name.'),
+      title: z.string().min(2).max(80)
+        .describe('Human-readable name of the style (e.g. "安静的编辑气质 · 长文型 deck")'),
+      description: z.string().min(20).max(600)
+        .describe('Frontmatter description — the routing signal. MUST say when to use it AND when not to.'),
+      body: z.string().min(200)
+        .describe('The methodology in markdown: reasoning, rejected alternatives, anti-default list, and where the style breaks down.'),
+      showcaseTitle: z.string().max(80).optional()
+        .describe('Title for the showcase card. Defaults to the style title.'),
+      showcaseNote: z.string().max(400).optional()
+        .describe('One line for the showcase card: what occasion this piece was for.'),
+      artifactPath: z.string().optional()
+        .describe('Work to show on the card, relative to workspace (e.g. "canvas.html" or "稿件/主稿.html"). Defaults to the active artifact.'),
+      overwrite: z.boolean().optional()
+        .describe('Replace an existing skill of the same name. Ask the user before setting this.'),
+    },
+    async ({ name, title, description, body, showcaseTitle, showcaseNote, artifactPath, overwrite }) => {
+      const fail = (text) => ({ content: [{ type: 'text', text }], isError: true });
+      try {
+        if (!NAME_RE.test(String(name || ''))) {
+          return fail(`Invalid skill name "${name}" — use kebab-case, 3-40 chars, e.g. "quiet-editorial-deck".`);
+        }
+        if (!projectId) return fail('No project bound; cannot resolve who owns this skill.');
+        const ownerId = getProject(projectId)?.ownerId || null;
+        const root = getUserPluginsRoot(ownerId);
+        if (!root) {
+          return fail('This project has no owner on record, so there is no personal skill library to write to.');
+        }
+
+        const md = composeSkillMd({ name, title, description, body });
+        const result = await installPluginToRoot(Buffer.from(md, 'utf8'), root, { force: !!overwrite });
+        if (result.status === 409) {
+          return fail(`A skill named "${name}" already exists in this user's library `
+            + `(${result.body.existing?.description || 'no description'}). `
+            + 'Ask the user whether to replace it, then call again with overwrite: true.');
+        }
+        if (result.status >= 400) {
+          const errs = (result.body.errors || []).join('; ') || result.body.error;
+          return fail(`Skill rejected by validator: ${errs}`);
+        }
+
+        // 橱窗条目：作品 + 它沉淀出来的 skill
+        // 橱窗条目指向的是**产物的相对路径**。扁平化前还要顺带记一个 taskId
+        // （产物住在哪个任务文件夹里），任务层没了之后这个字段永远是 null ——
+        // 留着列是因为 showcase 表里有存量数据，读的时候还认它。
+        const rel = String(artifactPath || getActiveArtifact(sessionId)?.path || '').replace(/\\/g, '/');
+        const artifactRel = rel || null;
+        let entry = null;
+        try {
+          entry = upsertEntry({
+            userId: ownerId,
+            projectId,
+            taskId: null,
+            artifactRel,
+            skillName: name,
+            title: (showcaseTitle || title).trim(),
+            note: showcaseNote?.trim() || null,
+          });
+        } catch (err) {
+          console.warn('[crystallize_skill] showcase entry failed:', err.message);
+        }
+
+        try {
+          ctx?.emit?.({
+            type: 'run.skill_crystallized',
+            skillName: name,
+            title: title.trim(),
+            showcaseId: entry?.id || null,
+          });
+        } catch { /* emit fail-safe */ }
+
+        const warn = (result.body.warnings || []).length
+          ? ` Warnings: ${result.body.warnings.join('; ')}.` : '';
+        return {
+          content: [{
+            type: 'text',
+            text: `Skill "${name}" saved to the user's personal library`
+              + `${artifactRel ? ` and the work added to their showcase` : ''}.`
+              + ` It becomes available in NEW sessions (not this one).${warn}`
+              + ` Tell the user plainly what you captured and what boundary you wrote,`
+              + ` so they can correct it while it is fresh.`,
+          }],
+        };
+      } catch (err) {
+        return fail(`crystallize_skill failed: ${err?.message || String(err)}`);
+      }
+    },
+  );
+}

package/server/engine/mcp/tools/edit-sketch.js

@@ -0,0 +1,167 @@
+/**
+ * mcp/tools/edit-sketch.js —— edit_sketch（2026-08-23 黑板二期）
+ *
+ * 改已有的图，不重画。原则抄用户自己的 AI-Annotation-demo 里那条「引用，不吐坐标」：
+ * agent 只引用画布 id，位置用**相对关系**表达（在某件东西的右边/下面/上面/左边、
+ * 或网格位移），像素由服务端解析 —— 让模型吐绝对坐标必幻觉。
+ *
+ * 一次调用一批操作（按序执行，一条坏了其余照做并在返回里报）：
+ *   set_text   改字（文字节点：内容/格式/字号/颜色）
+ *   move       挪一件：to {ref, side, gap?} 或 {dx, dy}（网格单位）
+ *   move_group 挪一组（同 tag 的全部，保持相对位置）：to 同上
+ *   remove     删一件画布原生物件（text/scribble）；产物卡不删（只能摘标签）
+ *   add_node   加一个文字节点，位置 at {ref, side, gap?}，归进 tag
+ *   add_edge / set_edge / remove_edge   线的增改删（线 id 见 read_board）
+ * 改完前端按 board.updated 整份重拉；默认不进 staging（改的是已落定的图）。
+ */
+
+import { tool } from '@anthropic-ai/claude-agent-sdk';
+import { z } from 'zod';
+import { readBoard, patchBoard, TEXT_FONTS } from '../../../projects/board-store.js';
+import { estimateSizeOn } from '../../../lib/board-kind-sizes.js';
+import { layerOf, normalizeCanvasId } from '../../../lib/canvas-id.js';
+import { BINDING_TYPE_IDS, BINDING_MATERIALS } from '../../../lib/binding-types.js';
+import { UNIT, textBox } from '../../../lib/sketch-layout.js';
+
+const MAX_OPS = 40;
+let seq = 0;
+const stamp = () => `${Date.now().toString(36)}${(seq++ % 1000).toString(36)}`;
+
+const REL = z.object({
+  ref: z.string().min(1).max(300).describe('canvas id to place relative to'),
+  side: z.enum(['right', 'left', 'above', 'below']),
+  gap: z.number().min(0).max(40).optional().describe('grid units (default 1)'),
+});
+const DELTA = z.object({ dx: z.number().min(-200).max(200), dy: z.number().min(-200).max(200) }).describe('grid units');
+const TO = z.union([REL, DELTA]);
+
+const OP = z.discriminatedUnion('op', [
+  z.object({ op: z.literal('set_text'), id: z.string().min(1).max(300), text: z.string().min(1).max(4000).optional(), format: z.enum(['plain', 'md']).optional(), size: z.enum(['sm', 'md', 'lg', 'xl']).optional(), color: z.enum(['ink', 'red', 'pencil', 'brass']).optional(), font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional() }),
+  z.object({ op: z.literal('move'), id: z.string().min(1).max(300), to: TO }),
+  z.object({ op: z.literal('move_group'), tag: z.string().min(1).max(40), to: TO }),
+  z.object({ op: z.literal('remove'), id: z.string().min(1).max(300) }),
+  z.object({ op: z.literal('add_node'), id: z.string().regex(/^[A-Za-z0-9_-]{1,24}$/).optional().describe('local handle to reference in later ops of this call'), text: z.string().min(1).max(4000), format: z.enum(['plain', 'md']).optional(), size: z.enum(['sm', 'md', 'lg', 'xl']).optional(), font: z.enum(['pen', 'kai', 'sans', 'serif', 'mono']).optional(), color: z.enum(['ink', 'red', 'pencil', 'brass']).optional(), at: REL, tag: z.string().max(40).optional() }),
+  z.object({ op: z.literal('add_edge'), from: z.string().min(1).max(300), to: z.string().min(1).max(300), type: z.enum(BINDING_TYPE_IDS).optional(), material: z.enum(BINDING_MATERIALS).optional(), label: z.string().max(60).optional(), tag: z.string().max(40).optional() }),
+  z.object({ op: z.literal('set_edge'), id: z.string().min(1).max(300), label: z.string().max(60).optional(), type: z.enum(BINDING_TYPE_IDS).optional(), material: z.enum(BINDING_MATERIALS).optional() }),
+  z.object({ op: z.literal('remove_edge'), id: z.string().min(1).max(300) }),
+]);
+
+export function makeEditSketchTool({ projectId, ctx }) {
+  return tool(
+    'edit_sketch',
+    `Edit what is already on the board — by id, without redrawing. Positions are RELATIVE
+(to {ref, side, gap} = beside/above/below another canvas id) or grid deltas ({dx,dy},
+1 cell = ${UNIT}px); you never give absolute coordinates. ids come from read_board
+(nodes: text:…/scribble:…, cards: deck:…/site:…/paths; lines: b:…).
+ops (run in order; a failing op is reported, the rest still apply):
+ set_text{id,text?,format?,size?,color?,font?} · move{id,to} · move_group{tag,to} ·
+ remove{id} · add_node{id?,text,at:{ref,side,gap?},…} · add_edge{from,to,type?,material?,label?} ·
+ set_edge{id,label?,type?,material?} · remove_edge{id}
+Use this for "move A under B", "rephrase that note", "add a branch", "delete the
+wrong line". For a brand-new diagram use sketch_on_board.`,
+    {
+      tag: z.string().max(40).optional().describe('Default tag for add_node/add_edge (the sketch you are editing)'),
+      ops: z.array(OP).min(1).max(MAX_OPS),
+    },
+    async ({ tag: defaultTag, ops }) => {
+      const err = (t) => ({ content: [{ type: 'text', text: t }], isError: true });
+      if (!projectId) return err('No project bound.');
+      const board = await readBoard(projectId);
+      const known = new Set(Object.keys(board.zones || {}));
+      const objects = {}; const bindings = {};      // 增量 patch
+      const live = { ...board.objects };             // 本次调用内的"当前态"（让后一条 op 看见前一条的结果）
+      const local = new Map();                       // add_node 的本地句柄 → canvas id
+      const rid = (raw) => { if (local.has(raw)) return local.get(raw); const c = normalizeCanvasId(raw); return c && live[c] ? c : null; };
+      const rectOf = (id) => { const e = live[id]; return e ? { x: e.x, y: e.y, ...estimateSizeOn(board, id, e) } : null; };
+      const placeRel = (box, rel) => {
+        const r = rectOf(rid(rel.ref));
+        if (!r) return null;
+        const g = (rel.gap ?? 1) * UNIT;
+        if (rel.side === 'right') return { x: r.x + r.w + g, y: r.y };
+        if (rel.side === 'left') return { x: r.x - g - box.w, y: r.y };
+        if (rel.side === 'below') return { x: r.x, y: r.y + r.h + g };
+        return { x: r.x, y: r.y - g - box.h };
+      };
+      const report = []; let ok = 0;
+      const setObj = (id, e) => { live[id] = e; objects[id] = e; };
+
+      for (let i = 0; i < ops.length; i += 1) {
+        const o = ops[i];
+        const fail = (why) => report.push(`✗ #${i + 1} ${o.op}: ${why}`);
+        try {
+          if (o.op === 'set_text') {
+            const id = rid(o.id); const e = id && live[id];
+            if (!e || e.kind !== 'text') { fail(`${o.id} 不是文字节点`); continue; }
+            const data = { ...e.data };
+            if (o.text) data.t = o.text;
+            if (o.format) { if (o.format === 'md') data.format = 'md'; else delete data.format; }
+            if (o.size) data.size = o.size; if (o.color) data.color = o.color; if (o.font && TEXT_FONTS.includes(o.font)) data.font = o.font;
+            const box = textBox(data.t, data.size || 'md', { md: data.format === 'md' });
+            setObj(id, { ...e, data, w: box.w, h: box.h }); ok += 1;
+          } else if (o.op === 'move') {
+            const id = rid(o.id); const e = id && live[id];
+            if (!e) { fail(`${o.id} 不在板上`); continue; }
+            const box = rectOf(id);
+            const p = 'ref' in o.to ? placeRel(box, o.to) : { x: e.x + o.to.dx * UNIT, y: e.y + o.to.dy * UNIT };
+            if (!p) { fail(`参照 ${o.to.ref} 不在板上`); continue; }
+            setObj(id, { ...e, x: Math.round(p.x), y: Math.round(p.y) }); ok += 1;
+          } else if (o.op === 'move_group') {
+            const members = Object.entries(live).filter(([, e]) => e.tag === o.tag && Number.isFinite(e?.x));
+            if (!members.length) { fail(`没有 #${o.tag} 的东西`); continue; }
+            const bb = { x: Math.min(...members.map(([, e]) => e.x)), y: Math.min(...members.map(([, e]) => e.y)) };
+            const rects = members.map(([id]) => rectOf(id));
+            const w = Math.max(...rects.map(r => r.x + r.w)) - bb.x; const h = Math.max(...rects.map(r => r.y + r.h)) - bb.y;
+            const p = 'ref' in o.to ? placeRel({ w, h }, o.to) : { x: bb.x + o.to.dx * UNIT, y: bb.y + o.to.dy * UNIT };
+            if (!p) { fail(`参照 ${o.to.ref} 不在板上`); continue; }
+            const dx = Math.round(p.x - bb.x); const dy = Math.round(p.y - bb.y);
+            for (const [id, e] of members) setObj(id, { ...e, x: e.x + dx, y: e.y + dy });
+            ok += 1;
+          } else if (o.op === 'remove') {
+            const id = rid(o.id); const e = id && live[id];
+            if (!e) { fail(`${o.id} 不在板上`); continue; }
+            if (!e.kind) { fail(`${id} 是产物卡，不能从黑板删；要摘标签用 finish_sketch erase`); continue; }
+            delete live[id]; objects[id] = null; ok += 1;
+          } else if (o.op === 'add_node') {
+            const size = (o.size === 'sm' && o.text.length > 40) ? 'md' : (o.size || 'md');
+            const box = textBox(o.text, size, { md: o.format === 'md' });
+            const p = placeRel(box, o.at);
+            if (!p) { fail(`参照 ${o.at.ref} 不在板上`); continue; }
+            const refId = rid(o.at.ref);
+            const zone = layerOf(refId, live[refId], known);
+            const id = `text:a${stamp()}`;
+            const tag = o.tag || defaultTag || live[refId]?.tag || null;
+            setObj(id, {
+              x: Math.round(p.x), y: Math.round(p.y), z: 1, w: box.w, h: box.h, kind: 'text',
+              data: { t: o.text, ...(o.format === 'md' ? { format: 'md' } : {}), font: TEXT_FONTS.includes(o.font) ? o.font : 'pen', size, color: o.color || 'ink' },
+              zone, by: 'agent', ...(tag ? { tag } : {}),
+            });
+            if (o.id) local.set(o.id, id);
+            report.push(`+ node ${o.id ? `${o.id}=` : ''}${id}`); ok += 1;
+          } else if (o.op === 'add_edge') {
+            const from = rid(o.from); const to = rid(o.to);
+            if (!from || !to || from === to) { fail(`端点不在板上：${o.from} → ${o.to}`); continue; }
+            const id = `b:a${stamp()}`;
+            const tag = o.tag || defaultTag || live[from]?.tag || live[to]?.tag || null;
+            bindings[id] = { type: o.type || 'link', from, to, by: 'agent', ...(o.material && o.material !== 'ink' ? { material: o.material } : {}), ...(o.label ? { label: o.label } : {}), ...(tag ? { tag } : {}) };
+            report.push(`+ edge ${id}`); ok += 1;
+          } else if (o.op === 'set_edge') {
+            const b = board.bindings?.[o.id];
+            if (!b) { fail(`线 ${o.id} 不存在`); continue; }
+            const nb = { ...b };
+            if (o.label !== undefined) { if (o.label) nb.label = o.label; else delete nb.label; }
+            if (o.type) nb.type = o.type;
+            if (o.material) { if (o.material === 'ink') delete nb.material; else nb.material = o.material; }
+            bindings[o.id] = nb; ok += 1;
+          } else if (o.op === 'remove_edge') {
+            if (!board.bindings?.[o.id]) { fail(`线 ${o.id} 不存在`); continue; }
+            bindings[o.id] = null; ok += 1;
+          }
+        } catch (e) { fail(String(e?.message || e).slice(0, 120)); }
+      }
+      if (!ok) return err(`没有一条操作成功：\n${report.join('\n')}`);
+      await patchBoard(projectId, { objects, bindings });
+      try { ctx?.emit?.({ type: 'board.updated', sessionId: null, summary: `改了黑板（${ok} 处）` }); } catch { /* */ }
+      return { content: [{ type: 'text', text: `Applied ${ok}/${ops.length} op(s).${report.length ? `\n${report.join('\n')}` : ''}` }] };
+    },
+  );
+}