让 AI Agent 直接在本地 CLI 里完成启智平台的全部操作。

---

本项目建立的意义

在本项目开始筹办之初，对于所有 SII 的学生，启智平台是科研实验链路里最慢的那一环：每次申请资源、新建 Notebook、新建训练任务、同步代码都要反复点点点，SSH 等更进一步的功能更是遥遥无期。

本着过渡到大 Agent 时代、将一切重复性机械工作交给 Agent 的初衷，我们创办了 InspireSkill 项目，旨在将启智平台 GUI 打平为 CLI，并建立了 CLI + Skill 的一体化系统，让 InspireSkill 成为所有 Agent 开箱即用的工具、让你的 Claude Code / Codex / Antigravity / Cursor / OpenClaw / OpenCode / Qoder CLI / Qoder Work / Kimi Code / Kimi Desktop 成为进行科研工作的唯一入口。

建立和维护本项目的过程并非易事，InspireSkill 也并非只是将启智平台的网页 API 打平重构为 CLI 的简单工作，在维护本项目的过程中，设计高于平台语义的高层功能、寻找启智平台中细枝末节的 API 并将其优雅融入 CLI 系统中、尤其是维护一个易于 Agent 阅读且包含平台所有特性的文档系统都给我们带来了不小于 CLI 本身的麻烦。

在长时间的开发与维护中，以 @realZillionX 和 @JingYiJun 为首的开发团队始终秉持着注重细节与优雅的开发者精神，最终构建出一个令人满意的项目。时至今日，我们可以自豪地说：InspireSkill 所包含的功能，只有你想不到，没有我们做不到。它们包括但不限于：对 HDD/SSD/QB-ILM 等项目路径的优雅维护、翻转镜像的可见范围、将平台内部源入口交给 Agent（从而使在不可上网区配置镜像成为可能）、联网 Notebook 的 SSH 板块、受限 Notebook 的 JupyterTerminal 执行路径、空闲 8 卡整节点总量的查询、低优任务占用总量的查询、将 Notebook / 训练任务的资源视图 / 事件 / 聚合日志交给 Agent。

对初次使用者的简单介绍

InspireSkill 将算力平台的一切入口交给 AI Agent。当 Claude Code / Codex / Antigravity / Cursor / OpenClaw / OpenCode / Qoder CLI / Qoder Work / Kimi Code / Kimi Desktop 识别到本项目所提供的 SKILL.md，它会：

• 直接调用 inspire 命令查实时资源、开 Notebook、提 HPC 任务、拉日志
• 提供可选的 Clash Verge Mixed Port 分流模板，让公网与启智内网共存一套本地代理配置，取代多人共用断连的 aTrust；CLI 本身不绑定固定端口，任何能同时覆盖公网与 *.sii.edu.cn 的代理方案都行
• 把平台网页上的常用操作都变成可复现、可串联、可自动化的命令链
• 从 SKILL.md 按需加载对应使用手册，理解调度语义、资源申请原则和验收点，不需要用户在对话里反复向 Agent 解释平台语义

为什么比 InspireCode / 在实例里装 Agent 更好？

启智官方的 InspireCode 是把 OpenCode 直接部署到某个 Inspire 实例里——要用就得打开 qz.sii.edu.cn、进那个实例、在它的终端里跟 OpenCode 对话。凡是“把 Agent 装在服务器上”的方案都是这个路数。InspireSkill 走相反路径：Agent 留在本机，Inspire 降格为被调用的工具。

一句话：InspireCode 把 Agent 搬进 Inspire，InspireSkill 把 Inspire 变成 Agent 的一把工具。

---

为什么比社区里其它启智 CLI 更值得用？

启智社区还有两条独立维护的 CLI：EmbodiedForge/Inspire-cli 和 tianyilt/qzcli_tool。它们都解决了部分网页操作自动化问题，尤其 qzcli_tool 已经覆盖资源查询、GPU Job 提交、HPC Submit、Logs、Dashboard 和 Jupyter Exec，也提供 qzcli-mcp 给 MCP-Capable Harness 使用。

InspireSkill 的定位更往前走了一层：它不是把若干 API 包成命令，而是把启智平台整理成一套 Agent 能长期使用的操作模型。安装、命令面、SKILL.md、references/、项目 INSPIRE.md、Path Alias、Workload Profile、观测和清理闭环都在同一套设计里。

一句话：这两条 CLI 各做了一段路；InspireSkill 把整个平台的操作面、文档面和观测面端到端铺平，让 Agent 不只是“能调用命令”，而是能理解应该怎么用启智平台。

---

快速上手

平台支持：MacOS + Linux 一等公民。Windows 用户请用 WSL2——CLI 依赖 SSH / rsync / GPFS 目录约定 / POSIX 文件权限，Windows 原生不在 Roadmap。

安装

前置：bash / curl / tar / Python 3.10+ / 已装 uv（推荐）或 pipx 任一。

curl -LsSf https://astral.sh/uv/install.sh | sh
curl -fsSL https://raw.githubusercontent.com/realZillionX/InspireSkill/main/scripts/install.sh | bash

安装、可选参数和安装后检查见 references/setup/install-and-config.md。

更新

inspire update                # CLI 包 + SKILL.md / references/ 一起升到最新
inspire update --check        # 只检查，不动
inspire update --cli-only     # 仅升 CLI 包与运行时
inspire update --skill-only   # 仅刷 SKILL.md / references/

升级旧版本和 Installer 检测说明见 references/setup/install-and-config.md。 成功升级 CLI 后，inspire update 会显示旧版本到新版本之间的 GitHub Release 更新摘要。

完整初始化（安装后必跑）

inspire account add 
inspire config show --compact
inspire init
cd /path/to/your-repo
inspire init --scope project
inspire resources availability --workspace all --include-cpu

inspire init 默认做账号级全局发现，写入平台 Catalog 和默认 Path Alias；--scope project 用于当前仓库的 Project Context 和 Path Alias 覆盖。

账号级 / 项目级配置分层、多账号和代理 Setup 见 references/setup/install-and-config.md。

---

能力一览

---

支持的 Agent Harness

不同 Harness 的后台唤醒、Skills 实现和 MCP 能力会有差异；InspireSkill 的安装器负责把同一套 SKILL.md / references/ 放到各自约定目录，用户继续使用自己习惯的 Agent 入口。

---

自定义 SKILL.md / INSPIRE.md

SKILL.md 装完是一份通用 Playbook。日常 Workspace 基本就是 CPU资源空间 和 分布式训练空间；资源条件不要写成隐式默认值，把 workspace、project、group、quota 和 image 组合成 Workload Profile，并在 inspire notebook/job/hpc/... create --profile 或 Batch 文件里显式使用。

项目仓库维护根目录 INSPIRE.md，记录该项目的人类可读启智上下文；具体字段和边界以 SKILL.md 为准。INSPIRE.md 属于当前 Repo，不会被 inspire update 覆写。

需要定制 Harness 级入口时，直接编辑 ~/.claude/skills/inspire/SKILL.md 和同目录 references/（Codex / Antigravity / Cursor / OpenClaw / OpenCode / Qoder CLI / Qoder Work / Kimi Code / Kimi Desktop 同理）。inspire update 默认会覆盖 SKILL.md 和 references/；维护本地改动后用 inspire update --cli-only 只升级 CLI 与运行时。

---

🔧 维护承诺

启智平台的调度语义、资源组划分、镜像可用性会频繁变化。InspireSkill 的维护目标是让 CLI 和使用手册始终贴近平台真实行为。

维护者 @realZillionX 会高频率、持续跟进上游变更。每次发版后，任意 inspire 都会在 stderr 提醒一行，跑 inspire update 即升（用法见上面更新段）。

发现新的平台行为差异时，在 Issue Tracker 开一条，附 inspire --debug 的 Trace（CLI 会自动脱敏敏感登录凭据和代理信息）。反馈流程的更多细节见下方“开发与贡献”一节。

---

代理配置

不常驻 SII 的科研人员通常需要让本机代理转发 *.sii.edu.cn 流量；能直连 SII 校园网的人可以走 DIRECT。Clash Verge Mixed Port 的 SII Proxy / DIRECT 分流模板见 references/setup/install-and-config.md；CLI 本身不绑定固定端口。代理地址通过 inspire account add 写入账号配置，并可用 inspire config show --compact 核对。

凭据（Host / User / Password）从实验室或组织管理员获取，不要提交到任何公开仓库或聊天记录。

---

开发与贡献

项目由 @realZillionX 维护，节奏与启智平台的行为 / 调度语义紧密绑定。为了让上游变更能被最快、最一致地消化进 CLI、SKILL.md 和 references/，贡献入口按变更风险分层：

• 欢迎小而清楚的 PR。文档修正、使用手册补丁、平台行为变化修复、可复现的小型 CLI Bugfix 都可以直接提 PR；长期协作者（如 @JingYiJun）持续跟进平台变化，相关 PR 通过基础验证和 Review 后可按快速通道合入。
• 大范围语义调整先提 Issue。平台语义变化快，涉及 Workflow 重写、配置边界、调度策略或多命令联动的改动，先用 Issue 描述问题场景，附上 inspire --debug 的日志最好（CLI 会自动脱敏敏感登录凭据和代理信息）。维护者会评估后纳入后续版本，通常几天内发新版。
• 新的平台行为差异同样走 Issue；不用自己附敏感本地文件，维护者会用仓库内的开发工具复现。

这么安排的权衡：这个 Skill 的价值在于与上游保持零漂移的同步。Issue 是最高效的问题信号，PR 是可落地 Patch 的通道；能小步合并的就小步合并，需要统一调度的就先收敛语义再动手。

---

文档索引

• SKILL.md — 日常使用入口：CLI Help 查询方式、按需加载索引和项目上下文字段。
• references/setup/install-and-config.md — 安装、更新、账号初始化、项目初始化和 SII Proxy Setup。
• references/dev/browser-api.md — CLI 维护参考：网页会话接口和当前前端请求合约。
• references/resources-and-paths.md — Workspace、Compute Group、规格三元组、实时资源和 Workload Profile 边界。
• references/network-and-sources.md — 公网、离线 GPU 空间、SII 内部源和镜像固化策略。
• references/paths.md — 共享盘作用域、存储池、挂载隔离、Path Alias 和远端路径边界。
• references/notebook.md — Notebook 作为交互工作台、连接方式、文件流转、Proxy、安全和观察边界。
• references/image-management.md — 镜像职责、保存 / 注册边界、可见性和清理原则。
• references/compute-workloads.md — GPU Job、CPU HPC、Ray、Serving 的适用边界、调度语义和观察闭环。
• references/workflows.md — CPU 准备、数据处理、分布式训练三阶段项目流程。
• references/model.md — Model Registry 与 Serving 的职责边界、注册限制和版本判断。
• cli/ — CLI 源码；入口 cli/inspire/cli/main.py。
• scripts/install.sh — Curl Pipe Bash 安装器。

---

License

LICENSE（MIT）

Acknowledgements

• 启智平台团队提供的公开资料与协助。
• EmbodiedForge/Inspire-cli 提供了 CLI 的初步框架。

Made for researchers who’d rather think than click.