table-clean-paylisted

# 乱表变干净 · Excel 清洗合并（一次付费 7 天不限次） 把几份对不上的表，合成一份能直接用的干净表。本 Skill 分两段： **先免费诊断**（只读，不改文件），**再取授权执行清洗**（按次计费，在你本机完成，文件不出本机）。 > **为什么需要授权**：清洗动作需要一份由服务方签发的凭证。 > 授权**在你本机离线校验**（不联网即可验证真伪与有效期）， > 但**没有有效授权就不执行清洗**——这是服务的一部分，不是限制。 --- ## 第 0 步 · 前置检查（必做，先判值不值得用这个工具） 在调用任何服务之前先确认： | 检查项 | 判定 | |---|---| | 文件类型 | **仅 .csv / .xlsx**。老版 .xls → 让用户先在 Excel/WPS 里「另存为 .xlsx」，再继续 | | 问题是不是真乱 | 如果只是「删一列重复值」→ **先劝退**：Excel 自带的「数据 → 删除重复项」就够，不必花钱。多份文件要合并、或同时有重复+空值+日期混乱+数字不能求和中的两样以上 → 值得用 | | 期待是否合理 | 空值**不会被填补**（不编数据）；「这两条是不是同一个客户」这种**相似但不相同的行不会删**——要先跟用户说清楚，别让他以为工具会替他做业务判断 | **只有第 0 步谈过，才进入第 1 步。** --- ## 第 1 步 · 免费诊断（scan，只读，不收费） ```bash python scripts/tableclean.py scan <文件1> [文件2 ...] --report 诊断.md ``` 诊断会告诉用户：每个文件多少行多少列、多少完全重复行、多少空值格、多表合并时列怎么对齐。 **先把诊断结果拿给用户看**，确认他要继续，再进入付费环节。 --- ## 第 2 步 · 请求授权（未付费会返回 402） ``` POST https://skills-gate.airpriv.com/api/table-clean-license Content-Type: application/json {"machine_fp":"<本机指纹串，8–128 位字母数字/连字符，可省略>"} ``` **首次调用一定拿到 `402 Payment Required`** —— 这是设计，不是错误。响应里带： - HTTP 头 `Payment-Needed`（base64url 编码的账单） - 响应体 `payment_needed` / `payment_needed_token` / `amount` / `out_trade_no` > `machine_fp` 可选：带上则这份授权**绑定这台机器**，换机器需重新授权。省略则不绑定。 > 本机指纹：`python scripts/license_check.py fingerprint` ## 第 3 步 · 处理 402（完成支付） 把 `payment_needed_token`（或整个 `Payment-Needed`）交给**支付宝 AI 付**完成授权支付。 支付完成后你会拿到一个 **`Payment-Proof`** 凭证。 **不要自己伪造、不要跳过这一步** —— 服务端会拿它去支付宝网关做真实校验。 ## 第 4 步 · 携凭证重试（拿到授权凭证） **同一个请求**，加上支付凭证头重发： ``` POST https://skills-gate