SuperAPI AI 工具集

extract-annotation-source

写作与研究

查看项目

更新于 10-16 00:00

技能介绍

用途:当需要从 Axhub 原型 URL 读取 PRD、目录或标注上下文时,使用本技能从运行时快照 window.AXHUB_ANNOTATION_SOURCE 中提取信息,尤其适用于“原型即 PRD”的场景。

主要能力:可获取 source.directory 中的目录/PRD 大纲,以及 directory 节点中 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 解析。

限制:页面必须为只读操作;不修改快照对象或回写 window;不主动下载图片;若快照未发布则无法提取,只能报告缺失情况。