# Inspire

> Use for Inspire/启智平台 (qz.sii.edu.cn) through the inspire CLI: install/update/uninstall, accounts, local SII proxy setup, INSPIRE.md asset upkeep, workspace/project/resource/path selection, Notebook, GPU Job, HPC, Ray, Serving, TensorBoard, Image, Model Registry, observation, cleanup, and Inspire CLI Browser API maintenance. Use CLI Help for syntax and load only the focused reference.

- Skill: `realzillionx/inspire` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add realzillionx/inspire`
- Raw SKILL.md: https://api.skillmd.com/api/skills/realzillionx/inspire/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: realZillionX (https://skillmd.com/u/realzillionx)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/realzillionx/inspire

---


# 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`](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`](references/internal-sources.md)。

## 持久资产上下文

CLI 不读写仓库级 `./.inspire/`，不把仓库绑定到某个 Project，也不假设一个仓库只在一个 Project 中运行。每次操作根据当前任务显式选择 Project / Workspace / 路径 / Image。

`INSPIRE.md` 仍可作为人类可读的可选资产合同：只在仓库存在需要跨 Agent、成员和会话复用的稳定远端路径、镜像、模型、数据版本或永久基础设施时维护；每项资产自带明确 Project / Workspace 适用范围，可同时覆盖多个 Project。账号凭据、实时状态、日志和短期计划不进入该文件。见 [`references/assets.md`](references/assets.md)。

## 最短执行闭环

1. 如果存在 `INSPIRE.md`，先读取其中与当前 Project / Workspace 相关的稳定资产合同；不存在时直接从 Live 事实开始。
2. 根据用户目标加载一份最匹配的 Reference；跨边界时再加载第二份。
3. 用 CLI Help 确认当前版本的真实命令表面。
4. 用 Live 查询确认账号、Workspace、Project、Compute Group、Quota、Image 和资源可用性。
5. 准备共享路径、代码和环境；复杂条件先 `dry-run` 或运行短 Probe。
6. 提交匹配的 Workload。
7. 按当前 Workload 的 Help 依次观察可用的 Events、Logs、Metrics、Instances 和 Status。
8. 核验业务健康与产物完整性；本次产生的持久资产写回 `INSPIRE.md`。
9. 运行中的对象先 `stop`，再 `delete`；终态且不再需要的对象直接 `delete`，仍有当前或声明的未来消费者时保留。

## 按需加载索引

命令语法和参数始终回到 CLI Help。每次先加载最匹配的一份 Reference：

### 平台操作

| 用户问题或判断点 | 先加载 |
| --- | --- |
| 安装、更新、卸载、账号、多账号切换、账号初始化 | [`references/setup/install-and-config.md`](references/setup/install-and-config.md) |
| 本机是 Windows（PowerShell、`install.ps1`、系统 OpenSSH、私钥 ACL） | [`references/setup/windows-native.md`](references/setup/windows-native.md) |
| 本机 Clash Verge 的 `*.sii.edu.cn`、`SII Proxy` / `DIRECT` 分流 | [`references/setup/sii-proxy.md`](references/setup/sii-proxy.md) |
| `INSPIRE.md`、稳定资产身份与生命周期 | [`references/assets.md`](references/assets.md) |
| Workspace、Compute Group、Quota、实时资源和优先级 | [`references/resources.md`](references/resources.md) |
| 项目归属、负责人、预算与平台优先级（`inspire project`，全局对象、不按 Workspace 划分） | [`references/assets.md`](references/assets.md) |
| 共享盘、存储池、挂载隔离和绝对路径 | [`references/paths.md`](references/paths.md) |
| 数据广场检索、官方数据集挂载、版本与访问权限 | [`references/dataset.md`](references/dataset.md) |
| 联网准备、SII 内部源、依赖安装、镜像固化 | [`references/internal-sources.md`](references/internal-sources.md) |
| Notebook 创建、按账号连接、`exec` / `shell` / `scp`、IDE URL、文件流转 | [`references/notebook.md`](references/notebook.md) |
| GPU Job、CPU HPC、Ray、Serving、TensorBoard，及提交后的观察、优先级与异常 | [`references/compute-workloads.md`](references/compute-workloads.md) |
| CPU 准备、数据处理、GPU 训练、部署或交付的阶段化计划 | [`references/workflows.md`](references/workflows.md) |
| Image 选择、保存、注册、可见性和清理 | [`references/image.md`](references/image.md) |
| Serving Endpoint、`INF_API_KEY`、API Key 管理与请求亲和性 | [`references/compute-workloads.md`](references/compute-workloads.md) |
| Model Registry、Model Version 与 Serving 的关系 | [`references/model.md`](references/model.md) |

### CLI 开发

仅在维护 CLI Browser API 封装、核对前端请求合同，或用户明确要求接口细节时加载：

| 需要什么 | 加载 |
| --- | --- |
| 请求契约、响应信封、认证与 Session、分页、Workspace scoping、错误码、探针方法、变更验收；当前 CLI 使用的 Action 请求体 / 响应 / 参数语义 / CLI 映射 / 限制；创建面字段合同；数据广场（`aip.sii.edu.cn`）的握手、信封与目录端点 | [`references/dev/browser-api.md`](references/dev/browser-api.md) |