59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
---
|
||
name: open-canvas
|
||
description: 打开 Infinite Canvas 在线或本地画布，并自动连接本地 Canvas Agent。用户要求打开、启动、进入或使用 Infinite Canvas 画布时使用。
|
||
---
|
||
|
||
# Open Infinite Canvas
|
||
|
||
默认打开在线版。只有用户明确要求使用本地项目时，才启动本地前端。
|
||
|
||
## 在线版
|
||
|
||
1. 启动本地 Canvas Agent 并保持运行：
|
||
|
||
```bash
|
||
npx -y @basketikun/canvas-agent
|
||
```
|
||
|
||
2. 从启动输出取得 `Local URL` 和 `Connect token`。
|
||
|
||
3. 在 Codex 右侧浏览器打开：
|
||
|
||
```text
|
||
https://canvas.best/canvas?mode=new&agentUrl=<Local URL>&agentToken=<Connect token>
|
||
```
|
||
|
||
## 本地版
|
||
|
||
1. 在 Infinite Canvas 项目中启动前端，并使用 Vite 输出的 `Local` 地址：
|
||
|
||
```bash
|
||
cd web
|
||
bun install
|
||
bun run dev
|
||
```
|
||
|
||
2. 启动本地 Canvas Agent：
|
||
|
||
```bash
|
||
npx -y @basketikun/canvas-agent
|
||
```
|
||
|
||
3. 从启动输出取得 `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`
|