version: "1.0.0" name: open-canvas description: 打开、连接或操作 Infinite Canvas 画布；未连接时启动本地 Agent 并自动传入连接信息，已连接时直接调用画布 MCP 工具。

打开、连接和操作画布

本插件通过 npx -y @tigerowo/canvas-agent@latest 获取并运行 npm 上的 Agent，画布操作使用本插件 MCP 提供的现有工具。命令不依赖仓库或插件缓存目录。

• 已连接且目标画布已确认时，直接操作，跳过下方连接流程；首次连接、目标改变或连接失效时再确认目标。
• 直接调用当前对话提供的画布 MCP 工具，不编写临时脚本另建 MCP 客户端。工具缺失时定位插件加载状态和启动错误，不以脚本调用成功代替插件工具加载成功。
• 普通创建节点使用已知工具定义和必要参数，不重复读取工具清单；操作需要已有节点、内容、来源或当前选择时才按需查询画布。
• 工具已返回成功、节点 ID 和节点数据时，以返回结果为准，不再查询整张画布验证；报错、结果不明确或用户要求复查时再追加检查。

建立连接

npx 自动获取包及依赖，无需用户进入插件缓存安装依赖。缺少 Node.js 22+、npm/npx 或下载失败时说明实际错误并停止，不改用开发机路径。

Windows 启动权限：执行第 3 步后台服务或第 5 步浏览器打开命令时，使用用户的正常桌面账户，连接配置也应属于同一桌面用户。现有权限不足时，先通过执行工具实际发起桌面执行权限申请；工具支持 sandbox_permissions 时设置为 require_escalated 并填写 justification，获批后自动继续，覆盖当前命令的已有授权直接复用，不额外聊天确认。仅申请配置目录写入权限不能替代桌面执行权限，不在沙箱账户中强行启动。

会话禁止申请权限、用户拒绝或自动审批拒绝时，停止对应启动，明确说明被拒绝的操作和原因；不修改权限策略、不换工具绕过拒绝，也不默认转成让用户在 PowerShell 手动执行。用户主动选择手动方式时再提供命令。

1. 优先使用用户已经给出的画布 URL 和已观察到的原画布标签，不重复索取地址。实际画布路由是 /canvas/[id]。不同浏览器或配置文件可能没有同一份本地项目；连接已有画布时保留原浏览器环境，不先在内置浏览器打开裸链接。只有用户要求新建时，才在目标站点 /canvas 列表通过现有“新建”操作进入画布，不能拼造画布 ID。无法确定站点时再询问实际地址。
2. 执行 npx -y @tigerowo/canvas-agent@latest config 读取 {url, token, origins}，并请求其 GET /config 判断服务是否已启动。config 不改本机连接配置。HTTP /config 只提供 {url, hasToken}，不包含 Token；首次尚无本机配置时进入启动步骤。
3. 服务未运行时，用当前环境提供的后台终端运行 npx -y @tigerowo/canvas-agent@latest，保持进程存活。Windows 使用 Start-Process 时必须带 -WindowStyle Hidden。不要安装或发布额外全局包。启动失败或端口属于其他服务时读取错误并停止，不反复启动或结束未知进程。已有服务正常时不要重复启动。
4. 读取启动输出的 Local URL、Connect token，或再次执行 npx -y @tigerowo/canvas-agent@latest config。Token 保存在当前用户的 ~/.infinite-canvas/codex-agent.json，无需用户创建 .env、生成 Token 或录入网站来源。不要在回复、文档或额外日志中复制 Token 或包含它的完整连接链接。
5. 原画布标签可控时，用标准 URL 和 URLSearchParams 保留原链接及其他 fragment 参数，设置 agentUrl、agentToken，在该标签打开连接链接。原浏览器不可控时，执行 npx -y @tigerowo/canvas-agent@latest open "<原画布URL>" <浏览器> [浏览器参数...]，入口会自动带入凭据并打开浏览器，无需读取或输出完整连接链接。浏览器取 chrome、edge、firefox、brave；只有已确认原画布使用系统默认浏览器时才用 default。使用已确认的原配置文件参数；无法确定原浏览器或配置时只询问缺失的信息，不猜测、不切换内置浏览器。Token 仅写入 fragment，不放普通 query。
6. 打开命令成功不代表已连接。等待画布 MCP 工具可用，再调用 get_canvas_summary 确认目标，成功后继续用户任务；无需能控制系统浏览器标签。网页的本地网络权限提示由用户允许。失败时定位服务、网页连接或原浏览器配置的问题，不转成手填 Token 教程，不用其他画布替代目标。多个画布连接时明确当前目标，不能随意选一个执行。

浏览器连接需要与 Agent 在同一台电脑，npm 包下载后仍在本机运行。Codex 未登录时执行 npx -y @openai/codex@0.159.2 login，让用户完成登录；不要读取或复制账号凭证。只执行用户请求所需的启动、连接和画布操作。