docs: add story module package placeholder
This commit is contained in:
@@ -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`
|
||||||
|
|||||||
@@ -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. 已冻结边界
|
||||||
|
|
||||||
|
|||||||
30
server-rs/packages/module-story/README.md
Normal file
30
server-rs/packages/module-story/README.md
Normal 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 的旧实现方式。
|
||||||
Reference in New Issue
Block a user