前言¶
做 DeepSeek Harness 插件或智能體時，常見訴求不是再寫一套聊天入口，而是讓已有 Harness 會話能從飛書直接發起和繼續：掃碼創建機器人、多個機器人並存、飛書裏多輪對話，同時少維護獨立橋接服務。xmanrui/dsh-feishu 是圍繞這個目標做的飛書接入插件。
這是什麼¶
xmanrui/dsh-feishu 是一個 DeepSeek Harness 插件，owner 爲 xmanrui，許可證爲 MIT。它把一個或多個飛書機器人直接接入 DeepSeek Harness，並在 Harness「設置 → 插件 → 飛書」中掃碼逐個創建機器人。
插件運行在 dsh web 的 Host 進程內，不需要再維護獨立橋接服務。當前按 DeepSeek Harness 0.1.0-rc.6 的插件與 Connection RPC 接口開發。
README 開頭寫有“本項目不維護了”，並推薦替代插件 dsh-im。
核心功能¶
- 在 Harness「設置 → 插件 → 飛書」內反覆掃碼添加多個機器人，無需手動複製 App ID 或 App Secret。
- 每個機器人擁有獨立憑據、飛書長連接、授權用戶、會話映射和消息去重狀態。
- 單個機器人斷線、重連或移除，不會中斷其他機器人。
- 掃碼用戶自動成爲首位授權用戶，創建後即可私聊機器人。
- 收到消息後先添加處理中 Reaction，成功或失敗後再更新狀態。
- 使用飛書 CardKit 原生流式卡片輸出，失敗時安全回退爲普通文本。
- 每個飛書會話映射到持久的 Harness 會話，支持多輪上下文。
- 默認使用 Harness
standard智能體預設，包括網頁搜索等工具能力。 - App Secret 僅保存在 DSH Host 的憑據存儲中，不進入瀏覽器、二維碼或插件配置文件。
安裝與啓用¶
先執行安裝命令：
npx -y github:xmanrui/dsh-feishu install
安裝後重啓 dsh web。打開 Harness「設置 → 插件 → 飛書」，點擊「添加機器人」，再用飛書掃碼確認。
需要更多機器人時，再次點擊「添加機器人」即可；掃碼只會新增，不會覆蓋現有機器人。連接成功後，在飛書中找到剛創建的機器人併發送消息即可。
每個機器人支持以下命令：
/new/status/help
本地開發¶
如果是從源碼驗證，可以先克隆倉庫：
git clone https://github.com/xmanrui/dsh-feishu.git
進入倉庫目錄後，依次執行：
npm install
npm test
npm run build
node bin/dsh-feishu.mjs install --source .
這裏先安裝依賴、運行測試、構建插件，再用本地源碼安裝。倉庫仍保留舊版獨立橋接 src/index.mjs 與 .env.example；新安裝優先使用 Harness 插件模式。
安全與默認行爲¶
- RPC 僅允許本機 Harness 頁面訪問。
- 瀏覽器不能提交或讀取 App Secret。
- 默認只接受掃碼創建機器人的飛書用戶消息。
- 機器人使用
standard工具集，但不會自動批准 Harness 的高風險操作。 - 移除某個機器人會只停止它自己的長連接，並清除它自己的插件憑據，不影響其他機器人。
- 重複掃碼得到同一個飛書應用時，會複用原機器人記錄，不會產生重複接入。
適用場景與注意¶
適合想把 Harness 會話接入飛書私聊、用掃碼方式管理多個機器人、且不希望額外維護獨立橋接服務的開發者。
安裝前要注意：插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。App Secret 只保存在 DSH Host 的憑據存儲中，非敏感配置保存在 $DSH_HOME/integrations/dsh-feishu/，各機器人的會話狀態彼此隔離。
環境要求：package.json 聲明 Node >=20，並依賴 @larksuiteoapi/node-sdk、dotenv、qrcode。更新 Harness 後，建議先運行測試，並驗證設置頁、掃碼和消息收發閉環。
鏈接¶
- GitHub：https://github.com/xmanrui/dsh-feishu
- 插件目錄頁：https://www.skillhub.cn/plugins/xmanrui/dsh-feishu
