# platform-oss 平台适配 package 说明

日期：`2026-04-20`

## 1. package 职责

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

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

## 2. 当前阶段说明

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

1. `PostObject` 浏览器直传签名
2. 旧 `/generated-*` 公开前缀到 OSS `object_key` 的兼容映射
3. `object_key -> publicUrl` 解析
4. `x-oss-meta-*` 元数据归一化与大小限制校验
5. `content-type`、`content-length-range`、`success_action_status` policy 条件生成

当前仍未落地的内容：

1. `STS` 临时授权
2. 服务端上传 helper
3. 私有对象签名 URL
4. 对象确认与业务绑定

## 3. 边界约束

1. `platform-oss` 只承接对象存储平台适配，不承接业务实体状态与业务规则。
2. 资产状态与对象绑定最终由业务模块和 `apps/spacetime-module` 管理，前端接口由 `apps/api-server` 暴露。
3. 不允许把 OSS SDK、签名逻辑和 URL 策略重新散落到多个业务模块里各自实现。