docs: add custom world module package placeholder

server-rs/README.md

@@ -14,7 +14,7 @@
 
 ## 2. 当前阶段说明
 
-当前目录已经完成以下十四项初始化：
+当前目录已经完成以下十五项初始化：
 
 1. 为新后端预留正式目录并把路径固定到仓库结构中。
 2. 创建虚拟 workspace `Cargo.toml`，后续 package 会逐项挂入。
@@ -30,21 +30,21 @@
 12. 创建 `packages/module-progression/` 目录占位，固定成长与章节推进模块 package 落位。
 13. 创建 `packages/module-quest/` 目录占位，固定任务运行时模块 package 落位。
 14. 创建 `packages/module-runtime-item/` 目录占位，固定运行时物品模块 package 落位。
+15. 创建 `packages/module-custom-world/` 目录占位，固定自定义世界与 agent 模块 package 落位。
 
 后续任务会继续在本目录内按顺序补齐：
 
-1. `packages/module-custom-world`
-2. `packages/module-assets`
-3. `packages/module-editor`
-4. `packages/module-ai`
-5. `packages/shared-contracts`
-6. `packages/shared-kernel`
-7. `packages/platform-auth`
-8. `packages/platform-oss`
-9. `packages/platform-llm`
-10. `packages/spacetime-client`
-11. `packages/tests-support`
-12. `scripts/*`
+1. `packages/module-assets`
+2. `packages/module-editor`
+3. `packages/module-ai`
+4. `packages/shared-contracts`
+5. `packages/shared-kernel`
+6. `packages/platform-auth`
+7. `packages/platform-oss`
+8. `packages/platform-llm`
+9. `packages/spacetime-client`
+10. `packages/tests-support`
+11. `scripts/*`
 
 ## 3. 已冻结边界
 

server-rs/packages/module-custom-world/README.md

@@ -0,0 +1,30 @@
+# 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 或前端临时状态中。