4t145/dsh-lark-connector
4t145★ 0TypeScriptLast synced: 2026-08-16
Feishu connector plugin for DeepSeek Harness
README excerpt
dsh-lark-connector 一个面向 DeepSeek Harness(DSH)的飞书连接器插件。 它把飞书机器人接入 DSH:飞书私聊或群聊中的消息可以进入独立的 DSH 会话,由 Agent 处理后再回复到原飞书消息。同时提供 Web 设置页,用于管理飞书凭据、连接状态以及新建飞书会话的默认配置。 功能特性 - 飞书 WebSocket 长连接:使用飞书官方 Node SDK 接收实时消息,不需要额外部署 Webhook 服务。 - 私聊与群聊支持:私聊消息直接响应;群聊仅响应明确 @ 机器人的文本消息。 - 会话隔离:每个飞书 chat 映射到独立的 DSH session;同一 chat 内按 FIFO 顺序处理,不同 chat 可以并发处理。 - 会话恢复与归档替换:使用 DSH session persistence 保存历史;归档后的 chat 会自动创建新的可见 session。 - 原生 DSH 会话标题:使用飞书聊天标题作为 DSH session 标题,并在消息中标注发送者信息。 - Workspace 归属:可将飞书会话归入指定 DSH workspace;未配置时使用宿主默认目录。 - 新会话默认配置:在 Web 设置页选择 Agent preset、Provider/Model 和 Workspace,应用于之后创建的飞书 session。 - 可靠回复:Agent 完成后将最终文本回复到原消息;超长文本自动分段,消息 ID 有界去重,避免长连接重放造成重复处理。 - 凭据管理:通过 DSH credentials 服务保存 App ID、App Secret、品牌和 lark-cli 路径,也支持环境变量和 .env 来源。 - lark-cli 集成:自动同步应用凭据到 lark-cli,并提供 lark setup、lark status 工具检查 CLI、官方 Skills 与连接状态。 - 中英文 Web 界面:设置页面文案跟随 DSH 当前语言。 安装 在 DSH profile 中安装本插件: 插件 bundle 安装后,重启 DSH Web Host。插件注册名为 lark-connector。 飞书应用配置 在飞书开放平台创建应用并启用机器人能力,然后: 1. 开通接收和发送消息所需的权限。 2. 在事件订阅中选择“使用长连接接收事件”。 3. 订阅 im.message.receive v1。 4. 将机器人加入需要响应的群聊。 Web 设置 打开 DSH 设置中的“飞书连接器”页面,可以配置: - App ID - App Secret - Brand(feishu 或 lark) - lark-cli 路径 - 飞书会话 Workspace - 新建飞书会话使用的 Agent preset - 新…
View full README on GitHub →