前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。當智能體完成一個任務後，需要一種方式將結果通知給用戶。原生推送通常不夠直觀，而直接訪問手機系統的 API 開發成本較高。這個插件解決了從 DSH 代理向華爲 HarmonyOS 負一屏（智慧助手·今天）推送任務完成消息的需求。
是什麼¶
這是一個將任務完成消息推送到華爲 HarmonyOS 負一屏服務卡片的 DSH 插件。它線纜兼容 OpenClaw today-task 技能（相同的上傳端點和負載契約），意味着兩者使用相同的認證方式和卡片渲染規則。插件本身不提供客戶端 UI，也不依賴額外的運行時庫，直接使用 Node.js 內置的 fetch 進行 HTTP 通信。
安裝¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:Entity-Him/dsh-hiboard-push
安裝完成後，重啓 dsh 進程以加載插件。
配置¶
使用前需要在 HarmonyOS 手機端獲取並配置授權碼。
-
獲取 authCode
- 在手機上打開負一屏（智慧助手·今天）。
- 進入「我的」→「動態管理」→「關聯賬號」→「Claw 智能體」。
- 獲取並複製授權碼（例如uhIzvTvjwnAD）。 -
配置授權碼
使用提供的命令將授權碼寫入配置文件：
dsh-hiboard-auth your-auth-code
該命令會將授權碼寫入 ~/.dsh/hiboard-auth.env（文件權限爲 600，隱藏），並確保 dsh 進程每次啓動時都能讀取到該憑證。
- 重啓服務
執行完配置命令後，重啓 dsh 以使設置生效。
核心功能¶
插件註冊了兩個工具供智能體調用。
hiboard_push¶
用於推送任務卡片。參數說明如下：
| 參數 | 必需 | 說明 |
|---|---|---|
name |
✅ | 任務名稱，作爲卡片標題、scheduleTaskName 和 summary。 |
content |
✅ | Markdown 格式的正文內容（≤ 5000 字符），將原樣渲染在卡片上。 |
result |
❌ | 結果摘要/狀態標籤，默認爲 任務已完成。 |
schedule_id |
❌ | 週期性任務 ID，保持相同的 ID 可將重複卡片聚合。 |
dry_run |
❌ | 布爾值，設爲 true 時僅構建和驗證載荷，不發送實際卡片。 |
hiboard_verify¶
用於測試連接。調用此工具會在手機負一屏收到一張“dsh 連接測試”卡片，用於驗證 authCode 和網絡鏈路是否通暢。
注意事項¶
- 安全風險：authCode 是個人憑證，持有該碼的任何人都可以向你的負一屏推送卡片。切勿將其粘貼到羣聊或提交到代碼倉庫。
- 兼容性：由於使用與 OpenClaw 相同的端點，如果你之前配置過 OpenClaw，可以直接複用其 authCode。
- 存儲位置：授權碼僅存儲在本地文件
~/.dsh/hiboard-auth.env中。
