前言¶
在 DeepSeek Harness（DSH）里做自动化时，常见做法是手写脚本调用飞书开放平台 API，或在对话里反复粘贴文档链接、表格截图。多维表格的分组统计、仪表盘图表、云文档导入、群消息发送，各自对应不同接口与权限，授权与重试也要自己接。
dsh-feishu 由维护者 2048lr 发布，归类为联网工具，把飞书 / Lark 租户上的多维表格、文档、电子表格、云盘、知识库和消息等能力，封装成 DSH 可调用的工具，并提供可视化设置页与 OAuth 授权流程。下面介绍它的定位、工具能力、安装与典型用法。
这是什么¶
dsh-feishu 是面向 DeepSeek Harness 的飞书 / Lark 集成插件（Deep Feishu / Lark integration）。智能体通过一组以 feishu_ 为前缀的工具（可在设置里改名）访问真实租户资源；插件还提供浏览器侧浮动面板，用于查看操作记录并在页面上完成授权。
新建内容默认落在已授权用户自己的云盘下：工具以用户身份调用开放平台。若尚未保存用户授权，会回退到应用身份并在结果中给出警告，而不是静默把文件写到用户看不到的空间。
核心功能¶
README 中列出的工具如下（名称前缀默认为 feishu_）：
| 工具 | 作用 |
|---|---|
feishu_bitable |
一次调用创建多维表格应用及其数据表、字段；列出表与字段；批量插入、搜索、更新、删除记录 |
feishu_dashboard |
在多维表格内创建仪表盘与图表块（柱状图、折线图、饼图、排行榜、指标卡、NPS 等约 15 类），调整位置，读取图表计算结果 |
feishu_query |
对表做分组聚合查询（group by、sum / avg / min / max / count / distinct_count、筛选、排序、top-N），聚合在服务端完成 |
feishu_doc |
创建文档；追加 Markdown（转为原生块）或原始块；读取纯文本；将本地 Markdown / Word / Excel / PowerPoint / PDF 导入为新云文档 |
feishu_sheet |
创建电子表格；增删工作表；读、写、追加区域 |
feishu_drive |
浏览文件夹；创建文件夹；上传与下载；移动、删除；读取元数据 |
feishu_wiki |
列出知识库空间与节点；将 wiki token 解析为对应文档；创建与移动节点 |
feishu_message |
发送文本、互动卡片、富文本帖子、文件与图片；在线程中回复；通过自定义机器人 webhook 发送 |
feishu_auth |
诊断授权、生成授权 URL、用手动 code 完成交换、刷新、登出 |
feishu_api |
调用文档中任意飞书开放平台路径，共用同一套鉴权、重试与错误映射 |
设置页（设置 → 飞书 / Feishu）可编辑应用凭据、默认落点与身份、功能开关、授权 scope 与重定向 URL、高级项（端点覆盖与分页上限等），无需手改 YAML。保存时只写入当前 profile 的 cordis.patch.yml 中本插件条目，Harness 可热加载；App Secret 不写入该文件，而是进入凭据存储。
安装与启用¶
安装方式二选一，不要同时使用：两种方式都会在 loader 中创建 id 为 feishu 的条目，重复定义会触发 duplicate loader entry id。
推荐：bundle 安装¶
dsh plugin add github:2048lr/dsh-feishu
该命令会把 dsh-feishu 加入 dsh.profile.bundles，并在 profile 启动时合并包内的 cordis.patch.yml。
手动安装（无 CLI）¶
在仓库根目录执行（资料原文为 PowerShell 脚本）：
pwsh -File scripts/install.ps1
脚本会把包复制到 profile 的 node_modules 并在 cordis.patch.yml 中插入插件行。完成后必须重启 DeepSeek Harness（主机侧 Node 模块缓存在进程内，仅 reload 不够）。
无论哪种方式，首次重启后建议在 设置 → 飞书 / Feishu 中填写配置，而不是长期手改 YAML。
飞书应用侧准备¶
- 在 飞书开放平台（或 Lark）创建企业自建应用，在「凭证与基础信息」记下 App ID、App Secret。
- 在「安全设置 → 重定向 URL」添加插件回调（端口以 DSH 实际监听为准，插件会从 host 读取并在
feishu_auth的status中给出完整 URI），例如：
http://127.0.0.1:19387/api/feishu/oauth/callback
-
在「权限管理」添加所需 scope 并发布版本（未发布版本的权限不生效）。
offline_access为必需项，否则无法拿到 refresh token，用户需频繁重新授权。其余常见 scope 包括bitable:app、docx:document、drive:drive、sheets:spreadsheet、wiki:wiki、im:message、im:resource、contact:user.base:readonly等，与上表工具对应关系见 README 权限表。 -
在 DSH 设置页填写 App ID，将 App Secret 通过凭据引用（默认名
FEISHU_APP_SECRET）或环境变量提供；选择品牌feishu或lark。
授权¶
在设置页点击「授权飞书」，或让智能体调用 feishu_auth、action 为 authorize_url。浏览器完成回调后，后续调用以该用户身份执行。无本机浏览器的远程/无头环境：在任意环境打开授权 URL，再把回调中的 code 传给 feishu_auth、action 为 complete。
典型用法¶
配置与授权完成后，可在对话中直接描述任务，由模型选用对应工具，例如：
- 用
feishu_bitable建表、写字段、批量写入记录，再用feishu_query做分组汇总。 - 用
feishu_dashboard在同一多维表格应用里加图表块并读取指标。 - 用
feishu_doc从本地 Markdown 导入文档，或追加 Markdown 内容。 - 用
feishu_message发卡片或文件；需要未封装接口时用feishu_api走开放平台路径。
未在表中列出的配置项（如 defaultFolderToken、defaultIdentity、toolPrefix、enableTools 等）可在设置页或 README 的 Configuration 一节查阅；除 appId 外字段均有默认值。
适用场景与注意¶
适合已在 DSH 中运行智能体、并希望把飞书租户当作「可写工作区」的开发者：项目台账、报表、文档归档、知识库整理、通知下发等，都可由 agent 调用工具完成，而不是单独维护一套飞书脚本。
使用前请注意：
- 插件以当前 DSH 进程权限运行，安装前应阅读 GitHub 仓库 源码与 MIT 许可证（package.json 标注版本 0.1.0，Node >= 20）。
- 社区目录 SkillHub 插件页 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；星标与版本以仓库与目录页实时信息为准。
- 勿将 App Secret 明文写入
cordis.patch.yml；优先使用 Harness 凭据存储。 - bundle 安装与
install.ps1不要混用，避免 loader id 冲突。
结尾¶
dsh-feishu 把飞书多维表格、文档、表格、云盘、知识库、消息与通用 API 调用收敛到 DSH 工具层，并用设置页与 OAuth 降低接入成本。需要进一步了解权限表与高级配置时，以仓库 README（含 中文 README.zh.md）为准。
- 目录页：https://www.skillhub.cn/plugins/2048lr/dsh-feishu
- GitHub：https://github.com/2048lr/dsh-feishu
