前言¶
在 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）。
