mirror of
https://github.com/iflytek/skillhub.git
synced 2026-08-28 11:25:00 +00:00
159 lines
2.6 KiB
Markdown
159 lines
2.6 KiB
Markdown
---
|
|
title: CLI 兼容层
|
|
sidebar_position: 4
|
|
description: ClawHub CLI 协议兼容层
|
|
---
|
|
|
|
# CLI 兼容层
|
|
|
|
SkillHub 提供 ClawHub CLI 协议兼容层，现有工具可无缝迁移。
|
|
|
|
## 配置 ClawHub CLI
|
|
|
|
要让 ClawHub CLI 连接到你的 SkillHub 实例，需要配置以下环境变量：
|
|
|
|
### 环境变量配置
|
|
|
|
**Linux/macOS (bash/zsh):**
|
|
```bash
|
|
# ~/.bashrc 或 ~/.zshrc
|
|
export CLAWHUB_SITE=https://skill.xfyun.cn
|
|
export CLAWHUB_REGISTRY=https://skill.xfyun.cn
|
|
```
|
|
|
|
**Windows (PowerShell):**
|
|
```powershell
|
|
# 永久设置（当前用户）
|
|
[Environment]::SetEnvironmentVariable('CLAWHUB_SITE', 'https://skill.xfyun.cn', 'User')
|
|
[Environment]::SetEnvironmentVariable('CLAWHUB_REGISTRY', 'https://skill.xfyun.cn', 'User')
|
|
|
|
# 或者临时设置（当前会话）
|
|
$env:CLAWHUB_SITE = 'https://skill.xfyun.cn'
|
|
$env:CLAWHUB_REGISTRY = 'https://skill.xfyun.cn'
|
|
```
|
|
|
|
### 使用 CLI 标志（单次命令）
|
|
|
|
```bash
|
|
clawhub --site https://skill.xfyun.cn --registry https://skill.xfyun.cn install <skill>
|
|
```
|
|
|
|
### 前端一键复制
|
|
|
|
SkillHub 网页端的技能详情页会自动显示带有正确环境变量的安装命令，直接复制即可使用。
|
|
|
|
## Well-known 发现
|
|
|
|
```http
|
|
GET /.well-known/clawhub.json
|
|
```
|
|
|
|
响应：
|
|
|
|
```json
|
|
{
|
|
"apiBase": "/api/v1"
|
|
}
|
|
```
|
|
|
|
## 兼容层 API
|
|
|
|
### Whoami
|
|
|
|
```http
|
|
GET /api/v1/whoami
|
|
```
|
|
|
|
响应：
|
|
|
|
```json
|
|
{
|
|
"handle": "username",
|
|
"displayName": "User Name",
|
|
"role": "user"
|
|
}
|
|
```
|
|
|
|
### 搜索
|
|
|
|
```http
|
|
GET /api/v1/search?q={keyword}&page={page}&limit={limit}
|
|
```
|
|
|
|
响应：
|
|
|
|
```json
|
|
{
|
|
"results": [
|
|
{
|
|
"slug": "my-skill",
|
|
"name": "My Skill",
|
|
"description": "...",
|
|
"author": {
|
|
"handle": "username",
|
|
"displayName": "User Name"
|
|
},
|
|
"version": "1.2.0",
|
|
"downloadCount": 100,
|
|
"starCount": 50,
|
|
"createdAt": "2026-01-01T00:00:00Z",
|
|
"updatedAt": "2026-03-01T00:00:00Z"
|
|
}
|
|
],
|
|
"total": 1,
|
|
"page": 1,
|
|
"limit": 20
|
|
}
|
|
```
|
|
|
|
### 解析
|
|
|
|
```http
|
|
GET /api/v1/resolve?slug={slug}&version={version}
|
|
```
|
|
|
|
响应：
|
|
|
|
```json
|
|
{
|
|
"slug": "my-skill",
|
|
"version": "1.2.0",
|
|
"downloadUrl": "/api/v1/download/my-skill/1.2.0"
|
|
}
|
|
```
|
|
|
|
### 下载
|
|
|
|
```http
|
|
GET /api/v1/download/{slug}/{version}
|
|
```
|
|
|
|
### 发布
|
|
|
|
```http
|
|
POST /api/v1/publish
|
|
Content-Type: multipart/form-data
|
|
|
|
file: <zip-file>
|
|
```
|
|
|
|
响应：
|
|
|
|
```json
|
|
{
|
|
"slug": "my-skill",
|
|
"version": "1.0.0",
|
|
"status": "published"
|
|
}
|
|
```
|
|
|
|
## 坐标映射
|
|
|
|
| SkillHub 坐标 | ClawHub canonical slug |
|
|
|---------------|------------------------|
|
|
| `@global/my-skill` | `my-skill` |
|
|
| `@team-name/my-skill` | `team-name--my-skill` |
|
|
|
|
## 下一步
|
|
|
|
- [系统架构](../architecture/overview) - 了解架构设计
|