三、配置凭证

两种方式任选其一：

方式 A：环境变量（默认，推荐）

export WECOM_BOT_ID="wwxxxxxxxxxxxxxx"
export WECOM_BOT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
dsh web

方式 B：profile patch 覆盖（~/.dsh/profiles/web/cordis.patch.yml）：

- id: wecom-bot
  config:
    botId: wwxxxxxxxxxxxxxx
    botSecret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

patch 覆盖的是整行 config，覆盖时如需保留其他选项要一并写全（完整选项见下表）。

未配置时插件保持空闲、仅打印提示，不影响 dsh web 启动。

六、配置项

配置键	默认值	说明
`botId`	环境变量 `WECOM_BOT_ID`	智能机器人 BotID
`botSecret`	环境变量 `WECOM_BOT_SECRET`	智能机器人 Secret
`wsEndpoint`	`wss://openws.work.weixin.qq.com`	长连接网关
`heartbeatIntervalMs`	`30000`	心跳间隔（毫秒）
`reconnectBaseDelayMs`	`1000`	重连初始退避（毫秒）
`reconnectMaxDelayMs`	`30000`	重连最大退避（毫秒）
`sessionMode`	`per-user`	`per-user` 每个成员一个 agent 会话（多轮上下文）；`per-message` 每条消息新建 agent
`cwd`	进程 cwd	agent 的工作目录
`provider` / `model`	默认模型选择	覆盖 agent 使用的模型（留空用 `agentDefaultModel`）
`reasoningEffort`	默认	推理档位（如 `high`/`medium`/`low`）
`agentPreset`	部署默认（`standard`）	agent 装配预设：决定工具/提示。留空用部署默认（web profile 为 `standard`，含 bash/fs 等完整工具）；可选 `code` / `minimal`。缺失 preset 时 agent 无工具，任务会"假执行"（模型输出伪工具调用文本）
`ignoreOlderThanSec`	`300`	忽略超过该秒数的历史消息（重连补发防抖）
`maxReplyChars`	`6000`	最终回复最大字符数，超出截断
`ackOnReceive`	`true`	先推一条「已收到」中间态
`stripGroupMentions`	`true`	群聊消息去掉 `@机器人` 提及前缀