背景
基于 docs/battle-system-mechanics.md 及其分章节，对当前仓库进行了一次完成度 review。
当前仓库已经具备：
- 一个可运行的最小 CLI 战斗 demo
srsim.core 下的最小战斗主循环、时间线、事件流、状态、伤害、削韧/击破、治疗/护盾能力tests/test_battle.py 与 tests/test_demo_cli.py 的最小回归- 一套独立的
role_api 数据加载与查询 API
但与 battle docs 目标中的“可扩展、可配置的通用战斗模拟器”相比，仍有若干核心缺口需要拆开推进。
本 issue 目标
作为 battle docs 落地的总跟踪项，汇总以下子任务：
Review 摘要
已完成：
- 时间线基础 AV 推进，速度变化后剩余 AV 按比例换算
- Basic / Skill / Ultimate 的最小动作执行与 SP/Energy 基础资源流
- 事件流基础骨架：Battle/Wave/Turn/Action/Hit/Damage/Break/Status/Kill
- 基础直伤公式、治疗、护盾、Weakness Break 与 Broken 恢复
- 最小状态生命周期（owner turn start / end）
- 最小单体 AI 与 CLI demo
role_api 的数据重建、查询、测试- 特殊行动窗口骨架：Ultimate 插队、Extra Turn、强类型插队队列、正确 AV 变换接口
未完成或仅部分完成：
- 更细粒度的事件钩子与统一动作上下文
- 文档中的状态通用模型、驱散/净化、叠层策略与更多 tick 时机
- 文档中的仇恨、强制选中、Bounce、特殊目标脚本
- 文档中的配置化规则层（SP/Energy/Aggro/tie-break/wave carry-over）
- 文档中的召唤物、倒计时对象、忆灵/特殊实体建模
- 文档中的特殊伤害分类与对应公式分支
- battle docs 第 18 章剩余回归测试场景
验证
.venv/bin/pytest -q 通过.venv/bin/ruff check src tests 通过
背景
基于
docs/battle-system-mechanics.md及其分章节，对当前仓库进行了一次完成度 review。当前仓库已经具备：
srsim.core下的最小战斗主循环、时间线、事件流、状态、伤害、削韧/击破、治疗/护盾能力tests/test_battle.py与tests/test_demo_cli.py的最小回归role_api数据加载与查询 API但与 battle docs 目标中的“可扩展、可配置的通用战斗模拟器”相比，仍有若干核心缺口需要拆开推进。
本 issue 目标
作为 battle docs 落地的总跟踪项，汇总以下子任务：
Review 摘要
已完成：
role_api的数据重建、查询、测试未完成或仅部分完成：
验证
.venv/bin/pytest -q通过.venv/bin/ruff check src tests通过