前言¶
DeepSeek Harness (Cordis) 提供了构建智能体的基础框架。在对接即时通讯（IM）时，通常需要配置公网 IP 和回调服务器来接收事件。本插件基于飞书官方 @larksuiteoapi/node-sdk，使用官方 WebSocket 长连接接收事件，省去了配置回调服务器的步骤。
插件由 tkwkeven 维护，同时提供两个插件入口：一个用于消息通道桥接，另一个用于进程重启后的恢复通知。安装后，它会自动插入配置到 Harness 的 cordis.patch.yml 中。
功能特性¶
- 消息通道桥接：基于 WebSocket 长连接的消息通道桥接，支持飞书中国版与国际版。
- 并行任务会话：支持创建独立的、可持久化的 Harness 会话，并在各自的话题中运行，带有实时流式交互卡片。
- 媒体处理：支持媒体入站（文件、语音、视频）和出站（通过斜杠命令或模型标记），支持超大文件自动降级与云空间上传。
- 云文档支持：支持飞书云文档的读取与生成。
- 进程恢复通知：进程重启完成后，向发起重启的聊天发送恢复提示。
- 无需公网环境：无需配置公网 IP 和回调服务器即可运行。
安装与启用¶
安装前请确保已安装 Node.js 22.19 或更高版本，并已安装 DeepSeek Harness。
执行以下命令进行安装：
pnpm dsh plugin --profile web add https://github.com/tkwkeven/dsh-lark-all/releases/download/v1.0.0/dsh-lark-all-1.0.0.tgz
安装完成后，插件会自动插入配置到 Harness 的 cordis.patch.yml 中。你需要确保已通过 Harness 凭据服务解析 App Secret，并在飞书开放平台配置好权限。
典型用法¶
基础命令¶
在聊天中发送以下命令以进行连通性检查或查看状态：
/bot-ping：连通性检查，返回pong。/bot-help：查看命令帮助。/bot-status：查看连接状态。
并行任务会话¶
在聊天中发送以 任务： 开头的消息，即可创建独立会话：
任务：帮我调研一下开源社区的 Cordis 插件生态
ptc任务：写一个 PowerShell 脚本批量重命名文件
任务执行过程中会显示流式卡片，任务完成后报告以回复形式投递。在任务话题中继续发消息即可继续该会话。
发送媒体¶
可以使用斜杠命令或模型标记的方式发送文件、图片、语音或视频：
/bot-send-file C:\path\to\demo.txt
/bot-send-image C:\path\to\photo.png
模型在回复中单独一行输出 [lark-file: 路径] 也可以附带媒体。
接收媒体¶
接收到的文件、语音、视频会自动下载到 <cwd>/.lark-inbox/ 目录，文本类文件附带内容预览。原图若超过附件限制，会自动降级为工作区文件。
注意事项与适用场景¶
- 依赖要求：需要
Node.js >= 22.19，且依赖@larksuiteoapi/node-sdk与 DeepSeek Harness 的相关 peer dependencies。 - 凭据安全：App Secret 不写入插件配置，必须通过 Harness 凭据服务解析，建议使用环境变量注入 App ID。
- 平台配置：需要在飞书开放平台配置权限，并在“事件与回调”中启用“使用长连接接收事件”。
- 运行权限：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
结尾¶
该插件通过整合消息通道与运维通知功能，降低了 DeepSeek Harness 在飞书/Lark 环境下的接入成本。更多配置细节与源码，可参考 GitHub 仓库。
