Skip to content

v0.5.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Aug 08:05
· 18 commits to main since this release
v0.5.0
59f2c7f

v0.5.0 — Tier-1 离线随包官方知识层 hms_knowledge

DSH 社区鸿蒙开发助手：新增离线随包的官方知识节选层——无 SDK、无 CLI、无网络，也能秒查高频 API 的人读官方文档。

新增 / Highlights

  • hms_knowledge 工具（共 19 个工具：12 个 hdc 设备工具 + 7 个 hms_ 工具）*
    • catalog：列出 20 个内置主题（模块/指南分类、起始 API 版本、标签、逐文件溯源 URL）
    • read：先目录后小节——按 ## 标题导航，按小节名或序号读指定小节（每节 24K 字符封顶，防爆上下文）
    • search：关键词同时匹配主题与章节标题，返回得分与命中标题
    • 离线可用：无需 DevEco Studio / SDK / devecocli / 网络；每次结果都带 CC-BY-4.0 署名
  • Tier-1 知识数据（约 1.2MB 随包内置）
    • 20 个高频主题逐字节选：16 个 API 模块（promptAction / router / notificationManager / vibrator / batteryInfo / deviceInfo / http / webSocket / preferences / emitter / process / url / util / UIAbility / abilityAccessCtrl / Context）+ 4 个应用模型与 ArkTS 指南（UIAbility 生命周期与用法、状态管理概述、创建自定义组件）
    • 来源：gitee.com/openharmony/docs master（commit b8477987，CC-BY-4.0）；knowledge/index.json 记录逐文件 sourceUrl / sha256 / since / tags，可审计可重放
  • 许可合规闭环
    • notices.json + THIRD_PARTY_NOTICES.md 新增 openharmony-docs-tier1 条目（现 8 notices）
    • license-check 门禁扩展：knowledge/ 的 meta.json 校验 + 逐文件 sha256 完整性校验 + 版权行搜索覆盖 lib/ 全域
    • scripts/build-knowledge.mjs 维护者工具：一键重新拉取并刷新知识层（记录上游 commit）
  • 技能升级：harmonyos-knowledge 技能新增查询速查——人读文档先 hms_knowledge（离线秒回）→ 机读版本判定 hms_api → 全量库 hms_docs

实测 / Verified

  • 冒烟：19 工具 + 3 技能注册；catalog / read（目录→小节）/ search 全动作离线 PASS
  • 真实 E2E（dsh --profile hdctest 无头实例，会话日志逐条核验 tool/call 与 tool/result）：
    • catalog 任务：模型正确汇报 20 主题，并推出最早起始 API 6 主题（batteryInfo / deviceInfo / http，并列 webSocket）
    • read/search 任务：目录 → 按小节读 showToast / ShowToastOptions → 搜索“振动”命中 vibrator；模型正确回答起始 API 9、message 必填，并主动带出 showToast 自 API 18 废弃 + 逐字引用与 CC-BY 署名
  • license-check PASS（8 notices，含 sha256 完整性）；npm pack 36 文件，压缩 212KB / 解压 1.4MB

环境要求 / Requirements

  • hms_knowledge 零环境依赖（离线随包）
  • 其余 hdc / hms_* 工具环境要求同 v0.4.0（本机 hdc；@deveco/deveco-cli 作为 optionalDependency 随装，失败容忍）

安装 / Install

dsh plugin --profile <name> add dsh-hdc-bridge
Assets 2
Loading