前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的架构。当需要在 DSH 中集成飞书消息时，通常需要自行开发 Webhook 服务来接收和转发消息。dsh-lark-connector 插件通过飞书官方 SDK 提供长连接，将飞书消息直接接入 DSH 会话，由 Agent 处理后通过飞书回复，无需额外的消息中转服务。
功能特性¶
该插件包含以下核心能力：
- 飞书 WebSocket 长连接：使用官方 SDK 接收实时消息，无需部署外部 Webhook。
- 私聊与群聊支持：私聊消息直接响应；群聊仅响应明确 @ 机器人的文本消息。
- 识图能力：支持 PNG/JPEG/WebP/GIF 格式，自动下载并持久化到 DSH 附件存储，供视觉模型处理。
- 会话隔离与恢复：每个飞书
chat映射到独立的 DSH session，支持 FIFO 顺序处理。 - 原生 DSH 会话标题：使用飞书聊天标题作为 DSH session 标题，并在消息中标注发送者信息。
- Workspace 归属：可将飞书会话归入指定 DSH workspace。
- 新会话默认配置：在 Web 设置页配置 Agent preset、Provider/Model 和 Workspace，应用于后续创建的飞书 session。
- 可靠回复：支持超长文本分段，通过消息 ID 有界去重防止重复处理。
- 凭据管理：支持通过 DSH credentials 服务或环境变量保存 App ID、App Secret 等。
- lark-cli 集成：自动同步凭据到 lark-cli，提供配置检查工具。
- 中英文 Web 界面：设置页面文案跟随 DSH 当前语言。
安装与启用¶
插件已发布在 npm，安装路径需替换为实际源码路径：
dsh plugin --profile web add /path/to/dsh-lark-connector
安装完成后，重启 DSH Web Host。插件注册名为 lark-connector。
配置¶
Web 设置页¶
在 DSH 设置的「飞书连接器」页面，需配置以下项：
- App ID：飞书应用 ID
- App Secret：飞书应用密钥
- Brand：品牌标识，通常为
feishu或lark - lark-cli 路径：lark-cli 可执行文件路径，留空则从系统 PATH 查找
- 飞书会话 Workspace：指定飞书会话归属的 DSH workspace
- 新建会话默认配置：Agent preset、Provider、Model 等
- 卡片展示选项：是否添加 THINKING 表情、是否使用交互卡片流式更新、是否展示工具调用等
环境变量¶
凭据支持通过环境变量配置，优先级高于 Web 页面保存的值：
| 变量名 | 作用 |
|---|---|
LARK_APP_ID |
飞书应用 App ID |
LARK_APP_SECRET |
飞书应用密钥 |
LARK_BRAND |
品牌，通常为 feishu |
LARK_CLI_PATH |
lark-cli 可执行文件路径 |
lark-cli 集成¶
插件提供两个 DSH 工具：
lark_setup：检查 lark-cli 和官方 Agent Skills，可选择执行官方安装器。lark_status：查看应用配置、CLI 版本和连接状态。
使用与注意事项¶
典型用法¶
- 在飞书开放平台创建应用并启用机器人能力，订阅
im.message.receive_v1事件。 - 在 DSH Web 设置页配置 App ID、App Secret 等凭据。
- 使用
lark_setup工具检查环境。 - 在飞书群聊中 @ 机器人以开始交互。
注意事项¶
- 群聊响应：群聊仅响应明确 @ 机器人的文本消息。
- 附件限制：图片超出单条消息附件数量上限会被忽略。
- 环境变量优先级：环境变量优先级高于 Web 页面保存的凭据。
- 归档行为：归档后的 chat 会自动创建新的可见 session。
生态与维护¶
dsh-lark-connector 是一个社区插件，由开发者 4t145 维护。
- 许可证：MIT
- 项目地址：https://github.com/4t145/dsh-lark-connector
- 插件目录：https://www.skillhub.cn/plugins/4t145/dsh-lark-connector
