DSH（DeepSeek Harness）生态遵循“一切皆插件”的理念，开发者通常通过命令行或 API 与 Agent 进行交互。如果需要在飞书（Lark）客户端中直接与 Agent 对话，需要一个中间层来处理消息的收发与协议转换。minyang2020/dsh-feishu-bridge 正是这样一个双向桥接器，它让飞书用户能通过长连接直接与本地运行的 DSH Agent 进行交互。
这是一个在飞书里直接和你的 DeepSeek Harness Agent 对话的双向桥接器。项目由用户 minyang2020 维护，采用 MIT 许可证。它通过飞书长连接与本地正在运行的 DSH 进程通信，实现消息的实时收发。
核心功能¶
- 会话隔离与触发：私聊模式下，每个飞书用户自动绑定一个独立的 DSH 会话，上下文互不干扰。群聊模式下，只有被 @机器人 时才会响应，回复发送回群里。
- 流式与富交互：Agent 回复支持流式输出，以 cardkit 打字机卡片逐字上屏（权限缺失时自动降级为普通文本）。支持审批转发，当 Agent 请求权限时，飞书端收到确认文本；支持提问转发，Agent 提问时以序号或选项格式回复。
- 连接与安全：飞书长连接与 DSH 事件流均支持断线重连。飞书长连接由本机主动发起，零公网依赖，无需开放端口。插件运行在本机 DSH 进程权限下，安全性由本地环境保障。
安装与启用¶
- 安装插件：
使用官方命令安装插件包feishu-dsh-bridge：
dsh plugin --profile <名字> add feishu-dsh-bridge
- 配置插件：
在 profile 的cordis.patch.yml文件中添加配置项（示例）：
- id: feishu-dsh-bridge
config:
appId: cli_xxxxxxxxxxxxxxxx
appSecret: your_app_secret
dshBaseUrl: http://127.0.0.1:3200
sessionCwd: D:\workspace
典型用法¶
- 私聊：在飞书搜索应用名，发起单聊即可开始对话。
- 群聊：在群设置中添加机器人，之后只有 @机器人 才会触发响应。
- 控制任务：在对话中使用
/stop可以取消当前会话正在进行的任务。 - 配置调整：绑定关系持久化在
state/mapping.json文件中。流式输出默认开启，可通过设置环境变量STREAMING=false关闭；STREAM_UPDATE_INTERVAL_MS可控制卡片刷新节流。
注意事项¶
- 安全：
.env文件包含真实凭据，已加入.gitignore，切勿提交。state/目录包含会话绑定信息，同样不提交。 - 权限生效：飞书开放平台的权限配置和事件订阅需要「发布版本」后才生效。若长连接连不上，请检查飞书端权限配置是否已发布。
- 功能限制：当前仅支持文本消息。图片、文件、富文本消息暂不支持（会提示仅支持文本）。
- 网络与运行：桥接只监听本机 DSH 的 loopback API，飞书侧凭据按租户隔离。
该插件通过长连接方式，为 DSH Agent 提供了直接接入飞书的入口，适合需要在企业内部通讯工具中调试或使用 Agent 的场景。更多细节与源码，请访问 GitHub 仓库。
