From df8ef351bbbc14f482de752da6edfbd211ccdb9c Mon Sep 17 00:00:00 2001 From: kdletters Date: Tue, 21 Apr 2026 00:50:33 +0800 Subject: [PATCH] docs: add custom world module package placeholder --- .../01_M0_M2_FOUNDATION_AND_AUTH.md | 3 +- server-rs/README.md | 26 ++++++++-------- .../packages/module-custom-world/README.md | 30 +++++++++++++++++++ 3 files changed, 45 insertions(+), 14 deletions(-) create mode 100644 server-rs/packages/module-custom-world/README.md diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md index c5b9bac6..4125f6e8 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -67,7 +67,8 @@ 交付物：[../server-rs/packages/module-quest/README.md](../server-rs/packages/module-quest/README.md) - [x] 创建 `packages/module-runtime-item` 交付物：[../server-rs/packages/module-runtime-item/README.md](../server-rs/packages/module-runtime-item/README.md) -- [ ] 创建 `packages/module-custom-world` +- [x] 创建 `packages/module-custom-world` + 交付物：[../server-rs/packages/module-custom-world/README.md](../server-rs/packages/module-custom-world/README.md) - [ ] 创建 `packages/module-assets` - [ ] 创建 `packages/module-editor` - [ ] 创建 `packages/module-ai` diff --git a/server-rs/README.md b/server-rs/README.md index 61450660..8e62ea39 100644 --- a/server-rs/README.md +++ b/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. 已冻结边界 diff --git a/server-rs/packages/module-custom-world/README.md b/server-rs/packages/module-custom-world/README.md new file mode 100644 index 00000000..3cebd176 --- /dev/null +++ b/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 或前端临时状态中。