管理 Shell 预设
Shell 预设把脚本安装到 Shine 的受管目录，并在 ~/.shine/bin/ 创建可直接调用的命令入口。Shine 当前支持 Bash、Zsh 和 PowerShell 的 profile 与命令目录管理；原生命令入口使用 .sh 或 .ps1，Bun 可作为另一种跨平台命令运行时。
从 Shine 1.x 升级
Shine 2.0 已是当前稳定版。它引入了更严格的生命周期安全与恢复边界；从既有 1.x 安装升级前，
管理应用配置
应用预设把配置文件安装到目标应用使用的位置，并通过 ~/.shine/app-manifest.toml 记录受管文件。安装前遇到已有的非受管文件时，Shine 会先创建 *.shine.bak 备份。
初始化与管理系统
系统预设为 macOS、Ubuntu 和 Windows 提供可选择的开发环境初始化步骤，以及少量可逆的受管系统
自定义预设
少量个性化优先使用 overlay；需要完全维护一套预设时，再使用外部 presets_dir。
将系统预设迁移到 v2
本页面向维护 v1 自定义系统预设 的用户。如果你只使用 Shine 2 内置的系统预设，无需手动迁移，请直接阅读初始化与管理系统。
管理环境变量与密钥
Shine 可以保存预设模板变量，也可以使用 GPG 或 age 封存项目环境中的敏感值。封存后的
SSH 会话：密钥代理与文件传输
shine ssh 会打开一个普通 SSH 会话，可在会话中转发选定环境变量、让远端命令按需请求
任务与本地服务
本页说明如何保存个人快捷命令，以及把 app 预设生成的资源通过本机 HTTP 地址提供给其它应用读取。
在 AI Agent 参与开发时保护环境密钥
Claude Code、Codex 等 AI Agent 参与开发后，密钥安全不再只是“不要提交 .env”这么简单。Agent 可能能读取工作区文件、运行命令、查看命令输出；如果把长期有效的明文 secret 放在项目里，它们很容易被复制到日志、补丁、上下文或远端服务中。
同步终端主题
在 macOS 或 Ubuntu 的受管 shell profile 中，Shine 可以自动判断终端背景是浅色还是深色，并导出 SHINETERMINALTHEME=light|dark。同时会为未自行设置的 BAT_THEME 选择 GitHub（浅色）或 OneHalfDark（深色）。