dsh-lark：DeepSeek Harness 的飞书与 Lark 集成插件

dsh-lark 是 DeepSeek Harness（DSH）的飞书与 Lark 集成插件（DSH plugin），由 sugarforever 维护，采用 MIT 协议，使用 TypeScript 编写。它解决的核心问题是：让用户无需公网服务器、域名或 Webhook 回调地址，即可直接从飞书或 Lark 与 Harness Agent 对话，并复用 Harness 中已配置的模型、工具、系统提示和会话存储。插件基于飞书官方 @larksuiteoapi/node-sdk 的 Channel API，通过 WebSocket 长连接接收消息，自动处理重连、去重、串行处理与消息格式转换，并将飞书会话映射到 Harness Session。

dsh-lark 这个 DSH plugin 支持哪些核心特性？

插件支持飞书中国版和国际版 Lark，单聊和普通群聊按聊天复用 Harness Session，话题群按线程使用独立 Session，回复会关联原始消息并保留在话题线程中。群聊默认需要 @机器人，单聊默认开放，并可通过白名单限制用户。会话标识经过 SHA-256 处理，避免原始 chat_id 泄露，Harness 内部错误不会直接发送给用户。此外，可以为飞书渠道指定模型，或沿用 Harness 默认模型。

dsh-lark 怎么安装？

安装前需确保 Node.js 版本为 ^22.19.0 或 >=24.0.0，并已安装 DeepSeek Harness 0.1.0-rc.6 或更高版本。若尚未运行 Harness，可先启动 Web Profile：

npx @deepseek-ai/dsh web

然后通过以下命令安装插件：

dsh plugin --profile web add github:sugarforever/dsh-lark

安装后插件保持启用，但需在 Harness Settings 中配置 App ID 和 App Secret 后才会建立连接。

dsh-lark 如何配置飞书应用？

需在飞书开发者后台创建企业自建应用，启用机器人能力，并添加权限：im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:send_as_bot。若需处理群聊中未 @机器人的消息，需额外开通 im:message.group_msg 并设置 requireMention: false。事件订阅选择“使用长连接接收事件”，添加 im.message.receive_v1，无需填写 Webhook 地址。

dsh-lark 如何启动与使用？

启动 Harness Web Profile 后，在 Settings 的“飞书与 Lark”页面配置 App ID、App Secret、域名、访问策略和 Agent 参数。Provider 和 Model 来自 Harness 模型目录，留空则跟随默认配置。App Secret 通过 Credentials 保存，不会写入普通 Settings。配置完成后，即可在飞书中与机器人对话。

dsh-lark 兼容哪些 DeepSeek Harness 版本？

插件兼容 DeepSeek Harness 0.1.0-rc.6 及更高版本，通过 CI 持续验证最新发布版本，升级到后续 RC 通常无需重新发布插件。插件将 Harness 服务包声明为 optional peer，适配 DSH 的 Bundle 加载机制，不会重复安装 Harness。

查看更多 DSH 插件，访问 dsh-plugin.org