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