dsh-feishu-bridge
飞书 / Lark ↔ DeepSeek Harness 完整通道 | Full Feishu/Lark channel for DeepSeek Harness
把飞书与 DeepSeek Harness 打通（无需公网地址）：
Bridge Feishu/Lark with DeepSeek Harness (no public address needed).
- 飞书通道：WebSocket 长连接收发（单聊 + 群聊 @机器人），消息进 DSH agent，回复推回飞书，与 Web 会话双向同步。
- Feishu channel: WebSocket long-connection (1:1 + group @), messages forwarded to the DSH agent, replies mirrored back to Feishu, two-way sync with the Web session.
- 飞书审批：DSH 审批请求推送到飞书，回复「同意 / 拒绝」即可控制 agent 权限。
- Feishu approval: DSH approval requests are pushed to Feishu; reply "同意 / 拒绝" (approve / reject) to control agent permissions.
- 零个人硬编码：凭据走
.secrets.env（已 gitignore）。 - Zero personal hardcoding: credentials via
.secrets.env(gitignored).
快速开始 / Quick Start
前置：已安装并运行 DeepSeek Harness（dsh web，默认 http://127.0.0.1:3080）。
Prerequisite: DeepSeek Harness running (dsh web, default http://127.0.0.1:3080).
git clone <repo-url> dsh-feishu-bridge
cd dsh-feishu-bridge
# 1) 填飞书凭据 / fill in Feishu credentials
cp .secrets.env.example .secrets.env
# 编辑 .secrets.env：FEISHU_APP_ID / FEISHU_APP_SECRET（FEISHU_DOMAIN=feishu 或 lark）
# 2) 安装依赖 / install dependencies
npm install --no-audit --no-fund
# 3) 前台运行（测试）/ run in foreground (test)
node bridge.mjs
# 看到 "WebSocket 已连接" 即成功 / connected → send a message to the bot in Feishu
# 4)（可选）注册为 launchd 常驻 / (optional) register as launchd service
bash daemon/install.sh飞书应用要求 / Feishu App Requirements
在飞书开放平台创建自建应用 / Create a custom app at Feishu Open Platform:
- 启用「机器人」能力 / Enable "Bot" capability.
- 事件接收方式选「长连接」/ Choose "Long connection" for event subscription, 订阅
im.message.receive_v1. - 权限 / Permissions:
im:message.p2p_msg:readonly/im:message.group_at_msg:readonly/im:message:send_as_bot. - 发布版本并安装到企业 / Publish a version and install to your tenant.
详细步骤见 / See docs/feishu-app-setup.md.
配置（.secrets.env）/ Configuration
| 变量 / Var | 说明 / Description |
|---|---|
| FEISHU_APP_ID | 飞书应用 App ID |
| FEISHU_APP_SECRET | 飞书应用 App Secret（不入库 / not committed） |
| FEISHU_DOMAIN | feishu（国内 / CN）/ lark（国际 / intl），默认 feishu |
| FEISHU_REQUIRE_MENTION | 群聊是否必须 @机器人 / require @mention in groups，默认 true |
| SESSION_MODE | single（所有消息一会话 / one session for all）/ per-chat（每聊天一会话 / one per chat），默认 single |
| TARGET_SESSION_ID | single 模式驱动指定会话 / drive a specific session；不设则用固定会话 session-feishu-bridge |
| DSH_WEB_URL | DSH 地址 / DSH URL，默认 http://127.0.0.1:3080 |
审批 / Approvals
- agent 需要权限时（写工作区外等），审批请求自动推送到你最近对话的飞书聊天。
- When the agent needs permissions (e.g. writing outside the workspace), the approval request is pushed to your recent Feishu chat.
- 回复「同意」放行 / 回复「拒绝」拦截。
- Reply "同意" (approve) to allow, or "拒绝" (reject) to block.
管理 / Management
launchctl list | grep feishu-bridge # 状态 / status
tail -f daemon/bridge.log # 日志 / logs
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