Skip to content

MikuMikuAR 文档

Main Navigation 首页用户指南知识卡小说决策记录开发运维 GitHub

Appearance

Sidebar Navigation

用户指南

AI 助手

相机操作

云层设置

拖拽模式

环境氛围

环境预设

水面设置

实验功能

外部动作导入

雾设置

队形编排

视线追踪

地面设置

模型导入

镜面反射

动作与播放

换装

布料物理

姿势工作室

程序化动作

道具

场景保存与恢复

设置

阴影设置

天空设置

舞台灯光

舞台渲染

风力与粒子

架构与规范

MikuMikuAR 架构与技术方案

MMD 生态竞品分析报告

MikuMikuAR — UI 组件规范

函数映射表

内部文档（仓库可见 · 站点隐藏）

MikuMikuAR — 菜单操作指南

MikuMikuAR 项目现状

大模块审核子代理流水线 Playbook（MikuMikuAR 版）

四端目标能力矩阵（Single Source of Truth）

MikuMikuAR 专业术语规范

网页端数据存储与 Origin 隔离说明

网站与 Web 部署架构

决策记录 (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: 顶层目录分层公理 —— 「纯算法层」假说的证伪与重定性

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 互依赖拆解

ADR-235: 保存机制现状与张力登记 —— 双权威源 / 同步写假设 / 全量 vs 增量 / 迁移不对称

ADR-234: env-state ↔ Go EnvState 字段 parity 防线 —— 用检查脚本终结「TS 加字段、Go 忘同步」

ADR-233: 程序化动作 per-mode 独立参数 —— 拆分单一状态为待机/自动舞蹈各自参数集

ADR-232: ADR 元治理 —— 取代关系判别与脚本口径统一

ADR-231: 地面视觉后续方向（自发光地屏 + 程序化地面图案）

ADR-230: 文档自动化工具链决策 —— 从手写索引到机器守护的完整闭环

ADR-229: E2E 自动化推进 —— 从 schema 到测试零映射

ADR-228: UI 行控件公共化第三轮 + 命名去 `_` 前缀

ADR-227: 个人灯阴影按需开关与分辨率可调

ADR-226: 地面材质单一事实源重构（GroundMaterialSpec）

ADR-225: Web 部署路径重分配 — 文档站占 Pages 根、主应用降 /app/ 子路径

ADR-224: Plaza 广场数据源统一与持久化 — GitHub 远程配置 + Go 用户目录缓存 + 内置兜底 + id 统一

ADR-223: 水面视觉效果整顿 —— 法线混合、深度泡沫、折射扭曲、SSS、渐变颜色

ADR-222: 水面深度差雾（Depth-Difference Fog）—— 从相机距离雾迁移至水柱厚度雾

ADR-221: 逐材质透明度（alphaMul）—— 材质编辑器第 11 参数

ADR-220: Schema 完整性元测试 —— 不开浏览器，秒级捕获 schema 漂移

ADR-219: 测试并发调优与 isolate 污染治理 — vitest 全量提速：maxWorkers 落地 + isolate=false 障碍清理

ADR-218: 知识库（docs/knowledge）分层治理 — 痛点与方案

ADR-217: 地水无限尺寸单源化 — 水面跟进 groundInfiniteEnabled

ADR-216: 移除死状态字段 underwaterFogDensity / underwaterFogMultiplier

ADR-215: 取消「道具」资源类型 — 模型附属关系替代 prop + accessory 体系

ADR-214: Menu ID 命名规范治理

ADR-213: Go 后端 EnvState 命名漂移修复与契约补全

ADR-212: 命名 vs 翻译 vs 实际功能错位系统审计与治理

ADR-211: 水面功能开关体系 — 噪声原语消重与效果分组开关化

ADR-210: 环境光照字段名名实相符重命名（envIntensity/envBrightness）

ADR-209: 月亮 —— 第二天体的渐进式设计（复用太阳骨架）

ADR-208: 地面预设贴图设计统一 —— sourceKind 语义标注（预留）+ 程序化纹理防覆盖

ADR-207: 动作菜单重构 —— 程序化动作可加载化 + 双面板对称

ADR-206: 测试基础设施收敛与断言质量治理

ADR-205: AI 工具体系全景 — 从写操作到读写闭环

ADR-204: 单测分层与治理规范（拆上帝文件 · 降 mock 密度 · fixtures 复用 · unit/integration 分层）

ADR-203: AI 助手会话持久化与独立面板

ADR-202: fork 自治改动批次 — 一次回灌批量根治可改 fork 的上游缺口

ADR-201: 路径2 — 给 babylon-mmd fork 增加原生刚体施力导出（wasm 侧解析）

ADR-200: 风力对模型自带刚体无效 — 遍历 map 恒空的架构误解

ADR-199: LLM 能力边界与缓解策略（归档）

ADR-198: 场景序列化异常的保存韧性

ADR-197: 统一动作注册表 — 菜单可维护性归一化

ADR-196: 内置 AI 诊断助手（LLM Diagnostic Assistant）

ADR-195: 下载文件夹统一修订（三平台系统下载目录 + 消除"二扫"）

ADR-194: 风物理系统修复 — 从「假风」到真实风场

ADR-193: 模型稳定身份（inst.id = 持久化 uuid）

ADR-192: 上游适配层重构（MmdAdapter）

ADR-191: 神桶 `@/core/utils` 去桶化（零依赖叶下沉）

ADR-190: 端能力声明式收口（淘汰散落 isAndroidPlatform 分支）

ADR-189: 纹理加载路径优化（并行读取 + basename 共享 + LRU + KTX2 基础设施）

ADR-188: PBRMaterialBuilder 材质系统迁移 — PBR 渲染升级

ADR-187: babylon-mmd 剩余高价值功能综合分析

ADR-186: bone-override 帧内时序图

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 与主应用统一路径

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 分类

ADR-156: 大模型交流 — 创意路线（角色台词生成）

ADR-155: 自然语言控场景 — 叠加于 AiService 管线之上

ADR-154: 引入大模型交流能力 — 推荐路线（聊天面板打底）

ADR-153: 无障碍（a11y）支持总体方案

ADR-152: 舞台灯光光锥（Light Cone）

ADR-151: 反射系统统一架构（SSR/Probe 统一入口 + Planar 协调）

ADR-150: 模型替换原子操作契约（Model Replace Contract）

ADR-149: 材质系统 × 换装系统基线冲突登记

ADR-148: 过载文件拆分工程

ADR-147: 动作管线显式调度器 + 集中骨骼覆盖状态

ADR-146: 函数级重复摸排与收敛（第二波）

ADR-145: 多模块协同预设 — 一键启用组合姿态

ADR-144: Per-model Overlay Motion（动作2 叠加层）

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-133: Android MPR 多线程物理缺失——构建门控与架构障碍

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 模式

ADR-122: IK 感知骨骼覆盖 — 运动模块 IK 适配

ADR-121: 全局动作意图（Scene-level Motion Intent）— 场景级意图 + 每实例继承/覆盖

ADR-120: 环境预设分类化 — 天空/地面/水面/大气

ADR-119: 缩略图缓存键单一源治理

ADR-118: 刷新率感知的自动降级阈值

ADR-117: Go 端用户可见错误的 i18n 化

ADR-116: 动作覆盖系统 — 模块化架构 + 骨骼覆盖下沉

ADR-115: 风格化水体竞品调研与波光粼粼增强方向

ADR-114: 地面反射增强 — 从平面近似到 PBR 材质

ADR-113: 体积云延展地平线与画质/性能升级

ADR-112: SdefInjector + SdefMesh 接入 — SDEF 球面变形

ADR-111: 场景/环境菜单按用户直觉重新划分

ADR-110: IMmdModel 接口类型补全 — 上游 PR 计划

ADR-109: AR 模块审查结论与遗留项排期

ADR-108: AnimationRetargeter + HumanoidMmd 接入 — 扩展动作来源

ADR-107: StreamAudioPlayer 接入 — 替换自建音频管线

ADR-106: 时序审核与异步生命周期规范

ADR-105: AbortSignal 传递规范与异步异常处理基线

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 难改」

ADR-092: 贴图与反射统一 —— 单一纹理工厂 + 单一平面反射引擎

ADR-091: 地面纹理统一 —— 4 种样式合并为单一 canvas + StandardMaterial 路径

ADR-090: 对话框默认目录记忆（按资源类型）—— 双端可用

ADR-089: 地面模式分类重构 —— 拆分为几何类型(groundType) + 外观样式(groundStyle)

ADR-088: 音效系统 — 脚步声与 SFX 总线

ADR-087: 模型广场 · 浏览器体验增强路线图

ADR-086: 猫步走秀程序化动作（Catwalk Procedural Motion）

ADR-085: 脚部地面跟随（Feet Adjustment）

ADR-084: Mesh-to-Cloth 虚拟裙骨生成 —— WASM Bullet 运行时刚体注入

ADR-083: 地面功能扩展 —— 反射/倾斜/纹理滚动/高程着色/跟随网格/图案扩展/法线贴图

ADR-082: 跨发版 CI 缓存预热（cache-warm 落盘 main 作用域）

ADR-081: XPBD(TS) 测试物理全栈移除与受影响 ADR 审计

ADR-080: 预设动画 observer 级联暴涨——addOnce 自注册陷阱

ADR-079: 感知层扩展——always-on 实时叠加的适用边界

ADR-078: 模型广场 · 下载拦截（iframe 内一键入库）

ADR-077: 模型广场 · Cookie 中继（登录态代理）

ADR-076: 卡通化渲染后处理模式

ADR-075: 模型广场 · 网页浏览（内嵌代理 + 外链闭环）

ADR-074: 动态 Cubemap RT 球面反射

ADR-073: AR 地形识别 —— 原生 ARCore / ARKit 桥接

ADR-072: AR 平面检测 —— WebXR hit-test + plane detection

ADR-071: 程序化动作与角色感知边界重构

ADR-070: 相机模式「演唱会」语义重构（拆分出「环绕」模式）

ADR-069: 材质面板纹理支持审计与推进路线

ADR-067: UI 重复率审计与重构

ADR-066: 全屏资源库界面（精简版）

ADR-065: 纯 items 层级语言热切换刷新（精简版）

ADR-064: 技术债清偿（续）—— *Dir 包装维持现状 + scene.ts 业务循环依赖破除

ADR-063: 架构债务清偿（精简版）

ADR-062: 水面反射渲染目标与通用反射系统

ADR-061: 高级骨骼操控与姿态工作室实现计划

ADR-061.1: Ragdoll 保真度补齐实施计划

ADR-061.1: Ragdoll 保真度补齐（球面关节 + 旋转求解 + 暂停/过渡仲裁 + 关节参数化）

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: 配置持久化覆盖现状

ADR-046: 渲染独立开关 — Custom 性能模式（精简版）

ADR-045: 统一加载与资源管理（精简版）

ADR-044: MMD 生态竞品分析

ADR-043: DanceXR 功能差距挖掘

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 — 可配置快捷键系统

ADR-035: 设置面板功能缺口评估

ADR-034: 菜单体系大统一 — slideRow + cardContainer + lcard

ADR-033: config.ts 四向分裂 + tryCatchStatus 泛化 + slideRow 收束

ADR-032: 体积云渲染方案调查

ADR-031: 2026-07-05 会话清理 — 文档翻新 + AGENTS.md 瘦身 + 硬约束精简

ADR-030: 小说目录按功能分类重组

ADR-029: 物理设置界面重构 — 从布料单页到双系统分治

ADR-028: 风场系统统一 — 从碎片化到集中治理

ADR-027: 菜单响应式系统 — 控件自更新 + Proxy 自动触发

ADR-026: 环境系统增强 — 纹理地面、粒子系统、粒子溅射、水下后处理联动

ADR-025: 触屏交互优化与 ZIP 模型扫描通用化

ADR-024: 渲染增强 Phase 2（精简版）

ADR-022: 预设治理 — 统一管理范围与分级架构

ADR-021: 程序化动作系统（Idle/Auto Dance + LipSync + 视线追踪）

ADR-020: 换装系统（服装变体/纹理替换）

ADR-019: XPBD 布料模拟引擎选型与架构

ADR-018: PathManager 平台抽象层 + 文件 I/O 审计

ADR-017: Android 平台适配（精简版）

ADR-016: 视线追踪子系统架构

ADR-015: 材质编辑器 UI 重构 + 逐材质开关

ADR-014: 模型加载预设库（角色设置快照）

ADR-013: Skybox 贴图系统改进

ADR-012: 云渲染改进 — Perlin 噪声 + 双分层

ADR-011: Wails v3 迁移评估与决策

ADR-009: 模型详情面板 — 运行时模型实例控制

ADR-006: 扫描简化 + 文件名多编码自动检测

ADR-005: 待修复项 — 已知技术债务

ADR-004: CSS 统一重构 + 弹窗单例模式

ADR-003: 下载监听策略（精简版）

ADR-002: 配置写入分离 — writeConfig 轻写 vs writeConfigAndRescan 全量

ADR-001: 项目基础设施决策

知识卡

env

环境状态写入入口（setEnvState + 中间件链）

共享焦散纹理系统

云层系统

环境碰撞控制

环境系统上下文

环境变更分发回调（破循环依赖）

环境重力控制

地面材质单一事实源（GroundMaterialSpec）

地面系统

环境系统实现核心（barrel + observer + fog）

环境灯光包装

粒子系统

环境状态防抖持久化

反射系统

天空系统

地形生成器

统一贴图工厂

时间流转与太阳角系统

Babylon.js 类型逃逸封装

水下视觉系统

水面系统

湿身效果系统

环境系统门面（Facade）

统一平面反射引擎

scene

AR 摄像头视频透传

AR 模式场景级协调

姿势多角度预设系统

节拍驱动自动运镜（beatcut）

相机行为循环（freefly/surround/concert）

相机骨骼锁定

相机工厂 + 用户输入

相机状态管理 + 运行时上下文

相机 VMD 动画

相机模式管理系统（MmdCamera）

构图指南

脚部落地检测降级

分类材质系统

模型运行时 ID 解析

PMX 模型加载与缩略图捕获

模型注册表与生命周期管理

模型生命周期操作

换装叠加层

换装系统

PMX 声明纹理缺失审计

场景打包/解包

场景存档迁移（纯函数）

场景序列化与自动保存

场景核心编排器（纯组装器）

SSS PBR 材质

纹理路径 fallback 候选生成

纹理 LRU 缓存

缩略图渲染

缩略图缓存 key 推导

变换适配器注册表（双模态去重）

拖拽变换模式开关

变换目标拾取与元数据

变换选中物状态源

水印系统

physics

地面碰撞体（WASM Bullet 静态刚体）

物理骨骼桥与每帧注册表

裙摆拓扑分析（ADR-084 Phase 1）

虚拟裙骨物理控制器（ADR-084 Phase 2-3）

风力物理注入（WASM Bullet）

rendering

WebXR 能力探测

GPU 压缩纹理能力探测

反 Y 轴指针输入

光锥网格

个人灯光跟随

灯光预设系统

阴影生成器

舞台灯光系统

灯光模块状态对象

太阳圆盘可视化

灯光预设过渡动画

场景光照与阴影（barrel）

镜面道具

性能降级 — 环境桥接

性能监控与自动降级

统一质量档位解析器

场景渲染管线与后处理

3D 拖拽 Gizmo 统一抽象

motion

外部动作重定向桥

骨骼覆盖存储（多模块仲裁）

骨骼覆盖核心 API

手部独立控制模块（左手/右手）

口型同步桥

脚部地面跟随（MMD-native IK）

脚步声控制器

动作历史管理

场景级动作意图库

动作数学工具

动作模块基类

动作模块类型定义

动作模块 — 身体姿势

脚部独立控制模块（左脚/右脚）

动作模块注册表

动作模块 — 骑乘模型

动作管线（逐帧合成）

动作播放控制

动作预设类型

重心微动

眨眼模拟

呼吸模拟

微表情

JS 端视线追踪

WASM 端视线追踪

视线追踪主模块

感知口型同步

感知观察者（感知层）

感知层共享类型

感知层主控

程序化动作系统

多 VMD 叠加系统

VMD 动作加载器

WASM 图层混合器

ui

AI 助手独立面板入口

诊断助手 → 聊天 UI（子模块）

诊断助手 → 配置 UI（子模块）

诊断助手 → tool call 控制（子模块）

诊断助手 → 会话管理（子模块）

诊断助手 → 单例状态（子模块）

渲染层 DOM 契约单源

环境菜单层级系统

环境弹窗（编排 + barrel）

资源库操作

资源库浏览弹窗

资源库核心

资源库会话状态单例

资源库初始化

资源库入口与编排

菜单工厂

菜单 Overlay 与 Wrapper 管理

声明式菜单 Schema 注册表

声明式菜单 Schema 集中注册聚合器

声明式菜单 Schema

菜单栈共享指针（stackRegistry）

滑出式菜单引擎（SlideMenu）

模型子菜单构建

材质编辑 UI

模型预设管理 UI

动作绑定 UI

动作详情 UI

动作菜单层级系统

动作覆盖 UI 层级（模块化覆盖 + 高级骨骼覆盖）

换装 UI 构建器

模型广场浏览器

模型广场创作者列表

广场下载拦截器

广场站点配置

广场状态管理

模型广场 UI 辅助函数

预设列表查看器

菜单渲染引擎

场景拖拽层级菜单

场景菜单层级系统

场景菜单共享状态

场景弹窗（编排 + 路由）

舞台灯光菜单层级

设置 — 关于页面

设置动作映射表

外观设置

设置 — 操控页面

AI 诊断助手面板（协调入口）

设置 — 画面页面

语言设置

设置 — 媒体页面

设置 — 资源页面

设置共享工具

设置 — 系统页面

设置目标常量

设置页路由与编排

UI 辅助函数聚合

基础行控件构建器

core

统一动作注册表 — 菜单/NL/快捷键共享真相源

AI 配置持久化（IndexedDB）

错误环形缓冲与全局捕获

NL 意图解析 — LLM 文本 → 动作执行

场景运行时快照（AI 上下文）

内置 AI 诊断助手 — 双适配器服务层

SSE 流式解析器

安卓文件访问（shared 模式）

音频总线

角色台词生成 — 人设约束 + 情绪解析 + TTS 朗读

AI 会话 IndexedDB 存储

颜色工具函数

配置聚合层

后端适配层

DOM 工具

核心零依赖叶模块

轨道坐标系转换

共享类型定义

工具函数叶模块群

开发环境 E2E 钩子

诊断用动作注册

跨平台对话框

安全释放工具

拖拽导入逻辑层

E2E 状态读取器注入桥

EnvState 默认值派生

EnvState 单一源 Schema

事件处理与导航系统

结构化反馈 API

统一文件服务层

Go 错误翻译

确定性哈希与值噪声

国际化翻译函数

图标聚合

应用启动引导

统一资源加载队列

模型加载/库扫描完成后菜单刷新注册表

国际化语言状态

轻量日志工具（无依赖）

轻量 Markdown→DOM 渲染器

window.__mmar 运行时状态暴露

babylon-mmd 适配边界

Observer 生命周期管理

轨道相机键盘输入状态叶子

服装变体配置指南

平台能力探测

PMX 元数据提取

预设元数据归一化

轻量响应式刷新系统

菜单渲染上下文栈（RenderContext）

渲染循环与 FPS 时钟

资源加载失败统一汇总

Runtime 隔离桥（Wails Events/Browser）

运行模式检测

'@wailsio/runtime 浏览器桩'

安全调用工具

场景动作注入桥

应用快捷键定义

快捷键注册表

全局状态与场景运行时 Store

状态栏与提示系统

主题纯函数叶

Toast 通知系统

UI 行为注入桥

UI 与场景常量

焦点陷阱工具

标题栏小型开关（createHeaderToggle）

键盘导航工具

菜单导航项契约

预设面板复合组件

滑块输入控制器

UI 持久化状态

后端绑定聚合层（backend 代理化）

统一风场辅助函数

简体中文语言包

繁体中文语言包

backend

Go 后端核心（App 生命周期 + 配置系统）

Go 文件对话框封装

Go 文件与路径平台抽象

Go 模型隔离与安全 HTTP

Go 错误 i18n 信封

Go 软件集成（Blender/MMD/自定义）

Go KTX2 纹理编码

Go 模型库扫描

Go LLM 客户端与 AI 绑定

Go 广场窗口与配置

Go 预设持久化与标签

Go 模型广场代理（SSRF 防护）

Go 场景序列化与打包

Go 缩略图缓存

Go 更新检查与安装

Go 通用工具

Go 下载目录监听与导入

Go ZIP 解压与缓存管理

小说

01-基础设施与依赖

建材仓库的大扫除

目录的守望者

图标战争

数据的纹路

错位的五键

不存在的 bug

删与留

最后一公里

回声的归处

声音与按键

音效总线

五种语言

快捷键注册表

快捷键的登记簿

场景的底片

尾章 · 减法

02-UI交互

00-序章

放大的议会

审美的裂缝

议会的三路分流

城邦的户籍重划

议院改革

隐形的面板

悬空之影

空白的弹窗

弹窗之战

替身

重构风暴

三层闭包

调目

调目·校验

滑动的议会

空白的一秒

所见即所得

看不见的缝隙

图书馆的摆书人

第 19 章 · 电梯的楼层记忆

第 20 章 · 调参数的手感

第 22 章 · 忘记的设置

被偷走的焦点

设置页的五幕

替身的最后一刀

拖拽之手

议会的黑板

设置页的缺口

城邦的蓝图

账本的合并术

第 31 章 · 目录的记忆术

第 32 章 · 审核的微光

03-动作演算

动作的语法

节拍与曲线

WASM 骨骼物理

VMD 的回写

唇语的算法

翻译官

04-音频与换装

纹理织工

音频的节律

衣褶的叠加

衣橱的自动发现

05-布料物理

布料之魂

织布机的垃圾

快递员与会变形的护盾

沉默的函数

拆迁日

旧城拆迁

借来的骨头

06-相机移动

视角

多相机之眼

经纬的统一

第 4 章 · 双轴分野

借来的一双眼

07-环境渲染

天穹之境

天穹之图

天光之悟

尘与风

天穹之华

光影之协奏

地面的重生

反射与幽灵粒子

反射的统一

调光器的最小档位

四风归一

水面苏醒

水下的呼吸

云层协议

08-模型管理

裂隙初现

三态之仓

给模型拍证件照

术语圣战

材质的纹章学

三层解剖

消失的头发

没装子弹的枪

账本的自动落印

不显影的证件照

被压扁的证件照

锁死的钥匙，沉默的笔

入境的手续

09-程序化动作

舞蹈的轮回

印章与账本

感知层的重生

活着

脚踏实地

猫步

快门与心跳

历史的游标

10-灯光与阴影

调色台

灯塔的觉醒

光的七宗罪

夕阳的影子

双影

三面镜

降级的台阶

追光的人

附录·其他

机器中的巨石

附录：隐形的面板 — 代码块全集

附录·安全横切

追赶者的阴影

XSS 攻坚战

路径的陷阱

边境线

附录·跨模块重构

重构日

瘦身日

组装与检查

八城之盟

三刀之后

第九城

西西弗斯之夜

循环深渊

打包之战

预设宪章

八城审计

物理之躯

三审

第 14 章 · 中段清算

四条路

审计拾遗

审计报告

审计报告的最后一页

物理的迁徙

加载的统一

被遗忘的记忆

HTTP 的黄昏

附录·文档演进

第五章 · 读图

第四章 · 绘图师

第零卷 03 · 试金石试验室

第九章 · 审计之光

第四章 · 伪影与真镜

第 4 章 · 代码的镜厅

第四章 · 在别人的地图上

第 3 章 · 议会与织工

失忆的档案室

收敛的纪元

回声的几何

全绿的谎言

目录与向导

说「help」的语言

手术刀与伤疤

附录·Go后端

地下管道的检修

断桥重建

工坊

安卓之门

开发运维

Bug 日志

骨骼变换覆写无效（视线追踪程序化骨骼旋转）

菜单两套导航机制AI难重写

纹理不显示：模型无颜色

程序化动作脚穿透地面

程序化动作应用到角色无效（动作1）

程序化动作切换与缩略图截帧时序冲突

用户VMD加载后角色呼吸消失

水面关掉后不恢复

单一全局音量控制所有声音

两套物理引擎并存性能差3至5倍

WASM 404：`index_bg.wasm` 无法加载

VMD 播放无反应

UI 硬编码中文无法切换语言

Shader 404：textureAlphaChecker.vertex.fx

security-audit-CVE

PMX 加载失败：`is not pmx file`

grid切换后地面变纯色重启才恢复

Ctrl+Space 被三个模块同时注册静默覆盖

CORS：Wails WebView 跨域被拦

2026-08-10-overlay-click-unreachable-headless

2026-08-09-model-manager-test-ts-nocheck-private-access

2026-08-03-web-entry-btnMainAction-not-rendered

2026-08-03-shared-toon-disposed-on-model-remove

2026-08-03-guide-screenshots-gap

2026-08-03-babymmd-binding-warning-noise

2026-08-02-schema-driven-action-drive-pitfalls

2026-08-02-resource-load-missing-warning

2026-08-02-mirror-geometry-persist-gap

2026-08-02-e2e-web-preview-4174-down

2026-08-02-body-posture-bend-no-effect

2026-08-01-web-locale-404-text-keys

2026-07-31-babylon-mmd-dist-esm-resolution

2026-07-29-slog-custom-handler-hang

2026-07-28-prepush-lint-and-stale-test

2026-07-25-web-zip-pmx-subdir-textures

2026-07-25-web-texture-stem-collision

2026-07-21-visibilitychange-dispose-scene-freeze

2026-07-20-GroundMesh-ShaderMaterial-effect-null-crash

2026-07-19-test-mock-gap-and-stale-assertions

2026-07-17-water-preset-nan-uniform

2026-07-17-bone-override-parent-child-propagation

2026-07-17-adr124-file-access-migration

2026-07-16-thumbnail-cache-miss

2026-07-16-thumbnail-aspect-ratio-ui-grid

2026-07-16-env-state-not-restored

2026-07-15-settings-menu-defects

2026-07-15-path-override-ignored

2026-07-11-vmd-layers-type-comments

2026-07-11-seven-rounds-summary

2026-07-11-perception-writeMatToBuffer

2026-07-11-MmdRuntimeBoneExtended-dedup

2026-07-11-lighting-tween-bugs

2026-07-11-env-water-setWorldMatrix

发版记录

v1.9.1

v1.9.0

v1.8.0

v1.7.0

v1.6.7

v1.6.6

v1.6.5

v1.6.3

v1.6.1

v1.6.0

v1.5.3

v1.5.2

v1.5.1

v1.5.0

v1.4.1

v1.4.0

v1.3.6

v1.3.5

v1.3.3

v1.3.1

v1.2.7

v1.2.6

v1.2.5

v1.2.3

v1.2.1

v1.2.0

v1.1.4

release-process

本页导航

换装叠加层

Pager

Previous page模型生命周期操作

Next page换装系统