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