vscode中实现live2d看板娘需使用rainbow fart waifu插件，它唯一稳定支持桌面级.waifu模型并触发交互；须手动下载live2d-model-collections的合规模型包，按规范路径放置并匹配.physics3.json、pose3.json及idle命名等配置。
VSCode 里用 Live2D 看板娘，核心靠 Rainbow Fart Waifu 插件
不是所有 Live2D 插件都能在 VSCode 里“活”起来——Rainbow Fart Waifu 是目前唯一稳定支持桌面级 Live2D 模型（.waifu 格式）并在编辑器内触发交互的插件。它本质是把 live2d-model-collections 的模型资源加载进一个轻量容器，再通过命令控制显示/切换。别试 vscode-live2d 或其他名字带 live2d 的插件，它们要么已停更，要么只改背景图、不跑模型。
安装后模型不显示？大概率卡在资源路径和格式上
装完插件只是第一步，Rainbow Fart Waifu 不自带任何模型，也不自动下载。你必须手动获取合法 .waifu 模型包，并放到指定目录：
- 去 GitHub 打开
live2d-model-collections仓库，点Download ZIP下载完整模型集 - 解压后找到某个子文件夹（比如
shizuku.waifu），它里面必须含model.model3.json、model.moc3、textures/等标准 Live2D v3 结构 -
Ctrl + Shift + P→ 输入Show Rainbow Fart Waifu Commands→ 选Open resource directory→ 进入live2dpackages文件夹 → 把整个xxx.waifu文件夹拖进去（不是里面的内容，是整个文件夹） - 再执行
Switch waifu models，列表里出现名字才算成功
模型能动但行为奇怪？检查 physics3.json 和 motion 组名是否匹配
很多模型放进去能显示、能眨眼，但点击没反应、idle 动作卡住、物理晃动异常——问题几乎都出在模型配置文件本身，而非插件设置：
在整本书中我们所涉及许多的Flex框架源码，但为了简洁，我们不总是显示所指的代码。当你阅读这本书时，要求你打开Flex Builder，或能够访问Flex3框架的源码，跟随着我们所讨论源码是怎么工作及为什么这样做。 如果你跟着阅读源码，请注意，我们经常跳过功能或者具体的代码，以便我们可以对应当前的主题。这样能防止我们远离当前的主题，主要是讲解代码的微妙之处。这并不是说那些代码的作用不重要，而是那些代码处理特别的案例，防止潜在的错误或在生命周期的后面来处理，只是我们当前没有讨论它。有需要的朋友可以下载看看
-
.physics3.json缺失或字段损坏，会导致头发/裙摆不随鼠标移动而摆动 -
.pose3.json里定义的姿势组名（如TapBody、TapHead）必须和插件默认触发逻辑对得上；否则点击头部没反应，只能点身体 - 动作文件夹里的
Idle组若不存在或命名不一致（比如叫idle小写），插件就找不到默认待机动画，人物会僵住 - 如果想自定义交互行为，得改插件源码里的
interactionMap配置，不是改 settings.json
Power Mode + Live2D 一起开？小心性能掉帧和音频冲突
两个“摸鱼神器”叠加很爽，但实际运行时容易翻车：
-
Power Mode的粒子爆炸动画由 Webview 渲染，Live2D 也是靠 Canvas/WebGL 渲染，共用主线程，高配机器也可能卡顿——建议把powermode.presets设为simple-rift或clippy，避免fireworks这类重特效 -
Rainbow Fart Waifu默认播放语音提示（比如“主人来啦～”），和 Power Mode 的音效、你自己外放的 BGM 容易打架；关语音需手动删插件目录下的audio/文件夹 - 两者都启用时，VSCode 窗口最小化再恢复，Live2D 常常黑屏或错位，此时要手动执行一次
Reload Waifu命令（在 Waifu Commands 里）
真正麻烦的从来不是装插件，而是模型本身的结构兼容性和交互配置细节。一个 .waifu 文件夹看着简单，但少一个 .physics3.json，或者 motion 文件夹里 idle 动作命名差个大小写，人物就彻底“罢工”。别急着换模型，先用插件自带的 demo 模型跑通流程，再替换。
