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 5ec9e713..403c2418 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -73,7 +73,8 @@ 交付物:[../server-rs/packages/module-assets/README.md](../server-rs/packages/module-assets/README.md) - [x] 创建 `packages/module-editor` 交付物:[../server-rs/packages/module-editor/README.md](../server-rs/packages/module-editor/README.md) -- [ ] 创建 `packages/module-ai` +- [x] 创建 `packages/module-ai` + 交付物:[../server-rs/packages/module-ai/README.md](../server-rs/packages/module-ai/README.md) - [ ] 创建 `packages/shared-contracts` - [ ] 创建 `packages/shared-kernel` - [ ] 创建 `packages/platform-auth` diff --git a/server-rs/README.md b/server-rs/README.md index 58736aa0..dfad9038 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下十七项初始化: +当前目录已经完成以下十八项初始化: 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`,后续 package 会逐项挂入。 @@ -33,18 +33,18 @@ 15. 创建 `packages/module-custom-world/` 目录占位,固定自定义世界与 agent 模块 package 落位。 16. 创建 `packages/module-assets/` 目录占位,固定资产任务与对象绑定模块 package 落位。 17. 创建 `packages/module-editor/` 目录占位,固定编辑器读写模块 package 落位。 +18. 创建 `packages/module-ai/` 目录占位,固定 AI 编排模块 package 落位。 后续任务会继续在本目录内按顺序补齐: -1. `packages/module-ai` -2. `packages/shared-contracts` -3. `packages/shared-kernel` -4. `packages/platform-auth` -5. `packages/platform-oss` -6. `packages/platform-llm` -7. `packages/spacetime-client` -8. `packages/tests-support` -9. `scripts/*` +1. `packages/shared-contracts` +2. `packages/shared-kernel` +3. `packages/platform-auth` +4. `packages/platform-oss` +5. `packages/platform-llm` +6. `packages/spacetime-client` +7. `packages/tests-support` +8. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/module-ai/README.md b/server-rs/packages/module-ai/README.md new file mode 100644 index 00000000..d888be76 --- /dev/null +++ b/server-rs/packages/module-ai/README.md @@ -0,0 +1,29 @@ +# module-ai 独立模块 package 占位说明 + +日期:`2026-04-20` + +## 1. package 职责 + +`module-ai` 是 AI 编排模块 package,后续负责: + +1. 剧情、聊天、自定义世界、运行时物品等生成型流程的模块级编排 +2. prompt 组织、阶段状态、结果引用与模块间协同 +3. 与 `apps/api-server` 的流式输出与兼容接口对接 +4. 与 `apps/spacetime-module` 的任务状态、结果引用聚合对接 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位,不提前进入模型调用、流式编排与结果回写实现。 + +后续与本 package 直接相关的任务包括: + +1. 设计多模型编排与任务状态抽象 +2. 对齐剧情、聊天、自定义世界等生成链路 +3. 对齐流式输出、阶段事件与兼容响应结构 +4. 接入模块级结果回写与任务引用绑定 + +## 3. 边界约束 + +1. `module-ai` 负责生成型流程的模块级编排,不把供应商 SDK 直接散落到各业务模块里。 +2. 实际模型接入通过 `packages/platform-llm` 完成,状态与结果引用最终回写到 `apps/spacetime-module` 聚合的状态模型中。 +3. 前端兼容 REST 与 SSE 由 `apps/api-server` 暴露,但 AI 编排过程不能再次退回单个大 orchestrator 的黑盒写法。