前言¶
在 Harness 里写鸿蒙（HarmonyOS）应用时，常见做法是反复打开官方文档、自行整理组件用法和设计规范，再在对话里粘贴片段。信息分散、版本口径不统一，静态规则也很难和模型输出对齐。
dsh-harmony-dev（鸿蒙开发台·全量版）由维护者 zixiaog 发布，分类为客户端插件。它把规范卡片、可执行校验规则、代码生成和华为官方知识库检索装进 DeepSeek Harness：Host 侧 5 个工具供模型调用，Client 侧提供「鸿蒙开发台」整页面板。下面介绍其定位、能力与安装验证方式。
这是什么¶
插件 npm 包名为 dsh-harmony-dev，当前 latest 版本为 0.1.1（MIT 许可证，要求 Node >= 20）。仓库与文档入口：
- 目录页：https://www.skillhub.cn/plugins/zixiaog/dsh-harmony-dev
- GitHub：https://github.com/zixiaog/dsh-harmony-dev
README 给出的内容规模为：366 条内容、5 个 Host 工具、22 条可执行规则（规则集共 34 条）、官方知识库 MCP 通道，以及内嵌全量数据的内容面板。数据侧包括 40 张组件卡、60 条设计规范、200 张 API 卡、46 讲课程、20 个示例等；281/366 张卡片带有 sources 出处标注。
核心能力¶
Host 工具（5 个）¶
| 工具 | 作用（据 README） |
|---|---|
harmony_search |
检索卡片、规则，并可返回官方文档片段 |
harmony_get |
按引用拉取规则、设计 token、版本差异等 |
harmony_build |
生成 tokens / scaffold / page，并带自查 |
harmony_check |
静态评审、迁移、无障碍、一多、版本、上架等检测 |
harmony_create |
落盘生成可打开的 Stage 工程骨架（empty/tabs/list/settings，约 20 个文件） |
harmony_create 经 README 记载：harmony_check 可对生成结果判定 pass。官方知识库通过内置最小 JSON-RPC MCP 客户端访问；端点异常时会降级并在 warnings 中说明。
Client 面板¶
左侧栏出现「鸿蒙开发台」入口，主区域为五 Tab：token / 规则 / 内容库 / 示例 / 版本。面板数据全量内嵌（README 记载 346 卡 + 34 规则 + 20 示例等构建产物），支持基线切换、复制代码与官方目录分类。
校验与版本¶
harmony_check 覆盖 review（静态规则）、migrate（V1→V2）、a11y、one_multi、version、release 等方向；34 条规则中 22 条可执行。版本能力包括 14 个版本、9 条 apidiff，以及版本归一化与基线过滤（例如对 harmony_search 指定 targetApi 时过滤高于基线的 API 卡）。
安装与启用¶
插件以 Harness 进程权限运行；安装前请查看仓库源码与 MIT 许可证。安装会直接使用仓库内已提交的 data/*.json、client.js，不执行构建脚本，README 记载首次安装约 15 秒（下载 npm 包）。
方式 1：GitHub 仓库地址¶
在 Harness「插件」→「添加插件」中填写：
https://github.com/zixiaog/dsh-harmony-dev
或命令行：
dsh plugin add https://github.com/zixiaog/dsh-harmony-dev
方式 2：npm 包名¶
在「添加插件」中填写：
dsh-harmony-dev
包发布于 https://www.npmjs.com/package/dsh-harmony-dev。
方式 3：本地绝对目录¶
通过 plugin_manager 安装 bundle，目标为工作区内插件目录的绝对路径（README 示例形式）：
plugin_manager install_bundle target = <workspace>/dsh-harmony-dev
新装可经 HMR 热生效；替换同名包需重启宿主。不要手抄进 node_modules。
安装后快速验证¶
- 模型工具表出现
harmony_search/harmony_get/harmony_build/harmony_create/harmony_check。 - 左侧栏出现「鸿蒙开发台」图标，点开为五 Tab 面板。
- 对模型说「用 harmony_search 查一下列表懒加载」，应返回卡片、规则及官方片段（首次官方通道可能较慢）。
典型用法¶
以下参数形态来自 README「装完怎么验」一节，便于在对话或工具调用中复现。
检索与精读：
harmony_search {query:"列表 懒加载"}
harmony_get {ref:"R003"}
harmony_get {ref:"Title_L"}
harmony_get {ref:"24→26", kind:"version"}
harmony_search {query:"列表", targetApi:"API 6"}
生成与自查：
harmony_build {action:"tokens"}
harmony_build {action:"page", name:"DetailPage", layout:"settings"}
harmony_check {action:"review", code:"..."}
harmony_check {action:"version", from:"6.1.1(24)", to:"26.0.0"}
工程骨架：
harmony_create {name:"DemoApp", template:"tabs"}
默认输出目录为宿主进程 cwd（profile 目录）下的 harmony-projects/，README 建议显式传 path 到你的工程目录。生成后可用 DevEco 打开、Sync、签名并运行。
官方文档通道：
harmony_search {query:"List 滑动删除 swipeAction"}
返回中 data.official.docs 应为官方文档片段；MCP 配假端点或断网时应出现降级告警。
适用场景与注意¶
适合： 在 Harness 内做 ArkTS / ArkUI 开发、查组件与设计规范、做静态规则评审、对比 API 版本差异、快速搭 Stage 骨架的团队或个人。
已知限制（README 原文要点）：
- 官方 MCP 通道首次调用较慢（默认超时 12s），失败会熔断 60s 并降级本地快照。
- 部分 API 卡的
since仍待校准；32 张 API 卡未匹配到官方出处。 - 34 条规则中 12 条为人工清单项，不可自动执行。
- 20 个示例为可读文件，未在 DevEco 编译验证；
harmony_create不编译、不签名、不上架。
维护者还在 README 中记录了函数式插件导出 name、本地 Junction 安装勿依赖 import('@deepseek-ai/cordis') 等接入踩坑，二次开发同类插件时可对照仓库 docs/架构与接入.md。
结尾¶
dsh-harmony-dev 把鸿蒙开发的检索、规范、校验、生成和官方文档通道收敛到 Harness 插件形态，减少在文档站与 IDE 之间来回切换。社区目录页见 https://www.skillhub.cn/plugins/zixiaog/dsh-harmony-dev，源码与使用手册见 https://github.com/zixiaog/dsh-harmony-dev（docs/使用手册.md）。
