# module-progression 独立模块 package 占位说明

日期：`2026-04-20`

## 1. package 职责

`module-progression` 是成长与章节推进模块 package，后续负责：

1. `player_progression`、`chapter_progression` 等成长状态模型
2. 等级、章节推进、敌对强度与进程规则
3. 与 runtime、story、quest 的成长联动
4. 与 `apps/spacetime-module` 的成长表、reducer、view 聚合对接

## 2. 当前阶段说明

当前提交仅完成目录占位，不提前进入成长规则、投影与兼容接口实现。

后续与本 package 直接相关的任务包括：

1. 设计 `player_progression`、`chapter_progression`
2. 设计 `update_progression_state`
3. 对齐章节推进、成长变化与兼容输出结构
4. 接入 runtime 与 story 的成长联动

## 3. 边界约束

1. `module-progression` 保持纯领域规则与状态建模，不直接承接 LLM、OSS 或 HTTP 协议。
2. 成长状态作为 runtime 与 story 的公共领域组件，不能再次散落回单个 handler 或临时 service 中。
3. 前端兼容输出由 `apps/api-server` 暴露，成长状态真相由 `apps/spacetime-module` 聚合。