Commit Graph

884 Commits

Author SHA1 Message Date
huangzd1997 c8cd75cf6c feat(phase-5): B60 console 分页与矩阵预聚合+P1-B5/6/7/8 性能热点收口
接管另一路会话的 Phase 5 在飞件收口(5A/5C 主体由那一路落码,本笔补齐 P1-B7 与两处台账并整量验证)。

- 5A/B60:撞款 console 的行窗口在服务端真分页(响应 dup 行数 ≤ pageSize,total_dup 仍是未分页
  总数)、dupGroup 判据收归服务端单一出处(前端 dupWithinGroup 删掉,两套同名规则不再分叉)、
  排序先于切窗;后管矩阵改预聚合+列窗 40。读数(200 列 × 50 行):每行 3 店 8.4 → 5.3 → 0.7ms
  (12.4×),每行 40 店 83.7 → 18.4 → 1.8ms(45.3×)。服务端不设列窗是判断不是漏做:shops 每行
  只有 5 个标量,而矩阵的列来自已分页的行——给 shops 再加分页会把"全局指标读全集"和"列窗读本页"
  两套语义搅在一起。浏览器首屏/交互耗时本机拿不到,登记为 Phase 6 现网复量。
- P1-B6:claim 循环的父任务终态判定折成一次批量 IN(TaskFileJobBatchQueries+Mapper XML,
  铁律 1 收口在 Mapper),逐行 CAS 认领一字不动。
- P1-B5:V187 只建 idx_biz_file_task_resume_of;审计给的候选集索引**有意不建**(V184 前缀已覆盖,
  OR/IS-NULL 与 COALESCE 不可索引),判据把这条负判定钉住。真库 EXPLAIN 本机无 MySQL,顺延现网。
- P1-B8:结果载荷的对象存储删除移到 afterCommit,事务里不再做 120s 超时的网络调用。
- P1-B7:结果集读取按窗提交+收割(窗口=线程池队列容量的一半)。审计把它记成"无 limit",但截断
  是正确性错误不是性能取舍,真能收的是"整份结果集被读两遍"——一次性提交时每支 Future 把解好的
  载荷扣在自己身上直到全部收割完,峰值=结果集+另一份整副本;分窗后副本只驻留一窗。流式组装
  契约要改 4 个模块的调用方,本 Phase 未做,别读成 P1-B7 已闭环。
- SourceScanTest 台账随之登记:裸名 25 → 26、调用方 18 → 19(P1-B7 的窗口判据只能打在源码上——
  线程池只有 8 个线程,"同时开始读几行"改前改后读数相同,差异只体现在堆上,mock 数不出来)。
2026-11-03 23:00:44 +08:00
huangzd1997 b9d23d5936 feat(phase-4): 建单凭据需求按 task type 登记进 TaskModuleRegistry(B72-01)
`/newApi` 是整包转发的透传面(客户端只搬字节),载荷里有什么凭据需求客户端猜不出来;
铁律 27 的建单闸门此前只有两处各写一枚枚举,"这一类要什么凭据"没有一处正本。本笔把它
收成表:`TaskModuleRegistry.Module` 新增 `submitSecret`(16 类逐类登记),
`requireSubmitSecret` 新增按 type 的入口,enum 形态降为包内原语——包外再想硬编一把密钥
就编译不过,只能上册表。

两处判断写死在代码里:
- **登记为空是结论,不是漏填**。外观专利/货源查询要 LLM 密钥;其余几类缺的是代理,
  而缺代理在执行侧是「直连降级」不是注定失败(铁律 27 边界 c),拦了会把现在能跑的功能
  判死——所以本笔只登记、不新增任何拦截,`enqueue_json` 那半还等"这台机器直连能不能
  采到"的实测读数(B72-01 后半欠账原样留着)。
- **空登记调到这里当场 IllegalStateException,不静默放行**。空转的闸门比没有闸门更坏,
  它让下一个人以为这条链已经防住了(门禁 1 同族)。同理 `submitSecretModuleOf` 对不在
  清单里的 type 抛错而不回落:「没登记」与「登记过=不需要」不许揉成同一个值。

判据:`TaskModuleCoverageTest` +3 例(登记表与实际问闸门的类型双向对撞/每个模块都
登记过/未知类型当场抛,源码扫描按 ConsoleWideningGuardrailTest 的 mainRoot 口径,
定位不到即抛不空扫)+`UserApiSecretServiceTest` +4 例(按 type 拒/放行不读库/
空登记抛 IllegalStateException 且不碰库/未注册抛 IllegalArgumentException)。
两处快照测试跟着改到类型形态(`anyString()` 消歧重载,摘掉不再使用的 enum 导入)。
反向验证:外观专利不登记→2 红;给 COLLECT_DATA 顺手加登记→2 红;静默放行→1 红;复原复绿。

行为对现网零变化:两个调用点问的还是同一把钥匙、同一句文案。
门禁:`mvn -o test-compile` rc=0;`mvn -o test` 整量 5274/0 失败/0 错误/19 skipped
BUILD SUCCESS(Phase 3 在册 5267+本笔 7)。
2026-11-03 16:19:59 +08:00
huangzd1997 51401de2d5 fix(phase-2): B51-R1 收口——failure_category 落库+写点全接线+双读按文案优先
判死/重试/重开原先只读 biz_file_task.error_message 里的中文子串决定:改一句用户看得见的
文案=静默改一次整单生死,而且改的人不会知道。V186 补 failure_category(可空、存量不回填),
TaskFailureLedger 作为唯一写入口把「那次判断的结果」与文案同笔落库——词汇表仍只有
TaskRetryEligibility 一处,ledger 不抄第二份 markers(B52 那族的复发形状)。

- wrapper 面 22 处写点全部同笔派生写列;实体面接线第二批(外观专利 4/相似ASIN 4/采集 1),
  正是 DELIVERY/BALANCE 那几族被判死消费的文案
- 读侧 category(task) 取「文案判得出按文案、判不出才按列」:名单外的实体写点改文案带不动列,
  无条件读列=让一列陈旧判决判死当前这一单,那是本笔自己引入的漂移,比它要修的 bug 更糟
- FileTaskEntity.failureCategory 标 @TableField(updateStrategy = ALWAYS):updateById 默认跳过
  null 字段,「清错误」的分支会留下陈旧列;让 null 真落库,最坏只退回文案判定=加列前的今天
- 判据:TaskFailureCategoryGuardrailTest(5)+TaskFailureCategoryMigrationV186Test(5),已反向验证
  「删任一处配对即红」;SourceScanTest 台账裸名 24→25、调用方 17→18
- 门禁:mvn -o test 整量 5267/0 失败/0 错误/19 skipped;_push_gate.py full overall=pass

Contract 阶段(收 contains(<中文>) 判定)按蓝图登记留到读侧全切之后,本轮不动。
2026-11-03 12:49:45 +08:00
huangzd1997 34f730d403 fix(phase-2): 任务活性与失败归因六格收口——在飞豁免/锚点分流/同源判据/回落一元化/巡检按账号分组
蓝图 docs/REFACTOR_PLAN.md Phase 2 的 ①②③④⑥ 五格+台账登记。⑤(failure_category)
未做,原因见文末,不以此笔冒充闭环。

① B74-02 卡死阈值二选一 → 选"扫描询问执行侧",没有抬阈值。
  取证:B 侧 24h 批次 costMs 实测 22,988 / 85,298 / 939,172(单行批次 15.6 分钟),
  A 侧今天 06:07:20 `STUCK_REQUEUE_EXHAUSTED jobId=23815 taskId=33179 stuckRequeueCount=20`,
  06:08 复位恢复、09:20 同样两条=环。真因不是批次长:`startJobHeartbeat` 在父任务终态时
  按 CR-08 刻意停止续期(stage=TERMINAL_STOP_RENEW),执行线程还在跑而 updated_at 冻结,
  扫描每 5 分钟扣一次计数。冻结是**无限期**的,抬到 16 分钟只把 20 次计满从 100 分钟拖到
  320 分钟,还把真遗骸回收拖慢 ⇒ 改为 TaskFileJobService 持内存在飞登记
  (markInFlight/clearInFlight/isInFlight),扫描对"本机线程还在跑"的行不重排也不计数;
  登记面随进程重启即空,遗骸回收形状不变。worker 侧登记在 activateRunningClaim 之后、
  注销在 finally(finishAfterExecution 之后再注销)。

③ B74-03 判死谓词分流(先取证后动手,红线照办)。
  取证:云助手只读 HGETALL+TTL 两枚 stall 键自洽——33179 pos="Linux后台抓取: 606/676"
  与当前 progressText 逐字相同、at 距 now 16,058s(4.46h)、TTL 余 16,342s ⇒ 键 TTL 设定
  32,400s = 9h = 窗口(180min)×3;33149 同样自洽。机制坐实:键一过期 evaluateAgainstSnapshot
  就把起点重锚到 now 并直接 ADVANCING ⇒ 每 9 小时白送一轮完整豁免,沉默客户端永远封不了口
  (11-02 那串"客户端仍在推进"即此形状)。改法:快照缺失/at 读不出与"指纹真变"分口,
  重建锚点锚到**客户端最后一次上报时刻**(位置哈希自己的 at,此前无人读过),再走同一条
  时间判据;客户端确在心跳时锚点仍新鲜 ⇒ 照旧 ADVANCING,判死线不提前(28919 教训在册)。
  P0-C2 快照按"更新即登记"补 3 支:沉默超窗不得豁免/at 读不出走同一条判据/心跳中照旧放行。

② B74-01 三格:landed 与 isJudged 收成同源(mergeLlmRowsIntoChunks 认的"塞回分片"不是结论,
  旧写法给只有 patentRisk 的行打 24h 标记 ⇒ 既不再是候选又无结论列);beginRowInspection 的
  Redis null 由"抢到"改判"未抢到"(抛异常的真降级照旧放行,两条不同路);
  deleteExtraTaskCacheKeys 原删的是从不写入的基键=删空气,改按 processed-rows:{taskId}:*
  游标 SCAN 删真实逐行标记(用 SCAN 不用 KEYS)。新断言做过反向验证:摘掉 isJudged 闸门
  即真红,不是白过。terminalizeRoundExhaustedRows 是按轮次上限终态化的唯一豁免,已写明。

④ B74-04 四台 JSON 回落收成唯一出处 TaskOwnerJsonFallback(result_json 正档先于 request_json;
  店铺采集此前只读 request_json ⇒ 列缺失的 39 行 RUNNING 存量行在不同校验里算出两个归属)。
  TaskOwnerReadSourceGuardrailTest 补回落面:四台不得再有本地回落写法,且顺序钉在那一处。

⑥ B73-03 巡检分组键按供应商账号折(供应商, 提取域, 排序后 query 的摘要——只落摘要,
  链接里的账密明文不进日志/告警面)。青果整个账号只有 1 条通道,旧 moduleKey|channel|密文
  让同一把 key 多开几枪就自己把用户的代理打成 channel_busy。另一半边界同样钉住:
  非链接型凭据(LLM 密钥)照旧逐模块分组,否则拿 A 渠道的结论冒充 B。

台账:SourceScanTest 裸名 23→24(新增 TaskOwnerJsonFallback.java 这一枚),
  与 2026-11-02 那次 22→23 同法逐笔写明是谁的哪一笔、为什么只能打在源码连线上。

门禁实录:mvn -o test 整量 **5256 例/0 失败/0 错误/19 skipped,BUILD SUCCESS**;
  mvn -o test-compile rc=0;定向面另点过(56/88/34+70/63/104 例全绿);
  本仓后端无 spotless/checkstyle ⇒ lint 与格式步如实登记、不是漏执行。

未做的一格(⑤ B51-R1 failure_category):取证显示 biz_file_task.error_message 的落库点
  **没有单一出口**(LambdaUpdateWrapper.set(errorMessage) 15 处+setErrorMessage 若干,
  合计约 25 处,且清 null 的分支也必须同步清列)。这不是"改一支方法"的量级,
  拿半截双写冒充 Expand 会变成列恒为 NULL 的死代码 ⇒ 留作单独一笔,蓝图保持未勾。
2026-11-03 10:47:59 +08:00
huangzd1997 66621d8a16 test(ratchet): f43ed6f1 落地时漏改的两处陈旧钉按实测重新上钉
这两支红在 HEAD 上(不是工作树):f43ed6f1「任务中断+继续」当时只跑了定向
79+22 与 ops 快检,没点后端整量,于是两支钉死分母跟着功能一起陈旧。本笔不放宽,
只是把覆盖面变大如实记账——与文件里既有的 126→128 那条同一写法。

- ResultFileJobHandlerTest.interfaceMethodsPresent 9→10:接口新增第 10 枚
  default onTaskResumed(Long)(继续续跑前清模块补检预算,AP 侧删 __recheck__
  哨兵键;不清则"继续"后第一轮就被"补检已耗尽"直接按部分表收尾)。断言里
  同时补上对 onTaskResumed 的 methodOf 存在性核对,别只数个数。
- RequestSuppliedIdentityOutletTest 写类分母 128→129:TaskHeartbeatController
  POST /api/tasks/{taskId}/interrupt 是新增的写类端点,@RequestParam("user_id")
  先过 adminAuthSupport.resolveOwnershipUserId 再比归属(:52-57 实核)。
2026-11-03 09:29:37 +08:00
huangzd1997 43240b9a10 fix(stability): 接手第三路未提交 WIP 并收口——卡死扫描跨实例归属守卫+补检预算闸
归属声明(不是本会话的产出,本会话只补了漏改的桩):这批改动在工作树里躺到
2026-11-03 00:47 未提交,f43ed6f1 的 commit message 已点名"同工作树另一会话的在飞件
(TaskFileJobService 卡死归属守卫、TaskResultFileJobWorker、DeliverySupport 补检闸及其
3 支测试)未卷入本提交"。用户 2026-11-03 拍板"接手收口后开 Phase 2",故原样入库。

WIP 本体(作者=第三路会话):
- TaskFileJobService:resetStuckRunningJobsDetailed 增 currentInstanceId 重载+
  belongsToAnotherInstance 谓词——B 扫到 A 正在跑的 RUNNING 行不再翻 PENDING 也不再
  +1 stuck_requeue_count(33149 爬到 20 判死线即此形状);不带实例 id 的旧入口保持
  原行为,后管人工复位按钮不受守卫影响。
- AppearancePatentDeliverySupport:requestRecheckForMissingRows 自己吃
  recheckMaxRounds 预算——行级轮次只在行真进批次才累加,"没有可比对图/载荷"的行
  永远进不了批次,于是 33179 一个 1 行缺口六小时补了 70+ 轮。
- 配套:TaskFileJobOwnerHandOffTest +4 支(谓词边界/他机 RUNNING 不翻不判死/
  自己的陈旧行照翻/无实例 id 入口原行为),StuckScan 与 FailureNotify 两支桩
  改到新 3 参签名。

本会话补的一格:TaskResultFileJobWorkerTest 三支桩没跟着改到 3 参签名,
stuckSimilarAsinJobAtRetryLimitFailsOwningTask 等 3 例 PotentialStubbingProblem
真红(11-03 09:0x 实测)——改成 eq(0),eq(0),anyString() 并补 eq 静态导入。

验证:mvn -o test 定向 6 类(Worker/StuckScan/FailureNotify/OwnerHandOff/
ResultFileJobHandler/RequestSuppliedIdentityOutlet)rc=0 全绿。
2026-11-03 09:29:23 +08:00
huangzd1997 6444c17edc refactor(phase-1): 后端依赖瘦身——CN-03 lombok provided+CN-04 测试库泄包排除+S-be-2/3 依字节码证据排 rocketmq 死重(fastjson1/guava/snappy 保留留痕) 2026-11-03 04:13:03 +08:00
huangzd1997 a04c1f3cf6 test(phase-0): 稳定性契约快照三支(P0-C1 stuck 时序/P0-C2 活性谓词三出口/P0-C5 判死 markers 词汇表) 2026-11-03 02:43:15 +08:00
huangzd1997 f43ed6f116 feat(task-interrupt): 任务「中断+继续」——在跑可停、部分表可下载、已中断可续跑
用户口径(2026-11-03,33179 卡 80%「正在提交检测」的救援出口):任务卡片加
「中断/继续」;中断后已完成检测的数据生成结果文件供下载,未完成行不再检测;
继续在原任务上续跑剩余行(断点续传,已检测行不重检)。

中断(POST /api/tasks/{taskId}/interrupt,鉴权镜像 retry:resolveOwnershipUserId
+归属校验,普通账号只能中断自己名下的任务;终态重按幂等 no-op):
- TaskHeartbeatService.markCancelledByUser:ACTIVE→CANCELLED 条件更新(词表走
  TaskStatuses.FileTask 常量),写「用户中断任务,已完成部分可下载」+finished_at,
  syncTerminalState 同步模块缓存与进度快照;客户端心跳拿到 notAlive 即协作停止
  (app_client/maixiang 零改动,≤60s 自停)。
- LLM 批循环批间查终态即停:当前批跑完不再发新批(isOwningTaskTerminal)。
- 中断任务的组装跳过候选申领/LLM/补检,直接按已有行账出部分表(allowPartial),
  状态保持 CANCELLED 不改写,只补行账缺口文案;cleanupResultFileJob 对 CANCELLED
  任务保留分片/范围态/瞬态载荷(这就是「继续」的续跑点),常规交付照旧清理。

继续(retry 链路放宽 CANCELLED,全部在原任务上):
- retryInPlace 条件更新放宽 FAILED/CANCELLED;CAS 前经 ResultFileJobHandler
  新钩子 onTaskResumed 清模块补检预算(AP:删 __recheck__ 哨兵键;不清则继续后
  第一轮就被「预算耗尽」直接按部分表收尾,钩子抛错即中止不留半态)。
- 中断已交付过的:清 result.result_file_url/size(让位给新表)+把 SUCCESS 的
  ASSEMBLE_RESULT 作业复位 PENDING(retry/stuck 计数清零、清错误与 finished_at);
  FAILED 仍走既有 resetTerminalFailedForRecovery。
- 校验文案「只有失败或已中断的任务可以继续」;成功任务不可继续。

前端(用户端外观专利 Tab 先行,后端端点本身通用):中断按钮进当前/历史两个
动作槽(确认框说明「未完成行不再检测、已完成检测的数据会生成结果文件供下载」);
CANCELLED 显示「已中断」(判定先于 isResultPreparing,不掉「等待中」兜底);
重试按钮文案 CANCELLED→「继续」,继续的确认框警示部分结果文件将被替换请先下载;
轮询收敛集合与 keepPendingFileTask 补 CANCELLED。棘轮:前端 catch 块 310→311
(interruptTaskRecord 一支,两处 ElMessageBox 确认走 .then 两臂不新增 catch);
状态词表全走 TaskStatuses 常量。

测试:TaskHeartbeatServiceTest +4(CAS 落库+缓存同步/终态幂等/非本人 403/
任务不存在明确报错)、TaskInPlaceRetryServiceTest +3(继续复位+作业复位+
补检钩子只对 CANCELLED 触发/成功不可继续)、新增 AppearancePatentInterrupted
ResumeTest(3)(保留分片=续跑点/常规交付照旧清理/中断收尾不改写状态)与
AppearancePatentLlmBatchPipelineInterruptTest(2)(批间终态即停);后端定向
79+22 全绿。前端新增 appearance-patent-interrupt-continue.test.ts(9);npm test
1003/1003、test:mount 55/55、vue-tsc 零错;ops 快检 overall=pass(grep 需
Git usr/bin 在 PATH,两红格系本机 shell 环境非代码红)。

并发边界:同工作树另一会话的在飞件(TaskFileJobService 卡死归属守卫、
TaskResultFileJobWorker、DeliverySupport 补检闸及其 3 支测试、useLiveTaskBoard、
task-delete 三件)未卷入本提交;本提交不依赖其中任何符号(appendDeliveryGapMessage/
resetTerminalFailedForRecovery/registry.asMap 均在 HEAD 已在)。
2026-11-03 02:07:48 +08:00
huangzd1997 37f51df37d fix(owner): 跨实例归属背离改为转交作业,不再无限 defer 空转
领取按 biz_task_file_job.owner、执行时校验按 biz_file_task.owner_instance_id,
任务转交后两列一旦背离就是互斥死锁:能领到这行的实例必被校验拒,校验放过的
实例必领不到这行;而拒绝分支 deferRunning 既不计 retry_count 也不计
stuck_requeue_count 还每轮刷新 updated_at,卡死重排与 PENDING 遗骸两条兜底
因此永不触发。现网外观专利 33179/33149 停在 PENDING 每 15 秒被拒一次,单机
12 小时 6381 条拒绝,进度快照冻结 4 小时 19 分,既不失败也不完成。

- TaskFileJobService: 新增 handOffToOwner(owner 列与 scope_key 尾段一起改挂,
  CAS 按观测到的旧 owner 回撞)与 withOwnerScopeKey(ownerFromScopeKey 的逆操作);
  enqueueAssembleResult 的 PENDING 分支改为按入队 scopeKey 对账归属——Python
  超时恢复每 2 分钟走这一格一次,原先只补发事件不对账等于每 2 分钟确认死锁还在。
- TaskResultFileJobWorker: 归属拒绝改为先改挂再退回。转交后两列重合,拒绝条件
  按构造不再成立,因此不需要额外计数兜底。
- 相似ASIN/发布 ownerFromTask 改为 owner_instance_id 列优先:原先只读 resultJson
  快照(转交后不再同步),转交目标会算错、死锁只是换个方向。店铺采集本就列优先,未动。

判据:TaskFileJobOwnerHandOffTest(11) + TaskResultFileJobWorkerOwnerHandOffTest(3)
+ TaskOwnerReadSourceGuardrailTest(5,含四台校验源同源的源码绊线,已反向验证
"改回只读快照即红")。SourceScanTest 台账按设计登记新消费方:裸名 22→23、
调用方 16→17。后端整量 5206 支 0 失败 19 skipped。
2026-11-02 22:53:18 +08:00
huangzd1997 0114a5b7a7 fix(文案): NO_AVAILABLE_CHANNEL 不再断言"是你自己的采集占着",三成因一次说全
现网实测把这句文案证伪了:零并发单发 overseas.proxy.qg.net/get(就这把平台 key)仍回
NO_AVAILABLE_CHANNEL,而两台机器本小时都没有一条青果提取记录(vc 槽空闲、maixiang 走的是
极客且本小时只确立 17 次租约)。所以"等约 3 分钟释放"是一个**猜出来的单一成因**,
它会把人引去反复点、等一个根本不会来的释放。

供应商这个码至少三种成因,文案一次给全并给出去哪查:同账号其他提取占着(约 3 分钟)、
这把 key 的套餐到期/无余量、后台把鉴权切成 IP 白名单档(我们只做账密档,切了就一直拿不到
通道——铁律 25 那条口径)。后管档位名同步从「待释放」改成「无可用通道」,用户端面板提示
补"隔几分钟仍报同一句就别再等,去青果控制台核对通道数与有效期"。

判据跟着反转:原来那条测试把"正被你自己的采集占着"当事实钉住,现在改成
doesNotContain 那句 + 必须含「没有可用的空闲通道」「IP 白名单」——谁改回单一成因即红。

顺带清掉 B73-14:UserSecretModule.defaultChannel() 的注释写"代理=青果(10-29 拍板)",
而代码取 ProxyProvider.DEFAULT=JIKIP(10-30 拍板改回极客)——注释与代码相反,下一个人照
注释判断"没写 channel 就是青果"会做错事;改成只跟着 DEFAULT 取值并写明来历。

后端整量 5187/0 失败/19 skipped;用户端 994+55、后管 1872+68、tsc 两面 rc=0、
ops 可读性棘轮 10 绿。
2026-11-02 17:09:08 +08:00
huangzd1997 7e64c12dd6 fix(proxy): 青果检测改真探并按供应商分码,三面收口凭据外漏与「无法判定」
用户报「青果也要加检测」,往下挖出四层假象,一次收口:

- 后端:probeProxy 的青果短路(过去无条件回「提取成功(青果隧道端点,连接鉴权在客户端)」,
  依据的注释已过期——存下来的链接里就带 key/pwd)删掉,改成真打一次提取,按供应商返回码
  分档出独立 check_code:channel_busy / invalid_key / forbidden / rate_limited /
  insufficient_balance / tunnel_unverified。文案出口一律抹 key/pwd。
- 后端:巡检遇 channel_busy 不落库也不推通知。通道被占不是「密钥坏了」而是「此刻问不出
  结论」,而巡检自己那一发真提取就要占掉唯一一条通道——落库等于把用户早上看到的
  「代理异常」写成我们自己造成的。
- 后端:余量口径按供应商分档。青果账号此前会落进「否则查平台套餐」那条,界面显示的是
  别人家的 jikip 余量(串档);青果不提供可鉴权的余量/余额查询(余额接口是控制台
  appid/appkey 签名档),这一档宁可返回「查不了」也不借极客的数。
- 后端:SecretMasking.maskProxy 的脏值回落不再套 mask()——它保后 4 字符,而青果的 pwd=
  恰好挂在末尾,等于把口令尾 4 位交给界面与日志;改成只交「像 host 的那一段」。
- 用户端:去掉「青果账密直连,无需检测」的 disabled 例外,未保存账密现拼链接送检;
  「无法判定」回落改成后端文案原样显示+可重试语义;代理卡不再套 LLM 渠道字典
  (「龙抬头」错标的真根因就在这行)。
- 后管:货源标签拆成两张互不相通的字典,代理列只读 masked 且不回落到原文,删掉
  user-select:all 的全选复制旁路,「修改代理」改成重填 Authkey/Authpwd 的弹窗。

判据:SecretMaskingTest(5)、UserProxyBalanceServiceTest(6)、UserApiSecretServiceTest
(+1 巡检不落库)、UserApiSecretCheckServiceTest(+138 行分码)、ProxyLinkKeyTest、
用户端 node 5 支+mount 10 支、后管 node 9 支+mount 8 支。后端整量 5187/0 失败,
full 闸门四面绿。
2026-11-02 15:18:41 +08:00
huangzd1997 7f5437d012 feat(submit-gate): 缺 LLM 密钥的外观专利/相似ASIN 单在建单口当场拒
用户口径(2026-11-01):「没配置代理的不止是变体采集要拦,其他任务也是一样,包括 llm 密钥。」
这一支是服务端那半边——两把 LLM 密钥此前是**静默降级**:readApiKey 读空只打一条
log.warn,然后「保留原始行」把单子跑完、把表出出来,整列检测结论却是空的。
用户买到一张没检测过的结果表却看不出来,比一句「没配密钥」的失败更难发现;
而 UserSecretModule 早就把这两把密钥登记成 required=true(用户端必填),闸门只是把
这句声明变成会拦事的代码。

- UserApiSecretService#requireSubmitSecret:请求体带的密钥与库里存的那把,有一个非空即放行;
  两侧都空当场 BusinessException(文案点名是哪把密钥、去哪配)
- 外观专利 AppearancePatentTaskService.parseAndCreateTask / 相似ASIN
  SimilarAsinTaskService.parseAndCreateTask:闸门排在 Excel 解析与建单四段**之前**,
  不解析、不落库、不占配额;userId 校验仍在最前(先判身份再判凭据)
- 用例:UserApiSecretServiceTest 3 支(两侧都空拒 / 带值放行且不读库 / 库存量放行)、
  两支建单快照各 2 支(缺密钥不碰源文件不落库;正向对照验模块与请求密钥同值)
- 六支 SimilarAsinTaskService*Test 补 @Mock UserApiSecretService:@InjectMocks 缺该类型
  会注进 null,闸门调用直接 NPE——这是把闸门接真后必须显式登记的依赖
- RequestSuppliedIdentityOutletTest 写类分母 126→128:2026-11-01「原任务重试」新增的两支
  POST 端点(TaskRetryController / AppearancePatentController)都已接 resolveOwnershipUserId,
  覆盖面变大不是放宽判据;该红是当时只跑四面闸门、没点后端整量留下的陈旧分母

后端整量 mvn -o test:5164 例(本笔改动 0 红;唯一一处红即上述陈旧分母,已随本笔抬正)
2026-11-02 00:33:58 +08:00
huangzd1997 8f206a6019 chore(ratchet): 原任务重试两处兜底 catch 逐处记名并抬四格
TaskInPlaceRetryService 的 clearResultError/resetAssembleJob:WARN 留痕、
失败不阻断已复位的重试。total 1063→1065、logOnly 190/249→192/251、
notRethrow 严格/基线 602→604,出处逐条写进常量上方。
2026-11-01 01:55:34 +08:00
huangzd1997 96b090dfd5 feat(task-retry): 重试按钮推广到相似ASIN与采集数据
同类问题一起修:这两个模块与外观专利共用同一条自动重试(原先也克隆重试)。
- 新增通用端点 POST /api/tasks/{taskId}/retry(模块无关,从任务行取 moduleType)
- 两页失败任务在「删除」前显示「重试」,调用后在原任务上复位续跑
- catch 棘轮 308→310,两处均 ElMessage 可见出口
2026-11-01 00:46:08 +08:00
huangzd1997 0a467793ac feat(task-retry): 失败任务改为原任务上重试 + 重试按钮(用户拍板)
用户口径(2026-11-01):失败不再自动克隆(一单失败几次就多几行结果),
改成「删除」旁边的「重试」按钮,在原任务上断点续传;自动重试也只复位原任务。

- 新增 TaskInPlaceRetryService:FAILED→PENDING,清错误/终态时间,代数+1,
  保留分片/解析载荷/已检测标记;结果行清错误、组装作业复位(含卡死重排计数清零)
- TaskResumeService 自动重试改为调用原地复位(不再 cloneForRetry)
- TaskRetryEligibility 新增 DELIVERY(结果文件生成多次失败/卡死重排不重试)
- 新端点 POST /api/appearance-patent/tasks/{id}/retry;前端失败任务显示重试按钮
- ⚠ 本笔的 BrandAppearancePatentTab.vue 里另含他路在飞的「删除失败任务时一并删任务行」
  两小段(同一文件无法分块提交),随本笔一并入库
- 用例:TaskInPlaceRetryServiceTest 2、TaskResumeServiceTest 19、Eligibility 9、
  契约 8、前端 catch 棘轮 4,均绿
2026-11-01 00:30:51 +08:00
huangzd1997 0dfd385c4c fix(task-resume): 交付侧失败不再自动克隆重试
现网 32967→33001→33017:同一份输入失败后自动重试 3 代,每代一行
「结果文件生成多次失败」,用户看到「失败一次出一个结果」。
TaskRetryEligibility 新增 DELIVERY 类(结果文件生成多次失败/卡死重排),
排在欠费之前判定;回传中断/心跳超时仍可重试(反向用例钉住)。
2026-10-31 23:57:14 +08:00
huangzd1997 6a9dc34713 fix(db): V185 菜单插入显式写 company_id 并按公司幂等
columns.company_id 是 NOT NULL 无默认值,漏写直接 1364,导致 V185 从未应用成功
(库里留 success=0 历史行,A/B 后端都起不来)。菜单是每公司一行,幂等判据改成
(company_id, column_key);事务内实测插入 6 行后回滚干净。
2026-10-31 22:45:24 +08:00
huangzd1997 91d36327f9 fix(phase-5.2): 消项 CR 第二轮 P1/P2/P3(通道/证据链/交付时序/后管证据页) 2026-10-31 21:12:18 +08:00
huangzd1997 a4e4456b50 feat(llm-arrears): 上游 LLM 欠费的提示落到任务界面并让货源链欠费即判死
现网两处叠加的洞:归因文案早在 2026-10-27 就写进了 biz_file_task.error_message,
但两支历史装配器只读结果行的错误、buildActiveItem 连任务级那条都不带,用户在列表
里只看到「失败」两字;货源链更是只有行级归因、任务停在 RUNNING,采集端读不到
心跳的 alive=false,就继续为永远进不了 LLM 的行按次付费买出口 IP。

- 新增 modules/task/service/TaskVisibleFailureNotice:界面出口的单一判据。认出本仓
  写下的欠费/密钥失效归因就换成 TASK_TERMINAL_GUIDANCE 那句中文动作,库里原文一字
  不改(英文响应体与上游账户号不进界面,对齐 RawExceptionMessageSinkGuardTest)。
  刻意不用 TaskRetryEligibility.BALANCE 当显示判据——那一类还涵盖 jikip 代理欠费,
  拿它换句子会把「出口没钱」说成「LLM 账户欠费」,正是 10-27 要避免的误导。
- 两支 HistoryAssembler 共用该出口:行级为空时兜底任务级归因,欠费压过行级副产品。
- 货源链补 terminalizeOnFatalLlmFailure(口径逐字对齐外观专利):判据取 BALANCE、
  非终态才写、可重入;并让 finalizeTask 不许用空/二次错误串盖掉整单结论。
- 用例:TaskVisibleFailureNoticeTest 11 例、SimilarAsinLlmArrearsTerminalTest 16 例
  (含 502/429/连接失败/心跳超时不许误杀、已终态不改写、收尾覆盖保护、接线源码钉子),
  两支装配器各补 4/3 例。后端整量 5,127 例/0 失败/19 skipped。
2026-10-31 17:34:54 +08:00
huangzd1997 7469c710d7 feat(collect-channel): 采集执行方按单判定并随 /parse 落库
「这一单交本机还是线上」原先是全局 yml aiimage.collect-routing.local-enabled,
一台服务器一个值,把同机所有账号捆成同一个执行方:本机开着的用户被迫走线上,
跑 Linux 兜底的用户也没法把某一单留在本机。现改为建单时逐单登记
biz_file_task.collect_channel(V183,可空=按模块默认),全局开关只留兜底窗口。

- 列可空且不回填:空值按模块默认解释,APPEARANCE_PATENT/SIMILAR_ASIN 读作 LOCAL、
  其余读作 ONLINE,与撤掉的 AIIMAGE_COLLECT_LOCAL_* 出厂值逐字节等价,
  历史单与未升级前端行为不变。
- TaskRetryCloneSupport.buildChild 必须继承通道:原单选了线上,重试掉回模块默认
  等于悄悄换执行方。
- CollectChannel 用逐值比对而非 valueOf+catch 判「不可识别」:后者会把静默 catch
  总数顶过 CatchSilenceRatchetTest 上限 1057。
- 两支建单快照 golden 随 collect_channel 键重建(只多出 collectChannel=null)。
2026-10-31 12:33:09 +08:00
huangzd1997 2c2cb23943 fix(phase-5.1): 回收/确认幂等与两前端分片重试按 CR 消项加固
- 分片回收与 savePart/complete 共用会话锁并锁内复查 mtime
- 版本/教程 confirm 按 version 或 fileName+version 幂等返回既有行
- 证据登记失败补偿删除已上传对象;标签截断到列宽 32
- 用户端分片持久化 upload_id、校验包体失败、失败不再 DELETE
- 后管逐片重试 2 次、放弃时删除会话;catch 台账抬到 1057/190
2026-10-31 04:26:58 +08:00
huangzd1997 b13d795731 fix(phase-4): 证据件与分片落点按既有尺子收口
- TaskEvidenceMapper 去掉注解 SQL,保留期回收改用 MyBatis-Plus 分页
- 超管出口只保留一处静态判定,AdminTaskEvidenceController 记 uid 对撞日志
- SHA-256 走 Hutool DigestUtil、临时件用 File.delete 收掉两枚新 catch
- 分页台账补 AdminTaskEvidenceController 两点,catch 台账抬到 1055/189
2026-10-31 04:03:14 +08:00
huangzd1997 6fe5c8c8d0 feat(phase-3,4): 证据件服务端落点与两前端大档分片接线
- 后端新增 evidence 模块(V182 证据表/独立桶/超管读取面/内部登记)与
  application.yml evidence 块;管理员四端点逐个 requireSuperAdmin。
- 分片通道补 @Scheduled 回收与 LocalTempCleanupService 的 chunk-uploads 覆盖;
  版本/教程 confirm 接受 file_key,把拼装件搬进 client 桶后落库。
- 用户端 9MB 视频改走 uploadTempFileToJava 分片;后管版本/教程 >8MB 走分片,
  小文件仍走原 presign 直传。
- 激活 Phase 3/4 后端与两前端预置契约。
2026-10-31 03:45:50 +08:00
huangzd1997 5c283a79fc test(phase-0): 确认基线全绿并预置迭代验收测试契约 2026-10-31 01:14:39 +08:00
huangzd1997 c7b035dce9 fix(user-secret): 白名单「获取当前 IP」改走服务端回显,第三方回显只作兜底
无影云桌面等受限网络里 myip.ipip.net 不可达,页面却能正常调自家接口,
导致青果白名单拿不到本机出口 IP。新增 /api/user-secrets/client-ip
回显服务端看到的来源 IP(XFF 逐跳取首个公网地址),前端优先用它,
失败再退回第三方回显。
2026-10-30 17:07:32 +08:00
huangzd1997 43ae12f722 feat(user-secret): 代理白名单一键添加(极客/青果)并前置默认渠道
- 客户端设置面板新增「白名单」区块:自动获取出口 IP、可手改;加入前先同步未上报的代理配置,避免拿服务端旧 Key 代加
- 后端新增 POST /api/user-secrets/proxy-whitelist:先查后加;极客用套餐 ID+套餐 key,青果用已保存提取链接里的 key,重复添加不报错
- 极客套餐 key 加密存 biz_user_proxy_plan.jikip_plan_key(V181),回读只给掩码;换套餐 ID 时必须重填
- 白名单接口地址走配置(AIIMAGE_USER_SECRET_JIKIP/QINGGUO_WHITE_LIST_*),日志不落 key 与完整 URL
- 贞贞/极客等默认选项前置;catch 棘轮 7 处逐条记名并入基线(含 79b04afd 的 AdminApiGuardFilter 一枚)
2026-10-30 11:05:55 +08:00
huangzd1997 79b04afdd9 fix(phase-6.1): CR 消项——分页锚点、分片鉴权、中断归属
- 任务中心 keyset 锚点取 offset-1(上一页最后一行),修复第 2 页首行永久丢失
- /api/files/chunk/** 纳入必须凭据的写端点,并按解码路径再判一次堵住百分号编码绕过
- /api/tasks/{id}/interrupted 增加归属闸:普通账号只能打断自己名下任务,
  内部令牌/管理角色保持原语义;品牌任务经 BrandTaskHeartbeatSpi.findOwnerUserId 比对
- 新增 TaskInterruptOwnershipTest 3 例,守卫测试扩到 6 例
2026-10-30 10:56:01 +08:00
huangzd1997 457af3607f feat(user-secret): 密钥设置支持 LLM 渠道与代理供应商切换
- 用户密钥新增 channel 列(V180):LLM 行存渠道 longtaitou/t8star,代理行存供应商
  qingguo/jikip;存量与新建默认均回填 t8star/jikip(默认仍走贞贞与极客,手动可切)
- 外观专利/货源查询按任务归属用户的密钥渠道路由 LLM 主机(渠道经 SecretUsageContext
  下到工作线程,不逐层改签名);切到龙抬头时模型映射 gemini-3.1-flash-lite 并补
  enable_thinking + thinking_budget=medium(对齐贞贞现网口径),检测链路刻意不思考
- 代理检测按供应商解析:青果 code 为字符串、隧道端点支持 域名:端口、
  NO_AVAILABLE_CHANNEL 归为可重试;青果只验提取成功(账密只在客户端本地)
- 密钥设置页:每个模块加渠道分段选择、代理卡加供应商选择与青果 Authkey/Authpwd
  (只存本机,不上报),切换渠道未重填密钥时拦住保存;换号继承带渠道与供应商
- 后管密钥管理三列显示渠道/供应商标签
2026-10-30 04:00:38 +08:00
huangzd1997 eaab173ae9 fix(collect-routing): 后端整量 5 处红收口(身份出口/归属棘轮/中文文案基线)
全量 mvn -o test 抓到 3 个测试类 5 处失败,均因本次恢复链引入:
- queue-payload 恢复时缺 resolveOwnershipUserId ⇒ 身份出口判红;接上会话出口后
  boundRead 分母 63→64(不是放宽,是新增一条已接出口的 handler)
- 恢复的本地激活在 TaskService 里手抄 !MODULE_TYPE.equals(...) ⇒ 手写归属文件数 15→16;
  改为复用底座 requireSubmissionTask(模块校验口径一致,棘轮不涨)
- 相似ASIN activate 新增「已切换后台自动执行」文案 ⇒ 中文出口 61→62(已在常量注释登记)

mvn -o test:5032 例 / 0 失败 / 0 错误 / 19 skipped。
2026-10-29 21:38:31 +08:00
huangzd1997 39c01ada44 feat(collect-routing): 专利/货源本地采集开关与 Linux 兜底窗口
外观专利与相似ASIN默认「本地采集」,由页面推本机客户端;本地推了没人领时
PENDING 超过 linux-fallback-minutes(默认 30 分钟)才允许 Linux 内部认领接管,
避免本地机全关时任务无限排队(PENDING 已不再按时间判死)。

- 新增 aiimage.collect-routing.local-enabled 与 GET /api/collect-routing
- 客户端兜底拉取只认本地模块;内部认领对本地模块按兜底窗口二次过滤
- 外观专利 activate 在本地模式下恢复 PENDING→RUNNING 条件更新(与认领互斥),
  关闭时保留后台拒绝语义;相似ASIN 关闭时明确拒绝「点启动」
- 恢复 GET /api/appearance-patent/tasks/{id}/queue-payload(本地推送取载荷用)
- /api/collect-routing 进用户态守卫名单,两处前缀计数基线 15→16 / 23→24
2026-10-29 20:27:53 +08:00
huangzd1997 8b7d5d4a40 fix(tasks): PENDING 排队不再按 2 小时判死,等客户端认领
PENDING 是排队态不是卡死态:单机串行跑大任务时队列等再久也必须保留,
按 updated_at 清杀会把排队任务误判成「长期未被领取」并连锁触发自动克隆重试,
同一份活被放大成多条失败记录(2026-10-28 现网 1514 行任务连续三代)。

判死巡检只留 SCHEDULED(到点未启动)与 RUNNING(心跳残留)两条;
排队任务一律等 TaskClientPullService 认领,页面放弃的解析预览也保留。
2026-10-29 19:19:21 +08:00
huangzd1997 217f5eec62 feat(phase-5): AC-19/AC-21 读路径时间窗与 keyset、心跳瘦读、菜单缓存、去 RAND、MDC 与补检限流
AC-19(P1-B1/B2/B3/B4)
- 任务中心(P1-B1):TaskCenterQueryService.tasks() 不带 startTime 时补 90 天默认窗口
  (startOfDefaultWindow),不再把 null 透传给 12 模块 UNION 扫全历史;selectTaskPage 的
  `LIMIT ? OFFSET ?` 改成 (createdAt,id) 游标,深翻页的 skip 挪进新语句
  selectTaskPageAnchor——它只投影 (id,createdAt) 两列。宽/窄两份 UNION 共用同一对筛选片段
  (taskFilterT/taskFilterB),锚点与页查询筛的行集在结构上不可能漂;页码语义、total、
  响应结构与前端全部不变。
- 关键词抽词(P1-B2):selectRandomUnused 不再 ORDER BY RAND()(全表 filesort)。
  服务层先 countHit 数命中集、再把窗口起点掷在 [0, total-limit],按 k.id 有序取一段后
  在内存洗牌。分布口径变了(连续 id 的一段 vs 逐行独立随机),已如实登记。
- 心跳(P1-B3):selectFileTask 只捞 id/moduleType/status/userId/updatedAt 五列;
  需要整实体的模块由新 SPI 默认方法 heartbeatNeedsFullTaskEntity()(默认 true=保守)
  声明后补一次主键读,collect-data/similar-asin/appearance-patent 三个只用
  task.getId() 的显式豁免。半行进 saveTaskCache 会写出坏缓存,比多读一次列难查得多。
  markInterrupted 改走整实体读(要 errorMessage 并同步模块缓存/快照)。
- 权限菜单(P1-B4):loadMenus 加 (companyId,menuType) 短 TTL(30s) 快照缓存,
  五处目录写路径 create/update/delete/reorder/copyTreeFromTemplate 全部写时失效;
  只缓存目录本体、不缓存用户授权行——撤权必须下一请求就生效。

AC-21(审计 §5/PERF §6)
- RequestTraceFilter 把已解析却只进日志参数的 requestId 写入 MDC(缺失写 "-"),
  finally 里 MDC.clear()(tomcat 线程复用,不清就把上一条的 id 带给下一条日志);
  logback-spring.xml 的两条 pattern 默认值 + application.yml 显式设的 file/console
  两条同批改带 [%X{requestId}]——本文件那两条会盖掉默认值,漏一处线上照样看不见。
- AppearancePatentDeliverySupport.requestRecheckForMissingRows 的补检轮 WARN 按任务限流:
  5 分钟窗口内首条 WARN(带 suppressedInLastWindow 汇总),其余降 DEBUG。刻意不吃
  recheckRounds/countRecheckRound 那对轮次计数——那是 scheduleFallbackRecheck 的补检预算,
  从日志路径再计一次会让"限流"吃掉业务预算、任务更早被判补检耗尽。
  "补检排不上队"那条不受限流(要人处置的信号不许压)。

契约激活与判据变更
- PendingPhase5ReadPathTest 5 例、PendingPhase5LogVolumeAndMdcTest 3 例全部去 @Disabled 转绿;
  后者预置的 logback 路径层级写错(mainSourcesRoot() 已是 src/main/java),激活时修正,
  并补一条 application.yml 的 pattern 判据(只增不减)。
- 新增 AppearancePatentRecheckWarnThrottleTest 3 例:钉实跑读数(6 轮只留 1 条 WARN + 5 条
  DEBUG、按任务隔离、排不上队仍出声),形状尺子之外的行为证据。
- TaskCenterQueryMapperSqlTest +2 例(锚点窄投影、游标收窄两分支)、
  TaskCenterQueryServiceTest +3 例(默认窗口、第一页不付锚点钱、页码越界返回空页)。
- 三处既有判据按新契约反转,一支没注释掉:selectTaskPage 的 `LIMIT ? OFFSET ?`→游标、
  分页参数绑定数 2→1/16→18/8→7;tasks() 三处 isNull()→notNull()(默认窗口生效本身成为断言)。
- 棘轮登记:SQL 分层语句总数 143→144(新语句点名),MigratedSqlEquivalenceTest
  XML_SELECT_TOTAL 99→100、LEDGER_ROWS 85→84、LEDGER_SELECTS 60→59——
  selectTaskPage 那一行整条摘出基准账本并点名进 NOT_MIGRATED,因为基准是"搬迁前的注解原文",
  改写它等于让等价性测试替新 SQL 背书。
- application.yml 走 hash-object+update-index 只提交本轮 pattern 那一格(4/2),
  另一路会话在飞的 client-task-pull 注释格原样留在工作树未提交。

读数:后端 mvn -o test 5,021 例/0 Failures/0 Errors/19 skipped(6:21 min,
较 Phase 4 的 5,013 净增 8 例=激活 8 例预置后新增 8 例判据);fat jar 实起,落盘行带出
`[main] INFO  [] c.nanri.aiimage.AiImageApplication - Starting...` 证明 MDC 位真在渲染;
本机无 MySQL ⇒ Hikari 反复 Starting、Tomcat 未监听,请求级 requestId 关联与现网四样本顺延 Phase 6。
2026-10-29 16:32:46 +08:00
huangzd1997 ef0bc51fa2 fix(phase-4): 分片通道两处界面文案过全仓尺子(英文原文只进日志)
`new BusinessException("初始化分片上传失败:" + ex.getMessage())` 与
`"拼装安装包失败:" + ex.getMessage()` 把底层磁盘/IO 的英文原文直接交给界面,
撞上全仓尺子 RawExceptionMessageSinkGuardTest(起因是 2026-10-09 那张货源查询截图:
卡片上的英文不是写错的文案,而是 error_message 里的异常原文)。两处改走
`UserMessages.with(中文主干, ex)`:详情是中文才拼接、英文丢弃,同时各补一行 WARN
把根因留在日志里(界面看不到,运维要找得到)。

为什么后端全量补跑才暴露:四面闸门的后端格是"按类点名"的格子册,
RawExceptionMessageGuardTest 不在册 ⇒ full 档绿也不等于整量绿,本笔由 `mvn -o test`
整量兜住(Tests run 5013/Failures 0/Errors 0/Skipped 27,8:26 min)。

复跑:RawExceptionMessageSinkGuardTest 2 例、UserFacingMessageChineseGuardTest 2 例、
ChunkedUploadServiceTest 8 例、WorkbenchClientPackageServiceTest 21 例、
CatchSilenceRatchetTest 9 例(catch 分类仍是 RETHROW,四数一格没动)全绿。
2026-10-29 14:15:52 +08:00
huangzd1997 0586df2df0 feat(phase-4): AC-16/17/18 前端登录态与分片上传、后管包体与竞态门
AC-16(S1-F1/S1-F2)
- frontend-vue ensureAuth:清态前先判 isAuthError——弱网/超时/5xx 不再把人踢回登录页;
  http.ts 的 onResponseRejected 给错误打鉴权标记(HTTP 401 与业务 401/4011 都算),
  纯网络错误保留底层文案供调用方区分"断网"与"掉登录";clearLocalSession 导出复用。
- admin 全局错误兜底:main.ts 装 app.config.errorHandler(首屏就崩也接得住),
  window error / unhandledrejection 由 App.vue setup 调 useGlobalErrorReporting() 接线,
  卸载出口在 onBeforeUnmount 摘监听与提示定时器(后管的 timer-cleanup-pairing 尺子要求
  "注册点所在文件找得回反注册 + 卸载钩子",故接线必须在组件作用域,不在 main.ts)。
  上报体只带 kind/message/stack/route/ts 并过脱敏(Bearer、JWT 三段式、query 里疑似
  token/key/secret 的取值一律打码),凭据零容忍;服务端新增
  /api/admin/client-errors(requireAdmin,字段截断 2000 后 WARN 落日志,不落库)。

AC-17(S1-F3)
- 后端新增分片通道 ChunkedUploadService(init/part/status/complete/abort):8MB/片、
  同片重复上传幂等覆盖、流式拼装复算 sha256、超限与缺片直接拒绝、24h 过期回收;
  FileUploadController 暴露 /api/files/chunk/**,LocalFileStorageService 加
  saveTempFileFromFile(同一套扩展名黑名单与 fileKey 索引);三键显式写进 application.yml
  (不进"只在代码默认值里"的名单)。
- 工作台安装包 93MB:WorkbenchClientPackageService 走同一分片通道转存 client 桶
  (objectKey 写进会话 purpose,拼装时逐字匹配,防借分片接口覆盖已发布包),
  confirm 失败带 cleanupUnconfirmedObject 补偿清理未登记对象;后管 ≤64MB 仍直传预签名 PUT。
- 用户端 upload.ts:大文件分片 + 逐片重试 + 进度回调,超时按体积给(不再固定 120s);
  断点探测失败不再静默按"全缺"重传(catch-silence 棘轮因此一格没涨,blocks 300→301 已记名)。

AC-18(P1-F1/P1-F2/P1-F4/S1-F4)
- 后管 manualChunks 摘掉 element-plus(按需引入已在 src/plugins/element.ts 生效):
  实测构建产物已无 element-plus 独立 chunk,index.html 只 modulepreload vue 块。
- UsersPage/DeviceLogsPage 接 createLatestRequestGate,旧响应不再覆盖新页;
  用户端新增 useServerTablePaging(只驻留当前页 + 自带竞态门 + 失败给原因),
  挂载用例 3 例钉住"翻页重取/旧响应作废/失败可见"。
- DeliveryVideoWorkspace 两处轮询接 document.visibilityState,隐藏标签页暂停。

激活 Phase 0 预置契约 7 例(用户端 5 + 后管 5,共 12 例;其中 AC-16 后管两支按"接线在组件作用域"
的口径改写并把判据加强到反注册配对 + 根组件接线,见蓝图 §5)。
门禁读数:后端 mvn -o test-compile rc=0,CatchSilenceRatchetTest 9 例绿(total 1034→1045、
notRethrow 585→591、logOnly 182→188 逐处记名,EMPTY 未涨)、ChunkedUploadServiceTest 8 例、
WorkbenchClientPackageServiceTest 21 例、ClientErrorReportControllerTest 4 例;后管 1848 例 +
mount 33 例 + vue-tsc + build 全绿;用户端 955 例 + mount 30 例 + vue-tsc + build 全绿。
真机:OssWorkbenchClientLiveVerificationTest 以线上 MinIO 实测 PUT→stat→sha256→presign→删除
全链 1 例绿(凭据只走环境变量,不落任何文件)。

⚠ 按 pathspec 只圈本轮文件:application.yml 用索引手术只提交分片三键那一格,他人
「PENDING 不再按 2 小时判死」的 StaleTaskRepairService/ClientTaskPullSpi/application.yml
注释件与 useLiveTaskBoard/BrandAppearancePatentTab/task-delete-target 四件在飞改动
原样留在工作树未提交。
2026-10-29 13:47:21 +08:00
huangzd1997 62a1b50067 feat(phase-3): AC-9~12 后端任务引擎稳定性(队列隔离/心跳降级/清理瘦投影/终态与超时)
- AC-9(S1-B2/B3):视频/图像任务改走独立 videoQueueExecutor(aiimage.task-queue.video-max-concurrent,
  默认 6),不再与结果文件组装共用 12 格 taskQueueExecutor;TaskQueueGate 增 queue 标签区分指标;
  scheduled worker 本地派发被拒改回队(requeue),不再压回 16 线程调度池内联组装。
- AC-10(S1-B4):CollectDataService.updateProgress 去掉任务锁,改无条件短事务 + updated_at 乐观 CAS,
  只写 result_json/updated_at 两列;TaskHeartbeatService 对 SPI 进度写异常降级,
  TaskHeartbeatVo 新增 progressDegraded/warning,alive 仍为 true。
- AC-11(S1-B5/B6):ModuleHistoryCleanupService 批查与四路指针查询全部瘦投影;
  application.yml 增 server.shutdown=graceful 与 spring.lifecycle.timeout-per-shutdown-phase=30s;
  虚拟线程池 destroy 改为 await 在途任务(上限 aiimage.task-queue.shutdown-await-seconds)。
- AC-12(S1-B1/B7/B8/B9):PENDING 僵尸重试计数可到 MAX 并就地翻 FAILED 进 exhaustedJobs;
  修正 selectAdminTaskDetail 的双转义(&amp;gt;= -> &gt;=)并按真实 SQL 修正迁移基准账本;
  MyBatis default-statement-timeout=60s(AIIMAGE_DB_DEFAULT_STATEMENT_TIMEOUT_SECONDS);
  店铺数据两处删除收进 @Transactional,对象回收沿用 afterCommit 注册。
- 契约激活:PendingPhase3*Test 14 例全部去 @Disabled;同步改写被新契约反转的既有判据
  (CollectDataProgressThrottleTest 锁/updateById 口径、OwnerRouting 的内联分支改显式关闭派发形态、
  FaultInjection 指标按新 queue 标签查找)与三处棘轮(catch total 1031->1034、
  notRethrow 582->585、超管调用点 17->18,均逐条记名)。
2026-10-28 21:05:33 +08:00
huangzd1997 c4fc9784e8 feat(collect-data): 结果 Excel 追加「被过滤明细」sheet,品牌检测失败原因可见
task 32573 回传 600 行只留 1 行,被砍掉的 599 行在系统里只剩四个计数,
谁都答不出「是哪些 ASIN、死在哪一道」。四类被过滤行现在于提交时当场
逐行落库(V179 biz_collectdata_filtered_row),结果 Excel 追加第 3 个
sheet 供逐行对账。不在装配期回读 chunk 重判——去重库与无效品牌库读的
都是当前态,任务窗口期的写入会让判定漂移(错标/漏标/分类串台),
依据逐条写在 V179 头注释里。

同批:brandQueryFailedCount 与原因进历史 VO 和任务卡片;损耗通知不再对
「未配置代理」的用户承诺稍后重跑——补测队列两轮 21/21、28/28 全败、净增
0 行,那句是谎。

台账:XML_STATEMENT_TOTAL 141→143(新 mapper 两条写侧语句);静默 catch
棘轮 total 1028→1031、不重抛 579→582、只 log 181→182(三枚审计件容错,
逐处记名于 CatchSilenceRatchetTest 上方注释)。
2026-10-28 19:31:50 +08:00
huangzd1997 0e2af88184 feat(phase-1): AC-7 数据读取按归属收口、AC-8 匿名写端点要凭据
清空全部历史(ImageHistoryController/Service)不再接受请求参数里的
user_id 当归属:改走 DataReadScope.readScope(...).userIdsOr(),scope 为空
集时 service 直接 log.warn + return 0,绝不退化成"不筛=全库"。每日档下载
(AdminShopDataCrawlTasksController/ShopDataCrawlAdminTasksService)同样按
可见店铺 key 校验,越权回 BusinessException(403) 而非静默返回别人的文件。

AdminApiGuardFilter 新增 CREDENTIALED_WRITE_PATHS:/api/files/upload 与
/api/tasks/{id}/interrupted 这两个此前带 X-Internal-Token 即可匿名的写端点
改为解析不出身份即 401——静态共享密钥能证明走了内部通道,证明不了是谁。
该判定不吃 user-tool-guard-enabled 总闸,纯令牌存量客户端行为不变。

激活 Phase 0 预置的 3 支 pending 契约(AnonymousWriteGuard / HistoryClearScope /
DailyFileOwnership,去 @Disabled),另补 ImageHistoryServiceTest 迁移 + 2 例、
ShopDataCrawlAdminTasksDailyFileOwnershipTest 6 例行为判据。目标 127 例 0 失败。

他人的 collectdata in-flight 改动(CollectDataService/CollectDataHistoryItemVo/
BrandCollectDataTab/collect-data.ts 等)未卷入本提交。
2026-10-28 17:03:24 +08:00
huangzd1997 b3d90d2161 fix(collect-data): 进度节流不再借道 updated_at 计时,终态用 summaries 校正
心跳层的 updated_at 检查点在本模块 SPI 之前就把该字段刷成 now,而节流窗口
又拿它当锚点——每条心跳都被自己刚写下去的时间戳合并掉。现网 task 32573:
7 个关键词全部跑完、61 个分片全部回传,processedRows 恒 0,用户端卡片于是
写着「关键词缺口:任务提前结束于 0/7,还有 7 个关键词未采集」,把已完成的任务
报成漏采。节流锚点改为服务内按 taskId 键控的上一次进度落库时刻,只在 UPDATE
成功后推进、任务离 RUNNING 时回收;不塞进 result_json,否则那份 JSON 含墙上
时钟就永久不可复现(快照测试 submit_result_snapshot_is_reproducible 钉的就是它)。

客户端 post_result 不带 current/total,旁路心跳一旦整轮不落地就没有终态进度可用。
summaries 与 processed_items 在客户端成对推进(search_task.py:660-661),条数即
真实已处理关键词数,据此在收尾时校正 processedRows:只抬不砍、不越过 totalRows,
task 31253 那种「8 行只跑 2 个关键词」必须继续显示 2/8。

同一张卡片上 invalidFilteredCount 一会儿叫「不符合 ASIN 过滤」一会儿叫「无效品牌」,
而它是品牌黑名单命中的行数,与用户的 ASIN 筛选条件无关,统一为「无效品牌过滤」。

6 条旧节流用例靠手工摆 updated_at 让窗口到期,锚点一换必然失效,改为
expireProgressWindow(service, task)。它们在 setUp 里把节流设成 0,从未覆盖过
生产默认 15000——这也是这个 bug 能藏到现网的原因之一。
2026-10-28 15:29:06 +08:00
huangzd1997 632efa6a8e test(phase-0): v1.1 验收契约预置(AC-7~12/16~19)与两处棘轮台账登记
后端 9 支 @Disabled 契约只引用现存签名(mvn -o test-compile rc=0),逐条
钉住审计 ✅ 缺口:清空全表删、每日档按 id 越权、出厂默认下匿名可写的
interrupted/upload、12 格共享执行器与拒绝即内联、心跳抢锁变 40902、
批查整实体与无优雅停机、PENDING 被 Math.min(4) 钉死永不终态、
视频详情 SQL 双转义、无 statement timeout、删除多写无事务、
深 OFFSET/ORDER BY RAND/心跳整行/菜单每请求重算、补检 WARN 风暴与无 MDC。

两前端 3 支用 { skip } 预置 AC-16/17/18(网络错误登出、全局兜底与脱敏
上报、单次 PUT 无分片、element-plus 回首屏、列表无竞态门)。

台账两处按官方口径重钉,非放宽:source-pin-ledger 用仓内
UPDATE_SOURCE_PIN_BASELINE=1 生成(含他人 3 支零钉子件记账);
SourceScanTest 点名台账 10→22 名/8→16 支,逐个出处写在注释里。
2026-10-28 14:37:17 +08:00
huangzd1997 46774fffed perf(similar-asin): 缺图逐格告警降为 DEBUG,避免单任务万条 WARN 阻塞日志队列 2026-10-28 12:09:09 +08:00
huangzd1997 437d75db52 docs(gate): 重钉静默 catch 棘轮 total 1026→1028/不重抛 577→579(B49 非 ★ 收尾第二批)
两处新增都是 log.warn+计数+continue 的逐批/逐条目容错(QueryAsinService.flushInsert、
DedupeRunService.packageFolderDedupeResultsAsZip),逐处记名写在常量上方;
rethrow 393/logOnly 181/empty 56 三格未动。实测由 SilentCatchScanner 在同一棵树跑出,
不是估的。
2026-10-27 16:10:48 +08:00
huangzd1997 88d737a7f0 fix(tasks): 批量入库与 folder 去重逐条容错,发布文案不说谎
B49/B50 收尾三处当时被标"非 ★"跳过的同类缺陷。判据同一条:一颗坏项不许让
其余项一起不干活,也不许把"根本没拿到数据"说成"数据正常"。

1) shopkey/service/QueryAsinService.java(B49 #6,flushInsert:843-844)
   复验为真:整张表共用一条读行循环,某一批 insertBatch 抛出即冒到
   runImportTask 的 catch,后面的批次一个都跑不到、内存里的余行一起丢。
   审计里"报数虚高"那条已被复验否掉(原状下坏批计数确实不外发),本笔不按
   那个理由改;但逐批容错之后坏批计数会随后续进度外发,所以必须按"没落库"
   回退:insertedCount 扣回、skippedCount 记上、坏批点名进日志与 errorMessage。
   收尾新增 failIfBatchesLost():有坏批就让导入落"失败"态并报出缺口行数——
   admin 侧只在 failed 分支显示 errorMessage(QueryAsinPage.vue:260-271),
   留在 success 上等于把没入库的行说成导入完成。重传整表是安全的:已入库行
   会被 rowSignature 认成重复跳过。
   processImportFile 由 private 收到包级作测试接缝(形状同 tryAcquireFileSlot)。
   该 importer 此前零夹具,新建 3 例(真 xlsx + 真 ExcelStreamReader)。

2) dedupe/service/DedupeRunService.java(B49 #4 的 folder 分支)
   只在 folder 模式成立:逐文件清洗结果只落本地临时目录,唯一交付物是那个
   ZIP。两颗坏项会带走整批——① 收尾的 aborted 判定排在打包之前,一个 worker
   线程级异常就让打包整步跳过;② 打包循环里一个条目读不到/条目名相撞就整包
   作废。现改为 folder 分支先打包再判 aborted,打包逐条目容错并点名跳过;
   一个都没写进去时拒绝交空包(那才是"根本没拿到数据")。aborted 仍照旧把
   终态落 FAILED,不拿部分交付冒充全量成功;缺口写在交付条目与日志上,
   不写 file_task.error_message。非 folder 分支一个字节没动。
   DedupeArchiveEntry 与打包方法收到包级作测试接缝。新建 3 例,含一支用
   同线程执行器让第 2 个 worker 当场线程级异常的真链路用例。

3) publish/service/PublishTaskService.java(B49 #7/B50 #4,607-609)
   按上一轮复验结论只改文案,不动状态语义:逐文件 status/VO 本来就交付了。
   会说谎的地方是 publishResultFile(..., preserveFailure=false) 把结果行
   error_message 洗成 null,"N 个文件没进这张表"在文案层等于全部成功。
   缺口写在 biz_file_result.error_message(本仓既有"部分交付"载体:
   ShopMatch:825/PriceTrack:905/ProductRisk:827 都按它判 partialFailure;
   publish 侧只有 toResultVo:1216 读它,纯展示,fileReady 由 success+url 推导
   不受影响)。SUCCESS 的 file_task.error_message 继续留空并就地写明理由:
   TaskRetryEligibility.forceMajeureCategory 与 SimilarAsinStaleReopenSupport
   .isStaleFailure 都按那段文字做字面量分类,写进去会喂错 stale/重开/续跑判据。
   文案两个方向都不说谎:说清"只含成功处理的 X 个、另有 N 个未纳入(点名)",
   并明写"不是表格格式问题、可只重新提交这些文件",不把可恢复失败推给表格。
   新建 2 例(含反向钉:全成功时不得凭空造缺口文案)。

实测:mvn -o test-compile rc=0;新增 8 例改前 6 红(QueryAsin 2 红=原始
RuntimeException 直接冒出、批次被提前收走;Dedupe 3 红="Wanted but not
invoked: fileResultMapper.insert"+整包作废;Publish 1 红=errorMessage 恒
null),改后 8/8 绿;相邻既有 9 支类 97 例全绿(PublishTaskServiceTest 33、
DedupeRunProgressResumeTest 14、PublishFileLevelStatusTest 8、
PublishResultFileJobHandlerTest 8、DedupeRunServiceCleanRulesTest 9、
DedupeRunServiceFileSlotTest 2、QueryAsinResolveServiceTest 13 等)。

CatchSilenceRatchetTest 按预期判红(本笔新增 2 处 catch,均在被禁改的共享台账
里,合并时由主线程统一重钉):实测 total=1028(基线 1026)、
notRethrow(incl logOnly)=579(基线 577)、logOnly=181(不变)、
rethrow=393(不变)、empty=56(不变)。
2026-10-27 16:03:37 +08:00
huangzd1997 e08b5369d7 fix(appearance-patent): 上游余额欠费即判任务终态,停止为空转的行烧出口
B46 那一笔(f3445c21)只做到「行级一次就停、归因写对」:撞上上游 403
insufficient_user_quota 后不再跑满 3 次重试,任务本身仍停在 RUNNING/WAIT_LLM
等 Python 继续回传分片。采集端(maixiang ap_worker)只看 /task/heartbeat 的
alive,读不到终态就继续为剩下的行按次付费买出口 IP——而那些行永远进不了 LLM,
钱白花。这一笔补上 Java 侧缺的那半步:欠费即把任务落终态 FAILED,心跳随即
回 alive=false,worker 下一跳收手。

- 判据只认 TaskRetryEligibility 的 BALANCE 类(欠费 + 密钥失效),复用现成分类器
  而非再抄一份字面量表;连接不可达 / 5xx / 429 / 抓取缺口一律照旧继续或按已有
  结果交付,判宽了就是拿用户整单给一次网络抖动陪葬。
- 停手点放在批管线的作业执行线程(LLM 批次就在这里跑),不在心跳线程;识别到
  欠费即停止后续批次,并回调宿主落终态(FileTaskMapper 与收尾口径在宿主手里)。
- 写终态前重读库里现状态:已 SUCCESS/COMPLETED/CANCELLED/FAILED 的一律不动,
  因此可重入,多入口命中也只写一次。
- 终态文案 = 生产者原文(客户端欠费归因 + 上游 lastErr)+ 可执行动作,原文一个
  字都不重写;不出现「请稍后重试」,不把欠费说成临时抖动。
2026-10-27 16:03:35 +08:00
huangzd1997 07f973d9df fix(tasks): 单片/单文件读不到跳过它,缺数据不许冒充已收齐
三处"一颗坏项拖垮整批"与一处假绿本体:

- BrandTaskStorageService:一片载荷读不到就整份聚合丢掉,而三个调用方
  (finalizeTask/abort/tryRecoverCompletedRunningTask)都没有就地 try;改逐片跳过长
  WARN,并把 receivedChunkCount/completed 的判据从 chunks.size()(DB 行数)改成
  真正读到的片数——拿行数比 chunkTotal 正是"118/119 行没数据仍判已完成"的形状;
  解析缓存与汇总状态两处同型"整批抛出"一并改成逐条跳过。
- AppearancePatentLlmBatchPipeline:候选收集跑在批循环之前,一抛就走不到循环体内
  那道 finally releaseRowInspection,本轮已申领的行要挂满处理中 TTL(15 分钟),
  且 terminalizeRoundExhaustedRows 跟着不执行(轮次到顶的行因此永不判死);改逐片容错。
- TransientPayloadStorageService:跨实例判据枚成 public 常量并提供 cause 链走法。
  resolvePayload 会把真实原因 rewrap 成「<errorMessage>: <pointer>」,消费端只摸顶层
  消息时「only exists on instance=」「does not exist」两处判定恒 false——跨实例留痕
  从未下过笔、"跳过该分片"分支是死代码。消费端(ChunkPayloadSupport/
  HistoryAssembler/ResultRowReader)全部改走共享常量+cause 链。
- SimilarAsinHistoryAssemblerTest 的假绿桩删除:改前它桩的是生产者早已不再产出的
  英文旧串,断言照旧绿;现在跑真实 resolvePayload 取异常(只 mock RustFS 边界),
  改前 15 跑 1 红、改后 15/15 绿。
- SimilarAsinStaleReopenSupport:客户端卡死尾句枚成常量、整句文案唯一出口,生产者
  与重开白名单共用;此前只是碰巧被前缀命中,生产者一改前缀就会"永不重开"。
2026-10-27 15:09:41 +08:00
huangzd1997 f3445c21c8 fix(llm): 余额耗尽按「余额欠费」归因且不再重试进冷却
- 新增 LlmBalanceGuard:识别 insufficient_user_quota 等上游余额/额度字样
- SimilarAsin/AppearancePatent 客户端命中后一次就停,不落进不可达/冷却分支
- 单测:识别口径 3 例 + 两客户端各 1 例(只发 1 次、文案含余额欠费)
2026-10-27 10:04:03 +08:00
huangzd1997 e0abd33ed4 feat(keyword-share): 新增客户端批量同步端点,保住真实使用人/时间与四级类目
工作台「关键词使用记录」与后台管理对不上,根因不是链路不通(后台现存词 426
与桌面 426 逐字相等),而是「谁、何时」两个字段在推拉两个方向上各丢一次:

- 推:markInternal 把 user_name/used_time 硬写成 token 账号与服务器此刻,
  历史使用记录推上去一律变成「同步账号 + 同步那一刻」;
- 拉:selectRows/selectRandomUnused 投影 u.user_name,而 VO 属性叫 usedUser,
  驼峰映射只会认成不存在的 userName ⇒ GET /keywords 的 usedUser 恒为 null;
- 词本体:add() 从不写四级类目,且 keyword_share 侧只有 INSERT IGNORE、
  没有任何 UPSERT,重复词静默 no-op。

处置:
- 修 used_user 别名(两处投影);
- 新增 KeywordShareMapper#upsertBatchFromSync,类目/chinese 按
  COALESCE(NULLIF(VALUES(x),''),x) 非空才覆盖,更新分支不碰 user_name/add_time
  (那是历史归属,不由同步改写);
- 新增 POST /api/keyword-share/sync/import:每行携带 usedUser/usedTime,
  绕开 markInternal 复用现成 KeywordUsageMapper#upsertBatch(本就是 =VALUES(...)),
  不改表结构、不加 Flyway 迁移;
- used 取三态:null=不改动使用状态。按 false 处理会让「只同步词库」的一次
  调用把后台已有使用记录整批删掉;
- 共享 API 账号下的归属失真用服务端名单收口:命中 aiimage.keyword-share-sync
  .used-users 才按姓名落库且落名单里那份写法(全/半角括号归一,否则同一人被
  后管拆成两个使用者);strict 默认 false,名单未填时放行并计 usedUserUnknown,
  避免首次上线把全部记录静默改写成账号名。

顺带:CatchSilenceRatchetTest 要求新增 catch 必须同批净减,而宽松时间解析需要
try/catch ⇒ 把 ShopDataCrawlAdminTasksService 已有的同形状实现抽成
common/support/LooseLocalDateTimeParser 两处共用,净新增 catch 为 0,未放宽基线。

尺子:XML_STATEMENT_TOTAL 140→141,NOT_MIGRATED 点名新 insert(非 select,
XML_SELECT_TOTAL 不动)。

验证:mvn -o test-compile rc=0;后端整面 mvn -o test 4892 passed/0 failed/18 skipped。
本机无 MySQL,端到端未跑,真链路待客户端联调(ops BACKLOG B44)。
2026-10-26 19:17:26 +08:00
huangzd1997 b8abdc1eec test(guard): 超管出口调用点登记 17 处
UserSecretUsageService 新增业务调用后阈值未同步,全量套件此前为红;
登记为 16 个业务调用方 + DataReadScope 包装体。
2026-10-26 15:13:49 +08:00
huangzd1997 915a573439 fix(auth): 登录不再推进会话世代,支持同账号多端同时在线
产品定档同账号可多端同时在线:登录 +1 会让每次登录都吊销其他端 token。
- 移除登录路径的 session_epoch 自增;登出仍原子 +1 吊销全部旧令牌
- 改密补 session_epoch +1,避免旧 token 继续用到 7 天 TTL
- 单设备开关仍可按 machine 顶下线(现网默认关闭)
2026-10-26 15:13:43 +08:00
huangzd1997 2163c6b585 fix(workbench-client): 上传强校验纯数字版本并归一化存量 v 前缀
客户端按 x.y.z 逐段比较,v1.0.112 会被严格解析器判非法,检查更新永远回「已是最新」。
- presign/confirm 只接受 ^\d+\.\d+\.\d+$,带 v 前缀、两段或后缀直接拒绝
- V178 剥离存量 v/V 前缀,冲突时中止迁移
- 后管上传表单同步校验并提示格式
2026-10-26 15:13:36 +08:00