dsh-feishu-gateway

English | 中文

在**飞书（Feishu/Lark）**里与你的 DeepSeek Harness（DSH） agent 对话。

这是一个 DSH 插件 bundle：挂载飞书长连接监听器，每条飞书消息路由到稳定的 DSH 会话 （通过 agents 服务的 resume 恢复，多轮对话保持在同一个会话），agent 的最终答复以 Markdown 富文本（post 消息的 md 标签）回复。支持 /new 开启全新会话、可配置的 "处理中"提示语、以及主动推送。

功能

• 💬 完整对话 — 飞书私聊 / 群聊 @机器人 → DSH agent → 回复
• 🔁 会话保持 — 每个飞书会话对应一个 DSH 会话（agents.resume / agents.create）； 发 /new（或"另起会话 / 新会话 / 重新开始 / 换个话题"）开启全新会话
• ✍️ Markdown 回复 — 用普通富文本（post）消息的 md 标签：粗体、行内代码、 列表、链接原生渲染，无需卡片
• 🤖 完整 agent 能力 — DSH agent 自带模型与工具（bash、文件、子代理…），完全自主
• 📨 主动推送 — 可选管理 HTTP API（/api/push），随时向用户/群推送文本、Markdown、卡片
• 🔌 无需公网 — 飞书长连接，不需要回调地址
• 🗂 持久化 — 飞书↔DSH 会话映射重启不丢

环境要求

• 已安装并构建的 DeepSeek Harness（dsh CLI），并配置好 DEEPSEEK_API_KEY （agent 直接使用 DSH 当前模型，无需另配）
• 一个飞书开放平台企业自建应用，已开启机器人能力（见下）

飞书应用配置

1. 飞书开放平台 → 创建企业自建应用。
2. 开启机器人能力。
3. 开通权限：im:message、im:message:send_as_bot（如需读取消息内容再加 im:message:send_as_bot:readonly），然后创建版本并发布。
4. 事件与回调 → 选择使用长连接接收事件，订阅 im.message.receive_v1（无需公网）。
5. 在飞书客户端搜索应用名，添加机器人为联系人。

安装（作为 DSH 插件）

前提：本包已发布到 npm，且 dsh 命令可用。

方式一（推荐）：运行本仓库的一键脚本

./scripts/create-profile.sh