dsh-feishu-bridge

飞书（Feishu / Lark）桥接插件，用于 DeepSeek Harness（DSH）。

通过飞书长连接（WebSocket）接收机器人消息 → 交给一个拥有完整工具集的常驻 Agent 执行命令 → 再通过飞书机器人回复。不需要公网 IP / 域名 / 内网穿透，本机能访问公网即可。

架构

飞书用户 → 飞书云 ←WS 长连接→ helper.mjs(本地) --POST--> 插件路由 → 常驻 Agent(执行命令) → 飞书 API 回复

• 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。

第二步：安装插件

mkdir -p ~/.dsh/plugins
git clone https://github.com//dsh-feishu-bridge.git ~/.dsh/plugins/feishu-bridge
cd ~/.dsh/plugins/feishu-bridge
npm install

第三步：配置凭证（二选一）

方式 A：环境变量（推荐）

export FEISHU_APP_ID=cli_xxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxx

方式 B：本地 config.json（已 gitignore，不会进仓库）

cp config.example.json config.json
# 编辑 config.json，填入 appId / appSecret / cwd（工作目录）等

凭证优先级：环境变量 FEISHU_APP_ID / FEISHU_APP_SECRET > config.json。

第四步：挂载到 web profile

编辑 ~/.dsh/profiles/web/cordis.patch.yml，加入：

- insert:
    - id: feishu-bridge
      name: '../../plugins/feishu-bridge/index.js'