xiangyu-cas Codex-Canvas
把这个根 Skill 作为 Codex-Canvas 的发现和安装入口。最终运行形态必须是完整 Codex 插件：personal marketplace 中存在 codex-canvas@personal，Codex 已把插件复制到版本化缓存，并在新任务中加载插件自带的 skills 和 MCP server。
安装为 Codex 插件
当用户要求安装、升级或修复 Codex-Canvas，或者当前目录来自 redskill install codex-canvas 时，先执行本节。不要在 Skill 文件下载完成后停止。
- 将包含本文件的目录视为
<codex-canvas-skill-root>。如果本 Skill 刚由 RedSkill 安装，优先使用redskill install输出的安装目录；默认通常是当前 workspace 下的skills/codex-canvas/。 - 在
<codex-canvas-skill-root>/scripts/中查找唯一以install-codex-plugin命名的 JavaScript 安装器。仓库源码与 SkillHub 兼容包可能使用不同的模块扩展名；只运行实际存在的那个文件。 - 执行：
node <installer-path> --json - 安装器必须完成整条稳定链路：把官方 GitHub 仓库放到用户长期目录、切换到最新已发布且校验通过的稳定 Release、安装锁定依赖、写入 personal marketplace、执行
codex plugin add codex-canvas@personal，再用codex plugin list --json验证安装状态和版本。 - 默认跳过可选 RapidOCR 安装，以保持首次安装稳定快速。只有用户明确要求同时安装本地 OCR 时，才追加
--with-ocr。 - 如果安装器报告缺少
git、node、npm或codex，如实报告缺失项。不要改用未校验的main分支、手工拼装插件缓存、系统 UI 自动化或直接链接临时 workspace Skill 目录。 - 成功后告诉用户：插件已经安装，但当前任务不会动态获得刚安装插件的 MCP server 和专用 skills；关闭旧画布并新建一个 Codex 任务，再使用
@Codex-Canvas、$canvas或“打开 Codex-Canvas 画布”。
重复执行安装器应更新或复用同一个稳定源码目录和 personal marketplace 条目。遇到非 Codex-Canvas 仓库、脏工作树或普通目录占用了目标位置时必须停止，不得覆盖用户文件。
定位运行时
- 完成上面的插件安装后，优先使用已安装插件缓存中的 Codex-Canvas runtime。只有安装或故障恢复期间才把当前 Skill 目录视为
<codex-canvas-root>。 - 执行 CLI 前，先确认
<codex-canvas-root>/bin/codex-canvas.mjs存在。 - 使用 Node.js 18.18 或更新版本运行命令。
- 将所有画布数据保存在当前工作区的
canvas/目录下。
打开画布
- 使用以下命令启动或复用项目本地画布：
node <codex-canvas-root>/bin/codex-canvas.mjs open --project <workspace> - 如果能拿到当前 Codex thread id，传入
--thread-id <thread-id>。Codex-Canvas 也会读取CODEX_THREAD_ID和CODEX_CANVAS_CODEX_THREAD_ID。 - 优先使用
open，不要直接用start；open会复用健康的已保存运行时，只在需要时启动 detached server。 - 当 Codex in-app browser 控制能力可用时，直接在 Codex 内置浏览器打开返回的 URL。
- 如果当前环境无法控制内置浏览器，返回画布 URL 的 Markdown 链接。不要启动系统默认浏览器。
图片收集
- 对生成或编辑后的图片，尽量将输出保存到当前工作区。
- 已知图片路径时，用以下命令导入：
node <codex-canvas-root>/bin/codex-canvas.mjs import <image-path> --project <workspace> --thread-id <thread-id> - 如果输出路径不明确，用以下命令收集近期图片：
node <codex-canvas-root>/bin/codex-canvas.mjs collect --project <workspace> --thread-id <thread-id> --since-minutes 30 --limit 5 - 默认收集只扫描
~/.codex/generated_images/<thread-id>。未绑定 thread 时默认收集会安全地不执行；只有用户明确要求手动恢复时，才使用--from <dir,dir>扫描指定目录。 - 遵守 Codex-Canvas 的放置规则：同一批生成图横向排列；从画布对象派生的结果放到源图片右侧。
AI 操作边界
AI 图片操作必须使用稳定的 Codex-Canvas action id 和后端 job。不要把具体操作 prompt 写进前端代码。
quick-edit：使用skills/canvas-quick-edit/SKILL.md。remove-bg：使用skills/canvas-remove-bg/SKILL.md。expand：使用skills/canvas-expand/SKILL.md。edit-text：使用skills/canvas-edit-text/SKILL.md。edit-elements：使用skills/canvas-edit-elements/SKILL.md。
只有在对应 action 被请求时，才加载匹配的操作技能。平移、缩放、拖拽、选择、删除、铅笔绘制、文本对象编辑、工具栏状态、视口 framing 等确定性画布交互应保留在本地应用代码中。
跨平台规则
- 保持 macOS 和 Windows 跨平台兼容。
- 核心行为不要依赖 AppleScript、
osascript、System Events、Windows UI Automation、坐标点击、模拟按键、剪贴板粘贴或操作系统特定的浏览器启动方式。 - 优先使用 Codex 支持的浏览器、插件、MCP、CLI 和后端 job 集成面。
- 修改工具栏、dock 和控件 UI 时，使用成熟图标集和应用既有图标风格。
插件兼容
不要要求 .codex-plugin/plugin.json 指向这个根 Skill。Skill 负责发现、bootstrap 和故障恢复；正式使用由 personal marketplace 安装的插件负责。插件安装路径继续暴露现有 skills/ 目录和 MCP server 配置。