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
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
2494629f0d
fix: 属性编号问题
2026-10-17 22:15:03 +08:00
c1b1bd5301
fix: 特殊光环没有 couldApplySpecial = true
2026-10-17 22:05:51 +08:00
0207f3ce7b
docs(10-11): 迭代修正读者阻断问题（第2轮）
...
- B-03: enemy-specials.md 新增「内置属性编号表」（0..26，逐条抄自当前 special.ts），表下 warning 诚实标注地图伤害转换器编号未对齐（以 special.ts 为准，不臆造对齐表）
- B-03: enemy-map-damage.md 明确点出 code 18 在内置表=无敌、转换器=阻击的双重含义
- B-03: enemy-combat-script.md 的 code 18 示例注明 18=无敌，并说明转换器未对齐与本篇无关
- R2-01: 解释 @motajs/anon-tokyo 的来历（events.md + src-tour.md「包从哪来」）
- R2-02: enemy-aura.md 补 ISpecial23Value 字段说明表
- R2-03: 补 initializeEnemy 一句话介绍（集中注册入口，内置/自定义同一流程）
- R2-04: events.md 说明参数接口实际放入 src/data/event/types.ts
- R2-05: hero-equipment.md 接口清单补 compareEquip
- R2-06: enemy-map-damage.md code-43 示例补关键类型注解
- 追加第 2 轮复审与修正记录到 10-11-READER-REVIEW.md
2026-10-17 21:59:56 +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
b09da5b129
docs(10-10): complete 基础接口组引导式重写 plan
2026-10-17 21:25:57 +08:00
5be78db471
docs(10-10): 引导式重写 map-tiles、flags
2026-10-17 21:24:07 +08:00
3836afe5d9
docs(10-10): 引导式重写 hero-location、map-structure
2026-10-17 21:23:14 +08:00
b4d1202a74
docs(10-10): 引导式重写 hero-items、hero-equipment
2026-10-17 21:22:33 +08:00
ef8cd06c07
docs(10-09): complete 概念组与其他组引导式重写 plan
2026-10-17 21:19:33 +08:00
1deb860359
docs(10-09): 引导式重写 replay-commands、data-plugins
...
- replay-commands 以「重放要先记全」引导核心原则，保留主动/被动与装饰器，不给示例
- data-plugins 以「一组功能打包按时初始化」引导，保留时机次序与占位示例（N-4）
2026-10-17 21:17:12 +08:00
d882668ba0
docs(10-09): 引导式重写 hooks、events
...
- hooks 以「某个动作发生时想插一手」引导，保留需求→钩子对照表与 addHook/removeHook
- events 以「内建动作 + 也能自己加」引导，保留 BuiltInFunction、env、注册与两示例
2026-10-17 21:16:33 +08:00
ea8e6f20c8
docs(10-09): 引导式重写 src-tour、code-basics
...
- src-tour 以「该改哪个文件」引导，保留该不该改表、constant.ts，不含已弃用项
- code-basics 保持三段式与引导口吻，泛型比作类型的函数，保留 D-23 唯一外链
2026-10-17 21:15:46 +08:00
5ed2df4d29
docs(10-08): complete 战斗组引导式重写 plan
2026-10-17 21:06:49 +08:00
de5e9e1229
docs(10-08): 引导式重写 calculator/script/status-hooks
...
- enemy-calculator：从「属性换算成伤害」引入，保留公式导读与临界约定
- enemy-combat-script：从「战斗前后的规则」引入，保留脚本/钩子选型表
- enemy-status-hooks：从「状态要反复生效」引入，强调多钩子协同
2026-10-17 21:05:18 +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
b1b7c8e0e7
docs(10-08): 重写 combat-overview、enemy-specials（引导式）
...
- combat-overview 用平实语言解释计算后怪物、为何重建、为何分四步
- enemy-specials 改为引导式开篇，保留两类定义、实现位置表与编辑器约定
2026-10-17 21:05:06 +08:00
a24457cfef
docs(10-07): complete 修正 D-09 复审第 1/3/4 条 plan
...
- 讲清 state 三类获取方式；清除 2 处 legacy 泄漏（全 24 篇扫描）
- 纠正 hero-attribute 修饰器定位为临时/永久皆可；构建转绿
2026-10-17 20:58:48 +08:00
27050e91a5
docs(10-07): 纠正修饰器定位
...
- 标题「修饰器：临时的加减与百分比」改为「修饰器：数值与百分比加成」
- 改写表述：修饰器临时/永久皆可，是否临时取决于何时移除
- 新增临时用法说明（addModifier 挂上、不再需要时 deleteModifier 移除）；保留永久示例与 save 语义
2026-10-17 20:57:09 +08:00
488c108b4c
docs(10-07): 清除 legacy 泄漏
...
- data-vs-render 移除含 legacy 全局包裹接口 Mota.r 的 :::info，改为平实说明
- enemy-map-damage 去除旧主对象全局前缀 core.flags，保留 flag 名 betweenAttackMax
- 全 24 篇 legacy 扫描：除上述两处外无其它 legacy 命中（ICoreState/core.jsonc 不计入）
2026-10-17 20:57:02 +08:00
b30140ddcb
docs(10-07): 讲清 state 获取方式
...
- data-state-overview 用平实语言解释主对象 state（总目录比喻）
- 新增「state 从哪来」小节：框架参数传入（useEffect/插件/env.state）、handler.state、this.state
- 说明示例假设 state 已在作用域中；保留对象表与 L0-L3 分组
2026-10-17 20:56:52 +08:00
49ecbfb89e
docs(10): add D-09 review revision plans (10-07..10-12)
2026-10-17 20:25:05 +08:00
36d38907ff
docs(10-05): complete events, replay-commands, data-plugins plan
2026-10-17 19:00:50 +08:00
2266c15595
docs(10-05): write events, replay-commands, and data-plugins docs
...
- events: BuiltInFunction, IBlockEventEnv, createEventRegistrations, setFlag/healHero examples
- replay-commands: core principle, Active/Passive, @shouldReplay/@ignoreReplay (no example)
- data-plugins: IDataPluginDefine lifecycle, dataPlugins registration, placeholder example
2026-10-17 18:59:50 +08:00
7a7cda24b2
docs(10-04): complete battle docs plan
2026-10-17 18:47:46 +08:00
0868650847
docs(10-04): write map damage, combat script, and status hook docs
...
- document map damage views, converters, reducers, and code mapping caveat
- add combat script selection table and before/after examples
- explain multi-hook status handling and calculator integration
2026-10-17 18:45:48 +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
5528edc70d
docs(10-04): write combat overview, specials, and aura docs
...
- add combat flow overview with mermaid and doc map
- document special attribute definitions and implementation locations
- document aura priority, built-in auras, and custom examples
2026-10-17 18:43:06 +08:00
678addf2a4
docs(10-03): complete basic-interfaces docs plan
...
- 8 篇基础接口教程落位；构建通过、无 dead link
- SUMMARY 记录实测 commits=3、plan_head_before
2026-10-17 18:05:03 +08:00
a3f55112b7
docs(10-03): write map-tiles and flags
...
- 地图图块：getBlock/setBlock/removeBlock/putMapData/getMapData/iterateBlocks
- Flag 变量：全部接口（含 occupied/getOrInsertComputed）与使用建议
2026-10-17 18:02:07 +08:00
0d14d32a48
docs(10-03): write hero-equipment, hero-location, map-structure
...
- 勇士装备：装备槽与实例仓库、装备加成即修饰器、compareEquip
- 勇士位置：坐标、朝向与楼层的获取
- 地图结构：楼层集合、楼层激活、楼层与图层（含事件层）
2026-10-17 18:01:19 +08:00
627a40bc4b
docs(10-03): write data-state-overview, hero-attribute, hero-items
...
- 数据端总览：state 入口、常用对象表与 L0-L3 分层标注
- 勇士属性：基础/最终属性、修饰器、save 语义、只读与试算
- 勇士道具：四种类别区分与 addItem/useItem/iterateItems 等接口
2026-10-17 18:00:04 +08:00
0348c30893
docs(10-02): complete concept-and-navigation docs plan
...
- 10-02-SUMMARY.md: 4 concept docs (data-vs-render/src-tour/code-basics/hooks)
with measurements, decisions, and coverage block
2026-10-17 17:51:55 +08:00
c47aa5269b
docs(10-02): write code-basics and hooks concept docs
...
- code-basics: concise syntax, modules/imports, types intro (generics as
'functions of types'), interface/implements convention, approved external link
- hooks: what hooks are, common hook families, need-to-hook table, addHook/
removeHook usage, async hooks
2026-10-17 17:49:49 +08:00
2ea8cb33f5
docs(10-02): write data-vs-render and src-tour concept docs
...
- data-vs-render: dual-end split (compute vs draw), src/data vs src/client,
mermaid diagram, replay verification runs data side only
- src-tour: tour src/data, src/client, src/content, src/constant.ts plus a
should-you-edit table
2026-10-17 17:48:28 +08:00
ebc61e620a
docs(10-01): complete clear-legacy-docs + register-intermediate plan
2026-10-17 17:40:33 +08:00
ca3a61fb81
docs(10-01): register intermediate tutorial nav entry and sidebar
...
- add nav entry 中级教程 -> /intermediate/data-vs-render
- add sidebar['/intermediate/'] with 4 groups / 24 links (4/8/9/3)
2026-10-17 17:39:03 +08:00
e3d61ee14f
docs(10-01): clear legacy docs and decouple API sidebar from build
...
- delete docs/index.md and docs/guide, dev, logger, api trees
- drop old nav entries and guide/logger/api sidebar keys from config.ts
- remove apiSidebar import and listenSidebar() plugin; drop unused Plugin import
- guard generateSidebar() with existsSync when docs/api is absent
2026-10-17 17:37:43 +08:00
1099583b07
docs(10): rewrite 10-01 to clear legacy docs + register intermediate; refresh 10-06/10-CONTEXT/ROADMAP
2026-10-17 16:36:11 +08:00
6a42bf42d4
docs(10): create phase plan (intermediate tutorial 24 docs + site registration)
2026-10-16 21:06:26 +08:00
7af881d655
docs: 删除已完成 TODO 注释
2026-10-16 20:45:21 +08:00
3f74d5f25e
feat: 完善内置特殊属性
2026-10-16 20:30:04 +08:00
a0e402728e
refactor: 数据端用户结构
2026-10-16 17:29:51 +08:00
0a133058ca
refactor: 渲染端初始化移动至主插件
2026-10-16 00:41:58 +08:00
7fde97ff1e
feat: list 文件的配置类型定义
2026-10-15 14:59:48 +08:00
d1ebca0b16
chore: 调整加载接口
2026-10-14 20:41:14 +08:00
