folder-forge-paylisted
Install: claude install-skill Mao-jh/folder-forge
# 按日期批量建文件夹（一次付费 7 天不限次）
给一批日期、一批编号、一份名单，一次把整套目录建出来。
本 Skill 分两段：**先免费出清单**（只读，不建任何目录），**再取授权真建**（在你本机完成，不联网）。
> **为什么需要授权**：批量创建目录需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**，但**没有有效授权��不执行创建**——这是服务的一部分，不是限制。
---
## 第 0 步 · 先出清单（免费，必做）
```bash
python scripts/folderforge.py date --root <目录> --from 2026-01-01 --to 2026-12-31 --unit day
python scripts/folderforge.py date --root <目录> --from 2026-01 --to 2026-12 --unit month --layout "{Y}/{Y}-{M}"
python scripts/folderforge.py index --root <目录> --count 24 --pattern "第{n:02d}章"
python scripts/folderforge.py names --root <目录> --file 名单.txt
```
| 参数 | 说明 |
|---|---|
| `--unit` | `day` / `week` / `month` / `quarter` / `year` |
| `--layout` | 层级模板。可用 `{Y}` `{M}` `{D}` `{Q}` `{W}` `{YM}` `{YQ}` `{YMD}` `{YMD_}` |
| `--pattern` | 编号模板，支持 `{n}` 与 `{n:02d}` 补零 |
| `--root` | 在哪个目录下建（**必须已存在**，本工具不建父目录链） |
清单会长这样：`新建 N 个 · 已存在 M 个 · 被同名文件占用 K 个`。
**看到 `K > 0` 会直接拒绝执行**——那是同名文件挡路，覆盖它不是我们该替你做的决定。
**没给 `--apply` 时，什么都不会被创建。**
## 第 1 步 · 请求授权（未付费会返回 402）
```
POST https://skills-gate.airpriv.com/api/folder-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 步 · 处理 402（完成支付）
把 `payment_needed` 对象（**不是整个响应信封**）交给**支付宝 AI 付**完成支付，拿回 **`Payment-Proof`**。
**不要自己伪造** —— 服务端会拿它去支付宝网关做真实校验。
## 第 3 步 · 携凭证重试（拿到授权凭证）
同一请求加上头 `Paymen