153bc8b373
docs(10-26): 修复高级 II 读者问题（第2轮）
2026-10-21 20:25:18 +08:00
2d25a32660
docs(10-26): 修复高级 II 读者阻断问题（第1轮）
2026-10-21 20:09:28 +08:00
31f89f8b66
docs(10-25): 收口高级 II 互链与构建
2026-10-21 19:08:26 +08:00
6b4e02f79d
docs(10-25): 注册高级 II 侧边栏
2026-10-21 19:06:00 +08:00
635badf1ac
docs(10-25): 编写高级 II 导览
2026-10-21 19:05:29 +08:00
c154faea1c
docs(10-24): 编写高级 II 怪物上下文与战斗深入
2026-10-21 18:59:42 +08:00
ed7e174a87
docs(10-24): 编写高级 II 新增怪物属性
2026-10-21 18:59:04 +08:00
548007cdb7
docs(10-23): 编写高级 II 新增勇士属性
2026-10-21 18:50:08 +08:00
64fb0494d7
docs(10-23): 编写高级 II 自动寻路
2026-10-21 18:49:56 +08:00
e3c2a455a9
docs(10-22): 编写高级 II 自定义录像指令
2026-10-21 18:31:46 +08:00
6145607b18
docs(10-22): 编写高级 II 勇士装备系统
2026-10-21 18:31:34 +08:00
84e56d740c
docs(10-21): 编写高级 II 静态与动态图块
2026-10-21 18:13:02 +08:00
44dccc8914
docs(10-21): 编写高级 II 自定义范围对象
2026-10-21 18:12:17 +08:00
4bd1665a78
docs(10-20): 扩充 Store 内容与分项示例（用户第6轮）
2026-10-21 14:18:30 +08:00
2f181c8f2e
docs(10-20): 修订模板结构与注释（用户第5轮）
2026-10-21 13:01:21 +08:00
c578990810
docs(10-20): 修订存档/录像/Store/钩子（用户第4轮B）
2026-10-21 12:27:45 +08:00
b451da203d
docs(10-20): 修订声明式/插件（用户第4轮A）
2026-10-21 12:05:23 +08:00
6351cfea6e
docs(10-20): 修订插件渲染端/Store边界/代码块（用户第3轮）
...
- plugin-system 补充渲染端插件接口与完整示例，删除排序细节
- data-stores 删除 fromRaw 与缓存更新等阶段性深层说明，边界改为「极少需要自己补定义」
- 全部七篇代码块补成完整类/函数结构
- replay-consistency 保留 logReplaySafetyDetail 查详细信息的调用说明
- index 说明高级教程同时覆盖数据端与渲染端
2026-10-21 10:46:55 +08:00
74116b8d67
docs(10-20): 修订 Store/钩子/声明式（用户第2轮）
...
- data-stores：五个 Store 改为无序列表并补入 enemyStore；删除登记模板与验证节，改为讲读接口
- hooks-in-depth：统一为「一个对象一个钩子实例」，删除身份来源与共享实例内容
- declarative-vs-imperative：去掉 content 示例、地图伤害重述、验证节与改内置小节
- index：同步 Store 数量、钩子表述与 saveState 返回独立对象
2026-10-20 22:02:07 +08:00
8912f5d77d
docs(10-20): 修订插件/存档/录像（用户第2轮）
...
- 插件系统适配 dataDeps 与数据端/渲染端依赖方向
- 可存档内容明确顶层不自动 structuredClone，并补充执行器切换楼层示例
- 录像一致性改为分析式判断，提前说明录像记录缺失警告，删除收集区间细节
- 三篇收束边界与注意，删除改内置对比与重复示例
2026-10-20 21:45:55 +08:00
d35f8303da
docs(10-20): 补充插件示例的导入与放置说明
2026-10-20 17:38:43 +08:00
68e1f6f72c
docs(10-20): 高级 I 改为库文档风格（示例+注释）
...
- 删除七篇中的六步实操结构，改为叙述 + 带注释示例
- 移除 [模板] / [需改] 代码标记，验证段改为叙述
- 记录用户第 1 轮修订意见与构建结论
2026-10-20 17:33:49 +08:00
b8afe95e1b
docs(10-19): 修复高级 I 读者阻断问题（第1轮）
2026-10-20 16:23:19 +08:00
f1c0f8b2a4
docs(10-19): 按 D-58 调整高级教程模板与定位
...
- 高级 I 不再强制模板章节：移除 declarative、replay、hooks 的泛化骨架，保留 plugin、saveable 与精简后的 data-stores
- 移除「不懂代码就改内置」类中级提示，改为 D-55（新增系统优先插件，必要时才改内置）
- 补充 D-58 修订记录
2026-10-20 15:28:18 +08:00
5a6c3891b5
docs(10-18): 收口高级 I 互链与构建
2026-10-20 14:59:45 +08:00
9644e2de0f
docs(10-18): 注册高级教程导航与侧边栏
2026-10-20 14:56:02 +08:00
4dcac2f80a
docs(10-18): 编写高级 I 导览
2026-10-20 14:54:56 +08:00
30b7d867c6
docs(10-16): 核对源码并收口录像与 Store 文档
...
- 按 replay/func.ts 核对 shouldReplay 的路径登记、ignoreReplay 的整段忽略与 end 的三个提前返回
- 按核心源码说明收集入口目前只有测试调用，正文只描述「区间开启时」的口径
- 按 store 源码核对四个 Store 字段、键、读取返回形状与重复登记告警码
- 修正静态图块现查 / 动态图块缓存的差异，避免「改 Store 不影响已有对象」的过度概括
- prettier 通过，构建 green、build complete、无 dead link
2026-10-20 14:36:42 +08:00
25e8dcb28b
docs(10-16): 编写 data-common 的 Store 文档
...
- 逐个讲清 tileStore / itemStore / mapStore / eventStore 存什么、键与读取接口
- 区分 Store 定义与运行时对象，说明运行时只读的原因
- 给出正确注册位置与「模板：在加载期注册 Store 原始数据」
- 说明 EnemyStore 不在 IDataCommon 上，并给出六步实操与验证
2026-10-20 14:28:52 +08:00
65801ea74b
docs(10-16): 编写录像一致性文档
...
- 讲清 @shouldReplay / @ignoreReplay 的落点：状态变更入口 vs 延迟被动路径
- 说明 @ignoreReplay 作用于整段收集区间，不是单个方法
- 说明能保证什么、不能保证什么，以及检测机制与边界
- 给出「模板：给方法加录像标记」与六步实操「给一个内置方法补录像标记」
2026-10-20 14:26:51 +08:00
c1589ecf04
docs(10-15): 核对源码并收口可存档文档
...
- 补齐读档开始时清理录像禁用标记的细节
- 修正注册时机表述，避免暗示晚注册无法生效
- prettier 与文档构建门禁通过
2026-10-20 13:32:35 +08:00
bf18d4b39d
docs(10-15): 编写可存档内容
...
- 新增高级 I 可存档内容一篇，覆盖一致性与 structuredClone 约束
- 说明注册、三级压缩、存档顺序与执行器时机
- 给出通用模板、插件计数器示例与验证步骤
2026-10-20 13:20:57 +08:00
5109d32515
docs(10-17): 核对源码并收口钩子文档
2026-10-20 13:08:03 +08:00
e074c73433
docs(10-17): 编写钩子文档
2026-10-20 13:00:01 +08:00
876529b397
docs(10-14): 核对源码并收口插件文档
2026-10-20 12:39:58 +08:00
1b92ee4c5e
docs(10-14): 编写插件系统
2026-10-20 12:38:34 +08:00
7285ab9fa3
docs(10-13): 核对源码并收口声明式文档
2026-10-19 22:12:26 +08:00
47777bcb94
docs(10-13): 编写声明式与命令式接口
2026-10-19 22:08:10 +08:00
aea30987f6
docs(10-11): 修复加粗边界导致的不渲染
...
- flags.md 第 14/15 行加粗短语以标点结尾致 flanking 失败，调整结构使加粗内容以汉字结尾
- 全量扫描 docs/intermediate/*.md（排除代码 span/围栏），确认 0 处真实失效
- READER-REVIEW 追加 batch 11 记录
2026-10-19 19:43:40 +08:00
e64167b7c5
docs(10-11): 按 D-51 微调特殊属性落点与讲解方式
...
- 特殊属性实现写进已有文件（aura.ts 等），仅查询属性新建 query.ts
- aura.ts / query.ts 建议用 //#region {code}-{name} 包裹
- 通俗解释「副作用」；地图伤害按计算后怪物计算，光环加的特殊属性会真实生效
- 依赖并修改外部环境应拆成查询 + 光环、用新怪物属性桥接（指向高级教程）
- getCriticalLimit 提一句并指向高级教程；接口讲解改为「为了实现 X，改 Y 接口」
- 追加 batch 10 读者审阅记录
2026-10-19 19:28:18 +08:00
a50210aec2
docs(10-11): 按 D-50 增加通用机制模板（战斗组）
2026-10-19 18:25:55 +08:00
486784fdcf
docs(10-11): 按 D-49 调整战斗篇（改内置优先）
...
- 7 篇战斗教程改为「先改内置」为主线，示例类移到末尾并加 D-49 caveat
- enemy-specials/aura/final/calculator/map-damage/combat-script/status-hooks
- READER-REVIEW 追加 batch 8（D-49 战斗框架）记录
2026-10-19 18:09:59 +08:00
9c57673e0a
docs(10-11): 按 D-49 改类示例与改内置定位（查询/钩子）
2026-10-19 16:47:31 +08:00
3aae27a939
docs(10-11): 新增图块存储（TileStore）文档并注册侧边栏
...
- 新增 docs/intermediate/tile-store.md：讲解 state.tileStore 与图块数字/id 区别，附 D-48 实操
- config.ts 基础接口组加入「图块存储」侧边栏条目（8→9）
- 10-11-READER-REVIEW.md 记录 U-03 完成
2026-10-19 15:45:48 +08:00
66a75b08ad
docs(10-11): 按 D-48 重做实操（其他组）
...
- events.md：设置 Flag / 勇士回血 两个示例改写为六步实操，删除 import 并补复制说明；删去约 100 个 / 发布前 数量类信息（保留内置事件集已完整的视角）
- data-plugins.md：注册插件片段删除 import 并补复制说明，包来源改为直接说明；生命周期讲解与占位示例保留
- 10-11-READER-REVIEW.md：追加用户循环 batch 6（D-48 实操·其他）记录
2026-10-19 15:39:45 +08:00
454325052f
docs(10-11): 按 D-48 重做实操（战斗组）
...
- 战斗组 9 篇的实操/示例改为六步（目标→改哪里→复制什么→改什么→怎么验证→注意）
- 各篇代码片段去掉 import，并补统一复制说明（指向 code-basics）
- 保留系统/原理讲解与 U-07..U-19 既有修正；combat-overview 无实操不改
- 追加 10-11-READER-REVIEW.md 的 batch 5 记录
2026-10-19 15:30:42 +08:00
cfa602f25c
docs(10-11): 按 D-48 重做实操（概念+基础接口）
...
- 概念/基础接口 12 篇的实操部分改为六步照抄式（目标/改哪里/复制什么/改什么/怎么验证/注意）
- 片段一律去掉 import，统一附复制说明并指向 code-basics 的复制约定
- code-basics 删除 dev.md 的 import 置顶约定句，新增「照抄教程里的代码时，怎么处理 import」小节
- 仅改 docs/intermediate/*.md 与本篇审阅记录
2026-10-19 15:15:45 +08:00
687e248ac1
docs(10-11): 用户修订循环 batch3（基础/其他 + 高级教程预留）
...
- U-01 src-tour：content 层主要在编辑器内改、对应初级教程
- U-02 data-state-overview：解释 state 静态类型按 L0-L3 逐层累加
- U-04 map-structure：按 alias/zIndex 取指定图层（非 addLayer）
- U-05 map-tiles：putMapData/getMapData 完整示例 + 高级教程预留
- U-06 flags：区分字段对象与字段值，两组接口如何选择
- U-20 events：以内置事件集已完整（发布前约 100 个）视角改写
- U-21 replay-commands：录像指令细节留高级教程
- U-22 11 篇：高级教程显式说明 + 非链接预留标记
2026-10-18 14:45:00 +08:00
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
