quick-launch-forge-paylisted
Install: claude install-skill Mao-jh/quick-launch-forge
# 一键打开常用文件夹·双击就开的启动入口
本 Skill 分两段:**先免费体检**(只读,不写任何文件),**再取授权真写**(在你本机完成,不联网)。
> **为什么需要授权**:批量写出文件需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**,但**没有有效授权就不执行写盘** —— 这是服务的一部分。
---
## 第 0 步 · 先体检(免费,建议必做)
```bash
python scripts/quicklaunch.py --add "客户资料=D:/客户资料" --add "公司官网=https://example.com"
```
| 用法 | 作用 | 参数 |
|---|---|---|
| `--add "名称=路径"` | 加一条入口,可多次 | 路径 / 网址 / 程序都行 |
| `--in 入口.json` | 从配置文件读全部入口 | 也支持每行一条 `名称=路径` 的 .txt |
| `--name 我的入口` | 启动台的名字 | 默认「常用入口」 |
| `--out 目录` | 产物写到哪 | 默认 ./常用入口 |
| `--apply` | 真生成 | 付费;不加只体检 |
**没给 `--apply` 时,什么都不会被写出** —— 只打印将要发生什么。
## 第 1 步 · 请求授权(未付费会返回 402)
```
POST https://skills-gate.airpriv.com/api/quick-launch-forge-license
Content-Type: application/json
{"machine_fp":"<本机指纹串,8–128 位,可省略>"}
```
首次调用一定拿到 `402 Payment Required`(设计如此)。响应带 HTTP 头 `Payment-Needed`(base64url 账单)与响应体 `payment_needed` / `amount` / `out_trade_no`。
本机指纹:`python scripts/license_check.py fingerprint`
## 第 2 步 · 完成支付
把 `payment_needed` 对象(**不是整个响应信封**)交给**支付宝 AI 付**完成支付,拿回 **`Payment-Proof`**。
**不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。
## 第 3 步 · 携凭证重试(拿到授权凭证)
同一请求加上头 `Payment-Proof: <凭证>` 重发,成功返回 `200`,
`content.data.license` = 授权凭证(存成 `license.json`)。
**一次付费 = 一份授权 = 7 天有效**,期间反复处理**不需要再付费**。
## 第 4 步 · 校验授权并执行(离线)
```bash
python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的值>"
echo $? # 0 = 放行;非 0 = 拒绝,不要执行
```
退出码:`0` 通过 · `4` 签名不通过 · `5` 已过期 · `6` 产品不匹配 · `7` 指纹不匹配 · `2` 路径问题。
**退出码 `0` 才允许执行**:
```bash
python scripts/run_paid.p