前言¶

DeepSeek Harness（dsh）把智能体能力封装成可插拔的插件体系，但默认交互多在终端或本地进程里完成。团队日常协作在飞书，若要把 dsh 接到 IM 里，通常需要自己搭机器人、配应用凭证、再把 slash 命令和审批流串起来。

dsh-feishu（npm 包名 @dsh-feishu/dsh-feishu）是维护者 PGZXB 发布的 dsh 原生客户端插件：飞书聊天即 dsh 会话，控制面板把每条 slash 命令做成卡片按钮，审批与提问在卡内完成，输出以流式卡片呈现。下面介绍它的定位、能力与安装用法。

这是什么¶

dsh-feishu 是 DeepSeek Harness 的飞书 UI，分类为客户端插件。一句话概括：面板驱动的控制台——每个命令都是控制面板卡片上的按钮，支持卡内审批与提问、流式卡片，以及扫码一键配置飞书应用。

插件以 MIT 许可证发布，当前 npm 版本为 0.2.0，要求 Node.js ≥ 22.13。README 注明 dsh 仍处于 pre-release（0.1.0-rc.x），版本间可能不兼容；main 分支与 npm @latest 均跟踪 dsh 0.1.1-rc.2。

社区目录页：https://www.skillhub.cn/plugins/PGZXB/dsh-feishu（SkillHub 为独立社区站点，与 DeepSeek / 幻方无官方从属关系）。源码与文档：https://github.com/PGZXB/dsh-feishu。

核心功能¶

面板驱动的命令控制台¶

发送 /panel 会弹出控制面板卡片，上面的每个按钮对应一条 slash 命令，与手动输入命令等价。不必记语法，点选即可执行 /repo、/cd、/model、/sessions 等操作。

流式输出卡片¶

智能体运行时，工具调用、推理过程、Markdown 与表格会实时写入卡片；结束后卡片变为完成态，并提供 Stop、复制、重试以及返回面板的按钮。

卡内审批与提问¶

权限升级时推送审批卡片，可点 Allow once 或 Reject；智能体提问时以卡片形式呈现，可点选或回复作答。群聊中错误通知、审批与提问会 @ 发起人。

会话持久化与工作目录¶

每个飞书聊天绑定一个 dsh 会话，工作目录与上下文在 daemon 重启后仍保留。通过 📚 Pick project（等同 /repo）或 📁 Change dir（等同 /cd <path>）选定目录后，智能体才会开始执行任务。

扫码一键配置¶

dsh-feishu-setup 向导通过扫码创建并配置飞书应用，无需手动在飞书开放平台填凭证。若已有应用，可设置环境变量或 profile 配置中的 FEISHU_APP_ID / FEISHU_APP_SECRET（详见仓库 docs/feishu-setup.md）。

其他能力¶

• 群聊与 @ 提及：默认需 @ 机器人；仅你与机器人的私聊群也可直接发消息，策略可配置。
• /group <name> 创建含机器人的群聊。
• 表情回应确认、聊天/用户白名单（allowedChats / allowedUsers）、定时提醒（/schedule）、会话日志导出（/export）、诊断卡片（/feishu-status）。

安装与启用¶

安装前确认 Node.js 版本，并全局安装 pnpm。pnpm ≥ 11 默认会阻止 protobufjs 的构建脚本，安装插件时需加 --allow-build=protobufjs。

从 npm 安装（推荐）¶

# 1. 确认 Node.js ≥ 22.13
node --version

# 2. 安装 pnpm
npm install -g pnpm

# 3. 将插件加入 feishu profile
npx @deepseek-ai/dsh plugin --profile feishu add @dsh-feishu/dsh-feishu@latest --allow-build=protobufjs

# 4. 扫码创建并配置飞书应用
npx --yes --package @dsh-feishu/dsh-feishu dsh-feishu-setup --new --profile feishu

# 5. 启动 dsh
npx @deepseek-ai/dsh --profile feishu

从源码安装¶

git clone https://github.com/PGZXB/dsh-feishu.git
cd dsh-feishu
pnpm install
pnpm run build

npx @deepseek-ai/dsh plugin --profile feishu add link:.
pnpm run setup:feishu -- --new --profile feishu
npx @deepseek-ai/dsh --profile feishu

卸载¶

npx @deepseek-ai/dsh plugin --profile feishu remove @dsh-feishu/dsh-feishu

# 可选：删除 profile 及 surface 数据
rm -rf ~/.dsh/profiles/feishu ~/.dsh/feishu

典型用法¶

启动后在飞书中给机器人发消息即可。一次完整会话通常按以下顺序进行：

1. 开始聊天：私聊机器人，或发送 /group <name> 创建群聊；群内需 @ 机器人（策略可改）。
2. 打开控制面板：发送 /panel。
3. 选择工作目录：点 📚 Pick project 或 📁 Change dir；未设置目录时机器人不会执行任务。
4. 提问：直接发消息，输出流式写入卡片。
5. 处理审批与提问：在卡片内批准权限或作答。
6. 管理会话：点 🗂️ Sessions 查看并恢复历史会话（等同 /sessions）；点 ➕ New chat 开新对话（等同 /clear，旧会话仍保留）。

常用命令一览：

完整列表见仓库 README 的 Commands 章节。

适用场景与注意¶

适合谁： 已在用或计划用 dsh 做智能体开发、希望把交互放到飞书 IM 的团队或个人；需要移动端或协作场景下点选操作、卡内审批，而不想维护一套自建机器人脚手架的用户。

使用前请注意：

• dsh 与 dsh-feishu 均处于快速迭代期，升级前对照 README 中的 dsh 版本说明。
• 插件以当前 dsh 进程权限运行，能访问该进程可触及的文件系统与网络；安装前应阅读源码与 MIT 许可证，确认权限与白名单配置（allowedChats / allowedUsers）符合团队安全要求。
• 生产环境建议先在小范围聊天中验证 /feishu-status 与权限预设，再扩大使用面。

结尾¶

dsh-feishu 把 dsh 的 slash 命令、流式输出和审批流收敛到飞书卡片里，用 /panel 和扫码配置降低接入成本。若你已在 dsh 生态里做智能体，又希望协作入口落在飞书，可以从 npm 安装并按 Quickstart 走一遍。

• 社区目录：https://www.skillhub.cn/plugins/PGZXB/dsh-feishu
• GitHub：https://github.com/PGZXB/dsh-feishu