它是什么
HarmonyOS NEXT Skills 是一个离线的文档与自动化资料库，为 AI 编程助手提供鸿蒙 NEXT 开发的本地事实来源——让回答来自磁盘上的文件，而不是模型的记忆。它面向多个 agent（README 覆盖了 Gemini CLI、Claude Code、Codex 与 DSH），在 DeepSeek Harness 上则以 filesystem skill 的形态安装：一份 SKILL.md 规则文件、一棵庞大的 references/ 文档树和若干 Python 辅助脚本，通过一个 Cordis bundle patch 接入。
安装之前先把预期摆正：README 明确说这个 bundle 不安装 MCP、tools 或 apps，仓库目前也不是 Codex plugin。agent 得到的是一条文档化的检索路径——SKILL.md → KITS.md / TASK_MAP.md → INDEX.md → 目标文档——作用于一份本地的 API 资料拷贝。
资料库里有什么
- API 参考——ArkTS、ArkUI 与系统模块，按「确认 API 版本」的用法组织，
JsEtsAPIReference下有逐版本索引。 - API 26 快照——API 26.0.0 的声明、类型与签名；
v1.3.37是纳入这份快照的发布。README 说明快照可以用sync_api26_snapshot.py从更新版本的 DevEco Studio 重新生成。 - Kit 与任务导航——
KITS.md与TASK_MAP.md按 Kit 或按任务定位文档。 - DevEco / 模拟器自动化——HVD、
hdc、uitest、抓包与诊断，包括一篇 DevEco 模拟器私有接口与 AI 自动化的文档。README 提醒：私有接口工作流必须先读对应文档，并明确产物目录、脱敏边界与非交互模式。 - 最小工程模板——
empty-ability-app，一个用于构建与 smoke 测试的 Empty Ability 工程。 - 自动化脚本——
scripts/下的 Python 辅助，覆盖设备证据、UI/UX、Trace 与命令行工作，外加维护者在发布前运行的打包与参考一致性检查。
运行要求
- DSH 安装走的是 GitHub 依赖，不是 npm 包：仓库内清单名为
dsh-harmony-next（v1.3.37），来源中没有任何一处提到 npm 发布。 - 清单没有
engines、没有依赖、也没有scripts块——因此没有安装期生命周期脚本，安装时除了解包文件与应用cordis.patch.yml之外不会执行任何代码。 - 辅助脚本是 Python 3；重新生成 API 26 快照还需要本机装有 DevEco Studio。而资料库最主要的用法——读文档——除了文件本身什么都不需要。
- 清单没有 client 块：这个 bundle 不会给 DSH 增加任何 Web 界面、面板或设置页。
- Harness 版本支持、权限与遥测均未文档化：没有
dsh.compatibility声明，README 也没有关于受支持 DSH 版本的表述。请按「未说明」理解，而不是按「安全」理解。
许可证：这一段请读两遍
有两个事实要放在一起看。package.json 声明 MIT，README 的许可证一节也写着「MIT」——但 GitHub 仓库没有可被 GitHub 识别的许可证文件，因此这份授权只靠这两处声明支撑。更重要的是，README 明确写道：文档内容来自华为 HarmonyOS 官方资料，版权归原作者所有。MIT 声明覆盖的是打包方式，它无法重新授权华为的文档。请把这份参考树当作转手的厂商文档来对待；超出本地参考范围的复用，先查华为的条款。
已知限制
- 它是快照，不是活源：API 覆盖面固定在打包声明所捕获的内容——
v1.3.37时最新为 26.0.0。新鲜度取决于维护者是否跟随 DevEco Studio 的发布重新生成快照。 - 声明之外的内容——官方 guide、示例与差异说明——README 自述「持续补充」，请按「尚不完备」理解。
- 没有 MCP 或工具集成：agent 读的是文件，上面没有结构化查询层。
- README 以中文为主、附英文版；参考内容本身是华为的（以中文为主的）文档。
什么时候用它、什么时候不要用
当你用 agent 写 HarmonyOS NEXT 代码、希望回答锚定在本地 API 声明上时用它——尤其适合 ArkTS/ArkUI 开发、API 版本确认，以及 DevEco 模拟器自动化这类幻觉签名最常出问题的场景。离线也意味着整份语料不需要网络、不需要 API key。
不要拿它回答应用市场的政策、账号或上架问题——这是开发者参考资料，不是政策来源。如果你的工作面向打包快照之外的 API 版本，请改为核对华为的在线文档，而不是本地拷贝。
安装
dsh plugin --profile web add github:linhay/harmony-next.skills本站以 web profile 为标准；README 自己的 DSH 安装行用的是 --profile demo，github: 规格相同——换成你实际使用的 profile 即可。其他 agent 在 README 里有各自的命令：Gemini CLI 用 gemini skills install，Claude Code 与 Codex 各有 npx skills add 变体。