> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 音乐

> 查看和控制 Mac 上 Spotify 或 Apple Music 正在播放的内容，并让智能体播放你想听的。

音乐显示并控制你 Mac 上的音乐应用：Spotify 和 Apple 的“音乐”。它自己不播放流媒体，也不需要账号或密钥。它随 Archetype 一起提供，默认开启。仅支持 macOS。通用设置见[插件](https://docs.archetype.ing/zh/extend/plugins.md)。

## 在侧边栏中

**音乐**显示正在播放的内容，包括封面、进度条、控制按钮和音量，还可以在你安装的应用之间切换。

* **Spotify**：粘贴 Spotify 链接即可播放，也可以搜索。
* **Apple Music**：搜索你的资料库，播放你的播放列表。

你查看页面时，它每 2 秒读取一次这些应用。未打开的应用显示为未打开，而不是错误。

## 允许 Archetype 控制这些应用

第一次使用时，macOS 会询问是否允许 Archetype 控制 Spotify 或“音乐”。请允许。如果之前选了不允许，打开“系统设置 → 隐私与安全性 → 自动化 → Archetype”，开启对应的应用。未获允许时，页面会显示这些步骤。

## 智能体能做什么

| 工具 | 作用 |
| - | - |
| `now_playing` | 现在正在播放什么，在哪里播放。只读。 |
| `search_music_library` | 在你的“音乐”资料库中查找歌曲。只读。 |
| `list_music_playlists` | 列出你在“音乐”中的播放列表。只读。 |
| `control_music` | 播放、暂停、下一首、上一首、跳转、音量、随机播放、重复播放。 |
| `play_music` | 播放 Spotify 链接、“音乐”中的歌曲或播放列表。 |

在 `control_music` 或 `play_music` 之前，插件自己不会询问任何事。

## 设置

| 设置 | 作用 |
| - | - |
| **Music app**（`player`） | 两个应用都没有播放时页面显示的应用：`auto`、`spotify` 或 `music`。其中一个正在播放时，页面显示那一个。 |

也可以在 `~/.config/archetype/config.json` 中设置：`"plugins": { "music": { "player": "spotify" } }`。

## 关闭

在“管理 → 插件”中关闭，或设置 `"plugins": { "music": false }`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.