dsh-wechat

dsh-wechat

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

给 Agent 的摘要：宿主侧 cordis 插件；dsh plugin --profile add 安装，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 仍以小字保留。
• 所有者：每只 bot 的所有者是扫码绑定它的那个账号（不是第一只 bot 的所有者）；默认 allowlist 策略下，第二只 bot 由别的微信号绑定时，那个账号照样可以直接对话/用命令。
• 隔离：会话键带 bot id（p2p::），所以两只 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//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/，并在消息里附 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。

行为契约（改动前必读）

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