本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

ax-feishu-bridge

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add ax-feishu-bridge

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 通过扫码快速创建飞书/Lark 机器人，减少手动配置
• 支持私聊、群聊、群话题分别维护独立的 Pi 会话
• • open：群里和话题里可直接回复，不需要 @，还需手动在飞书开发者后台开启机器人“获取群组中所有消息”的权限
• • mention：只有 @ 机器人、命中关键词或回复机器人消息时才会回复（后两项可选开启）
• 支持图片、代码文件和文本文件等附件输入；图片识别取决于当前模型是否支持图片

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后飞书机器人没回复怎么办？

三件事按顺序看：1) 配置是否已完成（DSH 下次启动若没检测到配置会自动进入终端配置向导）；2) 插件是否随宿主加载（DSH 里 autoStart 默认开启，可 /feishu status 看连接状态）；3) 群聊策略是否要求 @ 机器人（策略为 mention 时只有 @ 或命中关键词才回复）。

同时装了 DSH 和 Pi 两边的飞书插件会冲突吗？

不会互相干扰。配置分别存在 ~/.dsh/feishu/config.harness.json 和 ~/.pi/agent/feishu/config.pi.json；连接锁按机器人凭证（appId）区分，同 appId 的多进程只会保留一个持有者（其他会被标记 owned by another process）；卡片回调端口 Pi 用 3001、DSH 用 3002，默认就错开。

图片发给机器人，模型能"看见"吗？

可以，但有两个前提：1) 当前选中的模型要支持图像输入；2) Harness 宿主要提供图片附件服务——若宿主未挂载，本插件会自己注册本地存储到 ~/.dsh/attachments（挂载失败时退化为仅文字）。仅支持 png/jpg/webp/gif。

群聊怎么做到不 @ 也能触发？

群策略设为 open 时群消息默认自动触发；策略设为 mention 时只 @ 才回复，但可以叠加：1) 在飞书开发者后台开启"获取群组中所有消息"或"获取群组中用户和机器人发送的消息"权限；2) 用 /config groupKeywords 报警,告警 配置关键词触发；3) 用 /config groupAlsoOnReply true 开启回复机器人消息继续追问。

/config 能改哪些项？

仅限白名单：群策略（open/mention）、群关键词、回复机器人消息触发、是否忽略其他机器人消息、收到消息时的表情回应、语言、流式回复开关及打印/推送间隔。App ID/Secret、卡片回调地址、引文消息展开等连接级配置不接受聊天内修改，需要改 config.json 后重启。

怎么卸载或重置？

DSH 下运行 /feishu reset confirm 可清除配置和会话映射（保留会话历史）；想完全卸载用 dsh plugin remove 即可。reset 不会删除飞书侧的会话内容或机器人本身。

长时间任务会被报失败吗？

默认不会。promptNotifySec=180 表示超过 180 秒在飞书里发一条"仍在处理中"的提示，回复卡片保持"回复中"，完成后正常送达。只有显式设置 promptTimeoutSec>0 才会硬超时并报失败。

这个插件只能在 DSH 里用吗？

不是。同一个 npm 包（ax-feishu-bridge）同时分发为 Pi 扩展和 DSH bundle 插件，配置、群策略、会话隔离完全独立，可以并存；README 里的 Windows 配置段落只针对 Pi 适配器（Windows 上需要给 Pi 指定 Git Bash），DSH 适配器无需这步。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则