Commit Graph

7 Commits

Author SHA1 Message Date
5c77676bca docs(10-11): 用户修订循环 batch2(代码讲解/修正)
按用户领域视角修订循环 batch 2(U-12/U-13/U-16/U-17/U-18/U-19)修正战斗各篇:

- U-12/U-16:转换器 / 视图 / 效果 / 计算器 / 脚本 / 钩子代码块补逐行中文注释,并用 [模板] / [需改] 标出可照抄与必须修改的部分
- U-13:新增「注册在哪里」,给出 initializeEnemy 函数体(无关行省略)与注册调用位置
- U-17:每篇明确「改内置实现」vs「写自己的类」的区别与各自效果
- U-18:enemy-map-damage 的「受地形遮挡的激光」示例替换为更简单的「八方向激光」(FaceGroup.Dir8)
- U-19:enemy-calculator 补「计算器必须无副作用」;enemy-status-hooks 的「下次战斗伤害乘二」改为钩子挂状态 + 计算器只读 + 战斗脚本消费

docs 8 篇;10-11-READER-REVIEW.md 追加 batch 2 记录。
2026-10-18 14:30:51 +08:00
8c5e8979e1 docs(10-11): 用户修订循环 batch1(战斗概念/说明)
- combat-overview/enemy-specials: 说明上下文重建时机(惰性、一般无需手动)
- enemy-final/aura/query: 补「既依赖又改外部」不提供的原因(循环依赖)
- enemy-specials: getSpecial<T> 泛型说明 + 特殊属性定义逐行注释与动态文案
- enemy-aura: 转换器/视图大白话,每条属性可对应不同转换器
- enemy-query: query() 必须调用 + 查询上下文改为只读 IReadonlyEnemyContext
- 追加 10-11-READER-REVIEW.md 用户循环 batch1 记录
2026-10-18 14:07:25 +08:00
4f4090d5c5 style(10-11): prettier 格式化中级教程文档 2026-10-17 22:22:37 +08:00
beedb185d1 docs(10-11): 迭代修正读者阻断问题(第3轮)
- 地图伤害编号改为对齐后的权威表:领域 13 / 夹击 14 / 阻击 16 / 激光 22 / 捕捉 25
- 伏击统一改为捕捉,明确伤害恒 0 属设计如此;实际结算已接通
- 更新特殊属性与战斗脚本中的编号说明,移除未对齐叙述
- 补充查询注册签名差异,并让「同化」描述与示例逻辑一致
2026-10-17 22:20:37 +08:00
927611182b docs(10-11): 迭代修正读者阻断问题(第1轮)
- 修正 B-01..B-13 共 13 条阻断性理解问题(详见 10-11-READER-REVIEW.md 第 1 轮记录)

- src-tour 新增「包从哪来」概念,并在用到包名 import 的篇目交叉引用

- 结构门禁 STRUCT-OK;构建 green、dead link = 0
2026-10-17 21:50:12 +08:00
f5e432d04f docs(10-08): 引导式重写 enemy-aura/query/final
- enemy-aura:先讲「光环影响周围」,再引出优先级与 apply/applySpecial
- enemy-query:从「需要看周围」引入查询,保留未内置警示与三示例
- enemy-final:从「最后收尾」引入最终效果,保留三方对比与仿攻示例
2026-10-17 21:05:12 +08:00
e13ebf71ed docs(10-04): write query, final, and calculator docs
- document query effects as new, not built into the engine
- add final effect comparison and attack-copy example
- explain damage formula, critical conventions, and arithmetic example
2026-10-17 18:44:16 +08:00