docs: add npc module package placeholder
This commit is contained in:
30
server-rs/packages/module-npc/README.md
Normal file
30
server-rs/packages/module-npc/README.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# module-npc 独立模块 package 占位说明
|
||||
|
||||
日期:`2026-04-20`
|
||||
|
||||
## 1. package 职责
|
||||
|
||||
`module-npc` 是 NPC 状态与互动模块 package,后续负责:
|
||||
|
||||
1. `npc_state` 等 NPC 关系与状态模型
|
||||
2. 招募、关系变化、互动规则与场景语义状态
|
||||
3. 与 story action、runtime、custom world 的 NPC 联动
|
||||
4. 与 `apps/api-server` 的 NPC 相关 facade 与流式交互对接
|
||||
5. 与 `apps/spacetime-module` 的 NPC 表、reducer、view 聚合对接
|
||||
|
||||
## 2. 当前阶段说明
|
||||
|
||||
当前提交仅完成目录占位,不提前进入对话生成、状态投影与交互规则实现。
|
||||
|
||||
后续与本 package 直接相关的任务包括:
|
||||
|
||||
1. 设计 `npc_state`
|
||||
2. 设计 `resolve_npc_interaction`
|
||||
3. 对齐 NPC 关系变化、招募、对话相关兼容输出
|
||||
4. 接入 story 主循环与 custom world 的 NPC 联动
|
||||
|
||||
## 3. 边界约束
|
||||
|
||||
1. `module-npc` 负责 NPC 状态真相与互动规则,外部 LLM 台词生成与流式文本输出不直接塞进模块内部。
|
||||
2. 对话与招募文案生成优先通过对应模块应用层和平台适配完成,NPC 状态最终回写到 `apps/spacetime-module` 聚合的状态模型中。
|
||||
3. 前端兼容接口与 SSE 由 `apps/api-server` 暴露,但 NPC 状态不能再次分散到会话缓存或前端临时状态中。
|
||||
Reference in New Issue
Block a user