dsh-lark-channel

English | 中文

DeepSeek Harness 的飞书/Lark IM 机器人渠道插件。每个会话（单聊或群聊）驱动一个独立的 DSH Agent；助手的推理与工具调用以平台原生的思考过程呈现，最终答案单独发送，宿主的审批问题变成交互卡片，按钮点击即作答。

传输层使用 @larksuite/channel，WebSocket 长连接，无需公网回调地址。

• 能力
• 环境要求
• 快速开始
• 配置
• 行为
• 已知限制
• 开发

能力

• 每个会话一个 Agent。sessionScope 决定粒度：整个会话、单个话题、或共享会话里的单个发送者。session id 跨重启稳定。
• 两种输出模式：cot 用平台原生思考过程，stream 每轮一张打字机卡片，供旧客户端使用。
• 以 / 开头的一行作为宿主命令执行，不开模型轮次。/stop 停止当前轮次，/help 列出可用命令。
• 宿主的审批问题变成带「允许一次 / 拒绝」按钮的卡片，点击即结算，卡片改写为决定结果。
• 图片可选开启，下载后提交到宿主附件存储，随消息进入模型。
• 每条回复指向提出它的那条消息，原消息在话题里时回复也留在话题内。
• 授权只在平台的应用可用范围内收窄，所有名单默认为空。
• 未配置凭证时启动即画二维码，扫码经官方流程创建应用，含事件订阅。

环境要求

• Node ^22.19.0 || >=24.0.0，pnpm 11.7。
• 一个 DeepSeek Harness 部署（dsh 0.1.0-rc.6 或更新）。@deepseek-ai/cordis（^4.0.1）是 peer 依赖，由宿主提供。
• 飞书或 Lark 租户。应用本身可以由首次启动的扫码流程创建。
• cot 输出要求客户端能渲染思考过程：PC 7.70、移动端 7.74。更旧的客户端用 output: 'stream'。

快速开始

npx @deepseek-ai/dsh plugin --profile web add --allow-build=dsh-lark-channel github:Roy-oss1/dsh-lark \
  && npx @deepseek-ai/dsh web

控制台会打印一个二维码。用飞书扫它，应用即创建完成，渠道无需重启即建连。在 Settings → Models 里填 DeepSeek API key，然后私聊机器人或在群里 @ 它。

已经在用 dsh？把两处 npx @deepseek-ai/ 前缀去掉即可。

组合细节、二维码有效期与 invariant 伴生行

包清单声明了 dsh.bundle.patch: ./cordis.patch.yml，安装进 profile 时其 patch 行叠加到 profile 组合上。凭证可在 patch 中使用 !!js process.env.…。

一个二维码的有效期由平台下发（当前是 60 分钟），没人扫就自动换一个，所以晚点再来也总有一个能用的码；被拒绝或请求失败则停下并说明原因，需要重启重新发起。要重置已存凭证，删除 settings 文档里的 lark-channel 段即可，其路径可从宿主 settings 界面获得；settings 层存在期间会覆盖入口配置的值。