来源: AGENTS.md ai/project-map.yml src/AGENTS.md data/AGENTS.md tests/AGENTS.md android/AGENTS.md commit 3053bf160578 docs-explanation

子系统地图

这张地图用于找到入口，不替代源码阅读。修改前继续读取目标路径最近的 AGENTS.md。

子系统	主要路径	常见相邻契约
Character / Avatar	src/character*、src/avatar*	effect、activity、mutation、save
Items / Inventory / Pockets	src/item*、src/inventory*、src/item_pocket*	JSON item type、crafting、vehicle
Creatures / Monsters	src/creature*、src/monster*	monster JSON、effects、map
Map / Mapgen	src/map*、src/mapgen*	terrain/furniture、overmap、save
Overmap	src/overmap*	overmap terrain/special、mapgen
Vehicles	src/vehicle*	vehicle part JSON、map、activity
Crafting	src/crafting*、src/recipe*	item IDs、requirements、inventory
Mutation / Effects	src/mutation*、src/effect*	JSON factories、Character、EOC
Activities	src/activity*、src/player_activity*	actors、Character、serialization
UI / Input	src/*ui*、src/input*	SDL/curses、translation、platform
Save	src/savegame*、src/save_snapshot*	every serialized owner、migration
Mod loading	src/mod_manager*、data/mods/	dependencies、JSON load order
Lua bridge	src/lua_platform*、data/lua/	ModDefinition、LuaLS、registrations
Localization	lang/、src/translations*	extraction、PO/MO、UI
Android	android/	Gradle、JNI/native build、SDL3

测试通常按行为而不是按源码目录一一对应。先用 rg 查找类型、注册名或稳定 ID，再在 tests/ 中查找相同符号和用户可见行为。跨子系统修改应明确对象所有权、生命周期、 序列化和性能热点。