docs: add ai module package placeholder

This commit is contained in:
2026-04-21 00:52:32 +08:00
parent f6258ed7c2
commit 9f6fd5ed1e
3 changed files with 41 additions and 11 deletions

View File

@@ -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`

View File

@@ -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. 已冻结边界

View File

@@ -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 的黑盒写法。