31 lines
1.5 KiB
Markdown
31 lines
1.5 KiB
Markdown
# module-custom-world 独立模块 package 占位说明
|
||
|
||
日期：`2026-04-20`
|
||
|
||
## 1. package 职责
|
||
|
||
`module-custom-world` 是自定义世界与 agent 模块 package，后续负责：
|
||
|
||
1. `custom_world_profile`、`custom_world_session` 等世界状态模型
|
||
2. `custom_world_agent_session`、消息、操作、草稿卡等 agent 状态模型
|
||
3. 传统问答流、library、gallery、agent 会话的模块级编排
|
||
4. 与 `apps/api-server` 的 custom world 兼容接口与 SSE 对接
|
||
5. 与 `apps/spacetime-module` 的 custom world 表、reducer、view 聚合对接
|
||
|
||
## 2. 当前阶段说明
|
||
|
||
当前提交仅完成目录占位，不提前进入问答流、agent 流、世界编译与资产绑定实现。
|
||
|
||
后续与本 package 直接相关的任务包括：
|
||
|
||
1. 设计 `custom_world_profile`、`custom_world_session`
|
||
2. 设计 `custom_world_agent_session`、消息、操作、卡片相关表
|
||
3. 对齐 traditional custom world、library、gallery、agent 兼容链路
|
||
4. 接入世界编译、场景图、封面图与角色资产的模块级编排
|
||
|
||
## 3. 边界约束
|
||
|
||
1. `module-custom-world` 负责世界状态真相、agent 状态与模块级编排，不把整个会话重新塞回单大 JSON 体。
|
||
2. 外部 LLM、图片生成、OSS 写入等副作用通过平台适配和应用层完成，状态最终回写到 `apps/spacetime-module` 聚合的状态模型中。
|
||
3. 前端兼容 REST 与 SSE 由 `apps/api-server` 暴露，但自定义世界主链状态不能再次分散到本地 session store 或前端临时状态中。
|