dsh-feishu-bridge

配置文件与凭据位置

内容	文件
启用实例 + 插件配置	~/.dsh/profiles/web/cordis.patch.yml（Windows：C:\Users\\.dsh\profiles\web\cordis.patch.yml）
App Secret（凭据）	~/.dsh/.credentials.yaml（Windows：C:\Users\\.dsh\.credentials.yaml）

---

配置项

配置项	必填	默认值	说明
appId	是	无	飞书应用 App ID（非敏感，直接写明文）
appSecretEnv	是	FEISHU_APP_SECRET	App Secret 的凭据引用名，真正的值在 ~/.dsh/.credentials.yaml
domain	否	feishu	feishu（中国版）/ lark（国际版）
requireMention	否	true	群聊是否必须 @机器人
dmMode	否	open	单聊策略：open / allowlist / disabled
groupAllowlist	否	[]	群 chat_id 白名单，空 = 不限制
dmAllowlist	否	[]	dmMode: allowlist 时允许的用户 open_id
botOpenId	否	无	机器人 open_id，用于精确判断“是否 @机器人”；不填则退化为“mentions 非空”
provider / model	否	Harness 默认	为飞书渠道单独指定模型
reasoningEffort	否	模型默认	为飞书渠道指定推理强度（如 off/high/max，取决于模型支持）
workspace	否	第一个 Workspace	Agent 的工作目录
agentPreset	否	默认 Preset	Agent 使用的 Preset（决定工具/系统提示组合）
streamProgress	否	true	是否把执行过程（工具调用）回传飞书
maxProgressMessages	否	0（不限制）	单个 turn 内最多回传多少条过程消息（工具调用 + 中间回复合计）；0 = 有多少转多少
processingNotice	否	true	收到普通消息时先回一句“正在处理 / 排队中”的即时回执
turnTimeoutMs	否	900000（15 分钟）	单个 turn 最长执行时间（毫秒），超时自动取消本轮并提示
resetCommand	否	/reset	重置会话的指令
compactCommand	否	/compact	手动压缩上下文的指令
requireAdminForGroupReset	否	true	群聊重置是否要求群主/管理员（需 im:chat:readonly 权限；设为 false 则群成员也能重置）
errorMessage	否	内置中文提示	Agent 出错时返回给用户的统一提示（最长 500 字符）

完整示例：

- id: feishu-bridge
  disabled: false
  config:
    appId: cli_xxxxxxxxxxxxxxxx
    appSecretEnv: FEISHU_APP_SECRET
    domain: feishu
    requireMention: true
    dmMode: open
    # 可选：
    provider: deepseek-official
    model: deepseek-v4-flash
    reasoningEffort: high
    workspace: C:\Project\my-repo
    agentPreset: coding
    streamProgress: true
    maxProgressMessages: 10

---