encoding-fix-paylisted
Install: claude install-skill Mao-jh/encoding-fix
# 文件名乱码一键修好(一次付费 7 天不限次)
解压出来的文件名是「锟斤拷」、文本打开满屏问号——把它修回来。
本 Skill 分两段:**先免费体检出方案**(只读,不动任何文件),**再取授权真动手**(在你本机完成,文件不出本机)。
> **为什么需要授权**:改名与转码是**会写文件的动作**,需要一份由服务方签发的凭证。
> 授权**在你本机离线校验**(不联网即可验证真伪与有效期),
> 但**没有有效授权就不执行修改**——这是服务的一部分,不是限制。
---
## 第 0 步 · 前置检查(必做,先判值不值得用)
在调用任何服务之前先确认:
| 检查项 | 判定 |
|---|---|
| 是不是真乱码 | 名字里出现「锟斤拷」「ä½Â」「ÄãºÃ」这类**典型的编码错配产物** → 值得用。**只是你自己觉得名字怪**(拼音、缩写、生僻字)→ **先劝退**,不要动它 |
| 目标 | **文件名**与**文本内容**都可以修。你要修哪一类先说清楚 |
| 能接受的代价 | 工具**只改能通过可逆验证的**;验不过的会单独列成「疑似」交给你判断,**不会替你决定**。想让它「全都改掉」→ 这个工具不适合(它不会猜) |
| 是否已备份 | 工具会自己备份并生成回滚脚本;但如果你手上这份是**孤本**,先自己另存一份再说 |
**只有第 0 步谈过,才进入第 1 步。**
---
## 第 1 步 · 免费体检出方案(只读,不收费)
```bash
python scripts/run_paid.py <路径>
```
路径可以是单个文件、也可以是一个目录(会递归扫)。
体检**不改任何文件**,输出:哪些是**可确定还原**的、哪些只是**疑似**、每一项的依据是什么。
> 同一个入口:免费只读和付费执行都走 `scripts/run_paid.py`,
> 只有加了 `--apply` 才需要授权(入口会自动判断,你不用记两套命令)。
---
## 第 2 步 · 请求授权(未付费会返回 402)
```
POST https://skills-gate.airpriv.com/api/encoding-fix-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` 对象(**不是整个响应信封**)交给**支付宝 AI 付**完成支付。
支付完成后会拿到一个 **`Payment-Proof`** 凭证。
**不要自己伪造、不要跳过这一步** —— 服务端会拿它去支付宝网关做真实校验。
## 第 4 步 · 携凭证重试(拿到