前言¶
DeepSeek Harness (DSH) 的核心價值在於本地化智能體開發與運行。對於開發者而言，直接在終端操作 Agent 比較方便，但在移動場景下操作則不夠直觀。dsh-feishu-bridge 解決了這個問題：它是一個連接飛書與本地 DSH 的橋接插件，允許用戶在飛書單聊中發送消息，直接驅動本機 DSH Agent 執行任務並回帖。
與官方 Web UI 或桌面套殼方案不同，該方案不需要公網 IP 或反向隧道，直接利用本機長連接處理事件。
核心功能¶
- 消息驅動：監聽飛書長連接事件
im.message.receive_v1，將遠程文本轉化爲本地 Agent 的 followup 任務。 - 回覆策略：先回復「處理中…」，待回合結束再發送完整回覆文本。
- 安全校驗：支持白名單校驗和
message_id去重；空白名單拒絕全部請求。 - 高危限制：
bash、write、edit等高危工具默認拒絕（deny）。 - 管理命令：支持
/status查看狀態，/cancel取消當前任務。
安裝與啓用¶
前置要求：
* Node.js 版本 >= 22。
* DeepSeek Harness 版本 0.1.0-rc.6。
安裝步驟：
1. 從源碼克隆並構建（可選，推薦使用 npx 直接安裝）。
2. 創建或指定 profile（例如 feishu-dev）。
3. 執行安裝命令：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile feishu-dev add .
配置¶
插件需要通過環境變量或配置文件注入飛書憑證與權限設置。需配置的字段包括：
* appId：飛書應用 ID。
* appSecret：飛書應用密鑰。
* allowOpenIds：允許接收消息的飛書用戶 ID 白名單。
* workspace：本地 Agent 工作區路徑。
安全配置：
* 空白名單：若 allowOpenIds 爲空或未配置，將拒絕全部消息。
* 工具權限：高危工具默認禁止。若需臨時放開（極不安全），需通過環境變量手動控制，不支持飛書端點選批准。
典型用法¶
安裝並啓動 DSH 後，在飛書單聊中發送以下指令：
- 普通對話：發送「你好」。
- 期望：先收到「處理中…」，隨後收到模型的完整回覆。
- 安全測試：發送「用 bash 執行 echo hi」。
- 期望：收到「安全閘已拒絕」提示，終端日誌顯示
tool_denied。
- 期望：收到「安全閘已拒絕」提示，終端日誌顯示
- 狀態查詢：發送
/status。- 期望：收到 Agent 當前狀態（如「空閒」或「忙碌」）。
- 取消任務：發送
/cancel。- 期望：取消當前正在進行的任務。
注意事項¶
- 免責聲明：本插件爲獨立社區項目，與 DeepSeek 或飛書官方無隸屬關係。遠程消息將驅動本機 Agent 讀寫文件，變更與安全後果由操作者自行承擔。
- 會話限制：同一會話中若上一條消息未處理完成，新消息會被提示「忙碌」（不排隊）。
- 兼容性：進程重啓後會話不恢復，啓動爲新會話。兼容性以
COMPAT.md爲準，DSH 仍處於 Preview 階段。 - 消息類型：目前僅支持單聊 + 純文本，羣聊 @、富文本、卡片消息暫不支持。
總結¶
dsh-feishu-bridge 提供了一種低侵入的方式，將飛書作爲本地 DeepSeek Harness Agent 的遠程控制台。它通過長連接實現即時響應，並內置了嚴格的安全限制，適合需要在移動端或遠程快速觸發本地計算任務的場景。
