前言¶
DSH 可以通过插件接入不同消息入口。对于需要在本机运行 DSH agent 的场景，JMOKSZ/dsh-lark-bridge 提供了一个飞书（Feishu / Lark）入口：在飞书里给机器人发消息，由机器人通过官方长连接把任务交给本机 DSH agent 处理。
下面介绍它的定位、已核实能力、安装方式、运行方式和注意事项。
这是什么¶
JMOKSZ/dsh-lark-bridge 是一个飞书入口插件，由 JMOKSZ 维护，许可证为 MIT。
它让飞书机器人驱动本机 DSH agent，并支持附件、交互问答/审批、流式进度卡片和主动推送。插件走官方长连接（WebSocket），无需公网 IP、无需反向代理。
核心能力¶
插件提供以下能力：
- 流式回复卡片（默认开启），实时展示思考、回答草稿和工具调用面板。
- 主动推送：
feishu_send工具可向会话推送文本/卡片。 - 交互问答与审批：
ask_user_question与工具审批渲染为按钮卡片。 - 附件处理：图片/文件/视频/音频自动下载保存。
- 富文本：
post消息自动提取纯文本。 - 多会话：每个飞书 chat 独立 DSH session。
- 群聊：默认仅在被 @ 时响应。
- 命令：
/new、/status、/whoami、/help。
安装前置¶
先确认本机满足以下条件：
1、已安装 DSH CLI、pnpm、Node.js ≥ 22。
2、准备一个可用的 LLM key。
3、准备飞书应用凭据，并开通权限：
im:message
im:message:send_as_bot
im:message.group_at_msg
im:chat
im:resource
im:message:update
安装¶
下面这条命令从 GitHub 安装插件，并绑定 lark profile：
dsh plugin --profile lark add github:JMOKSZ/dsh-lark-bridge --ignore-scripts
配置环境变量¶
凭据全部来自环境变量，不写入配置文件。
必填变量：
LARK_APP_ID
LARK_APP_SECRET
可选变量：
LARK_WORKSPACE
示例：
export LARK_APP_ID=cli_xxx
export LARK_APP_SECRET=xxx
export LARK_WORKSPACE=/path/to/work
运行¶
按已核实的使用示例启动插件：
LARK_APP_ID=cli_xxx LARK_APP_SECRET=xxx LARK_WORKSPACE=/path/to/work dsh --profile lark
启动后，飞书机器人通过长连接接收消息，并将任务交给本机 DSH agent 处理。
典型用法¶
1、单聊：直接发消息；群聊：@机器人 后发消息。
2、发送图片/文件/视频/音频：自动下载处理，可附文字说明。
3、需要选择/审批时：点击卡片按钮，或直接回复编号/文字。
4、使用命令：
/new
/status
/whoami
/help
适用场景与注意¶
适合需要在本机运行 DSH agent，并从飞书发起任务的场景，尤其是需要附件、交互审批、流式进度和主动推送的使用方式。
注意：
- 插件会以当前
dsh进程权限运行；安装前建议查看仓库源码与MIT许可证，确认其飞书消息、附件下载和 DSH agent 行为符合预期。 LARK_APP_ID、LARK_APP_SECRET为必填；LARK_WORKSPACE为可选。- 附件大小上限为
104857600，飞书上限为100MB。 - 该插件使用
MIT许可证；DSH 插件目录为社区站点，并非官方应用商店。
链接¶
- GitHub：https://github.com/JMOKSZ/dsh-lark-bridge
- 插件目录线索 URL（未在本次已核实资料中确认）：https://www.skillhub.cn/plugins/JMOKSZ/dsh-lark-bridge
