前言¶
在 DSH 裏讓執行 Agent 自己寫代碼、自己跑構建、自己說「完成了」,編排側往往缺少可執行的驗收閘門:任務邊界模糊、派發前沒有結構化質詢、交付後仍採信執行者的自述。HarmonyOS 場景下常見協作是 DSH 編排加 DevEco Code 落地,若仍只靠一份提示詞文檔串聯,很難把「做完」的定義、派發前審查和獨立取證固化成工程動作。
下面介紹的 DwGuard-Dsh-Hmos(npm 包名 dwguard-dsh-hmos)由社區維護者 Dogwind221 發佈,在 SkillHub 社區目錄中歸類爲工作流插件。它把上述協作收成一組有閘門的步驟:任務包凍結、對抗預審、Goal 派發、四維外部審計、返工與知識沉澱。核心主張在 README 裏寫得很直接:交付物必須自己證明自己,DSH 不採信執行者的自述結論。
這是什麼¶
DwGuard-Dsh-Hmos 是跑在 DeepSeek Harness(DSH)側的插件,面向 DSH 編排 + DevEco Code 執行 的雙 Agent 鴻蒙開發閉環。它不是替代 DevEco 寫 ArkTS,而是在 DSH 裏註冊工具、Skill 與可選 UI(右側欄 DshHoms 看板),用產物目錄(如 .shared/、artifacts/)推導當前階段,而不是口頭報階段。
- 維護者與源碼:Dogwind221/dwguard-dsh-hmos
- 社區目錄頁:SkillHub 插件頁
- 許可證:MIT(以倉庫 LICENSE 爲準)
- npm 當前版本:0.6.6(資料截取時)
核心功能¶
資料中的架構可以概括爲「規劃 → 執行 → 驗收」三條線,並與文檔裏的四個增量一一對應。
任務包凍結(dwguard_spec)¶
先把「做完」寫清楚:功能、審美、性能、無障礙四維判據,每條需可證僞、有獨立驗證方式;寫不出來則不允許進入派發。對應流程裏的 凍結任務包 節點。
派發前對抗預審(dwguard_prereview)¶
從性能、生命週期、併發、API 兼容四個視角質詢任務包;阻斷項必須經歷一次反駁(rebuttal),未關閉不得派發。預審不通過會回到任務包生成。
Goal 模式派發(dwguard_dispatch)¶
預審通過後生成 Goal 簡報,交給 DevEco 側執行閉環:理解任務包 → 編碼 → 構建 → 推設備 → 自驗。
自評與澄清閘門¶
DevEco 自評達標只是聲明,不是交付。雙方無異議才進入外部審計;實現層分歧回到編碼實現(返工單 tasks/rework-n.md);任務包層分歧停線改包、升版本並重跑預審,執行者重新理解任務包。增量② 影子審查在編碼期只讀巡檢,結構性風險先落到該閘門再決定回哪一層。
四維外部審計(dwguard_audit)¶
不採信自驗:截圖、佈局樹、日誌、測量值等,一條判據一段證據;四維須覆蓋,must 判據缺證據則閘門不開。README 說明四維各派一個子代理並行取證,進度可反映在 artifacts/audit-progress.json。
返工、驗收與沉澱¶
審計未通過走返工再進執行環;通過後產出 artifacts/acceptance-report.md 驗收報告,再由 dwguard_knowledge 按主題歸檔經驗。dwguard_status 彙總階段、未讀交付與下一步。
裝好後新會話會拿到 15 個工具、3 個 skill 及策略提示詞;對 DSH 說「給鴻蒙做個 XX 頁面」時會加載 dwguard-hmos skill(以 README 描述爲準)。
安裝與啓用¶
環境要求(來自 package.json / README):
- DSH:
>=0.2.1-rc.0且<0.3.0 - Node:
>=20 - 插件以 bundle 形式安裝並向 profile 註冊 host;不要用
npm install代替 DSH 插件安裝器(那樣只會進node_modules,不會註冊 profile)。
profile 與入口(兩種裝法不要混用):
| 啓動方式 | profile | 安裝入口 |
|---|---|---|
| 桌面應用(默認) | desktop |
側欄 插件 → 添加插件(命令行無法改 desktop profile) |
CLI:dsh web / tui / headless 等 |
web / tui / … |
dsh plugin --profile <name> add … |
從 npm 安裝(推薦)
桌面版:
- 左側 插件 → 添加插件
- 包名填
dwguard-dsh-hmos或固定版本dwguard-dsh-hmos@0.6.6 - 安裝後按提示重啓(含托盤退出)
命令行 profile(示例爲 web):
dsh plugin --profile web add dwguard-dsh-hmos@0.6.6
機器上沒有 dsh 命令時:
npx @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile web add dwguard-dsh-hmos@0.6.6
CLI 也可從 GitHub 或本地目錄安裝(僅命令行 profile):
dsh plugin --profile web add https://github.com/Dogwind221/dwguard-dsh-hmos
確認安裝
- 桌面版:插件頁出現
DwGuard-Dsh-Hmos - CLI:
dsh --profile web --dump-config中可見# == dwguard-dsh-hmos
可選預設:倉庫內 preset/dwguard-hmos.cordis.yml 可在新會話選擇器增加「DwGuard 鴻蒙雙代理」入口;不裝預設時工具仍可用。
卸載:桌面版在已安裝插件中移除;CLI 執行 dsh plugin --profile web remove dwguard-dsh-hmos(profile 名換成你的實際 profile)。
典型用法¶
- 按上文裝好插件並新開一個會話(舊會話可能未熱加載工具表)。
- 用自然語言提出鴻蒙界面或能力需求,例如讓 DSH「給鴻蒙做個 XX 頁面」——會走
dwguard-hmosskill 所描述的多階段流程,而不是單次對話裏直接宣稱完成。 - 在桌面 Web 客戶端打開側欄 DshHoms(位於「插件」與「自動化任務」之間):右側欄標籤頁展示規劃 / 執行 / 驗收流程圖;階段由
.shared/等產物推導。README 註明需先跑一次任意 DwGuard 工具,看板的工作區列表纔會寫入~/.dsh/dwguard/workspaces.json並可選。 - DevEco 側按派發的 Goal 與任務包實現;自評與澄清通過後,等待 DSH 側 dwguard_audit 獨立取證;未過則按返工單修改後重跑執行與審計環。
- 需要只看編排與取證、少碰實現類工具時,可選用
preset/dwguard-hmos.cordis.yml疊加啓動或寫入cordis.patch.yml(詳見 README)。
只讀看板數據來自同源接口 GET /dwguard/board(無寫入、cache-control: no-store)。
適用場景與注意¶
適合誰
- 已在用 DSH 做需求編排、用 DevEco Code 寫 HarmonyOS / ArkTS,並希望把任務包、預審、四維驗收寫成可重複工程動作的團隊或個人。
- 需要「外部審計不採信自驗」、返工與驗收報告落盤到
artifacts/的流程控場場景。
使用前請注意
- 插件在當前 DSH 進程的權限下運行,會讀寫工作區與
~/.dsh/dwguard/等路徑;安裝前請自行審閱 GitHub 源碼 與 MIT 許可證。 - DSH 生態是「一切皆插件」;SkillHub 爲社區目錄,與 DeepSeek / 幻方無官方從屬關係,本文不構成安全或合規背書。
- 依賴 DSH 0.2.1-rc.x 與文檔中的 peer 版本;升級 DSH 或插件前對照 README / CHANGELOG。
- 兩個迴環不要混:實現層問題回編碼;任務包層問題改 Spec 並重跑預審。
結尾¶
DwGuard-Dsh-Hmos 把鴻蒙雙 Agent 協作從「提示詞約定」推進到「任務包凍結 → 對抗預審 → Goal 派發 → 四維取證審計 → 返工 / 驗收報告 → 知識沉澱」的可執行閉環,並在 DshHoms 看板裏用產物驅動階段展示。若你要在 DSH 裏系統化管住 DevEco 交付質量,可從 npm 包 dwguard-dsh-hmos@0.6.6 或社區目錄頁安裝,並對照倉庫 README 與英文版 README.en.md 繼續跟版本。
- 目錄頁:https://www.skillhub.cn/plugins/Dogwind221/dwguard-dsh-hmos
- GitHub:https://github.com/Dogwind221/dwguard-dsh-hmos