前言¶
在 DeepSeek Harness（DSH）裏接飛書，常見做法是自己在開放平臺建應用、抄 App ID 與密鑰、再去找羣聊的 chat_id，中間任何一步漏配 scope，排查都要對着文檔逐項對。DSH 社區插件 dsh-feishu-plugin（npm 包名 @yisang0910/plugin）做的是客戶端側一件事：在 DSH 設置面板左欄提供「飛書連接」頁，用四步向導把憑據、目標羣和連通性收攏到同一界面。長連接機器人、MCP 工具與卡片網關等能力在主倉庫 yinsang0910-star/dsh-feishu；本倉庫由主倉腳本單向同步生成，僅供插件目錄收錄，維護者爲 yinsang0910-star，分類爲客戶端。
這是什麼¶
dsh-feishu-plugin 是 DSH 的 Web 客戶端插件（dsh.client.platform: web），通過 Cordis patch 掛載設置頁，不單獨提供 25 個 MCP 工具的實現。它解決的是「飛書接入前的配置與驗收」：建應用指引、憑據寫入本機、選羣、九項真調接口自檢。與只在文檔裏列步驟相比，失敗項會直接提示應開通的 scope；與把憑據經瀏覽器中轉相比，支持 RFC 8628 設備授權掃碼創建自建應用，憑據只寫本機。
核心功能¶
下面按嚮導四步對應 README 中已說明的能力。
建應用¶
提供飛書開放平臺直達鏈接，以及 11 項權限清單，支持一鍵複製，便於在開放平臺創建自建應用時對照勾選。
填憑據¶
兩種方式：掃碼走設備授權創建飛書自建應用，憑據寫入本機、不經過瀏覽器；或手動填寫 App 憑據。
選會話¶
掃描機器人所在羣聊並點選目標羣，無需手抄 32 位 chat_id。
九項自檢¶
逐項真實調用飛書相關能力，覆蓋：憑據、機器人身份、會話列表、目標羣、讀歷史、上傳文件、雲空間、MCP 掛載、憑據文件。某一項失敗時，界面會給出需要開通的 scope。
自檢刻意減少對羣聊的干擾：讀歷史僅讀 1 條；上傳探測文件僅 20 字節且不發送到聊天。
安裝與啓用¶
安裝命令以倉庫 README 爲準（需指定 profile 與 commit）：
dsh plugin --profile <profile> add github:yinsang0910-star/dsh-feishu-plugin#<commit>
安裝後重啓 DSH，設置面板左欄會出現「飛書連接」。
運行環境：package.json 要求 Node >=20。插件依賴 DSH 自帶的 @deepseek-ai/dsh-client-ui-primitives 與 @deepseek-ai/dsh-client-ui-slots，無需單獨安裝。
許可證：MIT（當前發佈版本 0.1.0）。
典型用法¶
- 按上文命令把插件裝進指定 profile，重啓 DSH。
- 打開設置面板，進入「飛書連接」。
- 第一步：按頁內鏈接與 11 項權限清單在開放平臺創建或覈對應用。
- 第二步：掃碼創應用或手填憑據，保存到本機。
- 第三步：掃描並選擇機器人要服務的羣聊。
- 第四步：運行九項自檢，按失敗項補開 scope 後重試，直至全部通過。
若需要 MCP 工具、長連接機器人等運行時能力，應配合主倉庫 dsh-feishu 的文檔與部署方式；本插件頁主要負責連接配置與驗收。
適用場景與注意¶
適合誰：已在用或計劃用 DSH，希望通過圖形嚮導完成飛書自建應用憑據與目標羣配置，並在接業務前用九項自檢確認接口與 scope 的開發者。
權限與安全：插件以當前 DSH 進程權限運行，憑據寫入本機配置文件；安裝前請閱讀 GitHub 源碼 與 LICENSE，確認符合你的安全策略。社區目錄 SkillHub 插件頁 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；Issue 與主開發流向 dsh-feishu。
倉庫關係：勿向 dsh-feishu-plugin 直接提交功能代碼；變更應發生在主倉並由 scripts/publish-plugin-repo.ps1 同步。
結尾¶
dsh-feishu-plugin 把飛書連接從「分散文檔 + 手抄 ID」收成 DSH 設置裏的四步向導與九項自檢，適合作爲接 dsh-feishu 主能力前的配置入口。
- 目錄頁：https://www.skillhub.cn/plugins/yinsang0910-star/dsh-feishu-plugin
- GitHub：https://github.com/yinsang0910-star/dsh-feishu-plugin
- 主倉庫：https://github.com/yinsang0910-star/dsh-feishu
