feat(worker): #1970 AI 标签 backfill 支持 force 重打降级记录 #1989

Merged

auto-approve-bot merged 1 commits from feat/1970-force-backfill-downgraded-tags into develop 2026-09-19 10:49:21 +08:00

Conversation 2 Commits 1 Files Changed 4

+375 -13

xiaoxia commented 2026-09-19 10:43:54 +08:00

Owner

Copy Link

Copy Source

背景

#1987 修复 Celery 任务注册、DOUBAO_VISION_MODEL 配置正确后，此前视觉 API 失败写入的降级记录 {"inherited_tags": [...]}（非 NULL）不会被 backfill 捞起（find_untagged 只匹配 ai_tags IS NULL），tag 任务本身也按幂等跳过，存量降级片段永远无法补全真实 AI 标签（含 has_text）。

改动

• find_untagged(limit, include_downgraded=False)：force 模式下用 ai_tags['has_text'].as_string() IS NULL（→ JSON/JSONB ->>'has_text'）同时匹配 NULL 记录和缺 has_text 键的降级记录；has_text=true/false 的完整记录始终排除。
• tag_atom_clip_task(atom_clip_id, force=False)：force=True 时放行缺 has_text 的降级记录并覆盖写入；完整标签始终跳过保持幂等。
• backfill_atom_clip_tags(..., force=False)：透传 kwargs={"force": ...} 给 tag 任务。

用法

Celery 调用（管理员/运维）：

backfill_atom_clip_tags.delay(force=True)  # 含降级记录全量重打
backfill_atom_clip_tags.delay(max_clips=20, force=True)  # 小批验证

验证

• 新增 7 个回归测试（仓储过滤 SQL 在 SQLite 验证跨库语义；任务层直接调用原函数，兼容 tests/unit 旧测试向 sys.modules 注入 celery_app MagicMock 不还原的污染）
• 全量 tests/unit：15828 passed / 28 skipped；ruff/black/isort 通过

兼容性

force 默认 False，默认行为完全不变（仅 ai_tags IS NULL）。

## 背景 #1987 修复 Celery 任务注册、DOUBAO_VISION_MODEL 配置正确后，此前视觉 API 失败写入的降级记录 `{"inherited_tags": [...]}`（非 NULL）不会被 backfill 捞起（`find_untagged` 只匹配 `ai_tags IS NULL`），tag 任务本身也按幂等跳过，存量降级片段永远无法补全真实 AI 标签（含 has_text）。 ## 改动 - `find_untagged(limit, include_downgraded=False)`：force 模式下用 `ai_tags['has_text'].as_string() IS NULL`（→ JSON/JSONB `->>'has_text'`）同时匹配 NULL 记录和缺 has_text 键的降级记录；`has_text=true/false` 的完整记录始终排除。 - `tag_atom_clip_task(atom_clip_id, force=False)`：force=True 时放行缺 has_text 的降级记录并覆盖写入；完整标签始终跳过保持幂等。 - `backfill_atom_clip_tags(..., force=False)`：透传 `kwargs={"force": ...}` 给 tag 任务。 ## 用法 Celery 调用（管理员/运维）： ```python backfill_atom_clip_tags.delay(force=True) # 含降级记录全量重打 backfill_atom_clip_tags.delay(max_clips=20, force=True) # 小批验证 ``` ## 验证 - 新增 7 个回归测试（仓储过滤 SQL 在 SQLite 验证跨库语义；任务层直接调用原函数，兼容 tests/unit 旧测试向 sys.modules 注入 celery_app MagicMock 不还原的污染） - 全量 tests/unit：**15828 passed / 28 skipped**；ruff/black/isort 通过 ## 兼容性 force 默认 False，默认行为完全不变（仅 ai_tags IS NULL）。

xiaoxia added 1 commit 2026-09-19 10:43:54 +08:00

feat(worker): #1970 AI 标签 backfill 支持 force 重打降级记录 ... 9558969a31

DOUBAO_VISION_MODEL 修复后，此前视觉 API 失败写入的
{'inherited_tags': [...]} 降级记录（非 NULL）不会被默认 backfill 捞起，
tag 任务也按幂等跳过。

- find_untagged 加 include_downgraded：用 ai_tags['has_text'].as_string()
  IS NULL 同时匹配 NULL 与缺 has_text 键的降级记录（json/jsonb 通用，
  has_text=true/false 的完整记录排除）
- tag_atom_clip_task / backfill_atom_clip_tags 加 force 参数，
  backfill 透传 kwargs={'force': ...}
- 7 个回归测试（任务层测试兼容旧测试 sys.modules 注入 MagicMock 的污染）

gitea-actions bot commented 2026-09-19 10:44:55 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1989
预览链接	https://pr-1989.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1989 | | 预览链接 | [https://pr-1989.preview.xiaoxiajianji.com](https://pr-1989.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot merged commit a1f25a4426 into develop 2026-09-19 10:49:21 +08:00

auto-approve-bot deleted branch feat/1970-force-backfill-downgraded-tags 2026-09-19 10:49:24 +08:00

gitea-actions bot commented 2026-09-19 10:49:46 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1989 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1989 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

Clear labels

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot frontend-dev xiaoxia

No Assignees

2 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1989