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)。
This commit is contained in:
2026-10-31 12:33:09 +08:00
parent 7459177bb4
commit 7469c710d7
25 changed files with 400 additions and 131 deletions
@@ -17,10 +17,8 @@ AIIMAGE_COST_GUARD_LLM_WINDOW_TOKENS_THRESHOLD=600000
AIIMAGE_COST_GUARD_PLATFORM_PROXY_DAILY_THRESHOLD=2000
AIIMAGE_COST_GUARD_SHARED_ACCOUNTS_THRESHOLD=3
# 采集执行方路由:专利/货源默认本地采集;关掉则只由 Linux 后台执行。
# 本地采集的任务 PENDING 超过该分钟数还没被客户端领走,才允许 Linux 兜底。
AIIMAGE_COLLECT_LOCAL_APPEARANCE_PATENT=true
AIIMAGE_COLLECT_LOCAL_SIMILAR_ASIN=true
# 采集执行通道:由建单时界面单选(biz_file_task.collect_channel,V183),不再有全局开关。
# 本机通道的任务 PENDING 超过该分钟数还没被客户端领走,才允许 Linux 兜底。
AIIMAGE_COLLECT_LINUX_FALLBACK_MINUTES=30
AIIMAGE_DB_URL=jdbc:mysql://127.0.0.1:3306/aiimage?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai&useSSL=false
@@ -390,9 +390,6 @@ aiimage:
# 关掉某模块=该模块只由 Linux 后台执行,页面不再推送。未登记的模块按「非本地」处理,
# 保持内部认领原有的 internal-min-pending-minutes,不被卷进本地优先。
collect-routing:
local-enabled:
APPEARANCE_PATENT: ${AIIMAGE_COLLECT_LOCAL_APPEARANCE_PATENT:true}
SIMILAR_ASIN: ${AIIMAGE_COLLECT_LOCAL_SIMILAR_ASIN:true}
linux-fallback-minutes: ${AIIMAGE_COLLECT_LINUX_FALLBACK_MINUTES:30}
# 客户端兜底拉取:页面没推送成功(只解析没点启动 / 推送前关页面 / 纯浏览器打开)、
# 长期停在 PENDING 的任务由在线客户端领走执行。2026-10-29 起 PENDING 不再按 2 小时判死
@@ -0,0 +1,24 @@
-- V183: 任务级采集执行通道(本地采集 / 线上采集)
--
-- 背景(2026-10-31 用户拍板):
-- 「这一单在用户自己机器上采,还是交给 Linux/外机 Windows 采」原先只有**全局** yml
-- `aiimage.collect-routing.local-enabled` 一档,一台服务器一个值,所有账号被捆在一起:
-- 本地机器开着的用户被迫走线上,Linux 兜底在跑的用户也没法把某一单留在本机。
-- 现在改成建单时由界面单选框决定,默认本机。
--
-- 设计口径:
-- * 可空:NULL=「这一单没登记通道」,由 `CollectChannel.defaultFor(moduleType)` 兜,
-- 外观专利/相似ASIN 读作 LOCAL、其余模块读作非本地——与 V183 之前出厂值
-- (`AIIMAGE_COLLECT_LOCAL_APPEARANCE_PATENT/SIMILAR_ASIN:true`)逐字等价,
-- 所以历史行与未升级客户端的行为不变,不需要回填;
-- * 不加索引:两条认领查询本来就按 (user_id|status, module_type, created_at) 收口,
-- 通道是在已筛出的候选上判定的(量级 = 单轮 limit),加列只为语义显式,不为加速;
-- * 不动 `linux-fallback-minutes`:它管的是「本地机没开时别让单子饿死」的兜底窗口,
-- 与「这一单选谁」是两件事,不能一起删。
--
-- 回滚(手工):
-- ALTER TABLE `biz_file_task` DROP COLUMN `collect_channel`;
ALTER TABLE `biz_file_task`
ADD COLUMN `collect_channel` VARCHAR(16) NULL
COMMENT '采集执行通道:LOCAL=本机客户端采/ONLINE=Linux 或外机 Windows;空=按模块默认' AFTER `task_mode`;