1688 AlphaClaw

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

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

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

安装

# 本地开发安装
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. 登录

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

3. 搜索技能

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

4. 查看技能详情

alphaclaw info xiaohongshu-upload

5. 安装技能

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

6. 查看已安装的技能

alphaclaw list

7. 发布技能

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

8. 收藏技能

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

9. 发表评论

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

10. 查看当前用户

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 文件，格式如下：

---
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 进行验证

示例工作流

创建和发布新技能

# 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

查找和安装技能

# 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 标志查看详细信息：

alphaclaw publish --debug

许可证

MIT

贡献者

SkillHub Team @ Alibaba