LittleInk/dsh-feishu-bot

README 摘要

dsh-feishu-bot — 飞书机器人接入 DeepSeek Harness（一键安装） 把 DeepSeek Harness 接进飞书：在飞书里和本机 agent 对话，agent 的回复发回飞书。 使用 飞书官方 SDK 的 WebSocket 长连接 ——无需公网 IP、无需端口映射、无需内网穿透。 特性 - ✅ 每飞书会话一个独立 DSH agent，多轮上下文连续（映射持久化 $DSH HOME/feishu-sessions.json ） - ✅ 断线自动重连（30 秒 watchdog）、token 自动刷新 - ✅ 私聊 / 群聊（@机器人）都支持 - ✅ 纯文本 + 富文本（post）消息 都支持（自动提取文字内容；post 里粘贴的图片也会下载识别） - ✅ 图片消息 支持：自动下载到 $DSH HOME/feishu-images/ ，并引导 agent 用识图脚本 （vision.js）识别内容后回复；文件/卡片/语音等暂忽略 - ✅ 提问闭环 ：agent 需要确认时会先把问题发到飞书，你直接回复答案即可（不会卡住） - ✅ 可选 open id 白名单 - ✅ 完整工具集 ：飞书会话自动挂载 agent preset（默认 standard ，与 Web 会话一致）， 文件读写、Shell、Web 搜索、Skills、目标、计划模式、子代理、工作流、Todo 等全部可用 环境要求 依赖 说明 DeepSeek Harness (dsh) 已安装并至少启动过一次（生成 $DSH HOME/profiles ） Node.js ≥ 22 自带 npm（用于自动安装飞书 SDK） 飞书开放平台应用 见下方第 1 步 一键安装（约 5 分钟） 第 1 步：飞书开放平台创建应用（一次性） 1. 打开 ，飞书账号登录 → 开发者后台 → 创建企业自建应用 。 2. 应用详情 → 添加应用能力 → 机器人 → 启用。 3. 事件与回调 → 事件配置 ： - 订阅方式选 「使用 长连接 接收事件」 。 - 添加事件 ： 接收消息 im.message.receive v1 （v2.0）。 4. 权限管理 （应用身份， 4 个全部开通，缺一不可 ）： 权限标识 名称 必需原因 im:message.p2p msg:readonly 读取用户发给机器人的单聊消息 私聊收消息 im:message 获取与发送单聊、群组消息 收发消息基础权限 im:message.group msg.include bot:read 获取群组中用户和机器人发送的消息 群聊收消息 im:message:send as bot 以应用的身份发消息 机器人回复 5. 版本管理与发布 → 创建版本 → 发布 （⚠️ 改配置后必须发布新版本才生效）。 6. 应用 可用范围 …

分类