飞书适配器 AtinyFurina/dsh-adapter-feishu

dsh-adapter-feishu

DeepSeek Harness 的飞书适配 Cordis 插件。使用飞书「长连接」模式（WebSocket），不需要公网 IP、域名或内网穿透，大陆网络直连可用。

工作原理

- 飞书长连接推送 im.message.receive_v1 事件（@机器人 或与机器人单聊）。
- 每个飞书会话（chatId）对应一个 DSH Agent，会话上下文持久保留。
- Agent 的回复按 900ms 增量流式发回飞书，自动分片，群聊自动 @ 发送者。
- 机器人自己的消息、重复推送的事件都会被过滤。

安装（本机部署方式）

1. 依赖安装（一次性）：

npm.cmd install --prefix C:\Users\AtinyFurina\.dsh\profiles --no-save @larksuiteoapi/node-sdk

2. 插件文件放在 web 配置目录：

C:\Users\AtinyFurina\.dsh\profiles\web\plugins\dsh-adapter-feishu\index.mjs

3. 在 C:\Users\AtinyFurina\.dsh\profiles\web\cordis.patch.yml 中加一行：

- id: ./plugins/dsh-adapter-feishu/index.mjs
config:
appId: cli_xxxxxxxx
appSecret: xxxxxxxxxxxxxxxx

保存后配置文件会被热加载；未生效时重启 dsh web。

飞书控制台操作清单

1. 打开 https://open.feishu.cn/app 创建「企业自建应用」。
2. 凭证与基础信息 → 记录 App ID 与 App Secret。
3. 添加应用能力 → 启用「机器人」。
4. 权限管理 → 开通：
- im:message 获取与发送单聊、群组消息
- im:message.p2p_msg 获取用户发给机器人的单聊消息
- im:message.group_at_msg 获取群组中 @机器人的消息
- im:message:send_as_bot 以应用身份发消息
5. 事件与回调 → 事件订阅 → 订阅方式选「使用长连接接收事件」→ 添加事件「接收消息 im.message.receive_v1」。
6. 版本管理与发布 → 创建版本并发布（企业自建应用需管理员审核或自动通过）。
7. 在飞书里搜索机器人名字，加进群或单聊，发消息即可。

配置项

- appId / appSecret 必填。
- cwd 给 Agent 的工作目录，默认 dsh 进程的工作目录。
- chunkSize 单条飞书消息最大字符数，默认 2000。
- flushIntervalMs 回复增量发送间隔(ms)，默认 900。
- mentionSender 群聊回复时是否 @ 发送者，默认 true。
- allowChats 白名单 chatId；非空时只处理这些会话。
- denyChats 黑名单 chatId。
- resetCommand 发该指令重置当前会话上下文，默认 /reset。
- stateFile 会话映射持久化文件，默认插件目录下 state.json。
- verbose 是否打印调试日志。

注意

管理命令（飞书里发给机器人）

- /help 查看命令列表
- /ws 列出所有工作区及其会话
- /ws add 注册新工作区
- /ws use 本对话绑定该工作区（下条消息新建会话）
- /agents 列出所有工作区中的所有会话（活跃/运行中/存档）与未归入工作区的活跃会话
- /use 本对话接管已有会话，续写其上下文
- /bind 查看本对话当前绑定
- /reset 重置本对话会话

注意

- 长连接模式仅支持企业自建应用；飞书要求事件回调 3 秒内返回，本插件在回调内只做入队，Agent 执行完全异步，满足该约束。
- 每个应用最多 50 个长连接；同一应用多客户端部署时事件随机发给其中一个。