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

快速上手

dsh-feishu

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @dsh-feishu/dsh-feishu

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

— 源: plugins.install

关键要点

• 实时流式卡片——工具调用、思考、markdown、表格，边跑边流出来。
• 一键控制面板——/panel 把命令面板全部做成按钮；不用记命令语法，且每个按钮与敲命令完全等价。
• 卡内审批 / 提问——提权审批、回答问题都在聊天里完成。
• 会话不丢——重启守护进程，聊天对应的会话和工作目录都还在。
• 群聊 + @ 提醒——群里 @ 机器人即可；出错、审批、提问都会 @ 回发起人。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

飞书机器人需要我自己手动创建应用吗？

不需要。运行 dsh-feishu-setup --new 用飞书账号扫一次码，工具会自动创建机器人应用、申请权限、写入凭据；已有应用也可通过 FEISHU_APP_ID / FEISHU_APP_SECRET 环境变量或配置直接接入。

必须先选工作目录才能发消息吗？

是。默认开启工作目录守门：聊天没绑定目录前 Agent 拒绝响应，必须先 /repo 选项目或 /cd <path> 指定路径才会工作；只有把配置里的 requireWorkingDir 改成 false 才会回退到默认目录。

群聊里要不要 @ 机器人？

默认要（groupMentionMode: always）。配置可改为 never（每条都回）、ambient（除非指向他人）或 topic（话题模式占位，等话题功能落地）。

流式卡片有大小上限吗？

飞书单卡片上限约 109 KB，超长输出会被尾部截断并标注"已截断 N 字符"；完整会话可 /export 导出 markdown 文件，无卡片大小限制。

会话和工作目录会保留吗？

会。插件挂载了 storage×3 + workspace，会话记录、工作目录、归档状态都写到 dsh 数据目录，重启不丢；DSH_HOME 相同的 dsh 网页端和飞书端可互看同一份会话。

支持哪些模型？怎么切换？

走 dsh 自带 LLM 适配器，可用 /model 打开选模型卡片，或 /model <provider>/<model> 直接设定；启动时也会把 DEEPSEEK_API_KEY（可配置为其他变量名）从环境变量自动搬进 dsh 凭据系统。

飞书机器人审批和提问怎么回？

自动以卡片形式回到当前聊天：权限申请出"Allow once / Reject"卡片点选，Agent 提问出单选/多选/文本题卡片（文本题由用户下一条普通消息回答），无需打字回命令行。

怎么彻底卸载？

dsh plugin --profile <name> remove @dsh-feishu/dsh-feishu 从 profile 摘掉插件；想要全新状态可追加删除 ~/.dsh/profiles/<name> 与 ~/.dsh/feishu 两个目录。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.1-rc.2+
• Node: >=22.13
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则