ZL-抽老婆插件 2.0 — 技术架构与开发计划
1. 工程结构(重构后)
依赖: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)
成功: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 播报 出轨预警 周播报均可关,防止刷屏。