Name: dsh-feishu-bridge
Author: erty3244

Installer

dsh plugin --profile web add github:erty3244/dsh-feishu-bridge

README

dsh-feishu-bridge

把飞书（Lark）自建机器人接到 DeepSeek Harness：手机上发一条飞书消息，DSH 里就开一轮；这一轮的回复自动回到飞书。走飞书自建应用的长连接，不需要公网 IP、不需要内网穿透、不需要回调地址。

零第三方依赖（只用 Node 内置模块），自己实现飞书长连接的帧编解码。

English: A zero-dependency bridge that connects a Feishu/Lark self-built bot to DeepSeek Harness over the official WebSocket long connection. Send a Feishu message → a DSH turn starts → the answer is posted back to the same chat. No public IP, no tunnel, no callback URL required.

它解决什么

DSH 跑在自己电脑上，人经常不在电脑前。这个插件让飞书成为本地 DSH 的输入输出口：

入站：飞书消息 → 投递进指定 DSH 会话（文字与图片一起带上；投递请求带飞书 message_id）
出站：该会话这一轮的最终回复 → 发回同一条私聊或群
不串线：每一轮与触发它的那条消息用 rpcId 精确配对，并发时也不会把 A 的回答回给 B
不重复：状态文件里记 message_id，重连后补送的旧消息不会被执行两遍；延迟送达会标注「晚了 N 分钟」
可换绑：目标会话写在 bindingFile 里，只有一行，改完下一轮生效，不用重启

自触发（自由时间 / 预约任务）已拆出，见 dsh-self-trigger。本仓库只做飞书桥接：入站投递 + 出站回帖。

安装

dsh plugin --profile desktop add ./dsh-feishu-bridge

或者在 DSH 桌面端的 设置 → 插件 里从目录安装。装完重启一次宿主（插件在宿主进程里起长连接）。

飞书侧准备（一次性，约 10 分钟）

打开飞书开放平台 → 创建企业自建应用
在「凭证与基础信息」里取 App ID / App Secret
「添加应用能力」→ 打开机器人
「权限管理」至少给：
- im:message（读取用户发给机器人的消息）
- im:message:send_as_bot（以机器人身份发消息）
- （要下载图片/文件再加 im:resource）
「事件与回调」→ 订阅方式选 使用长连接接收事件 → 添加事件 im.message.receive_v1
「版本管理与发布」创建版本并发布（企业内自建应用通常自己就能审核）
把机器人拉进你要用的群，或直接私聊它

配置

插件的配置走 profile 的 cordis.patch.yml，凭据单独放一个 JSON 文件（不放进插件配置，避免跟着插件一起被备份/导出）：

- insert:
    - id: dsh-feishu-bridge
      name: 'dsh-feishu-bridge'
      config:
        configPath: 'C:\Users\you\.dsh\feishu-config.json'
        bindingFile: 'C:\Users\you\.dsh\feishu-target-session.txt'
        stateDir: 'C:\Users\you\.dsh\feishu-bridge'

feishu-config.json：

{
  "appId": "cli_xxx",
  "appSecret": "xxx",
  "allowOpenIds": ["ou_xxx"],
  "allowChatIds": ["oc_xxx"],
  "note": "allowOpenIds / allowChatIds 是白名单；留空 = 谁都不放行"
}

bindingFile：只有一行，内容是要投递的目标会话 id（session-xxxx）。改一行、下一轮生效。
也可以直接在 config 里写 sessionId，bindingFile 优先生效。
白名单留空等于谁都不放行，不是放行所有人——这点别反着理解。
密钥可以不放明文：配 appSecretRef + DSH 的凭证机制（ctx.credentials.resolve），配置文件里只留引用名。
默认值：自动回帖默认开（只有显式写 autoReply: false 才关）；回执文字 ackText 默认「已收到」；dryRun 默认关。

安全与权限声明

这个插件在宿主里能碰到的范围，如实列出（市场审查口径）：

能力	用途
`network`	只连 `open.feishu.cn`（长连接 WSS + 发消息 / 取资源 HTTPS）
`fs-read`	读 `configPath`、`bindingFile`
`fs-write`	只写 `stateDir` 下的状态、日志、心跳
`host-runtime`	`sessionController.prompt` 投递消息
`credentials`（可选）	仅在配了 `appSecretRef` 时读一个具名凭证

不做的事：不开子进程、不执行 shell、不扫描磁盘、不读凭据文件、不上报任何遥测。

兼容性

测于 DSH 0.2.1-rc.2（desktop profile），Node ≥ 22
依赖的宿主接口：ctx.sessionController.prompt、ctx.on('session/event')、ctx.credentials.resolve
DSH 的内部接口会变。插件里对拿不到的对象都做了兜底与日志，宿主升级后先看 stateDir 下的日志再升级