yauntyour/DSH-WX-Msg-Tool

README 摘要

@deepseek-ai/dsh-wx-msg-tool DSH 微信消息工具插件（微信 ClawBot / iLink 协议）：设置页扫码登录并自动保存 api-token，提供 wx login / wx send / wx poll / wx status 四个工具，让 DSH 直接收发微信消息。 基于腾讯官方开放的微信 ClawBot（iLink，智联）Bot API（ ilinkai.weixin.qq.com ），HTTP/JSON 协议，无 SDK 依赖、无 Hook、无封号风险。使用前请阅读并遵守《微信ClawBot功能使用条款》。 功能 - 设置页扫码登录 ：DSH Web 设置页新增「微信消息」页 —— 点「扫码登录」由浏览器本地 canvas 绘制二维码（腾讯返回的 qrcode img content 是 liteapp 交互页 URL 而非图片，且禁止 iframe 嵌入，故插件内置零依赖 QR 编码器按该 URL 编码，与官方页面渲染等价），手机微信扫码确认后 api-token 自动保存（设置文档 secret 字段 + /plugins/wx-msg-tool/state.json ，仅存本机，浏览器永远拿不到 token）。设置页通过插件自有 HTTP 通道（ /wx-msg/state 、 /wx-msg/login 、 /wx-msg/config ）与宿主通信——官方 settings 线上通道只暴露核心命名空间（ WEB SETTINGS NAMESPACES ），第三方设置页需要自带通道（与 dsh-better-sidebar 同模式）。 - 工具（4 个） ： 工具 说明 wx login qrcode 发起扫码登录（headless 可用）/ status 查登录态 / logout 退出并清除 token wx send 发送文本消息； to 与 context token 取自 wx poll 返回的消息（回话关联必需） wx poll 收取消息：关闭自动轮询时直连服务器长轮询，开启时读取后台监控收件箱 wx status 通道状态：登录态 / token 是否存在 / 监控状态 / 收件箱条数 - 后台自动长轮询 ：设置页开启后，宿主进程持续长轮询并把消息暂存到收件箱（ inbox.jsonl ），供后续 wx poll 取走；会话过期（errcode -14）自动停轮询并提示重新登录。 - 自动会话回复（Clawbot 闭环） ：设置页开启「收到消息自动触发 DSH 会话回复」后，每条微信消息驱动一轮真实 DSH 会话——每用户一个持久会话（ chats.json 记录会话 ID，重启后 resume 续聊），用默认模型跑完一轮后把助手的回复自动发回微信（带原消息的 context token 关联会…

分类