为 DeepSeek Harness 提供 HarmonyOS NEXT 离线技能包：3700+ 份 ArkTS/ArkUI/NDK 文档索引与 DevEco 模拟器、UI 体检、性能 trace 自动化脚本。
- 语言
- Python
- 分支
- master
安装
$ dsh plugin --profile web add github:linhay/harmony-next.skills在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 linhay/harmony-next.skills：先查看仓库 https://github.com/linhay/harmony-next.skills.git 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
harmony-next.skills 是 DeepSeek Harness 的官方 HarmonyOS NEXT 离线技能包，把 3700+ 份 ArkTS/ArkUI/NDK 文档、DevEco 工具链说明与一组可执行的 Python 自动化脚本打包成一个可在对话里即时召回的 skill，让 AI 在没有网络的情况下也能给出可验证的 HarmonyOS 答案。
核心能力
- 在 DSH 对话中注入
harmony-next技能，AI 按SKILL.md → KITS.md/TASK_MAP.md → INDEX.md的层级索引命中真实文档路径，再只读目标 1-3 个文件作答 - 覆盖 HarmonyOS API 12-23 的离线快照：
JsEtsAPIReference/下 3678 份 modules/topics/types/errors/guides 文档，加上 IDE 调试、签名、发布、多端适配、性能等专题 - 用 6 个 Python 脚本在命令行调用 DevEco 工具链：命令行工具下载安装、HDC 模拟器管理与启动、设备证据采集、单步 UI 操作、离线 UI/UX 体检、Profiler trace 离线分析
- 提供可复制粘贴的最小 HarmonyOS NEXT 测试工程
empty-ability-app模板，含 Smoke UI 与hdc + uitest验证路径 - 在脚本执行遇到环境缺失时返回结构化
blockedJSON（带decision/failureCode/missingConfig），便于 AI 判断降级到官方 CLI 而不是死循环
技术实现
- 语言: JavaScript (ESM) + Python 3
- 关键依赖: 仅依赖 Node.js 内置
node:fs、node:url（index.js）；脚本侧依赖 Python 3，可选cv2/numpy/PIL/requests/scipy/skimage/werkzeug/opencc用于 UI/UX 体检 - 架构模式: DSH profile bundle ——
package.json通过dsh.bundle.patch指向cordis.patch.yml，注入名为dsh-harmony-next的 provider；index.js的apply(ctx)在ctx.skills上注册一个返回harmony-nextSkill 定义的 provider - 入口文件:
index.js（DSH 侧钩子）+harmony-next/SKILL.md（技能正文与 frontmatter）
适用场景
需要让 AI 编程助手（DSH、Gemini CLI、Claude Code、Codex 等）回答 HarmonyOS NEXT 问题时，不再凭模型记忆瞎猜 @ohos.* 模块、ArkUI 组件或 DevEco 命令，而是在离线文档中查到证据后再作答。典型用户是正在做 ArkTS / ArkUI 业务开发、NDK 集成、模拟器自动化或 DevEco Studio 调试的工程师。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DeepSeek Harness | 0.1.0-rc.6+ | bundle 实机验证基于 @deepseek-ai/dsh@0.1.0-rc.6，由 docs/agent-portability.md:89 记录 |
| Node.js | 未声明 | 源码未声明 engines 字段；index.js 仅使用 node:fs/node:url 等内置模块 |
| Python | 3.x（推荐） | 6 个工具脚本是 Python 3 实现，使用者调用脚本时需要 |
| DevEco Studio | 与本地一致 | 仅模拟器/HDC/UI 自动化/Profiler 脚本路径依赖；纯文档查询不依赖 |
| 平台 | 跨平台 | bundle 本身跨平台；脚本已验证路径集中在 macOS，Windows/Linux 需自验 |
| 原生模块 | 无 | index.js 不依赖任何 native 模块 |
安装方式
dsh plugin --profile web add github:linhay/harmony-next.skills
配置项
本插件无需额外配置。
安装后 index.js 会从 harmony-next/SKILL.md 读取 description、metadata.version、whenToUse 等 frontmatter 字段，并以 bundled 来源、rank=600 注册到 DSH 的 ctx.skills provider 列表里；其中 disable-model-invocation 与 user-invocable 两个布尔字段也会按 frontmatter 自动解析（默认前者关闭、后者开启）。
常见问题
Q: 这个插件具体能干什么？
A: 它给 DSH 注入一个名为 harmony-next 的技能，进入对话后 AI 会按 SKILL.md → KITS/TASK_MAP → INDEX 的路径检索本地 3700+ 份 HarmonyOS 文档，并按需要调用 Python 脚本做 DevEco 模拟器启动、HDC 证据采集、UI/UX 体检、Profiler trace 审计。
Q: 安装之后为什么看不到新工具图标？
A: 正常。这个 bundle 只注册 Skill、不注册 MCP/tools/apps；用 / 命令或 skills list 应能看到 harmony-next 技能。
Q: 必须先装 DevEco Studio 才能用吗？
A: 查 API、写 ArkUI 组件、看 NDK 头文件这类纯文档场景不需要 DevEco；只要跑模拟器、HDC、UI 自动化、性能 trace 这些脚本时才依赖本机的 DevEco / Emulator / HDC。
Q: 文档数据和华为官网对不上怎么办？
A: bundle 内置的 references/ 是 API 12-23 的离线快照，不是实时拉取的；当用户问"最新版"或遇到新 API 时，skill 规则要求对比 GitHub Releases 并回查华为在线文档确认。
Q: 模拟器脚本在 Windows 或 Linux 上能用吗？
A: 脚本本身跨平台，但仓库已验证的 hvd_manager.py launch、device_evidence_bundle.py 路径主要在 macOS 的 DevEco 安装上跑通；Windows / Linux 需要自行验证 DevEco 安装路径、镜像根目录和 HDC 端口映射。
Q: bundle 大约占多少空间？
A: 仅 references/ 离线文档就约 54 MB，加上 10 个脚本和测试，整体远大于普通 skill 包；安装前请预留足够磁盘。
Q: 怎么卸载？
A: 和其他 profile bundle 一样，从 DSH profile 的 bundle layer 移除 dsh-harmony-next 即可；也可手动删除 ~/.dsh/skills/harmony-next/ 或 .dsh/skills/harmony-next/ 目录。
上手难度
入门 — bundle 安装即用，无需写任何配置或钩子；如果只用到文档检索，连脚本都不用碰；要跑模拟器或 trace 工具链才需要逐步配置本地 DevEco 环境。
已知问题与限制
- 离线文档与华为官网之间存在时延：内置
references/是 API 12-23 的快照，遇到"最新接口"或新增 API 必须回查官方在线文档（harmony-next/SKILL.md:18-20） - 模拟器镜像下载被刻意阻断：
hvd_manager.py download-image返回blocked，当前已验证路径仍是 DevEco Studio SDK Manager UI 操作（harmony-next/SKILL.md:88） - 首次启动 DevEco Emulator 需要在用户已阅读协议后用
--accept-license显式确认；脚本默认不会替你勾选（harmony-next/scripts/hvd_manager.py:670-671） - UI/UX 体检脚本对 Python 依赖较重：默认解释器缺少
cv2/numpy/PIL等模块时，脚本会通过missingConfig=["uxPythonDependencies"]直接报错而非降级（harmony-next/SKILL.md:72） - 涉及 DevEco 模拟器与 IDE 私有接口（CodeGenie、
devecostudio://、UxTestService、hdc/uitest自动化等）属于版本敏感能力，使用前必须重新确认插件 ID、路径、端口和参数；文档明确"不把私有接口包装成稳定公共 API"（harmony-next/SKILL.md:177-181）
🧰 HarmonyOS NEXT 开发者专家技能包
给 Gemini CLI、Claude Code、Codex 等 AI 编程助手使用的 HarmonyOS NEXT 离线参考技能库。
面向 API 12-23 的本地知识源，覆盖 ArkTS、ArkUI、NDK、工具链、调试、发布与多端适配。
🎯 解决的问题
AI 编程助手在 HarmonyOS 开发中经常碰到的几类问题：
- 找不到
@ohos.*模块的真实文档 - 不确定某个 ArkUI 组件或 NDK 头文件是否存在
- API 版本差异、新增内容未纳入知识库
- 旧文档链接失效或迁移
- DevEco Studio 模拟器、
hdc、uitest等本地自动化的验证路径不清晰
本仓库把这些不确定性变成可定位、可跳转、可验证的本地文件查询。
Before / After
没有 skill：模型凭记忆猜 @ohos.* 模块、ArkUI 组件名或 DevEco 命令，答案看起来合理但缺少来源。
使用本 skill：先按 SKILL.md → KITS.md / TASK_MAP.md → INDEX.md 命中文档路径，再打开目标 Markdown，最后给出代码片段和 hdc / uitest / wrapper 脚本验证命令。
✨ 核心特性
- 完全离线检索：不依赖模型记忆，先命中文档路径再读取正文
- 为 Agent 工作流设计：按
SKILL.md → KITS/TASK_MAP → INDEX层层递进检索 - 覆盖范围广：不只 API 手册，还包含 IDE、签名、调试、发布、性能、NDK 实战指引
- 私有能力隔离：DevEco 模拟器、IDE 未公开接口单独成章，默认先验证版本和风险
- 自动化优先：支持非交互式自动化策略，提供证据采集、UI/UX 离线体检、trace 审计等脚本
- 可运行的最小工程：提供
empty-ability-app模板，可直接复制用于 smoke 测试
📚 内容导览
| 入口 / 模块 | 用途 |
|---|---|
SKILL.md | 技能规则唯一来源：告诉 Agent 如何检索、哪些内容优先信文档 |
references/KITS.md | 按 Kit 导航（AbilityKit、ArkUI、ArkData…） |
references/TASK_MAP.md | 按任务反查（UI、网络、媒体、NDK…） |
references/INDEX.md | 全库文件索引（3,708 个 Markdown 路径） |
JsEtsAPIReference/INDEX.md | API 分桶索引（modules、topics、errors…） |
references/templates/empty-ability-app | 可复制的 HarmonyOS NEXT smoke fixture（最小工程） |
docs/agent-portability.md | Agent 安装与适配路径说明 |
harmony-next/references/ | 所有 Markdown 正文（含 3,678 个 API 文档） |
自动化与诊断脚本（按需使用）：
| 脚本 | 功能 | 入口命令示例 |
|---|---|---|
commandline_tools_manager.py | Command Line Tools 下载与安装 | python3 harmony-next/scripts/commandline_tools_manager.py install ... |
device_evidence_bundle.py | 设备证据采集与 WebView DevTools 转发诊断 | python3 harmony-next/scripts/device_evidence_bundle.py webview-devtools ... |
device_ui_action.py | 单次 UI 操作与前后证据采集 | python3 harmony-next/scripts/device_ui_action.py tap ... |
ux_audit_pipeline.py | 一键离线 UI/UX 体检 | python3 harmony-next/scripts/ux_audit_pipeline.py doctor ... |
profiler_trace_audit.py | 离线 Trace 性能审计 | python3 harmony-next/scripts/profiler_trace_audit.py audit ... |
hvd_manager.py | HVD 设备管理 | python3 harmony-next/scripts/hvd_manager.py doctor ... |
特殊领域文档：
DevEco模拟器私有接口与AI自动化.mdArkWeb WebView CDP调试与字段到达证明.mdDevEco Studio IDE私有接口与AI自动化.mdminimal-project-scaffold.md
🚀 快速接入
通用方式（推荐）
npx skills add linhay/harmony-next.skills
当前仓库只有一个 skill，直接运行上面的命令会自动安装 harmony-next。如果想先查看可用技能：
npx skills add linhay/harmony-next.skills --list
Gemini CLI
gemini skills install https://github.com/linhay/harmony-next.skills --path harmony-next --scope user
Claude Code
npx skills add linhay/harmony-next.skills --skill harmony-next -a claude-code -g -y --copy
或手动添加仓库目录：
git clone https://github.com/linhay/harmony-next.skills.git
claude --add-dir /path/to/harmony-next.skills/harmony-next
Codex
npx skills add linhay/harmony-next.skills --skill harmony-next -a codex -g -y --copy
本仓库当前还不是 Codex plugin；
npx skills只会把 skill 安装到 Codex 可扫描的 skill 目录，不会安装 MCP/tools/apps。
也可手动放入官方路径（常用如 $HOME/.agents/skills/harmony-next；完整路径见 docs/agent-portability.md）。
DeepSeek Harness（DSH）
本仓库提供官方 DSH profile bundle dsh-harmony-next。推荐通过 DSH profile 安装：
# 从 GitHub 安装
dsh plugin --profile demo add github:linhay/harmony-next.skills
# 或从本地 checkout 安装
dsh plugin --profile demo add /path/to/harmony-next.skills
# 检查 bundle layer
dsh --profile demo --dump-config
Bundle 只注册 harmony-next skill 及其离线参考资源，不安装 MCP、tools 或 apps。DSH bundle 的 manifest 是根目录的 package.json，patch 是 cordis.patch.yml。
如果只需要 filesystem skill，也可以手动安装到 DSH 的兼容根目录：
# DSH_SOURCE 指向本仓库的本地 checkout
DSH_SOURCE=/path/to/harmony-next.skills
# 项目级 skill
mkdir -p .dsh/skills/harmony-next
cp -R "$DSH_SOURCE/harmony-next/." .dsh/skills/harmony-next/
# 或用户级 skill（默认 ~/.dsh/skills）
mkdir -p "$HOME/.dsh/skills/harmony-next"
cp -R "$DSH_SOURCE/harmony-next/." "$HOME/.dsh/skills/harmony-next/"
DSH 也支持 .agents/skills、$DSH_AGENTS_HOME/skills 等兼容根目录；发现优先级和更新方式见 docs/agent-portability.md。
各 Host 只负责加载 skill；HarmonyOS 检索规则以 harmony-next/SKILL.md 为准。
🧭 推荐检索路径
SKILL.md → KITS.md / TASK_MAP.md → INDEX.md → 目标 Markdown
设计原则：先定规则，再按 Kit 或任务缩小范围，用索引命中真实路径，最后只打开 1-3 个文件读细节。
📦 适用场景
- ArkTS / ArkUI 开发：组件、装饰器、状态管理、UIAbility 等 API 确认与示例
- NDK / C API：头文件对应真实文档、跨语言调用、CMake 配置
- IDE / 工具链 / 调试：签名、模拟器、真机调试、性能分析与发布流程
- DevEco 模拟器自动化：免 IDE 启动、HVD、
hdc/uitest自动化、抓包诊断 - DevEco IDE 私有能力：CodeGenie、ArkUI Inspector、离线 trace 审计、UI/UX 体检
- Agent 工程化集成：作为 Gemini CLI、Claude Code、Codex 的本地知识检索层
⚠️ 安全边界：私有接口与本地自动化
涉及 DevEco 模拟器、IDE 私有接口、设备日志、截图、抓包、HVD 创建/删除等操作时，必须先阅读对应的私有接口文档。这些流程要求：
- 执行前验证 DevEco / Emulator / SDK 版本和命令能力
- 明确产物目录、脱敏边界和失败时的
blocked输出 - 非交互模式下的执行策略、超时与脱敏契约
私有接口文档入口：
展开：模拟器/IDE 私有接口使用规则摘要
DevEco 模拟器私有接口 触发词：DevEco Studio、HarmonyOS Emulator、免 IDE 启动、HVD、hdc、uitest、aa、bm、snapshot_display 等。
规则：先读 SKILL.md 的私有接口章节，每次执行前重新验证版本和能力；在用户已授权的本地环境内，自动化策略用于描述执行模式、产物目录和脱敏契约；wrapper 脚本阻塞时建议先尝试官方 CLI 路径采集证据。
DevEco Studio IDE 私有接口 触发词：CodeGenie、MCP、devecostudio://、inspect.sh、ArkUI Inspector、Profiler、UxTestService 等。
规则：默认只做静态只读分析（插件 XML、jar、配置、离线 trace 等）；启动 IDE/GUI、本地服务、设备连接、MCP 配置等需记录目标、产物和脱敏边界；离线 trace 审计和 UI/UX 体检只使用已验证的 wrapper 脚本和规则子集。
完整细节请务必查阅上述两份文档。
📈 版本重点
| 版本 | 关键更新 |
|---|---|
v1.3.35 | 增加 DeepSeek Harness（DSH）官方 profile bundle 与 filesystem skill fallback 适配 |
v1.3.30 | 模拟器应用沙箱速查与 HVD doctor 的 DevEco Emulator 优先级修正 |
Unreleased | 一键离线 UI/UX 体检 CLI（ux_audit_pipeline.py） |
Unreleased | 设备调试证据包 CLI（device_evidence_bundle.py） |
Unreleased | 离线 Trace 性能审计 CLI（profiler_trace_audit.py） |
Unreleased | HVD launch 改进：trace socket 守护、镜像校验、许可协议处理 |
Unreleased | WebView DevTools 诊断、CDP 字段证明、单次 UI 操作证据与 Emulator 崩溃分类 |
v1.3.23 | Release workflow 更新到 Node 24 |
v1.3.7 | 新增可复制最小测试工程模板；SDK 版本适配验证（含 6.0.2(22)）；uitest smoke |
v1.3.6 | 模拟器非交互自动化策略 |
v1.3.5 | DevEco Studio IDE 私有接口参考 |
v1.2.0 | API 23 纳入；索引重建；链接兼容审计 |
🔧 维护与贡献
参考库更新后运行校验：
python3 harmony-next/scripts/check_packaging_docs.py
python3 harmony-next/scripts/reference_compat.py generate
python3 harmony-next/scripts/reference_compat.py check
python3 harmony-next/scripts/reference_compat.py audit
python3 -m unittest discover -s harmony-next/tests -p 'test_*.py' -v
📜 来源与许可
- 数据源：华为 HarmonyOS 官方文档
- 本仓库为 AI 辅助开发重新封装，英文说明见 README_en.md
感谢 LINUX DO 的支持。
收录徽章
[](https://deepseek-plugin.org/plugins/linhay/harmony-next.skills)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。