ZL-抽老婆插件 2.0 — 技术架构与开发计划

1. 工程结构(重构后)

ZL-抽老婆插件/
├── ZLPartnerPickerPlugin.cs        # 入口:初始化、群消息注册、周播报定时器
├── Core/
│   ├── WifeConfig.cs               # v2 配置(全局+分群覆盖,见 02 文档)
│   ├── WifeModels.cs               # v2 数据模型(BondRecord/PendingAction...)
│   ├── WifeStore.cs                # 写锁 + 原子写 + 每日快照 + v1→v2 迁移
│   ├── WifeRouter.cs               # 指令归一化与分发(保留现有骨架)
│   ├── WifeImageRenderer.cs        # System.Drawing,4 套模板统一升级
│   └── Features/
│       ├── DrawFeature.cs          # 抽卡/换老婆/挑选 + 品质 roll + SSR 播报
│       ├── AffectionFeature.cs     # 撩/约会/送花 + 怠惰惩罚 + 个人情缘卡数据
│       ├── RaidFeature.cs          # 抢夺/夺回 + 成功率计算 + 保护判定
│       ├── MarriageFeature.cs      # 求婚/同意/拒绝/分手/红娘 + 证书图触发
│       └── RankFeature.cs          # 三榜数据聚合 + 周盘点生成
├── Forms/
│   └── WebSettingsForm.cs          # WebView2 宿主(照搬售卡架构)
└── Web/
    ├── index.html / style.css / app.js

依赖:UniQQ.SDK、System.Drawing。无新增 NuGet 包。

2. 模块职责边界

  • WifeRouter:只做归一化、鉴权(群开关/白黑名单/权限)、分发;不含玩法逻辑。

  • Feature 之间不互相调用,共享数据只通过 WifeStore(内部持锁),需要跨模块的事件(如抢夺影响好感)由 WifeStore 返回操作结果、Router 层组合回复。

  • 回复文案集中在各 Feature 内的常量 + Templates 模板合并,Router 不写死文案。

3. 关键流程

3.1 抽卡(DrawFeature)

活跃池构建(沿用旧逻辑)→ 随机目标 → roll 品质 → 建 BondRecord(初始好感 = 基础100 + 品质加成)→ 渲染抽卡卡 → SSR 则追加全群播报。

3.2 抢夺成功率(RaidFeature)

rate = RaidBaseRate
     - (targetAffection / 100) * RaidAffectionStep
     - QualityDefense(quality)      // R=10 SR=15 SSR=25
rate = clamp(rate, RaidMinRate, 100)

成功:Bond 转移(OwnerId 换人,好感减半,品质不变,Source=raid,重置保护期);失败:写冷却 + 社死播报。

3.3 周播报(ZLPartnerPickerPlugin)

System.Threading.Timer 每分钟 tick → 对比分群配置中的 (DayOfWeek, HH:mm) → 到点且当日未播过 → RankFeature 生成盘点图与文本 → 逐群发送 → 记录 weekly:lastRun=yyyy-MM-dd 防重复。

3.4 怠惰检查

消息处理时惰性触发(不做全天定时扫描):进入某群处理时,检查该群 Bonds 的 LastInteractAt,跨过怠惰阈值则扣减并播报(每对关系每日至多播报一次,当天 date-key 记录防重)。

4. 图片模板(WifeImageRenderer)

模板尺寸基准要点
抽卡结果卡沿用现有尺寸品质角标(N灰/R蓝/SR紫/SSR金)、SSR 金色渐变边框、好感进度条
个人情缘卡沿用档位称谓、好感条、状态徽章(恋爱/已婚/冷静期)、称号列表、今日互动余量
排行榜图竖版列表名次徽章(金银铜)、头像、数值;三榜共用模板换表头
结婚证书图横版证书双头像、双方昵称、群名、日期、装饰边框

头像缓存沿用现有 CacheAvatarsAsync 机制。

6. 风险与注意

  • System.Drawing 平台限制:沿用现状依赖(现有版本已如此),不引入新渲染库;如需 Linux 支持另行立项。

  • JSON 并发:全部写入必须经 WifeStore 统一出口,禁止 Feature 直接改共享对象后绕过 Save。

  • 迁移安全:迁移前必须有 wife_state_v1_backup.json;迁移逻辑需覆盖"空记录/损坏 JSON"分支(损坏时保留原文件并以空 v2 启动)。

  • 播报频率:SSR 播报 出轨预警 周播报均可关,防止刷屏。

共 18 篇 ZL-抽老婆插件 / 技术架构 0 字 0 行 zhangxiaolin
创建 2026-09-26T17:38:01.312242577Z 更新 2026-09-26T17:39:17.607387557Z