dsh-feishu-chat：DeepSeek Harness 飞书双向聊天桥

前言¶

DeepSeek Harness 的设计理念是“一切皆插件”。开发者需要将 Agent 连接到外部平台时，往往面临配置繁琐、连接不稳定的问题。现有的实现通常需要手动编辑配置文件，且难以在运行时动态调整工作区。

下面介绍 dsh-feishu-chat，这是一个用于连接飞书（Lark）机器人的插件，它通过官方 WebSocket 长连接实现双向聊天，并提供可视化的设置页面来管理机器人凭证和工作区路由。

这是一个客户端插件，旨在打通 DeepSeek Harness 与飞书机器人之间的通信。它不依赖手动编辑配置文件，而是通过界面填入 App ID 和 App Secret 进行连接，支持在运行时动态切换工作区。

凭证连接
通过设置页面填入 App ID 和 App Secret 即可建立连接，无需手动修改配置文件。凭证存储在本地 $DSH_HOME/feishu-bot/config 目录下。
工作区路由
设置页面列出了 Profile 已知的所有工作区。点击任意一行即可绑定该工作区，入站消息将路由至该工作区的最新会话。切换绑定关系无需重启 Harness。
双向聊天
消息通过飞书官方 WebSocket 长连接（im.message.receive_v1）接收。Agent 回复后，消息会自动发送回同一聊天窗口。
Agent 工具
Agent 可使用 feishu_send_message 工具向飞书发送消息。默认 chat_id 为最近联系过 DSH 的聊天。
长连接保障
插件在进程内维护长连接，支持 Protobuf 帧解码（pbbp2）、自动 ACK、Ping 保活、分片合并以及自动重连。

使用官方 CLI 安装插件：

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

安装后，重启 dsh web 进程（如果是本地开发，刷新浏览器即可）。在设置页面找到“飞书”选项：

在飞书发送消息给机器人，DSH Agent 会接收到消息并生成回复。Agent 也可以在运行时调用 feishu_send_message 工具主动向用户发送消息。

权限与来源
这是一个社区第三方插件。安装后它将以当前 DSH 进程的权限运行，请确保在安装前检查源码和许可证（MIT）。
消息处理
每条入站消息会生成一个子 Agent（无队列机制）。在消息密集时，回复可能会出现乱序。
网络环境
插件在底层使用了 rejectUnauthorized: false 放宽了 TLS 验证，以便在公司代理或证书存储损坏的环境中工作。请根据实际环境评估安全风险。
配置位置
凭证仅在本地保存，不会上传或提交到仓库。

dsh-feishu-chat 为需要在飞书平台上与 DeepSeek Harness Agent 交互的开发者提供了一个无需手动配置文件的解决方案。通过官方 WebSocket 长连接和可视化的设置页面，它简化了双向聊道的搭建流程。