打字时伸爪，听音乐时摇尾。
奶牛猫是 Miucs 的默认桌面伙伴：黑白猫爪跟随按键，猫头随打字轻晃，尾巴响应音乐节拍。画面透明、默认鼠标穿透，不抢键盘焦点。
macOS 14+ · Apple Silicon · Swift 6 · Windows 10/11 · 实机待验
预览使用合成音乐与按键输入，经正式 Lua/Skia 绘制器生成；GIF 无声，不是桌面录屏。
| 插件 | 效果 | 详细说明 |
|---|---|---|
| 奶牛猫 · 默认主打 | 黑白猫爪敲键、猫头轻晃、尾巴随节拍摆动 | 奶牛猫 |
| 麦芬 | 两只线条小狗随打字跳跃，麦芬随节拍吹泡泡 | 麦芬 |
| 牛来 | 牛蹄响应按键，上方角色随音乐和打字运动 | 牛来 |
| 平次与和叶 | 平次随打字挥木剑，和叶随节拍转身 | 平次与和叶 |
| 塞尔达 | 林克随按键挥剑、举盾，守护者随拍点发射激光 | 塞尔达 |
| 摇曳露营 | 抚子随打字吃面，凛随音乐捧杯轻啜，篝火随拍点轻跳 | 摇曳露营 |
| 犬夜叉 | 打字时犬夜叉逞强，节拍触发戈薇指地、扑地和七宝受惊，全程无对白 | 犬夜叉 |
查看七个插件的动态预览。首次启动默认选择奶牛猫；之后记住你的选择。所有皮肤共用当前位置和大小，切换只换画面，重启恢复同一位置；不重启输入采集。
需要 Apple Silicon、macOS 14+、Swift 6、Python 3.10+、CMake 3.24+；首次本地开发签名需要 OpenSSL 3。
zsh build.sh
open dist/Miucs.app首次运行按提示授权系统音频捕获；要让猫爪响应打字，授予「输入监控」权限。音频和键盘可以同时使用，也能独立运行。系统休眠或音频中断后自动恢复，也可在「设置 → 声音与键盘」重新连接音频。更新后先退出旧版，再打开新构建。
提供 .NET 8/WPF、WASAPI 实现。构建方法见 Windows README，实机验证范围见 验收表。
macOS 和 Windows 都有独立设置窗口，分为「皮肤」「外观与位置」「声音与键盘」「关于 Miucs」。皮肤卡片直接显示图片或 GIF；整张卡片和整行侧栏都可点击，并有悬浮与按下反馈。五线谱与铅笔飞鸟不再提供。
- 皮肤：卡片选择、打开皮肤目录、重新扫描、重新加载当前皮肤。
- 外观与位置：调整大小、不透明度和桌面位置；切换皮肤保持当前矩形。
- 声音与键盘：查看连接状态、重新连接；Windows 键盘响应需主动启用，托盘动画开关也在这里。
- 桌面调整：鼠标悬停 3 秒点击小锁，再拖动或从右下角缩放，完成后恢复鼠标穿透。
macOS 在程序坞显示 Miucs，点击打开设置；Windows 设置显示在任务栏，关闭时最小化并继续运行，点击任务栏或再次运行应用可恢复设置。菜单栏 / 托盘仅保留打开设置、显示 / 隐藏皮肤、调整位置与大小和退出。
「设置 → 硬件屏幕」可把当前皮肤通过 USB 发到 ESP32-P4 小屏。使用支持原生桌宠的桌屿固件时，七套内置皮肤上传 Lua 和资源包，由开发板绘制；Mac 发送按键与音频特征，支持实例恢复和连续输入。不支持原生桌宠的设备保留 JPEG 卡片适配。使用 Miucs 屏幕固件时，画面铺到整屏，支持横竖屏及反向切换。
将已烧录对应固件的开发板接到原生 USB 数据口，再开启「在硬件屏幕上显示皮肤」。使用支持 CH343 的桌屿固件时，也可以把线接到烧录口，由运行中的桌屿 Mac 应用转发。连接中断后会自动重连。音乐和按键由电脑处理，隐藏桌面皮肤后小屏可继续显示。Miucs 整屏固件的型号、烧录与回退见 硬件适配说明。
本仓库提供 MiucsCore Swift Package。桌屿等宿主可以在自己的进程中使用 Miucs 的键盘、音频、皮肤资源和原生桌宠会话，无需另开 Miucs 应用。核心库不启动桌面窗口或 Lua/Skia worker；独立应用仍保留完整桌面功能。仓库依赖、资源打包、权限和生命周期见 嵌入指南。
应用内置七个 Lua 5.4/Skia 插件，也可安装自己编写的插件。首次构建自动下载并校验运行库依赖。开发和调试见 插件开发指南 与 插件工作台。
音频与物理按键只在本机分析，不依赖网络模型；应用不保存真实音频、屏幕或输入文字。