前言¶

DSH 生态里，渠道能力通常以插件形式接入。如果你希望在飞书或国际版 Lark 中使用 DeepSeek Harness，并且需要处理文本、图片、普通文件、持久会话和工具审批，而不是只做单轮文本问答，就需要一个能承接这些能力的渠道插件。

相比需要公网回调服务器的接入方式，sliverp/DeepSeek-harness-lark 使用官方 WebSocket 传输，不需要公网回调服务器，并支持飞书和国际版 Lark。下面介绍它的定位、核心能力、安装配置和典型用法。

这是什么¶

sliverp/DeepSeek-harness-lark 是一个 DeepSeek Harness channel bridge，用于把飞书 / Lark 的文本、图片和文件接入 DSH。

关键信息如下：

• 仓库：sliverp/DeepSeek-harness-lark
• 维护者：sliverp
• 许可证：MIT
• 基础：官方 @larksuiteoapi/node-sdk
• 传输：官方 WebSocket，自动重连
• 适用：飞书和国际版 Lark

核心功能¶

消息与会话¶

• 支持文本、富文本、图片和普通文件输入。
• 每个聊天维护持久、隔离的 Harness 会话。
• 发送 /new 会保留旧历史，并切换到空白会话。
• 创建和恢复会话时都会挂载并记录 Agent preset，默认 preset 是 standard。
• 支持直聊和群聊访问策略；群聊默认需要 @ 机器人。

文件与多模态¶

• 支持 Durable Harness attachments，并按模型能力组织多模态输入。
• 普通文件会下载到 Agent workspace 的 .dsh-lark/inbox/，方便文件系统工具检查。
• 回复支持模型文本、生成图片上传和工作区文件发送。

命令与审批¶

• 已注册的 Harness slash commands 直接执行，不作为普通消息发送给模型。
• 同一会话内可以使用 /approve <code> 和 /reject <code> 完成一次性工具审批。
• 提供以下命令：
• /bot-ping
• /bot-help
• /bot-image-test
• /bot-file-test
• /bot-status
• /bot-cancel

凭据与启动¶

• App Secret 通过 Harness credential service 解析。
• 如果未配置 App ID 或 App Secret，插件会处于 dormant startup。
• 仅安装插件不会阻塞 Harness Web。
• 凭据缺失或无效时，该渠道离线并记录日志，不会阻塞 Harness 启动。

安装与启用¶

环境要求¶

Node.js 22.19 or later
pnpm 10.33.4
DeepSeek Harness 0.1.0-rc.7 or later

安装¶

先安装插件，再配置飞书 / Lark 应用凭据：

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-lark

配置飞书 / Lark 应用¶

1. 在飞书开发者控制台创建自建应用，并启用 bot 能力。
2. 授予以下权限：

im:message.p2p_msg:readonly
im:message.group_at_msg:readonly
im:message:readonly
im:message:send_as_bot
im:resource

其中，im:message:readonly 用于飞书消息资源下载端点，处理用户发送的图片和文件；im:resource 仍用于机器人侧图片 / 文件上传。

3. 选择长连接事件投递，并订阅 im.message.receive_v1。
4. 发布应用版本，并把机器人加入需要使用的聊天。
5. 将 App ID 放入 LARK_APP_ID，并把 App Secret 存到 Harness credential reference LARK_APP_SECRET。

开发环境可以临时注入环境变量：

export LARK_APP_ID='<app-id>'
export LARK_APP_SECRET='<app-secret>'
pnpm dsh --profile web

为了长期使用，将 App ID 放入 ~/.dsh/.env，并通过 Harness credential 设置界面保存 App Secret。不要提交凭据。

典型用法¶

基础检查¶

在聊天中依次发送：

/bot-ping
/bot-image-test
/bot-file-test
/new

这一步用于检查基本连通性、图片测试、文件测试和新建会话。

文件检查与发送¶

发送普通文本、一张图片和一个 CSV 文件，然后要求机器人检查 CSV，并确认它使用的是已下载到工作区的路径。

接着要求它创建并发送一个 CSV。最终回复应包含文件附件。

工具审批¶

发起一个需要审批的操作，然后使用给出的精确指令回复：

/approve <code>

或者拒绝该操作：

/reject <code>

限制与注意¶

• 访问策略支持 open、allowlist、disabled。生产环境建议使用 allowlists 和最小权限 Harness permissions。
• 入站默认值：单条消息允许 10 个文件，单文件最多 50 MiB，单条消息总大小最多 100 MiB。
• 出站默认值：一条回复最多发送 5 个非空文件，每个最多 30 MiB。
• approvalTimeoutMs 必须小于 responseTimeoutMs。
• agentPreset 是新建会话和没有 preset 的持久化记录的显式回退值。
• 工具循环修复会把插件会话命名空间从 lark-v1-* 推进到 lark-v2-*。旧文件不删除、不改写，但插件不再追加到可能受 DSML 污染的 lark-v1-* 记录；旧记录仍可在 Web UI 中查看。
• 插件会以当前 dsh 进程权限运行。安装前建议先检查源码和 MIT 许可证。

结尾¶

如果需要在飞书 / Lark 内使用 DeepSeek Harness，并且重点是文本、图片、文件、持久会话和审批，sliverp/DeepSeek-harness-lark 提供了一个不需要公网回调服务器的接入方式。

社区目录为独立站点，不代表 DeepSeek / 幻方官方应用商店。仓库地址：

https://github.com/sliverp/DeepSeek-harness-lark

线索给出的目录页，以实际收录为准：

https://www.skillhub.cn/plugins/sliverp/DeepSeek-harness-lark