fix(douyu): 拆分账号资格活动窗口与库存语义

This commit is contained in:
yml
2026-11-22 20:04:49 +08:00
parent d78437c6ac
commit 1906f924bc
26 changed files with 896 additions and 174 deletions
@@ -702,3 +702,4 @@ Runner 启动前必须有预算 token;没有 token 时留在工作队列。
| 2026-11-22 | 履约租约改为状态化策略:默认无限,预售/人工独立配置,完成或取消后才设置释放时间 |
| 2026-11-22 | 按生产并发、CK 流失和历史领取峰值提高全局供给目标,并安全升级旧默认组合 |
| 2026-11-22 | 抽取统一账号准入过滤;外部协作推荐改为纯本地能力池,兑换记录统一走本地同步投影 |
| 2026-11-22 | 商品能力拆分账号资格、活动窗口和官方库存三轴;自动选号只读账号资格,预售允许开放前分配 |
@@ -112,12 +112,12 @@ GET /wgapi/ordnc/activity/peace/storehome
| `commodityId` | 商品唯一标识 | `account_commodity_states.commodity_id` |
| `commodityName` | 商品名 | `commodity_name` |
| `score` | 兑换所需积分 | 商品目录和资源判断 |
| `status=1` | 当前账号已达该商品兑换上限 | `availability=limited`,自动选号硬排除 |
| `status=0` | 当前账号未达兑换上限 | 仍需继续判断库存、时间和开放状态 |
| `storeStatus=0` | 官方商城当前不可售 | `availability=no_stock` |
| `openStatus=0` | 活动尚未开放 | `availability=not_open` |
| `count<=0` | 当前库存不足 | `availability=no_stock` |
| `startTime/endTime` | 商品外层开放窗口 | 与本地时间比较,投影到 `available_from/available_until` |
| `status=1` | 当前账号已达该商品兑换上限 | `account_eligibility=limited`,自动选号硬排除 |
| `status=0` | 当前账号有兑换资格 | `account_eligibility=eligible`,不受库存和活动时间影响 |
| `storeStatus=0` | 官方商城展示状态关闭 | `stock_state=out_of_stock`,仅供执行提示,不参与自动选号 |
| `openStatus=0` | 活动当前未开放 | `offer_state=before`,预售仍允许提前分配和绑定 |
| `count<=0` | 官方全局库存不足 | `stock_state=out_of_stock`,仅供展示和兑换执行参考 |
| `startTime/endTime` | 商品开放窗口 | `offer_state=before/active/expired` 并投影到 `available_from/available_until` |
| `timeLimited` | 是否限时开放 | `time_limited` |
| `specTimes` | 一天多场或分段开放计划 | `schedule_json` |
| `eliteLimited=1` | 商品要求精英手册资格 | 单独保存为门槛,不能写成账号限兑 |
@@ -126,21 +126,38 @@ GET /wgapi/ordnc/activity/peace/storehome
| `limitRooms` | 可用直播间列表 | 按商品目录或原始快照保留 |
| `preExchange.isExists=1` | 当前账号已有预兑记录 | 表示预兑状态,不等于已兑换 |
`count` 是商品库存,不是该账号还能兑换几次。抓包中存在 `status=1` 且
`count` 仍为大量正数的情况,因此不能通过库存判断当前账号是否已限兑。
`count` 是商品全局库存,不是该账号还能兑换几次。抓包中既存在 `status=1`
且 `count` 仍为大量正数的情况,也存在 `status=0`、`count=0`、`storeStatus=0`
但账号仍有兑换资格的情况。因此库存绝不能参与账号限兑或自动选号判断。
## 分类优先级
## 三轴分类
`storehome` 单项归一成本地 `availability` 时必须保持以下顺序:
`storehome` 单项必须拆成三个互不覆盖的维度:
1. 时间窗口未开始:`not_open`;
2. 时间窗口已结束:`expired`;
3. `status=1`:`limited`;
4. `storeStatus=0`:`no_stock`;
5. `count<=0`:`no_stock`;
6. `openStatus=0`:`not_open`;
7. `status=0` 且以上条件均通过:`available`;
8. 缺少可判定字段:`unknown`。
1. 账号资格 `account_eligibility`:
- `status=1` → `limited`
- `status=0` → `eligible`
- 缺失 → `unknown`
2. 活动窗口 `offer_state`:
- 未开始或 `openStatus=0` → `before`
- 窗口内 → `active`
- 已结束 → `expired`
- 商品未返回 → `not_offered`
3. 全局库存 `stock_state`:
- `storeStatus=0` 或 `count<=0` → `out_of_stock`
- 有明确取值 → `in_stock`
- 缺失 → `unknown`
旧字段 `availability` 仍保留为“兑换执行状态”,由三轴派生,只用于界面提示和实际兑换前检查:
- 账号 `limited` → `limited`
- 活动未开始 → `not_open`
- 活动结束 → `expired`
- 活动进行中但全局库存不足 → `no_stock`
- 账号 `eligible`、活动进行中且有库存 → `available`
自动选号只允许读取 `account_eligibility=eligible`,不得读取 `stock_state`。
预售单允许 `offer_state=before` 的账号提前分配。
`eliteLimited`、`roomLimited`、`limitRoomType` 和 `preExchange` 是附加门槛或状态,
不能在分类阶段无条件覆盖成 `limited`。
@@ -314,10 +331,9 @@ raw
- `manual_id`
- `rid`
- `item_count`
- `limited_count`
- `available_count`
- `not_open_count`
- `no_stock_count`
- `eligible_count` / `limited_count`
- `offer_before_count` / `offer_active_count`
- `stock_in_count` / `stock_out_count`
- `observed_at`
- `source`
- `duration_ms`
@@ -333,9 +349,10 @@ raw
2. 同时需要 eligibility 和 goods 时仍只请求一次;
3. `status=1` 准确归为 `limited`;
4. `status=0 + count>0 + 时间有效 + 开放有效` 归为 `available`;
5. `storeStatus=0` 和 `count<=0` 归为 `no_stock`;
5. `storeStatus=0` 和 `count<=0` 只写入 `stock_state`,不参与自动选号;
6. 时间未到和已结束分别归为 `not_open/expired`;
7. `eliteLimited` 不会被误写成账号限兑;
8. 预售选号允许 `offer_state=before`,直接兑换单仍按活动窗口控制;
8. 完整快照成功后一次批量更新全部商品;
9. 商品状态未变化时不产生无意义逐行更新;
10. `storedetail` 和 `batchExchangeLimit` 不会出现在全量资格扫描调用链中。
@@ -103,10 +103,12 @@ CK 生命周期、账号库存目标、覆盖率、查询同步契约和防重
### 账号商品能力
`account_commodity_states` 回答“这个账号对这个商品的官网结论是什么”:
`account_commodity_states` 回答“这个账号对这个商品的官网结论是什么”,必须拆分三轴:
- `availability`:`available / limited / no_stock / not_open / expired /
not_offered / unknown`;
- `account_eligibility`:`eligible / limited / unknown`,只由账号级 `status` 决定;
- `offer_state`:`before / active / expired / not_offered / unknown`;
- `stock_state`:`in_stock / out_of_stock / unknown`,仅作展示和执行参考;
- `availability`:由前三个维度派生的兑换执行状态,不能作为自动选号资格;
- `raw_status`:官网原始账号级状态;
- `raw_json`:该商品最近一次官方原始字段;
- `observed_at`:最近一次观察时间;
@@ -152,12 +154,14 @@ CK 生命周期、账号库存目标、覆盖率、查询同步契约和防重
### 官网可兑换
`official_available` 只由斗鱼官网判断:
`official_available` 必须拆开判断:
- 官方账号级 `status=0`;
- 商品开放窗口有效;
- 官方库存和开放状态允许兑换;
- 没有明确限兑、无库存、未开放或已结束。
- 账号资格只看官方账号级 `status=0`;
- 活动窗口单独记录为 `before / active / expired`;
- 全局库存单独记录为 `in_stock / out_of_stock`;
- 自动选号不读取库存;
- 预售允许账号资格通过后在 `before` 阶段提前分配;
- 实际兑换执行时,库存和开放状态才可能成为失败原因。
### 资源已就绪
@@ -241,16 +245,17 @@ AND 不违反内部兑换冷却
排序建议:
1. 新鲜 `available`;
2. 过期但曾经 `available`,允许官网复核;
3. 从未查询或 `unknown`;
4. 已知 `limited / no_stock / not_open / expired` 默认不进入候选。
1. 新鲜 `account_eligibility=eligible` 且 `offer_state=active`;
2. 预售单允许 `account_eligibility=eligible` 且 `offer_state=before`;
3. 过期资格允许进入后台刷新队列,但不能直接分配;
4. `account_eligibility=limited/unknown` 不进入候选;
5. `stock_state` 不参与排序或淘汰。
候选结果必须同时返回阻塞诊断,例如:
- 官网限兑;
- 无库存;
- 未开放;
- 活动未开放(预售不阻塞分配);
- 官方库存不足(仅执行提示,不阻塞分配);
- CK 失效;
- 角色换绑冷却;
- 有效租约;
@@ -180,7 +180,7 @@ ck_observed_lifetime_seconds 不变
有效库存 =
CK valid 且未超过新鲜阈值
AND 商品状态新鲜
AND 官网 status=0 且库存/时间/开放状态允许
AND 官网账号兑换资格 status=0
AND 无有效租约
AND 无活动外部协作单
AND 角色换绑冷却已结束
@@ -192,7 +192,9 @@ ck_observed_lifetime_seconds 不变
- `resource_ready`:积分足够且宝典已开通;
- `needs_recharge`:官网可兑换,但积分不足;
- `needs_open`:官网可兑换,但宝典未开通;
- `blocked`:官网限兑、无库存、未开放或冷却。
- `blocked`:账号官网限兑、资格未知或内部冷却;
- 官方全局库存、活动未开放属于执行提示,不阻断账号作为可分配供给;
- 预售可把 `offer_state=before` 且有资格的账号计入供给。
## 库存预警与补货
+3 -3
View File
@@ -70,15 +70,15 @@
- 一键查询或资料刷新把官方 `storehome` 商品状态写入 `account_commodity_states`;
- `storehome` 一次返回账号可见的全部商品,逐商品写状态,但每个账号只需一次列表请求;
- 同时保存 `timeLimited`、`specTimes` 和起止时间,未开始/已结束与账号限兑分别处理;
- 可兑换、未开放等稳定能力默认缓存 6 小时,库存 15 分钟,未知状态 5 分钟;
- 账号兑换资格和活动窗口默认缓存 6 小时,库存仅作展示并默认缓存 15 分钟;
否则 3 万账号池不可能在 15 分钟内刷新一遍,能力索引会长期处于过期状态;
- 有 pending 履约需求时,`account_capability_refresh` 作业优先刷新对应商品的过期能力;
- 能力刷新和外部请求由 `account_sync_queue` 独立执行槽消费,不占用选号 worker;
- 本地能力池缺失时,选号失败只向该独立队列补入最多 20 个账号,
可用 `PLATFORM_FULFILLMENT_CACHE_REFRESH_SEED_COUNT` 调整;
- 自动选号按 `next_allocate_at` 轮转,而不是永久按订单时间排在最前;
- “未开放”任务直接排到商品开放时间,“无库存”至少退避 5 分钟,
“能力快照缺失”退避 2 分钟,避免失败任务每 45 秒占满执行槽;
- 预售任务允许在活动开放前分配;直接兑换单的“未开放”任务排到商品开放时间;
“账号资格快照缺失”退避 2 分钟。官方全局库存不阻止自动选号;
- 单轮默认处理 20 个本地任务,可用 `PLATFORM_FULFILLMENT_AUTO_ALLOCATE_BATCH` 调整。
能力 TTL 可分别用 `ACCOUNT_COMMODITY_STABLE_TTL_SECONDS`、