# Scripts 目录说明

本目录包含 OpenClaw VOC Skills 项目的所有脚本，按功能分为三类。

## 目录结构

```
scripts/
├── deploy/                      # 部署与发布
│   ├── deploy-to-openclaw.ps1   # 本地部署：skills + playbook + memory → ~/.openclaw/
│   └── upload-skills.js         # CDN发布：上传所有 skills 到七牛云 CDN
│
├── tools/                       # 维护工具
│   ├── add-token-config.ps1     # 批量给 api-config.json 注入 tokenConfig
│   ├── fix-token-config.ps1     # 修复已损坏的 tokenConfig JSON
│   ├── fix-qrcode-url.py        # 修复充值二维码 URL
│   ├── update-payment-urls.ps1  # 批量更新支付页面 URL
│   ├── token-config-injection.txt  # tokenConfig 注入模板
│   ├── skill-executor.js        # Skill 执行器（含计费闭环测试）
│   └── mock-balance-server.js   # 模拟余额检查服务器
│
└── test/                        # 测试脚本
    ├── apig/                    # APIG 接口测试
    │   ├── test-apig-flow.ps1
    │   ├── test-apig-flow2.ps1
    │   ├── test-apig-cloudfunction.ps1
    │   ├── test-apig-real-user.ps1
    │   ├── test-apig-recharge.ps1
    │   ├── test-apig-routes.ps1
    │   └── test-balance-check.js
    │
    ├── cloudfunc/               # 云函数测试
    │   ├── test-cloudfunc.ps1
    │   ├── test-cloudfunc-name.ps1
    │   ├── test-cloudfunc-name2.ps1
    │   ├── test-cloudfunc3.ps1
    │   └── test-cloudfunc4.ps1
    │
    ├── video/                   # 视频 API 测试
    │   ├── test-video-api.ps1
    │   ├── test-video-auth.ps1
    │   ├── test-video-direct.ps1
    │   ├── test-video-full-flow.ps1
    │   └── test-video-isolation.ps1
    │
    └── misc/                    # 其他调试/查询
        ├── debug-single.ps1
        ├── test-find-apigauth.ps1
        ├── test-find-user.ps1
        ├── test-getapig-authid.ps1
        ├── test-getapig-parse.ps1
        ├── test-getapig-raw.ps1
        └── test-read.ps1
```

## 常用命令

### 部署到本地 OpenClaw

```powershell
# 部署全部（skills + playbook + memory templates）
.\scripts\deploy\deploy-to-openclaw.ps1

# 预览模式
.\scripts\deploy\deploy-to-openclaw.ps1 -DryRun

# 仅部署 skills
.\scripts\deploy\deploy-to-openclaw.ps1 -SkillsOnly

# 仅部署 workshop（playbook + memory）
.\scripts\deploy\deploy-to-openclaw.ps1 -WorkshopOnly

# 自定义 OpenClaw 目录
.\scripts\deploy\deploy-to-openclaw.ps1 -OpenClawDir "D:\custom\.openclaw"
```

### 上传到 CDN

```powershell
# 上传所有 skills 到七牛云（需要先 npm install）
node scripts\deploy\upload-skills.js
```

上传后的 CDN 地址格式：
```
https://repos.fmode.cn/x/openclaw-skills/{skill-name}/SKILL.md
https://repos.fmode.cn/x/openclaw-skills/{skill-name}/api-config.json
```

一键下载包：
```
https://repos.fmode.cn/x/openclaw-skills/openclaw-voc-skills.zip
```