在 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 仓库。
