配置文件与凭据位置

内容	文件
启用实例 + 插件配置	`~/.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`	否	`10`	单个 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

dsh-feishu-bridge

安装

说明文档

配置文件与凭据位置

配置项