dsh-wechat

把 DeepSeek Harness（DSH）接进微信：扫码绑定一次，之后在微信里派活、收结果、答审批。宿主侧 cordis 插件，零运行时依赖。

给 Agent 的摘要：宿主侧 cordis 插件；dsh plugin --profile <p> add <tgz> 安装，node bin/dsh-wechat.mjs login 扫码绑定（二维码打印在终端；GUI 里用设置页卡片）；绑定后微信即为一个 DSH 会话客户端（命令表见下）。改动前必读「行为契约」；排错看「故障排查」。实现细节在 docs/design.md。

文档地图（本页 = 操作入口；实现细节在独立文档里）：

文档	内容
README.md（本页）	安装、命令、配置、行为契约、超时、排查——照做即可
docs/design.md	架构、队列与竞速语义、投递实现、iLink 协议要点、与 DSH 的契约、平台兼容性
docs/side-effects.md	对系统的全部副作用（进程/端口/文件/定时器/网络出口）逐项清单
docs/profile-verification.md	一次性 profile 的安装/组合/启动/卸载证据与结果

安装

# 1) 从 Releases 取 tarball：https://github.com/zgat/dsh-wechat/releases
dsh plugin --profile desktop add ./dsh-wechat-<版本>.tgz      # 例如 0.1.41
#    也可以走 GUI：设置 → 插件 → 安装，粘贴该 tgz 路径

# 2) 扫码绑定（二维码打印在终端）
node bin/dsh-wechat.mjs login

# 3) 在微信里给机器人发任意一句话，会收到上手引导（/help 看全部指令）

前置条件：DSH 0.2.0-rc.2、Node ≥ 20、一个具备微信 ClawBot / iLink 机器人能力的微信号，且能访问 https://ilinkai.weixin.qq.com 与 https://novac2c.cdn.weixin.qq.com。

桌面端注意：dsh plugin 会转发给桌面端的 Electron 二进制，App 正忙时可能被中断（实测 script execution has been terminated，退出码 254）。稳妥做法是先完全退出桌面端再安装（或改用 GUI 的插件页安装，宿主自己不会被打断）。

无人值守（环境变量优先于凭据文件，不落盘）：

export DSH_WECHAT_BOT_TOKEN=ilinkbot_xxx
export DSH_WECHAT_BASE_URL=https://ilinkai.weixin.qq.com   # 可选
export DSH_WECHAT_BOT_ID=xxx@im.bot                        # 可选
export DSH_WECHAT_USER_ID=xxx@im.wechat                    # 可选：指定所有者

不给 DSH_WECHAT_USER_ID 时这条凭据没有所有者 → 所有被允许的联系人都视同所有者；无人值守部署请显式指定或收紧白名单。

验证与升级

版本不一致 = 需要重启：重启后插件会在状态里同时报告「运行中的版本」与「磁盘已装版本」，不一致时会明确提示。

配置改动热生效；升级已加载插件的代码需要重启（原因见 docs/design.md）：

node scripts/schedule-restart.mjs --cancel       # 取消已排程的重启
dsh --profile <profile> --dump-config | grep -A3 dsh-wechat   # 不启动时自检

能力速览

能力	说明
扫码绑定	iLink/ClawBot 协议；凭据本机保存（`0600`），无需 appid/secret
收发消息	长轮询收私聊；回复自动分段（默认 1800 字/段），失败退避重试 + 整轮后补发
会话映射	一个微信会话 ↔ 一个 DSH 会话，持久化绑定，重启后自动 `resume`
斜杠命令	切会话/工作区/模型/权限、看状态、停止回合（见下方命令表）
审批与提问	`approval/request`、`user-questions/request` 转发到微信；回「允许/拒绝/取消」或选项序号
跟读 `/listen`	其它客户端（GUI 等）在同一会话跑完的结果推到这里；该会话的审批/提问两端都能答
图片 / 文件	入站图片/文件/语音/视频解密落盘并把路径交给 Agent；Agent 可用工具把产物发回
模型工具	`wechat_send_text`、`wechat_send_file`、`wechat_chat_info`
访问控制	默认白名单 + 所有者模型；非所有者不能改权限、不能清凭据
错误日志	失败记录独立成页（设置页卡片给入口），默认保留 30 天、最多 300 条、一分钟内同类错误合并计数；微信里也可 `/errors` 查看最近 10 条
多 bot	一个插件实例可同时绑定多只机器人：每只各自长轮询、独立会话与命令；设置页点「添加绑定」扫码新增，已有的不受影响
设置页卡片	DSH 设置 → 微信：每只 bot 的昵称与在线状态、扫码时的二维码（内联 SVG，加载转圈）、添加绑定、刷新、改名（卡片内联输入框）、单方面解绑（两步确认）（客户端半边，见下）
长任务可见	「对方正在输入」+ 工具进度行（`progress: brief`）；长任务不静默、也不额外占用发送额度
渠道提示词	自动告诉模型「这个会话在微信里」：最终回答会自动送达、交付文件用 `wechat_send_file`、长内容先落盘再发——避免它把产物只写到磁盘上（只注入本插件创建的会话）
断线自愈	长轮询退避重试且不丢游标；`ret=-14` 自动清凭据并重新扫码；登录失败 60 秒重试

错误日志

失败不再显示在设置页卡片里（那里只留一个带条数的「错误日志」入口），改为独立页面与命令：

页面：<宿主地址>/dsh-wechat/errors?t=<令牌>，表格按时间倒序列出，同类重复错误合并为一条并计数；
命令：/errors 返回最近 10 条（仅所有者）；
保留：默认 30 天、最多 300 条；一分钟内重复的同一条错误合并计数。可用 errorLogDays / errorLogEntries 调整；
存储：写在 state.json 的 errors 数组里（0600），/status 仍保留最近一条的摘要。

多 bot

一个插件实例可以同时绑定多只微信机器人（iLink bot）：

添加：DSH 设置 → 微信 → 「添加绑定」→ 扫码。新 bot 立即开始工作，已有的 bot 继续在线，不需要重启。
昵称：iLink 官方接口只返回 ilink_bot_id / ilink_user_id（Clawbot 相关接口的 QR 状态响应里没有昵称字段），所以昵称是本地的：卡片里点「改名」即可（按 bot 持久化、重新扫码不丢），默认显示 微信机器人 <id 尾 4 位>，原始 id 仍以小字保留。
所有者：每只 bot 的所有者是扫码绑定它的那个账号（不是第一只 bot 的所有者）；默认 allowlist 策略下，第二只 bot 由别的微信号绑定时，那个账号照样可以直接对话/用命令。
隔离：会话键带 bot id（p2p:<bot>:<user>），所以两只 bot 接到同一个人的消息也各自独立——会话、/listen、/model、待答交互都不串。
投递：回复永远走收到这条消息的那只 bot，不会用别的 bot 的凭据发送。
移除：设置页卡片里每只 bot 有「解绑」按钮（立即停掉该 bot 的长轮询并删除凭据，其它 bot 不受影响）；在微信里也可 /logout（当前那只）或 /logout all（全部）。
迁移：旧的单 bot 状态在启动时自动迁移（凭据改成 {version:2,bots:{…}}，会话键补上 bot id），已有会话绑定不变。
超时：一次「添加绑定」默认 300 秒内没扫码就取消（loginTimeoutSeconds 可调），并把原因记进错误日志，卡片不会一直停在「添加中…」。

CLI 里 dsh-wechat --status 会逐只列出 bot、凭据来源、API 基座与长轮询游标。

设置页（GUI）

插件带一个客户端半边：DSH 设置 → 微信里有一张卡片，显示

连接状态（已连接 / 等待扫码 / 登录失败）与 bot 名；
未绑定时直接显示二维码（从 /dsh-wechat/api/qr 取 SVG 标记内联绘制），旁边有「刷新二维码」与「添加绑定」；
最近错误（来自 /status 同一份状态）。

实现方式与其它微信插件一致：package.json 里声明 dsh.client（platform: 'web'）+ exports["./client"]，浏览器 bundle 手写在 lib/client.js（只 require("react")，注册 settings.section slot），宿主侧在 GUI 的 web server 上提供 /dsh-wechat/api/{status,qr,qr.svg,add,refresh,errors} 与错误日志页 /dsh-wechat/errors。没有独立扫码页：这些路由只监听回环地址、不带令牌，与同类插件一致。

微信里的命令

命令	作用
`/help`（`/帮助`、`/?`）	显示帮助
`/new`（`/新会话`、`/reset`）	结束当前会话，下一条消息开启新会话（工作区/模型设置保留）
🔒 `/permission [模式]`（`/权限`、`/perm`）	查看/切换本对话的权限模式：`read-only` / `workspace-write`（默认）/ `danger-full-access`（需 `/permission danger-full-access confirm` 二次确认）；仅所有者可切换
`/session [序号\|会话 ID]`（`/会话`、`/对话`）	列出当前工作区的对话（标题与 DSH 界面一致，附时间/「运行中」/「←当前」）并切换；切换后询问是否把最近 N 段回执到微信（回 0-99，不回＝不回执）；子会话与已归档对话不列出；`/session new` 等价 `/new`，`/session sources` 打印来源诊断
`/stop`（`/停止`）	停止正在运行的回合；连排队消息一起丢弃并告知条数
`/whoami`（`/我是谁`）	你的微信 ID、会话键、DSH 会话 ID
`/workspace [序号\|名称\|路径]`（`/工作区`、`/项目`）	列出项目目录（标题优先）并切换；切换即结束当前会话
`/workspace add <路径> [名称]`	把目录登记为 DSH 工作区（GUI 里也会出现）并切过去
`/model [序号\|provider/model]`（`/模型`）	列出/选择模型（对下一个新会话生效）
`/reasoning [序号\|档位]`（`/思考`、`/effort`）	列出/选择思考深度（对下一个新会话生效）
`/settings`（`/设置`）	汇总当前会话的工作区、模型、思考深度
`/login`（`/登录`）	重新扫码登录的方法（在 DSH 设置 → 微信里点「添加绑定」）
`/listen`（`/接收`、`/订阅`、`/follow`）	开始跟读：其它客户端跑完的回合推到这里（直接发正文，无前缀），且该会话的审批/提问两端都能答；未绑定时先建好会话
`/mute`（`/停止接收`、`/免打扰`、`/unfollow`）	关闭跟读（不影响你自己回合的回复与审批/提问）
🔒 `/logout`（`/退出登录`）	清除本机凭据（会停止收发）；仅所有者可用
`/ping`	连通性检查

🔒 = 仅所有者可用。命令在进入 Agent 之前被处理，不消耗模型额度。

回答提问/审批时：选项可以用序号（2）或选项文字（方案 B、B）回答；单个问题时也可以直接回复自己的答案（"方案 A 太贵了"会被当作自由回答而不是选项）。

Agent 可用的工具

工具	用途
`wechat_send_text`	往当前微信会话发一条文本（阶段性进展、提醒）
`wechat_send_file`	把本地文件作为微信图片/文件发回（按扩展名判断图片，AES 加密 + CDN 上传）
`wechat_chat_info`	查询当前会话/DSH 会话/工作区/模型/运行状态

最终回答由插件自动回传，模型不需要也不应该重复发送。

配置项

写在 profile 的 $DSH_HOME/profiles/<profile>/cordis.patch.yml（patch 会整体替换 config，请写全要保留的键）：

- id: dsh-wechat
  name: 'dsh-wechat'
  config:
    enabled: true
    accessPolicy: allowlist
    allowedUserIds: ['oABC123example@im.wechat']
    workspace: /Users/me/projects/demo
    progress: brief

键	默认	说明
`enabled`	`true`	`false` 时插件完全不动（不注册监听、不连网）
`stateDir`	`$DSH_HOME/integrations/dsh-wechat`	凭据、状态、媒体、二维码的存放目录
`workspace`	第一个 DSH 工作区，否则 `process.cwd()`	新会话的工作目录（绝对路径）
`accessPolicy`	`allowlist`	`allowlist` 只服务白名单；`open` 接受任何发送者
`allowedUserIds`	`[]`	允许的微信用户 ID（也接受逗号分隔字符串）
`ownerUserId`	`null`	所有者，始终放行；留空时自动采用扫码绑定的微信号
`autoLogin`	`true`	无凭据时自动走扫码登录
`qrInCard`	`true`	二维码是否画在设置页卡片里（`false` 时只在终端/命令输出里出现；旧名 `loginPage` 仍接受）
`errorLogDays` / `errorLogEntries`	`30` / `300`	错误日志保留天数与条数上限
`loginTimeoutSeconds`	`300`	一次「添加绑定」的最长等待时间，超时自动取消并记入错误日志
`baseUrl`	`null`	覆盖 iLink 网关地址（默认 `https://ilinkai.weixin.qq.com`）
`cdnBaseUrl`	`null`	覆盖媒体 CDN 地址
`chunkChars`	`1800`	单条微信消息的最大字符数
`maxAnswerChars`	`20000`	一轮回答最多推送多少字（超出以「已省略 N 字」标注）；`0` = 不截断
`chunkDelayMs`	`350`	段与段之间的间隔，降低撞上发送限流的概率
`sendRetryMs`	`[500, 2000, 5000, 10000]`	单段失败的重试退避（仅瞬时错误；`ret=-14` 不重试）；整轮结束后仍失败的分段会再补发一轮
`typing`	`true`	是否显示「对方正在输入」
`typingKeepaliveSeconds`	`5`	输入状态保活间隔
`progress`	`brief`	`off` 只回最终答案；`brief` 加工具进度；`verbose` 再加中间说明
`showToolProgress`	`true`	`progress != off` 时是否推送 `🔧 tool` 行（关掉只影响通知，不影响工具可用）
`turnTimeoutSeconds`	`900`	超过这个时长发一条提醒（回合继续在后台跑，不是中断）；`0` = 不提醒（见「超时与节奏」）
`approvalTimeoutSeconds`	`300`	审批卡有效期；超时把决策交回另一端
`questionsTimeoutSeconds`	`600`	提问卡有效期；超时同上
`idleDisposeMinutes`	`0`	安静这么多分钟后释放常驻 Agent（绑定保留，下条消息自动 resume）；`0` = 常驻，可写小数
`agentPreset`	`null`	会话挂载的 agent preset；留空采用 DSH 默认（`standard`，含 `tool-bash`/`tool-fs`/`tool-fs-search`/`plan-mode` 等）。未挂载时微信里的 Agent 只有 `wechat_*` 工具
`model`	`null`	`provider/model` 或 `{ provider, model, reasoningEffort?, maxTokens? }`；留空采用 DSH 默认模型（必须能解析出路由）
`media.enabled`	`true`	是否收发图片/文件
`media.dir`	`stateDir/media`	入站附件落盘目录
`media.serveInbound`	`true`	把入站图片挂到卡片的回环路由 `/dsh-wechat/media/<不透明 id>`，并在消息里附 Markdown 图片链接（能不能显示成缩略图取决于 GUI 是否渲染用户消息里的图片；关掉则只给路径）
`media.maxInboundBytes`	`20971520`	入站媒体上限，超出直接拒绝
`media.maxOutboundBytes`	`52428800`	出站文件上限（本地保险）。实测 30 MiB / 33.4 MiB 都能正常送达，该量级没有平台大小限制
`media.uploadTimeoutMs`	`0`	上传超时预算；`0` = 按体积自动（假设 ≥50KB/s，下限 120 秒、上限 15 分钟）。33MB 约 12.7 分钟；上行慢就调大
`notifyLifecycle`	`false`	是否发送 `msg/notifystart\|notifystop`（非公开协议，失败忽略）
`routeTag`	`null`	`SKRouteTag` 路由标签，仅部署方需要时填写
`channelVersion`	`1.0.0`	`base_info.channel_version`
`logLevel`	`info`	`silent` / `error` / `warn` / `info` / `debug`

配置非法时插件在日志里明确报错并回退默认值，不会让整个 profile 起不来。想让 Agent 照常调用工具、但不把调用记录发到微信：progress: brief + showToolProgress: false。

行为契约（改动前必读）

只回微信发起的回合：按回合号配对，GUI 里跑的回合不会推到这个聊天（/listen 是显式例外）。
绑定独占：一个 DSH 会话同一时刻只属于一个微信会话，反之亦然；第二个会话要切进来会被明确拒绝（提示当前持有者，让它 /session new 释放）。
回答提问与审批：选项接受序号、选项文字或其前缀（2 / 方案 B / B）；单问题时含选项名的整句保持为自由回答。取消 = 不在微信答、交回原客户端。审批卡与提问卡的提示文案各自正确（不会互相串）。
交互归属：审批/提问只发给"此刻正在跑的那一轮"的发起方。微信发起的回合两端都能答（微信 + GUI，先答先算，另一端收到"已作废"并自动关框）；GUI/后台发起的回合默认不打扰微信，开 /listen 才双端；另一端没有应答者时不影响微信这张卡。
上下文窗口约 15–30 分钟：微信只能回复"最近说过话"的会话。超时提示后，用户回一句话（或 /listen）即可让那一轮复活，跑完的答案补发到微信；未再互动的回合按旧规则丢弃迟到的 turn/end。
发送单向：回执、切换确认、欢迎语、失败提示、跟读结果都只走"发往微信"的通道，不进入模型上下文；唯一进入会话的是用户消息原文（以及附件的落盘路径说明）。
命令不消耗模型额度：斜杠命令在进入 Agent 之前处理；/session 切换只重绑会话，不新建也不截断历史。
群聊不支持：iLink 的群消息没有可靠的回复路由，收到即忽略（debug 日志记一条）。
多联系人相互独立：每个微信联系人各自独立的会话与上下文。
出站按会话串行：同一会话的发送（回答分段、工具进度、wechat_send_text、wechat_send_file 及其说明文字）排成一条队列，不会交错；"说明 + 文件"作为一次排队发送，中间不会插进别的消息。
渠道提示词：本插件创建的会话会注入一段「微信渠道」说明（dsh-wechat:channel，order 10150），告诉模型回答会自动送达、交付文件用 wechat_send_file；GUI 自己开的会话不受影响。

超时与节奏（默认值速查）

项	默认	行为
单轮提醒	900s（15 分钟）	只发一条提醒（回合继续跑）；设 `turnTimeoutSeconds: 0` 可完全不提醒；用户回话即"复活"，答案随后补发
平台发送额度	同一窗口 10 条	超出被拒（`ret=-2`）；用户在微信发任意一句话即可解锁
审批卡	300s（5 分钟）	超时只撤微信卡，决策权交回另一端
提问卡	600s（10 分钟）	同上
上下文窗口	约 15–30 分钟	到期后主动推送报 `ret=-2 (prepare failed)`；需该会话先有新消息
工具进度	每轮 12 条	之后提示"后续进度不再逐条推送"

权限、外部依赖与失败边界

按 DSH STORE 的上架契约披露。本插件是宿主侧插件，以 DSH 进程权限运行——安装前请据此评估。

能力	用在哪里	范围与限制
文件	状态目录 `$DSH_HOME/integrations/dsh-wechat`（凭据/游标/绑定/启动记录，`0600`，目录 `0700`）、媒体目录（默认其下 `media/`，入站附件 `0600`）、二维码 SVG 文件	不写工作区、不写系统目录（`LaunchAgents`/`crontab`/`systemd` 一律不碰）；写入原子化并带瞬时错误重试
网络	出站长轮询与发消息（默认 `https://ilinkai.weixin.qq.com`）、附件上传下载（默认 `https://novac2c.cdn.weixin.qq.com/c2c`）、回环接口（`/dsh-wechat/api/*`，随宿主 GUI 端口）	目标可用配置覆盖但强校验（公网强制 https）；所有请求 `redirect:'error'`；无遥测、无第三方端点（由 `test/sideeffects.test.mjs` 出站白名单强制）
命令/子进程	无：插件不启动任何程序（不打开浏览器、不执行 shell），也不自开监听端口（二维码由设置页卡片绘制）	由 `test/sideeffects.test.mjs` 断言运行时（`lib/`、`bin/`）不得导入子进程 API
凭据	读取并保存机器人令牌（`credentials.json`，`0600`；也可由环境变量提供，此时不落盘）；日志与工具进度双重脱敏	不读取系统钥匙串、不读取无关环境变量；`/logout` 仅所有者可用，并清除读取失败留下的副本
原生制品	无	零运行时依赖、无原生模块，安装不触发编译
受保护的 DSH 行为	不修改、不遮蔽、不重复安装任何 `@deepseek-ai/*` 组件	只通过 `ctx.get(key)` 使用宿主服务，入口 ID 唯一

外部服务：微信 iLink 网关（必需）、媒体 CDN（仅收发附件时）。二者非本仓库所有，可用性取决于腾讯侧。

权限等级自评：high（触及凭据、网络与持久状态；不含子进程，也不自开监听端口）→ 不满足 STORE 的自动低风险通道，预期 user-reviewed / blocked，由使用者逐次审阅安装。

失败边界：网络失败退避重试且不丢游标；ret=-14 自动清凭据重登；分段发送失败只丢那一段并明确告知（先退避重试，再整轮补发）；state.json 损坏或读不出时改名留档、从空状态启动；插件异常不阻断 DSH——停用或卸载即恢复原状（明细见 docs/side-effects.md）。

一次性 Profile 证据：安装 / 组合 / 卸载的可复现验证记录见 docs/profile-verification.md（临时 DSH_HOME，不碰真实 profile；脚本明确 booted: false，真实启动验收需另跑一台 DSH）。

兼容性：DSH 0.2.0-rc.2 与 0.2.1-rc.2（后者：一次性 profile 的安装/组合/卸载实测 + 插件在该版本上真机运行）、Node ≥ 20、profile desktop 实测（其它 profile 只要提供 agents/sessions 服务即可运行）、macOS 实测 / Linux 与 Windows 路径已审计（0.2.0-rc.1、0.2.1-alpha.1 未验证）。

DSH STORE 状态（2026-10-20 复检）：目录条目仍停在 0.2.8，其 statusReason 是更早 commit 的陈旧结论（含 commands 与 nativeOrExecutableArtifacts）。对本仓库当前 commit 用商店自己的分析器复算，reasons: []、32 个包内条目全部 100644、commands: false、nativeOrExecutableArtifacts: false，只剩 files / network / credentials 三类可人工审阅豁免的信号；商店的官方预检脚本对该 commit 返回 status: passed（安全扫描 27/27 文件、0 发现）。状态仍为 blocked 的原因是尚无固定来源审阅记录（registry/admission-reviews.json 中作者不能自审），已在 DSH-Store#1321 提交证据并请求审阅。

故障排查

现象	处理
日志只有 `还没有凭据，跳过接收`	没有凭据：在设置页点「添加绑定」，或运行 `node bin/dsh-wechat.mjs login`
看不到二维码	① DSH 设置 → 微信的卡片（点「添加绑定」）；② 终端登录时的二维码；③ 状态目录里的 `login-qrcode.svg`
卡片里没有二维码	确认运行的是含客户端半边的版本，且 profile 里插件为启用状态；`/status` 里应有 `qrUrl`
反复 `接收消息失败（第 N 次）`	网络到不了 `ilinkai.weixin.qq.com`：`curl -I https://ilinkai.weixin.qq.com/ilink/bot/get_bot_qrcode?bot_type=3` 验证
`微信会话已过期（ret=-14）`	插件会清凭据并重新扫码；也可先 `logout` 再 `login`
`no context_token cached` / 主动推送报 `ret=-2 (prepare failed)`	距该会话最后发言超过约 15–30 分钟：让对方先发一条消息即可恢复
长回答丢段 / 「有 N 段未能发出」	微信平台限制：同一窗口最多连发 10 条，超出的会被拒（`ret=-2 prepare failed`），在微信里回任意一句话即可解锁；插件已退避重试 + 整轮补发，仍失败会告警。看插件记录的最近错误原文
大文件发送失败（`CDN upload timed out`）	上传预算按体积放大（33MB ≈ 12.7 分钟）；仍失败说明上行持续低于 50KB/s（实测正常在 1.2–6 MB/s），可用 `media.uploadTimeoutMs` 再调大
长任务很久没动静	微信发任意一句话（或 `/listen`）让那一轮复活；查看队列与运行状态
审批/提问在微信没出现	该轮不是微信发起的（默认不打扰）；开 `/listen`，或直接在 GUI 回答
审批框「允许」没生效（≤0.1.33）	0.1.34+ 已修（请求挂起时不再 abort 宿主信号）；重启后确认版本
`/session` 显示 `[object Object]`	0.1.15 已修（标题快照对象经 `titleText()` 取文本）；版本过旧则升级
`/session` 里显示"未命名对话"	该会话还没有 `session/title` 事件；`/session sources` 看来源诊断
微信里的 Agent 说"没有跑命令的工具"	会话未挂 agent preset（0.1.13 起自动挂载）；查看会话挂载的「预设」；旧会话需 `/new`
收到的图片打不开	检查 `media.maxInboundBytes`；日志 `inbound media decryption failed` 表示发送端密钥编码非标准——原文会以 `<名称>.enc` 落盘并标注不可读
回复是「回合被拦截」	会话被 DSH 归档：0.1.6 起微信侧自动改开新会话；否则按提示 `/new`
想继续某个旧对话	`/session` 列出选择；被归档的对话会提示先取消归档
微信里出现 `⛔ 发送者 … 不在白名单内`	把该 ID 加进 `allowedUserIds` 或设为 `ownerUserId`
插件完全没加载	`dsh --profile <name> --dump-config` 确认 patch 行存在；本插件不声明 `peerDependencies`，不会被版本闸门拦下
升级后行为没变	已加载的代码不会热替换：重启 DSH；重启后状态里会报告运行版本与已装版本是否一致

logLevel: debug 可看到长轮询、去重、回合收集与竞速细节；日志都带 [dsh-wechat] / [dsh-wechat:channel] 等前缀。

错误提示是「可照做」的：网关只回代码（HTTP 500、ret=-2、ret=-14），插件会补一句该怎么办——非图片文件被当成图片发送会提示「改按文件发送」；ret=-2 会提示「同一窗口最多 10 条，回一句话即可解锁」；ret=-14 提示重新扫码；上传超时给出体积与预算。记录的「最近错误」若来自上一次运行会明确标注。

安全默认

凭据/状态/附件 0600、目录 0700；写入「临时文件 + rename」原子替换，写失败清理临时文件，/logout 连读取失败留下的副本一并清除；
发送边界：只发往当前会话/所有者/白名单；状态目录内的文件（含凭据）拒绝发送；
日志与工具进度行脱敏：Bearer …、sk-…/github_pat_…/AKIA…/AIza…、JWT、PEM 私钥块、token=… 与中文字段名（密码/令牌…）；
网络：所有请求禁止跟随重定向；登录返回的 API 基座与 CDN 地址强校验（公网强制 https）；
卡片接口只监听宿主 GUI 的回环端口，不带令牌（与同类插件一致）；二维码只在设置页卡片与终端出现。

完整清单见 docs/side-effects.md。

平台支持

macOS 已实测（DSH 0.2.0-rc.2 与 0.2.1-rc.2 桌面端，微信收发闭环）；Linux / Windows 代码路径已审计但未实测。零运行时依赖、无原生模块、无需编译。平台细节（权限位差异、Windows 保留设备名与结尾点、原子写的退避重试、终端二维码字形）见 docs/design.md。

合规提醒

通过腾讯 iLink / ClawBot 官方扫码绑定路径接入微信，但仍需遵守微信与腾讯的相关协议：不要用于群发营销、批量加好友等违规用途；账号能否使用该能力由平台决定。

许可

MIT

dsh-wechat

把 DeepSeek Harness（DSH）接进微信：扫码绑定一次，之后在微信里派活、收结果、答审批。宿主侧 cordis 插件，零运行时依赖。

给 Agent 的摘要：宿主侧 cordis 插件；dsh plugin --profile <p> add <tgz> 安装，node bin/dsh-wechat.mjs login 扫码绑定（二维码打印在终端；GUI 里用设置页卡片）；绑定后微信即为一个 DSH 会话客户端（命令表见下）。改动前必读「行为契约」；排错看「故障排查」。实现细节在 docs/design.md。

文档地图（本页 = 操作入口；实现细节在独立文档里）：

文档	内容
README.md（本页）	安装、命令、配置、行为契约、超时、排查——照做即可
docs/design.md	架构、队列与竞速语义、投递实现、iLink 协议要点、与 DSH 的契约、平台兼容性
docs/side-effects.md	对系统的全部副作用（进程/端口/文件/定时器/网络出口）逐项清单
docs/profile-verification.md	一次性 profile 的安装/组合/启动/卸载证据与结果

安装

# 1) 从 Releases 取 tarball：https://github.com/zgat/dsh-wechat/releases
dsh plugin --profile desktop add ./dsh-wechat-<版本>.tgz      # 例如 0.1.41
#    也可以走 GUI：设置 → 插件 → 安装，粘贴该 tgz 路径

# 2) 扫码绑定（二维码打印在终端）
node bin/dsh-wechat.mjs login

# 3) 在微信里给机器人发任意一句话，会收到上手引导（/help 看全部指令）

无人值守（环境变量优先于凭据文件，不落盘）：

export DSH_WECHAT_BOT_TOKEN=ilinkbot_xxx
export DSH_WECHAT_BASE_URL=https://ilinkai.weixin.qq.com   # 可选
export DSH_WECHAT_BOT_ID=xxx@im.bot                        # 可选
export DSH_WECHAT_USER_ID=xxx@im.wechat                    # 可选：指定所有者

不给 DSH_WECHAT_USER_ID 时这条凭据没有所有者 → 所有被允许的联系人都视同所有者；无人值守部署请显式指定或收紧白名单。

验证与升级

版本不一致 = 需要重启：重启后插件会在状态里同时报告「运行中的版本」与「磁盘已装版本」，不一致时会明确提示。

配置改动热生效；升级已加载插件的代码需要重启（原因见 docs/design.md）：

node scripts/schedule-restart.mjs --cancel       # 取消已排程的重启
dsh --profile <profile> --dump-config | grep -A3 dsh-wechat   # 不启动时自检

能力速览

能力	说明
扫码绑定	iLink/ClawBot 协议；凭据本机保存（`0600`），无需 appid/secret
收发消息	长轮询收私聊；回复自动分段（默认 1800 字/段），失败退避重试 + 整轮后补发
会话映射	一个微信会话 ↔ 一个 DSH 会话，持久化绑定，重启后自动 `resume`
斜杠命令	切会话/工作区/模型/权限、看状态、停止回合（见下方命令表）
审批与提问	`approval/request`、`user-questions/request` 转发到微信；回「允许/拒绝/取消」或选项序号
跟读 `/listen`	其它客户端（GUI 等）在同一会话跑完的结果推到这里；该会话的审批/提问两端都能答
图片 / 文件	入站图片/文件/语音/视频解密落盘并把路径交给 Agent；Agent 可用工具把产物发回
模型工具	`wechat_send_text`、`wechat_send_file`、`wechat_chat_info`
访问控制	默认白名单 + 所有者模型；非所有者不能改权限、不能清凭据
错误日志	失败记录独立成页（设置页卡片给入口），默认保留 30 天、最多 300 条、一分钟内同类错误合并计数；微信里也可 `/errors` 查看最近 10 条
多 bot	一个插件实例可同时绑定多只机器人：每只各自长轮询、独立会话与命令；设置页点「添加绑定」扫码新增，已有的不受影响
设置页卡片	DSH 设置 → 微信：每只 bot 的昵称与在线状态、扫码时的二维码（内联 SVG，加载转圈）、添加绑定、刷新、改名（卡片内联输入框）、单方面解绑（两步确认）（客户端半边，见下）
长任务可见	「对方正在输入」+ 工具进度行（`progress: brief`）；长任务不静默、也不额外占用发送额度
渠道提示词	自动告诉模型「这个会话在微信里」：最终回答会自动送达、交付文件用 `wechat_send_file`、长内容先落盘再发——避免它把产物只写到磁盘上（只注入本插件创建的会话）
断线自愈	长轮询退避重试且不丢游标；`ret=-14` 自动清凭据并重新扫码；登录失败 60 秒重试

错误日志

失败不再显示在设置页卡片里（那里只留一个带条数的「错误日志」入口），改为独立页面与命令：

页面：<宿主地址>/dsh-wechat/errors?t=<令牌>，表格按时间倒序列出，同类重复错误合并为一条并计数；
命令：/errors 返回最近 10 条（仅所有者）；
保留：默认 30 天、最多 300 条；一分钟内重复的同一条错误合并计数。可用 errorLogDays / errorLogEntries 调整；
存储：写在 state.json 的 errors 数组里（0600），/status 仍保留最近一条的摘要。

多 bot

一个插件实例可以同时绑定多只微信机器人（iLink bot）：

添加：DSH 设置 → 微信 → 「添加绑定」→ 扫码。新 bot 立即开始工作，已有的 bot 继续在线，不需要重启。
昵称：iLink 官方接口只返回 ilink_bot_id / ilink_user_id（Clawbot 相关接口的 QR 状态响应里没有昵称字段），所以昵称是本地的：卡片里点「改名」即可（按 bot 持久化、重新扫码不丢），默认显示 微信机器人 <id 尾 4 位>，原始 id 仍以小字保留。
所有者：每只 bot 的所有者是扫码绑定它的那个账号（不是第一只 bot 的所有者）；默认 allowlist 策略下，第二只 bot 由别的微信号绑定时，那个账号照样可以直接对话/用命令。
隔离：会话键带 bot id（p2p:<bot>:<user>），所以两只 bot 接到同一个人的消息也各自独立——会话、/listen、/model、待答交互都不串。
投递：回复永远走收到这条消息的那只 bot，不会用别的 bot 的凭据发送。
移除：设置页卡片里每只 bot 有「解绑」按钮（立即停掉该 bot 的长轮询并删除凭据，其它 bot 不受影响）；在微信里也可 /logout（当前那只）或 /logout all（全部）。
迁移：旧的单 bot 状态在启动时自动迁移（凭据改成 {version:2,bots:{…}}，会话键补上 bot id），已有会话绑定不变。
超时：一次「添加绑定」默认 300 秒内没扫码就取消（loginTimeoutSeconds 可调），并把原因记进错误日志，卡片不会一直停在「添加中…」。

CLI 里 dsh-wechat --status 会逐只列出 bot、凭据来源、API 基座与长轮询游标。

设置页（GUI）

插件带一个客户端半边：DSH 设置 → 微信里有一张卡片，显示

连接状态（已连接 / 等待扫码 / 登录失败）与 bot 名；
未绑定时直接显示二维码（从 /dsh-wechat/api/qr 取 SVG 标记内联绘制），旁边有「刷新二维码」与「添加绑定」；
最近错误（来自 /status 同一份状态）。

微信里的命令

命令	作用
`/help`（`/帮助`、`/?`）	显示帮助
`/new`（`/新会话`、`/reset`）	结束当前会话，下一条消息开启新会话（工作区/模型设置保留）
🔒 `/permission [模式]`（`/权限`、`/perm`）	查看/切换本对话的权限模式：`read-only` / `workspace-write`（默认）/ `danger-full-access`（需 `/permission danger-full-access confirm` 二次确认）；仅所有者可切换
`/session [序号\|会话 ID]`（`/会话`、`/对话`）	列出当前工作区的对话（标题与 DSH 界面一致，附时间/「运行中」/「←当前」）并切换；切换后询问是否把最近 N 段回执到微信（回 0-99，不回＝不回执）；子会话与已归档对话不列出；`/session new` 等价 `/new`，`/session sources` 打印来源诊断
`/stop`（`/停止`）	停止正在运行的回合；连排队消息一起丢弃并告知条数
`/whoami`（`/我是谁`）	你的微信 ID、会话键、DSH 会话 ID
`/workspace [序号\|名称\|路径]`（`/工作区`、`/项目`）	列出项目目录（标题优先）并切换；切换即结束当前会话
`/workspace add <路径> [名称]`	把目录登记为 DSH 工作区（GUI 里也会出现）并切过去
`/model [序号\|provider/model]`（`/模型`）	列出/选择模型（对下一个新会话生效）
`/reasoning [序号\|档位]`（`/思考`、`/effort`）	列出/选择思考深度（对下一个新会话生效）
`/settings`（`/设置`）	汇总当前会话的工作区、模型、思考深度
`/login`（`/登录`）	重新扫码登录的方法（在 DSH 设置 → 微信里点「添加绑定」）
`/listen`（`/接收`、`/订阅`、`/follow`）	开始跟读：其它客户端跑完的回合推到这里（直接发正文，无前缀），且该会话的审批/提问两端都能答；未绑定时先建好会话
`/mute`（`/停止接收`、`/免打扰`、`/unfollow`）	关闭跟读（不影响你自己回合的回复与审批/提问）
🔒 `/logout`（`/退出登录`）	清除本机凭据（会停止收发）；仅所有者可用
`/ping`	连通性检查

🔒 = 仅所有者可用。命令在进入 Agent 之前被处理，不消耗模型额度。

Agent 可用的工具

工具	用途
`wechat_send_text`	往当前微信会话发一条文本（阶段性进展、提醒）
`wechat_send_file`	把本地文件作为微信图片/文件发回（按扩展名判断图片，AES 加密 + CDN 上传）
`wechat_chat_info`	查询当前会话/DSH 会话/工作区/模型/运行状态

最终回答由插件自动回传，模型不需要也不应该重复发送。

配置项

写在 profile 的 $DSH_HOME/profiles/<profile>/cordis.patch.yml（patch 会整体替换 config，请写全要保留的键）：

- id: dsh-wechat
  name: 'dsh-wechat'
  config:
    enabled: true
    accessPolicy: allowlist
    allowedUserIds: ['oABC123example@im.wechat']
    workspace: /Users/me/projects/demo
    progress: brief

键	默认	说明
`enabled`	`true`	`false` 时插件完全不动（不注册监听、不连网）
`stateDir`	`$DSH_HOME/integrations/dsh-wechat`	凭据、状态、媒体、二维码的存放目录
`workspace`	第一个 DSH 工作区，否则 `process.cwd()`	新会话的工作目录（绝对路径）
`accessPolicy`	`allowlist`	`allowlist` 只服务白名单；`open` 接受任何发送者
`allowedUserIds`	`[]`	允许的微信用户 ID（也接受逗号分隔字符串）
`ownerUserId`	`null`	所有者，始终放行；留空时自动采用扫码绑定的微信号
`autoLogin`	`true`	无凭据时自动走扫码登录
`qrInCard`	`true`	二维码是否画在设置页卡片里（`false` 时只在终端/命令输出里出现；旧名 `loginPage` 仍接受）
`errorLogDays` / `errorLogEntries`	`30` / `300`	错误日志保留天数与条数上限
`loginTimeoutSeconds`	`300`	一次「添加绑定」的最长等待时间，超时自动取消并记入错误日志
`baseUrl`	`null`	覆盖 iLink 网关地址（默认 `https://ilinkai.weixin.qq.com`）
`cdnBaseUrl`	`null`	覆盖媒体 CDN 地址
`chunkChars`	`1800`	单条微信消息的最大字符数
`maxAnswerChars`	`20000`	一轮回答最多推送多少字（超出以「已省略 N 字」标注）；`0` = 不截断
`chunkDelayMs`	`350`	段与段之间的间隔，降低撞上发送限流的概率
`sendRetryMs`	`[500, 2000, 5000, 10000]`	单段失败的重试退避（仅瞬时错误；`ret=-14` 不重试）；整轮结束后仍失败的分段会再补发一轮
`typing`	`true`	是否显示「对方正在输入」
`typingKeepaliveSeconds`	`5`	输入状态保活间隔
`progress`	`brief`	`off` 只回最终答案；`brief` 加工具进度；`verbose` 再加中间说明
`showToolProgress`	`true`	`progress != off` 时是否推送 `🔧 tool` 行（关掉只影响通知，不影响工具可用）
`turnTimeoutSeconds`	`900`	超过这个时长发一条提醒（回合继续在后台跑，不是中断）；`0` = 不提醒（见「超时与节奏」）
`approvalTimeoutSeconds`	`300`	审批卡有效期；超时把决策交回另一端
`questionsTimeoutSeconds`	`600`	提问卡有效期；超时同上
`idleDisposeMinutes`	`0`	安静这么多分钟后释放常驻 Agent（绑定保留，下条消息自动 resume）；`0` = 常驻，可写小数
`agentPreset`	`null`	会话挂载的 agent preset；留空采用 DSH 默认（`standard`，含 `tool-bash`/`tool-fs`/`tool-fs-search`/`plan-mode` 等）。未挂载时微信里的 Agent 只有 `wechat_*` 工具
`model`	`null`	`provider/model` 或 `{ provider, model, reasoningEffort?, maxTokens? }`；留空采用 DSH 默认模型（必须能解析出路由）
`media.enabled`	`true`	是否收发图片/文件
`media.dir`	`stateDir/media`	入站附件落盘目录
`media.serveInbound`	`true`	把入站图片挂到卡片的回环路由 `/dsh-wechat/media/<不透明 id>`，并在消息里附 Markdown 图片链接（能不能显示成缩略图取决于 GUI 是否渲染用户消息里的图片；关掉则只给路径）
`media.maxInboundBytes`	`20971520`	入站媒体上限，超出直接拒绝
`media.maxOutboundBytes`	`52428800`	出站文件上限（本地保险）。实测 30 MiB / 33.4 MiB 都能正常送达，该量级没有平台大小限制
`media.uploadTimeoutMs`	`0`	上传超时预算；`0` = 按体积自动（假设 ≥50KB/s，下限 120 秒、上限 15 分钟）。33MB 约 12.7 分钟；上行慢就调大
`notifyLifecycle`	`false`	是否发送 `msg/notifystart\|notifystop`（非公开协议，失败忽略）
`routeTag`	`null`	`SKRouteTag` 路由标签，仅部署方需要时填写
`channelVersion`	`1.0.0`	`base_info.channel_version`
`logLevel`	`info`	`silent` / `error` / `warn` / `info` / `debug`

行为契约（改动前必读）

只回微信发起的回合：按回合号配对，GUI 里跑的回合不会推到这个聊天（/listen 是显式例外）。
绑定独占：一个 DSH 会话同一时刻只属于一个微信会话，反之亦然；第二个会话要切进来会被明确拒绝（提示当前持有者，让它 /session new 释放）。
回答提问与审批：选项接受序号、选项文字或其前缀（2 / 方案 B / B）；单问题时含选项名的整句保持为自由回答。取消 = 不在微信答、交回原客户端。审批卡与提问卡的提示文案各自正确（不会互相串）。
交互归属：审批/提问只发给"此刻正在跑的那一轮"的发起方。微信发起的回合两端都能答（微信 + GUI，先答先算，另一端收到"已作废"并自动关框）；GUI/后台发起的回合默认不打扰微信，开 /listen 才双端；另一端没有应答者时不影响微信这张卡。
上下文窗口约 15–30 分钟：微信只能回复"最近说过话"的会话。超时提示后，用户回一句话（或 /listen）即可让那一轮复活，跑完的答案补发到微信；未再互动的回合按旧规则丢弃迟到的 turn/end。
发送单向：回执、切换确认、欢迎语、失败提示、跟读结果都只走"发往微信"的通道，不进入模型上下文；唯一进入会话的是用户消息原文（以及附件的落盘路径说明）。
命令不消耗模型额度：斜杠命令在进入 Agent 之前处理；/session 切换只重绑会话，不新建也不截断历史。
群聊不支持：iLink 的群消息没有可靠的回复路由，收到即忽略（debug 日志记一条）。
多联系人相互独立：每个微信联系人各自独立的会话与上下文。
出站按会话串行：同一会话的发送（回答分段、工具进度、wechat_send_text、wechat_send_file 及其说明文字）排成一条队列，不会交错；"说明 + 文件"作为一次排队发送，中间不会插进别的消息。
渠道提示词：本插件创建的会话会注入一段「微信渠道」说明（dsh-wechat:channel，order 10150），告诉模型回答会自动送达、交付文件用 wechat_send_file；GUI 自己开的会话不受影响。

超时与节奏（默认值速查）

项	默认	行为
单轮提醒	900s（15 分钟）	只发一条提醒（回合继续跑）；设 `turnTimeoutSeconds: 0` 可完全不提醒；用户回话即"复活"，答案随后补发
平台发送额度	同一窗口 10 条	超出被拒（`ret=-2`）；用户在微信发任意一句话即可解锁
审批卡	300s（5 分钟）	超时只撤微信卡，决策权交回另一端
提问卡	600s（10 分钟）	同上
上下文窗口	约 15–30 分钟	到期后主动推送报 `ret=-2 (prepare failed)`；需该会话先有新消息
工具进度	每轮 12 条	之后提示"后续进度不再逐条推送"

权限、外部依赖与失败边界

按 DSH STORE 的上架契约披露。本插件是宿主侧插件，以 DSH 进程权限运行——安装前请据此评估。

能力	用在哪里	范围与限制
文件	状态目录 `$DSH_HOME/integrations/dsh-wechat`（凭据/游标/绑定/启动记录，`0600`，目录 `0700`）、媒体目录（默认其下 `media/`，入站附件 `0600`）、二维码 SVG 文件	不写工作区、不写系统目录（`LaunchAgents`/`crontab`/`systemd` 一律不碰）；写入原子化并带瞬时错误重试
网络	出站长轮询与发消息（默认 `https://ilinkai.weixin.qq.com`）、附件上传下载（默认 `https://novac2c.cdn.weixin.qq.com/c2c`）、回环接口（`/dsh-wechat/api/*`，随宿主 GUI 端口）	目标可用配置覆盖但强校验（公网强制 https）；所有请求 `redirect:'error'`；无遥测、无第三方端点（由 `test/sideeffects.test.mjs` 出站白名单强制）
命令/子进程	无：插件不启动任何程序（不打开浏览器、不执行 shell），也不自开监听端口（二维码由设置页卡片绘制）	由 `test/sideeffects.test.mjs` 断言运行时（`lib/`、`bin/`）不得导入子进程 API
凭据	读取并保存机器人令牌（`credentials.json`，`0600`；也可由环境变量提供，此时不落盘）；日志与工具进度双重脱敏	不读取系统钥匙串、不读取无关环境变量；`/logout` 仅所有者可用，并清除读取失败留下的副本
原生制品	无	零运行时依赖、无原生模块，安装不触发编译
受保护的 DSH 行为	不修改、不遮蔽、不重复安装任何 `@deepseek-ai/*` 组件	只通过 `ctx.get(key)` 使用宿主服务，入口 ID 唯一

外部服务：微信 iLink 网关（必需）、媒体 CDN（仅收发附件时）。二者非本仓库所有，可用性取决于腾讯侧。

故障排查

现象	处理
日志只有 `还没有凭据，跳过接收`	没有凭据：在设置页点「添加绑定」，或运行 `node bin/dsh-wechat.mjs login`
看不到二维码	① DSH 设置 → 微信的卡片（点「添加绑定」）；② 终端登录时的二维码；③ 状态目录里的 `login-qrcode.svg`
卡片里没有二维码	确认运行的是含客户端半边的版本，且 profile 里插件为启用状态；`/status` 里应有 `qrUrl`
反复 `接收消息失败（第 N 次）`	网络到不了 `ilinkai.weixin.qq.com`：`curl -I https://ilinkai.weixin.qq.com/ilink/bot/get_bot_qrcode?bot_type=3` 验证
`微信会话已过期（ret=-14）`	插件会清凭据并重新扫码；也可先 `logout` 再 `login`
`no context_token cached` / 主动推送报 `ret=-2 (prepare failed)`	距该会话最后发言超过约 15–30 分钟：让对方先发一条消息即可恢复
长回答丢段 / 「有 N 段未能发出」	微信平台限制：同一窗口最多连发 10 条，超出的会被拒（`ret=-2 prepare failed`），在微信里回任意一句话即可解锁；插件已退避重试 + 整轮补发，仍失败会告警。看插件记录的最近错误原文
大文件发送失败（`CDN upload timed out`）	上传预算按体积放大（33MB ≈ 12.7 分钟）；仍失败说明上行持续低于 50KB/s（实测正常在 1.2–6 MB/s），可用 `media.uploadTimeoutMs` 再调大
长任务很久没动静	微信发任意一句话（或 `/listen`）让那一轮复活；查看队列与运行状态
审批/提问在微信没出现	该轮不是微信发起的（默认不打扰）；开 `/listen`，或直接在 GUI 回答
审批框「允许」没生效（≤0.1.33）	0.1.34+ 已修（请求挂起时不再 abort 宿主信号）；重启后确认版本
`/session` 显示 `[object Object]`	0.1.15 已修（标题快照对象经 `titleText()` 取文本）；版本过旧则升级
`/session` 里显示"未命名对话"	该会话还没有 `session/title` 事件；`/session sources` 看来源诊断
微信里的 Agent 说"没有跑命令的工具"	会话未挂 agent preset（0.1.13 起自动挂载）；查看会话挂载的「预设」；旧会话需 `/new`
收到的图片打不开	检查 `media.maxInboundBytes`；日志 `inbound media decryption failed` 表示发送端密钥编码非标准——原文会以 `<名称>.enc` 落盘并标注不可读
回复是「回合被拦截」	会话被 DSH 归档：0.1.6 起微信侧自动改开新会话；否则按提示 `/new`
想继续某个旧对话	`/session` 列出选择；被归档的对话会提示先取消归档
微信里出现 `⛔ 发送者 … 不在白名单内`	把该 ID 加进 `allowedUserIds` 或设为 `ownerUserId`
插件完全没加载	`dsh --profile <name> --dump-config` 确认 patch 行存在；本插件不声明 `peerDependencies`，不会被版本闸门拦下
升级后行为没变	已加载的代码不会热替换：重启 DSH；重启后状态里会报告运行版本与已装版本是否一致

logLevel: debug 可看到长轮询、去重、回合收集与竞速细节；日志都带 [dsh-wechat] / [dsh-wechat:channel] 等前缀。

安全默认

凭据/状态/附件 0600、目录 0700；写入「临时文件 + rename」原子替换，写失败清理临时文件，/logout 连读取失败留下的副本一并清除；
发送边界：只发往当前会话/所有者/白名单；状态目录内的文件（含凭据）拒绝发送；
日志与工具进度行脱敏：Bearer …、sk-…/github_pat_…/AKIA…/AIza…、JWT、PEM 私钥块、token=… 与中文字段名（密码/令牌…）；
网络：所有请求禁止跟随重定向；登录返回的 API 基座与 CDN 地址强校验（公网强制 https）；
卡片接口只监听宿主 GUI 的回环端口，不带令牌（与同类插件一致）；二维码只在设置页卡片与终端出现。

zgat/dsh-wechat

dsh-wechat

安装

验证与升级

能力速览

错误日志

多 bot

设置页（GUI）

微信里的命令

Agent 可用的工具

配置项

行为契约（改动前必读）

超时与节奏（默认值速查）

权限、外部依赖与失败边界

故障排查

安全默认

平台支持

合规提醒

许可

Community comments

zgat/dsh-wechat

dsh-wechat

安装

验证与升级

能力速览

错误日志

多 bot

设置页（GUI）

微信里的命令

Agent 可用的工具

配置项

行为契约（改动前必读）

超时与节奏（默认值速查）

权限、外部依赖与失败边界

故障排查

安全默认

平台支持

合规提醒

许可

Community comments