用途：litium-cloud CLI 是 Litium Serverless Cloud 的命令行前端，用于管理订阅（subscription）、环境（environment）与应用（app），也是上传制品的唯一途径。适用于创建环境、按 YAML 清单安装更新应用、打包部署代码制品、密钥、访问控制、备份、自定义域名及 CI/CD 流水线等任务。
主要能力：层级为订阅→环境→应用，制品与订阅级密钥位于订阅层。应用通过 apply 安装，没有 app install 或 app create 命令；清单为 YAML（kind / resource.id / spec），须从 marketplace manifest 模板起步。制品类型包括 dotnet、nextjs、nodejs、nuxtjs、sqlbackup、storage，代码制品可随时用 app deploy 部署，备份制品仅在安装时生效。密钥可设在订阅或环境，环境值优先。多数变更命令立即返回 job id 并退出 0，任务仍可能失败。访问控制由角色、主体、范围组成并向下继承。Portal（https://portal.litium.cloud）除上传制品外均可完成。
使用方式：需 .NET 8 SDK；添加 Litium NuGet 源：dotnet nuget add source https://nuget.litium.com/nuget/ -n Litium -u <docs-username> -p <docs-password>（macOS/Linux 加 --store-password-in-clear-text）；安装或更新：dotnet tool update -g litium.cloud.cli --no-cache；验证：litium-cloud --version；登录：litium-cloud auth login。工具位于 ~/.dotnet/tools 或 %USERPROFILE%.dotnet\tools，需加入 PATH。使用不确定的选项前先运行 litium-cloud <group> --help 与 litium-cloud <group> <command> --help。脚本化场景用 -o json，勿解析默认表格输出。
限制与注意：变更前用 litium-cloud context show 与 auth show 确认目标，并用 environment show 查看 Production: Yes|No。破坏性及生产变更需显式确认，勿随意加 --auto-yes；environment delete 无确认提示，会立即执行。密钥不得写入清单，应通过 subscription secret create 或 environment secret create 创建并用 valueFrom.secretRef 引用，优先用 --text-value / --binary-value。清单须从 litium-cloud marketplace manifest --app <app-type> -f <file>.yaml 生成，勿手写或臆造 apiVersion 等顶层键。每个任务需跟踪：litium-cloud status logs --job <job-id> --follow，再 litium-cloud status show --job <job-id> 检查 Details 是否有 failed。已知帮助文本错误：artifact-type list 实际路径为 litium-cloud artifact artifact-type list；app search 不存在，应使用 litium-cloud marketplace list --details。environment set-tier 与 --tier 需 CLI 2.11.0 及以上。未引用制品会在 14 天（从未使用）或 7 天（最后使用后）被删除。sql_backup_file 与 storage_backup_file 为仅创建时生效，恢复需卸载重装应用。应用启动时读取配置，新增密钥或配置后需 litium-cloud app restart --app <app-id> --wait。CI 中无浏览器时用 auth login --service-principal --username <service-principal-id> --certificate <path>，且服务主体不继承创建者权限，需显式授予角色。证书路径应使用绝对路径。公开文档位于 https://docs.litium.dev/<path>，追加 .md 可获取 Markdown。