mcpField
C
cowart-open-canvas

cowart-open-canvas

github.com/zhongerxin创意与媒体6.0k98 次安装3 周前更新
代码仓库

关于 cowart-open-canvas

cowart-open-canvas 是用于在 Codex 中打开、重新打开或刷新 Cowart 画布的技能。它调用 cowart_mcp 的渲染工具，并将用户当前工作区作为项目目录传入。

主要功能

  1. 01打开或重新打开画布
  2. 02显式请求时刷新画布
  3. 03将当前工作区传给渲染工具
  4. 04使用 Cowart 画布小组件

适用场景

  1. 01在 Codex 中打开 Cowart 画布
  2. 02重新显示已有画布
  3. 03按请求刷新当前画布

MCP 相关

此技能使用 cowart_mcp MCP 服务的 render_cowart_canvas_widget 工具打开画布小组件，并传入项目目录。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zhongerxin/cowart --skill cowart-open-canvas

安装后在 Claude Code 中输入/cowart-open-canvas确认已加载。

附带文件agents/openai.yaml

详细介绍

Cowart Open Canvas

实际的画布打开功能由 cowart_mcp MCP 服务及其 render_cowart_canvas_widget 工具提供。当用户要求打开、重新打开或明确刷新画布时，使用此技能。如果用户只调用了 @Cowart，且没有提出其他可执行的请求，也可以打开画布。不要将此技能用作图像生成、注释编辑、HTML、幻灯片或来自已打开的 Cowart 小组件的后续请求的前置条件。

工作流

  1. 确保已加载或可发现 cowart_mcp MCP 服务，并且 render_cowart_canvas_widget 工具可用。宿主可能会将完整工具名称显示为 mcp__cowart_mcp__render_cowart_canvas_widget。针对用户的打开、重新打开或明确刷新请求，调用一次该工具。将用户当前的 Codex 工作区作为 projectDir 传入；不要传入 Cowart 插件仓库目录。
{
  "projectDir": "/absolute/path/to/user/codex-project"
}

该工具会返回 openai/outputTemplate: ui://widget/cowart/canvas.html，告知 Codex 直接渲染小组件。正常使用时，不要启动 scripts/start-canvas.sh 或打开 localhost URL。

Cowart 还声明了一个 OpenAI MCP Extensions global 入口，因此受支持的宿主可以在导航栏中显示该入口，并允许用户将其固定。点击该入口会发送 {}，并直接在 <system Documents>/Cowart/canvas/ 中打开画布。这是一个供多个页面共用的本地画布；仅当不存在任何页面时才会创建第一页。没有项目选择器。空参数不会根据 MCP 进程目录推断工作区。在聊天中已知工作区时，继续传入 projectDir，以便直接打开该工作区的画布。Cowart 仅声明了 fullscreen 显示模式；在对话中，宿主可能会将全屏应用放在内容侧边栏中。

对于来自全局应用的后续请求，请使用 Cowart 的模型上下文或后续消息中提供的 projectDir 和 canvasDir。不要用全局应用线程自身的工作目录替代已打开画布的目录。

  1. 确认小组件已为用户打开。画布数据存储在当前项目中：
canvas/pages/<page-id>/cowart-canvas.json
canvas/pages/<page-id>/assets/
  1. 如果当前轮次中看不到 MCP 工具，请使用工具发现功能查找 Cowart 小组件/渲染能力，并在收到明确的 Cowart 画布调用后，在同一任务中重试。不要仅仅因为某一轮没有显示该工具，就声称必须新建任务。只有在刚安装或升级插件，且经过工具发现和明确重试后 MCP 架构仍不可用时，才建议新建 Codex 任务。

限制

不要仅仅因为适用另一项 Cowart 技能，或现有小组件发送了后续请求，就再次调用 render_cowart_canvas_widget。现有小组件会自行同步由 MCP 提供支持的画布更改。除非小组件无法打开，或用户明确要求执行这些检查，否则不要启动旧的本地 Web 服务、检查画布文件、运行构建、检查存储布局、截取屏幕截图或执行其他验证步骤。scripts/start-canvas.sh 现在仅作为本地开发时的备用方案。

评论

支持 Markdown