技能教程 · TUTORIAL
广告法违禁词 / 极限词检测 · 详细教程
纯本地扫文案里的广告法风险词（违禁词、极限词），给出命中位置和改写建议，不联网、不需要 API Key。
这是什么
adword-guard 是一个跑在你自己机器上的文案体检工具。它按一份整理好的词库，扫一遍你的文案或商品详情，把《广告法》里常见的违禁词、极限词（「最」「第一」「国家级」「根治」等）标出来，告诉你在哪一行、哪一列，并给一句改写建议。
零依赖：不联网、不需要 API Key、不装任何第三方库，Python 标准库直接跑。
适合谁 / 不适合谁
- ✅ 投放前自查：详情页、标题、口播稿、朋友圈文案，先扫一遍再发。
- ✅ 一批文案要过：整个目录的 txt / csv 一起扫，出一份 CSV 报告。
- ❌ 不是法务意见：它只做初筛，命中不等于一定违法，上架前拿不准的按平台规则或找法务过一遍。
- ❌ 只处理纯文本（txt / csv / md）。docx / pdf 先自己转成文本再扫。
怎么部署
- 下载解压：点页面顶部的「下载 …」拿到 zip，解压得到一个
adword-guard/文件夹（里面是SKILL.md和scripts/）。 - 装进 AI 助手：把整个
adword-guard/文件夹放进你所用助手的 skills 目录，助手就能自动发现它 ——
- WorkBuddy / CodeBuddy（用户级）：
~/.workbuddy/skills/adword-guard/，Windows 上是C://Users//<你的用户名>//.workbuddy//skills//adword-guard//； - 只想在某个项目里用：
<项目目录>/.workbuddy/skills/adword-guard/。
- 零依赖：这个包不需要装任何依赖，放进去就能跑。
- 用起来：直接跟助手说要做什么（例：「帮我扫一下这段广告文案有没有违禁词」），它会调用；想手动跑也行：
python scripts/adword.py --help用法
铁律：先 scan，再 fix。scan 只读、不改任何东西；fix 默认只预览，加 --apply 才真的写盘。
scan —— 体检（只读）
python scripts/adword.py scan 文案.txt
python scripts/adword.py scan ./文案包/ --recursive --ext .txt,.csv
python scripts/adword.py scan a.txt b.csv --report 报告.csv报告 CSV 列：文件,行号,列号,类别,命中词,上下文,处置,建议。两类处置：
- 自动可替换：词库里有安全说法（如
最低价→优惠价），fix 会直接换； - 需人工改写/删除：如
最好、第一、根治——工具不敢乱换，列出来让你自己改。
fix —— 自动替换（默认预览）
python scripts/adword.py fix ./文案包/ --out-dir 干净版/ --recursive # 预览
python scripts/adword.py fix ./文案包/ --out-dir 干净版/ --recursive --apply # 写盘只动「自动可替换」的词；「需人工改写」的命中原样保留（改错一个词比不替换更糟）。替换结果一律写到新目录，原文件不动，写盘时还会在 backup/ 留原文件副本。
list —— 看词库
python scripts/adword.py list按类别列出全部规则，确认词库对不对、要不要增删。
词库怎么改
词库在 scripts/words.json，纯 JSON，改完保存就生效，不用动代码：
{"i": 74, "c": "绝对化用语", "w": "你的新词", "a": "delete"}字段：w=词；p=可选正则；x=上下文排除（如「第一」后跟「名」就放行）；a=处置（delete=人工处理 / replace=自动换成 s）；s=安全说法；i=唯一编号。想收严就加词，想收松就删词。
词库覆盖（v1.0，73 条）
| 类别 | 举例 |
|---|---|
| 绝对化用语 | 最好、最佳、顶级、第一、独家、唯一、100%、零风险 |
| 功效承诺 | 根治、除根、三天见效、消炎、抗癌、无副作用、纯天然 |
| 虚假时限 | 仅限今天、手慢无、马上涨价、限时秒杀、抢购 |
| 迷信背书 | 开光、镇宅、辟邪、风水、招财、转运 |
带上下文排除：「第一」后跟 名/次/天/台/版…（序数用法）不报；「绝对」后跟 值/湿度/温度…（物理量）不报。
已知边界（如实说，不吹）
- 命中 ≠ 违法：很多词要看上下文，词库也没法穷尽所有变体。它是初筛工具，不是法务意见。
- 只处理纯文本；
docx/pdf先转成文本再扫。 - 词库更新跟法规/平台规则走，遇到没覆盖的新词，用
list看着加一条就行。
想要加功能
包里目前是 SKILL.md + scripts/adword.py + scripts/words.json。想加自定义行业词库、改处置规则、或接进你们自己的系统 → 用页面底部的联系方式找我，说清场景，我帮你做。