SKILL.md
wjs-cleaning-spam
清理挂在王建硕推文下的同城引流 spam 回复：隐藏回复 + 静音账号。
Core Principle
别人的推文删不掉。 X 只给串主两个武器：hide reply（从评论区移除，访客不可见）和 mute（通知里不再出现）。block 端点已被 X 从 API 下线（v2 返回 code 34，v1.1 要更高访问级别），真要拉黑只能网页手动。「删掉spam」= 隐藏 + 静音，做到 API 上限。
先 dry-run，人审 borderline，再 apply。 启发式会把真人评论（"机器人🤖"、"저지능🤪"）和 spam 变体（"我在济源呀🌷" + 隐形字符）分错边。flagged 直接处理，borderline 必须 Claude 逐条看。
Workflow
# 1. dry-run：输出 flagged + borderline 两个名单（JSON）
python3 ~/.claude/skills/wjs-cleaning-spam/scripts/clean_spam.py
# 2. Claude 逐条审 borderline：引流号特征 = 名字带 💕🌸♥ 装饰 / 同城话术 /
# 文本夹隐形字符（U+034F 等）/ 纯 emoji。真人评论（哪怕是骂人）不动。
# 把 borderline 里确认是 spam 的 id 并入名单。
# 3. apply：隐藏 + 静音（默认只处理 flagged；审完 borderline 用 --ids 指定全集）
python3 ~/.claude/skills/wjs-cleaning-spam/scripts/clean_spam.py --apply
python3 ~/.claude/skills/wjs-cleaning-spam/scripts/clean_spam.py --apply --ids id1,id2,...
# 4. 撞 429 限流（hide 约 50 次/15 分钟）脚本会自动停 —— 15 分钟后重跑同一条命令，
# state/cleaned.jsonl 记录了已处理的 id，自动跳过、续跑。向用户汇报：隐藏几条、失败几条（及原因）、静音几个号；提醒 block 需网页手动。
踩过的坑（2026-06-10 实战）
| 坑 | 现实 |
|---|---|
| raw 查询 401 Unauthorized | query 参数里的 : 必须 URL 编码（to%3Ajianshuo），不是 auth 问题，别去换 oauth1/oauth2 |
xurl block 报 code 34 |
block 端点已从 X API 移除（v2/v1.1 都不行），用 mute 替代，别反复试 |
| hide 报 "Invalid Request" | 该回复所在会话的根推文不是用户的（用户只是参与别人的串），串主才有权隐藏——记为 hide-failed，账号照样静音 |
| hide 报 429 | 限流约 50 次/15 分钟，等窗口刷新重跑脚本即可（状态文件保证幂等） |
| 纯文本 spam 漏网 | "我在济源呀" 这类同城话术靠隐形字符（U+034F/零宽符）混过滤器——脚本已检测，新变体出现时把特征加进 NAME_KW / INVISIBLE |
| 误伤真人 | emoji 启发式会扫进真人短评——这就是 borderline 名单存在的原因，必须人审 |
When NOT to use
- spam 超过 7 天：recent-search 接口只覆盖 7 天，更早的要用网页手动
- 用户要删自己发的推文：直接
xurl delete POST_ID - 用户要拉黑某个具体账号：API 做不到，告诉他网页操作（账号主页 ⋯ → Block）
State
state/cleaned.jsonl — 每条处理过的回复一行（id / author / status）。重跑跳过已处理；想重头来删掉此文件。