npm package: 1688alphaclaw
Description: SkillHub CLI - Manage and publish skills to SkillHub (Alibaba Internal)
Author: SkillHub Team @ Alibaba
Latest version: 1.1.6

# 1688 AlphaClaw

**SkillHub CLI Tool** - 1688 技能管理平台命令行工具

AlphaClaw 是为 SkillHub 技能中心开发的命令行工具，让开发者可以快速搜索、安装、发布和管理 Claude Code 技能（Skill）。

**官网**: https://www.alphashop.cn/

## 安装

```bash
# 本地开发安装
cd alphaclaw
chmod +x bin/alphaclaw.js
npm link

# 或者全局安装（发布到 npm 后）
npm install -g 1688alphaclaw
```

## 快速开始

### 1. 获取 API 密钥

访问遨虾控制台获取 Access Key 和 Secret Key：

**地址**: https://www.alphashop.cn/seller-center/apikey-management

> Secret Key 仅在创建时可见，请妥善保管！

### 2. 登录

```bash
alphaclaw login
# 自动打开浏览器访问 API 密钥管理页面
# 输入 Access Key 和 Secret Key（SK 输入时会被隐藏）
```

### 3. 搜索技能

```bash
alphaclaw search "小红书"
alphaclaw search "数据处理"
```

### 4. 查看技能详情

```bash
alphaclaw info xiaohongshu-upload
```

### 5. 安装技能

```bash
alphaclaw install xiaohongshu-upload
alphaclaw install xiaohongshu-upload --version 1.0.0
alphaclaw install xiaohongshu-upload --force  # 强制覆盖
```

### 6. 查看已安装的技能

```bash
alphaclaw list
```

### 7. 发布技能

```bash
cd my-skill/
alphaclaw publish
# 或者指定目录
alphaclaw publish ./my-skill --yes  # 跳过确认
```

### 8. 收藏技能

```bash
alphaclaw favorite xiaohongshu-upload
alphaclaw favorite xiaohongshu-upload --remove  # 取消收藏
```

### 9. 发表评论

```bash
alphaclaw comment xiaohongshu-upload
# 然后输入评论内容
```

### 10. 查看当前用户

```bash
alphaclaw whoami
```

## 命令列表

| 命令 | 说明 | 示例 |
|------|------|------|
| `login` | 登录到 SkillHub | `alphaclaw login` |
| `whoami` | 查看当前用户信息 | `alphaclaw whoami` |
| `search <query>` | 搜索技能 | `alphaclaw search "数据处理"` |
| `list` | 列出已安装的技能 | `alphaclaw list` |
| `info <name>` | 查看技能详情 | `alphaclaw info xiaohongshu-upload` |
| `install <name>` | 安装技能 | `alphaclaw install xiaohongshu-upload` |
| `publish [path]` | 发布技能 | `alphaclaw publish ./my-skill` |
| `comment <name>` | 发表评论 | `alphaclaw comment xiaohongshu-upload` |
| `favorite <name>` | 收藏/取消收藏 | `alphaclaw favorite xiaohongshu-upload` |

## 全局选项

| 选项 | 说明 |
|------|------|
| `--api <url>` | 覆盖 API 基础 URL |
| `--version, -v` | 显示版本号 |
| `--help, -h` | 显示帮助信息 |
| `--yes, -y` | 跳过确认提示 |
| `--force` | 强制执行（如覆盖已安装的技能） |
| `--debug` | 显示调试信息 |

## 技能包格式

要发布技能，你的技能目录必须包含 `SKILL.md` 文件，格式如下：

```markdown
---
name: my-skill
version: 1.0.0
type: SKILL
category: DATA_PROCESSING
description: "我的技能描述"
github-url: https://github.com/example/my-skill
---

# My Skill

详细说明你的技能...

## 使用方法

...

## 示例

...
```

### 必需字段

- `name`: 技能名称（字母、数字、连字符，如 `xiaohongshu-upload`、`1688-ranking`）
- `version`: 版本号（遵循语义化版本，如 `1.0.0`）
- `category`: 分类编码（见下文分类列表）
- `description`: 技能描述

### 可选字段

- `type`: 类型（`SKILL` 或 `EXPERIENCE`，默认 `SKILL`）
- `github-url`: GitHub 仓库链接

## 技能分类

| 分类编码 | 分类名称 |
|---------|---------|
| `official-1688` | 1688官方 |
| `product-sourcing` | 选品找商 |
| `material` | 素材处理 |
| `store-management` | 店铺管理 |
| `smart-marketing` | 智能营销 |
| `data-analysis` | 数据分析 |
| `other` | 其他 |

## 环境变量

| 变量名 | 说明 | 默认值 |
|-------|------|--------|
| `SKILLHUB_API` | SkillHub API 地址 | `https://api.alphashop.cn` |
| `NO_COLOR` | 禁用彩色输出 | - |

## 配置文件

AlphaClaw 的配置文件存储在：

- **认证信息**: `~/.alphaclaw/auth.json`
- **安装锁文件**: `~/.skillhub/skills-lock.json`
- **技能安装目录**: `~/.skillhub/skills/`

## 认证方式

AlphaClaw 使用基于 **JWT (JSON Web Token)** 的 AK/SK 认证方式：

- 使用 HMAC-SHA256 算法生成 JWT Token
- Token 有效期：30 分钟
- 每次 API 请求自动生成新 Token
- Authorization Header 格式：`Bearer <token>`

**认证流程**：
1. 用户登录输入 Access Key 和 Secret Key
2. 凭证保存到 `~/.alphaclaw/auth.json`
3. 每次 API 请求自动生成 JWT Token
4. Token 添加到 `Authorization` Header
5. 发送到后端 API 进行验证

## 示例工作流

### 创建和发布新技能

```bash
# 1. 创建技能目录
mkdir my-awesome-skill
cd my-awesome-skill

# 2. 创建 SKILL.md
cat > SKILL.md << 'EOF'
---
name: my-awesome-skill
version: 1.0.0
type: SKILL
category: DATA_PROCESSING
description: "一个很棒的技能"
---

# My Awesome Skill

这是一个很棒的技能...
EOF

# 3. 添加你的脚本文件
mkdir scripts
touch scripts/main.py

# 4. 登录（如果还没登录）
alphaclaw login

# 5. 发布
alphaclaw publish
```

### 查找和安装技能

```bash
# 1. 搜索技能
alphaclaw search "数据处理"

# 2. 查看详情
alphaclaw info data-processing-skill

# 3. 安装
alphaclaw install data-processing-skill

# 4. 查看已安装
alphaclaw list
```

## 与 SkillHub 后端集成

AlphaClaw 与 SkillHub 后端（global-1688-skills）无缝集成：

| 命令 | 后端 API |
|------|---------|
| `publish` | `POST /api/skill/file/upload` |
| `install` | `GET /api/skill/file/download` |
| `search` | `POST /api/skill/list` |
| `info` | `GET /api/skill/detail` |
| `comment` | `POST /api/skill/comment/add` |
| `favorite` | `POST /api/skill/favorite/add` |

## 调试

如果遇到问题，可以使用 `--debug` 标志查看详细信息：

```bash
alphaclaw publish --debug
```

## 许可证

MIT

## 贡献者

SkillHub Team @ Alibaba