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
@@ -30,4 +30,11 @@ public class AppearancePatentParseRequest {
@JsonAlias({"apiKey"})
@Schema(description = "调用 LLM API 的任务级密钥。非必填;为空时后端按用户密钥配置兜底。")
private String apiKey;
@JsonProperty("collect_channel")
@JsonAlias({"collectChannel"})
@Schema(description = "这一单的采集执行通道:LOCAL=本机客户端采,ONLINE=Linux 或外机 Windows。"
+ "非必填;留空或不可识别的值按模块默认执行(外观专利默认 LOCAL),与未升级前端的行为一致。",
example = "LOCAL", allowableValues = {"LOCAL", "ONLINE"})
private String collectChannel;
}
@@ -212,10 +212,12 @@ public class AppearancePatentTaskService extends AbstractFileTaskPipeline<Appear
throw new com.nanri.aiimage.common.exception.BusinessException(com.nanri.aiimage.modules
.usersecret.service.UserTaskGuardService.PAUSED_MESSAGE);
}
// 2026-10-29 本地采集开关:开着就恢复「页面推本地客户端」的启动语义;
// 关着走原后台语义(记录支持里对 PENDING 明确报「已切换后台自动执行」)。
if (collectRoutingProperties != null
&& collectRoutingProperties.isLocal(com.nanri.aiimage.config.CollectRoutingProperties.MODULE_APPEARANCE_PATENT)) {
// 执行方由这一单的通道决定(V183 collect_channel,建单时界面单选,默认本机):
// LOCAL 恢复「页面推本地客户端」的启动语义;ONLINE 走原后台语义(记录支持里对 PENDING
// 明确报「已切换后台自动执行」),任务留在 PENDING 等 Linux/外机认领。
FileTaskEntity channelTask = requireSubmissionTask(taskId);
if (com.nanri.aiimage.modules.task.model.CollectChannel
.resolve(channelTask.getCollectChannel(), channelTask.getModuleType()).isLocal()) {
activateForLocalClient(taskId, userId);
return;
}
@@ -194,6 +194,9 @@ public final class AppearancePatentParsePipeline {
FileTaskEntity task = headerFactory.create(TaskStatuses.FileTask.PENDING, "PYTHON_QUEUE", request.getUserId(), deviceId,
sourceFiles.size());
// 执行方在这一单选(界面 LOCAL/ONLINE 单选框,V183);未登记=按模块默认,历史行为不变。
task.setCollectChannel(com.nanri.aiimage.modules.task.model.CollectChannel
.persistedValue(request.getCollectChannel()));
task.setSuccessFileCount(0);
task.setFailedFileCount(0);
task.setRequestJson(jsonWriter.write(request, "序列化解析结果失败"));