realZillionX Inspire Skill
inspire 是启智平台的本地 CLI。命令组、子命令、参数、默认值和示例以 inspire --help、inspire <group> --help 和 inspire <group> <subcommand> --help 为准；本文件只保留平台判断、项目上下文约定、最短执行闭环和 Reference 路由。
核心操作模型
inspire account use <name> 设置持久默认账号；所有命令的 --account <name> 仅覆盖本次命令。账号使用本地 Alias。命令开始后固定账号，不受其他进程切换默认账号影响；不传参数只使用默认账号。切账号保留各账号的 Session、SSH Connection 和资源缓存，需要清理时使用相应的显式缓存管理命令。
执行前先把任务拆成四个平面：
| 平面 | 绑定内容 |
|---|---|
| 调度条件 | workspace、project、group、quota、GPU / CPU / 内存 / Shared Memory 和 image，决定任务在哪里、以什么规格运行。 |
| 远端文件 | 代码、数据、权重、Checkpoint 和产物的共享盘绝对路径。可在 shell 里用环境变量缩写；CLI 不维护路径 Alias。数据广场的官方数据集由创建时的 --dataset 只读挂载。 |
| 工作负载 | 交互调试用 Notebook；固定 GPU 后台任务用 Job；CPU Slurm 批处理用 HPC；弹性 Worker、常驻或流式任务用 Ray；模型 HTTP 服务用 Serving。 |
| 观察收尾 | Events 看调度，Logs 看程序（Job / HPC / Ray / Serving 都有，Notebook 用 exec / shell 读），Metrics / Instances 看实际工作单元，Status 看平台状态和落点；读完还要进实例里看的时候 shell 在 Job / HPC / Ray / Serving 下都有，默认进哪个实例按 Workload 定；训练曲线本身用 TensorBoard（inspire tensorboard）读。最后核验业务健康和产物，再清理资源。 |
创建 Workload 时每次显式传入 workspace、project、group、quota 和 image；这些调度字段没有隐式默认值，CLI 也不保存 Workload Profile。选择资源时从同一条 Live Quota Row 复制完整 group 和 quota，并用 Live 镜像目录选当前需要的 image。GPU Job Shared Memory 不能超过所选 Quota 的实例内存；细节见 references/compute-workloads.md。
Live 查询是账号、Workspace、Project、Compute Group、Quota、Image 和资源可用性的事实源；本地缓存只是加速层，可用 inspire cache status|refresh|clear 管理，三条命令都接受 --resource <kind> 只针对一类，不能当作资源事实；refresh 不接受裸形式，必须用 --resource / --workspace / --name 说明刷哪一块，而且正常情况下不需要跑它。CLI 对 Agent 的稳定资源身份只有 Name 和 Alias；同名对象用 Workspace、可读候选和 --pick 消歧。
通用文档只记录平台合同、当前 CLI 行为和长期有效的判断规则。某个账号可见的专属 Workspace / Registry 名称、当次目录数量、即时配额与价格、资源 ID、临时探针结果和待补验结论都不进入通用文档；这些事实随账号和时间变化，使用时从 Live 命令读取。受控验证只保留能够复现且直接约束实现的结论，不保留实验现场或过程统计。
受限 H100/H200 Notebook 的 JupyterTerminal exec 不支持本地 stdin，远端命令的默认 stdin 是 /dev/null。Agent 不得对它使用 --stdin / --bash-stdin，也不得从本地用管道或 < file 向 inspire notebook exec 喂输入；尚未确认 Transport 时同样不要先试。CLI 会在 Transport 预检后、发送用户命令前拒绝这些组合。需要脚本或输入文件时，先把它放到 /inspire/...，再让远端命令用显式重定向或路径读取；需要人工交互时使用带 TTY 的 inspire notebook shell，不要把 shell 当作脚本输入通道。SSH Notebook 的 exec --stdin 不受此限制。
发现类列表和 Batch 结果默认最多展示 20 项，用命令自身的 --limit/-n 收窄或 --all 显式展开；Job 日志默认有行数和字符预算，截断时会给出已展示数量和继续获取完整结果的选项。需要结构化输出时使用根级 inspire --json ...，输出始终是单一 JSON 文档。
Workspace 判断：
CPU资源空间和分布式训练空间是所有用户默认可用的公共 Workspace：前者承担 CPU Notebook、联网准备、依赖安装、HPC 数据处理和 CPU Ray；后者承担 GPU Notebook、GPU Job、多节点训练、Serving 和 GPU 观察。- 其余 Workspace（项目专属空间、国产卡分区等）必须由用户亲自指认；不要因为列表可见就自行启用。
分布式训练空间通常没有公网：公网内容先在CPU资源空间准备，写入共享盘或固化成镜像，再供 GPU Workload 使用；判断细节见references/internal-sources.md。
持久资产上下文
CLI 不读写仓库级 ./.inspire/，不把仓库绑定到某个 Project，也不假设一个仓库只在一个 Project 中运行。每次操作根据当前任务显式选择 Project / Workspace / 路径 / Image。
INSPIRE.md 仍可作为人类可读的可选资产合同：只在仓库存在需要跨 Agent、成员和会话复用的稳定远端路径、镜像、模型、数据版本或永久基础设施时维护；每项资产自带明确 Project / Workspace 适用范围，可同时覆盖多个 Project。账号凭据、实时状态、日志和短期计划不进入该文件。见 references/assets.md。
最短执行闭环
- 如果存在
INSPIRE.md，先读取其中与当前 Project / Workspace 相关的稳定资产合同；不存在时直接从 Live 事实开始。 - 根据用户目标加载一份最匹配的 Reference；跨边界时再加载第二份。
- 用 CLI Help 确认当前版本的真实命令表面。
- 用 Live 查询确认账号、Workspace、Project、Compute Group、Quota、Image 和资源可用性。
- 准备共享路径、代码和环境；复杂条件先
dry-run或运行短 Probe。 - 提交匹配的 Workload。
- 按当前 Workload 的 Help 依次观察可用的 Events、Logs、Metrics、Instances 和 Status。
- 核验业务健康与产物完整性；本次产生的持久资产写回
INSPIRE.md。 - 运行中的对象先
stop，再delete；终态且不再需要的对象直接delete，仍有当前或声明的未来消费者时保留。
按需加载索引
命令语法和参数始终回到 CLI Help。每次先加载最匹配的一份 Reference：
平台操作
| 用户问题或判断点 | 先加载 |
|---|---|
| 安装、更新、卸载、账号、多账号切换、账号初始化 | references/setup/install-and-config.md |
本机是 Windows（PowerShell、install.ps1、系统 OpenSSH、私钥 ACL） |
references/setup/windows-native.md |
本机 Clash Verge 的 *.sii.edu.cn、SII Proxy / DIRECT 分流 |
references/setup/sii-proxy.md |
INSPIRE.md、稳定资产身份与生命周期 |
references/assets.md |
| Workspace、Compute Group、Quota、实时资源和优先级 | references/resources.md |
项目归属、负责人、预算与平台优先级（inspire project，全局对象、不按 Workspace 划分） |
references/assets.md |
| 共享盘、存储池、挂载隔离和绝对路径 | references/paths.md |
| 数据广场检索、官方数据集挂载、版本与访问权限 | references/dataset.md |
| 联网准备、SII 内部源、依赖安装、镜像固化 | references/internal-sources.md |
Notebook 创建、按账号连接、exec / shell / scp、IDE URL、文件流转 |
references/notebook.md |
| GPU Job、CPU HPC、Ray、Serving、TensorBoard，及提交后的观察、优先级与异常 | references/compute-workloads.md |
| CPU 准备、数据处理、GPU 训练、部署或交付的阶段化计划 | references/workflows.md |
| Image 选择、保存、注册、可见性和清理 | references/image.md |
Serving Endpoint、INF_API_KEY、API Key 管理与请求亲和性 |
references/compute-workloads.md |
| Model Registry、Model Version 与 Serving 的关系 | references/model.md |
CLI 开发
仅在维护 CLI Browser API 封装、核对前端请求合同，或用户明确要求接口细节时加载：
| 需要什么 | 加载 |
|---|---|
请求契约、响应信封、认证与 Session、分页、Workspace scoping、错误码、探针方法、变更验收；当前 CLI 使用的 Action 请求体 / 响应 / 参数语义 / CLI 映射 / 限制；创建面字段合同；数据广场（aip.sii.edu.cn）的握手、信封与目录端点 |
references/dev/browser-api.md |