version: "1.0.1" name: open-canvas description: 打开 Infinite Canvas 在线或本地画布，并自动连接本地 Canvas Agent。用户要求打开、启动、进入或使用 Infinite Canvas 画布时使用。
Open Infinite Canvas
默认打开在线版。只有用户明确要求使用本地项目时，才启动本地前端。
在线版
- 启动本地 Canvas Agent 并保持运行：
bash
npx -y @basketikun/canvas-agent
- 从启动输出取得
Local URL 和 Connect token。
- 在 Codex 右侧浏览器打开：
text
https://canvas.best/canvas?mode=new&agentUrl=<Local URL>&agentToken=<Connect token>
本地版
- 在 Infinite Canvas 项目中启动前端，并使用 Vite 输出的
Local 地址：
bash
cd web
bun install
bun run dev
- 启动本地 Canvas Agent：
bash
npx -y @basketikun/canvas-agent
- 从启动输出取得
Local URL 和 Connect token，在 Codex 右侧浏览器打开：
text
<Vite Local 地址>/canvas?mode=new&agentUrl=<Local URL>&agentToken=<Connect token>
MCP 与连接地址
插件在新的 Codex 任务中加载时会自动启动 npx -y @basketikun/canvas-agent mcp。这个 MCP 进程负责提供画布工具，不提供网页连接服务； 上面启动的普通 Canvas Agent 负责提供 Local URL 和 Connect token。两个进程读取同一份本地配置，因此不需要用户手动填写地址或 token。
打开模式
用户没有明确指定打开方式时，始终使用 mode=new 新建画布。只有用户明确要求时才替换为：
- 最近画布：
mode=recent - 自己选择：
mode=choose