前言¶
在 DSH 插件式擴展的思路下，智能體運行時可以通過插件接入不同的消息渠道。itr-del/dsh-feishu 是一個用於 DeepSeek Harness（dsh）的飛書（Lark）IM 橋接插件，適合把飛書單聊消息接入運行中的 dsh 會話。
它解決的核心問題是：讓飛書 DM 用戶與 dsh 會話建立對應關係，使開發者可以通過飛書單聊與 dsh agent 進行多輪文本對話。
這是什麼¶
dsh-feishu 的一句話定位是：Feishu (Lark) IM bridge for DeepSeek Harness (dsh)。
該插件由 itr-del 維護，許可證爲 MIT，package.json 中版本爲 0.1.0。
它主要用於將飛書自建機器人接入 dsh 的文本對話場景，並維護每個飛書 DM 用戶對應的持久 dsh 會話。
核心功能¶
下面介紹已覈實的功能點：
- 一個飛書 DM 用戶對應一個持久 dsh 會話
會話標識爲：
feishu:<open_id>
-
支持跨重連的多輪對話
同一 DM 用戶在重新連接後，可以繼續使用已有會話上下文。 -
過濾出站文本中的 DeepSeek DSML 工具調用標記
插件會在返回到飛書的文本中處理 DSML 工具調用標記，避免其直接出現在用戶可見消息中。 -
純 ESM，無 TypeScript 編譯步驟
插件以 ESM 方式運行，不需要額外進行 TypeScript 編譯。 -
無遙測，完全本地
已覈實材料將其描述爲無遙測、完全本地運行。
插件默認配置如下：
{
"appId": "",
"appSecret": "",
"defaultProvider": "deepseek-official",
"defaultModel": "deepseek-v4-flash"
}
安裝與啓用¶
1. 安裝 dsh¶
先全局安裝 DeepSeek Harness：
npm install -g @deepseek-ai/dsh
2. 添加插件¶
安裝 dsh-feishu 插件：
dsh plugin add dsh-feishu
3. 配置飛書應用¶
在飛書開放平臺創建一個 Custom App，並複製 appId 和 appSecret。
事件訂閱需要按以下方式設置：
- 設置爲使用長連接接收事件/回調。
- 添加事件：
im.message.receive_v1
權限需要授予：
im:message
im:message.p2p_msg
完成權限配置後，發佈版本。
4. 設置環境變量並運行¶
以下環境變量在已覈實材料中列爲需要：
export DEEPSEEK_API_KEY="sk-..."
export FEISHU_APP_ID="cli_..."
export FEISHU_APP_SECRET="..."
然後啓動 dsh web：
dsh web
啓動完成後，在飛書單聊中給 bot 發送消息，即可發起會話。
典型用法¶
經過上面的步驟，典型使用流程如下：
- 在飛書單聊中向 bot 發送一條文本消息。
- 插件將消息接入 dsh 會話。
- dsh agent 返回文本回復。
- 插件將回復發送回飛書單聊。
同一飛書 DM 用戶對應同一個持久會話：
feishu:<open_id>
因此，後續繼續在該 DM 會話中發送消息時，可以基於已有會話進行多輪對話。
適用場景與注意¶
適合誰使用¶
該插件適合以下場景：
- 使用 dsh 構建或運行 agent，並希望通過飛書單聊訪問它。
- 需要本地運行、MIT 許可、無遙測的飛書文本橋接方案。
- 只需要 DM 文本消息，不需要圖片、文件、卡片或羣聊能力。
限制¶
已覈實材料中的限制包括：
- 僅支持文本消息。
- 不處理圖片、文件、卡片、post。
- 暫不支持羣聊，僅支持 DM。
關於流式回覆，現有材料中存在不一致表述，因此本文不將其列爲確定能力。
安全注意¶
FEISHU_APP_SECRET 和 DEEPSEEK_API_KEY 屬於敏感憑據，不應提交到代碼倉庫或暴露在日誌中。
插件以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；該插件許可證爲 MIT。
鏈接¶
- GitHub 倉庫：https://github.com/itr-del/dsh-feishu
