Files

T

kdletters c2c5e1ced5 发行包上限提升到 200 MiB 并支持 AGC 分片续传上传

- 发行包上限 100→200 MiB、展开总量 250→500 MiB，整包路由请求体上限继续从包上限派生；发行静态资源进程内缓存预算提到 256 MiB
- 反代放行量同步放宽到 210 MiB：Nginx 三份模板的 client_max_body_size、Pingora 网关默认值与 env 样例、路由对照矩阵
- platform-oss 新增内部对象追加写 append_internal_object(_with_retry)，以 OSS 返回的 next-append-position 作为权威已收字节
- api-server 新增 upload-state / chunk / complete / reset 四条分片路由，抽出共享收口 confirm_validated_package；偏移不符返回 409 与权威偏移，校验失败删除半包并落 upload_failed
- AGC 新增原生上传器 game_package_upload.rs（内容寻址暂存、分片续传、受控重试、进度事件）与 prepare / upload 两条命令，退役整包回传命令
- 渲染进程改为 prepare → 创建游戏 → 创建版本 → 原生分片上传 → 送审，LocalProjectExportPackagePayload 整包类型退役
- 同时修正 live 用例无法指向本地栈的两处基础设施问题：平台基址按传入 URL 选择，桥接层把 jsdom realm 的 Headers / Blob / FormData 降级成 Node 原生值
- 测试：platform-oss 74、api-server game_distribution 23、AGC 原生 4、发布相关前端 20；live 用例补真实栈「中断 → 续传 → 确认」断言（分片偏移序列 [0, 8388608]）
- 文档：玩法创作主规范的上传合同、运维与 Pingora 文档、决策记录、发行里程碑口径，以及新增的续传里程碑与实施计划

2026-09-23 19:06:02 +08:00

examples

项目快照按渠道分区，后台项目工程支持渠道筛选与游标分页

2026-09-21 16:57:16 +08:00

src

发行包上限提升到 200 MiB 并支持 AGC 分片续传上传

2026-09-23 19:06:02 +08:00

Cargo.toml

修复项目自动上传并增加后台完整工程下载

2026-09-20 10:07:31 +08:00

README.md

实现画布Agent侧边栏聊天

2026-07-04 12:03:58 +08:00

README.md

platform-oss 平台适配 package 说明

日期：2026-04-20

1. package 职责

platform-oss 是 OSS 平台适配 package，后续负责：

OSS 直传签名、STS、上传策略适配
对象上传、下载、签名 URL 与 cdn_url 解析适配
对象元数据、标签与内容 hash 适配
供 module-assets、module-custom-world 等模块复用的对象存储基础设施能力

2. 当前阶段说明

当前提交已落地最小可用 OSS 基础设施：

PostObject 浏览器直传签名
旧 /generated-* 公开前缀到 OSS object_key 的兼容映射
私有对象短期签名读 URL
私有对象 HEAD Object 探测
服务端 PutObject 上传 helper
x-oss-meta-* 元数据归一化与大小限制校验
content-type、content-length-range、success_action_status policy 条件生成
PostObject 签名、GetObject 读签名、HEAD Object 和 PutObject 的结构化日志
generated 私有对象上传默认写入 Cache-Control: public, max-age=31536000, immutable
editor-agent/ 服务端内部消息文档前缀，以及仅供后端使用的内部短期读签名能力

当前仍未落地的内容：

STS 真实临时授权下发
multipart 分片上传
内容 hash 自动计算与标签写入

补充说明：

当前产品口径为服务器上传 AI 生成资源、Web 端只负责读取。
因此 STS 不作为默认上传主链，api-server 只暴露禁用式 contract，避免浏览器拿到 OSS 写权限。
服务端生成资源应优先复用 OssClient::put_object，上传成功后再走对象确认链路写入 asset_object。
读签名和 HEAD Object 的入参必须直接传 object_key，不要把 bucket 名拼进路径；例如 generated-square-hole-assets/.../image.png 才是正确入参，xushi-dev/... 这类前缀不属于 object_key。
OSS V4 x-oss-date 必须固定为 yyyyMMdd'T'HHmmss'Z'，不能依赖 time::Time::to_string()；后者在小时小于 10 时可能输出非补零时间，导致签名格式错误。
结构化日志只记录 provider、operation、bucket、endpoint、object_key / key_prefix、access、content_type、content_length、status、status_class、error_kind 和 elapsed_ms 等排障字段；禁止输出 AccessKey、policy、signature、Authorization header 或完整 signed URL。
完整 OSS URL 不能当作 object key 传入签名接口；前端收到 https://*.oss-*.aliyuncs.com/generated-* 时应先归一为 legacy public path，再通过 /api/assets/read-url 换取短期 signed URL。
generated 资源缓存的主路径是 OSS 对象头、浏览器 / WebView HTTP 缓存和后续 CDN，不允许改成 api-server 本地磁盘静态资源兜底。
PostObject 是 OSS 基础设施能力，不代表所有前缀都允许浏览器直传；editor-agent/ 只用于画布 Agent 会话消息文档，属于服务端内部前缀，不向浏览器开放写入。
画布 Agent 消息文档固定使用 editor-agent/{conversationId}.json，由 api-server 通过服务端 PutObject 整体写入，通过内部读签名读取；浏览器只调用会话 API，不直接持有 editor-agent/ 对象的 OSS 写权限、STS 写权限或直传表单。
editor-agent/ 不属于 legacy /generated-* 公开资源前缀，也不应通过通用 /api/assets/read-url 暴露为前端可自行读写的对象地址。
画布 Agent 消息文档的业务上限、会话内串行写入、失败 generation record 保留等规则由 api-server 与 ADR 约束；platform-oss 只负责对象 key 规范化、签名和服务端上传能力。

3. 边界约束

platform-oss 只承接对象存储平台适配，不承接业务实体状态与业务规则。
资产状态与对象绑定最终由业务模块和 apps/spacetime-module 管理，前端接口由 apps/api-server 暴露。
不允许把 OSS SDK、签名逻辑和 URL 策略重新散落到多个业务模块里各自实现。
editor-agent/ 前缀是服务端内部消息文档命名空间，只允许保存 editor-agent/{conversationId}.json 形态的会话级 JSON 文档。
浏览器直传能力不得用于 editor-agent/ 前缀；若未来需要上传用户附件，应走独立的附件 / 资产前缀和确认链路，不得复用会话消息文档对象。