docs: add story module package placeholder

This commit is contained in:
2026-04-21 00:45:58 +08:00
parent d13c70f7fc
commit 9fba8a3191
3 changed files with 52 additions and 21 deletions

View File

@@ -53,7 +53,8 @@
交付物:[../server-rs/packages/module-auth/README.md](../server-rs/packages/module-auth/README.md) 交付物:[../server-rs/packages/module-auth/README.md](../server-rs/packages/module-auth/README.md)
- [x] 创建 `packages/module-runtime` - [x] 创建 `packages/module-runtime`
交付物:[../server-rs/packages/module-runtime/README.md](../server-rs/packages/module-runtime/README.md) 交付物:[../server-rs/packages/module-runtime/README.md](../server-rs/packages/module-runtime/README.md)
- [ ] 创建 `packages/module-story` - [x] 创建 `packages/module-story`
交付物:[../server-rs/packages/module-story/README.md](../server-rs/packages/module-story/README.md)
- [ ] 创建 `packages/module-combat` - [ ] 创建 `packages/module-combat`
- [ ] 创建 `packages/module-inventory` - [ ] 创建 `packages/module-inventory`
- [ ] 创建 `packages/module-npc` - [ ] 创建 `packages/module-npc`

View File

@@ -14,7 +14,7 @@
## 2. 当前阶段说明 ## 2. 当前阶段说明
当前目录已经完成以下项初始化: 当前目录已经完成以下项初始化:
1. 为新后端预留正式目录并把路径固定到仓库结构中。 1. 为新后端预留正式目录并把路径固定到仓库结构中。
2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。
@@ -23,28 +23,28 @@
5. 创建 `apps/spacetime-module/` 目录占位,固定 SpacetimeDB 主工程落位。 5. 创建 `apps/spacetime-module/` 目录占位,固定 SpacetimeDB 主工程落位。
6. 创建 `packages/module-auth/` 目录占位,固定鉴权模块 package 落位。 6. 创建 `packages/module-auth/` 目录占位,固定鉴权模块 package 落位。
7. 创建 `packages/module-runtime/` 目录占位,固定运行时状态基座模块 package 落位。 7. 创建 `packages/module-runtime/` 目录占位,固定运行时状态基座模块 package 落位。
8. 创建 `packages/module-story/` 目录占位,固定故事主循环模块 package 落位。
后续任务会继续在本目录内按顺序补齐: 后续任务会继续在本目录内按顺序补齐:
1. `packages/module-story` 1. `packages/module-combat`
2. `packages/module-combat` 2. `packages/module-inventory`
3. `packages/module-inventory` 3. `packages/module-npc`
4. `packages/module-npc` 4. `packages/module-progression`
5. `packages/module-progression` 5. `packages/module-quest`
6. `packages/module-quest` 6. `packages/module-runtime-item`
7. `packages/module-runtime-item` 7. `packages/module-custom-world`
8. `packages/module-custom-world` 8. `packages/module-assets`
9. `packages/module-assets` 9. `packages/module-editor`
10. `packages/module-editor` 10. `packages/module-ai`
11. `packages/module-ai` 11. `packages/shared-contracts`
12. `packages/shared-contracts` 12. `packages/shared-kernel`
13. `packages/shared-kernel` 13. `packages/platform-auth`
14. `packages/platform-auth` 14. `packages/platform-oss`
15. `packages/platform-oss` 15. `packages/platform-llm`
16. `packages/platform-llm` 16. `packages/spacetime-client`
17. `packages/spacetime-client` 17. `packages/tests-support`
18. `packages/tests-support` 18. `scripts/*`
19. `scripts/*`
## 3. 已冻结边界 ## 3. 已冻结边界

View File

@@ -0,0 +1,30 @@
# module-story 独立模块 package 占位说明
日期:`2026-04-20`
## 1. package 职责
`module-story` 是故事主循环模块 package后续负责
1. `story_session``story_event` 等故事会话状态模型
2. story action 主循环与状态推进规则
3. `currentStory`、story state、兼容视图模型的模块级拼装
4.`apps/api-server` 的 story facade 与 SSE 输出对接
5.`apps/spacetime-module` 的 story 表、reducer、view 聚合对接
## 2. 当前阶段说明
当前提交仅完成目录占位,不提前进入 reducer、view 与 SSE 兼容实现。
后续与本 package 直接相关的任务包括:
1. 设计 `story_session``story_event`
2. 设计 `resolve_story_action``continue_story``begin_story_session`
3. 对齐 `RuntimeStoryActionResponse``RuntimeStoryOptionView`
4. 落地 `/api/runtime/story/*` 兼容链路
## 3. 边界约束
1. `module-story` 负责故事状态真相与主循环规则,不把外部 LLM、OSS、短信、微信等副作用塞进模块内部。
2. 流式文本输出与 HTTP 协议兼容由 `apps/api-server` 暴露,但阶段状态与故事真相必须回写到 `apps/spacetime-module` 聚合的状态模型中。
3. 跨模块联动通过明确的 reducer 与模块边界协作,不回到单大 service 直接改整包 JSON 的旧实现方式。