# SkillHub CLI

SkillHub CLI 是给 OpenClaw 用户使用的命令行工具，用于登录 SkillHub、搜索 Skill、查看详情、下载 Skill 包，并将 Skill 导入到本机 OpenClaw。

## 首次使用

```bash
skillhub help
skillhub login
skillhub search ppt
skillhub info <slug>
skillhub install <slug>
```

如果还没有 SkillHub 账号：

```bash
skillhub register
```

CLI 会打开 SkillHub 注册页面。账号通过审核后，再执行：

```bash
skillhub login
```

## 常用命令

```bash
skillhub login                         登录 SkillHub 账号
skillhub register                      打开注册页面
skillhub whoami                        查看当前登录状态
skillhub search <keyword>              搜索已上架 Skill
skillhub info <slug>                   查看 Skill 详情
skillhub pull <slug> [--output <dir>]  下载 Skill 包
skillhub install <slug> [--output <dir>] 下载并导入 OpenClaw
skillhub logout                        清除本地登录状态
skillhub help                          查看帮助
```

## 安装

### Windows

1. 下载 `skillhub-cli-windows-x64.zip`。
2. 解压后将 `skillhub-win.exe` 放到长期保留的目录。
3. 在 PowerShell 中执行：

```powershell
.\skillhub-win.exe help
.\skillhub-win.exe login
.\skillhub-win.exe search ppt
.\skillhub-win.exe pull <slug>
.\skillhub-win.exe install <slug>
```

如果希望直接输入 `skillhub` 使用，可以把该目录加入 `PATH`，或将文件重命名为 `skillhub.exe`。

### macOS

```bash
curl -fsSL https://updates.celab.top/skillhub-cli/install-macos.sh | bash
```

安装后执行：

```bash
skillhub help
skillhub login
skillhub search ppt
skillhub install <slug>
```

## 登录与注册引导

- `search`、`info`、`pull`、`install` 都要求先登录。
- 未登录时，CLI 会提示用户执行 `skillhub login` 或 `skillhub register`。
- `skillhub register` 会打开 SkillHub 注册页面。
- `skillhub login` 成功后，会保存本地登录态，方便后续命令继续使用。
- `skillhub login` 输入密码时不会显示明文，也不会显示星号。
- 人工交互登录时，账号或密码输错最多可以重试 3 次。
- 如果账号尚未通过审核，CLI 会给出明确提示，用户需要等待管理员审核。

## 终端编码兼容

CLI 会自动判断当前终端是否适合显示中文：

- macOS 和 UTF-8 Linux 终端默认显示中文。
- Windows 如果当前代码页是 UTF-8，会显示中文。
- Windows 旧控制台或非 UTF-8 终端会自动降级为英文提示，避免中文乱码。

如果希望强制中文：

```powershell
$env:SKILLHUB_LANG="zh"
skillhub help
```

如果希望强制英文：

```powershell
$env:SKILLHUB_LANG="en"
skillhub help
```

Windows 用户如果希望长期显示中文，建议使用 Windows Terminal / PowerShell 7，或在当前终端执行：

```powershell
chcp 65001
```

## 下载与安装说明

- `pull` 会把 Skill 包下载到默认下载目录。
- `install` 会先下载 Skill 包，再尝试导入本机 OpenClaw。
- 自动导入要求本机可以执行 `openclaw` 命令，并且下载的 ZIP 包内包含 `SKILL.md`。
- 如果没有检测到 `openclaw`，或 ZIP 包内没有 `SKILL.md`，CLI 会保留已下载文件，并提示用户手动导入。

## 配置目录

Windows:

```text
%APPDATA%\SkillHubCLI\config.json
```

macOS:

```text
~/Library/Application Support/SkillHubCLI/config.json
```

## 默认下载目录

Windows:

```text
%USERPROFILE%\Downloads\SkillHub
```

macOS:

```text
~/Downloads/SkillHub
```

## 开发调试

```bash
cd cli-plugin
npm install
node bin/skillhub.js help
```
