飞书桥接pwangxo-sg/dsh-feishu-bridge

dsh-feishu-bridge

飞书 / Lark ↔ DeepSeek Harness 完整通道 | DeepSeek Harness 的完整飞书/Lark 通道

把飞书与 DeepSeek Harness 打通（无需公网地址）：
将飞书/Lark 与 DeepSeek Harness 打通（无需公网地址）。

- 飞书通道：WebSocket 长连接收发（单聊 + 群聊 @机器人），消息进 DSH agent，回复推回飞书，与 Web 会话双向同步。
- 飞书通道：WebSocket 长连接（单聊 + 群聊 @），消息转发至 DSH agent，回复镜像回飞书，与 Web 会话双向同步。
- 飞书审批：DSH 审批请求推送到飞书，回复「同意 / 拒绝」即可控制 agent 权限。
- 飞书审批：DSH 审批请求推送到飞书；回复“同意 / 拒绝”（批准 / 拒绝）即可控制 agent 权限。
- 零个人硬编码：凭据走 .secrets.env（已 gitignore）。
- 零个人硬编码：凭据通过 .secrets.env（已 gitignore）。

快速开始 / 快速开始

前置：已安装并运行 DeepSeek Harness（dsh web，默认 http://127.0.0.1:3080）。
前置条件：DeepSeek Harness 正在运行（dsh web，默认 http://127.0.0.1:3080）。

git clone  dsh-feishu-bridge
cd dsh-feishu-bridge

1) 填飞书凭据 / 填写飞书凭据
cp .secrets.env.example .secrets.env
编辑 .secrets.env：FEISHU_APP_ID / FEISHU_APP_SECRET（FEISHU_DOMAIN=feishu 或 lark）

2) 安装依赖 / 安装依赖
npm install --no-audit --no-fund

3) 前台运行（测试）/ 前台运行（测试）
node bridge.mjs
看到 "WebSocket 已连接" 即成功 / 已连接 → 在飞书中向机器人发送消息

4)（可选）注册为 launchd 常驻 / （可选）注册为 launchd 服务
bash daemon/install.sh

飞书应用要求 / 飞书应用要求

在飞书开放平台创建自建应用 / 在飞书开放平台创建自建应用：

1. 启用「机器人」能力 / 启用“机器人”能力。
2. 事件接收方式选「长连接」/ 事件订阅选择“长连接”，订阅 im.message.receive_v1。
3. 权限 / 权限：im:message.p2p_msg:readonly / im:message.group_at_msg:readonly / im:message:send_as_bot。
4. 发布版本并安装到企业 / 发布版本并安装到企业。

详细步骤见 / 参见 docs/feishu-app-setup.md。

配置（.secrets.env）/ 配置

| 变量 / 变量 | 说明 / 说明 |
| --- | --- |
| FEISHU_APP_ID | 飞书应用 App ID |
| FEISHU_APP_SECRET | 飞书应用 App Secret（不入库 / 不提交） |
| FEISHU_DOMAIN | feishu（国内 / 中国）/ lark（国际 / 国际），默认 feishu |
| FEISHU_REQUIRE_MENTION | 群聊是否必须 @机器人 / 群聊中是否必须 @，默认 true |
| SESSION_MODE | single（所有消息一会话 / 所有消息共用一个会话）/ per-chat（每聊天一会话 / 每个聊天一个会话），默认 single |
| TARGET_SESSION_ID | single 模式驱动指定会话 / 驱动指定会话；不设则用固定会话 session-feishu-bridge |
| DSH_WEB_URL | DSH 地址 / DSH URL，默认 http://127.0.0.1:3080 |

审批 / 审批

- agent 需要权限时（写工作区外等），审批请求自动推送到你最近对话的飞书聊天。
- 当 agent 需要权限时（例如写入工作区外），审批请求会推送到你最近对话的飞书聊天。
- 回复「同意」放行 / 回复「拒绝」拦截。
- 回复“同意”（批准）以允许，或回复“拒绝”（拒绝）以阻止。

管理 / 管理

launchctl list | grep feishu-bridge      # 状态 / 状态
tail -f daemon/bridge.log                # 日志 / 日志bash
bash daemon/uninstall.sh                 # 卸载常驻 / uninstall service

相关项目 / Related Projects

- financial-market-analysis — 金融市场分析技能（DSH）/ Financial market analysis skill for DSH：A股/基金/QDII/黄金/亚太指数日报、指标追踪、决策追踪，可与本桥配合（飞书收报告）。

定制与支持 / Customization & Support

需要针对你的场景定制（接入更多渠道、定时报告、私有数据源）/ Need customization (more channels, scheduled reports, private data sources)? 联系 / Contact:
p.wangxo@gmail.com（标题带 [定制] 前缀 / prefix "[定制]" in subject）

License

MIT