MUSIC-3

MUSIC-3 是一个基于 TypeScript + Tauri + Rust 的 Windows 本地音乐语音控制桌面应用。当前仓库已经包含：

• 规则型 agent 命令解析
• 可选 LLM 兜底理解与推荐增强
• 本地偏好学习
• Windows 本地 TTS 语音回复
• Tauri 播放器运行时与桌面 UI

Windows 快速启动

在仓库根目录执行：

powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1 -Run

这条命令会自动：

1. 检查 Node.js、npm、Rust、cargo、WebView2
2. 创建 .runtime/
3. 在缺少 .env 时从 .env.example 复制
4. 安装 npm 依赖
5. 运行 npm run check
6. 启动 Tauri 桌面应用

如果你只想检查环境和安装依赖，不直接启动：

powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1

常用命令

npm run doctor
npm run setup
npm run app
npm run check

说明：

• npm run doctor：检查 Windows 运行环境
• npm run setup：执行自举安装但不启动应用
• npm run app：自举并启动应用
• npm run check：执行 TypeScript 检查

LLM 配置

LLM 不是必需项。没有 API Key 时：

• 基础规则命令仍可使用
• 本地播放器和 UI 仍可运行
• 只有 LLM 兜底理解和推荐增强不可用

可以在桌面 UI 的 LLM Settings 中填入：

• API Key
• Base URL
• Model

配置会保存到：

.runtime/app-settings.json

偏好与运行数据

运行时会在 .runtime/ 下写入本地数据，例如：

• app-settings.json
• preferences.json

这些文件不应提交到 Git 仓库。

Skill

仓库内置了一个 Codex skill：

.agents/skills/music3-windows-runner

当用户把这个仓库交给 agent 并要求在 Windows 上直接跑起来时，应优先使用该 skill，统一走：

powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1 -Run

已知限制

• 当前本地 TTS 是 Windows 专用实现，依赖 PowerShell 和 SAPI.SpVoice
• Rust 侧仍有 rodio::DeviceTrait::name 的弃用警告，但不影响当前运行