dsh-xiaoyi: 連接華爲小藝 OpenClaw 模式到本地 DSH 會話的插件

前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。開發者在使用 DSH 時，往往需要將本地的智能體會話與外部服務打通。dsh-xiaoyi 是一款 DSH 宿主端插件，它將華爲小藝（XiaoYi）的 OpenClaw 模式接入本地 DSH 會話，讓手機端發送的語音、文本和圖片直接流轉到運行在你本地機器上的智能體中。

插件定位¶

名稱：dsh-xiaoyi
類型：DSH 宿主端插件
維護者：HangZhouXi
許可證：MIT
功能：在本地 DSH 會話與華爲雲小藝 OpenClaw 服務之間建立連接。

核心功能¶

該插件主要實現以下能力：

零第三方依賴：僅使用 Node.js 內置模塊，包含一個手寫的最小化 RFC6455 WebSocket 客戶端，處理文本幀、分片重組、心跳檢測及握手驗證。
協議完整實現：支持鑑權簽名、握手、心跳檢測（含連接失效檢測）以及 JSON-RPC 2.0 流式傳輸。
入站附件處理：支持接收來自小藝的圖片和文件，下載至本地並傳遞給 DSH 會話。
會話複用：在冷啓動時複用現有會話，避免每次都開啓新對話。
出站在線文件（實驗性）：支持將本地文件發送回小藝（協議僅支持公網 HTTPS URL，可靠性需謹慎對待）。

安裝與配置¶

環境要求¶

在安裝前，請確認滿足以下條件：

DSH 宿主：這是宿主端插件，必須在 DSH 環境中運行。
華爲小藝 OpenClaw 憑證：需要 AK、SK 和 agentId。這些需要在華爲雲開發者平臺自行申請。
Node.js ≥ 20：代碼依賴內置的 fetch、FormData 和 Blob。

安裝步驟¶

註冊插件：

通過 DSH 命令註冊插件源：

    dsh plugin --profile web add git+https://github.com/HangZhouXi/dsh-xiaoyi

執行安裝：

    dsh plugin --profile web install

冷啓動：

宿主端插件不支持熱重載，安裝後必須對 DSH 宿主進行冷啓動才能生效。
配置憑證：

編輯配置文件 ~/.dsh/xiaoyi/state.json：

    {
      "enabled": true,
      "ak": "XiaoYi Open Platform AK",
      "sk": "XiaoYi Open Platform SK",
      "agentId": "agentId of your OpenClaw-mode agent",
      "wsUrl": "wss://hag.cloud.huawei.com/openclaw/v1/ws/link",
      "sessionId": "",
      "cwd": "C:\\Users\\<you>\\Desktop",
      "publicBaseUrl": "",
      "imageHost": ""
    }

配置項說明：
*   `enabled`：總開關。
*   `ak` / `sk` / `agentId`：必填，小藝憑證。
*   `sessionId`：會話複用 ID，通常由插件自動維護。
*   `cwd`：會話工作目錄。
*   `publicBaseUrl` / `imageHost`：用於出站文件功能的配置。

典型用法¶

安裝並冷啓動後，可以在 DSH 會話中調用以下工具：

xiaoyi_status：查看通道狀態（憑證完整性、WebSocket 連接、隊列長度等）。
xiaoyi_set：動態更新憑證或開關（如 ak、sk、enabled 等）。
xiaoyi_send：向當前小藝會話推送短消息。
xiaoyi_send_photo：向小藝發送本地圖片或文件（實驗性功能）。
xiaoyi_reconnect：強制斷開並重連。

注意事項¶

非獨立聊天機器人：小藝僅作爲入口，它連接的是你本地的 DSH 會話。本地會話擁有相同的工具集和工作目錄，不存在第二個獨立的智能體。
權限與憑證：插件僅消費 AK/SK/agentId，無法爲你創建這些憑證。
方向可靠性：入站方向（手機 -> 本地）是可靠的；出站方向（本地 -> 手機）僅支持文本，發送圖片或文件功能處於實驗階段，且協議限制只能使用公網 HTTPS URL。

總結¶

dsh-xiaoyi 爲 DSH 用戶提供了連接華爲小藝 OpenClaw 模式的原生途徑，利用零依賴的協議實現保證了與宿主進程的穩定性。開發者可以通過配置文件或 xiaoyi_set 工具快速接入，實現手機端與本地工作流的無縫對接。