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
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
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
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
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
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
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
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
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
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
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
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
1717400945
refactor: 触发器
2026-07-27 18:04:05 +08:00
f6383e41e8
feat: 录像数组
2026-07-13 23:19:17 +08:00
376b0fcac5
feat: 装备系统
2026-07-10 15:30:20 +08:00
3ac14f8757
feat: 勇士身上的道具
2026-07-03 20:05:31 +08:00
9b3c3a4e40
feat: 道具效果存储
2026-07-01 23:45:06 +08:00
6029d038c6
feat: IITemStore
2026-07-01 22:19:48 +08:00
327bdc840b
docs: 更新提示词
2026-06-29 23:08:31 +08:00
0508dfb9e4
feat: 地形通行性判断
2026-06-28 22:42:27 +08:00
fadcc98864
refactor: 跟随者与勇士移动
2026-06-27 20:33:49 +08:00
9f62d8768e
feat: 战斗流程
2026-06-14 00:31:10 +08:00
d6275c0ea7
docs: 战斗流程
2026-06-01 16:21:34 +08:00
