功能介绍
概述
SCO CLI 是 SenseCore 的统一命令行工具，用于初始化访问凭据、管理本地配置、切换 Region 和可用区，以及使用当前 Region 提供的云资源能力。
SCO CLI 同时支持单 Region 和多 Region 使用场景。多 Region 用户只需安装和维护一套 SCO CLI，即可在已安装且当前访问凭据有权访问的 Region 之间切换，无需为不同 Region 分别维护命令行工具。单 Region 用户只需在初始化时选择默认 Region，即可使用 SCO CLI。
SCO CLI 的子产品命令分为内置命令和可独立安装的组件命令。部分子产品命令（例如 SRM 和 IAM）随 SCO CLI 提供，无需单独安装，也不受 sco components 管理。运行 sco --help 可以查看当前 Region 可直接使用的命令；在支持组件管理的 Region 中，运行 sco components list 可以查看可独立安装的组件。部分 Region 不提供组件管理能力，其支持的子产品命令均随 SCO CLI 提供。
核心命令入口如下：
安装
SCO CLI 提供 Linux、macOS 和 Windows 安装方式。
Linux 或 macOS 执行以下命令：
curl -sSfL https://sco.sensecore.cn/registry/install.sh | bash && export PATH="${SCO_HOME:-$HOME/.sco}/bin:$PATH"
该安装命令会写入以下本地目录：
| 用途 | 默认路径 | 自定义环境变量 |
|---|---|---|
| SCO 命令入口、运行文件和状态 | ~/.sco | SCO_HOME |
| 产品目录、Region 配置和组件清单 | ~/.local/share/sco | SCO_DATA_HOME |
Windows PowerShell 执行以下命令：
$ErrorActionPreference='Stop'; $installer=(Invoke-WebRequest 'https://sco.sensecore.cn/registry/install.ps1' -UseBasicParsing).Content; & ([scriptblock]::Create($installer)); $SCOBin=if($Env:SCO_HOME){Join-Path $Env:SCO_HOME 'bin'}elseif($Env:HOME){Join-Path $Env:HOME '.sco\bin'}else{Join-Path $Env:USERPROFILE '.sco\bin'}; if(($Env:Path -split [regex]::Escape([IO.Path]::PathSeparator)) -notcontains $SCOBin){$Env:Path += [IO.Path]::PathSeparator + $SCOBin}
该安装命令会写入以下本地目录：
| 用途 | 默认路径 | 自定义环境变量 |
|---|---|---|
| SCO 命令入口、运行文件和状态 | 优先使用 $Env:HOME\.sco，否则使用 $Env:USERPROFILE\.sco | SCO_HOME |
| 产品目录、Region 配置和组件清单 | 优先使用 $Env:HOME\.local\share\sco，否则使用 $Env:USERPROFILE\.local\share\sco | SCO_DATA_HOME |
安装完成后，可以执行以下命令确认 sco 可用：
sco version
如果当前终端无法识别 sco 命令，请确认 SCO_HOME 下的 bin 目录已加入 PATH。
可选：如需启用 Tab 命令补全，请先查看当前 Shell 的配置说明：
请根据当前 Shell 选择其中一条命令：
sco completion bash --help
sco completion zsh --help
sco completion fish --help
sco completion powershell --help
该命令只生成补全脚本，不会自动修改 Shell 配置。完整配置方法请参考 命令补全。
如果 PowerShell 阻止脚本执行，请参考 Microsoft 文档 about_Execution_Policies。
初始化
首次使用前，请运行：
sco init
交互式初始化会引导配置 profile、AccessKey、语言、Region 和可用区，并在保存后自动运行诊断检查。非交互初始化和参数说明请参考 初始化。
profile 和本地配置默认写入 ~/.config/sco，可通过 SCO_CONFIG 自定义。
诊断
检查本地安装和配置状态：
sco doctor
输出 JSON 格式诊断结果：
sco doctor --json
查看版本信息：
sco version
更新
检查并按提示更新 SCO CLI：
sco update
sco update 只更新 SCO CLI，不会更新独立安装的组件。更多说明请参考 更新 SCO CLI 和 组件管理。
卸载
预览卸载会删除的本地路径：
sco uninstall --dry-run
卸载 SCO CLI 并移除本地配置和数据：
sco uninstall --yes
更多卸载说明请参考 卸载。