@xiaohhhh1/canvas-agent 0.2.2 → 0.3.0

package/dist/{schemas.js → canvas/schemas.js}

@@ -4,6 +4,7 @@ const positionSchema = z.object({ x: z.number(), y: z.number() });
 const viewportSchema = z.object({ x: z.number(), y: z.number(), k: z.number() });
 const nodeTypeSchema = z.enum(["image", "text", "config", "video", "audio"]);
 const generationModeSchema = z.enum(["text", "image", "video", "audio"]);
+/** Canvas Agent 对外提供的工具名称。 */
 export const toolNames = [
     "site_navigate",
     "canvas_list_projects",

package/dist/{canvas-session.d.ts → canvas/session.d.ts}

@@ -1,5 +1,5 @@
 import type { ServerResponse } from "node:http";
-import type { AgentAttachment } from "./types.js";
+import type { AgentAttachment } from "../agent/types.js";
 type TurnAttachment = {
     clientId: string;
     id: string;
@@ -15,6 +15,7 @@ export type CodexState = {
     threadId: string;
     turnId: string;
 };
+/** 管理网页画布连接、状态、附件和工具请求。 */
 export declare class CanvasSession {
     private clients;
     private clientFocusOrder;
@@ -25,21 +26,32 @@ export declare class CanvasSession {
     private boundClientId;
     private focusSequence;
     private codexState;
+    /** 获取当前目标网页的画布状态。 */
     private get canvasState();
+    /** 获取当前 turn 绑定或最近激活的网页客户端。 */
     private get targetClientId();
+    /** 返回 Canvas Agent 当前连接状态。 */
     health(): {
         ok: boolean;
         hasCanvas: boolean;
         clients: number;
         codexBusy: boolean;
     };
+    /** 返回 Codex 是否正在执行任务。 */
     get codexBusy(): boolean;
+    /** 更新并广播 Codex 运行状态。 */
     setCodexState(patch: Partial<CodexState>): void;
+    /** 建立网页与 Canvas Agent 之间的 SSE 连接。 */
     openEvents(url: URL, res: ServerResponse): void;
+    /** 保存指定网页上报的最新画布快照。 */
     updateState(body: unknown, clientId?: string): void;
+    /** 将指定网页设为最近激活的工具目标。 */
     activateClient(clientId: string): void;
+    /** 将当前 Agent turn 固定绑定到指定网页。 */
     bindClient(clientId: string): void;
+    /** 解除当前 Agent turn 的网页绑定。 */
     releaseClient(clientId: string): void;
+    /** 保存当前 turn 可用的图片附件并返回安全引用。 */
     setTurnAttachments(clientId: string, attachments: AgentAttachment[]): {
         id: string;
         name: string;
@@ -48,17 +60,25 @@ export declare class CanvasSession {
         width: number;
         height: number;
     }[];
+    /** 清理指定网页或全部 turn 附件。 */
     clearTurnAttachments(clientId?: string): void;
+    /** 获取属于指定网页 turn 的图片附件。 */
     getTurnAttachment(clientId: string, attachmentId: string): TurnAttachment;
+    /** 接收网页返回的工具调用结果。 */
     resolveResult(clientId: string, body: {
         requestId?: string;
         error?: string;
         result?: unknown;
     }): boolean;
+    /** 向全部已连接网页广播事件。 */
     emitAll(type: string, payload: unknown): void;
+    /** 向全部网页广播带线程归属的事件。 */
     emitThread(type: string, threadId: string, payload?: Record<string, unknown>): void;
+    /** 校验工具参数并将调用分派到当前目标网页。 */
     callTool(name: unknown, rawInput: unknown): Promise<unknown>;
+    /** 将当前 turn 的附件转换为画布图片节点。 */
     private createAttachmentNodes;
+    /** 向目标网页发送工具请求并等待调用结果。 */
     private requestCanvasTool;
 }
 export {};

package/dist/canvas/session.js

@@ -0,0 +1,256 @@
+import crypto from "node:crypto";
+import { logger } from "../utils/logger.js";
+import { buildCanvasToolRequest, fitAttachmentNodeSize } from "./operations.js";
+import { compactCanvasState, compactNode, isToolName, nextCanvasX, parseToolInput } from "./tools.js";
+const SITE_TOOLS = new Set([
+    "site_navigate",
+    "canvas_list_projects",
+    "workbench_image_get_config",
+    "workbench_image_generate",
+    "workbench_video_get_config",
+    "workbench_video_generate",
+    "prompts_search",
+    "assets_list",
+    "assets_add",
+    "generation_get_status",
+]);
+/** 管理网页画布连接、状态、附件和工具请求。 */
+export class CanvasSession {
+    clients = new Map();
+    clientFocusOrder = new Map();
+    pending = new Map();
+    canvasStates = new Map();
+    turnAttachments = new Map();
+    activeClientId = "";
+    boundClientId = "";
+    focusSequence = 0;
+    codexState = { busy: false, threadId: "", turnId: "" };
+    /** 获取当前目标网页的画布状态。 */
+    get canvasState() {
+        return this.canvasStates.get(this.targetClientId) || null;
+    }
+    /** 获取当前 turn 绑定或最近激活的网页客户端。 */
+    get targetClientId() {
+        return this.boundClientId || this.activeClientId;
+    }
+    /** 返回 Canvas Agent 当前连接状态。 */
+    health() {
+        return { ok: true, hasCanvas: Boolean(this.canvasState), clients: this.clients.size, codexBusy: this.codexState.busy };
+    }
+    /** 返回 Codex 是否正在执行任务。 */
+    get codexBusy() {
+        return this.codexState.busy;
+    }
+    /** 更新并广播 Codex 运行状态。 */
+    setCodexState(patch) {
+        const next = { ...this.codexState, ...patch };
+        if (next.busy === this.codexState.busy && next.threadId === this.codexState.threadId && next.turnId === this.codexState.turnId)
+            return;
+        this.codexState = next;
+        logger.debug("Codex state changed", this.codexState);
+        this.emitAll("codex_state", this.codexState);
+    }
+    /** 建立网页与 Canvas Agent 之间的 SSE 连接。 */
+    openEvents(url, res) {
+        const clientId = url.searchParams.get("clientId") || crypto.randomUUID();
+        const statusOnly = url.searchParams.get("role") === "status";
+        logger.info("SSE client connected", { clientId, statusOnly });
+        res.writeHead(200, { "Content-Type": "text/event-stream", "Cache-Control": "no-cache", Connection: "keep-alive" });
+        if (!statusOnly) {
+            this.clients.set(clientId, res);
+            if (!this.clientFocusOrder.has(clientId))
+                this.clientFocusOrder.set(clientId, 0);
+            if (!this.activeClientId) {
+                this.activeClientId = clientId;
+                this.clientFocusOrder.set(clientId, ++this.focusSequence);
+            }
+        }
+        sendEvent(res, "hello", { ok: true, clientId, codex: this.codexState });
+        const timer = setInterval(() => sendEvent(res, "ping", { time: Date.now() }), 15000);
+        res.on("close", () => {
+            clearInterval(timer);
+            logger.info("SSE client disconnected", { clientId, statusOnly });
+            if (statusOnly || this.clients.get(clientId) !== res)
+                return;
+            this.clients.delete(clientId);
+            this.clientFocusOrder.delete(clientId);
+            this.canvasStates.delete(clientId);
+            if (this.boundClientId === clientId)
+                this.boundClientId = "";
+            this.pending.forEach((item, requestId) => {
+                if (item.clientId !== clientId)
+                    return;
+                this.pending.delete(requestId);
+                item.reject(new Error("请求页面已断开"));
+            });
+            if (this.activeClientId === clientId)
+                this.activeClientId = [...this.clients.keys()].sort((a, b) => (this.clientFocusOrder.get(b) || 0) - (this.clientFocusOrder.get(a) || 0))[0] || "";
+        });
+    }
+    /** 保存指定网页上报的最新画布快照。 */
+    updateState(body, clientId) {
+        const targetClientId = clientId || this.activeClientId;
+        if (!targetClientId)
+            return;
+        const state = { ...(body && typeof body === "object" && !Array.isArray(body) ? body : {}), clientId: targetClientId };
+        this.canvasStates.set(targetClientId, state);
+        logger.debug("Canvas state updated", { clientId: targetClientId, nodes: state.nodes?.length || 0, connections: state.connections?.length || 0 });
+    }
+    /** 将指定网页设为最近激活的工具目标。 */
+    activateClient(clientId) {
+        if (!this.clients.has(clientId))
+            throw new Error("当前网页未连接");
+        this.activeClientId = clientId;
+        this.clientFocusOrder.set(clientId, ++this.focusSequence);
+        logger.debug("Canvas client activated", { clientId });
+    }
+    /** 将当前 Agent turn 固定绑定到指定网页。 */
+    bindClient(clientId) {
+        if (!this.clients.has(clientId))
+            throw new Error("当前网页未连接");
+        this.boundClientId = clientId;
+        logger.debug("Canvas client bound to turn", { clientId });
+    }
+    /** 解除当前 Agent turn 的网页绑定。 */
+    releaseClient(clientId) {
+        if (this.boundClientId === clientId)
+            this.boundClientId = "";
+        logger.debug("Canvas client released from turn", { clientId });
+    }
+    /** 保存当前 turn 可用的图片附件并返回安全引用。 */
+    setTurnAttachments(clientId, attachments) {
+        this.turnAttachments.clear();
+        return attachments.flatMap((item, index) => {
+            if (!item.dataUrl?.startsWith("data:image/"))
+                return [];
+            const id = item.id?.trim() || `attachment-${crypto.randomUUID()}`;
+            const attachment = {
+                clientId,
+                id,
+                name: item.name?.trim() || `图片 ${index + 1}`,
+                type: item.type?.startsWith("image/") ? item.type : item.dataUrl.match(/^data:([^;]+)/)?.[1] || "image/png",
+                size: positiveNumber(item.size, 0),
+                width: positiveNumber(item.width, 1024),
+                height: positiveNumber(item.height, 1024),
+                dataUrl: item.dataUrl,
+            };
+            this.turnAttachments.set(id, attachment);
+            return [{ id, name: attachment.name, type: attachment.type, size: attachment.size, width: attachment.width, height: attachment.height }];
+        });
+    }
+    /** 清理指定网页或全部 turn 附件。 */
+    clearTurnAttachments(clientId) {
+        this.turnAttachments.forEach((item, id) => {
+            if (!clientId || item.clientId === clientId)
+                this.turnAttachments.delete(id);
+        });
+    }
+    /** 获取属于指定网页 turn 的图片附件。 */
+    getTurnAttachment(clientId, attachmentId) {
+        const attachment = this.turnAttachments.get(attachmentId);
+        if (!attachment)
+            throw new Error(`找不到本轮图片附件：${attachmentId}`);
+        if (attachment.clientId !== clientId)
+            throw new Error("图片附件不属于当前 turn 的发起标签页");
+        return attachment;
+    }
+    /** 接收网页返回的工具调用结果。 */
+    resolveResult(clientId, body) {
+        const item = body.requestId ? this.pending.get(body.requestId) : null;
+        if (!item || !body.requestId || item.clientId !== clientId)
+            return false;
+        this.pending.delete(body.requestId);
+        logger.debug("Canvas tool result received", { clientId, requestId: body.requestId, error: body.error, result: body.result });
+        body.error ? item.reject(new Error(body.error)) : item.resolve(body.result);
+        return true;
+    }
+    /** 向全部已连接网页广播事件。 */
+    emitAll(type, payload) {
+        this.clients.forEach((client) => sendEvent(client, type, payload));
+    }
+    /** 向全部网页广播带线程归属的事件。 */
+    emitThread(type, threadId, payload = {}) {
+        this.emitAll(type, { ...payload, threadId });
+    }
+    /** 校验工具参数并将调用分派到当前目标网页。 */
+    async callTool(name, rawInput) {
+        if (!isToolName(name))
+            throw new Error(`未知工具：${String(name)}`);
+        logger.info("MCP tool called", { name, input: rawInput, targetClientId: this.targetClientId });
+        const input = parseToolInput(name, rawInput);
+        if (SITE_TOOLS.has(name)) {
+            if (!this.clients.size)
+                throw new Error("当前没有已连接网页");
+            return await this.requestCanvasTool(name, input);
+        }
+        const readTool = ["canvas_get_state", "canvas_get_selection", "canvas_export_snapshot"].includes(name);
+        if (readTool && (!this.clients.size || !this.canvasState))
+            throw new Error("当前没有已连接画布");
+        if (name === "canvas_get_state" || name === "canvas_export_snapshot")
+            return compactCanvasState(this.canvasState);
+        if (name === "canvas_get_selection") {
+            const ids = new Set(this.canvasState?.selectedNodeIds || []);
+            return { nodes: (this.canvasState?.nodes || []).filter((node) => ids.has(node.id)).map(compactNode) };
+        }
+        if (name === "canvas_create_attachment_nodes")
+            return await this.createAttachmentNodes(input);
+        if (!this.clients.size)
+            throw new Error("当前没有已连接画布");
+        const request = buildCanvasToolRequest(name, input, this.canvasState);
+        return await this.requestCanvasTool(request.name, request.input);
+    }
+    /** 将当前 turn 的附件转换为画布图片节点。 */
+    async createAttachmentNodes(input) {
+        const clientId = this.targetClientId;
+        if (!this.clients.has(clientId))
+            throw new Error("当前没有已连接画布");
+        const attachments = input.attachmentIds.map((id) => this.getTurnAttachment(clientId, id));
+        const x = Number(input.x ?? nextCanvasX(this.canvasState));
+        const y = Number(input.y ?? 0);
+        const gap = Number(input.gap ?? 40);
+        const direction = input.direction || "row";
+        let offset = 0;
+        const nodes = attachments.map((attachment) => {
+            const size = fitAttachmentNodeSize(attachment.width, attachment.height);
+            const node = {
+                id: `image-${crypto.randomUUID()}`,
+                attachmentId: attachment.id,
+                title: attachment.name,
+                position: { x: direction === "row" ? x + offset : x, y: direction === "column" ? y + offset : y },
+                width: size.width,
+                height: size.height,
+            };
+            offset += (direction === "row" ? size.width : size.height) + gap;
+            return node;
+        });
+        await this.requestCanvasTool("canvas_create_attachment_nodes", { nodes });
+        return { nodes: nodes.map(({ id, attachmentId, title }) => ({ id, attachmentId, title })) };
+    }
+    /** 向目标网页发送工具请求并等待调用结果。 */
+    async requestCanvasTool(name, input) {
+        const requestId = crypto.randomUUID();
+        const clientId = this.targetClientId;
+        const client = this.clients.get(clientId);
+        if (!client)
+            throw new Error("当前没有已连接画布");
+        sendEvent(client, "tool_call", { requestId, name, input });
+        logger.debug("Canvas tool request sent", { requestId, name, input, clientId });
+        return await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(requestId);
+                logger.warn("Canvas tool request timed out", { requestId, name, clientId });
+                reject(new Error("画布操作超时"));
+            }, 30000);
+            this.pending.set(requestId, { clientId, resolve: (value) => (clearTimeout(timer), resolve(value)), reject: (error) => (clearTimeout(timer), reject(error)) });
+        });
+    }
+}
+/** 向 SSE 连接写入一个事件。 */
+function sendEvent(res, type, payload) {
+    res.write(`event: ${type}\ndata: ${JSON.stringify(payload)}\n\n`);
+}
+/** 将未知数值转换为正数，否则使用默认值。 */
+function positiveNumber(value, fallback) {
+    const number = Number(value);
+    return Number.isFinite(number) && number > 0 ? number : fallback;
+}

package/dist/{tools.d.ts → canvas/tools.d.ts}

@@ -1,6 +1,8 @@
 import { type ToolName } from "./schemas.js";
 import type { CanvasNode, CanvasSnapshot } from "./types.js";
+/** 判断传入名称是否为已注册的画布工具。 */
 export declare function isToolName(name: unknown): name is ToolName;
+/** 按工具名称校验并解析调用参数。 */
 export declare function parseToolInput(name: ToolName, input: unknown): {
     path: string;
 } | {
@@ -74,10 +76,10 @@ export declare function parseToolInput(name: ToolName, input: unknown): {
         prompt: import("zod").ZodOptional<import("zod").ZodString>;
     }, import("zod").ZodTypeAny, "passthrough">)[];
 } | {
-    nodeType: "image" | "text" | "config" | "video" | "audio";
+    nodeType: "text" | "image" | "config" | "video" | "audio";
+    title?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
-    title?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
     metadata?: Record<string, unknown> | undefined;
@@ -89,17 +91,17 @@ export declare function parseToolInput(name: ToolName, input: unknown): {
     direction?: "row" | "column" | undefined;
 } | {
     text?: string | undefined;
+    title?: string | undefined;
     x?: number | undefined;
     y?: number | undefined;
-    title?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
 } | {
     items: {
         text: string;
+        title?: string | undefined;
         x?: number | undefined;
         y?: number | undefined;
-        title?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
     }[];
@@ -145,19 +147,19 @@ export declare function parseToolInput(name: ToolName, input: unknown): {
     };
 } | {
     nodeId: string;
-    mode?: "image" | "text" | "video" | "audio" | undefined;
+    mode?: "text" | "image" | "video" | "audio" | undefined;
     prompt?: string | undefined;
 } | {
-    limit?: number | undefined;
     nodeIds?: string[] | undefined;
     scope?: "image" | "video" | "all" | "canvas" | undefined;
     taskId?: string | undefined;
+    limit?: number | undefined;
 } | {
     prompt: string;
+    count?: number | undefined;
     model?: string | undefined;
     size?: string | undefined;
     quality?: string | undefined;
-    count?: number | undefined;
     run?: boolean | undefined;
 } | {
     prompt: string;
@@ -170,13 +172,14 @@ export declare function parseToolInput(name: ToolName, input: unknown): {
     resolution?: string | undefined;
 } | {
     title: string;
-    kind: "image" | "text";
+    kind: "text" | "image";
     source?: string | undefined;
     content?: string | undefined;
     tags?: string[] | undefined;
     imageUrl?: string | undefined;
     note?: string | undefined;
 };
+/** 压缩画布快照，避免向 Agent 返回过长的节点内容。 */
 export declare function compactCanvasState(state: CanvasSnapshot | null): {
     nodes: {
         id: string;
@@ -196,6 +199,7 @@ export declare function compactCanvasState(state: CanvasSnapshot | null): {
     viewport?: import("./types.js").Viewport;
     clientId?: string;
 };
+/** 压缩单个画布节点的元数据内容。 */
 export declare function compactNode(node: CanvasNode): {
     id: string;
     type: import("./types.js").CanvasNodeType;
@@ -207,4 +211,5 @@ export declare function compactNode(node: CanvasNode): {
         [x: string]: unknown;
     };
 };
+/** 计算新节点在当前画布右侧的默认横坐标。 */
 export declare function nextCanvasX(state: CanvasSnapshot | null): number;

package/dist/{tools.js → canvas/tools.js}

@@ -1,21 +1,26 @@
 import { toolInputSchemas, toolNames } from "./schemas.js";
+/** 判断传入名称是否为已注册的画布工具。 */
 export function isToolName(name) {
     return typeof name === "string" && toolNames.includes(name);
 }
+/** 按工具名称校验并解析调用参数。 */
 export function parseToolInput(name, input) {
     return toolInputSchemas[name].parse(input ?? {});
 }
+/** 压缩画布快照，避免向 Agent 返回过长的节点内容。 */
 export function compactCanvasState(state) {
     if (!state)
         throw new Error("当前没有已连接画布");
     return { ...state, nodes: (state.nodes || []).map(compactNode) };
 }
+/** 压缩单个画布节点的元数据内容。 */
 export function compactNode(node) {
     const metadata = { ...(node.metadata || {}) };
     if (typeof metadata.content === "string" && metadata.content.length > 240)
         metadata.content = `${metadata.content.slice(0, 120)}...`;
     return { id: node.id, type: node.type, title: node.title, position: node.position, width: node.width, height: node.height, metadata };
 }
+/** 计算新节点在当前画布右侧的默认横坐标。 */
 export function nextCanvasX(state) {
     const nodes = state?.nodes || [];
     return nodes.length ? Math.max(...nodes.map((node) => node.position.x + node.width)) + 80 : 0;

package/dist/{types.d.ts → canvas/types.d.ts}

@@ -1,3 +1,4 @@
+/** 画布坐标。 */
 export type Position = {
     x: number;
     y: number;
@@ -31,13 +32,3 @@ export type CanvasSnapshot = {
     viewport?: Viewport;
     clientId?: string;
 };
-export type AgentEmit = (type: string, payload: unknown) => void;
-export type AgentAttachment = {
-    id?: string;
-    name?: string;
-    type?: string;
-    size?: number;
-    width?: number;
-    height?: number;
-    dataUrl?: string;
-};

package/dist/canvas/types.js

@@ -0,0 +1 @@
+export {};

package/dist/config.d.ts

@@ -2,7 +2,7 @@ export declare const DEFAULT_PORT = 17371;
 export declare const CONFIG_DIR: string;
 export declare const CONFIG_FILE: string;
 export declare const VERSION: string;
-export declare const AGENT_PROMPT = "\u4F60\u6B63\u5728\u5E2E\u52A9\u7528\u6237\u64CD\u4F5C Infinite Canvas \u7F51\u7AD9\u3002\u5207\u6362\u7F51\u7AD9\u9875\u9762\u7528 site_navigate\uFF0C\u53EF\u8DF3 / (\u9996\u9875)\u3001/canvas (\u6211\u7684\u753B\u5E03)\u3001/canvas/:id (\u6307\u5B9A\u753B\u5E03)\u3001/image\u3001/video\u3001/prompts\u3001/assets\u3001/config\u3002\u9700\u8981\u6539\u52A8\u753B\u5E03\u65F6\u4F18\u5148\u4F7F\u7528\u5DF2\u914D\u7F6E\u7684 infinite-canvas MCP \u5DE5\u5177\uFF1A\u5148 canvas_get_state \u8BFB\u53D6\u5F53\u524D\u753B\u5E03\uFF0C\u518D\u6839\u636E\u4EFB\u52A1\u4F7F\u7528 canvas_create_text_node\u3001canvas_generate_text\u3001canvas_generate_image\u3001canvas_generate_video\u3001canvas_generate_audio\u3001canvas_create_generation_flow\u3001canvas_create_config_node\u3001canvas_run_generation\u3001canvas_update_node\u3001canvas_connect_nodes \u7B49\u901A\u7528\u5DE5\u5177\uFF1B\u590D\u6742\u6279\u91CF\u6539\u52A8\u518D\u7528 canvas_apply_ops\uFF0C\u5220\u9664\u8FDE\u7EBF\u53EF\u7528 delete_connections\u3002\u672C\u8F6E\u82E5\u6709\u7528\u6237\u4E0A\u4F20\u7684\u56FE\u7247\u9644\u4EF6\uFF0C\u4F1A\u540C\u65F6\u7ED9\u51FA attachmentId\uFF1B\u7528\u6237\u8981\u6C42\u628A\u9644\u4EF6\u653E\u5165\u753B\u5E03\u6216\u4F5C\u4E3A\u751F\u6210\u53C2\u8003\u56FE\u65F6\uFF0C\u5FC5\u987B\u5148\u7528 canvas_create_attachment_nodes \u521B\u5EFA\u771F\u5B9E\u56FE\u7247\u8282\u70B9\uFF0C\u518D\u628A\u8FD4\u56DE\u7684\u8282\u70B9 ID \u4F20\u7ED9 canvas_create_generation_flow.referenceNodeIds\uFF0C\u4E0D\u8981\u521B\u5EFA\u7A7A\u56FE\u7247\u5360\u4F4D\u8282\u70B9\u3002\u82E5\u5F53\u524D\u4E0D\u5728\u753B\u5E03\u9875\uFF0C\u753B\u5E03\u5DE5\u5177\u4F1A\u62A5\u9519\uFF0C\u9700\u5148\u7528 site_navigate \u6253\u5F00\u753B\u5E03\u3002\u60F3\u4E86\u89E3\u6216\u6253\u5F00\u7528\u6237\u5DF2\u6709\u753B\u5E03\uFF0C\u7528 canvas_list_projects \u83B7\u53D6\u753B\u5E03\u6E05\u5355\u548C id\uFF0C\u518D\u7528 site_navigate \u8DF3 /canvas/:id \u6253\u5F00\u3002\u751F\u56FE\u5DE5\u4F5C\u53F0\u53EF\u7528 workbench_image_get_config \u770B\u53EF\u9009\u9879\u3001workbench_image_generate \u586B\u63D0\u793A\u8BCD\u5E76\u751F\u6210\uFF1B\u89C6\u9891\u521B\u4F5C\u53F0\u5BF9\u5E94 workbench_video_get_config \u4E0E workbench_video_generate\uFF1B\u7528 prompts_search \u5206\u9875\u641C\u7D22\u63D0\u793A\u8BCD\u5E93\uFF1B\u7528 assets_list \u67E5\u770B\u300C\u6211\u7684\u7D20\u6750\u300D\u3001assets_add \u65B0\u589E\u6587\u672C\u6216\u56FE\u7247\u7D20\u6750\u3002\u9700\u8981\u751F\u6210\u5185\u5BB9\u65F6\u76F4\u63A5\u8C03\u7528\u5BF9\u5E94\u751F\u6210\u5DE5\u5177\uFF0C\u4E0D\u8981\u7ED1\u5B9A\u7279\u5B9A\u4E1A\u52A1\u573A\u666F\u3002\u4E0D\u8981\u6A21\u62DF\u9F20\u6807\u70B9\u51FB\uFF0C\u4E0D\u8981\u8981\u6C42\u7528\u6237\u624B\u52A8\u590D\u5236 JSON\u3002";
+export declare const AGENT_PROMPT: string;
 export type SiteWorkspaceConfig = {
     workspacePath: string;
     activeThreadId?: string;
@@ -14,11 +14,15 @@ export type CanvasAgentConfig = {
     origins?: string[];
     workspace?: SiteWorkspaceConfig;
 };
+/** 读取本地 Canvas Agent 配置，不存在时生成默认配置。 */
 export declare function loadConfig(create?: boolean): CanvasAgentConfig;
+/** 将 Canvas Agent 配置写入用户配置目录。 */
 export declare function saveConfig(config: CanvasAgentConfig): void;
+/** 确保站点级 Codex 工作空间存在并已初始化。 */
 export declare function ensureSiteWorkspace(config: CanvasAgentConfig): {
     workspacePath: string;
     activeThreadId?: string;
     pinnedThreadIds?: string[];
 };
+/** 更新站点级 Codex 工作空间配置。 */
 export declare function updateSiteWorkspace(config: CanvasAgentConfig, patch: Partial<SiteWorkspaceConfig>): SiteWorkspaceConfig;

package/dist/config.js

@@ -6,7 +6,9 @@ export const DEFAULT_PORT = 17371;
 export const CONFIG_DIR = path.join(os.homedir(), ".infinite-canvas");
 export const CONFIG_FILE = path.join(CONFIG_DIR, "canvas-agent.json");
 export const VERSION = readPackageVersion();
-export const AGENT_PROMPT = "你正在帮助用户操作 Infinite Canvas 网站。切换网站页面用 site_navigate，可跳 / (首页)、/canvas (我的画布)、/canvas/:id (指定画布)、/image、/video、/prompts、/assets、/config。需要改动画布时优先使用已配置的 infinite-canvas MCP 工具：先 canvas_get_state 读取当前画布，再根据任务使用 canvas_create_text_node、canvas_generate_text、canvas_generate_image、canvas_generate_video、canvas_generate_audio、canvas_create_generation_flow、canvas_create_config_node、canvas_run_generation、canvas_update_node、canvas_connect_nodes 等通用工具；复杂批量改动再用 canvas_apply_ops，删除连线可用 delete_connections。本轮若有用户上传的图片附件，会同时给出 attachmentId；用户要求把附件放入画布或作为生成参考图时，必须先用 canvas_create_attachment_nodes 创建真实图片节点，再把返回的节点 ID 传给 canvas_create_generation_flow.referenceNodeIds，不要创建空图片占位节点。若当前不在画布页，画布工具会报错，需先用 site_navigate 打开画布。想了解或打开用户已有画布，用 canvas_list_projects 获取画布清单和 id，再用 site_navigate 跳 /canvas/:id 打开。生图工作台可用 workbench_image_get_config 看可选项、workbench_image_generate 填提示词并生成；视频创作台对应 workbench_video_get_config 与 workbench_video_generate；用 prompts_search 分页搜索提示词库；用 assets_list 查看「我的素材」、assets_add 新增文本或图片素材。需要生成内容时直接调用对应生成工具，不要绑定特定业务场景。不要模拟鼠标点击，不要要求用户手动复制 JSON。";
+export const AGENT_PROMPT = fs.readFileSync(new URL("../agent-instructions.md", import.meta.url), "utf8");
+const initializedWorkspaces = new Set();
+/** 读取本地 Canvas Agent 配置，不存在时生成默认配置。 */
 export function loadConfig(create = false) {
     try {
         return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
@@ -18,32 +20,47 @@ export function loadConfig(create = false) {
         return config;
     }
 }
+/** 将 Canvas Agent 配置写入用户配置目录。 */
 export function saveConfig(config) {
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
 }
+/** 确保站点级 Codex 工作空间存在并已初始化。 */
 export function ensureSiteWorkspace(config) {
     const current = config.workspace;
     if (current?.workspacePath) {
         const workspacePath = resolveWorkspacePath(current.workspacePath);
-        fs.mkdirSync(workspacePath, { recursive: true });
+        initializeWorkspace(workspacePath);
         return { ...current, workspacePath };
     }
     const workspacePath = path.join(CONFIG_DIR, "codex-workspaces", "site");
     config.workspace = { workspacePath };
-    fs.mkdirSync(workspacePath, { recursive: true });
+    initializeWorkspace(workspacePath);
     saveConfig(config);
     return { workspacePath };
 }
+/** 更新站点级 Codex 工作空间配置。 */
 export function updateSiteWorkspace(config, patch) {
     const current = ensureSiteWorkspace(config);
     const workspacePath = patch.workspacePath ? resolveWorkspacePath(patch.workspacePath) : current.workspacePath;
     const next = { ...current, ...patch, workspacePath };
     config.workspace = { workspacePath: next.workspacePath, activeThreadId: next.activeThreadId, pinnedThreadIds: next.pinnedThreadIds };
-    fs.mkdirSync(workspacePath, { recursive: true });
+    initializeWorkspace(workspacePath);
     saveConfig(config);
     return config.workspace;
 }
+/** 创建工作空间目录并写入默认 AGENTS.md。 */
+function initializeWorkspace(workspacePath) {
+    if (initializedWorkspaces.has(workspacePath))
+        return;
+    fs.mkdirSync(workspacePath, { recursive: true });
+    const instructionsFile = path.join(workspacePath, "AGENTS.md");
+    const current = fs.existsSync(instructionsFile) ? fs.readFileSync(instructionsFile, "utf8") : "";
+    if (!current || current.startsWith("# Infinite Canvas Agent"))
+        fs.writeFileSync(instructionsFile, AGENT_PROMPT);
+    initializedWorkspaces.add(workspacePath);
+}
+/** 将用户输入的工作空间路径解析为绝对路径。 */
 function resolveWorkspacePath(value) {
     if (value === "~")
         return os.homedir();
@@ -51,6 +68,7 @@ function resolveWorkspacePath(value) {
         return path.join(os.homedir(), value.slice(2));
     return path.resolve(value);
 }
+/** 从当前包信息中读取 Canvas Agent 版本号。 */
 function readPackageVersion() {
     try {
         const pkg = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { startHttpServer } from "./http-server.js";
-import { startMcpServer } from "./mcp-server.js";
+import { startHttpServer } from "./server/http.js";
+import { startMcpServer } from "./server/mcp.js";
 if (process.argv[2] === "mcp")
     await startMcpServer();
 else

package/dist/server/http.d.ts

@@ -0,0 +1,2 @@
+/** 启动仅监听本机的 Canvas Agent HTTP 服务。 */
+export declare function startHttpServer(): void;