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 b0bc6794..c5b9bac6 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -65,7 +65,8 @@ 交付物:[../server-rs/packages/module-progression/README.md](../server-rs/packages/module-progression/README.md) - [x] 创建 `packages/module-quest` 交付物:[../server-rs/packages/module-quest/README.md](../server-rs/packages/module-quest/README.md) -- [ ] 创建 `packages/module-runtime-item` +- [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` - [ ] 创建 `packages/module-assets` - [ ] 创建 `packages/module-editor` diff --git a/server-rs/README.md b/server-rs/README.md index e38ce56a..61450660 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下十三项初始化: +当前目录已经完成以下十四项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -29,22 +29,22 @@ 11. 创建 `packages/module-npc/` 目录占位,固定 NPC 状态与互动模块 package 落位。 12. 创建 `packages/module-progression/` 目录占位,固定成长与章节推进模块 package 落位。 13. 创建 `packages/module-quest/` 目录占位,固定任务运行时模块 package 落位。 +14. 创建 `packages/module-runtime-item/` 目录占位,固定运行时物品模块 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/module-runtime-item` -2. `packages/module-custom-world` -3. `packages/module-assets` -4. `packages/module-editor` -5. `packages/module-ai` -6. `packages/shared-contracts` -7. `packages/shared-kernel` -8. `packages/platform-auth` -9. `packages/platform-oss` -10. `packages/platform-llm` -11. `packages/spacetime-client` -12. `packages/tests-support` -13. `scripts/*` +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/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/module-runtime-item/README.md b/server-rs/packages/module-runtime-item/README.md new file mode 100644 index 00000000..1dbbfb90 --- /dev/null +++ b/server-rs/packages/module-runtime-item/README.md @@ -0,0 +1,30 @@ +# module-runtime-item 独立模块 package 占位说明 + +日期:`2026-04-20` + +## 1. package 职责 + +`module-runtime-item` 是运行时物品模块 package,后续负责: + +1. `treasure_record` 等运行时物品与宝藏状态模型 +2. 奖励解析、宝藏逻辑、运行时物品结算规则 +3. 与 story、inventory、quest 的运行时物品联动 +4. 与 `apps/api-server` 的运行时物品兼容接口对接 +5. 与 `apps/spacetime-module` 的运行时物品表、reducer、view 聚合对接 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位,不提前进入奖励解析、意图生成与兼容接口实现。 + +后续与本 package 直接相关的任务包括: + +1. 设计 `treasure_record` +2. 设计运行时物品结算与宝藏交互 reducer +3. 对齐奖励、宝藏、patch 与兼容输出结构 +4. 接入 story action 主循环的运行时物品联动 + +## 3. 边界约束 + +1. `module-runtime-item` 负责运行时物品状态真相与奖励规则,生成型物品意图与外部 AI 编排不直接塞进模块内部。 +2. 奖励与宝藏状态最终回写到 `apps/spacetime-module` 聚合的状态模型中,前端兼容接口由 `apps/api-server` 暴露。 +3. 运行时物品逻辑不能再次散落到 story、inventory 或 route handler 中分别维护。