让 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 任务、拉日志
• 全程只用 Name：参数、帮助、错误、人类输出和 JSON 输出都使用 Name、Account Alias、Path Alias 和可读状态，不需要 Agent 记忆或搬运平台内部 ID
• 提供可选的 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。

卸载

inspire uninstall                # skill 目录 + 更新检查 agent + CLI 包
inspire uninstall --purge        # 连 ~/.inspire 的账号配置一起删
inspire uninstall --purge-runtime # 连共享的 Playwright 浏览器缓存一起删

执行前会打印完整清单并要求确认。账号配置和浏览器缓存默认保留：前者重装后还能直接用，后者是本机所有 Playwright 工具共用的；仓库自己的 INSPIRE.md 和 ./.inspire/ 任何一档都不碰。CLI 已经跑不起来时，用安装脚本的 --uninstall 兜底，分层与参数见 references/setup/install-and-config.md。

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

inspire account add <name>
inspire account check
inspire init
cd /path/to/your-repo
inspire init --scope project
inspire resources availability --workspace 分布式训练空间 --include-cpu

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

安装、更新和多账号操作见 references/setup/install-and-config.md；项目初始化问询（Project / Workspace / Paths / Image）和 INSPIRE.md 维护见 references/project-context.md；Clash Verge 的 SII Proxy / DIRECT 分流模板见 references/setup/sii-proxy.md。

能力一览

支持的 Agent Harness

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

通用 Skill 与项目资产合同

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

INSPIRE.md 不是所有仓库必备的文件。只有某个具体科研或工程项目在启智上维护稳定拓扑、Canonical Remote Paths、永久基础设施或 Image / Model / Dataset / Checkpoint 等持久资产时，才在该项目工作区根维护 INSPIRE.md。CLI、Skill、文档和其它通用工具源码仓库不应为了“使用了启智”而创建它；初始化问询、字段与生命周期边界见 references/project-context.md。

需要定制 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 <subcommand> 都会在 stderr 提醒一行，跑 inspire update 即升（用法见上面更新段）。

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

代理配置

不常驻 SII 的科研人员通常需要让本机代理转发 *.sii.edu.cn 流量；能直连 SII 校园网的人可以走 DIRECT。Clash Verge Mixed Port 的 SII Proxy / DIRECT 分流模板和验证步骤见 references/setup/sii-proxy.md；账号级 proxy、Shell proxy 与 NO_PROXY 诊断见 references/setup/install-and-config.md。CLI 本身不绑定固定端口。

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

开发与贡献

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

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

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

文档索引

• SKILL.md：日常使用入口，包含平台不变量、项目上下文约定、最短执行闭环和按需加载索引。
• references/setup/install-and-config.md：安装、更新、账号配置、全局发现和多账号操作。
• references/setup/sii-proxy.md：Clash Verge 的 SII Proxy / DIRECT 分流模板和验证步骤。
• references/project-context.md：项目初始化问询（Project / Workspace / Paths / Image）、INSPIRE.md 资产合同和项目信息持续维护。
• references/resources.md：Workspace、Compute Group、规格三元组、实时资源和 Workload Profile 边界。
• references/paths.md：共享盘作用域、存储池、挂载隔离、Path Alias 和远端路径边界。
• references/dataset.md：数据广场检索、官方数据集的版本与访问权限、--dataset 只读挂载语义。
• references/internal-sources.md：联网准备动线、SII 内部源入口和镜像固化策略。
• references/notebook.md：Notebook 作为交互工作台、连接方式、文件流转、Proxy 和观察边界。
• references/compute-workloads.md：GPU Job、CPU HPC、Ray、Serving、TensorBoard 的适用边界、调度语义和观察闭环。
• references/workflows.md：CPU 准备、数据处理、分布式训练三阶段项目流程。
• references/image.md：镜像职责、保存 / 注册边界、可见性和清理原则。
• references/model.md：Model Registry 与 Serving 的职责边界、注册限制和版本判断。
• references/dev/browser-api.md：CLI 维护参考，覆盖请求契约、响应信封、认证与 Session、分页与 scoping、探针方法、仍在用的 v1 端点和变更验收。
• references/dev/browser-api-actions.md：CLI 维护参考，12 条路由 113 个 Action 的请求体、响应、参数语义、CLI 映射与限制。
• references/dev/data-plaza-api.md：CLI 维护参考，数据广场（aip.sii.edu.cn）的 CAS 握手、信封与目录端点。
• CONTRIBUTING.md：开发、测试和贡献约定。
• 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.}