Appearance
编码奇谭：MikuMikuAR 联邦演义
在一个 PMX 模型散落于各城邦的世界里，一个桌面壳不发明任何东西，只让所有城邦共享同一个模型库。
目录结构总览
本小说按 frontend/src/ 代码目录锚定 10 章 + 1 个附录容器。改了代码 → 看路径前缀 → 命中对应章 → 更新该章尾部。
| 章号 | 文件夹 | 对应代码目录 |
|---|---|---|
| 01 | 01-基础设施与依赖/ | frontend/src/core/ |
| 02 | 02-UI交互/ | frontend/src/menus/ |
| 03 | 03-动作演算/ | frontend/src/motion-algos/ |
| 04 | 04-音频与换装/ | frontend/src/outfit/ |
| 05 | 05-布料物理/ | frontend/src/physics/ |
| 06 | 06-相机移动/ | frontend/src/scene/camera/ |
| 07 | 07-环境渲染/ | frontend/src/scene/env/ |
| 08 | 08-模型管理/ | frontend/src/scene/manager/ |
| 09 | 09-程序化动作/ | frontend/src/scene/motion/ |
| 10 | 10-灯光与阴影/ | frontend/src/scene/render/ |
附录 appendix/ 收纳非代码目录锚定的章节，分 4 组：跨模块重构 / 文档演进 / Go后端 / 安全横切。
判定规则与决策链路详见 AGENTS.md（写作规范，不入文档站）。
01-基础设施与依赖 · 对应 frontend/src/core/
共享状态、配置、文件URL、图标、UI helpers、快捷键路由。
| 章 | 标题 |
|---|---|
| 1 | 建材仓库的大扫除 |
| 2 | 目录的守望者 |
| 3 | 图标战争 |
| 4 | 数据的纹路 |
| 5 | 错位的五键 |
| 6 | 不存在的bug |
| 7 | 删与留 |
| 8 | 最后一公里 |
| 19 | 回声的归处 |
| 19 | 声音与按键 |
| 19 | 音效总线 |
| 20 | 五种语言 |
| 21 | 快捷键的登记簿 |
| 21 | 快捷键注册表 |
| 22 | 场景的底片 |
| — | 尾章·减法 |
02-UI交互 · 对应 frontend/src/menus/
MenuStack、弹窗、设置页、模型库 UI、动作 UI、环境 UI、场景 UI。
| 章 | 标题 |
|---|---|
| 0 | 序章 |
| 1 | 放大的议会 |
| 2 | 审美的裂缝 |
| 3 | 议会的三路分流 |
| 4 | 城邦的户籍重划 |
| 5 | 议院改革 |
| 6 | 隐形的面板 |
| 7 | 悬空之影 |
| 8 | 空白的弹窗 |
| 9 | 弹窗之战 |
| 10 | 替身 |
| 11 | 重构风暴 |
| 12 | 三层闭包 |
| 13 | 调目 |
| 14 | 调目-校验 |
| 15 | 滑动的议会 |
| 16 | 空白的一秒 |
| 17 | 所见即所得 |
| 18 | 看不见的缝隙 |
| 19 | 图书馆的摆书人 |
| 20 | 电梯的楼层记忆 |
| 21 | 调参数的手感 |
| 22 | 忘记的设置 |
| 23 | 被偷走的焦点 |
| 24 | 设置页的五幕 |
| 25 | 替身的最后一刀 |
| 26 | 拖拽之手 |
| 27 | 议会的黑板 |
| 28 | 设置页的缺口 |
| 29 | 城邦的蓝图 |
| 30 | 账本的合并术 |
| 31 | 目录的记忆术 |
| 32 | 审核的微光 |
03-动作演算 · 对应 frontend/src/motion-algos/
程序化动作、VMD 写入、VPD 解析、节拍检测、LipSync 算法。
| 章 | 标题 |
|---|---|
| 1 | 动作的语法 |
| 2 | 节拍与曲线 |
| 3 | WASM骨骼物理 |
| 4 | VMD的回写 |
| 5 | 唇语的算法 |
| 6 | 翻译官 |
04-音频与换装 · 对应 frontend/src/outfit/
音频播放、VMD 同步、节拍挂载、换装系统、纹理变体、FBX 叠加层。
| 章 | 标题 |
|---|---|
| 1 | 纹理织工 |
| 2 | 音频的节律 |
| 3 | 衣褶的叠加 |
| 4 | 衣橱的自动发现 |
05-布料物理 · 对应 frontend/src/physics/
XPBD 求解器、布料生成、SDF 碰撞、调试可视化、布料管理器。
| 章 | 标题 |
|---|---|
| 1 | 布料之魂 |
| 2 | 织布机的垃圾 |
| 3 | 快递员与会变形的护盾 |
| 4 | 沉默的函数 |
| 5 | 拆迁日 |
| 5 | 旧城拆迁 |
| 6 | 借来的骨头 |
06-相机移动 · 对应 frontend/src/scene/camera/
相机模式、自由飞行、相机 VMD 轨道、轨道坐标统一。
| 章 | 标题 |
|---|---|
| 1 | 视角 |
| 2 | 多相机之眼 |
| 3 | 经纬的统一 |
| 4 | 双轴分野 |
| 5 | 借来的一双眼 |
07-环境渲染 · 对应 frontend/src/scene/env/
天空、地面、雾、云、水、粒子、风、环境预设、光照推导。
| 章 | 标题 |
|---|---|
| 1 | 天穹之境 |
| 2 | 天穹之图 |
| 3 | 天光之悟 |
| 4 | 尘与风 |
| 5 | 天穹之华 |
| 6 | 地面的重生 |
| 6 | 光影之协奏 |
| 7 | 调光器的最小档位 |
| 7 | 反射的统一 |
| 7 | 反射与幽灵粒子 |
| 8 | 四风归一 |
| 10 | 水面苏醒 |
| 11 | 水下的呼吸 |
| 番外 | 云层协议 |
08-模型管理 · 对应 frontend/src/scene/manager/
模型注册表、PMX 加载、缩略图、材质系统、模型操作、预设、保存触发。
| 章 | 标题 |
|---|---|
| 1 | 裂隙初现 |
| 2 | 三态之仓 |
| 3 | 给模型拍证件照 |
| 4 | 术语圣战 |
| 5 | 材质的纹章学 |
| 6 | 三层解剖 |
| 7 | 消失的头发 |
| 8 | 没装子弹的枪 |
| 9 | 账本的自动落印 |
| 10 | 不显影的证件照 |
| 11 | 被压扁的证件照 |
| 11 | 锁死的钥匙与沉默的笔 |
| 12 | 入境的手续 |
09-程序化动作 · 对应 frontend/src/scene/motion/
VMD 加载播放、程序化动作桥接、LipSync 桥接、播放控制。
| 章 | 标题 |
|---|---|
| 1 | 舞蹈的轮回 |
| 2 | 印章与账本 |
| 3 | 感知层的重生 |
| 3 | 活着 |
| 4 | 脚踏实地 |
| 5 | 猫步 |
| 6 | 快门与心跳 |
| 7 | 历史的游标 |
10-灯光与阴影 · 对应 frontend/src/scene/render/
渲染管线、灯光、阴影、性能降级、后处理。
| 章 | 标题 |
|---|---|
| 1 | 调色台 |
| 2 | 灯塔的觉醒 |
| 3 | 光的七宗罪 |
| 4 | 夕阳的影子 |
| 5 | 双影 |
| 6 | 三面镜 |
| 7 | 降级的台阶 |
| 8 | 追光的人 |
附录 · 跨模块重构
多模块同时动刀的工程事件。
| 章 | 标题 |
|---|---|
| 1 | 重构日 |
| 2 | 瘦身日 |
| 3 | 组装与检查 |
| 4 | 八城之盟 |
| 5 | 三刀之后 |
| 6 | 第九城 |
| 7 | 西西弗斯之夜 |
| 8 | 循环深渊 |
| 9 | 打包之战 |
| 10 | 预设宪章 |
| 11 | 八城审计 |
| 12 | 物理之躯 |
| 13 | 三审 |
| 14 | 中段清算 |
| 15 | 四条路 |
| 16 | 审计拾遗 |
| 17 | 审计报告 |
| 18 | 审计报告的最后一页 |
| 20 | 物理的迁徙 |
| 21 | 加载的统一 |
| 22 | 被遗忘的记忆 |
| 23 | HTTP的黄昏 |
附录 · 文档演进
文档 / 测试体系本身的发展。
| 章 | 标题 |
|---|---|
| 1 | 读图 |
| 2 | 绘图师 |
| 3 | 试金石试验室 |
| 4 | 审计之光 |
| 5 | 伪影与真镜 |
| 6 | 代码的镜厅 |
| 7 | DanceXR调研 |
| 8 | 议会与织工 |
| 9 | 失忆的档案室 |
| 10 | 收敛的纪元 |
| 11 | 回声的几何 |
| 12 | 全绿的谎言 |
| 13 | 目录与向导 |
| 14 | 说help的语言 |
| 15 | 手术刀与伤疤 |
附录 · Go 后端
Go 代码与 Wails 框架。
| 章 | 标题 |
|---|---|
| 1 | 地下管道的检修 |
| 2 | 断桥重建 |
| 3 | 工坊 |
| 4 | 安卓之门 |
附录 · 安全横切
横切多模块的安全问题。
| 章 | 标题 |
|---|---|
| 1 | 追赶者的阴影 |
| 2 | XSS攻坚战 |
| 3 | 路径的陷阱 |
| 4 | 边境线 |
附录 · 其他
| 类别 | 标题 |
|---|---|
| 代码附录 | 附录：隐形的面板 — 代码块全集 |
| 原始稿存档 | 机器中的巨石 |
章节计数：本目录不再维护章节总数统计表。新增章节只需在对应章文件夹放置 NN-标题.md，重跑 npm run gen:novelindex 即自动入列；索引由脚本生成，请勿手改。