Appearance
决策记录（ADR）
架构决策日志，共 253 篇（ADR-001 起按编号递增）。决策一旦写下即不可变；状态变化以各 ADR 文件首部「状态」行为准。
按状态分布
| 状态 | 数量 | 含义 |
|---|---|---|
| 推进中 | 6 | 已开工，尚未收口（含部分实施） |
| 规划中 | 7 | 已立项，等待实施 |
| 已落地 | 229 | 实施完成，代码已合入 |
| 已归档 | 11 | 被取代、放弃、过时或搁置，保留供追溯 |
本文件为 ADR 规范索引（按状态分组导航，可锚点跳转）。带日期的全量列表见 项目现状 · ADR 索引（附表，由
scripts/gen-status-index.mjs生成）。
推进中
| ADR | 主题 | 状态 |
|---|---|---|
| ADR-229 | E2E 自动化推进 —— 从 schema 到测试零映射 | 部分实施 — Phase 1 |
| ADR-220 | Schema 完整性元测试 —— 不开浏览器，秒级捕获 schema 漂移 | 实施中 |
| ADR-215 | 取消「道具」资源类型 — 模型附属关系替代 prop + accessory 体系 | 🔄 实施中 |
| ADR-204 | 单测分层与治理规范（拆上帝文件 · 降 mock 密度 · fixtures 复用 · unit/integration 分层） | 🟢 实施中 ⚠️ 被 [ADR-256] |
| ADR-189 | 纹理加载路径优化（并行读取 + basename 共享 + LRU + KTX2 基础设施） | 实施中 — Phase 0/1 全量 2133/… |
| ADR-109 | AR 模块审查结论与遗留项排期 | 部分实现 |
规划中
| ADR | 主题 | 状态 |
|---|---|---|
| ADR-231 | 地面视觉后续方向（自发光地屏 + 程序化地面图案） | 📝 规划 |
| ADR-223 | 水面视觉效果整顿 —— 法线混合、深度泡沫、折射扭曲、SSS、渐变颜色 | 规划 |
| ADR-222 | 水面深度差雾（Depth-Difference Fog）—— 从相机距离雾迁移至水柱厚度雾 | 规划 |
| ADR-209 | 月亮 —— 第二天体的渐进式设计（复用太阳骨架） | 📝 规划 |
| ADR-187 | babylon-mmd 剩余高价值功能综合分析 | 草案 · 待立项 |
| ADR-073 | AR 地形识别 —— 原生 ARCore / ARKit 桥接 | 提案 |
| ADR-072 | AR 平面检测 —— WebXR hit-test + plane detection | 提案 |
已落地
| ADR | 主题 | 状态 |
|---|---|---|
| ADR-257 | maxWorkers 12→8：共享机器并发场景的资源经济学 — 并发实测：双 vitest 各 12 worker（24 核拉满）69.4s，各 8 worker 64.3s——24 核全占后 CPU 竞争使墙钟反超；单 AI 8 核仅慢 3.7s（9%） | ✅ 已采纳 |
| ADR-256 | 性能导向的单测文件组织：同系列合并取代一刀切拆分 — isolate 下每文件独立依赖图是墙钟税；importDurations 实测 self ~100ms 却付 ~5s total 的文件优先合并；行数/vi.mock 阈值让位于依赖图成本 | ✅ 已采纳 |
| ADR-255 | 测试环境分流：@vitest-environment node 削减每文件 happy-dom 成本 — isolate=true 下 happy-dom 每文件重建是墙钟大头；无 DOM 依赖测试文件切 node 环境，环境累加 255s → ~90-105s | ✅ 已采纳 |
| ADR-254 | 历轮审核 P4 遗留项登记簿 —— 低风险改进清单与技术债跟踪 | ✅ 已立 |
| ADR-253 | 配置部分更新合并契约损坏 —— mergeUIState bool 覆盖 / mergeEnvState 零值覆盖 | ✅ 已立 |
| ADR-252 | 菜单资源释放链路缺失 —— disposeMenuWrapper/clearAllMenuWrappers 零调用与 _liveMenus 常驻 | ✅ 已立 |
| ADR-251 | scene 反向 import 循环依赖治理 —— model-ops/camera 对 ../scene 的真实静态循环 | ✅ 已立 |
| ADR-250 | 场景初始化重入与异常一致性 —— initScene 重入守护 + 中途异常状态复位 | ✅ 已立 |
| ADR-249 | IndexedDB 事务异常契约 —— complete/error/abort 三事件必须全部接线 | ✅ 已立 |
| ADR-248 | 派生缓存依赖引用键 —— 缓存 key 必须携带依赖引用，依赖变更即失效 | ✅ 已立 |
| ADR-247 | 材质参数应用双路径收敛 —— PBR 与 StandardMaterial 语义必须一致 | ✅ 已立 |
| ADR-246 | 序列化往返显式字段原则 —— 判别字段必须显式持久化，禁止反推 | ✅ 已立 |
| ADR-245 | Babylon 9.x 插件访问规范 —— 禁止桥接私有数组，统一走公开只读属性 | ✅ 已立 |
| ADR-244 | init 启动流程阶段化拆分 —— 110 行编排器按职责切分 | ✅ 已完成 |
| ADR-243 | EnvState 默认值从 Schema 自动推导 —— 消除 100+ 字段双源手工映射 | ✅ 已完成 |
| ADR-242 | 顶层目录分层公理 —— 「纯算法层」假说的证伪与重定性 | 已完成 —— 采纳方案 C；Phase 1 |
| ADR-241 | .mjs 脚本文档统一约定（跨仓库硬约束） | ✅ 已实施 |
| ADR-240 | 代码重复审计与双源消除 —— canvasToBase64 去重 / applyWindToParticles 空壳处置 / 工作区垃圾清理 | ✅ 已实施 |
| ADR-239 | env-water.ts 拆模块 —— 材质/反射/FX 三向拆分与生命周期宿主收拢（ADR-237 P3 落地） | ✅ 已实施 |
| ADR-238 | 循环依赖消解第二期 —— core→scene 根环与 motion/outfit 互依赖拆解 | 🟢 已实施 |
| ADR-237 | 超限模块拆分计划 —— 250LOC 天花板的优先级拆解路线图 | ✅ 收口 |
| ADR-236 | 循环依赖消解 — scene/render ↔ scene/manager 互依赖拆解 | ✅ 核心已实施 — render↔manager… |
| ADR-235 | 保存机制现状与张力登记 —— 双权威源 / 同步写假设 / 全量 vs 增量 / 迁移不对称 | ✅ 已完成 |
| ADR-234 | env-state ↔ Go EnvState 字段 parity 防线 —— 用检查脚本终结「TS 加字段、Go 忘同步」 | ✅ 已完成 |
| ADR-233 | 程序化动作 per-mode 独立参数 —— 拆分单一状态为待机/自动舞蹈各自参数集 | ✅ 已完成 |
| ADR-232 | ADR 元治理 —— 取代关系判别与脚本口径统一 | 已落地 |
| ADR-230 | 文档自动化工具链决策 —— 从手写索引到机器守护的完整闭环 | 已落地 |
| ADR-228 | UI 行控件公共化第三轮 + 命名去 _ 前缀 | 已完成 |
| ADR-227 | 个人灯阴影按需开关与分辨率可调 | 已完成 |
| ADR-226 | 地面材质单一事实源重构（GroundMaterialSpec） | 已落地 |
| ADR-225 | Web 部署路径重分配 — 文档站占 Pages 根、主应用降 /app/ 子路径 | 已实施 |
| ADR-224 | Plaza 广场数据源统一与持久化 — GitHub 远程配置 + Go 用户目录缓存 + 内置兜底 + id 统一 | 已实施 |
| ADR-221 | 逐材质透明度（alphaMul）—— 材质编辑器第 11 参数 | 已完成 |
| ADR-219 | 测试并发调优与 isolate 污染治理 — vitest 全量提速：maxWorkers 落地 + isolate=false 障碍清理 | 已完成 |
| ADR-218 | 知识库（docs/knowledge）分层治理 — 痛点与方案 | 已实施 |
| ADR-217 | 地水无限尺寸单源化 — 水面跟进 groundInfiniteEnabled | ✅ 已实施 |
| ADR-216 | 移除死状态字段 underwaterFogDensity / underwaterFogMultiplier | ✅ 已实施 |
| ADR-214 | Menu ID 命名规范治理 | ✅ 已完成 |
| ADR-213 | Go 后端 EnvState 命名漂移修复与契约补全 | ✅ 已完成 |
| ADR-212 | 命名 vs 翻译 vs 实际功能错位系统审计与治理 | ✅ 已完成 |
| ADR-211 | 水面功能开关体系 — 噪声原语消重与效果分组开关化 | ✅ Part 1/2/3 完成 |
| ADR-210 | 环境光照字段名名实相符重命名（envIntensity/envBrightness） | ✅ 已完成 |
| ADR-208 | 地面预设贴图设计统一 —— sourceKind 语义标注（预留）+ 程序化纹理防覆盖 | ✅ 已完成 |
| ADR-207 | 动作菜单重构 —— 程序化动作可加载化 + 双面板对称 | ✅ 已完成 |
| ADR-206 | 测试基础设施收敛与断言质量治理 | 🟢 已完成 |
| ADR-205 | AI 工具体系全景 — 从写操作到读写闭环 | ✅ 已完成 |
| ADR-203 | AI 助手会话持久化与独立面板 | 🟢 已完成 |
| ADR-202 | fork 自治改动批次 — 一次回灌批量根治可改 fork 的上游缺口 | ✅ P0 已落地 |
| ADR-201 | 路径2 — 给 babylon-mmd fork 增加原生刚体施力导出（wasm 侧解析） | ✅ 已实施 |
| ADR-200 | 风力对模型自带刚体无效 — 遍历 map 恒空的架构误解 | ✅ 已定性 |
| ADR-198 | 场景序列化异常的保存韧性 | 已实施 |
| ADR-197 | 统一动作注册表 — 菜单可维护性归一化 | 🟢 已完成 |
| ADR-196 | 内置 AI 诊断助手（LLM Diagnostic Assistant） | ✅ 已完成 |
| ADR-195 | 下载文件夹统一修订（三平台系统下载目录 + 消除"二扫"） | 已完成 |
| ADR-194 | 风物理系统修复 — 从「假风」到真实风场 | 已完成 |
| ADR-193 | 模型稳定身份（inst.id = 持久化 uuid） | 已立项 · 已实现 |
| ADR-192 | 上游适配层重构（MmdAdapter） | 已立项 · Phase 2 已完成 |
| ADR-191 | 神桶 @/core/utils 去桶化（零依赖叶下沉） | 已完成 |
| ADR-190 | 端能力声明式收口（淘汰散落 isAndroidPlatform 分支） | 已完成 |
| ADR-188 | PBRMaterialBuilder 材质系统迁移 — PBR 渲染升级 | Phase 1 完成 |
| ADR-186 | bone-override 帧内时序图 | accepted |
| ADR-185 | 网页端 ZIP 内子目录 PMX 贴图路径维度对齐 | 已完成 |
| ADR-184 | 网页端 ZIP 嵌套识别能力补齐（多编码检测 + 炸弹防护对齐 Go 端） | 已完成 |
| ADR-183 | 网页端 FSA 根目录授权引导（四态探针 + 重授权兜底） | 已完成 |
| ADR-182 | 网页端 ZIP 导入键规约命名空间化（消除同名 PMX 纹理碰撞） | 已完成 |
| ADR-181 | 下载管理面板（扫描→解压→入库→processed 标记）【经 ADR-195 修订定位与行为】 | 已完成 |
| ADR-180 | Web 资源库 FSA 句柄持久化与启动自动重扫 | 已完成 |
| ADR-179 | 更新安装拉起（按平台分级） | 已完成 |
| ADR-178 | 能力矩阵补全宿主级键（四端统一收口） | 已完成 |
| ADR-177 | Web Loader 与主应用统一路径 | 已完成 — Phase 0-3 落地 + Pha… |
| ADR-176 | 前端 Backend 适配器双实现（Web/Desktop 通杀） | 已完成 |
| ADR-175 | 光照强度多入口设计意图裁决 | ✅ 已裁决 |
| ADR-174 | 质量维度注册表 — 统一 qualityProfile 扩展点 | 已完成 |
| ADR-173 | env-bridge setEnvState 中间件化重构 | 已完成 |
| ADR-172 | 湿身效果：雨天角色材质湿润感 | 已完成 |
| ADR-171 | 场景级拖拽模式：快捷开关 + 收纳文件夹 | 已完成 |
| ADR-170 | 动作库选中范式 —— 将「默认」暴露为逐行「选中」（对齐模型焦点范式） | 已实施 |
| ADR-169 | 动作装载语义统一 —— 原位替换默认动作（replaceDefaultMotion） | 已实施 |
| ADR-168 | 动态追光：舞台灯跟随角色/骨骼 | 已实现 |
| ADR-167 | 场景级动作库（Scene Motion Library）— 多主动作平等共存 | 已完成 |
| ADR-166 | 感知层 per-model 上下文真实隔离（ADR-162/163 返工） | 已完成 |
| ADR-165 | 感知层性能基准 — 为 ADR-164 全员感知降级提供阈值依据 | 已完成 |
| ADR-164 | 感知层 per-model 实例化 — Phase 2（全员感知 + 性能降级） | 已实现 |
| ADR-163 | 感知层冲突可视化 — 闭环「左右脑互博」用户层可见性 | 已完成 |
| ADR-162 | 感知层 per-model 实例化 — Phase 1（pinned 模型支持） | 已完成 |
| ADR-161 | balanceSway 独立参数暴露 — 补齐感知层 UI 可调性 | 已完成 |
| ADR-160 | Gaze Delta 指数衰减 — 闭环「左右脑互博」物理根因最后一环 | 已完成 |
| ADR-159 | 渲染模块重复收口 + 关键补测 + 两项结构性重构决策 | 已实施 |
| ADR-158 | 动作系统三连修 + 全项目审核快修 | 已实施 |
| ADR-157 | 设置界面信息架构重组 — 10 分类 → 7 分类 | 已实施 — Phase 1 |
| ADR-156 | 大模型交流 — 创意路线（角色台词生成） | 🟡 Step 1 + Step 2a 已实施 |
| ADR-155 | 自然语言控场景 — 叠加于 AiService 管线之上 | 🟢 已完成 |
| ADR-153 | 无障碍（a11y）支持总体方案 | ✅ 全部完成 |
| ADR-152 | 舞台灯光光锥（Light Cone） | ✅ 已实施 |
| ADR-151 | 反射系统统一架构（SSR/Probe 统一入口 + Planar 协调） | ✅ 已实施 |
| ADR-150 | 模型替换原子操作契约（Model Replace Contract） | ✅ 已完成 |
| ADR-148 | 过载文件拆分工程 | ✅ 已完成 |
| ADR-147 | 动作管线显式调度器 + 集中骨骼覆盖状态 | 已完成 |
| ADR-146 | 函数级重复摸排与收敛（第二波） | ✅ 已完成 |
| ADR-145 | 多模块协同预设 — 一键启用组合姿态 | ✅ P1 已实施 |
| ADR-143 | 可统一代码收敛（P1 之外剩余项） | 已完成 |
| ADR-142 | withLoadingStatus 加载状态机统一 | 已完成 |
| ADR-141 | state.ts 拆分 — 状态基座重构 | 实施完成 |
| ADR-140 | DragSliderController 统一滑块输入 | 完成 |
| ADR-139 | Observer 生命周期统一管理 | ✅ 已完成 |
| ADR-138 | env-dispatcher 破循环依赖 | 已完成 |
| ADR-137 | EnvState 单一源 Schema | 已实施 |
| ADR-136 | 缩略图流式加载 AbortSignal 协作式取消 | ✅ 已完成 |
| ADR-135 | LibrarySessionStore — 资源库状态收敛基座 | ✅ 已完成 |
| ADR-134 | 无限地面方案修正 — 废弃相机跟随，扩大地面尺寸范围 | 已采纳 |
| ADR-132 | 环境亮度统一标量（EnvBrightness Unification） | 已实施 |
| ADR-131 | 资源浏览选中结果统一契约（BrowseOutcome） | ✅ 已完成 |
| ADR-130 | 场景 UI 整体设计与前后端发展方向路线图 | 规划中 |
| ADR-129 | 动作菜单场景级重设计（Scene-level Motion UI） | 已完成—最终实现偏离设计 |
| ADR-128 | 镜面道具化重命名（debugMirror → mirror） | ✅ 已完成 |
| ADR-127 | 场景级破坏性操作撤销 — Memento 快照 + 撤销 Toast | 已实现 |
| ADR-126 | 变换适配器统一（TransformAdapter Registry）— 跨 kind 拖拽/数值双模态去重 | ✅ 已完成 |
| ADR-125 | 动作覆盖撤销/重做 — 模块层 setParam 历史栈 | 已实施 |
| ADR-124 | 文件服务架构审计 —— 从 HTTP 中转到 ArrayBuffer 直传 | 已完成 |
| ADR-123 | _computeOverride 语义正式化 — weight≥1 复合、overrideRotation 标志、absolute 模式 | P1 已实施 |
| ADR-122 | IK 感知骨骼覆盖 — 运动模块 IK 适配 | P1 已实施 |
| ADR-121 | 全局动作意图（Scene-level Motion Intent）— 场景级意图 + 每实例继承/覆盖 | 已实施 |
| ADR-120 | 环境预设分类化 — 天空/地面/水面/大气 | ✅ Phase 1 完成 |
| ADR-119 | 缩略图缓存键单一源治理 | Phase 1 + Phase 2 已完成 |
| ADR-118 | 刷新率感知的自动降级阈值 | ✅ 已完成 |
| ADR-117 | Go 端用户可见错误的 i18n 化 | ✅ 已完成 |
| ADR-116 | 动作覆盖系统 — 模块化架构 + 骨骼覆盖下沉 | 已完成 |
| ADR-115 | 风格化水体竞品调研与波光粼粼增强方向 | P1+P2+P3+P4 已完成 |
| ADR-114 | 地面反射增强 — 从平面近似到 PBR 材质 | 已完成 |
| ADR-113 | 体积云延展地平线与画质/性能升级 | 完成 |
| ADR-112 | SdefInjector + SdefMesh 接入 — SDEF 球面变形 | 已完成 |
| ADR-111 | 场景/环境菜单按用户直觉重新划分 | 已实施 |
| ADR-110 | IMmdModel 接口类型补全 — 上游 PR 计划 | 草案 · 待立项 |
| ADR-108 | AnimationRetargeter + HumanoidMmd 接入 — 扩展动作来源 | 已落地 |
| ADR-107 | StreamAudioPlayer 接入 — 替换自建音频管线 | 已完成 |
| ADR-106 | 时序审核与异步生命周期规范 | ✅ 全部完成 |
| ADR-105 | AbortSignal 传递规范与异步异常处理基线 | ✅ Phase 1 + Phase 2 完成 |
| ADR-104 | 物理/换装/音频子系统设计债暂缓登记 | 已完成 |
| ADR-103 | SettingsStore 接入 setUIState 持久化链路 | 已完成 |
| ADR-102 | main.ts 拆分（init / events / render-loop / dev-hooks） | 已完成 |
| ADR-101 | 通用逻辑模式收敛（第二波） | 已完成 |
| ADR-100 | 相机系统「控制方案 × 运动行为」双轴拆分 | 已完成 |
| ADR-099 | babylon-mmd 未利用 API 接入 · Item 4 MPR 多线程 WASM 物理（Go 端 COOP/COEP 注入 POC） | 已完成 |
| ADR-098 | babylon-mmd 未利用 API 接入 · 批次一（描边渲染 + Composite 动画类型收敛） | 已完成 |
| ADR-097 | 资源库浏览与恢复决策汇总（含模型记忆） | ✅ 已实施 |
| ADR-096 | 通用 Helper 单点收敛 | 已完成 |
| ADR-095 | 路径归一化与归属判定统一 | 已完成 |
| ADR-094 | 资源库替换模式 — 加载后自动保持替换状态并回到模型列表 | 已完成 |
| ADR-093 | 菜单声明式 Schema —— 单一数据源 + 单渲染器，根治「大」与「AI 难改」 | 已完成 P0+P1+P2 |
| ADR-092 | 贴图与反射统一 —— 单一纹理工厂 + 单一平面反射引擎 | 已完成 |
| ADR-091 | 地面纹理统一 —— 4 种样式合并为单一 canvas + StandardMaterial 路径 | 已完成 |
| ADR-090 | 对话框默认目录记忆（按资源类型）—— 双端可用 | 已完成 |
| ADR-089 | 地面模式分类重构 —— 拆分为几何类型(groundType) + 外观样式(groundStyle) | 已完成 |
| ADR-088 | 音效系统 — 脚步声与 SFX 总线 | Phase A + Phase B 已完成；Ph… |
| ADR-087 | 模型广场 · 浏览器体验增强路线图 | 已完成 |
| ADR-086 | 猫步走秀程序化动作（Catwalk Procedural Motion） | 通过 |
| ADR-085 | 脚部地面跟随（Feet Adjustment） | Phase A 已完成；Phase B/C 降级… |
| ADR-084 | Mesh-to-Cloth 虚拟裙骨生成 —— WASM Bullet 运行时刚体注入 | 已完成 |
| ADR-083 | 地面功能扩展 —— 反射/倾斜/纹理滚动/高程着色/跟随网格/图案扩展/法线贴图 | 已交付 — Phase A + Phase B … |
| ADR-082 | 跨发版 CI 缓存预热（cache-warm 落盘 main 作用域） | 已实施 |
| ADR-081 | XPBD(TS) 测试物理全栈移除与受影响 ADR 审计 | 已实施 |
| ADR-080 | 预设动画 observer 级联暴涨——addOnce 自注册陷阱 | 已修复 |
| ADR-079 | 感知层扩展——always-on 实时叠加的适用边界 | Phase 1-4 已实施 |
| ADR-078 | 模型广场 · 下载拦截（iframe 内一键入库） | 已实施 |
| ADR-077 | 模型广场 · Cookie 中继（登录态代理） | 已实施 |
| ADR-076 | 卡通化渲染后处理模式 | ✅ 已实施 |
| ADR-075 | 模型广场 · 网页浏览（内嵌代理 + 外链闭环） | 已采纳 · 已实施 |
| ADR-071 | 程序化动作与角色感知边界重构 | 已实施 |
| ADR-070 | 相机模式「演唱会」语义重构（拆分出「环绕」模式） | 已实施 |
| ADR-067 | UI 重复率审计与重构 | 已完成 |
| ADR-066 | 全屏资源库界面（精简版） | ✅ 已实施 |
| ADR-065 | 纯 items 层级语言热切换刷新（精简版） | ✅ 已实施 |
| ADR-064 | 技术债清偿（续）—— *Dir 包装维持现状 + scene.ts 业务循环依赖破除 | 已实施 |
| ADR-063 | 架构债务清偿（精简版） | ✅ 已实施 |
| ADR-062 | 水面反射渲染目标与通用反射系统 | 已完成 |
| ADR-61.1 | Ragdoll 保真度补齐 实施计划 | 已交付 |
| ADR-61.1 | Ragdoll 保真度补齐（球面关节 + 旋转求解 + 暂停/过渡仲裁 + 关节参数化） | 已交付 |
| ADR-061 | 高级骨骼操控与姿态工作室实现计划 | 已完成 |
| ADR-060 | E2E 测试策略（Playwright + 双模式 Fixture + 场景数值钩子） | ✅ 已完成 |
| ADR-059 | i18n 多语言切换框架 | 已完成 |
| ADR-058 | 纹理路径字节级匹配 —— basenameFallbackFS 多编码兜底 | 已实施 |
| ADR-057 | Shift-JIS URL 乱码修复 —— Base64 查询参数方案（链路 A） | 已实施 |
| ADR-056 | WASM 运行时 Motion Layers 解锁 — JS 帧流合并 + 单图层兜底 | ✅ 已实施 |
| ADR-055 | AR 相机模式 —— 摄像头视频透传与模型叠加 | 已实施 |
| ADR-054 | 后续开发方向路线图 | 规划 |
| ADR-053 | Gaze 图层集成 —— 视线追踪作为图层类型 | 已完成 |
| ADR-052 | 地面模式增强 —— 网格大小/第二颜色/高度/纹理旋转 | 已完成 |
| ADR-051 | VMD 图层系统与骨骼级过滤 | 已完成 |
| ADR-050 | 保存触发机制统一 | 已实施 |
| ADR-049 | 轨道控制统一 — 球面坐标扩展到模型/道具 | 已实现 |
| ADR-048 | 变换系统统一 — 模型/灯光/道具移动一致性 | 已完成 — 反序列化统一 + 输入验证均已实施。… |
| ADR-047 | 配置持久化覆盖现状 | 已完成 — 2026-07-06 会话中修复了配… |
| ADR-046 | 渲染独立开关 — Custom 性能模式（精简版） | ✅ 已实施 |
| ADR-045 | 统一加载与资源管理（精简版） | ✅ 已完成 |
| ADR-042 | motion/ → motion-algos/ 目录改名 | 已完成 |
| ADR-041 | CI 自动检查 — Markdown 链接校验 + AI Mistake Tracker | 已完成 |
| ADR-039 | 文档体系精简 | 已完成 |
| ADR-038 | 动作系统审计修复 + 雾系统增强 + 颜色滑块拖拽 | 已完成 |
| ADR-037 | P2 功能批量交付 — Lifelike / Formation / Auto Camera / Scene Bundle | 已完成 |
| ADR-036 | ShortcutRegistry — 可配置快捷键系统 | 已完成 — ShortcutRegistry 核… |
| ADR-035 | 设置面板功能缺口评估 | 已完成 |
| ADR-034 | 菜单体系大统一 — slideRow + cardContainer + lcard | 已完成 — 全量迁移完成，所有菜单面板统一为 s… |
| ADR-033 | config.ts 四向分裂 + tryCatchStatus 泛化 + slideRow 收束 | 已完成 — config.ts 分裂、tryCa… |
| ADR-032 | 体积云渲染方案调查 | 已完成 — 调查完毕，结论：Babylon.js… |
| ADR-031 | 2026-07-05 会话清理 — 文档翻新 + AGENTS.md 瘦身 + 硬约束精简 | 已完成 |
| ADR-030 | 小说目录按功能分类重组 | 已实现 — 小说素材目录按功能分类重组完成 |
| ADR-029 | 物理设置界面重构 — 从布料单页到双系统分治 | 已实现 — XPBD 布料/WASM Bulle… |
| ADR-028 | 风场系统统一 — 从碎片化到集中治理 | 已实现 — wind-utils.ts 统一风向… |
| ADR-027 | 菜单响应式系统 — 控件自更新 + Proxy 自动触发 | 已实现 — Proxy 拦截 envState … |
| ADR-026 | 环境系统增强 — 纹理地面、粒子系统、粒子溅射、水下后处理联动 | 已完成 — Phase A 纹理地面 + Pha… |
| ADR-025 | 触屏交互优化与 ZIP 模型扫描通用化 | 已完成 — P0/P1/P2 全部实现 |
| ADR-024 | 渲染增强 Phase 2（精简版） | ✅ SSR/ReflectionProbe/SS… |
| ADR-022 | 预设治理 — 统一管理范围与分级架构 | 已实现 — 8 项改动全完成：EnvPreset… |
| ADR-021 | 程序化动作系统（Idle/Auto Dance + LipSync + 视线追踪） | 已完成 — Idle/AutoDance/Lip… |
| ADR-020 | 换装系统（服装变体/纹理替换） | 已完成 — Phase 8 完成，outfit.… |
| ADR-018 | PathManager 平台抽象层 + 文件 I/O 审计 | 已完成 — PathManager 接口 + t… |
| ADR-017 | Android 平台适配（精简版） | 主体已完成 |
| ADR-016 | 视线追踪子系统架构 | 已完成 — 双路径方案已实施 |
| ADR-015 | 材质编辑器 UI 重构 + 逐材质开关 | 已完成 — buildMatRootLevel/… |
| ADR-014 | 模型加载预设库（角色设置快照） | 已完成 — 保存/加载/库管理/自动匹配/try… |
| ADR-013 | Skybox 贴图系统改进 | 已完成 — SelectEnvTextureFi… |
| ADR-011 | Wails v3 迁移评估与决策 | 已完成 — 已迁至 Wails v3，项目当前运… |
| ADR-009 | 模型详情面板 — 运行时模型实例控制 | 已完成 — Phase 1-5 全部完成 |
| ADR-006 | 扫描简化 + 文件名多编码自动检测 | 已完成 — bestDecode/cleanMo… |
| ADR-005 | 待修复项 — 已知技术债务 | 已完成 — #1 HTTP 目录隔离 |
| ADR-004 | CSS 统一重构 + 弹窗单例模式 | 已完成 — CSS 变量体系 12 token … |
| ADR-003 | 下载监听策略（精简版） | 方案 C 已实施 ✅；方案 E 远期构想 |
| ADR-002 | 配置写入分离 — writeConfig 轻写 vs writeConfigAndRescan 全量 | 已完成 — writeConfig 从 writ… |
| ADR-001 | 项目基础设施决策 | 已完成 — 5 条基础设施决策已定案。注意：fo… |
已归档
| ADR | 主题 | 状态 |
|---|---|---|
| ADR-199 | LLM 能力边界与缓解策略（归档） | 📋 归档登记 |
| ADR-154 | 引入大模型交流能力 — 推荐路线（聊天面板打底） | 🗑️ 已被 ADR-196 取代 |
| ADR-149 | 材质系统 × 换装系统基线冲突登记 | 已登记 |
| ADR-144 | Per-model Overlay Motion（动作2 叠加层） | 已废弃 |
| ADR-133 | Android MPR 多线程物理缺失——构建门控与架构障碍 | ⚠️ 决策二证伪 — Android WebVi… |
| ADR-074 | 动态 Cubemap RT 球面反射 | 🗑️ 已放弃 |
| ADR-069 | 材质面板纹理支持审计与推进路线 | 调研落档 — 材质面板当前仅支持 4 标量乘率，… |
| ADR-044 | MMD 生态竞品分析 | 已完成 — 调研归档 |
| ADR-043 | DanceXR 功能差距挖掘 | 已完成 — 调研归档 |
| ADR-019 | XPBD 布料模拟引擎选型与架构 | 已完成 — xpbd-solver/collid… |
| ADR-012 | 云渲染改进 — Perlin 噪声 + 双分层 | ⚠️ 已过时 — 被 **[ADR-113] |