前言¶
DSH 可以通過插件接入不同消息入口。對於需要在本機運行 DSH agent 的場景，JMOKSZ/dsh-lark-bridge 提供了一個飛書（Feishu / Lark）入口：在飛書裏給機器人發消息，由機器人通過官方長連接把任務交給本機 DSH agent 處理。
下面介紹它的定位、已覈實能力、安裝方式、運行方式和注意事項。
這是什麼¶
JMOKSZ/dsh-lark-bridge 是一個飛書入口插件，由 JMOKSZ 維護，許可證爲 MIT。
它讓飛書機器人驅動本機 DSH agent，並支持附件、交互問答/審批、流式進度卡片和主動推送。插件走官方長連接（WebSocket），無需公網 IP、無需反向代理。
核心能力¶
插件提供以下能力：
- 流式回覆卡片（默認開啓），即時展示思考、回答草稿和工具調用面板。
- 主動推送：
feishu_send工具可向會話推送文本/卡片。 - 交互問答與審批：
ask_user_question與工具審批渲染爲按鈕卡片。 - 附件處理：圖片/文件/視頻/音頻自動下載保存。
- 富文本：
post消息自動提取純文本。 - 多會話：每個飛書 chat 獨立 DSH session。
- 羣聊：默認僅在被 @ 時響應。
- 命令：
/new、/status、/whoami、/help。
安裝前置¶
先確認本機滿足以下條件：
1、已安裝 DSH CLI、pnpm、Node.js ≥ 22。
2、準備一個可用的 LLM key。
3、準備飛書應用憑據，並開通權限：
im:message
im:message:send_as_bot
im:message.group_at_msg
im:chat
im:resource
im:message:update
安裝¶
下面這條命令從 GitHub 安裝插件，並綁定 lark profile：
dsh plugin --profile lark add github:JMOKSZ/dsh-lark-bridge --ignore-scripts
配置環境變量¶
憑據全部來自環境變量，不寫入配置文件。
必填變量：
LARK_APP_ID
LARK_APP_SECRET
可選變量：
LARK_WORKSPACE
示例：
export LARK_APP_ID=cli_xxx
export LARK_APP_SECRET=xxx
export LARK_WORKSPACE=/path/to/work
運行¶
按已覈實的使用示例啓動插件：
LARK_APP_ID=cli_xxx LARK_APP_SECRET=xxx LARK_WORKSPACE=/path/to/work dsh --profile lark
啓動後，飛書機器人通過長連接接收消息，並將任務交給本機 DSH agent 處理。
典型用法¶
1、單聊：直接發消息；羣聊：@機器人 後發消息。
2、發送圖片/文件/視頻/音頻：自動下載處理，可附文字說明。
3、需要選擇/審批時：點擊卡片按鈕，或直接回復編號/文字。
4、使用命令：
/new
/status
/whoami
/help
適用場景與注意¶
適合需要在本機運行 DSH agent，並從飛書發起任務的場景，尤其是需要附件、交互審批、流式進度和主動推送的使用方式。
注意：
- 插件會以當前
dsh進程權限運行；安裝前建議查看倉庫源碼與MIT許可證，確認其飛書消息、附件下載和 DSH agent 行爲符合預期。 LARK_APP_ID、LARK_APP_SECRET爲必填；LARK_WORKSPACE爲可選。- 附件大小上限爲
104857600，飛書上限爲100MB。 - 該插件使用
MIT許可證；DSH 插件目錄爲社區站點，並非官方應用商店。
鏈接¶
- GitHub：https://github.com/JMOKSZ/dsh-lark-bridge
- 插件目錄線索 URL（未在本次已覈實資料中確認）：https://www.skillhub.cn/plugins/JMOKSZ/dsh-lark-bridge
