内置预设
Shine 内置以下预设，可直接使用，也可复制后修改。它们并不代表 Shine 只能支持表中的工具。Shell 与 App 预设管理声明的命令和配置；系统预设负责初始化选定的 开发工具，或管理少量可逆的系统资源。App 预设不会自动安装对应的桌面应用。执行前先查看详情与 预览，确认目标路径、备份和权限范围：
shine shell list
shine app list
shine app info ghostty
shine app install ghostty --dry-run
shine sys list --all
shine sys info split-dns
本文介绍当前开发版（Next）的内置预设。已安装版本的可用功能请以 shine list --available 和 --help 的输出为准。
下表列出各平台可用的内置预设。
| Preset capability | macOS | Linux | Windows |
|---|---|---|---|
app/JetBrains | ✓ | ✓ | ✓ |
app/archey4 | ✓ | ✓ | — |
app/clash-verge | ✓ | ✓ | ✓ |
app/docker-desktop | — | — | ✓ |
app/docker-engine | ✓ | ✓ | ✓ |
app/fastfetch | ✓ | ✓ | ✓ |
app/ghostty | ✓ | ✓ | — |
app/git | ✓ | ✓ | ✓ |
app/starship | ✓ | ✓ | ✓ |
app/surge | ✓ | — | — |
app/vim | ✓ | ✓ | ✓ |
shell/agent/ccenv | ✓ | ✓ | ✓ |
shell/image-tools/img-compress | ✓ | ✓ | ✓ |
shell/image-tools/img-convert | ✓ | ✓ | ✓ |
shell/image-tools/img-resize | ✓ | ✓ | ✓ |
shell/proxy/setproxy | ✓ | ✓ | ✓ |
shell/proxy/usetproxy | ✓ | ✓ | ✓ |
shell/utils/copyfile | ✓ | ✓ | — |
shell/utils/shine-env-export | ✓ | ✓ | ✓ |
shell/utils/shine-theme-sync | ✓ | ✓ | ✓ |
Shell 预设
安装 Shell 类别后，打开新的 Bash、Zsh 或 PowerShell，即可按下表的名称调用命令。 需要修改当前会话的命令也应这样调用，不要直接运行预设目录中的脚本文件。
| 类别 | 命令 | 用途与前提 |
|---|---|---|
agent | ccenv | 通过 Bun 在 macOS、Linux 或 Windows 选择 Codex（默认）、DeepSeek 或 Qwen，并启动 Claude Code。provider 变量只进入该子进程；需要已安装 bun、shine 和 Claude Code。 |
image-tools | img-compress | 批量压缩直接传入的 JPEG、PNG、WebP 文件或目录第一层图片，生成派生文件。使用 IMAGE_QUALITY；需要 Bun 1.3.14 或更高版本。 |
image-tools | img-resize | 批量缩放图片，使其不放大并限制在 IMAGE_MAX_WIDTH × IMAGE_MAX_HEIGHT 内。需要 Bun 1.3.14 或更高版本。 |
image-tools | img-convert | 使用明确的 --format 把图片批量转换为 JPEG、PNG 或 WebP。需要 Bun 1.3.14 或更高版本。 |
proxy | setproxy | 为当前会话设置 HTTP/HTTPS/SOCKS5、npm 和 pnpm 代理。使用 HTTP_PROXY_PORT、SOCKS5_PROXY_PORT、PROXY_HOST、PROXY_NO_PROXY；auto 优先 SOCKS5。若安装了 Yarn，它会修改 Yarn 的持久代理配置。 |
proxy | usetproxy | 清除当前会话的代理变量，并清除 setproxy 写入的 Yarn 代理配置。 |
utils | copyfile | 通过 OSC52 把一个文件内容复制到本地剪贴板；仅 Unix，终端或终端复用器必须允许 OSC52。 |
utils | shine-env-export | 将一个 Shine env 值导入当前会话；可读取同名明文值，或解密 <KEY>_SECRET。 |
utils | shine-theme-sync | 为当前会话设置终端明暗主题对应的 SHINE_TERMINAL_THEME 与 BAT_THEME。 |
ccenv 的 Codex provider 通过本机 CLIProxyAPI 使用 CLIPROXYAPI_AUTH_TOKEN；DeepSeek 和 Qwen 分别使用对应的 *_API_KEY。凭据按 _SECRET、旧版 _GPG_SECRET、明文值的顺序解析；一旦选中的密文解密失败就会停止，不会回退。CLIProxyAPI 应只绑定回环地址，并配置与客户端相同的 token。
图片命令接受多个文件或目录第一层扫描，默认生成新文件而不修改输入，并支持 --output-dir 与各命令
自己的临时覆盖参数。完整说明见图片工作流。
更多安装、重装与卸载说明见管理 Shell 预设，环境变量格式见管理环境变量。
App 预设
大多数预设安装配置文件。Surge 和 Clash Verge Rev 还提供显式 artifact 命令，将这些文件接入 应用当前配置；请按各自指南完成设置。
| 类别 | 平台与目标 | 管理内容与注意事项 |
|---|---|---|
archey4 | Unix；~/.config/archey4/ | Archey4 系统信息配置。 |
clash-verge | macOS、Linux、Windows；merge 源位于 ~/.shine/clash-verge/，本地参考规则位于 CVR 用户数据目录 | Clash Verge Rev 的订阅增强示例。模式 1 使用受管 HomeDir 规则文件，HTTP/HTTPS 模式不会引用它们。构建与清理需要 Bun；实际订阅编辑器绑定与完整流程见应用配置指南。 |
docker-desktop | Windows；~/AppData/Roaming/Docker/settings-store.json | 仅修改 proxy 与 containersProxy 设置，完成后重启 Docker Desktop。 |
docker-engine | Unix：/etc/docker/daemon.json；Windows：~/.docker/daemon.json | Docker daemon 配置；Unix 目标需要管理员权限，完成后重启 Docker Engine。 |
fastfetch | ~/.config/fastfetch/ | Fastfetch 系统信息配置。 |
ghostty | Unix；~/.config/ghostty/ | Ghostty 主配置与内置明暗主题；主题背景可使用 GHOSTTY_BG_LIGHT、GHOSTTY_BG_DARK 模板变量。Ctrl + \ 向右新建分屏，Ctrl + - 向下新建分屏。Ctrl + H/J/K/L 分别切换到左/下/上/右分屏；解除 Super + [ / ] 的绑定（macOS 上为 Cmd）。无法切换分屏时，按键交给终端内的程序处理。 |
git | ~/.gitconfig | Git 常用别名和默认配置。安装前会按普通 app 预设规则备份不受管文件。 |
JetBrains | ~/.ideavimrc | JetBrains 的 IdeaVim 配置；需要已在 IDE 中启用 IdeaVim 插件。普通模式下，Ctrl + H/J/K/L 分别切换到左/下/上/右编辑器分屏，与 Ghostty 预设保持一致。 |
starship | ~/.config/starship.toml | Starship prompt 配置；需要另行安装并在 shell 中启用 Starship。 |
surge | macOS；~/Library/Application Support/Surge/Profiles/ | 本地代理、策略组、规则、General 设置模块，以及可选的 URI 订阅生成文件。Artifact apply/remove 需要 Bun，以及正在运行且 CLI 支持模块管理的 Surge；生成、刷新和 artifact 流程见应用配置指南。 |
vim | ~/.vim/ | Vim 基础配置和机器本地覆盖文件。 |
docker-desktop 的 JSON 合并保留其它 Docker Desktop 设置；所有其它 app 预设只管理其各自声明的文件。安装应用预设不会下载、安装或启动 Ghostty、Docker、Surge、Starship 等应用。
系统预设
使用 shine sys bootstrap 安装选定的开发工具，或通过 --preset 选择下表中的配置组合。
执行前先用 --dry-run 检查步骤和所需权限；完整操作见初始化与管理系统。
安装后会启用所选工具的 Shell 集成，之前启用的集成也会保留；如需关闭，使用
shine sys profile disable <ITEM>。Shine 不升级已安装的软件，请使用对应的包管理器或上游工具。
mise 项目只安装并启用 mise；工具配置和版本管理仍由 mise 自己负责。
| 平台 | Profile | 包含项目 |
|---|---|---|
| macOS | required | Homebrew、Yazi、Starship。 |
| macOS | recommended（默认） | required 加 Rust、Neovim、AstroNvim、ZeroTier、Zsh 插件、zoxide、Atuin、fzf、bat、eza。 |
| macOS | all | recommended 加 nvm、Bun、pnpm、mise、Fastfetch。 |
| Ubuntu | recommended（默认） | Rust、Neovim、AstroNvim、Atuin、Yazi、Starship、zoxide、zsh-vi-mode、fzf、bat、eza。 |
| Ubuntu | all | recommended 加 ZeroTier、Bun、pnpm、mise、Homebrew。 |
| Ubuntu | minimal | Neovim、fzf、bat、eza、zoxide；适合不需要 shell 历史、prompt 与 JavaScript 工具链的服务器。 |
| Windows | required | Rust、Yazi、Starship。 |
| Windows | recommended（默认） | required 加 Neovim、zoxide、Atuin、fzf、bat、eza、ZeroTier。 |
| Windows | all | recommended 加 Bun、pnpm、mise。 |
Ubuntu 安装说明
- Atuin： 安装后打开新的 Shell，运行
atuin import auto导入已有历史；需要同步历史时， 再运行atuin register或atuin login。 - Yazi： 从官方 stable APT 源安装软件及预览所需依赖，需要管理员权限，无需预先安装 Rust 或 Cargo。已有安装会被跳过，不会自动更换安装方式。
- pnpm： 无需预先安装 Node.js、npm 或 Corepack。安装目录为
~/.local/share/pnpm， Shine 会配置命令路径；安装后打开新的 Shell 即可使用。 - 最小服务器配置：
minimal仅包含上表所列工具，不含历史同步、提示符、Node.js 工具链或 Homebrew。安装前运行shine sys bootstrap --preset minimal --dry-run确认实际步骤。
Private split DNS
三个平台都内置独立的受管 split-dns 项目，不属于上述默认 profile。它把一个私有域名后缀定向到可经 ZeroTier 访问的 DNS 服务器；需要管理员权限和以下生效的 env 值：
PRIVATE_DNS_DOMAIN = "home.example.internal"
PRIVATE_DNS_SERVERS = "10.0.0.53"
先预览，再应用或移除：
shine sys info split-dns
shine sys apply split-dns --dry-run
shine sys apply split-dns
shine sys uninstall split-dns --dry-run
Ubuntu 上，split-dns 要求本机 DNS 查询经过 systemd-resolved 的 127.0.0.53。
如果 Shine 提示 DNS stub 被关闭，请先重新启用 DNSStubListener，或确认本机解析链路会经过
systemd-resolved，再应用配置。
它不会安装 ZeroTier、CoreDNS 或创建 DNS 区域；应先确保私有网络和 DNS 服务可用。完整的跨平台网络与排错步骤见使用 ZeroTier、CoreDNS 和 Shine 搭建异地私有域名网络。
系统初始化、受管项目和代理使用方式见初始化与管理系统。