两种方式二选一：一键扫码（推荐） 见第一步——扫码完成后插件自动把凭据写入 ~/.dsh/dsh-feishu-bridge/credentials.json（权限 0600），无需手动配置；或手动用环境变量 / 插件 Config 配置：

方式 1：环境变量 —— 在启动 DSH 的终端（或启动脚本）中导出：

export FEISHU_APP_ID="cli_xxxxxxxxxxxxxxxx"
export FEISHU_APP_SECRET="xxxxxxxxxxxxxxxx"

方式 2：插件 Config —— 在 DSH 插件配置中填写：

字段	说明
`feishuAppId`	飞书应用 App ID（未填时回退 `FEISHU_APP_ID`，再回退扫码凭据文件）
`feishuAppSecret`	飞书应用 App Secret（未填时回退 `FEISHU_APP_SECRET`，再回退扫码凭据文件）

凭据优先级：Config > 环境变量 > 扫码凭据文件；三种来源都缺失时插件启动才报缺凭据错误。

⚙️ 配置项

字段	类型	默认值	说明
`feishuAppId`	string	`''`（回退 `FEISHU_APP_ID`）	飞书应用 ID（未填时回退 `FEISHU_APP_ID`，再回退扫码凭据文件）
`feishuAppSecret`	string	`''`（回退 `FEISHU_APP_SECRET`）	飞书应用密钥（未填时回退 `FEISHU_APP_SECRET`，再回退扫码凭据文件）
`stream`	boolean	`true`	流式卡片总开关（每个会话可用 `/stream` 覆盖）
`maxTurnMs`	number	`600000`	看门狗时长：单回合超过该毫秒数则取消该回合，并回复错误卡片
`interruptAfterMs`	number	`0`	插队阈值：运行中回合超过该毫秒数，新消息打断它优先处理（`0` = 立即打断）
`streamThrottleMs`	number	`40`	流式卡片推送节流间隔（毫秒）
`streamThrottleChars`	number	`12`	流式卡片推送触发字符数
`maxReplyChars`	number	`4000`	非流式回复截断阈值（字符）
`batchWindowMs`	number	`800`	消息突发批处理窗口（毫秒）：窗口内同一聊天的连续普通消息合并为一条进入 DSH；`0` = 禁用
`maxMessageChars`	number	`20000`	入站单条消息长度上限（字符）：超出截断并提示；`0` = 不限制
`rateLimitPerMinute`	number	`30`	入站限流：每 chat 每分钟消息数上限（agent 注入前防护，防刷屏烧额度）；`0` = 不限制

@dsh-external/dsh-feishu-bridge