前言¶
DeepSeek Harness (DSH) 的插件化架構允許智能體擴展功能，調用外部服務。對於需要將執行結果實時同步到手機的用戶來說，將消息推送到華爲負一屏（“Today” / 智慧助手·今天）是一個典型需求。此插件通過 DSH 代理將任務完成消息轉化爲負一屏的服務卡片，解決了智能體與手機端信息同步的問題。
插件簡介¶
這是 entity-him/dsh-hiboard-push 插件。它用於從 DeepSeek Harness (DSH) 代理向華爲 HarmonyOS 負一屏推送任務完成消息作爲服務卡片。該插件與 OpenClaw 的 today-task 技能 wire 兼容，使用相同的上傳端點、載荷協議和卡片渲染規則，因此複用相同的 authCode 即可。
安裝¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:Entity-Him/dsh-hiboard-push
配置連接¶
插件使用華爲負一屏的 authCode 進行身份驗證。配置步驟如下：
-
在手機上獲取
authCode：
- 打開負一屏（assistant-today）。
- 進入“我的” → “動態管理” → “關聯賬號” → “Claw 智能體”。
- 複製顯示的授權代碼。 -
在終端中配置該代碼：
dsh-hiboard-auth your-auth-code
該命令會將代碼寫入 ~/.dsh/hiboard-auth.env（文件權限爲 600）。
或者，直接設置環境變量：
export DSH_HIBOARD_AUTH_CODE=your-auth-code
配置後需重啓 DSH 進程以生效。
核心功能¶
插件註冊了兩個工具，用於發送卡片和驗證連接。
hiboard_push¶
該工具用於構建併發送任務卡片。參數說明如下：
| 參數 | 必填 | 描述 |
|---|---|---|
name |
✅ | 任務名稱，作爲卡片標題、scheduleTaskName 和 summary。 |
content |
✅ | Markdown 格式的正文內容（≤ 5000 字符），將原樣渲染在卡片上。 |
result |
❌ | 結果摘要/狀態標籤，默認爲“任務已完成”。 |
schedule_id |
❌ | 週期任務 ID，保持相同 ID 可將重複卡片歸類。 |
dry_run |
❌ | 模擬構建並驗證載荷，不發送消息（無需 authCode）。 |
卡片樣式根據參數填充情況變化：
* 標準任務卡片：包含 name、content、result。
* 週期任務卡片：在標準卡片基礎上包含 schedule_id。
* 僅摘要卡片：僅包含 name 和 result，不含 content。
hiboard_verify¶
該工具用於端到端的連接測試，發送一張名爲“dsh 連接測試”的卡片，用於確認 authCode 和網絡路徑有效。
典型用法¶
- 連接測試：在 DSH 聊天中調用工具驗證配置：
call hiboard_verify
如果手機收到“dsh 連接測試”卡片，說明配置成功。
- 任務推送：在智能體邏輯中調用
hiboard_push。
call hiboard_push with name="代碼審查", content="# 審查結果\n通過", result="已完成"
此後，卡片會出現在手機的負一屏卡片流中。
注意事項¶
- 憑證安全：
authCode是個人憑證，持有該代碼的人可以向你的負一屏推送卡片。請勿將其粘貼到羣聊或提交到代碼倉庫。 - Markdown 限制：
content字段的 Markdown 內容長度不能超過 5000 字符。 - 運行權限：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證（MIT）。
- 依賴：插件不包含客戶端 UI，底層使用 Node.js 內置的
fetch進行 HTTP 通信。
總結¶
該插件爲 DSH 代理提供了一個直接將任務結果推送到華爲負一屏的途徑。通過 hiboard_push 和 hiboard_verify 工具，開發者可以方便地實現任務狀態的可視化通知。更多細節可參考 GitHub 倉庫。
