DSH（DeepSeek Harness）生態遵循“一切皆插件”的理念，開發者通常通過命令行或 API 與 Agent 進行交互。如果需要在飛書（Lark）客戶端中直接與 Agent 對話，需要一箇中間層來處理消息的收發與協議轉換。minyang2020/dsh-feishu-bridge 正是這樣一個雙向橋接器，它讓飛書用戶能通過長連接直接與本地運行的 DSH Agent 進行交互。
這是一個在飛書裏直接和你的 DeepSeek Harness Agent 對話的雙向橋接器。項目由用戶 minyang2020 維護，採用 MIT 許可證。它通過飛書長連接與本地正在運行的 DSH 進程通信，實現消息的實時收發。
核心功能¶
- 會話隔離與觸發：私聊模式下，每個飛書用戶自動綁定一個獨立的 DSH 會話，上下文互不干擾。羣聊模式下，只有被 @機器人 時纔會響應，回覆發送回羣裏。
- 流式與富交互：Agent 回覆支持流式輸出，以 cardkit 打字機卡片逐字上屏（權限缺失時自動降級爲普通文本）。支持審批轉發，當 Agent 請求權限時，飛書端收到確認文本；支持提問轉發，Agent 提問時以序號或選項格式回覆。
- 連接與安全：飛書長連接與 DSH 事件流均支持斷線重連。飛書長連接由本機主動發起，零公網依賴，無需開放端口。插件運行在本機 DSH 進程權限下，安全性由本地環境保障。
安裝與啓用¶
- 安裝插件：
使用官方命令安裝插件包feishu-dsh-bridge：
dsh plugin --profile <名字> add feishu-dsh-bridge
- 配置插件：
在 profile 的cordis.patch.yml文件中添加配置項（示例）：
- id: feishu-dsh-bridge
config:
appId: cli_xxxxxxxxxxxxxxxx
appSecret: your_app_secret
dshBaseUrl: http://127.0.0.1:3200
sessionCwd: D:\workspace
典型用法¶
- 私聊：在飛書搜索應用名，發起單聊即可開始對話。
- 羣聊：在羣設置中添加機器人，之後只有 @機器人 纔會觸發響應。
- 控制任務：在對話中使用
/stop可以取消當前會話正在進行的任務。 - 配置調整：綁定關係持久化在
state/mapping.json文件中。流式輸出默認開啓，可通過設置環境變量STREAMING=false關閉；STREAM_UPDATE_INTERVAL_MS可控制卡片刷新節流。
注意事項¶
- 安全：
.env文件包含真實憑據，已加入.gitignore，切勿提交。state/目錄包含會話綁定信息，同樣不提交。 - 權限生效：飛書開放平臺的權限配置和事件訂閱需要「發佈版本」後才生效。若長連接連不上，請檢查飛書端權限配置是否已發佈。
- 功能限制：當前僅支持文本消息。圖片、文件、富文本消息暫不支持（會提示僅支持文本）。
- 網絡與運行：橋接只監聽本機 DSH 的 loopback API，飛書側憑據按租戶隔離。
該插件通過長連接方式，爲 DSH Agent 提供了直接接入飛書的入口，適合需要在企業內部通訊工具中調試或使用 Agent 的場景。更多細節與源碼，請訪問 GitHub 倉庫。
