用途:在内部宿主环境中处理 Genie editor 待办(backlog),流程为先读 backlog、再改代码、最后回写状态并复核。命令模板、字段说明和常见错误见 references/cli-reference.md。
主要能力与用法:先运行 npx @axhub/genie status --json 检查服务;若服务未启动或命令不可用,直接说明阻塞点。用 editor clients list --channel <channel> 查找目标客户端,优先匹配 pageUrl、sessionId、显式 targetClientId 及 editor.* 能力,整个任务固定使用同一组 channel + targetClientId。随后做全局扫描:editor snapshot 加 editor nodes list --status pending-dispatch,dirty;无 backlog 则如实返回。处理节点前先 editor editing set --state editing,保持稳定 provider,每个节点使用唯一 taskRequestId。需要时用 context-images export 补页面级参考,节点定位不清时用 node screenshot,导出图片仅作辅助证据。改代码后至少再读一轮 snapshot 和 nodes list --status pending-dispatch,dirty,error,editing。每个已领取节点必须写终态:成功 completed、失败 error、中断或放弃 idle。
多节点并行:同一块 UI 的节点优先合并处理;真正独立的节点可并行改代码,但客户端选择、节点领取/释放、最终复核由主代理统一负责;节点位置未判断清楚时不要并行。
限制与规则:不要把“代码改完”等同于“backlog 已消费”,节点仍为 dirty 或 pending-dispatch 时需同时说明代码与 backlog 状态;服务离线、客户端不对、缺少能力、截图失败、节点无法定位时直接报告,不要伪造完成;不要留下无终态的已领取节点。最终回复至少包含:使用的 channel + targetClientId、本轮处理的 elementKey、各节点终态、修改的文件、所做验证、仍未处理或状态异常的节点。