在 DeepSeek Harness 的開發中，讓智能體與協作平臺交互是常見需求。dsh-plugin-feishu 通過一系列工具填補了這一空白，通過你自己的企業自建飛書應用實現直接集成。
該插件爲 DeepSeek Harness 提供了 25 個 feishu_* 工具，覆蓋了聊天消息、雲文檔（包括圖片、生成的圖表和表格）、多維表格記錄、電子表格範圍和驅動權限。它完全使用 Node.js 編寫，沒有外部依賴，也不需要 Python。
核心功能¶
插件提供的工具分爲以下幾類：
聊天與消息
* feishu_list_chats: 列出機器人加入的會話
* feishu_list_chat_members: 獲取會話成員
* feishu_send_text: 發送純文本消息
* feishu_send_post_message: 發送富文本消息
* feishu_read_chat_history: 讀取聊天曆史
* feishu_recall_message: 撤回消息
文檔 (docx)
* feishu_create_document, feishu_read_document, feishu_read_document_blocks
* feishu_append_document_blocks, feishu_update_document_block, feishu_delete_document_block
* feishu_insert_table_into_document, feishu_insert_image_into_document, feishu_insert_chart_into_document
* feishu_resolve_wiki_node: 解析 Wiki 節點
多維表格
* feishu_create_bitable, feishu_list_bitable_tables, feishu_list_bitable_fields
* feishu_write_bitable_record, feishu_read_bitable_records
表格
* feishu_read_sheet_range, feishu_write_sheet_range
權限管理
* feishu_grant_document_access, feishu_set_document_link_sharing
安裝與配置¶
安裝¶
在支持插件的 DeepSeek Harness 環境中，執行以下命令安裝插件：
dsh plugin --profile web add github:2286893544/feishu-dsh-plugin
安裝後需要重新加載配置，並在設置頁面中進行配置。
配置¶
進入 Settings → 飛書 頁面進行配置。你需要準備企業自建飛書應用的憑證。
| 字段 | 說明 |
|---|---|
appId |
自建應用的 App ID (cli_...) |
appSecret |
應用密鑰，該字段會被隱藏顯示爲密碼控件 |
tenantDomain |
租戶域名，如 acme.feishu.cn（留空時可通過 API 自動檢測） |
defaultChatId |
默認會話 ID (oc_...)，當工具調用未指定 chat_id 時使用 |
grantOpenId |
分享對象 ID (ou_...)，創建的文檔和表格默認共享給該用戶 |
wikiSpaceId |
知識庫空間 ID，用於創建 Wiki 文檔 |
wikiParentNodeToken |
Wiki 文檔的默認父節點 Token（爲空則創建在根目錄） |
此外，也可以通過環境變量或配置文件注入憑證：
* FEISHU_APP_ID
* FEISHU_APP_SECRET
* FEISHU_TENANT_DOMAIN
配置完成後，可以通過 測試連接 按鈕（POST 到 /dsh-plugin-feishu/test-connection）驗證憑證是否正確。
注意事項與限制¶
- 圖表渲染：圖表在本地渲染（使用純 Node.js PNG 編碼器和 5x7 ASCII 字體）。圖表標題和分類標籤必須是 ASCII 字符，非 ASCII 字符會被丟棄。如果需要中文圖表，建議生成圖片後使用
feishu_insert_image_into_document。 - 表格 API：電子表格工具使用的是經典的 sheets v2 range API。
- 聊天權限：只能讀取機器人已加入的聊天記錄，其他用戶的私人聊天無法通過 API 訪問。
- 應用權限：需要啓用機器人的企業自建應用，併發布以下權限範圍：讀取聊天曆史、文檔讀寫、多維表格、表格和驅動權限管理。機器人必須是被目標聊天邀請的成員，且需要擁有讀取權限的文檔必須已與機器人共享。
- 安全性：憑證僅在本地處理，不會上傳到外部服務。嚴禁在聊天或文檔中分享
appSecret。
適用場景¶
該插件適合需要在 DeepSeek Harness 智能體中直接操作飛書生態的開發者。所有工具均通過 DSH 的標準接口暴露，無需編寫額外的橋接代碼。
生態與來源¶
該插件遵循 MIT 許可證。有關詳細的開發文檔、已知限制及源代碼，請訪問其 GitHub 倉庫。
