shifan3/dsh-feishu-bridge

README 摘要

dsh-feishu-bridge 飞书（Feishu / Lark）桥接插件，用于 DeepSeek Harness（DSH）。 通过 飞书长连接（WebSocket） 接收机器人消息 → 交给一个拥有完整工具集的 常驻 Agent 执行命令 → 再通过飞书机器人回复。不需要公网 IP / 域名 / 内网穿透，本机能访问公网即可。 架构 - helper.mjs ：用官方 @larksuiteoapi/node-sdk 的 WSClient 主动外连飞书服务器，接收 im.message.receive v1 事件。 - index.js ：宿主插件，负责创建常驻 Agent、注册桥接路由、处理 / 命令、回发消息与 typing 指示器。 前置条件 - 已部署 DSH，并能以 dsh web （web profile）启动。 - 本机 Node.js ≥ 18（ fetch / WebSocket 均可用）。 - 一个飞书 企业自建应用 （含机器人能力）。 第一步：配置飞书应用 1. 打开 open.feishu.cn/app → 创建 企业自建应用 → 添加「 机器人 」能力。 2. 权限管理开启： im:message （获取与发送消息）、 im:message.p2p msg （单聊）、 im:message.group at msg （群聊 @）、以及消息表情回复权限（ im:message.reaction ，用于 typing 指示器）。 3. 事件与回调 → 订阅事件 im.message.receive v1 ，订阅方式选「 使用长连接接收事件 」。 4. 创建版本并 发布 （个人租户需管理员审批通过后机器人才生效）。 5. 在「凭证与基础信息」复制 App ID 和 App Secret 。 第二步：安装插件 第三步：配置凭证（二选一） 方式 A：环境变量（推荐） 方式 B：本地 config.json（已 gitignore，不会进仓库） 凭证优先级：环境变量 FEISHU APP ID / FEISHU APP SECRET config.json 。 第四步：挂载到 web profile 编辑 /.dsh/profiles/web/cordis.patch.yml ，加入： 重启 dsh web 即可生效。启动日志出现 [feishu-bridge] 与 [feishu-helper] 即表示加载成功。 内置命令 在飞书里直接发送： 命令 作用 /help 显示命令帮助 /new 新建会话（重置） /reset 重置当前会话 /sessions 列出会话（ 为当前） /session 切换 / 新建会话 /cd 切换 workspace（相对 / / / 绝对路径）， 会重置会话 /status 当前状态 /context 当前…

分类