dsh-feishu-chat

dsh plugin --profile web add dsh-feishu-chat

dsh-feishu-chat

飞书机器人 ↔ DeepSeek Harness 双向聊天桥：给飞书机器人发消息，DSH 智能体自动回复；智能体也能主动往飞书发消息。

功能

• 填写 App ID / App Secret 即可连接飞书机器人 — 装好插件，打开 设置 → 飞书，把飞书开放平台 → 你的应用 → 凭证与基础信息 里两项值粘进去，点保存并重新连接，长连接就起来了，全程不需要手改配置文件。
• 随时切换绑定工作区 — 同一个设置页会列出 profile 已知的所有工作区（名称 + 路径 + 最近活动时间），点哪一行就把入站飞书消息重新路由到那个工作区；选择会被持久化，路由器在线热切换，无需重启 DSH。
• 双向聊天 — 飞书消息经官方 WebSocket 长连接（im.message.receive_v1）到达 DSH，委派给当前绑定工作区最新会话的子代理处理，纯文本回复自动发回原聊天。
• 智能体 → 飞书工具 — 模型获得 feishu_send_message 工具，任意会话都能把消息推给最近联系过 DSH 的飞书聊天（或指定 chat_id）。
• 稳定的长连接 — protobuf 帧解码（pbbp2）、自动 ack、ping 保活、sum/seq 分片合并、断线退避重连，全部在宿主进程内完成；停止或更新插件时全部清理干净。

安装

# 从 npm（发布后）或本仓库：
dsh plugin --profile web add dsh-feishu-chat
# 或直接从 GitHub：
dsh plugin --profile web add github:Qing45/dsh-feishu-chat

重启 dsh web，打开 设置 → 飞书：

1. 连接机器人 — 填写机器人 App ID 与 App Secret（飞书开放平台 → 你的应用 → 凭证与基础信息），点保存并重新连接。状态行变绿就表示长连接已建立。

2. 选择工作区 — 工作区列表展示 profile 已知的所有工作区（名称 + 路径 + 最近活动时间）。点哪一行就绑定哪个，入站飞书消息就会路由到该工作区最新会话。之后可以随时切换，无需重启。

⚠️ 本插件是社区第三方代码 —— 安装即表示你信任该来源。凭证只保存在本机 $DSH_HOME/feishu-bot/config.json，不会被提交或上传。

工作原理

组成 · 文件 · 职责

Host 入口 · lib/index.js · Cordis 插件（export const name + export function apply），串联配置、路由、WS、工具与 HTTP 路由

飞书 API · lib/feishu.js · node:https 助手：租户令牌、发消息、WS 端点

WS 客户端 · lib/ws.js · 进程内长连接：protobuf pbbp2.Frame、自动 ack、ping、分片合并、重连

路由 · lib/router.js · 入站消息 → 解析父代理（initiator → live agent → resume）→ 子代理 → 回复

配置 · lib/config.js · $DSH_HOME/feishu-bot/config.json 持久化

HTTP 路由 · lib/routes.js · 设置页所用路由（写操作仅限同源）

Client · client/client.js · window.__ModuleLoader__.load bundle，注册 设置 → 飞书 页面

本包是标准 DSH bundle：package.json 声明 dsh.bundle.patch（层插入）与 dsh.client（web bundle），cordis.patch.yml 把插件行插入 profile 树。

本地开发安装（免重启 GUI）

profile 自己的补丁层（$DSH_HOME/profiles/<profile>/cordis.patch.yml）支持热加载：

pnpm --dir "$DSH_HOME/profiles/web" add /path/to/dsh-feishu-chat

然后在 cordis.patch.yml 末尾追加：

- insert:
    - id: feishu-bot
      name: 'dsh-feishu-chat'

刷新浏览器即可在设置页看到「飞书」，无需重启。

注意事项

• 每条入站消息会生成一个子代理（无排队），突发消息时回复可能乱序。
• 出于兼容（企业代理 / 证书存储损坏的环境），TLS 校验被放宽（rejectUnauthorized: false），请自行评估该取舍。
• 工具名为 feishu_send_message；省略 chat_id 时发给最近联系过 DSH 的飞书聊天。

License

MIT