前言¶
DeepSeek Harness 採用了模塊化設計，強調通過插件擴展功能。對於需要在第三方通訊平臺（如 Narra Messenger）上部署智能體的開發者，手動對接 Gateway 協議通常涉及繁瑣的認證管理和會話映射。本插件提供了現成的連接層，將 Harness 的 Agent Preset 直接映射到 Narra 的房間中。
定位¶
dsh-narra-channel 是 NetMind-AI 維護的第三方 DeepSeek Harness 通道插件，用於將 Harness 的智能體預設連接到 Narra Messenger。它不修改 DeepSeek Harness 或 Narra 前後端，專注於處理 Narra Gateway 的協議握手、憑證存儲及消息流轉發。
核心功能¶
- 連接預設與身份映射: 在 Harness 設置中選中一個 Agent Preset，插件會自動提取其中的聯繫人名稱和簡介，並在 Narra 中綁定。
- 憑證安全存儲: 綁定所需的 Gateway URL 和 Bearer Token 不會明文記錄在配置文件或日誌中，而是存儲在 Harness Credentials 裏。
- 獨立 Worker 模型: 每個綁定會創建一個獨立的 Channel Worker。消息在該 Worker 內部串行處理，但不同綁定之間可以併發工作。
- 會話與去重: 插件將 Narra 的房間映射爲 Harness 可恢復的確定性 Session，避免重複執行已完成的對話。
- 語音指令支持: 識別
voice_instructions，用於觸發簡短、快速的語音友好型回覆。 - 流式傳輸: 文本回復通過 Narra Gateway 以流式方式傳輸。
安裝與啓用¶
插件依賴 Node.js ^22.19.0 || >=24.0.0 和 pnpm 11.7.0，目標版本爲 Harness 0.1.0-rc.8。
- 構建並安裝插件包：
git clone https://github.com/NetMind-AI/dsh-narra-channel.git
cd dsh-narra-channel
pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build
pnpm pack
dsh plugin --profile web add ./narra-dsh-narra-channel-0.1.5.tgz
- 配置與綁定：
重啓web配置文件，打開 Harness 設置 → Narra。- 選擇一個 Agent Preset。
- 粘貼 Narra 提供的完整綁定指令或其 setup-guide URL。
- 檢查插件生成的 Narra 身份信息（名稱和簡介），如需修改請手動調整。
- 點擊 Bind and start listening，等待狀態變爲
connected。
適用場景與注意¶
- 併發限制: 單個綁定同一時間僅能處理一條消息。如果該 Agent 的多個房間有長耗時任務，後續消息會排隊。
- 附件處理: 附件目前僅保留源元數據，插件版本
0.1.5不會下載或返回文件內容。 - 運行環境: 第三方 Harness 插件運行在 Harness 進程內部，權限與 DSH 進程一致。請確保信任插件源碼及許可證（MIT）。
- 版本依賴: 插件當前針對 Harness
0.1.0-rc.8開發。如果 Harness 更新，可能需要重新安裝插件或等待適配。
結語¶
該插件通過封裝 Gateway 協議細節，簡化了 Narra Messenger 的接入流程。開發者可以專注於 Agent Preset 的邏輯編寫，無需關心底層的認證與會話管理。源碼與文檔可在下方鏈接獲取。
