这是一个用于配置 macOS 终端配色的开源指南，也提供一个可审查的 Bash 辅助工具。它支持 Terminal.app、iTerm2、Alacritty、Warp 和 Ghostty。项目独立维护，与 terminalcolors.com 无隶属、赞助或官方合作关系。
将下面提示词中的 <主题名称> 和 <终端工具> 替换为你的选择，然后复制整段内容并粘贴到支持操作本机文件和终端的 AI Agent 中：
请根据 https://terminalcolors.com/ 网站，将「<主题名称>」安装到我 Mac 上的「<终端工具>」中。请自动检查该工具的配置位置，下载正确格式的主题，备份现有配置后完成安装，并告诉我如何启用主题和恢复原配置。
以上主题仅用于展示不同配色风格，不代表排名或推荐。点击图片可在 terminalcolors.com 查看对应主题；在 GitHub 上使用 Command + 点击 可在新标签页中打开。
请在 terminalcolors.com 选择你喜欢的主题，再下载对应终端的本地文件。本仓库中的 Ayu Dark 只是用于演示五种格式的一个例子，不代表推荐或排行榜。
本项目处理的是终端的颜色方案：背景色、前景色和 ANSI 色板。它不会安装字体，不会配置 Starship、Oh My Zsh 等 shell 提示符，也不会改变 Vim、Neovim 或 VS Code 的编辑器主题。详见配色基础。
| 终端 | 主题格式 | 辅助工具的行为 |
|---|---|---|
| Terminal.app | .terminal plist |
用系统 open 导入，之后在界面中选择 |
| iTerm2 | .itermcolors plist |
用系统 open 导入，之后在界面中选择 |
| Alacritty | .toml |
复制主题并保守更新 TOML import |
| Warp | .yaml / .yml |
复制到 Warp 主题目录 |
| Ghostty | 无扩展名 | 复制主题并更新一个有效 theme = 设置 |
要求 macOS 和系统自带 Bash。先阅读计划，确认路径，再允许写入：
bash bin/terminal-theme doctor
bash bin/terminal-theme install themes/warp/ayu-dark.yaml --dry-run
bash bin/terminal-theme install themes/warp/ayu-dark.yaml --yes
bash bin/terminal-theme list-backups
bash bin/terminal-theme restore BACKUP_ID --yes不加 --yes 时工具会询问确认；没有交互输入时会取消。--dry-run 只显示来源、目标和配置计划，不写文件。工具只接受已下载的本地文件，不下载主题，也不执行网络脚本。
Terminal.app 和 iTerm2 的导入需要在应用设置中手动激活。它们的备份记录也只提供手动删除指引，不会直接修改应用偏好设置。配置文件型终端的每次成功写入都会留下可列出、可恢复的备份。
不要分享包含令牌、主机名或私人路径的完整配置。安全问题请按 SECURITY.md 私下报告。提交主题格式或文档改进前请阅读 CONTRIBUTING.md。本项目不接受没有来源和许可证信息的大批量主题目录。
MIT 许可证仅适用于本项目原创的代码和文档；第三方主题数据仍遵循上游条款，来源见 themes/README.md。