SuperAPI AI 工具集

harmonyos-official-docs

写作与研究

查看项目

更新于 10-16 05:48

技能介绍

用途:当需要从 developer.huawei.com 查阅 HarmonyOS/鸿蒙的开发指南、API 参考、版本说明等官方文档时使用。文档站为 Angular SPA,页面 HTML 不含正文,代理不预设任何 URL,须通过 REST API 自行检索定位文档,技术细节见 reference.md。

主要能力与工作流:

  1. 分析问题,提取关键词与内容类型(概念/步骤为指南,接口/组件为 API 参考,版本变更为版本说明)。
  2. 选择 catalog:开发指南、场景指导用 harmonyos-guides;API/组件/Kit 接口用 harmonyos-references;版本新增与变更用 harmonyos-releases。不确定时并行查询 harmonyos-guides 与 harmonyos-references。
  3. 对选定 catalog 调用 getCatalogTree(catalogName 与 objectId 均设为 catalog 根名)。
  4. 用 search_nodes 按关键词匹配节点的 nodeName 与 relateDocument。无匹配时换 catalog、拆分或放宽关键词重试;多个匹配时优先标题吻合度高的,概念问题优先 guides,接口问题优先 references;命中含 children 的目录节点先拉取其文档作索引,再对其子节点继续检索或拉取。
  5. 对目标节点的 relateDocument 调用 getDocumentById,用 extract_html 解析 content。content 为空说明该节点可能是纯目录,改拉其子节点;信息不足则补充拉取相关兄弟或父节点。
  6. 回答时附来源链接:{DOC}/{catalogName}/{relateDocument}。

用户提供文档 URL 时:按 reference.md § URL 解析提取 catalogName 与 slug,跳到步骤 5。

限制与约束:禁止对文档页面 URL 使用 WebFetch 或直接 curl HTML;遇 403/429 按 reference.md § 错误处理降速重试;接口非正式公开,无法确认时告知用户。