adword-guard v1.0.0 — 广告法违禁词 / 极限词检测
======================================================================

纯本地运行：**不联网、不需要 API Key、不用装任何第三方库**。
有 Python 3 就能跑，只用标准库 —— 扫 txt / csv / md 里的广告法风险词，
出 Excel 能直接打开的 CSV 报告，还能一键替换有安全说法的词。

目录结构
--------
  SKILL.md            给 AI 看的使用说明（装到 WorkBuddy / CodeBuddy 的 skills 目录即可）
  scripts/adword.py   主脚本
  scripts/words.json  词库（73 条，改词直接改它，不用改代码）
  README.txt          本文件

最快上手
--------
  # 1) 体检（只读，出 CSV 报告）
  python scripts/adword.py scan 文案.txt

  # 2) 整个目录扫一遍（递归 + 只看 txt/csv）
  python scripts/adword.py scan ./文案包/ --recursive --ext .txt,.csv

  # 3) 预览自动替换
  python scripts/adword.py fix ./文案包/ --out-dir 干净版/ --recursive

  # 4) 真的写盘（原文件不动，另留备份）
  python scripts/adword.py fix ./文案包/ --out-dir 干净版/ --recursive --apply

常用命令
--------
  # 看词库现在有哪些词
  python scripts/adword.py list

  # 报告写到自定义位置
  python scripts/adword.py scan a.txt b.csv --report 报告.csv

  # 自定义词库路径
  python scripts/adword.py scan 文案.txt --words 我的词库.json

两类处置
--------
  自动可替换   词库里有安全说法（如 最低价→优惠价、限时秒杀→限时优惠），
               fix 会直接换掉。
  需人工改写   如 最好 / 第一 / 根治 / 顶级 —— 换错比不替换更糟，
               脚本只报告、不代改，按 scan 报告逐条处理。

安全
----
  * scan 永远只读，不碰文件
  * fix 不加 --apply 就只是预览，一个文件都不写
  * 写盘结果一律进 --out-dir 新目录，**输入文件原样保留**，
    同时在该目录 backup/ 下留一份原件副本

已知边界
--------
  * 命中 ≠ 违法，很多要看上下文；词库也没法穷尽所有变体。
    它是初筛工具，不是法务意见，上架前拿不准的过一遍平台规则。
  * 只处理纯文本（txt/csv/md），docx/pdf 先转成文本再扫。
  * 带上下文排除：「第一」后跟 名/次/天/台/版 不报；「绝对」后跟 值/湿度/温度 不报。

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

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