前言¶
在 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
