> 重要提示：本文档用于测试和研究目的。花生壳平台需要付费升级会员才能长期使用，当前仅体验功能。
一、前置条件（必须）
1.1 用户必须先完成以下步骤
注意：AI 智能体无法自动完成这一步，必须由用户操作！
| 步骤 | 操作 | 说明 |
|------|------|------|
| ① 注册账号 | 打开 https://console-hsk-ng.oray.com | 新用户注册贝锐花生壳账号 |
| ② 登录平台 | 扫码或账号密码登录 | 确保账号状态正常 |
| ③ 获取 API Key | 进入「静态托管」页面 → 点击「复制指令」 | 复制其中的 API Key |
| ④ 提供给智能体 | 将 API Key 发给 AI 智能体 | 用于自动认领资源 |
1.2 两种使用模式
| 模式 | 需要 API Key | 有效期 | 适用场景 |
|------|-------------|--------|----------|
| 匿名临时 | ❌ 不需要 | 7天 | 临时测试、研究体验 |
| 自动认领 | ✅ 需要 | 永久（需付费会员） | 长期使用、正式项目 |
二、什么是 HSK CLI？
HSK CLI 是贝锐花生壳提供的命令行工具，支持两大核心功能：
| 功能 | 说明 |
|------|------|
| 文件托管 | 上传 HTML/ZIP 等静态资源，自动生成公网可访问的 URL |
| 内网穿透 | 将本地服务暴露到公网 |
三、完整流程（关键）
花生壳公网上传完整流程
- 用户操作
- 注册账号：console-hsk-ng.oray.com
- 登录平台
- 获取 API Key：静态托管页面 → 复制指令
- 用户提供给智能体
- 将 API Key 发送给 AI 智能体
- 智能体执行
- 安装 HSK CLI
- 保存 API Key
- 执行上传命令
- 返回结果
- 公网链接
- 资源 ID
- 认领提示
四、安装与上传命令
安装 HSK CLI
```bash
npm install -g @aweray/hsk-cli
hsk-cli update
hsk-cli --version
```
上传文件
```bash
hsk-cli host --format json
```
保存 API Key（用于自动认领）
```bash
hsk-cli api-key set --scene file_hosting --key
```
五、费用说明
⚠️ 重要：花生壳平台需要付费升级会员才能长期使用！
| 套餐 | 价格 | 功能 |
|------|------|------|
| 免费版 | 0元 | 7天临时链接 |
| 标准版 | 约50元/年 | 永久链接 |
| 企业版 | 约200元/年 | 自定义域名 |
结论： 本文档仅用于测试和研究。
六、相关链接
- 花生壳官网：https://ficp.fun
- HSK 控制台：https://console-hsk-ng.oray.com/console/file-hosting
- HSK CLI 文档：https://hsk.oray.com/doc/cli-setup.md
教程更新时间：2026年08月19日