微信群聊助手 hjjhkr/dsh-wechat-bot

dsh-wechat-bot

让一个微信小号像普通群友一样在一个群里聊天的 DeepSeek Harness（DSH） 插件。

当前状态（2026-10-23）
- ✅ 测试账号真实加密库、与测试联系人的私聊入站、真实模型生成及微信回发已通过。
- ✅ 测试群已通过会话选择、双击打开独立窗口、按选中窗口走 native 文字发送，并以精确数据库回执确认真实发送；正式 /help 的收件和回件也已逐条核对。
- ✅ 正式 /ask 使用真实模型生成三段且三段都已确认发送；结束时 backlog 为 0，modelErrors、sendErrors 均为 0。
- ✅ 新加入的另一群已完成初始化、正式 /help 和模型回复；窗口绑定与恢复修复为通用流程，不按群名或群 ID 加特例。
- ✅ 必需的 Windows worker 源码及其测试、第三方许可证、固定依赖清单已迁入 adapters/wechat-db/native-runtime，新版无需从旧项目目录加载源码。
- ✅ 插件预留的 window/get|set 已接通：显示小号专用桌面、正常扫码登录、点击返回主桌面；微信保留在后台。
- ℹ️ 默认发送方式仍是写入 JSON 发件箱；只有显式提供本机 --sender-config 才启用同步真实文字发送。微信版本、Weixin.dll 与控件门参数必须和本机配置匹配；其他版本未验收。
- ⏳ 当前只验收单活动目标；多会话并行、群聊长期稳定性、锁屏发送恢复和媒体收发/识别尚未验收。

文档中的账号、联系人、群名、消息标识和路径均使用通用示例；真实聊天记录、账号配置及验收证据留在部署者本地。

能做什么

- 合并连发的消息：群里 3 秒没有新消息就把攒下的合成一批（从第一条算最多等 8 秒），以 JSON 数组一次交给模型，多人连着说也只回一次。两个时间所有模式统一，聊天里 /wait 3 8 随时调整。
- 续发重写：这一批里说过话的人，在这批交给模型后的一个静默期（3 秒）内又补了一句、且回复还没发出，草稿作废，带上补充重写一次；每条消息最多重写一次，不会被一直拖住。别人的话、更晚的补充进下一批；命令不触发。
- 判断在跟谁说话：程序先根据 @、引用、叫名字、刚聊完接着说 算出每条消息的 addressed（you / maybe / other / none）和依据，再交给模型判断；有人直接找它却不回，会纠正一次。交给模型的消息按人分组（成员甲：1、2、3；成员乙：1、2），另附时间顺序；每人的长期记忆在后台上下文中按 ID 绑定，模型不必从交错的消息里分辨谁说了什么。
- 定向互动：/attack 昵称 持续嘲讽某人、/comfort 昵称 持续安慰某人，主动开场后 TA 说一句才回一句，TA 不说话就不发，其他人一律不理；/unattack /uncomfort 停止，TA 一小时不说话自动结束。
- 三种发言模式（可用命令随时切换）：free 每批都给模型自由接话；infer（默认）先判断消息是否真的在找它，普通群聊默认安静，主动插话最多一条且默认全群共用2分钟间隔，整批都明确在和别人讲话时跳过；at 只回 @ 和引用；另有 silent 静音。
- 命令即时执行、插队：/ 命令在插件运行时里直接执行，不经过模型；回复插到所有排队消息前面立即发出；改变状态的命令（切模式、禁言、忘记、清上下文、/ask）会打断正在思考的旧回答，旧批次按新状态重新处理。
- 模型与思考强度可调：/model 切换模型、/think off|low|high|max 调思考强度，切换前按 DSH 的模型目录校验，重启后保持。
- 定时消息：/cron 10m 内容、/cron 10:00 内容、/cron 每天 22:00 UTC-5 内容……本地定时库，重启不丢。
- 联网与每日播报：群回复可查询 HLTV、Apex Legends Status 和 CSQAQ；每日北京时间 10:00–21:00 随机发送一条 HLTV 新闻，17:30 发送当天 19:30 的 Apex 排位地图。HLTV 通过 DeepSeek 云端读取归档、搜索站内文章、核对标题与时间后生成中文摘要；搜索索引可能滞后、文章正文可能缺失，失败时记录错误而不编造。云端抓取可能收费，服务不提供最终跳转地址，无法核实整个访问链路仅经过目标网站。只在当前监听的群运行，超过计划时间 10 分钟不补发；失败或中断记录在群日志及状态中。CSQAQ 查询使用 DSH 凭据 CSQAQ_API_TOKEN，需站方允许当前出口 IP，不把令牌放入项目配置。
- 身份认 wxid，名字跟着最新的走：群昵称、昵称、备注、微信号都映射到 wxid 上；改名后按新名字也能找到同一个人，记忆和互动不受影响。
- 按 ID 记住人：长期记忆保存在 <dataDir>/memories/<聊天hash>/id-<用户ID的SHA256>/MEMORY.md，文档标明原始用户 ID。每人最多 30 条精选自动记忆，整份文档最多 16 KiB；稳定背景、交流偏好、持续事项和互动约定按主题合并修正。人工补充区可手动编辑，程序不改；每次回复重新读取当前发言人的文档，按回复对象 ID 使用，影响语气、详略和举例。后台每群最多 2 次/分钟，infer 跳过回复的消息也可学习；/memory 查看自己被学到的笔记，/forget 删除自己的某条或全部自动记忆（人工补充保留）。某个文件被改坏时只跳过这个人并记一次日志，不影响回复别人。
- 人设库：<dataDir>/personas/ 里每个 .md 文件是一个人设（文件名即人设名），可以手工增删改，下一条回复就用上；/persona 查看和切换，默认 大肥鱼（mini 版，适合不开思考的模型；开思考时可换 大肥鱼-pro），旧人设保留为 小鲸鱼。
- 扛得住、能自愈：积压上限、限速、模型超时、连续失败熔断、看门狗、适配器崩溃自动重启；有压力与混沌测试。
- 收消息与处理不依赖桌面窗口：适配器从本地数据库读取，插件按状态处理；可选真实发送后端需要可用的微信桌面窗口，锁屏发送恢复尚未验收。
- 在 DSH 里看得见：右侧栏控制台显示连接、群、模式、临时处理日志和健康指标；工作区「微信 · 群名」会话展示模型输入和最终输出，联网查询中间过程不显示，启动时自动绑定。镜像使用本次运行的内存会话，不新增 JSONL 聊天日志，退出时解除会话绑定；DSH 自带的投影缓存保留。/wechat eval 用真实模型评测"该不该说话、在跟谁说"。
原则：何时调用模型由脚本控制，先判断对象，再决定是否发言。 对象信号、发言模式、目标识别（按数据库里的发送者 id）、定向互动的触发、记忆归属、限速熔断由程序处理；要求模型对所有成员使用相同的判断标准，不以熟悉程度和最近聊天次数增加回应优先级。直接找机器人时要求回复，沉默会纠正一次；推断模式的普通消息默认安静，主动插话由程序按意图限频，且不会因此把群友后续每句话都当成找自己。

完整命令见 docs/commands.md。和最初版本的对比见 docs/handoff.md。

目录

plugins/dsh-wechat-bot/ DSH 插件（安装的就是这个目录） lib/ index.js 插件入口、配置 schema app.js surface.js DSH 集成：控制台 API、/wechat 命令、wechat_bot 工具 session.js model.js DSH 原生临时会话镜像、模型调用 bot.js 适配器连接与自动重启、所服务的群、看门狗 chat.js 一个群的流水线：命令 → 合批 → 模式 → 对象判断 → 模型 → 记忆 → 发送 batcher.js addressing.js prompt.js decision.js memory.js memory-learning.js 后台记忆学习（MemoryLearner：独立排队、限速、取消、重试） memory-maintenance.js 记忆整理（30 条或接近大小上限自动触发 / 控制台手动），按用户 ID 串行 model-agents/ reply、memory 两份 AGENTS.md，插件加载时读入 markdown-memory.js 按用户 ID 保存 MEMORY.md：读取宽松、按主题写入、人工区不动 personas.js 人设库（/persona） page-lifetime.js exitWithPage：最后一个页面关闭后停机并退出 DSH roster.js 群成员名册（当前名字，短缓存，读不到不拖慢回复） commands.js cron.js 命令（含 /cron） engagement.js /attack /comfort：按昵称或 @ 找人（脚本完成，不交给模型） models.js /model /think：模型与思考强度切换（按 DSH 模型目录校验） guard.js 限速、熔断、超时、发送优先通道 protocol.js rpc.js adapter.js simulator.js 适配器协议、传输、模拟器 store.js eval.js client/index.js 右侧栏控制台 bin/simulator.js bin/check-adapter.js personas/ test/ adapters/wechat-db/ 微信数据库适配器（Python）：读库收消息；默认发件箱，可选内置 worker 真实文字发送 native-runtime/ 已迁入的 Windows worker 源码、测试、许可证和依赖清单 main.py 参数入口（含可选 --sender-config） wechat_db/source.py 加密库范围约束与读取 wechat_db/adapter.py 协议、监听及 outbox/delivery 分流 wechat_db/delivery.py 可选同步发送的持久防重与回执 wechat_db/legacy_sender.py 旧 worker 子进程及会话目标选择 wechat_db/detached_window.py 双击打开/复用目标独立窗口 wechat_db/native_window_worker.py 隐藏桌面窗口准备、验证与派发 wechat_db/native_binding.py 已绑定 HWND 的进程/窗口/DLL 身份复核 wechat_db/desktop_control.py 插件预留显隐接口、专用桌面登录与返回按钮 wechat_db/native_send.py 选中窗口的文字发送和数据库回执 docs/ protocol.md 协议 · commands.md 命令 · handoff.md 交接与对比

回复请求的输入分为两层：人设、平台规则、近期聊天和按成员 ID 绑定的完整记忆放在后台提示上下文；当前 user 消息仅包含本轮新消息 JSON（now/chat/you/new，以及可选 event）。DSH 微信会话仅显示这条新消息 JSON，纠错时显示修正要求。后台历史和记忆仍参与本轮模型请求，这项分层不减少它们占用的 token。

安装

DSH Web（本轮验证过的安装流程）

1. 克隆仓库，并启动使用独立 DSH_HOME 的 DSH Web 实例。
2. 将插件链接到 Web profile：dsh plugin --profile web add link:<插件绝对路径>。插件的 Host peer dependencies 由 DSH 运行时提供；不要把其他实例的 node_modules 链接进源码目录。
3. 在工作区会话输入 /wechat，按提示完成初始化，再在控制台「选择会话」中选择目标群或私聊。

DSH Desktop（保留的旧说明，本轮未验证）

DSH Desktop ≥ 2.0（运行时 0.2.1-rc.2）可在 设置 → 插件 → 添加插件 中选择 …\dsh-wechat-bot\plugins\dsh-wechat-bot，或使用 dsh plugin --profile desktop add link:<该目录>；重启后在工作区会话输入 /wechat。本轮真实微信验收是在 DSH Web 工作区完成的，没有逐项重验 Desktop 流程。
独立 Web 实例使用 web 配置档；npm CLI 的 desktop 配置档专供 Electron 使用，不用于独立 Web 实例。

不配置适配器时，插件连接内置模拟器（假群聊，控制台里可以模拟群友发言），可以完整试用。接真实微信：

$DSH_HOME/profiles/web/cordis.patch.yml（Desktop使用desktop目录）
- id: wechat-bot
config:
adapter:
command: C:/path/to/python.exe
args: [-u, C:/path/to/dsh-wechat-bot/adapters/wechat-db/main.py, --account, wxid_example_abcd]

以上示例使用默认发件箱。需要启用真实文字发送时，在参数中增加 --sender-config <本机配置文件路径>；它与显式 --outbox 互斥，且只开放文字发送。按 native-runtime/README.md 安装发送依赖，将发送配置指向仓库内的 worker。账号目录、密钥缓存和控件门配置留在本地。适配器参数、显隐开关和故障处理见 adapters/wechat-db/README.md。

配置

| 键 | 默认 | 说明 |
| adapter.command / args / cwd / env | 空 = 模拟器 | 适配器进程 |
| exitWithPage | false | 专用 DSH Web 实例可开启：最后一个浏览器标签页关闭 5 秒后停止机器人（等正在发的那条发完）并退出 DSH；5 秒内刷新重连可取消。宿主没有 appExit 时不生效（插件照常加载） |
| model.provider / model | 空 = DSH 默认模型 | |
| model.reasoningEffort | off | 思考强度 off/low/high/max；/ask 临时用 high；运行中可用 /model /think 覆盖 |
| model.maxTokens | 600 | |
| aliases | [小鲸鱼, DeepSeek] | 除微信昵称外大家怎么叫它（用于"叫名字"判断） |
| behavior.mode | infer | free / infer / at / silent |
| behavior.quietMs / maxWaitMs | 3000 / 8000 | 合批：群里静默多久就算一批 / 从这批第一条消息起最多等多久（运行中可用 /wait 覆盖） |
| behavior.maxMessages | 20 | 一批最多几条；排队超过的更早消息转为上下文 |
| behavior.maxParts | 3 | 一次最多发几条 |
| behavior.memoryLearning | true | 由独立后台学习器写入记忆；关闭时使用主回复的记忆建议 |
| behavior.memoryCallsPerMinute | 2 | 后台学习独立限速，允许 1–2 次/分钟/群 |
| behavior.idleMinutes | 0 | 冷场多久后可以主动说话（仅 free 模式），0 = 不主动 |
| behavior.staleMinutes | 10 | 发不出去的回复多久后丢弃 |
| behavior.cronZone | +08:00 | /cron 默认时区 |
| guard.maxTurnsPerMinute | 8 | 每分钟最多几次模型调用 |
| guard.commandsPerMinute | 6 | 每人每分钟最多几条命令 |
| guard.modelTimeoutSeconds | 90 | 单次模型调用超时 |
| guard.maxTextChars | 2000 | 超长消息截断 |
| guard.breakerThreshold / breakerBaseSeconds | 3 / 30 | 连续几次失败熔断 / 首次暂停多久（之后翻倍，最长 10 分钟） |
| guard.stuckMinutes | 5 | 处理卡住多久由看门狗重建 |
| stickers | {} | 表情包名 → 图片路径，模型可输出 {"sticker":"名字"} |
| commandsDir | 空 | 自定义命令脚本目录 |
| persona | 大肥鱼 | 默认人设（人设库里的文件名，不含 .md）；/persona 可临时切换 |
| personasDir | 空 = <dataDir>/personas | 人设库目录；首次启动复制自带人设，已有文件不覆盖 |
| dataDir | ~/.dsh/wechat-bot | 状态目录 |

exitWithPage 作用于整个 DSH Web 页面，切换会话或收起机器人面板不会触发。默认关闭，避免影响共用实例。关停时不再接收新消息，正在发的那条发完、正在执行的命令做完后保存状态，适配器收到 shutdown 后退出（10 秒不退出就结束进程），然后 DSH 退出；即使停机出错也照常退出并记录错误。发送结果不确定的记录会保留，不自动重发。

工作原理

微信本地数据库 ── adapters/wechat-db（轮询、解析）── JSON-RPC over stdio ──┐ ▼ Bot（适配器自动重启 · 看门狗）── ChatRunner（所服务的群）消息 → 以 / 开头？ ─是→ 命令运行时：立即执行 → 回复走优先通道插队发出 │ ├ 改状态的命令：打断正在思考的旧回答，旧批次按新状态重算 │否 ├ /ask /tldr：先回"收到"，插队交给模型（不受限速） ▼ ├ /cron：写入本地定时库，到点按原文发送 │ └ /attack /comfort：脚本按 @/昵称定目标，模型写开场白定向互动中？ ─是→ 只留目标（按发送者 id）的消息；没有就跳过；一批只回一次 ▼ 合批（3s 静默 / 8s 上限 / 最多 20 条，溢出转上下文；/wait 可调）回复发出前：本批作者 3s 内又补了一句 → 带上补充重写一次 ▼ 对象判断 addressed + 依据 → 模式过滤（free / infer / at / silent） ▼ 限速 · 熔断 → 模型（硬超时；镜像到本次运行的「微信 · 群名」会话） ▼ {"to": 消息id, "reply": ["短句", …], "memory": [...]} 不合格→纠正一次；有人找它却沉默→提醒一次 ▼ 发送通道（按 canSend 等待；过时丢弃）；独立后台学习并行评估记忆 ▼ adapter.message/send ├ 默认：wechat-db 写一行内容 JSON 到发件箱 └ 配置 --sender-config：仓库内的隐藏桌面 worker 在选中的主窗/独立窗发送文字，以精确数据库回执确认

接话状态按成员分别保存最近回复；其他人插话不会覆盖原成员的接话机会。明确转为人与人 @/引用后，普通跟进不再被当作找机器人。模型输入里每个人都按 id 标注当前名字和别名，消息带原始 id、@ 对象和引用作者 id；消息里被 @、被引用或被叫到名字但没发言的成员单独列出（chat.mentioned），不会把整个群名册塞进每一轮。

后台记忆与回复并行合批，最多保留 20 条待评估消息、序列化输入不超过 18,000 字符；学习器只看这一批发言人的记忆，放不下时依次舍弃旧上下文、部分旧笔记和别名，当前证据正文不截断。笔记没展示全的人仍可新增主题，但不能改写或合并没给模型看全的已有主题。模型失败最多重试一次，停止、/reset、/forget 会取消在途学习。开启后台学习时，回复模型不再被要求输出记忆。日志分别显示记忆结果和排队、模型、发送耗时。

MEMORY.md 的固定标题、用户 ID 标记和两个分区标题须保留；在人工区自由补充交流要求（写成 ### 主题 的条目，模型不能覆盖同名主题），自动区由程序维护。下一次回复就会读取修改。文件格式被改坏时这个人被跳过、控制台记一次日志，改好后自动恢复，程序也不会覆盖它。回复模型每轮最多带 24k 字的文档，正在找机器人的人优先，并按最终回复 to 所属用户 ID 使用。

相似内容按语义归为一个稳定主题，在原条目中持续补充有效细节，单条正文最多 480 字。发现已有重复时，模型用 mergeTopics 指定同一用户的旧自动主题，程序校验来源和归属后一次写入合并结果并移除重复条目；人工区、其他主题与其他用户的文档保持不变。未知来源或合并后超过上限会拒绝，原文保留。写入按主题进行、每个文件排队串行，后台学习、/forget 和整理互不覆盖。语义判断由模型完成，程序不靠关键词硬编码归类。

单个用户达到 30 个自动主题或文件接近大小上限（3/4）时，后台自动整理；同一个人 30 分钟内最多自动整理一次。控制台"整理记忆"按钮整理当前群至少有 2 条记忆的人（最多 20 个，先大后小）。整理用当前模型最深的思考档（支持 max 就用 max），只合并重复、移除临时或已失效细节；它没提到的主题原样保留，整理期间新学到的主题也保留；合并后的正文不能比来源加起来更长（不让模型编新内容）。人工区不发给模型、也不会被改。整理过程在独立的"记忆整理 · 群名 · 思考档"原生 DSH 会话里展示，并在控制台按用户显示结果；不会向微信发送整理内容。

模型职责和固定输出要求分别放在 plugins/dsh-wechat-bot/lib/model-agents/reply/AGENTS.md 与 plugins/dsh-wechat-bot/lib/model-agents/memory/AGENTS.md，插件加载时读入，修改后重新加载插件生效。回复遵守当前人设，人设只影响正文口吻，文字和颜文字必须放入合法 JSON 的 reply 字符串；解析器保留颜文字与普通括号，只移除明确舞台动作。

旧聊天 JSON 中的 memory.members 在加载这个群时迁移到 Markdown（已有自动记忆的人不覆盖），随后聊天 JSON 只保留模式、等待设置、定时任务等控制状态，原始聊天、日志、成员名册不写盘。某个人迁移失败（例如他的文件被改坏）时旧数据保留、群照常监听，下次加载再试。微信适配器的读取游标及发送结果不确定记录仍保留。原生模型镜像使用独立的 live 会话 ID，不接续旧 JSONL。

测试

cd plugins/dsh-wechat-bot
node --test test/*.test.js # 独立检出需要 DSH Host 依赖；见下方本轮实测说明
STRESS_SCALE=3 node --test test/stress.test.js
cd ../../adapters/wechat-db && python -m pytest tests # 当前适配器 204 项
python -m pytest native-runtime/tests/python # 已迁入 worker 90 项

最近一次交付复核（2026-10-24）：Node 209 passed / 0 skipped（含数据库端到端；node_modules 以目录联接指向 DSH 自带依赖，WECHAT_DB_PYTHON 指向装好 requirements.txt 的 Python），STRESS_SCALE=3 压力测试 6 项通过，适配器 204 passed。迁入 worker 在复核用的临时环境里 87 passed / 3 failed，3 项都是缺 pywin32（win32file）的环境问题；协作者在装好 native-runtime/python/requirements.txt 的环境中为 90 passed。直接运行 Node 测试需先满足 peerDependencies（或像上面那样联接 DSH 依赖）。真实模型以合成用例验证自然记忆、两位作者的玩笑约定、爸爸/爷爷称呼归属和第三方转述保护；未发微信。称呼输出曾在复跑中波动，不把一次通过视为模型永远正确；无请求的记忆删除建议由程序拒绝。

| 测试文件 | 覆盖 |
| units protocol | 合批、对象判断、输出解析、记忆归属、协议与 stdio 传输、崩溃与进程回收 |
| bot | 合批到模型、纠正、插话/沉默、思考中新消息进下一批、多条回复、canSend 等待、发送失败语义、重启恢复 |
| commands | 四种模式各自放行哪些消息、命令插队、打断旧回答、/ask 越过限速、刷命令限流、/persona 切换与人设库初始化 |
| markdown-memory memory-maintenance store-memory | MEMORY.md 读写与隔离、人工区不动且同名主题受保护、合并与上限、坏文件跳过且不被覆盖、整理只换它覆盖的主题、旧记忆迁移 |
| page-lifetime adapter-shutdown | 最后一个页面关闭后停机再退出、刷新取消、停机出错仍退出；适配器关闭等发送完成、拒绝新发送、卡死的进程被结束 |
| models | 模型/思考强度切换的校验、持久化、/ask 降级、聊天里的 /model /think |
| engagement | 找人（@ 优先、精确、唯一模糊、重名/找不到/自己）、按人分组的模型输入、开场、只回目标、一批一回、目标沉默不发、替换与停止、禁言暂停、超时结束、重启保持、必须回复 |
| continuation | 续发重写（同一人一个静默期内补充 → 重写一次；别人、更晚、命令不触发；每条最多一次；多条回复发完；互动中只认目标）、/wait 设置/校验/持久化/恢复 |
| addressing-context conversation-quality | 按成员保存接话、人与人转向不算接话、引用按 id 找作者；后台记忆学习（不回复也能学、慢 learner 不拖回复、/forget 取消且不复活、独立限速、失败重试一次）、成员名册超时与缓存、耗时日志 |
| prompt-identity memory-learning | 每人按 id 标当前名字/别名、只列被提到的成员、引用作者、记忆规则随 learner 开关；记忆学习输入的体积上限与过滤、输出格式校验、不能凭第三方转述写/删别人的记忆 |
| client-sender-status | 控制台的独立窗口准备状态、重试与显隐开关（离线） |
| cron | 时间解析（相对、钟点、日期、每天、时区、DST）、非法输入、定时库限额与只取一次、到点发送、重启补发/错过、不执行命令、锁屏 |
| stress | 50 人刷屏、混乱模型、适配器崩溃风暴、发送故障+锁屏抖动、看门狗、长时间运行 |
| dsh | 用 DSH 真实会话服务验证「微信 · 群名」会话的流式、失败、取消、崩溃恢复 |
| wechat-db | 数据库新消息 → 适配器 → 插件 → 模型 → 默认发件箱 JSON |
| adapters/wechat-db/tests | 解析（分片、发送者映射、群昵称/改名/微信号映射到 wxid、zstd、@、引用、表情、图片、系统消息）、子进程协议、发件箱/同步发送幂等、默认/独立窗口 worker 桥接、读不到库时的恢复 |

许可

MIT。人设改编自 mtshang/make-your-qq-ai-group-member（MIT）。adapters/wechat-db/vendor/ 下的第三方代码保留原许可证。