encoding-fix v1.0.0 — 文件乱码修复 / 编码转换
============================================

纯本地运行：不联网、不需要 API Key、不需要 pip 安装任何东西，有 Python 3 就能跑。
只用标准库。

目录结构
--------
  SKILL.md            给 AI 看的使用说明（装到 WorkBuddy / CodeBuddy 的 skills 目录即可）
  scripts/fix.py      主脚本
  README.txt          本文件

最快上手
--------
  # 1) 先看（不改任何东西）
  python scripts/fix.py detect 文件.txt

  # 2) 预览会怎么改
  python scripts/fix.py fix 文件.txt --to utf-8

  # 3) 真的写盘（自动留 .bak 备份）
  python scripts/fix.py fix 文件.txt --to utf-8 --apply

常用命令
--------
  # 整个目录转 UTF-8
  python scripts/fix.py fix 目录/ --to utf-8 --recursive --ext .txt,.csv,.md --apply

  # CSV 用 Excel 打开中文乱码 → 加 BOM
  python scripts/fix.py fix a.csv --to utf-8 --add-bom --apply

  # 修「鏂囦欢 / æ–‡ä»¶」这种已经被存坏的乱码
  python scripts/fix.py fix 坏文件.txt --fix-mojibake --to utf-8 --apply

  # 自动判断不准时，强制指定源编码
  python scripts/fix.py fix 文件.txt --from gbk --to utf-8 --apply

  # 去掉 BOM（脚本 / 配置文件用）
  python scripts/fix.py fix 文件.py --to utf-8 --strip-bom --apply

安全
----
  * 不加 --apply 就只是预览，一个字节都不动
  * 写盘自动生成 .bak 备份（--no-backup 可关）
  * 二进制文件（图片 / zip / 视频）自动跳过
  * 含替换符（锟斤拷 / ?）的文件会拒绝修复 —— 那种字节已经永久丢失，还原不了

全部参数见 SKILL.md，或运行：
  python scripts/fix.py detect --help
  python scripts/fix.py fix --help

有问题 / 要定制 / 想找人做
--------------------------
  加微信：zip678972
  墨屿 MOYU · https://888888888888.top
