dsh-wechat-pro

配置

插件配置在「设置 → 插件配置 → dsh-wechat-pro」或 cordis.patch.yml 的 config 段， 也支持环境变量（DSH_WXBOT_*，测试时可指向本地 mock）：

键 / 环境变量	默认	说明
autoConnect	true	启动时已有凭证自动连接
allowFrom / DSH_WXBOT_ALLOW_FROM	空	微信用户白名单（逗号分隔的 from_user_id；空 = 全部，建议设置）
dataDir / DSH_WXBOT_DATA_DIR	$DSH_HOME/dsh-wechat-pro	凭证/联系人注册表/媒体目录
baseUrl / DSH_WXBOT_BASE_URL	https://ilinkai.weixin.qq.com	iLink 端点（测试可指向 mock）
replyMaxChars / DSH_WXBOT_REPLY_MAX	3800	单条微信消息上限，超出分片（env 优先）
streamLevel	normal	默认输出等级（minimal/normal/verbose；微信内可 /level 覆盖）
mirrorWebTurns	false	Web 发起的回合是否也推送到微信（默认只推微信发起的回合）
replyTimeoutMs / DSH_WXBOT_REPLY_TIMEOUT_MS	300000	单轮回复超时（env 优先）
announceToAgent	true	是否在系统提示词声明插件能力

输出等级与推送范围

• /level（微信内即时切换，按联系人持久化）：
  • minimal（默认，推荐）— 只推最终答复与错误（不含任何过程消息）；
  • normal — 思考（🤔）+ 工具调用（🔧）/结果（✅）+ 最终答复；
  • verbose — normal + 完整工具参数与结果（不截断）。
• 回合来源：只有微信发起的回合会推送到微信；Web 端在同一会话发起的对话默认不推送（mirrorWebTurns: true 可改为也推送）。判断依据：该回合的触发消息是否带浏览器时区（微信侧不带）。
• ⚠️ 腾讯发送额度限制（重要）：实测腾讯 iLink 对单条入站消息的回复发送有额度限制——过程消息刷屏（normal/verbose 下每个工具调用都推一条）会触发 sendMessage ret=-2 prepare failed，后续所有发送（含最终答复）都会被拒。因此默认 minimal（每回合只发最终答复+错误，最可靠）。若确实想看过程，可 /level normal，同时过程消息上限 maxProcessPerTurn（默认 3）会尽量为最终答复留额度，但不能保证。
• 长度限制与超长回复降级：微信单条消息约 2048 字符限制，replyMaxChars 默认 3800（超出自动分片，每片间隔 1s）。最终答复分片预算 maxReplyChunks（默认 8 片）：分片数在预算内正常发送；超预算时降级为「首片 + 完整内容落盘为文件发给你」（一条媒体消息，不占文本条数额度，完整内容必达）。文件存于 dataDir/outbox/。
• 发送可靠性：最终答复/审批提示等关键消息发送失败会自动重试一次；所有发送失败都会追加到 dataDir/logs/wechat-pro.log（隐藏窗口启动时这是唯一可查的发送痕迹，ret=-2 prepare failed 即额度/上下文被拒）。