Appearance
知识卡索引
原子化架构知识层，共 267 张卡：记录「某个子系统现在长啥样、去哪找」。与 ADR（为什么这么决定）互补——知识卡引用而不复制 ADR 结论。
卡片格式规范、立卡判据、
source_files铁律见 知识卡层导读；AI 检索入口见 路由表；菜单全景见 menu-map（机器生成）。
分类总览
| 分类 | 卡片数 | 说明 |
|---|---|---|
| env | 24 | 环境系统 |
| scene | 34 | 场景编排 |
| physics | 5 | 物理系统 |
| rendering | 18 | 渲染系统 |
| motion | 34 | 动作系统 |
| ui | 58 | UI / 菜单 |
| core | 76 | 核心基础设施 |
| backend | 18 | 后端 |
env
环境系统
| 卡片 | 关联 ADR |
|---|---|
| 环境状态写入入口（setEnvState + 中间件链） | - ADR-138 |
| 环境碰撞控制 | - ADR-212 |
| 环境变更分发回调（破循环依赖） | - ADR-138 |
| 环境重力控制 | - ADR-148 |
| 地面材质单一事实源（GroundMaterialSpec） | - ADR-226 |
| 地面系统 | - ADR-114 |
| 环境系统实现核心（barrel + observer + fog） | - ADR-138 |
| 环境灯光包装 | - ADR-132 |
| 环境状态防抖持久化 | - ADR-148 |
| 时间流转与太阳角系统 | - ADR-148 |
| 水面系统 | - ADR-062 |
| 环境系统门面（Facade） | - ADR-128 |
叶子模块 / 工具函数（12 张）：env-caustics · env-clouds · env-context · env-particles · env-reflection · env-sky · env-terrain · env-texture · env-type-helpers · env-underwater-fog · env-wetness · planar-reflection
scene
场景编排
| 卡片 | 关联 ADR |
|---|---|
| AR 摄像头视频透传 | - ADR-055 |
| AR 模式场景级协调 | - ADR-055 |
| 相机状态管理 + 运行时上下文 | - ADR-100 |
| 相机模式管理系统（MmdCamera） | - ADR-035 |
| 脚部落地检测降级 | - ADR-088 |
| 分类材质系统 | - ADR-188 |
| PMX 模型加载与缩略图捕获 | - ADR-124 |
| 模型注册表与生命周期管理 | - ADR-049 |
| 模型生命周期操作 | - ADR-049 |
| 换装叠加层 | - ADR-242 |
| 换装系统 | - ADR-242 |
| 场景序列化与自动保存 | - ADR-049 |
| 场景核心编排器（纯组装器） | - ADR-099 |
| SSS PBR 材质 | [] |
| 变换适配器注册表（双模态去重） | - ADR-126 |
| 拖拽变换模式开关 | — |
| 变换选中物状态源 | - ADR-171 |
叶子模块 / 工具函数（17 张）：camera-angle · camera-auto · camera-behaviors · camera-bone-lock · camera-factory · camera-vmd · composition-guide · model-id · pmx-texture-audit · scene-bundle · scene-migrate · texture-fallback · texture-lru · thumbnail-capture · thumbnail-key · transform-pick · watermark
physics
物理系统
| 卡片 | 关联 ADR |
|---|---|
| 物理骨骼桥与每帧注册表 | - ADR-081 |
| 虚拟裙骨物理控制器（ADR-084 Phase 2-3） | - ADR-084 |
| 风力物理注入（WASM Bullet） | - ADR-104 |
叶子模块 / 工具函数（2 张）：ground-collision · skirt-analyzer
rendering
渲染系统
| 卡片 | 关联 ADR |
|---|---|
| GPU 压缩纹理能力探测 | - ADR-189 |
| 个人灯光跟随 | - ADR-168 |
| 灯光预设系统 | - ADR-168 |
| 场景光照与阴影（barrel） | - ADR-132 |
| 性能监控与自动降级 | - ADR-159 |
| 场景渲染管线与后处理 | - ADR-076 |
叶子模块 / 工具函数（12 张）：ar-webxr-probe · invertablePointersInput · light-cone · lighting-shadow · lighting-stage · lighting-state · lighting-sun · lighting-tween · mirror-debug · performance-env-bridge · quality-profile · transform-gizmo
motion
动作系统
| 卡片 | 关联 ADR |
|---|---|
| 外部动作重定向桥 | - ADR-108 |
| 骨骼覆盖存储（多模块仲裁） | - ADR-084 |
| 骨骼覆盖核心 API | - ADR-061 |
| 口型同步桥 | - ADR-021 |
| 脚部地面跟随（MMD-native IK） | - ADR-085 |
| 动作历史管理 | - ADR-125 |
| 场景级动作意图库 | - ADR-121 |
| 动作模块基类 | - ADR-116 |
| 动作模块注册表 | - ADR-116 |
| 动作管线（逐帧合成） | - ADR-147 |
| 动作播放控制 | - ADR-204 |
| 感知层主控 | - ADR-071 |
| 程序化动作系统 | - ADR-021 |
| 多 VMD 叠加系统 | - ADR-051 |
| VMD 动作加载器 | - ADR-051 |
叶子模块 / 工具函数（19 张）：hand-symmetry · motion-footstep · motion-math · motion-module-types · motion-modules-body-posture · motion-modules-feet · motion-modules-riding · motion-preset-types · perception-balance · perception-blinking · perception-breathing · perception-expression · perception-gaze-js · perception-gaze-wasm · perception-gaze · perception-lipsync · perception-observer · perception-shared · wasm-layers-blender
ui
UI / 菜单
| 卡片 | 关联 ADR |
|---|---|
| 渲染层 DOM 契约单源 | - ADR-229 |
| 环境弹窗（编排 + barrel） | - ADR-065 |
| 资源库操作 | - ADR-131 |
| 资源库核心 | - ADR-131 |
| 资源库初始化 | - ADR-017 |
| 资源库入口与编排 | - ADR-045 |
| 菜单 Overlay 与 Wrapper 管理 | - ADR-191 |
| 声明式菜单 Schema | - ADR-093 |
| 菜单栈共享指针（stackRegistry） | - ADR-191 |
| 滑出式菜单引擎（SlideMenu） | - ADR-065 |
| 模型预设管理 UI | - ADR-145 |
| 动作绑定 UI | - ADR-129 |
| 动作详情 UI | - ADR-167 |
| 动作菜单层级系统 | - ADR-071 |
| 广场状态管理 | - ADR-087 |
| 菜单渲染引擎 | - ADR-093 |
| 场景弹窗（编排 + 路由） | - ADR-065 |
| 设置共享工具 | - ADR-157 |
| 设置页路由与编排 | - ADR-157 |
| 基础行控件构建器 | - ADR-140 |
叶子模块 / 工具函数（38 张）：assistant-panel · diagnostic-chat · diagnostic-config · diagnostic-control · diagnostic-session · diagnostic-state · env-menu-levels · library-browse · library-session-store · menu-factory · menu-registry · menu-schema-register · model-detail · model-material-ui · motion-override-levels · outfit-ui · plaza-browser · plaza-creators · plaza-download · plaza-sites · plaza-thumbnail · preset-list-viewer · scene-drag-levels · scene-menu-levels · scene-menu-state · scene-stage-lights · settings-about · settings-actions · settings-appearance · settings-controls · settings-diagnostic · settings-graphics · settings-language · settings-media · settings-resources · settings-system · settings-targets · ui-helpers
core
核心基础设施
| 卡片 | 关联 ADR |
|---|---|
| 统一动作注册表 — 菜单/NL/快捷键共享真相源 | - ADR-197 |
| AI 配置持久化（IndexedDB） | - ADR-196 |
| 错误环形缓冲与全局捕获 | - ADR-196 |
| NL 意图解析 — LLM 文本 → 动作执行 | - ADR-155 |
| 场景运行时快照（AI 上下文） | - ADR-196 |
| 内置 AI 诊断助手 — 双适配器服务层 | - ADR-196 |
| 安卓文件访问（shared 模式） | - ADR-017 |
| 音频总线 | - ADR-088 |
| 后端适配层 | - ADR-176 |
| EnvState 默认值派生 | - ADR-243 |
| EnvState 单一源 Schema | - ADR-137 |
| 事件处理与导航系统 | - ADR-102 |
| 结构化反馈 API | — |
| 统一文件服务层 | - ADR-057 |
| 应用启动引导 | - ADR-003 |
| 统一资源加载队列 | - ADR-045 |
| 模型加载/库扫描完成后菜单刷新注册表 | — |
| 国际化语言状态 | - ADR-059 |
| babylon-mmd 适配边界 | - ADR-192 |
| 轨道相机键盘输入状态叶子 | - ADR-049 |
| 渲染循环与 FPS 时钟 | - ADR-102 |
| 资源加载失败统一汇总 | — |
| Runtime 隔离桥（Wails Events/Browser） | - ADR-177 |
| 运行模式检测 | - ADR-099 |
| 快捷键注册表 | - ADR-036 |
| 全局状态与场景运行时 Store | - ADR-141 |
| 键盘导航工具 | - ADR-153 |
| 后端绑定聚合层（backend 代理化） | - ADR-176 |
叶子模块 / 工具函数（48 张）：ai-sse · character-bible · chat-store · color-helpers · config-barrel · core-dom · core-leaf-modules · core-orbit · core-types · core-utils · dev-hooks · diagnostic-actions · dialog · dispose-helpers · drop-import · e2e-state-bridge · goerr · hash-noise · i18n-t · icons-bundle · logger · markdown · mmar-globals · observer-handle · outfits-spec · platform · pmx-meta · preset-meta · reactivity · render-context · runtime-stub · safe-call · scene-action-bridge · shortcut-app · status-bar · theme · toast · ui-action-bridge · ui-constants · ui-focus-trap · ui-header-toggle · ui-nav-item · ui-preset · ui-slider-controller · ui-state · wind-utils · zh-CN · zh-TW
backend
后端
| 卡片 | 关联 ADR |
|---|---|
| Go 后端核心（App 生命周期 + 配置系统） | - ADR-066 |
| Go 文件与路径平台抽象 | - ADR-195 |
| Go 模型隔离与安全 HTTP | — |
| Go 软件集成（Blender/MMD/自定义） | — |
| Go KTX2 纹理编码 | — |
| Go 模型库扫描 | - ADR-189 |
| Go LLM 客户端与 AI 绑定 | — |
| Go 广场窗口与配置 | — |
| Go 预设持久化与标签 | - ADR-145 |
| Go 模型广场代理（SSRF 防护） | — |
| Go 场景序列化与打包 | — |
| Go 更新检查与安装 | - ADR-179 |
| Go 下载目录监听与导入 | — |
| Go ZIP 解压与缓存管理 | - ADR-057 |
叶子模块 / 工具函数（4 张）：go-dialogs · go-i18nerr · go-thumbnail · go-util
ADR 反查
从卡片
adr:字段反向聚合：某条决策影响了哪些子系统。正向导航见 决策记录索引。