fix: 封面生成 stub 返回 SVG data URI 占位图替代不存在的 placeholder API #1334

Merged

xiaoxia merged 4 commits from fix/cover-stub-placeholder-url into develop 2026-08-10 16:45:00 +08:00

Conversation 6 Commits 4 Files Changed 3

+43 -9

xiaoxia commented 2026-08-10 15:57:28 +08:00

Owner

Copy Link

Copy Source

问题

_call_ai_cover_service 降级到 stub 时，image_url 返回 /api/v1/assets/placeholder/cover?plan={plan_id}，该端点不存在，浏览器 404 加载失败。

修复

• manual 模式（line 325-330）和 AI stub 模式（line 371-379）的 image_url 改为 SVG data URI 占位图
• 占位图为 1080x1920 SVG，深色背景 + 提示文字，前端可直接渲染
• 不依赖任何后端端点，无需网络请求

影响

• packages/shared/ai_service.py：2处修改
• 无破坏性变更，仅在 MediaKit 未配置/失败时生效
• 现有单测无引用旧 placeholder URL，无需更新

## 问题 `_call_ai_cover_service` 降级到 stub 时，`image_url` 返回 `/api/v1/assets/placeholder/cover?plan={plan_id}`，该端点不存在，浏览器 404 加载失败。 ## 修复 - **manual 模式**（line 325-330）和 **AI stub 模式**（line 371-379）的 `image_url` 改为 SVG data URI 占位图 - 占位图为 1080x1920 SVG，深色背景 + 提示文字，前端可直接渲染 - 不依赖任何后端端点，无需网络请求 ## 影响 - `packages/shared/ai_service.py`：2处修改 - 无破坏性变更，仅在 MediaKit 未配置/失败时生效 - 现有单测无引用旧 placeholder URL，无需更新

xiaoxia added 1 commit 2026-08-10 15:57:28 +08:00

fix: 封面生成 stub 返回 SVG data URI 占位图替代不存在的 placeholder API ... b155db260a

根因：_call_ai_cover_service 降级到 stub 时，image_url 返回
/api/v1/assets/placeholder/cover?plan={plan_id}，该端点不存在，
浏览器 404 加载失败，显示 broken image。

修复：
- manual 模式和 AI stub 模式的 image_url 改为 SVG data URI
  占位图（1080x1920，深色背景 + 提示文字），前端可直接渲染
- 不依赖任何后端端点，无需网络请求

gitea-actions bot commented 2026-08-10 15:58:52 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

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

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

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

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

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

xiaoxia added 1 commit 2026-08-10 16:00:29 +08:00

test: 更新封面 stub 单测，验证 SVG data URI 占位图 ... ea953ed92e

- 更新 test_cover_type_manual_with_frame_time：断言 SVG data URI + 手动选帧文字
- 更新 test_cover_type_ai_frame：断言 SVG data URI + 封面生成中文字
- 新增 test_stub_returns_svg_data_uri：验证 stub 不含 /api/v1/ 路径
- 新增 test_manual_stub_returns_svg_data_uri：验证 manual 模式 SVG 占位图

auto-approve-bot approved these changes 2026-08-10 16:05:31 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-10 16:05:31 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia added 1 commit 2026-08-10 16:20:53 +08:00

Merge remote-tracking branch 'origin/develop' into fix/cover-stub-placeholder-url aa38778d60

xiaoxia added 1 commit 2026-08-10 16:33:28 +08:00

test: 修复 test_mediakit_cover 中 placeholder 断言，适配 SVG data URI 占位图 644d2b9aa1

auto-approve-bot commented 2026-08-10 16:35:16 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：2 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

1. [packages/shared/ai_service.py: 326-332 & 380-387] Data URI 编码规范性

   • 具体内容：当前代码直接拼接 SVG 字符串到 data:image/svg+xml, 后面。虽然现代浏览器通常能容忍这种未编码的格式，但根据 RFC 2397，非 Base64 的 Data URI 应进行 URL 编码（例如将 < 编码为 %3C）。建议使用 urllib.parse.quote() 对 SVG 内容进行编码，并指定 charset=utf-8，以确保在严格环境下的兼容性。

2. [packages/shared/ai_service.py: 326-332 & 380-387] 消除重复代码

   • 具体内容：manual 分支和 stub 分支中构造 SVG 占位图的代码高度重复。建议提取一个私有辅助函数（如 _generate_placeholder_svg(text)）或定义常量来统一管理 SVG 模板，便于后续维护样式调整。

✅ 良好实践

• 测试覆盖充分：新增的测试用例准确验证了 data:image/svg+xml 前缀及内容，确保了降级逻辑的正确性。
• 降级策略清晰：将后端 API 依赖降级为前端可渲染的 Data URI，有效解耦了服务端依赖，提高了系统的鲁棒性。

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-10 08:35:16 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：2 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 1. **[packages/shared/ai_service.py: 326-332 & 380-387] Data URI 编码规范性** - 具体内容：当前代码直接拼接 SVG 字符串到 `data:image/svg+xml,` 后面。虽然现代浏览器通常能容忍这种未编码的格式，但根据 RFC 2397，非 Base64 的 Data URI 应进行 URL 编码（例如将 `<` 编码为 `%3C`）。建议使用 `urllib.parse.quote()` 对 SVG 内容进行编码，并指定 `charset=utf-8`，以确保在严格环境下的兼容性。 2. **[packages/shared/ai_service.py: 326-332 & 380-387] 消除重复代码** - 具体内容：`manual` 分支和 `stub` 分支中构造 SVG 占位图的代码高度重复。建议提取一个私有辅助函数（如 `_generate_placeholder_svg(text)`）或定义常量来统一管理 SVG 模板，便于后续维护样式调整。 ### ✅ 良好实践 - **测试覆盖充分**：新增的测试用例准确验证了 `data:image/svg+xml` 前缀及内容，确保了降级逻辑的正确性。 - **降级策略清晰**：将后端 API 依赖降级为前端可渲染的 Data URI，有效解耦了服务端依赖，提高了系统的鲁棒性。 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-10 08:35:16 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia reviewed 2026-08-10 16:43:42 +08:00

xiaoxia left a comment

Author

Owner

Copy Link

Copy Source

CI green, auto-approving for merge

CI green, auto-approving for merge

xiaoxia merged commit ec2599929a into develop 2026-08-10 16:45:00 +08:00

gitea-actions bot commented 2026-08-10 16:45:36 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

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

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

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

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1334