管理 Shell 预设

Shell 预设把脚本安装到 Shine 的受管目录，并在 ~/.shine/bin/ 创建可直接调用的命令入口。Shine 当前支持 Bash、Zsh 和 PowerShell 的 profile 与命令目录管理；原生命令入口使用 .sh 或 .ps1，Bun 可作为另一种跨平台命令运行时。

内置类别、平台限制、当前会话命令和所需环境变量见内置预设。

查看与安装

shine shell list
shine shell install proxy
shine shell install utils/shine-env-export # 只安装这一个命令
shine shell install            # 安装当前平台可用的全部类别

也可以使用自动识别 shell 或 app 类别的简写：

shine install proxy
shine install shell/utils/shine-env-export

类别 target 会启用当前平台可用的全部命令；只需要其中一个命令时，使用明确的 category/command target。修改型命令不接受裸命令名，因为不同类别可能出现同名命令。

安装后需打开新终端或重新加载 shell profile。需要补全时运行：

shine completions install

修复安装

当受管脚本、命令入口或 PATH 片段需要按当前预设重建时：

shine shell install proxy --replace-managed
shine install shell/proxy --replace-managed

--replace-managed 会覆盖 Shine 管理的对应内容。先用 shine info shell/proxy --diff 检查状态，避免把有意的本地修改当作损坏处理。

卸载

shine shell uninstall proxy --dry-run
shine shell uninstall proxy
shine shell uninstall utils/shine-env-export
shine shell uninstall proxy --purge

按命令卸载会保留同类别下其他已安装命令；只要兄弟命令仍需要，共享 preset 或 snapshot 文件 就可能继续保留。--purge 会额外删除空的受管预设目录；未指定 target 时会处理整棵 shell 预设目录。它不会删除 ~/.shine/config.toml。

内置常用命令

类别	命令	用途
image-tools	img-compress、img-resize、img-convert	使用 Bun 1.3.14 或更高版本批量处理 JPEG、PNG、WebP
proxy	setproxy、usetproxy	设置或清除当前终端会话的代理变量
utils	copyfile	通过 OSC52 将文件内容复制到本地剪贴板
utils	shine-env-export	将 Shine env 值载入当前 shell
utils	shine-theme-sync	输出当前终端明暗主题的 shell export 语句
agent	ccenv	选择 Codex、DeepSeek 或 Qwen provider，并在隔离的子进程环境中启动 Claude Code；需要 Bun

某些类别按平台提供不同脚本；shine shell list 只显示当前平台可用的条目。

ccenv 默认通过本机 http://127.0.0.1:8317 的 CLIProxyAPI 使用 Codex，也可交互选择 DeepSeek 或 Qwen。相应凭据使用 CLIPROXYAPI_AUTH_TOKEN、DEEPSEEK_API_KEY 或 QWEN_API_KEY；加密值使用同名的 _SECRET 后缀，旧版 _GPG_SECRET 仍可读取。所选 provider 的变量只传给启动的 Claude 进程，不会修改当前终端。Claude 参数会原样转发；若首个参数与 ccenv 的 --run 兼容参数冲突，先写 --：

ccenv --print "hello"
ccenv -- --run

想用 Bun 编写跨平台命令预设？请参阅可选运行时的 Shell 入口。