xlsx-split-forge-paylisted
Install: claude install-skill Mao-jh/xlsx-split-forge
# Excel拆分·按部门/按条件把一张表拆成多个文件
本 Skill 分两段：**先免费体检**（只读，不写任何文件），**再取授权真写**（在你本机完成，不联网）。
> **为什么需要授权**：批量写出文件需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**，但**没有有效授权就不执行写盘** —— 这是服务的一部分。
---
## 第 0 步 · 先体检（免费，建议必做）
```bash
python scripts/xlsplit.py --in 总表.xlsx --by-col 部门
```
| 用法 | 作用 | 参数 |
|---|---|---|
| `--in <文件>` | 源表（.xlsx / .csv），可多个 | 多个文件各自拆 |
| `--by-col 部门` | 按这一列的每个取值拆 | 列名 / 列序号 / 列字母都行 |
| `--by-sheet` | 按工作表拆（一表一文件） | 和 --by-col 二选一 |
| `--every 500` | 每 500 行拆一份（大表分卷） | 最后一份可能不足 N 行 |
| `--sheet 一月,二月` | 只处理这几张工作表 | 逗号分隔 |
| `--format csv` | 输出 csv 而不是 xlsx | 默认跟随源文件 |
| `--max-groups 200` | 拆出文件数的上限（默认 200） | 超了会中止，防选错列炸出几千个 |
| `--apply --out 目录` | 真拆分并写出 | 付费；不加 --apply 只体检 |
**没给 `--apply` 时，什么都不会被写出** —— 只打印将要发生什么。
## 第 1 步 · 请求授权（未付费会返回 402）
```
POST https://skills-gate.airpriv.com/api/xlsx-split-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 步相同的值>"
ec