docs: add quest module package placeholder

This commit is contained in:
2026-04-21 00:49:13 +08:00
parent 4ad172637a
commit 839cd41bd6
3 changed files with 47 additions and 16 deletions

View File

@@ -63,7 +63,8 @@
交付物:[../server-rs/packages/module-npc/README.md](../server-rs/packages/module-npc/README.md) 交付物:[../server-rs/packages/module-npc/README.md](../server-rs/packages/module-npc/README.md)
- [x] 创建 `packages/module-progression` - [x] 创建 `packages/module-progression`
交付物:[../server-rs/packages/module-progression/README.md](../server-rs/packages/module-progression/README.md) 交付物:[../server-rs/packages/module-progression/README.md](../server-rs/packages/module-progression/README.md)
- [ ] 创建 `packages/module-quest` - [x] 创建 `packages/module-quest`
交付物:[../server-rs/packages/module-quest/README.md](../server-rs/packages/module-quest/README.md)
- [ ] 创建 `packages/module-runtime-item` - [ ] 创建 `packages/module-runtime-item`
- [ ] 创建 `packages/module-custom-world` - [ ] 创建 `packages/module-custom-world`
- [ ] 创建 `packages/module-assets` - [ ] 创建 `packages/module-assets`

View File

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

View File

@@ -0,0 +1,30 @@
# module-quest 独立模块 package 占位说明
日期:`2026-04-20`
## 1. package 职责
`module-quest` 是任务运行时模块 package后续负责
1. `quest_record` 等任务状态模型
2. 任务进度、任务日志、任务信号处理规则
3. 与 story、runtime、progression 的任务联动
4.`apps/api-server` 的任务兼容接口对接
5.`apps/spacetime-module` 的任务表、reducer、view 聚合对接
## 2. 当前阶段说明
当前提交仅完成目录占位,不提前进入任务草案、进度投影与兼容接口实现。
后续与本 package 直接相关的任务包括:
1. 设计 `quest_record`
2. 设计 `apply_quest_signal`
3. 对齐任务进度、日志与兼容输出结构
4. 接入 runtime 与 story 的任务联动
## 3. 边界约束
1. `module-quest` 负责任务状态真相与任务规则,生成型任务草案与外部 AI 编排不直接塞进模块内部。
2. 任务状态最终回写到 `apps/spacetime-module` 聚合的状态模型中,前端兼容接口由 `apps/api-server` 暴露。
3. 任务不能再次散落到 story service、runtime service 或前端临时状态里分别维护。