dsh-feishu
Verified@wilshi/dsh-feishu · v0.3.5 · MIT
Feishu/Lark chat surface for DeepSeek Harness: streaming cards, in-card questions and approvals, and guided setup. · DSH 飞书/Lark 接入面:流式卡片、卡片内提问与审批、引导式配置。
Install
dsh plugin add @wilshi/dsh-feishu Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Readme
The Feishu UI for DeepSeek Harness (dsh)
English | 中文
给 DeepSeek Harness(dsh)做的飞书 UI——一个 dsh 原生插件,带面板驱动的控制台:每个 slash 命令都是 ⚙️ 控制面板卡片上的一个按钮,审批和提问都在聊天卡片内完成,扫一次二维码就把整个应用配好。
注意: DeepSeek Harness 仍是预发布版本,版本之间可能有破坏性变更。本包是 PGZXB/dsh-feishu(MIT)的 DSH
0.2.1-rc.5移植版:上游实现原样保留在lib/,仅在 0.2.1 宿主 API 变化处打补丁。宿主包(@deepseek-ai/*、cordis)都是peerDependencies,由 DSH 运行时提供。
宿主服务与 bundle 范围
bundle patch 只插入 feishu 这一行。它刻意不再插入 schedule 与
tool-ask-user:DSH 0.2.1 已经由 dsh-web-app 和 agent preset 挂载它们,而
dsh-app-boot 的 insert 不去重——重复的服务提供者或工具名会让启动失败。
需要自定义 schedule 配置时,用按 id 覆盖的写法(见 cordis.patch.yml 注释)。
插件声明了最小 inject 列表——agents、sessionQuery、commands、tools——
cordis 会等这些聊天界面离不开的服务就绪后再激活。其余能力都是可选软依赖,通过
ctx.get(...) 读取并在缺失时打一条警告:approval、userQuestions、
attachments、workspaceRegistry、sessionTitle、permissionPresets、
planMode、agentDefaultModel、agentPresets、llm、schedule、
credentials。
https://github.com/user-attachments/assets/e9163793-52f2-4e2c-a08a-22b27372be61
2 分半的演示(控制面板、流式卡片、审批与提问)。
快速上手
从 npm 安装
# 1. 安装 Node.js ≥ 22.13
# macOS / Linux:nvm(https://github.com/nvm-sh/nvm)→ nvm install 22
# Windows:https://nodejs.org(或 winget install OpenJS.NodeJS.LTS)
node --version
# 2. 安装 pnpm
npm install -g pnpm
# 3. 安装插件
# (pnpm ≥ 11 默认拦截 protobufjs 的构建脚本,所以加上
# --allow-build=protobufjs 让它执行)
npx @deepseek-ai/dsh plugin --profile feishu add @wilshi/dsh-feishu@latest
# 4. 扫一次二维码:创建并配置飞书应用
npx --yes --package @wilshi/dsh-feishu dsh-feishu-setup --new --profile feishu
# 5. 启动
npx @deepseek-ai/dsh --profile feishu
从源码安装
# 1. 安装 Node.js ≥ 22.13
# macOS / Linux:nvm(https://github.com/nvm-sh/nvm)→ nvm install 22
# Windows:https://nodejs.org(或 winget install OpenJS.NodeJS.LTS)
node --version
# 2. 安装 pnpm
npm install -g pnpm
# 3. 克隆并构建
git clone https://github.com/WilShi/dsh-feishu.git
cd dsh-feishu
pnpm install
pnpm run build
# 4. 装进 profile
npx @deepseek-ai/dsh plugin --profile feishu add link:.
# 5. 扫一次二维码:创建并配置飞书应用
pnpm run setup:feishu -- --new --profile feishu
# 6. 启动
npx @deepseek-ai/dsh --profile feishu
然后到飞书里给机器人发消息即可。配置向导会把飞书应用整套搞定,全程不用开网页控制台,也不用手填凭据。如果你已经有应用,改成设置 FEISHU_APP_ID / FEISHU_APP_SECRET(环境变量或 profile 配置),详见 docs/feishu-setup.md。
卸载
# 从 profile 移除插件
npx @deepseek-ai/dsh plugin --profile feishu remove @wilshi/dsh-feishu
# 可选——彻底清理:删除 profile 及其 surface 数据
#(路径按默认 dsh home,~/.dsh)
rm -rf ~/.dsh/profiles/feishu ~/.dsh/feishu
怎么用
一个飞书聊天对应一个 dsh 会话,机器人就是 agent 的化身。一次典型的使用是这样:
- 开个聊天。 直接私聊机器人;也可以发
/group <名字>建个群。群里一般要 @ 机器人(默认策略);如果群里只有你和机器人,不 @ 直接说也行;@ 策略本身可配置。

- 打开控制面板。 直接发送“面板”或
/panel,会唤出一张中文面板卡片。

- 先定工作目录。 没定目录之前机器人会直接给出工作区选择卡。也可在面板点击 🗂️ 选择工作区,从扫描结果、最近使用和收藏中选择,支持搜索或手动输入路径。

直接问。 发消息,agent 跑起来,工具调用、思考过程、markdown、表格一行行流进一张卡片。跑完卡片变绿,答案完整留在里面;停止、复制、重试和 ⚙️ 面板按钮就贴在卡片上。
进行中 已完成 

要审批就批,要回答就答。 agent 需要提权时会弹一张审批卡,点 Allow once 放行(或 Reject 拒绝);它有问题会弹提问卡,点选项或直接回一句。
审批 提问 

管工作区、会话和 Agent 模式。 点 🗂️ 选择工作区 会直接列出 DSH 已注册的工作区名称,可切换、添加、搜索、收藏、重命名或移除注册(不会删除目录和会话)。点 🗂️ 会话管理 可按“全部会话 / 当前工作区 / 当前飞书聊天”筛选,并查看详情、继续、重命名、分叉、归档或导出。点 🧠 Agent 模式 可选择标准、Codex、Claude Code 或用户自定义预设;切换时保留旧会话并安全开启新会话。

面板卡片上的每个按钮都对应一个 slash 命令。也可以直接发送“面板”“切换工作区”“会话管理”“新对话”,无需记命令语法。
命令
| 命令 | 作用 |
|---|---|
/help |
列出所有命令 |
/panel |
打开控制面板卡(所有命令的按钮版) |
/group <name> |
和机器人建群(无参会弹名称输入卡) |
/cancel |
停下正在跑的回合 |
/cd <path> |
设置本聊天的工作目录(无参会弹路径输入卡) |
/repo [path] |
挑一个项目目录(无参扫描默认 roots;/repo <path> 扫描该路径) |
/workspaces [path] |
列出并管理 DSH 正式工作区;带路径时直接添加并切换 |
/status |
查看本聊天的工作区、会话、模型、Agent 模式和运行状态 |
/feishu-status |
显示运行状态诊断卡 |
/schedule |
列出活跃的提醒 |
/model <provider/model> |
切换本会话的模型(无参打开选择器) |
/mode [preset] |
选择 Agent 模式(无参打开卡片;支持标准、Codex、Claude Code 和自定义预设) |
/export |
把会话日志作为文件发出来 |
/log |
把仅含飞书插件记录的诊断日志发到本聊天;仅配置白名单或显式设置 allowLogExport: true 时可用 |
/sessions |
列出已保存会话(卡片上可继续、重命名、分叉、归档和导出) |
/resume <id> |
在本聊天恢复一个已保存会话(无参打开会话列表) |
/clear /new |
开新对话(旧会话仍保留) |
/goal <text> |
设置任务目标(无参会弹文本输入卡) |
/compact |
压缩较旧的对话历史 |
/feedback <text> |
发送反馈(无参会弹文本输入卡) |
/permission <preset> |
切换权限预设(无参打开选择器) |
/plan [on|off] |
进入或退出计划模式(无参切换) |
能做什么
- 实时流式卡片——工具调用、思考、markdown、表格,边跑边流出来。
- 一键控制面板——
/panel把命令面板全部做成按钮;不用记命令语法,且每个按钮与敲命令完全等价。 - 卡片化工作区与会话——工作区名称与桌面端一致,可添加、切换、搜索、收藏、重命名和安全移除;会话可按全部/工作区/飞书聊天筛选,并继续、重命名、分叉、归档或导出。
- Agent 模式管理——标准、Codex、Claude Code 和自定义 Agent preset 都可在飞书选择;切换会自动新建会话,避免不同内核的工具历史互相污染。
- 原生图片与文件输入——飞书图片进入 DSH 原生视觉附件链路,普通文件同时保留 DSH 附件引用与工作区可读路径;服务异常时自动降级,不阻塞对话。
- 卡内审批 / 提问——提权审批、回答问题都在聊天里完成。
- 会话不丢——重启守护进程,聊天对应的会话和工作目录都还在。
- 群聊 + @ 提醒——群里 @ 机器人即可;出错、审批、提问都会 @ 回发起人。
- 回执、白名单、提醒、导出、诊断——表情回执、
allowedChats/allowedUsers白名单、定时提醒、会话日志文件、状态卡。
交互与日志安全
interactionTimeoutMs控制审批卡和提问卡等待回复的时长,默认 5 分钟,最小 1000 毫秒。locale默认是zh-CN,也可显式设为en-US;sessionVisibility默认是chat。仅在可信的私有机器人上,管理员才应显式放宽为workspace或all。- 会话可见范围同时约束列表、直接输入的
/resume <id>和全部会话卡片操作;已连接的会话不会再被另一个飞书聊天静默抢走。 maxQueuedTurns限制单个聊天等待中的消息数(默认 50),maxPendingAttachments限制等待下一条指示的文件数(默认 20)。超过上限时会明确提示,不会让持久化状态无限增长。- 飞书会话映射会自动兼容旧版 v1/v2 数据并升级为 v3;已有凭据、聊天绑定和工作目录不会被覆盖。
- 持久化日志仅记录
feishu日志域,默认单文件 5 MiB、保留 3 个轮转文件;可用logMaxBytes、logMaxFiles调整。 - 配置非空的
allowedChats或allowedUsers后会自动开放/log;未限制访问范围的机器人必须显式设置allowLogExport: true才能导出日志。 proxyUrl(或环境变量FEISHU_PROXY_URL)用于让飞书 REST 与 WebSocket 流量走 HTTP(S) 代理。公开版不带默认代理:不配置即直连;配置了非法地址则会 fail-closed 报错,而不是静默直连。
参与贡献
见 CONTRIBUTING.md 与 SECURITY.md。开发、测试与发布:docs/development.md。
交流群
扫码加入 dsh-feishu 飞书交流群:

致谢
- PGZXB/dsh-feishu —— 本项目移植到 DSH 0.2.1-rc.5 的上游原版(MIT)。Host/Client 逻辑与配置向导均来自上游;本仓库保留编译产物
lib/,只修补宿主 API 的接缝。 - botmux —— 群聊交互模式的参考:流式卡片、审批,以及扫码驱动的开放平台快速接入流程。dsh-feishu 借鉴的是 botmux 的交互与接入模式,而非其架构——botmux 桥接外部 CLI,本插件则是 dsh 原生、进程内的。
- DeepSeek Harness —— 本插件所服务的平台。
- Lark Open Platform SDK —— 底层所用的 WebSocket 长连接与卡片 API。
License
MIT——见 LICENSE。