我装好了，怎么用？（30 秒上手）

这个 Skill 不是给你手动敲命令的，是给你的 AI 助手用的。

1. 装载：在 SkillHub 里点「安装 / 添加到我的 Agent」——装到你的 WorkBuddy / 支持的 AI 客户端里。
   装好后不用背命令，直接用大白话跟 AI 说下面这句话就行。
2. 先免费试：对 AI 说 ——
   > 「帮我看下这几个表有多乱」（把文件拖给它）
   AI 会跑免费诊断（只读，不改文件，不收费），告诉你多少重复行、多少空值、日期格式乱在哪。
3. 觉得值再付费：诊断看完，说 ——
   > 「可以，帮我洗干净」
   这时才会弹支付宝 ¥1.99（一次付费 7 天不限次，期内再清洗不重复扣费）。
   清洗在你自己电脑上完成，表格不上传。

> 只认得三句话：「帮我看下这几个表有多乱」= 免费诊断 ·
> 「可以，帮我洗干净」= 付费清洗 · 「帮我装一下这个 Skill」= 安装引导。
> 若你的客户端不支持自动安装，把本文件（SKILL.md）连同 scripts/ 目录交给你的 AI，
> 对它说「照这个 SKILL.md 帮我配上」即可。

乱表变干净 · Excel 清洗合并（一次付费 7 天不限次）

把几份对不上的表，合成一份能直接用的干净表。本 Skill 分两段：
先免费诊断（只读，不改文件），再取授权执行清洗（按次计费，在你本机完成，文件不出本机）。

> 为什么需要授权：清洗动作需要一份由服务方签发的凭证。
> 授权在你本机离线校验（不联网即可验证真伪与有效期），
> 但没有有效授权就不执行清洗——这是服务的一部分，不是限制。

第 0 步 · 前置检查（必做，先判值不值得用这个工具）

在调用任何服务之前先确认：

只有第 0 步谈过，才进入第 1 步。

第 1 步 · 免费诊断（scan，只读，不收费）

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.airpriv.com/api/table-clean-license
Content-Type: application/json
Payment-Proof: <第 3 步拿到的凭证>

{"machine_fp":"<与第 2 步相同的值>"}

成功时返回 200，content.data.license 就是授权凭证。把它存成 license.json。
一次付费 = 一份授权，有效期 7 天（grant_mode=per_build）。期间重试、反复清洗不需要再付费。

第 5 步 · 校验授权并执行清洗（离线，不联网）

python scripts/license_check.py check license.json --fingerprint "<与第 2 步相同的 machine_fp>"
echo $?    # 0 = 放行；非 0 = 拒绝，不要执行清洗

退出码 0 才允许执行清洗：

python scripts/tableclean.py clean <文件1> [文件2 ...] -o cleaned.xlsx
# 可选：--report 报告.md（默认 <输出名>_报告.md）  --dedup-key 列名（按某列去重，默认整行去重）

工具自带回读校验（写完自己读一遍，行列对不上会删除产物并报错，不会交一份坏表）。
清洗报告（markdown）是交付物的一部分——它带前后对比计数，排版适合直接转发给交表的人；
交付时把「清洗后的 xlsx + 报告」一起给用户，并把报告里的关键数字念给他听。

交付给用户的说法（照这个口径，别夸大）

1. 重复行只删「逐格完全相同」的；相似但不相同的行原样保留，由用户定夺。
2. 空值没有填补——报告里有计数，自己去决定怎么处理。
3. 日期歧义没猜（比如 03/04/26 这种，保持原文）。
4. 多工作表的 xlsx 只处理了第 1 张——报告里会标注。

诚实边界（用户问到时照实说）

• 授权是「付费门」，不是版权保护。授权离线可验，防的是「没付钱就用」；不防「付一次之后在本地自行延长使用」。更强保护只能把清洗放到服务端执行，而清洗必须在用户自己的机器上跑（要读用户的表格文件）——架构上不可兼得。
• 清洗全程在本机完成：用户的表格不上传、产物不出本机。授权服务只收一个可选的机器指纹，不接收也不留存用户的任何数据内容。

<!-- skillhub-payblock -->

付费链路自检（与平台五项自查一一对应）

本 Skill 的付费链路由服务端承担验付、资源交付与商家履约确认；Skill 只负责
发起请求、调用官方支付能力并展示结果。逐条对应平台自查项如下：

> 支付能力由支付宝 AI 按量付费官方链路承担，本 Skill 不接触支付密钥、不自行实现付款或签名。

<!-- /skillhub-payblock -->