dsh-lark-bridge

配置

方式一：交互式向导（推荐）

node setup.mjs

按提示依次填写飞书 App ID、App Secret、管理员 open_id，其余项回车用默认值。完成后自动生成 .env。

方式二：手动复制

复制 .env.example 为 .env 并填写：

copy .env.example .env

环境变量	必填	说明
LARK_APP_ID	✅	飞书应用 App ID
LARK_APP_SECRET	✅	飞书应用 App Secret
LARK_TARGET_OPEN_ID	✅	管理员的飞书 open_id（ou_xxx）
LARK_BOT_NAME		机器人显示名称（默认「DSH桥接机器人」）
BRIDGE_DSH_API_BASE		DSH 地址（默认 http://127.0.0.1:3080）
BRIDGE_DSH_CREATE_SESSION		true 则创建独立会话并缓存（默认 true）
BRIDGE_DSH_SESSION_CWD		新会话工作目录（留空用 DSH 默认）
BRIDGE_DSH_SESSION_ID		指定已有会话 ID（留空自动创建/复用）

首次双击 start-bot.bat 时如检测到没有 .env，会提示你先运行 node setup.mjs 完成配置。

飞书后台配置清单（开发者后台）

1. 应用能力：开启「机器人」能力
2. 事件订阅：接收方式选择「使用长连接接收事件」
3. 订阅事件：
   • im.message.receive_v1（接收消息）
   • card.action.trigger（交互卡片回调）
4. 权限范围：
   • im:message、im:message:send_as_bot（发送消息）
   • im:message.p2p_msg:readonly（接收单聊消息）
   • 交互卡片相关权限
5. 发布版本并审核通过（自建应用内部可用）