# module-assets 独立模块 package 占位说明

日期：`2026-04-20`

## 1. package 职责

`module-assets` 是资产任务与对象绑定模块 package，后续负责：

1. `asset_job`、`asset_object`、`asset_manifest` 等资产状态模型
2. 角色形象、动作、Qwen 精灵表、场景图、封面图等资产任务编排
3. 业务实体与 OSS 对象的绑定关系
4. 与 `apps/api-server` 的 assets 兼容接口对接
5. 与 `apps/spacetime-module` 的资产表、reducer、view 聚合对接

## 2. 当前阶段说明

当前提交仅完成目录占位，不提前进入生成链路、对象确认与兼容接口实现。

后续与本 package 直接相关的任务包括：

1. 设计 `asset_job`、`asset_object`、`asset_manifest`
2. 设计角色、动作、场景、精灵表相关资产表
3. 对齐资产生成、发布、对象确认与兼容接口链路
4. 接入 OSS 对象写入与绑定编排

## 3. 边界约束

1. `module-assets` 负责资产任务状态、对象引用关系与模块级编排，不把二进制对象本身放回本地持久化目录真相中。
2. OSS 上传、签名、对象读写等副作用通过平台适配完成，状态最终回写到 `apps/spacetime-module` 聚合的状态模型中。
3. 前端兼容接口由 `apps/api-server` 暴露，但资产任务状态与对象绑定关系不能再次散落到本地文件判断逻辑里。