企业官网建设流程全解析

Music Island（音乐悬浮岛）是一款免安装的 Windows 10/11 音乐控制工具：把鼠标移到屏幕顶部边缘，音乐悬浮岛就会弹出，播放、暂停、切歌、进度条尽在指尖。它默认通过 Windows SMTC 媒体协议跟随任意支持系统的播放器（Spotify、浏览器播放器等），还支持本地语音输入、Better Voice 降噪插件和 AI 助手额度面板，且全程本地运行、无遥测。

快速上手：下载 exe 免安装即用

Music Island 是绿色便携应用，三步完成部署：

1. 下载最新的music-island.exe，保存到你希望长期保留的文件夹；
2. 直接双击打开，无需安装向导；
3. 按首次启动的四步引导（Onboarding）完成设置，其中最后一步会显式询问是否随 Windows 开机自启。

⚠️ 可执行文件未做签名，Windows SmartScreen 可能弹出警告，属于正常现象，详见 SECURITY.md。所有设置存放在%APPDATA%\Music Island\，日后直接替换新 exe 即可升级，配置不丢失。

首次启动的四步引导源码位于 src/features/intro/Onboarding.tsx，第一步的文案正是本教程的核心操作："Move to the top edge to pause music and skip tracks"（移到顶部边缘即可暂停和切歌）。

核心操作：鼠标悬停桌面顶边唤出音乐岛

这是 Music Island 的招牌交互，记住一个动作即可：

• 鼠标贴近屏幕顶边并停留，悬浮岛从顶边滑出，显示封面、歌曲信息、进度条和播放控制；
• 鼠标离开后岛屿自动收回到一条细进度线（顶部边缘指示器），不打扰你的工作；
• 唤出时岛屿会保持展开至少 3 秒，即使鼠标短暂离开也有充足时间点击控制按钮——这就是标题中"3秒掌控"的由来，悬停保持逻辑实现于 src/features/overlay/OverlayShell.tsx。

小贴士：如果顶边响应太快或太迟钝，可在设置里调整悬停延迟（80–1200ms 毫秒级可调），相关控件在 src/features/settings/SettingsPanel.tsx 中实现。多显示器场景下，在"外观（Appearance）"中选择悬浮岛所在显示器；旋转屏幕或分辨率变化后位置会自动跟随，断开的优先显示器重连后岛屿会自动回到原屏。

播放什么：三种音乐源连接方式

切换入口在设置 → Music source。SMTC 是目前最通用的方案：Spotify、浏览器播放器等只要开始播放，就会注册 Windows 媒体会话并被悬浮岛接管。注意部分浏览器播放器要开始播放后才会出现在列表中（详见 docs/TROUBLESHOOTING.md）。

进阶一：自定义你的悬浮岛布局

3.0 版本引入了实时布局编辑器，"所见即所得"地拼装岛屿：

• 把封面、播放键、进度、点赞/踩（Reactions）、AI 助手小组件直接拖进预览；
• 拖动边缘改变宽度，拖动角落改变整体缩放；
• 设置按钮与播放/暂停永远保留，不用担心拖丢；
• 石墨深色与浅色主题共用同一套控件与布局。

进阶二：任务栏迷你播放器

不想每次悬停顶边？可以开启原生任务栏迷你播放器：设置 → Taskbar → Taskbar mini-player（默认关闭）。

• 它以原生 Win32 窗口形式贴在 Windows 系统托盘旁，随任务栏出现/隐藏而移动，不嵌入 WebView，零干扰；
• 默认包含封面 + 上一首 + 播放/暂停 + 下一首，可自由添加点赞、随机、单曲循环并调整大小与顺序；
• 点击封面会立即唤出顶部悬浮岛并保持至少 3 秒，方便随时切换到完整控制。

架构细节（同进程 Win32 子窗口、防碰撞布局策略等）见 docs/TASKBAR.md。

附赠能力：本地语音输入与麦克风降噪

音乐控制之外，Music Island 还内置了两项可选能力：

• 本地语音输入（Dictation）：按快捷键说话，识别结果直接插入当前活动应用。识别完全在本地运行，模型需先在 设置 → Dictation 中下载；支持词库、历史录音（含音频）、可选的 AI 后处理。文档见 docs/DICTATION.md；
• Better Voice（Beta）：实时降噪、压缩、限幅等麦克风处理管线，配合狐狸形象实时可视化电平，把"处理前后的声音"直观展示出来。

两项功能均默认关闭、按需启用，隐私边界见 docs/PRIVACY.md。

常见问题排查（FAQ）

完整排障清单见 docs/TROUBLESHOOTING.md，版本演进记录见 CHANGELOG.md。

总结：把播放器放回你视线最顺手的位置

Music Island 用"悬停顶边 3 秒"这一极简交互，把任何 Windows 播放器的控制权收拢到桌面最上方：免安装、本地优先、无遥测、可深度定制，还顺带附赠任务栏迷你播放器、本地语音输入和麦克风降噪。对于经常切换 Spotify、浏览器播放器的用户，它几乎是零成本的生产力升级。