Move repository images and embedded template bitmaps to S3 #23

2026-10-29T15:04:33Z

codex-bot commented

2026-10-29 15:04:33 +00:00

目标与改动

业务内容图片曾作为初始化种子、public 文件、版式作者素材和 Base64 模板数据进入 Git，造成源码与镜像携带重复素材。本次直接将文件内容迁入现有 S3，PostgreSQL assets 保存媒体元数据；代码保留清单、媒体 ID 和必要 SVG 设计源稿。

删除 603 个 PNG（38,085,328 字节），去重为 572 个不可变 S3 对象。已完成实际迁移，全部对象通过 S3 GET 和现有线上 /api/media API 两轮逐对象 SHA-256 校验，元数据已在事务中登记。
Studio 两个模板 JSON 的 334 处 Base64 图片改为媒体引用。SVG 导出按认证媒体 API 临时嵌入图片，继续提供自包含 SVG；下载限制 16 MiB，不接受任意远程地址。
保留旧五个 public 图片 URL 的兼容映射；预览和学习封面读取 S3，人物包导入读取媒体 API，Docker 不再打包 PNG。
作者工具读取外部缓存或认证媒体 API；生成输出使用仓库外路径。截图文档改用媒体链接，.gitignore 阻止图片再入库。
完整逐文件图片索引见 apps/waterfall-wiki/src/content/managed-media.json，迁移、恢复与限制见 docs/s3-media.md。

验证与限制

572 个对象经 S3 读回和线上认证媒体 API 读回，字节数、类型、SHA-256 全部通过。
16 项 Studio 单元测试、3 项清单/外部缓存测试、2 项人物包测试通过；JS 语法、git diff --check、Studio tsc --noEmit 检查通过。
Wiki tsc --noEmit 因本地依赖 nodemailer 缺失而未通过；未安装依赖，也未运行 Next typegen。
按用户要求，没有 CI/CD、没有构建、没有部署，完整集成测试未执行。测试代码已改用隔离 S3 合成素材，不访问生产数据。
线上当前镜像与旧 Git 历史仍保留原图片；未重写历史或清理运行镜像。新引用与镜像变化需将来部署后才能生效。
新环境需同时恢复 S3 对象和 assets 元数据；清单不是数据库备份。

Base: main；head: codex/s3-media。等待用户手动合并，不启用自动合并。本 PR 的分支推送/PR 不触发当前 main-only CI；合并 main 会按现有规则触发 CI/CD，请用户自行安排合并时间。

## 目标与改动业务内容图片曾作为初始化种子、public 文件、版式作者素材和 Base64 模板数据进入 Git，造成源码与镜像携带重复素材。本次直接将文件内容迁入现有 S3，PostgreSQL assets 保存媒体元数据；代码保留清单、媒体 ID 和必要 SVG 设计源稿。 - 删除 603 个 PNG（38,085,328 字节），去重为 572 个不可变 S3 对象。已完成实际迁移，全部对象通过 S3 GET 和现有线上 /api/media API 两轮逐对象 SHA-256 校验，元数据已在事务中登记。 - Studio 两个模板 JSON 的 334 处 Base64 图片改为媒体引用。SVG 导出按认证媒体 API 临时嵌入图片，继续提供自包含 SVG；下载限制 16 MiB，不接受任意远程地址。 - 保留旧五个 public 图片 URL 的兼容映射；预览和学习封面读取 S3，人物包导入读取媒体 API，Docker 不再打包 PNG。 - 作者工具读取外部缓存或认证媒体 API；生成输出使用仓库外路径。截图文档改用媒体链接，.gitignore 阻止图片再入库。 - 完整逐文件图片索引见 apps/waterfall-wiki/src/content/managed-media.json，迁移、恢复与限制见 docs/s3-media.md。 ## 验证与限制 - 572 个对象经 S3 读回和线上认证媒体 API 读回，字节数、类型、SHA-256 全部通过。 - 16 项 Studio 单元测试、3 项清单/外部缓存测试、2 项人物包测试通过；JS 语法、git diff --check、Studio tsc --noEmit 检查通过。 - Wiki tsc --noEmit 因本地依赖 nodemailer 缺失而未通过；未安装依赖，也未运行 Next typegen。 - 按用户要求，没有 CI/CD、没有构建、没有部署，完整集成测试未执行。测试代码已改用隔离 S3 合成素材，不访问生产数据。 - 线上当前镜像与旧 Git 历史仍保留原图片；未重写历史或清理运行镜像。新引用与镜像变化需将来部署后才能生效。 - 新环境需同时恢复 S3 对象和 assets 元数据；清单不是数据库备份。 Base: main；head: codex/s3-media。等待用户手动合并，不启用自动合并。本 PR 的分支推送/PR 不触发当前 main-only CI；合并 main 会按现有规则触发 CI/CD，请用户自行安排合并时间。

codex-bot added 1 commit 2026-10-29 15:04:34 +00:00

Move repository content images to S3-backed media references 19bba57561

codex-bot referenced this pull request

2026-10-29 16:43:23 +00:00

Rebuild Studio infinite canvas as full-screen movable tools #24

codex-bot merged commit 922c7bd0d0 into main

2026-10-29 16:43:29 +00:00

codex-bot referenced this pull request

2026-10-29 17:00:29 +00:00

Fix Studio release smoke after S3 template migration #25

Sign in to join this conversation.