@kobinflow/canvas-agent 0.6.0 → 0.7.0

package/README.md

@@ -16,7 +16,7 @@ npx -y @kobinflow/canvas-agent@latest
 npx -y @kobinflow/canvas-agent@latest --debug
 ```
 
-Debug 日志会以 `[DEBUG][HH:mm:ss]` 等传统格式输出到终端，并按启动日期保存到 `~/.infinite-canvas/logs/canvas-agent-YYYY-MM-DD.log`。终端日志带级别颜色，文件日志为纯文本；日志包含 HTTP、SSE、线程、turn、Codex app-server 和工具调用事件，token 与图片 Data URL 会自动隐藏。
+Debug 日志会以 `[DEBUG][HH:mm:ss]` 等传统格式输出到终端，并按启动日期保存到 `~/.dianran/logs/canvas-agent-YYYY-MM-DD.log`。终端日志带级别颜色，文件日志为纯文本；日志包含 HTTP、SSE、线程、turn、Codex app-server 和工具调用事件，token 与图片 Data URL 会自动隐藏。
 
 本仓库开发时也可以直接运行：
 
@@ -38,7 +38,7 @@ Connect token: xxxxxx
 
 Codex app 插件会读取启动输出里的 Local URL 和 Connect token，并直接打开画布网页地址；Canvas Agent 不负责生成画布打开 URL。
 
-Canvas Agent 默认只监听 `127.0.0.1`。网页第一次带正确 token 连接后，Canvas Agent 会记录该网页 Origin；之后其他 Origin 不能复用这个本地 Agent，除非用户清理 `~/.infinite-canvas/canvas-agent.json` 里的 `origins`。
+Canvas Agent 默认只监听 `127.0.0.1`。网页第一次带正确 token 连接后，Canvas Agent 会记录该网页 Origin；之后其他 Origin 不能复用这个本地 Agent，除非用户清理 `~/.dianran/canvas-agent.json` 里的 `origins`。
 
 ## 发布
 
@@ -50,30 +50,34 @@ Canvas Agent 默认只监听 `127.0.0.1`。网页第一次带正确 token 连接
 
 如果希望 Codex 终端能直接操作画布，需要先把 Canvas Agent 注册成 Codex MCP。
 
-直接运行 `npx -y @kobinflow/canvas-agent@latest` 只启动本地 Agent 服务，不会安装 MCP，也不会增加 Codex 工具上下文。只有安装 Codex app 插件，或手动执行 `codex mcp add` 后，`infinite-canvas` 工具才会进入 Codex 上下文；由于工具较多，不使用时建议移除。
+直接运行 `npx -y @kobinflow/canvas-agent@latest` 只启动本地 Agent 服务，不会安装 MCP，也不会增加 Codex 工具上下文。只有安装 Codex app 插件，或手动执行 `codex mcp add` 后，`dianran` 工具才会进入 Codex 上下文；由于工具较多，不使用时建议移除。
 
 通过插件安装时移除插件：
 
 ```bash
+codex plugin remove dianran
+# 旧版本 / 上游安装的名字：
 codex plugin remove infinite-canvas
 ```
 
 手动添加 MCP 时移除 MCP：
 
 ```bash
+codex mcp remove dianran
+# 旧版本 / 上游安装的名字：
 codex mcp remove infinite-canvas
 ```
 
 ### Codex app 插件
 
-仓库内提供了 Codex app 插件：`plugins/infinite-canvas`。在 Codex app 中添加本仓库的 marketplace 后，可以安装 `Infinite Canvas` 插件；插件会注册同一个 `infinite-canvas` MCP，并带上画布操作说明。
+仓库内提供了 Codex app 插件：`plugins/dianran`。在 Codex app 中添加本仓库的 marketplace（`codex plugin marketplace add kobingogo/dianran`）后，可以安装 `点染 Dianran` 插件；插件会注册同一个 `dianran` MCP，并带上画布操作说明。0.7.0 起 MCP 名从 `infinite-canvas` 改为 `dianran`，配置目录从 `~/.infinite-canvas` 改为 `~/.dianran`（首次启动自动迁移旧 token / 地址）。
 
 添加本地 marketplace 时建议使用仓库绝对路径，避免 Codex 从其他工作目录解析失败：
 
 ```bash
-cd /path/to/infinite-canvas
+cd /path/to/dianran
 codex plugin marketplace add "$(pwd)"
-codex plugin add infinite-canvas@infinite-canvas-local
+codex plugin add dianran@dianran-local
 ```
 
 插件默认通过 npm 启动 MCP；这个命令只提供 MCP 工具，不会把 MCP 写入全局配置，也不会在退出时自动卸载：
@@ -82,18 +86,18 @@ codex plugin add infinite-canvas@infinite-canvas-local
 npx -y @kobinflow/canvas-agent@latest mcp
 ```
 
-使用时可以直接在 Codex 里说“打开 Infinite Canvas”，插件会启动本地 Agent，读取 Local URL 和 Connect token，然后在右侧打开 `https://canvas.best/` 并自动新建、连接画布；只有明确要求使用本地项目时才会启动本地前端。
+使用时可以直接在 Codex 里说“打开点染画布”，插件会启动本地 Agent，读取 Local URL 和 Connect token，然后在右侧打开 `https://dianran.vercel.app/` 并自动新建、连接画布；只有明确要求使用本地项目时才会启动本地前端。
 
 Canvas Agent 启动后，给 Codex 添加 MCP：
 
 ```bash
-codex mcp add infinite-canvas -- npx -y @kobinflow/canvas-agent@latest mcp
+codex mcp add dianran -- npx -y @kobinflow/canvas-agent@latest mcp
 ```
 
 本仓库开发时可以改成，实际使用建议替换为本机绝对路径：
 
 ```bash
-codex mcp add infinite-canvas -- node /path/to/infinite-canvas/canvas-agent/dist/index.js mcp
+codex mcp add dianran -- node /path/to/dianran/canvas-agent/dist/index.js mcp
 ```
 
 Canvas Agent 源码使用 TypeScript 编写，MCP 协议层使用官方 `@modelcontextprotocol/sdk`，工具入参使用 `zod` 描述。
@@ -101,7 +105,7 @@ Canvas Agent 源码使用 TypeScript 编写，MCP 协议层使用官方 `@modelc
 如果希望终端里的 Codex 不被 MCP 审批卡住，可以在 `~/.codex/config.toml` 里给这个 MCP 设置自动放行：
 
 ```toml
-[mcp_servers.infinite-canvas]
+[mcp_servers.dianran]
 command = "npx"
 args = ["-y", "@kobinflow/canvas-agent@latest", "mcp"]
 default_tools_approval_mode = "approve"
@@ -134,7 +138,7 @@ default_tools_approval_mode = "approve"
 
 ## 侧边栏 Codex
 
-本地面板会把提示词发送给 Canvas Agent。Canvas Agent 使用官方 `@openai/codex` CLI 的 `codex app-server --stdio` 启动并复用同一个 Codex thread，启动时会注入 `infinite-canvas` MCP 配置并自动放行 MCP 审批，真正执行画布修改前仍由网页侧边栏二次确认。
+本地面板会把提示词发送给 Canvas Agent。Canvas Agent 使用官方 `@openai/codex` CLI 的 `codex app-server --stdio` 启动并复用同一个 Codex thread，启动时会注入 `dianran` MCP 配置并自动放行 MCP 审批，真正执行画布修改前仍由网页侧边栏二次确认。
 
 侧边栏会展示 Codex 返回的 `thread.started`、`turn.started`、`item.*`、`turn.completed` 等结构化事件；Canvas Agent 会合并短时间内的回复、思考摘要和命令输出增量，网页使用同一条消息持续更新，并把任务进度、计划、搜索、文件修改与工具操作整理为中文过程时间线。
 
@@ -147,13 +151,13 @@ Claude Code Adapter 代码暂时保留，但当前网页侧边栏只开放 Codex
 如果希望 Claude Code 也能操作画布，需要给 Claude Code 添加同一个 MCP。建议用 user scope，避免 Canvas Agent 从不同目录启动时找不到配置：
 
 ```bash
-claude mcp add --scope user --transport stdio infinite-canvas -- npx -y @kobinflow/canvas-agent@latest mcp
+claude mcp add --scope user --transport stdio dianran -- npx -y @kobinflow/canvas-agent@latest mcp
 ```
 
 本仓库开发时可以改成：
 
 ```bash
-claude mcp add --scope user --transport stdio infinite-canvas -- node /path/to/infinite-canvas/canvas-agent/dist/index.js mcp
+claude mcp add --scope user --transport stdio dianran -- node /path/to/dianran/canvas-agent/dist/index.js mcp
 ```
 
-Canvas Agent 调用 Claude Code 时会默认带上 `--allowedTools mcp__infinite-canvas__*`，画布写操作仍由网页侧边栏确认。
+Canvas Agent 调用 Claude Code 时会默认带上 `--allowedTools mcp__dianran__*`（兼容旧名 `mcp__infinite-canvas__*`），画布写操作仍由网页侧边栏确认。

package/agent-instructions.md

@@ -1,10 +1,10 @@
-# Infinite Canvas Agent
+# Dianran Canvas Agent
 
 你正在帮助用户操作点染（Dianran）画布网站。
 
 - 用户要求操作画布时，默认目标就是网页当前已经打开的画布。需要了解内容时先使用 `canvas_get_state`；读取成功后直接在该画布执行任务，不要调用 `canvas_list_projects`，也不要用 `site_navigate` 重复进入画布。
 - 只有用户明确要求查看、选择或切换其他画布，或者 `canvas_get_state` 明确提示当前没有已连接画布时，才使用 `canvas_list_projects` 和 `site_navigate`。`site_navigate` 可跳转 `/`、`/canvas`、`/canvas/:id`、`/image`、`/video`、`/prompts`、`/assets`、`/config`。
-- 修改当前画布时根据任务使用已配置的 infinite-canvas MCP 工具；复杂批量改动使用 `canvas_apply_ops`。
+- 修改当前画布时根据任务使用已配置的 dianran MCP 工具（旧安装可能叫 infinite-canvas）；复杂批量改动使用 `canvas_apply_ops`。
 - 用户要求把上传附件放入画布或作为生成参考图时，必须先用 `canvas_create_attachment_nodes` 创建真实图片节点，再把节点 ID 传给生成流程，不要创建空图片占位节点。
 - 生图与视频工作台分别使用 `workbench_image_*`、`workbench_video_*` 工具；提示词和素材分别使用 `prompts_search`、`assets_*` 工具。
 - 用户要求生成图片、视频、音频或文本时，默认调用对应的 `canvas_generate_image`、`canvas_generate_video`、`canvas_generate_audio`、`canvas_generate_text`，通过当前画布的生成节点完成任务。

package/dist/agent/claude.js

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { AGENT_PROMPT } from "../config.js";
+import { AGENT_PROMPT, LEGACY_MCP_SERVER_NAME, MCP_SERVER_NAME } from "../config.js";
 import { createAgentLogWriter } from "../utils/agent-runtime.js";
 import { errorMessage } from "../utils/value.js";
 /** 使用 Claude CLI 执行一次带 Canvas Agent 工具的任务。 */
@@ -7,7 +7,7 @@ export function runClaudeTurn(prompt, emit) {
     const fullPrompt = withAgentPrompt(prompt);
     if (!fullPrompt)
         return;
-    const child = spawnAgent("claude", ["-p", "--output-format", "stream-json", "--verbose", "--include-partial-messages", "--allowedTools", "mcp__infinite-canvas__*", fullPrompt], emit);
+    const child = spawnAgent("claude", ["-p", "--output-format", "stream-json", "--verbose", "--include-partial-messages", "--allowedTools", `mcp__${MCP_SERVER_NAME}__*,mcp__${LEGACY_MCP_SERVER_NAME}__*`, fullPrompt], emit);
     if (child)
         pipeJsonLines(child, emit, "claude");
 }

package/dist/agent/codex-client.js

@@ -3,7 +3,7 @@ import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { createAgentLogWriter } from "../utils/agent-runtime.js";
-import { VERSION } from "../config.js";
+import { MCP_SERVER_NAME, VERSION } from "../config.js";
 import { logger } from "../utils/logger.js";
 import { field } from "../utils/value.js";
 import { codexEventHistory } from "./codex-event-history.js";
@@ -812,7 +812,7 @@ function canvasAgentMcpCommand() {
 }
 /** 生成 Codex app-server 使用的 MCP 配置。 */
 function codexConfig(permissionMode) {
-    return { model_reasoning_summary: "auto", ...(permissionMode === "automatic" ? { approvals_reviewer: "auto_review" } : {}), mcp_servers: { "infinite-canvas": { command: canvasAgentMcp.command, args: canvasAgentMcp.args, default_tools_approval_mode: "approve", startup_timeout_sec: 20, tool_timeout_sec: 90 } } };
+    return { model_reasoning_summary: "auto", ...(permissionMode === "automatic" ? { approvals_reviewer: "auto_review" } : {}), mcp_servers: { [MCP_SERVER_NAME]: { command: canvasAgentMcp.command, args: canvasAgentMcp.args, default_tools_approval_mode: "approve", startup_timeout_sec: 20, tool_timeout_sec: 90 } } };
 }
 function threadSettings(permissionMode) {
     return { approvalPolicy: permissionMode === "full" ? "never" : "on-request", sandbox: permissionMode === "full" ? "danger-full-access" : "workspace-write", config: codexConfig(permissionMode) };

package/dist/agent/codex.js

@@ -495,7 +495,7 @@ async function writeAttachmentFile(item) {
     const [, meta = "", data = ""] = item.dataUrl?.match(/^data:([^;]+);base64,(.+)$/) || [];
     if (!data)
         throw new Error(`图片附件无效：${item.name || "未命名图片"}`);
-    const file = path.join(os.tmpdir(), `infinite-canvas-${Date.now()}-${Math.random().toString(16).slice(2)}.${imageExt(meta || item.type)}`);
+    const file = path.join(os.tmpdir(), `dianran-${Date.now()}-${Math.random().toString(16).slice(2)}.${imageExt(meta || item.type)}`);
     await fs.writeFile(file, Buffer.from(data, "base64"));
     return file;
 }

package/dist/canvas/session.js

@@ -1,4 +1,5 @@
 import crypto from "node:crypto";
+import { LEGACY_MCP_SERVER_NAME, MCP_SERVER_NAME } from "../names.js";
 import { logger } from "../utils/logger.js";
 import { buildCanvasToolRequest, fitAttachmentNodeSize } from "./operations.js";
 import { compactCanvasState, compactNode, isToolName, nextCanvasX, parseToolInput } from "./tools.js";
@@ -114,9 +115,10 @@ export class CanvasSession {
         this.preparedConversationThreadId = threadId;
         const statuses = this.conversationState.mcpStatuses;
         const hasPending = !this.conversationInventoryComplete || Object.values(statuses).some((item) => item.status === "starting");
-        const requiredFailure = statuses["infinite-canvas"]?.status !== "ready";
+        const required = statuses[MCP_SERVER_NAME] || statuses[LEGACY_MCP_SERVER_NAME];
+        const requiredFailure = required?.status !== "ready";
         const hasFailure = Object.values(statuses).some((item) => item.status === "failed" || item.status === "cancelled");
-        const requiredFailureDetail = statuses["infinite-canvas"]?.error;
+        const requiredFailureDetail = required?.error;
         return this.updateConversation({
             threadId,
             status: hasPending ? "preparing" : requiredFailure ? "failed" : hasFailure ? "warning" : "ready",

package/dist/config.d.ts

@@ -1,6 +1,9 @@
 export declare const DEFAULT_PORT = 17371;
 export declare const CONFIG_DIR: string;
 export declare const CONFIG_FILE: string;
+/** 0.6.x 及更早版本（与上游 Infinite Canvas 共用）的配置位置；首次启动时迁移其中的 token / 地址 / 已授权来源。 */
+export declare const LEGACY_CONFIG_FILE: string;
+export { LEGACY_MCP_SERVER_NAME, MCP_SERVER_NAME } from "./names.js";
 export declare const VERSION: string;
 export declare const AGENT_PROMPT: string;
 export type SiteWorkspaceConfig = {

package/dist/config.js

@@ -3,8 +3,11 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 export const DEFAULT_PORT = 17371;
-export const CONFIG_DIR = path.join(os.homedir(), ".infinite-canvas");
+export const CONFIG_DIR = path.join(os.homedir(), ".dianran");
 export const CONFIG_FILE = path.join(CONFIG_DIR, "canvas-agent.json");
+/** 0.6.x 及更早版本（与上游 Infinite Canvas 共用）的配置位置；首次启动时迁移其中的 token / 地址 / 已授权来源。 */
+export const LEGACY_CONFIG_FILE = path.join(os.homedir(), ".infinite-canvas", "canvas-agent.json");
+export { LEGACY_MCP_SERVER_NAME, MCP_SERVER_NAME } from "./names.js";
 export const VERSION = readPackageVersion();
 export const AGENT_PROMPT = fs.readFileSync(new URL("../agent-instructions.md", import.meta.url), "utf8");
 const initializedWorkspaces = new Set();
@@ -14,12 +17,28 @@ export function loadConfig(create = false) {
         return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"));
     }
     catch {
+        const legacy = readLegacyConfig();
+        if (legacy) {
+            if (create)
+                saveConfig(legacy);
+            return legacy;
+        }
         const config = { url: `http://127.0.0.1:${Number(process.env.PORT) || DEFAULT_PORT}`, token: crypto.randomBytes(18).toString("hex") };
         if (create)
             saveConfig(config);
         return config;
     }
 }
+/** 读取旧版 ~/.infinite-canvas 配置（只取连接相关字段，工作空间沿用其绝对路径）。 */
+function readLegacyConfig() {
+    try {
+        const legacy = JSON.parse(fs.readFileSync(LEGACY_CONFIG_FILE, "utf8"));
+        return legacy?.url && legacy?.token ? legacy : null;
+    }
+    catch {
+        return null;
+    }
+}
 /** 将 Canvas Agent 配置写入用户配置目录。 */
 export function saveConfig(config) {
     writeConfigFile(CONFIG_DIR, CONFIG_FILE, config);
@@ -62,7 +81,7 @@ function initializeWorkspace(workspacePath) {
     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"))
+    if (!current || current.startsWith("# Infinite Canvas Agent") || current.startsWith("# Dianran Canvas Agent"))
         fs.writeFileSync(instructionsFile, AGENT_PROMPT);
     initializedWorkspaces.add(workspacePath);
 }

package/dist/names.d.ts

@@ -0,0 +1,4 @@
+/** Codex / Claude Code 中注册的 MCP 服务名（插件 .mcp.json、codex mcp add 与 app-server 注入保持一致）。 */
+export declare const MCP_SERVER_NAME = "dianran";
+/** 0.6.x 及更早版本和上游 Infinite Canvas 使用的旧名字，仍被识别以兼容旧安装。 */
+export declare const LEGACY_MCP_SERVER_NAME = "infinite-canvas";

package/dist/names.js

@@ -0,0 +1,4 @@
+/** Codex / Claude Code 中注册的 MCP 服务名（插件 .mcp.json、codex mcp add 与 app-server 注入保持一致）。 */
+export const MCP_SERVER_NAME = "dianran";
+/** 0.6.x 及更早版本和上游 Infinite Canvas 使用的旧名字，仍被识别以兼容旧安装。 */
+export const LEGACY_MCP_SERVER_NAME = "infinite-canvas";

package/dist/server/http.js

@@ -6,7 +6,7 @@ import { runClaudeTurn } from "../agent/claude.js";
 import { archiveCodexThread, CodexSkillLookupError, configureCodexSkill, generateCodexSkillDraft, interruptCodexTurn, isRecoverableThreadError, listCodexModels, listCodexSkills, listCodexThreads, readCodexThread, resolveCodexApproval, resolveCodexSkill, resumeCodexThread, runCodexTurn, startCodexThread, summarizeCodexThread } from "../agent/codex.js";
 import { messageMetadataStore } from "../agent/message-metadata.js";
 import { AGENT_PROTOCOL_VERSION, CanvasSession } from "../canvas/session.js";
-import { DEFAULT_PORT, ensureSiteWorkspace, loadConfig, saveConfig, updateSiteWorkspace } from "../config.js";
+import { DEFAULT_PORT, ensureSiteWorkspace, LEGACY_MCP_SERVER_NAME, loadConfig, MCP_SERVER_NAME, saveConfig, updateSiteWorkspace } from "../config.js";
 import { logger } from "../utils/logger.js";
 import { checkVersions } from "../version-check.js";
 import { SkillStore, SkillStoreError } from "../skills/store.js";
@@ -470,8 +470,8 @@ export function startHttpServer() {
         console.log(`Local URL: ${config.url}`);
         console.log(`Connect token: ${config.token}`);
         console.log("Codex MCP is not installed by this command.");
-        console.log("Optional MCP add: codex mcp add infinite-canvas -- npx -y @kobinflow/canvas-agent@latest mcp");
-        console.log("Remove manually added MCP: codex mcp remove infinite-canvas");
+        console.log(`Optional MCP add: codex mcp add ${MCP_SERVER_NAME} -- npx -y @kobinflow/canvas-agent@latest mcp`);
+        console.log(`Remove manually added MCP: codex mcp remove ${MCP_SERVER_NAME}  (old installs: codex mcp remove ${LEGACY_MCP_SERVER_NAME})`);
         if (logger.enabled)
             console.log(`Debug log: ${logger.filePath}`);
         logger.info("Canvas Agent started", { url: config.url, workspace: ensureSiteWorkspace(config).workspacePath, debugLog: logger.filePath });

package/dist/server/mcp.js

@@ -5,7 +5,7 @@ import { AGENT_PROMPT, loadConfig, VERSION } from "../config.js";
 /** 启动通过标准输入输出通信的 MCP 服务。 */
 export async function startMcpServer() {
     const config = loadConfig(true);
-    const server = new McpServer({ name: "canvas-agent", version: VERSION }, { instructions: AGENT_PROMPT });
+    const server = new McpServer({ name: "dianran-canvas-agent", version: VERSION }, { instructions: AGENT_PROMPT });
     toolNames.forEach((name) => registerCanvasTool(server, config, name));
     await server.connect(new StdioServerTransport());
 }

package/dist/utils/logger.js

@@ -7,7 +7,7 @@ import { formatDateForFilename } from "./date.js";
 /** 管理 Canvas Agent 的终端与文件 Debug 日志。 */
 export class Logger {
     enabled = process.argv.includes("--debug");
-    filePath = this.enabled ? path.join(os.homedir(), ".infinite-canvas", "logs", `canvas-agent-${formatDateForFilename()}.log`) : "";
+    filePath = this.enabled ? path.join(os.homedir(), ".dianran", "logs", `canvas-agent-${formatDateForFilename()}.log`) : "";
     logger;
     /** 普通模式输出 Info 以上日志，Debug 模式额外输出 Debug 并写入文件。 */
     constructor() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kobinflow/canvas-agent",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",