用途:当标注原型 URL 暴露了 PRD、目录、标注或源码上下文时,供 AI Agent 在评审、实现规划等后续工作前读取已发布的上下文,理解页面结构。
主要能力:读取 source.directory 得到目录/PRD 大纲;提取 type 为 markdown 的目录节点中的 Markdown 或 PRD 条目;统计标注数量并报告重要节点字段,如 id、title、pageId、locator、annotationText、aiPrompt、color、controls;在存在 source.source 时报告 root 与 manifest,需要时通过 root 读取 manifest 及相关文件;通过 images.length 判断是否附带图片,未获用户要求不下载图片。
使用方式:用 Playwright、Browser、Chrome 或可执行页面 JavaScript 的等效工具打开指定标注原型 URL;等待应用渲染后短暂轮询 window.AXHUB_ANNOTATION_SOURCE;求值并返回该值,不修改对象、不写回 window。最小求值示例:await page.waitForFunction(() => window.AXHUB_ANNOTATION_SOURCE, { timeout: 10000 }); const source = await page.evaluate(() => window.AXHUB_ANNOTATION_SOURCE); 若值缺失,报告 URL、页面标题、相关控制台错误,并说明未发布标注原型上下文快照。若用户要求向 Axhub Make 提交评审报告,读取 references/review-report-submission.md。
数据形状:AnnotationSourceRuntimeSnapshot 含 directory(AnnotationDirectory 或 null)、nodes(AnnotationNode 数组)、可选 source(含 root、manifest)。directory.nodes 为原型树,节点类型有 folder、route、link、markdown。nodes 是完整标注列表,与当前页面、选中状态和颜色筛选无关。每个标注节点含 id、index、可选 title、可选 pageId、locator、aiPrompt、annotationText、hasMarkdown、color、images、可选 controls、createdAt、updatedAt。source 仅作源码发现参考;在包含源码的 HTML 中,manifest 指向 source/manifest.json,其路径相对 source.root 解析。
限制:页面默认只读,除非用户要求提交评审报告;不修改返回对象;不主动下载图片;缺失快照时只能报告错误信息,无法提供上下文。