diff --git a/AGENTS.md b/AGENTS.md index 69befe2..ce37cca 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -34,3 +34,6 @@ Do not launch browsers or browser automation for UI validation unless explicitly ## Proxy Documentation `docs/代理池与白名单.md` is the source of truth for proxy extraction, whitelist handling, account grouping, standby proxies, runtime failover, and proxy scheduling. Any change to `internal/proxy/`, `internal/seckill/proxy_groups.go`, proxy timing/settings, or proxy logs/statistics must update that document in the same change. + +## Seckill Drill Documentation +`docs/抢购预演.md` is the source of truth for the read-only seckill rehearsal. Any change to rehearsal timing, account requests, proxy preparation, cancellation, or homepage drill status must update that document in the same change. diff --git a/README.MD b/README.MD index bffade8..785f2d8 100644 --- a/README.MD +++ b/README.MD @@ -72,6 +72,8 @@ GOOS=linux GOARCH=amd64 wails build 代理默认启用严格模式:定时任务提前 2 分钟准备,代理未就绪时不启动且不回退直连;品赞提取强制 JSON,同机多实例共享白名单协调锁,主界面直接显示 `G1`、`G2` 或“直连”。 +主界面“抢购预演”按正式时序执行:`T-120s` 准备真实账号和代理,`T-2s` 预热,`T0` 执行只读账号请求;不会预兑换、锁单、支付或消耗积分。详细说明见 [docs/抢购预演.md](docs/抢购预演.md)。 + 构建并启动控制中心: ```bash diff --git a/docs/代理池与白名单.md b/docs/代理池与白名单.md index 088b0ac..b7be6b4 100644 --- a/docs/代理池与白名单.md +++ b/docs/代理池与白名单.md @@ -204,6 +204,22 @@ `whiteList-verify` 返回的业务错误也会保留原始消息并执行同样的致命/可重试分类,不再把所有非零 `code` 都判定为致命错误。 +### 准备阶段业务风控探测 + +代理池校验完成后、标记为就绪前,会对每个活动组执行只读 `batchExchangeLimit`。组内第一个账号无法取得明确业务响应时,会继续尝试同组其他账号: + +- Cookie 已有 CSRF 时直接复用。 +- `1644400007` 来自斗鱼接口响应 JSON 的 `error` 字段,不是本地生成;日志现在会显示 `error=1644400007`。 +- 错误码是 `1644400007`、错误文案包含“活动火爆”或纯文本中出现该数字状态码时,都视为当前代理出口被风控。 +- 同一出口 IP 的代理组一起切换。 +- 备用代理优先选择不同公网 IP;只有相同 IP 的备用时不直接使用。 +- 切换后必须重新检查全部活动组,不能只检查被替换的单组。 +- 新代理仍返回活动火爆时继续切换;备用耗尽时同步调用提取 API 获取新代理,再重新检查。 +- 补提取数量按“替换失败组所需数量 + 备用目标缺口”计算,避免替换完成后没有剩余备用。 +- 任一活动组在截止时间前没有拿到明确业务响应,严格模式保持未就绪并阻止启动。 +- `1644400011 您点击太快` 和商品售罄不等于代理风控。 +- 电竞手册和和平小店没有可用的批量限制接口,启动前只做各自只读业务连通性校验。 + ## 8. 账号分组 账号按名称排序后顺序分组,保证相同账号集合尽量得到稳定分组。 @@ -362,10 +378,15 @@ T-0s 本地定时触发 8. 运行期间每 20 秒探测一次备用代理,连续 2 次失败后移出备用池并补提取。 9. 严格模式失败组等待备用期间,该组账号暂停发请求,不继续消耗故障代理和抢购次数。 10. 补提取失败后按 2 秒节奏继续重试,直到任务停止、代理恢复或代理池失效。 +11. 锁定、支付、兑换、CSRF 或批量限制接口返回 `1644400007` / “活动火爆”时,不等第二次错误,立即按出口 IP 切换代理组。 +12. `1644400011 您点击太快` 仍然只触发账号级降频,不切换代理。 +13. 直连模式出现活动火爆不会触发代理切换。 非严格模式已经主动切换到直连的组,不会在运行中自动切回代理;严格模式保留失败组状态,因此可以在新备用到达后重新绑定。 -运行前门禁会检查代理池是否过期、是否被配置更新、是否存在失败组,以及是否覆盖本次选择的全部账号。备用数量不足不会导致已覆盖账号的活动代理被重建。 +运行前门禁会检查代理池是否过期、是否被配置更新、是否存在失败组、是否完成逐组业务风控预检,以及是否覆盖本次选择的全部账号。代理切换会清除预检状态,必须重新通过后才能启动。备用数量不足不会导致已覆盖账号的活动代理被重建。 + +业务错误必须保留斗鱼错误码。代理风控识别明确的 `1644400007` 或“活动火爆”文案;不能仅凭“繁忙”“稍后再试”等宽泛文案切换,避免把普通频控误判为代理故障。 ## 13. 代理有效期 @@ -389,9 +410,16 @@ T-0s 本地定时触发 - 不支付 - 不消耗积分 - 抢购运行中禁止执行 +- 最多持续 2 分钟,避免提取接口限频时无限等待 演练可模拟账号数,计算活动代理和备用代理数量,并逐个验证代理节点。 +演练通过口径与正式启动门禁一致: + +- 所有活动代理必须能够并发完成只读业务请求。 +- 备用代理不足或部分备用不可用时,演练仍标记为可启动,但会显示降级警告。 +- 任意活动代理失败时演练不通过。 + 演练通过只说明当前时点可用;不能保证开抢瞬间不会集中故障。 ## 15. 2026-11-21 实测摘要 @@ -657,3 +685,8 @@ cd frontend && npm run type-check | 2026-11-21 | 备用不足不得导致活动代理池重复提取 | 已实现 | | 2026-11-21 | 严格模式失败组暂停请求并持续补提取,不空打故障代理 | 已实现 | | 2026-11-21 | 运行期持续探测备用代理,失败节点移出备用池 | 已实现 | +| 2026-11-22 | 代理锁定接口返回活动火爆时立即切换出口 IP | 已实现 | +| 2026-11-22 | 准备阶段通过只读兑换限制接口探测代理业务风控 | 已实现 | +| 2026-11-22 | 启动前逐组预检,切换后重新检查全部代理组,未通过禁止启动 | 已实现 | +| 2026-11-22 | 新备用仍活动火爆时同步补提取,并按失败组加备用缺口计算数量 | 已实现 | +| 2026-11-22 | 订单业务错误日志保留斗鱼数字错误码 | 已实现 | diff --git a/docs/抢购预演.md b/docs/抢购预演.md new file mode 100644 index 0000000..6e765e9 --- /dev/null +++ b/docs/抢购预演.md @@ -0,0 +1,50 @@ +# 抢购预演 + +抢购预演用于验证正式抢购前的本地链路,不执行任何兑换动作。 + +## 使用方式 + +主界面点击“抢购预演”后: + +1. 使用当前勾选账号和商品建立任务。 +2. 点击时作为模拟 `T-120s`,立即准备并校验代理池。 +3. 以点击后 2 分钟作为模拟 `T0`,进入倒计时;代理准备耗时计入这 2 分钟。 +4. `T-2s` 使用当前账号 Cookie 执行预热。 +5. `T0` 按配置并发数执行账号级只读请求。 +6. 显示成功、失败和完成进度。 + +## 代理风控检测 + +抢购预演与正式抢购共用同一套代理准备和启动门禁: + +- 准备阶段逐组执行只读 `batchExchangeLimit`。 +- 返回 `1644400007` 或“活动火爆”时,立即切换备用代理。 +- 新代理仍命中活动火爆时继续切换;备用不足时同步提取新代理。 +- 切换后重新检查全部活动组,无法全部通过则预演直接失败,不进入倒计时。 +- `T0` 的只读请求如果再次命中活动火爆,预演会记录失败并触发同一套代理切换逻辑。 + +## 请求边界 + +允许调用: + +- CSRF/CTN 获取。 +- 角色绑定信息查询。 +- 批量兑换限制查询。 +- 和平小店角色查询。 +- 代理时间或商品接口探测。 + +禁止调用: + +- 预兑换。 +- 创建兑换订单。 +- 兑换。 +- 支付。 + +预演不会写入真实抢购结果,也不会自动修改积分或点券。 + +## 优先级 + +- 真实抢购运行中不能启动预演。 +- 预演等待或执行期间,如果真实抢购启动,预演立即终止。 +- 预演使用独立状态,不占用真实抢购运行锁。 +- 关闭应用或停止调度器时自动取消预演。 diff --git a/frontend/src/components/console/ControlStrip.vue b/frontend/src/components/console/ControlStrip.vue index e276b42..aff8d62 100644 --- a/frontend/src/components/console/ControlStrip.vue +++ b/frontend/src/components/console/ControlStrip.vue @@ -5,7 +5,8 @@ import { useAccounts } from '@/composables/useAccounts' import { useActivity } from '@/composables/useActivity' import { useProducts } from '@/composables/useProducts' import { useToast } from '@/composables/useToast' -import { GetResults } from '@wails/go/app/App' +import { CancelSeckillDrill, GetResults, GetSeckillDrillStatus, StartSeckillDrill } from '@wails/go/app/App' +import { types } from '@wails/go/models' const { scheduleActive, seckillRunning, startNow, stopSeckill, startFixed, startSchedule, cancelSchedule, restoreSchedule, subscribeSeckillState, unsubscribeSchedulerEvents } = useScheduler() const { @@ -50,6 +51,9 @@ let stockWatchTimer: number | null = null let stockWatchStartTimer: number | null = null let stockRefreshing = false let stockWatchSettling = false +const seckillDrill = ref(types.SeckillDrillStatus.createFrom({ state: 'idle' })) +const drillStarting = ref(false) +let drillStatusTimer: number | null = null // 从本地缓存恢复定时设置 const { savedTime } = restoreSchedule() @@ -57,6 +61,7 @@ const targetTime = ref(savedTime || '18:00:00') onMounted(() => { subscribeSeckillState() + void refreshSeckillDrill() }) const handleMainAction = async () => { @@ -71,6 +76,78 @@ const handleSchedule = () => { startSchedule(targetTime.value, fixedAttempts.value, fixedDelayMs.value) } +const drillStateLabel = computed(() => { + const labels: Record = { + idle: '未开始', + preparing: '准备代理', + scheduled: '等待触发', + warming: '预热中', + running: '并发预演中', + completed: '预演完成', + failed: '预演失败', + cancelled: '已取消' + } + return labels[seckillDrill.value.state] || seckillDrill.value.state +}) + +const drillCountdown = computed(() => { + const seconds = Math.max(0, seckillDrill.value.remainingSeconds || 0) + return `${String(Math.floor(seconds / 60)).padStart(2, '0')}:${String(seconds % 60).padStart(2, '0')}` +}) + +const stopDrillPolling = () => { + if (drillStatusTimer) { + clearInterval(drillStatusTimer) + drillStatusTimer = null + } +} + +const ensureDrillPolling = () => { + if (drillStatusTimer) return + drillStatusTimer = window.setInterval(() => { + void refreshSeckillDrill() + }, 500) +} + +const refreshSeckillDrill = async () => { + try { + seckillDrill.value = await GetSeckillDrillStatus() + if (seckillDrill.value.active) { + ensureDrillPolling() + } else { + stopDrillPolling() + } + } catch { + stopDrillPolling() + } +} + +const toggleSeckillDrill = async () => { + if (seckillDrill.value.active) { + await CancelSeckillDrill() + await refreshSeckillDrill() + showToast('预演已取消', '抢购预演已停止', 'warn') + return + } + const ap = buildAccountProducts(selectedProductId.value || '') + if (!ap) return + + drillStarting.value = true + showToast('抢购预演', '正在按 T-120s 准备代理,随后倒计时到模拟抢购时刻', 'info', 4000) + try { + const result = await StartSeckillDrill(ap) + if (result.success === false) throw new Error(result.error || '预演启动失败') + await refreshSeckillDrill() + ensureDrillPolling() + showToast('抢购预演已设置', result.msg || '将在 T0 执行只读预演', 'success', 5000) + } catch (e: any) { + await refreshSeckillDrill() + showToast('预演启动失败', e?.message || String(e), 'error') + } finally { + drillStarting.value = false + } +} + const queryAssets = () => { if (isXiaodian.value) { queryAllXiaodianAssets() @@ -364,6 +441,7 @@ watch(seckillRunning, (running, wasRunning) => { onUnmounted(() => { stopKeywordWatch() stopStockWatch() + stopDrillPolling() unsubscribeSchedulerEvents() }) @@ -380,6 +458,14 @@ onUnmounted(() => { > {{ seckillRunning ? '停止抢购' : '立即抢购' }} +