用途:处理 Axhub Commentary 的完整工作流,包括页面批注读取与处理、生成可批注地址、准备 Annotation 标注环境、配置 AI 对话与批注执行,以及低频的页面侧接入。编辑器由 Axhub Chrome 扩展或宿主预览环境提供,不要求目标项目安装编辑器 runtime。
主要能力与用法:先判断任务属于哪条工作线,只读取对应参考文档。批注读取与处理先直接读取本地 comments.json,不检测 ACP UI;只有本地批注无法定位、读取或格式校验失败时,才访问 http://localhost:32124/api/health 检测,需同时满足 status: "ok" 和 service: "acp-ui" 才算就绪,失败后读 references/acp-native-bootstrap.md 启动并再次确认。生成可批注地址优先用不改项目文件的临时链接方案;Figma 例外,最终链接只给原始 Figma URL 加绝对 projectPath。Annotation 环境需开启 Runtime 时读 axhub-annotation-standalone;外部 JSON 标注源放在当前 filePath 同目录并命名 annotation-source.json,单 HTML 页面则内嵌标注源并让 annotationSourcePath 指向该文件。AI 对话与批注执行读 references/ai-capabilities.md,支持范围以该文档和 ACP UI 当前配置为准。
限制:Commentary 的 AI 对话、AI 批注执行、provider session、宿主资源工具和本地标注源读写依赖 ACP UI,未确认 health 时不得宣称就绪;本地批注记录与 tweak 的读取回写、属性调整和页面内方案切换不依赖 ACP UI。批注处理成功后先写入 completed 并保留节点,再询问用户是否清除,确认后只写入删除标记,实际清理由扩展统一执行。属性调整与多方案比稿为低频按需能力,仅在用户明确要求时进入。具体供应商、CLI 与登录就绪情况、token 等凭据不在资料中提供,需以实际环境为准。