PROJECT FILE · 2026.06.18 · LIVE

微信群聊娱乐
机器人 SaaS 商用项目

一份单日 8 轮深度决策 + 1 日实施全程档案。从零起步、卡密激活、代理体系、防封壁垒—— 在合规边界内逼近行业天花板。AI Agent 全栈实施。
0
轮决策
深度多轮迭代
0
个 TASK
8 已完成
0
张表 SCHEMA
方案 C 折中归一
0
功能开关
参考 7xzs 商用基线
0
节点 API
7 模块 mixin
0
长期记忆
跨会话保留
▼ SCROLL TO EXPLORE
DECISION LOG

8 轮决策迭代时间线

每一轮深度沟通、每一次方向调整、每一个被驳回的方案都在这里。从最初"Wechaty + PadLocal"的初稿，到最终"中央 + 节点 + Python wcferry"的定稿。

01
ROUND 01 技术选型 商业模式
起点：个微协议 / SaaS / 单人
"我要开发一套微信群聊娱乐机器人落地商用"
初步选型：Wechaty + PadLocal Puppet（Python）。多租户 SaaS 架构，群主/企业付费，4 类娱乐功能（AI 聊天/群游戏/图片梗图/签到积分）。
WechatyPadLocalPython 3.11FastAPIPostgreSQL
02
ROUND 02 开源底座 方向调整
XYBot V1 vs V2 评估 → 推翻 PadLocal
"两套方案需要你看看然后再定后续开发方向（XYBot V1/V2）"
深度调研后发现：V2 用闭源 binary 已停更，V1 README 自荐去 V2，但 V2 已 archived。**真正的稳定底座是 wcferry**（lich0821）。决定不直接 fork 任何 V1/V2，改以 wcferry 为协议层 + 借鉴 V2 架构 + 自建 SaaS 多租户。**淘汰 Wechaty + PadLocal**（¥80/号/月成本）。
wcferry 主线GPL-3.0 商用解读Windows 协议机
03
ROUND 03 指令体系 商用参考
阿星指令清单 · 5 级权限 · 4+1 货币
"axing.junvip.cn 的指令单页（仅作设计参考）"
抽取 5 大设计参考：① 5 级权限（群员/普管/超管/至尊/钻石付费）；② 指令命名约定（数字短指令+中文动词+#参数分隔）；③ 5 大模块切分（资产/社交/养成/游戏/运营）；④ 4+1 货币体系（金币/积分/魅力/身价 + 钻石付费货币）；⑤ 钻石内购触点设计（情感墙而非功能墙）。
5 级权限4+1 货币复活宝宝炫富抢富豪
04
ROUND 04 逆向参考 71 字段配置
7xzs 商用后台逆向 · 真实在售产品
"我把整个群空间的源码下载到了本地 D:\WeChatbot\qun"
抓出 26 个 HTML + 完整 JS/CSS。识别：① 后端 PHP 老派架构（不抄技术）；② **71 个功能开关字段**（直接抄拼音命名 qiandao/jiehun/caichengyu）；③ 6 个后端接口路径；④ 群级短链鉴权（timestamp+sign+robotid+qid）；⑤ 11 个独立统计页（金币榜/婚姻图谱/宝宝家谱）；⑥ 一群一空间设计范式（手机扫码即用，无需登录）。
短链鉴权范式WeUI 移动端71 字段11 统计页
05
ROUND 05 合规边界 哆来咪分析
哆来咪混合架构 · 学思想不学实现
"D:\WeChatbot\哆来咪机器人逻辑架构.txt 综合分析一下"
哆来咪 = WCF 内核 + 云端 iPad 协议代登 + MinHook 特征抹除。**纯技术上明显更优**（封号率/上手成本/版本适配），但**触刑事红线**（杭州/深圳/上海已有 3-7 年判刑案例）。决议：抄思想不抄实现——登录与运行环境隔离、本地零轮询、行为限频、号池主备。**不做 iPad 代登 / 内存伪造 / Hook 抹除**。
登录运行解耦登录辅助 VM不做云代登
06
ROUND 06 架构终态 客户已就绪
中央 + 节点架构 · 跳过 Phase 0
"商业验证不需要，我手里大批客户需要这款"
客户挂机 = 服务器挂机（多种混合：客户自购云/我们代采/集中部署）。号需求从单号到几十号都有。架构最终敲定为"中央 + 节点"：中央承担全部业务+数据（Linux Docker），节点是无状态薄客户端（Windows + wcferry），WebSocket 通信。客户已收定金 → 跳过 Phase 0 商业验证 → 直接客户分级签约。
中央+节点WebSocket数据集中节点可替换
07
ROUND 07 深度优化 AI Agent 杠杆
6 项劣势优化 · 多协议策略 · 法律打底
"6 项劣势能否优化逼近？云代登能否用协议规避？"
结论：3 项打平/反超 + 2 项缩小一半 + 1 项已优。① 用户协议无法规避刑事认定（看程序客观功能）；② 用 AI Agent 把业务层 70% 工作量压缩到 1/3；③ 多协议策略：wcferry 主 + wxauto 备（"安全版"）；④ 客户定金必须签正式合同 + 律师审核（¥500-2000）+ 定金分批使用（≥30% 留退款准备金）。
AI Agent 全栈wcferry 主wxauto 备合同打底
08
ROUND 08 产品锁定 Plan 批准
卡密 · 代理 · 号分级 · 数据继承
"机器人激活通过卡密 / 自营+代理分销 / 单号体感 / 主备双封极端情况"
① 卡密激活（"开通#KEY-XXXX"取代订阅扣费，cross-border 友好）；② 自营+自动代理升级（购买达阈值升级代理商，1-2 级分销）；③ 号分级方案 A（主门面号 + 工具号内部路由 + 授权码绑定，用户体感单号）；④ 群数据继承双层方案（主备自动切换 + 双封时群内"继承数据#KEY"密钥指令）；⑤ wcferry 不能完全替代 wxauto——保留多协议策略；⑥ 企微暂不做（外部群限制）。用户 ExitPlanMode 通过，进入实施。
卡密激活自动代理升级主门面号密钥继承PLAN APPROVED
VS · COMPETITIVE

哆来咪 vs 我们方案

纯技术维度哆来咪明显更优——但商业、合规、单人产能维度，我们方案更优秀。真正的差距是"是否承担刑事风险换取技术天花板"。

维度
哆来咪云端代登
我们中央+节点
胜方
降低封号率
极强 · 月级生命周期
3-6 周（叠加优化后）
哆来咪
用户上手成本
点开出码
一键安装包 · 打平
打平
技术开发成本
极高 · 3-5 人 × 1-2 年
低 · AI Agent 全栈
我们
法律合规
触刑事红线
民事/灰色边界
我们
可对外公开销售
不能
可以
我们
SaaS 适配性
需额外做
天生 SaaS 原生
我们
单号生命周期
60+ 天
21-45 天（合规天花板）
哆来咪
ARCHITECTURE

最终部署架构

中央承担全部业务+数据，节点是无状态薄客户端。三种部署形态（客户自购云 / 我们代采 / 集中部署），同一套节点程序。

CENTRAL
🌐
FASTAPI
业务 API · WebSocket Hub
DATA
🗄️
POSTGRESQL 15
42 张表 · RLS 多租户
CACHE
⚡
REDIS 7
会话 · 限频令牌桶
QUEUE
⚙️
CELERY 5
AI 调用 · 图片生成
⇅ WSS
NODE A
🖥️
客户自购云
Win + wcferry · 1-3 号
NODE B
🖥️
我们代采
Win + wcferry · 5-20 号
NODE C
🖥️
集中部署
Win VM × N · 50+ 号
⇣ 7-MODULE CLIENT
📦
CLIENT (Mixin)
login/message/user/chatroom/friend/tool
🛡️
PROTECT 单例
4 小时新设备风控
⏱️
QUEUE 节流
_queue_message · 1 秒
⇣ MINHOOK · TCP 10086
💬
PC 微信 3.9.12.17
锁定版本 · 禁更新
NODE API · ADR-006 · NEW

节点 7 模块API 设计

参考 XYBotV2 WechatAPIClient（aiohttp + Mixin 组合），抽取微信机器人能力的"自然领域模型"。method signature 抄 80%，底层换成 wcferry 调用——AI Agent 跨文件理解成本最低，方法签名标准化。

base
2
基类 + 9 种异常处理（UserLoggedOut / BanProtection 等）
login
12
扫码、心跳、登出、设备 ID/名称、自动心跳
message
13
发文本/图/语音/视频/链接/卡片/CDN + 1 秒节流队列 ⭐
user
3
个人信息、二维码
chatroom
6
群信息/成员/公告/二维码/拉人/邀请
friend
5
联系人/详情/昵称/加好友
tool
10+
silk/wav/amr 互转 · 文件下载 · 代理设置
protect
3
单例 · 4 小时新设备风控保护 ⭐
01
⏱️ 1 秒节流队列
所有发消息走内部 _queue_message 队列，强制 await sleep(1)。wcferry 默认无节流，直接发爆 = 立刻封号。MVP 必做。
02
🛡️ Protect 风控单例
新设备登录后 14400 秒（4 小时）窗口内拦截发消息/改步数等敏感操作。ignore_protect=True 可绕过（仅测试用）。MVP 必做。
03
📨 三元组返回
所有发消息方法返回 tuple[client_msg_id, create_time, new_msg_id]。撤回、引用、关系追踪都要这三个值。一次性给齐零额外查询。
# API 签名示例：抄签名不抄实现，底层换成 wcferry 调用 async def send_text_message( self, wxid: str, content: str, at: list | str = '' ) -> tuple[int, int, int]: # 1. Protect 检查（4 小时窗口） if not Protect().check(14400) and not self.ignore_protect: raise BanProtection("4h window") # 2. 走 1 秒节流队列 result = await self._queue_message(self._send_text, wxid, content, at) # 3. 返回三元组 return result.client_msg_id, result.create_time, result.new_msg_id
TECH STACK

精确版本技术栈

所有依赖精确锁定。客户禁止自行升级 PC 微信。wcferry 升级前必须在 staging 节点跑 7 天烟雾测试。

PROTOCOL · 协议层
wcferry
pip install wcferry
lich0821 官方 Python 客户端，与中央同语言。底层 sdk.dll 自动注入 PC 微信，本地 TCP 10086 + protobuf 通信。
CLIENT · 微信版本
PC 微信
3.9.12.17
wcferry 当前唯一兼容版本，强锁定。下载源：tom-snow/wechat-windows-versions。注册表禁用自动更新。
RUNTIME · 运行时
Python
3.11.x
异步生态成熟，AI 库最丰富。中央和节点统一语言，AI Agent 跨语言切换为零。
WEB · API 框架
FastAPI
latest stable
业务 API + WebSocket Hub。自动文档生成。Pydantic v2 校验对 AI Agent 友好。
DATABASE · 主存储
PostgreSQL
15.x
42 张业务表（方案 C）。Row-Level Security 强隔离 tenant_id。SQLAlchemy 2.0 异步 ORM。
CACHE · 缓存层
Redis
7.x
会话 + 限频令牌桶 + 游戏状态机短期数据 + AI 上下文。Celery broker。
QUEUE · 异步任务
Celery
5.x
AI 调用、图片生成、定时签到、异步通知。与 Redis broker 集成。
LLM · AI 主模型
DeepSeek
API · 性价比最高
主用 DeepSeek 控成本（¥0.001/千 token），高级套餐切 OpenAI 兼容接口。
FRONTEND · 群主端
WeUI + jQuery
参考 7xzs 范式
手机扫码即用。短链鉴权（timestamp+sign+qid+robotid），群主无需登录。
FRONTEND · 超管端
React + AntD Pro
现代化 PC 后台
租户管理 / 节点池 / 卡密 / 代理 / 计费 / 风控。AI Agent 友好生态。
DEPLOY · 部署
Docker Compose
v2
本地开发与生产环境一致。PostgreSQL+Redis+FastAPI+Celery 一键启停。
DEV TOOLS · AI Agent
Claude Code · Codex · Trae
multi-agent stack
不绑定单一工具，按场景组合。业务层 AI 写 80%，架构由人拍板。
DATA MODEL · ADR-001

42 张表Schema 蓝图

方案 C 折中归一：货币归一、关系归一、风控独表、配置 KV、日志合一。AI Agent 上下文友好，新增功能开关零停机迁移。

42
总表数
6
ADR 决策
11
业务领域
RLS
硬隔离
🏢 租户与账号
tenants users agents commissions
🤖 节点与机器人
bot_nodes groups group_members
💰 货币与签到
wallets signins
💕 社交关系
relationships
👶 养成系统
babies nobles
🎮 游戏与抽奖
game_sessions lottery_pool lottery_records mystery_boxes
🎫 卡密与订单
kami kami_usage orders subscriptions
⚙️ 群级配置
group_features welcome_messages permanent_blacklist keyword_responses
🛡️ 风控与限频
bot_health bot_status_history bot_fatigue rate_limit_events risk_events
📊 日志与统计
member_event_log usage_records usage_aggregate
🔐 鉴权
share_links
CORE BARRIER · 防封壁垒

8 项行为限频核心技术壁垒

封号率是微信机器人 SaaS 的唯一商业生命线。Phase 2 MVP 必须实现，不可拖延。预期单号生命周期 21-45 天（合规方案天花板）。

每号每日发送总量
≤ 800 条 / 天
超量自动停止响应到次日 0 点。是经验值，业内基础线。
每号每分钟发送
≤ 60 条（目标 ≤ 30）
令牌桶限流，超过队列等待。绝对上限 60，目标值更保守。
每群每分钟发送
≤ 6 条 / 群
群级独立限流。即使全局还有额度，单群也不能刷屏。
@回复延迟抖动
1.5 - 4 秒 random
不能秒回——秒回是机器人特征。随机抖动模拟真人思考。
指令响应延迟
0.8 - 2.5 秒 random
即使逻辑很快也要假装"在思考"。命令越复杂延迟越长。
连续@同人
≤ 3 次 / 分钟
防止刷屏式@。1 分钟内同一目标超过 3 次自动丢弃后续。
同群消息间隔
≥ 8 秒
N 条指令瞬时秒级推送 = 必封信号。强制最小间隔。
凌晨静默时段
02:00 - 06:00
凌晨不主动发消息（被动响应除外）。模拟正常人作息。
IMPLEMENTATION · LIVE

实施进度面板

Plan 已批准，进入实施阶段。第一日完成 8/10 task，包含开发日志机制、长期记忆基础设施、Schema 设计、技术栈调研、ADR 文档化、项目档案网站、WechatAPIClient 调研。

LATEST DELTA · 2026.06.18 EVENING
用户主动提供 XYBotV2 WechatAPIClient 文档 → 调研后决定节点 wcferry 封装层完全对齐其 7 模块切分（base/login/message/user/chatroom/friend/tool/protect）。新增 ADR-006、Task #10。
TASK #5
建立开发日志机制
D:\WeChatbot\dev_log\ 按日期分文件 + README 模板，防上下文压缩丢失
COMPLETED
TASK #2
长期记忆基础设施
6 份 memory 文件：user_profile / project_overview / project_decisions / tech_stack / schema_decisions / open_questions
COMPLETED
TASK #1
数据库 Schema 设计
Plan 子代理输出 A/B/C 三方案对比，用户选定方案 C（~42 张表，折中归一）
COMPLETED
TASK #6
写入 Schema ADR
6 条 ADR 记录：方案 C 选型、多租户隔离、业务数据集中、群级主键、ORM 选型、节点 API 设计
COMPLETED
TASK #3
wcferry 跑通脚本调研
澄清 wechatferry/wechatferry vs lich0821/WeChatFerry 关系，最终选 Python wcferry
COMPLETED
TASK #7
更新技术栈记忆
填充精确版本号：Python 3.11 + PC 微信 3.9.12.17 + PostgreSQL 15 + Redis 7
COMPLETED
TASK #8
设计网站结构和视觉
本网站设计阶段 · 已完成（暗色科技感 + 三色霓虹 + 网格背景 + 粒子动画）
COMPLETED
TASK #9
实现单文件 HTML
D:\WeChatbot\timeline\index.html · 零外部依赖 · 可部署 GitHub Pages · 含今日所有增量
COMPLETED
TASK #4
初始化项目骨架
D:\WeChatbot\ 项目结构 + Docker Compose + 本地 Git + apps/central + apps/node（按 7 模块切分）
NEXT UP
TASK #10
实现节点 7 模块封装
按 WechatAPIClient 抄 7 模块（base/login/message/user/chatroom/friend/tool/protect）+ 1 秒节流 + Protect 4 小时
BLOCKED BY #4
PERSISTENT MEMORY · NEW

长期记忆基础设施

6 份 memory 文件跨会话保留，AI Agent 重启后能快速恢复完整上下文。每份文件用 frontmatter 描述类型与作用，MEMORY.md 作为索引。

👤
user_profile.md
用户画像：AI Agent 全栈开发、商用 SaaS 目标、已收客户定金、决策风格
📌
project_overview.md
项目概览：中央+节点架构、三种部署形态、合规边界硬约束
📋
project_decisions.md
8 轮讨论后最终决策：wcferry 主线、卡密激活、代理体系、防封壁垒
🔧
tech_stack.md
精确版本号锁定：Python 3.11 + PC 微信 3.9.12.17 + PG 15 + Redis 7
🗄️
schema_decisions.md
6 条 ADR：方案 C / RLS 隔离 / 数据集中 / 群级主键 / ORM / 节点 API
❓
open_questions.md
5 个待用户决策点：定金详情、号类型、卡密面额、AI 计费维度、密码设置权
LEGAL · 合规边界

做与不做的硬边界

合规边界是项目能否长期运营的命脉。每一项"不做"都是基于 2023-2025 真实判决案例（杭州/深圳/上海，3-7 年实刑）。

✓ 我们做的事
  • 行为限频引擎（8 项规则 Phase 2 必做）
  • 主备号自动切换（30s 内）
  • 号疲劳度算法 + 分级使用策略
  • 群数据继承双层方案（主备切换 + 密钥指令）
  • 正式合同 + 律师审核 + 定金分批
  • 客户工作号教育 + 干净环境维护
  • 登录与运行环境物理隔离（VM 级）
  • 多协议产品策略（标准版 wcferry / 安全版 wxauto）
✗ 我们不做的事
  • iPad 协议代登 / 内存伪造登录态
  • 反 Hook 检测对抗 / MinHook 特征抹除
  • 云端代登中台 Serverless（哆来咪式）
  • 自动批量加好友 / 自动建群 / 自动群发
  • 帮客户做"群控"（一台机控多号同步）
  • 替客户做营销/拉群（客户自做不参与）
  • 微信版本由客户自行升级（必须我们锁定）
  • 企业微信路线（外部群限制 · 暂不做）