外观专利转 Linux 后台主力执行:activate 不再推送客户端浏览器

- activateTask 改为状态校验:PENDING 保持等 Linux 内部认领,旧前端点启动给出明确提示并中止入队,任务不会重复执行
- 内部认领新增独立等待窗口 internal-min-pending-minutes(默认2分钟),任务创建后快速自动开始
- 客户端兜底拉取默认白名单移除 APPEARANCE_PATENT,防止未来误开时客户端抢抓
- 前端「启动」按钮改「提交后台执行」:不再 enqueue_json 推客户端队列,直接进入轮询
This commit is contained in:
2026-09-30 13:41:26 +08:00
parent 27a7cd0f82
commit f4be12c5f9
4 changed files with 35 additions and 97 deletions
@@ -287,22 +287,19 @@ public class AppearancePatentTaskService {
if (task == null || !MODULE_TYPE.equals(task.getModuleType()) || userId != null && !Objects.equals(userId, task.getUserId())) {
throw new BusinessException("任务不存在");
}
ensureTaskOwnedByCurrentInstance(task, "activate");
// 只允许 PENDING→RUNNING(条件更新):与客户端「兜底拉取」的原子认领互斥,
// 谁先翻转谁执行,避免页面与客户端重复执行同一任务
int updated = fileTaskMapper.update(null, new LambdaUpdateWrapper<FileTaskEntity>()
.eq(FileTaskEntity::getId, taskId)
.eq(FileTaskEntity::getStatus, STATUS_PENDING)
.set(FileTaskEntity::getStatus, STATUS_RUNNING)
.set(FileTaskEntity::getUpdatedAt, LocalDateTime.now()));
if (updated == 0) {
FileTaskEntity latest = fileTaskMapper.selectById(taskId);
if (latest != null && STATUS_RUNNING.equals(latest.getStatus())) {
throw new BusinessException("任务已在执行中(可能已由客户端自动接管),无需重复启动");
}
throw new BusinessException("任务已结束");
// 2026-09-30 起外观专利已整体迁移 Linux 后台执行(无浏览器抓取):
// activate 不再把任务推给客户端浏览器。任务保持 PENDING,由内部认领端点
// (/api/internal/tasks/pull-pending + maixiang-ap worker)在等待窗口后自动接管。
// 这里保留接口仅做状态校验:旧前端(未刷新页面缓存)点「启动」时给出明确提示,
// 前端收到业务异常会中止入队逻辑,任务不会被执行两次。
if (STATUS_PENDING.equals(task.getStatus())) {
log.info("[外观专利] activate 不再推送客户端,任务保持 PENDING 等待 Linux 后台认领 taskId={} userId={}", taskId, userId);
throw new BusinessException("外观专利已切换后台自动执行,无需打开浏览器,稍候自动开始");
}
taskCacheService.touchTaskHeartbeat(taskId);
if (STATUS_RUNNING.equals(task.getStatus())) {
throw new BusinessException("任务已在执行中(可能已由后台自动接管),无需重复启动");
}
throw new BusinessException("任务已结束");
}
public AppearancePatentDashboardVo dashboard(Long userId) {
@@ -70,6 +70,14 @@ public class TaskClientPullService {
@Value("${aiimage.client-task-pull.internal-enabled:false}")
private boolean internalEnabled;
/**
* 内部认领的 PENDING 等待窗口(分钟),独立于客户端兜底拉取口径。
* 外观专利已整体迁移 Linux 后台执行(2026-09-30):任务创建后等待这段时间才允许
* 内部认领——给「建完任务想立刻删除」的用户留余地,也让旧前端点「启动」的过渡语义平滑。
*/
@Value("${aiimage.client-task-pull.internal-min-pending-minutes:2}")
private long internalMinPendingMinutes;
public TaskClientPullService(FileTaskMapper fileTaskMapper,
InstanceMetadata instanceMetadata,
List<ClientTaskPullSpi> handlers) {
@@ -101,8 +109,8 @@ public class TaskClientPullService {
*/
@PostConstruct
public void logEffectiveConfig() {
log.info("[client-task-pull] 生效配置 enabled={} internalEnabled={} moduleTypes={} minPendingMinutes={} limit={} handlers={}",
enabled, internalEnabled, moduleTypes, minPendingMinutes, Math.max(1, Math.min(limit, MAX_LIMIT)), pullHandlers.keySet());
log.info("[client-task-pull] 生效配置 enabled={} internalEnabled={} internalMinPendingMinutes={} moduleTypes={} minPendingMinutes={} limit={} handlers={}",
enabled, internalEnabled, internalMinPendingMinutes, moduleTypes, minPendingMinutes, Math.max(1, Math.min(limit, MAX_LIMIT)), pullHandlers.keySet());
}
/** 拉取并认领该用户"长期未被领取"的任务,按创建时间升序返回,最多 limit 条。 */
@@ -153,7 +161,7 @@ public class TaskClientPullService {
return List.of();
}
long startedAt = System.currentTimeMillis();
LocalDateTime cutoff = LocalDateTime.now(DB_ZONE).minusMinutes(Math.max(1L, minPendingMinutes));
LocalDateTime cutoff = LocalDateTime.now(DB_ZONE).minusMinutes(Math.max(1L, internalMinPendingMinutes));
int safeLimit = Math.max(1, Math.min(limit, MAX_LIMIT));
List<FileTaskEntity> candidates = fileTaskMapper.selectList(new LambdaQueryWrapper<FileTaskEntity>()
.select(FileTaskEntity::getId, FileTaskEntity::getModuleType, FileTaskEntity::getCreatedAt)
@@ -288,12 +288,17 @@ aiimage:
# 默认关闭;打开前需先发布带兜底拉取线程的客户端版本,旧客户端不受影响。
client-task-pull:
enabled: ${AIIMAGE_CLIENT_TASK_PULL_ENABLED:false}
module-types: ${AIIMAGE_CLIENT_TASK_PULL_MODULE_TYPES:SIMILAR_ASIN,COLLECT_DATA,APPEARANCE_PATENT}
# 2026-09-30 外观专利已迁移 Linux 后台执行(内部认领),不再由客户端浏览器兜底执行,
# 因此默认白名单移除 APPEARANCE_PATENT,防止未来误开 enabled 时客户端又抢着抓取。
module-types: ${AIIMAGE_CLIENT_TASK_PULL_MODULE_TYPES:SIMILAR_ASIN,COLLECT_DATA}
min-pending-minutes: ${AIIMAGE_CLIENT_TASK_PULL_MIN_PENDING_MINUTES:5}
limit: ${AIIMAGE_CLIENT_TASK_PULL_LIMIT:5}
# 服务端内部认领(/api/internal/tasks/pull-pending,Linux 后台 worker 专用),
# 与客户端兜底拉取开关独立:外观专利详情页抓取迁 Linux 时单独打开即可。
internal-enabled: ${AIIMAGE_CLIENT_TASK_PULL_INTERNAL_ENABLED:false}
# 内部认领的 PENDING 等待窗口(分钟):任务创建后等待这段时间才允许 Linux worker 认领,
# 留出「建完任务想立刻删除」的余地,也让旧前端点「启动」的过渡语义平滑。
internal-min-pending-minutes: ${AIIMAGE_CLIENT_TASK_PULL_INTERNAL_MIN_PENDING_MINUTES:2}
# 客户端中断任务的自动续跑(V129):客户端被更新脚本/任务管理器杀掉时,在跑的任务会被
# 客户端启动时上报中断并标 FAILED(用户能看到真实原因),这里把这些任务重新排队成 PENDING,
# 由上面的兜底拉取通道交给在线客户端继续跑——长任务不再因为一次客户端更新就整个白跑。