升级与迁移
升级前运行 shine --version 确认当前版本，并阅读所有适用于来源版本和所用功能的事项。
管理 Shell 预设
Shell 预设把常用脚本安装为可以直接调用的命令，支持 Bash、Zsh 和 PowerShell。
从 Shine 1.x 升级
本页说明如何从既有 1.x 安装升级到 Shine 2.10。请先阅读下列操作确认与恢复变化，
管理应用配置
应用预设将配置安装到应用需要的位置。替换已有的非受管配置文件前，会先创建 *.shine.bak 备份。
初始化与管理系统
使用系统预设，可以在 macOS、Ubuntu 或 Windows 上安装选定的开发工具，并启用相应的 Shell
自定义预设
少量个性化优先使用 overlay；需要完全维护一套预设时，再使用外部 presets_dir。
将系统预设迁移到 v2
本页面向维护 v1 自定义系统预设 的用户。如果你只使用 Shine 2 内置的系统预设，无需手动迁移，请直接阅读初始化与管理系统。
管理环境变量与密钥
Shine 可以保存预设模板变量，也可以使用 GPG 或 age 封存项目环境中的敏感值。封存后的
SSH 会话：密钥代理与文件传输
shine ssh 会打开一个普通 SSH 会话，可在会话中转发选定环境变量、让远端命令按需请求
任务与应用构建产物
本页说明如何保存个人快捷命令，以及运行 app 的 artifact 脚本。
在 AI Agent 参与开发时保护环境密钥
Claude Code、Codex 等 AI Agent 参与开发后，密钥安全不再只是“不要提交 .env”这么简单。Agent 可能能读取工作区文件、运行命令、查看命令输出；如果把长期有效的明文 secret 放在项目里，它们很容易被复制到日志、补丁、上下文或远端服务中。
同步终端主题
在 macOS 或 Ubuntu 的受管 shell profile 中，Shine 可以自动判断终端背景是浅色还是深色，并导出 SHINETERMINALTHEME=light|dark。同时会为未自行设置的 BAT_THEME 选择 GitHub（浅色）或 OneHalfDark（深色）。