CLI-Hub 使用指南

📦 CLI-Hub 是什么？

CLI-Hub 是 CLI-Anything 的官方包管理器，类似于 pip、npm、brew，专门用于浏览、安装、更新、卸载由社区构建的 CLI。

无需自己从源码构建，一行命令即可获得现成的 CLI！

🚀 安装 CLI-Hub

pip install cli-anything-hub

要求：Python 3.10+

验证安装：

cli-hub --version

📋 基础命令

浏览所有可用的 CLI

cli-hub list

输出示例：

📦 Available CLIs in Hub:
  - gimp          CLI for GIMP image editor
  - blender       CLI for Blender 3D creation
  - shotcut       CLI for Shotcut video editor
  - libreoffice   CLI for LibreOffice suite
  - obs           CLI for OBS Studio
  ...

搜索特定功能的 CLI

# 按名称搜索
cli-hub search gimp

# 按功能搜索
cli-hub search image
cli-hub search video
cli-hub search office

查看 CLI 详情

cli-hub info gimp

输出示例：

📦 CLI: gimp
Description: CLI for GIMP image editor
Version: 1.2.0
Author: HKUDS Community
Supports: Windows, macOS, Linux
Commands: 42
Last Updated: 2026-05-20

🔧 安装和使用 CLI

安装一个 CLI

cli-hub install gimp

这会自动：

从 CLI-Hub 注册表下载对应的 CLI harness
安装 Python 依赖
将 CLI 添加到 PATH

启动已安装的 CLI

cli-hub launch gimp

这会打开一个交互式 REPL，你可以直接输入命令操控 GIMP。

查看已安装的 CLI

cli-hub list --installed

更新一个 CLI

cli-hub update gimp

卸载一个 CLI

cli-hub uninstall gimp

🎯 实战示例

示例 1：用 GIMP CLI 批量处理图片

# 安装 GIMP CLI
cli-hub install gimp

# 启动 REPL
cli-hub launch gimp

# 在 REPL 中：
> project new --width 1920 --height 1080 -o batch.json
> layer add -n "Photo" --type image --path ./input/photo.jpg
> export file --path ./output/processed.png --format PNG
> exit

示例 2：用 Blender CLI 批量渲染

cli-hub install blender
cli-hub launch blender

> project open --path ./scene.blend
> render start --output ./frames/ --format PNG

🌐 CLI-Hub 注册表

CLI-Hub 的注册表托管在 GitHub： https://github.com/HKUDS/CLI-Anything/tree/main/registry

每个 CLI 在注册表中有：

skill.json：元数据（名称、描述、版本、支持平台）
README.md：使用说明
cli/：CLI harness 源码

🔒 安全说明

CLI-Hub 的注册表在每次 cli-hub update 时会进行哈希校验，防止缓存数据被篡改
所有 CLI 均为开源（Apache 2.0），源码可在 GitHub 查看
仅安装你信任的 CLI

📚 下一步

💡 提示：如果你自己为一个新软件生成了 CLI，可以通过提交 PR 到注册表，让全社区都能使用你的 CLI！