photocraft-editor 是面向 photocraft 的内嵌编辑器技能，核心用途是在支持 MCP Apps 或内置浏览器的宿主内打开 photocraft 的真实编辑界面，并把当前任务工作区连接到该界面，使 Agent 的工具操作与用户看到的编辑页面保持一致。
主要能力方面，该技能提供打开编辑器、打开浏览器编辑页、在 Codex 中打开、查询编辑器状态，以及文档级操作：用 doc_open 或 doc_new 打开或新建文档，用 doc_inspect 查看图层，用 command_list 查询实际可用命令，用 command_run 执行命令，用 doc_save 保存 .pcraft 工程，用 doc_export 导出文件。
使用方式上，应先从当前已加载插件的工具列表找到 photocraft-editor 服务，并以本任务工作区的绝对路径调用 open_editor，首次调用传入 workspace；相对文件路径可在编辑器就绪后交给具体打开工具。宿主支持原生 MCP Apps 时会呈现 ui://photocraft/panel.html；仅得到工具文字结果不代表界面已打开。Codex 未自动呈现面板时，可调用 open_browser_editor，把返回的 editorUrl 交给宿主内置浏览器打开能力；Codex Desktop 可调用 open_in_codex，target 为 browser，url 用实际返回值，不要猜测本地页面路径为固定端口。同一实例只打开一个编辑页，先调用 editor_status，等待 attached 或 ready 为 true 再执行；加载失败应先处理页面错误。
适用场景包括在宿主内进行可视化图像编辑、让 Agent 操作与界面同页展示、检查图层与执行编辑器命令、保存工程并导出结果。限制与注意事项：本轮所有编辑应使用同一服务；原生 CLI 与 Web 编辑器不是同一个内存文档，切换前必须先保存并显式重开。若宿主仅支持 MCP，工具调用能力与内嵌 UI 是两件事，可在外部浏览器使用同一 editorUrl，但须明确这不是宿主内嵌验收。开发候选缺少 ui/dist/adapter.mjs 时需先按插件 ui/README.md 构建，不要从缓存猜测路径或绕过校验。该技能独立安装不附带编辑器服务，需要安装配套插件或配置其 MCP 后端。工具未注册时，可在得到插件实际目录后用项目终端运行 node ui/dist/adapter.mjs --serve，并通过环境变量 CRAFT_WORKSPACE_ROOT 指定本任务工作区；须保持该进程存活，自动化仍要连接对应 MCP 实例，不能另开后端声称共享会话。完成后应保存工程并重开检查，读取实际导出文件；浏览器存储、预览截图和已提交渲染任务不等于工作区交付。