多平台违禁词检测

嘎——本鸭来了。一条文案要在好几个平台同时发，最怕的是：小红书过了、抖音挂了、公众号又被驳。 这个 Skill 的活儿很专一：拿一段文案，一次性比对多个平台的违禁词口径，让你在发布前就看清 「同一句话，在哪个平台风险最高」，再给你一版全平台都能落地的安全改写。

适合需要跨平台分发的自媒体作者、品牌运营、电商与 MCN 审核团队。

---

这个 Skill 怎么干活

核心是「同一文案 × 多平台并比」：

1. 收文案——用户把要发的文案给本鸭。
2. 逐平台检测——对 xiaohongshu、douyin、gongzhonghao 各调用一次都爆鸭接口 （默认三个全查，用户也可只指定其中几个）。
3. 风险对照——把各平台结果并排成一张表：平台 / 判定 / 风险类别 / 命中词 / 建议。
4. 统一改写——本鸭综合所有平台的命中词，给出一版改完即可全平台发布的安全文案。

注意：每个平台是一次独立计费调用。查三个平台 = 三次调用。用户只关心某几个平台时， 用 --platforms 缩小范围，省密钥额度。

---

拿钥匙（DOUBAOYA_API_KEY）

调用接口需要一把密钥（API Key）：

1. 打开 doubaoya.com → 登录。
2. 进入 密钥中心 → 点击 生成密钥。
3. 复制生成的密钥，形如 dyh_xxxxxxxxxxxx。

把密钥写进环境变量（脚本只从这里读，绝不会打印你的密钥）：

export DOUBAOYA_API_KEY=dyh_你的密钥

• macOS / Linux：把上面这行追加到 ~/.zshrc（zsh）或 ~/.bashrc（bash），再 source 一下让它长期生效。
• Windows：[Environment]::SetEnvironmentVariable("DOUBAOYA_API_KEY", "dyh_你的密钥", "User")，重开终端生效。
• 验证：echo $DOUBAOYA_API_KEY（macOS/Linux）或 echo %DOUBAOYA_API_KEY%（Windows）。

密钥安全铁律：密钥等同账号，绝不在对话、日志、报告里回显或粘贴。脚本设计上只读环境变量、从不输出 Key。

---

运行脚本

# 默认三平台全查
python3 scripts/check_multi.py "这款美白神器三天见效，全网最低价，无效退款"

# 只查指定平台（逗号分隔，省额度）
python3 scripts/check_multi.py "你的文案" --platforms xiaohongshu,douyin

• 零依赖，只用 Python 3 标准库，直接跑。
• 脚本对每个平台 POST 一次，把所有平台结果汇成一个 map 后以 JSON（ensure_ascii=False，缩进 2）打印。
• 单个平台失败不影响其它平台：失败的平台在 map 里记 error，其余照常返回。

---

接口契约

• 地址：POST https://doubaoya.com/api/apis/tool/check-banned-words/call
• 鉴权：请求头 Authorization: Bearer $DOUBAOYA_API_KEY
• 请求体（每个平台一次，参数严格如下）：

{ "platform": "xiaohongshu", "content": "<待检测文案>" }

platform 取值依次迭代："xiaohongshu"、"douyin"、"gongzhonghao"。

• 返回信封：

{
  "success": true,
  "requestId": "req_xxx",
  "data": {
    "source": "contentSafety.sensitiveWords",
    "content": "这款美白神器<span>三天见效</span>，<span>全网最低价</span>",
    "originalContent": "这款美白神器三天见效，全网最低价",
    "prohibitedWordsType": ["禁用词", "敏感词"],
    "raw": {}
  },
  "error": null
}

每次调用都先看 success：为 true 时读 data 里这五个字段（就这五个）； 为 false 时读 error.code / error.message。

字段	含义
originalContent	未标注的原文
content	标注版正文，命中处被 HTML 标签包裹——唯一能定位「哪几个词命中」的地方
prohibitedWordsType	命中的风险类别数组（类别名，不是命中词）
source / raw	来源标识与上游原始返回

🔴 接口不返回「风险等级」「命中词清单」「替换建议」这三类字段，别去读不存在的字段。

每个平台怎么判「有没有命中」

• 有命中：prohibitedWordsType 非空数组，或 content 与 originalContent 不相等（任一成立即算）。
• 确实没命中：拿到了 content 或 originalContent（证明检测跑过了），且上面两条都不成立。
• 没拿到结果：该平台条目里有 error，或 content 与 originalContent 都缺失/为 null。 🔴 这时该平台一律标「检测失败」，绝不能填成「合规」/「low」——漏报比误报危险得多， 读不到就如实说读不到，不替用户下合规结论。

---

错误处理

脚本逐平台处理 HTTPError / URLError，把错误写进对应平台条目并继续其它平台：

状态码	code	含义与处置
401	MISSING_API_KEY / UNAUTHORIZED	密钥缺失或无效。回 doubaoya.com → 密钥中心重新生成并配置环境变量。
400	VALIDATION_ERROR	参数有误，多为 platform 取值非法或 content 为空。
402	INSUFFICIENT_CREDITS	密钥额度不足。到 doubaoya.com 充值后再试。
502	PROVIDER_FAILED	上游暂时抖动，已自动退款，可安全重试。

---

输出模板

脚本返回的是 JSON map，本鸭须解析后填入下面的模板，禁止把原始 JSON 直接甩给用户。

1. 逐平台风险对照表

平台	判定	风险类别 (prohibitedWordsType)	命中词（从 content 的标注提取）	建议（本鸭给）
小红书	【命中 / 无命中 / 检测失败】	【类别，逗号分隔】	【命中词，逗号分隔】	【替换建议】
抖音	【…】	【…】	【…】	【…】
公众号	【…】	【…】	【…】	【…】

• 平台名用中文（小红书 / 抖音 / 公众号），便于阅读。
• 「判定」一列严格按上面判据填，三选一，不要自创风险等级——接口不回等级。
• 某平台走「没拿到结果」分支（有 error，或正文字段全缺）时，该行判定填检测失败并附 code／缺了哪个字段， 🔴 不许填「无命中」，也不许编造结果。
• 「建议」一列由本鸭结合上下文给出——接口不提供建议。
• 全平台均判定为「无命中」时，对照表照常列出，判定一列写「无命中」。

2. 全平台安全改写

综合所有平台的命中词与建议，给出一版改完即可在所有目标平台发布的文案：

【安全改写后的整段文案。要求：覆盖各平台所有命中词；语义通顺、语气与风格不变； 不加 emoji、不重写结构、不加引用或代码块，直接输出。改动处可加粗斜体标出。】

---

输出规则

1. 先出逐平台风险对照表，再出全平台安全改写，不输出开场白与结束语。
2. 脚本返回 JSON 后必须解析填模板，禁止直接输出原始 JSON。
3. 风险横向比较是本 Skill 的核心价值——务必让用户一眼看清「哪个平台命中最多、类别最重」。
4. 安全改写要同时满足所有平台口径：以命中最多的平台为基线消词。
5. 某平台失败时，照常输出其余平台结果，并在对照表标注该平台失败原因； 🔴 有平台检测失败时，末尾必须提示「该平台未完成检测，别当它通过」，不要写成全平台可发。
6. 全平台都判定为「无命中」时：对照表如实标注，安全改写处写「原文已可全平台发布，无需改动」。
7. 绝不回显 DOUBAOYA_API_KEY。

---

常见问答

Q：为什么查三个平台会扣三次额度？ A：每个平台是一次独立的违禁词检测调用，按平台计费。只想查某几个平台就用 --platforms 缩范围。

Q：提示 401 / 密钥无效？ A：确认 DOUBAOYA_API_KEY 已配置（echo $DOUBAOYA_API_KEY），密钥形如 dyh_…。 失效就到 doubaoya.com → 密钥中心 → 生成密钥，重新配置。

Q：某个平台报 502 怎么办？ A：PROVIDER_FAILED 是上游临时抖动，已自动退款，直接重试即可，不会重复扣费。

Q：数据会被保存吗？ A：文案通过 HTTPS 发送至都爆鸭后端完成匹配，脚本本地不持久化原文与结果。

关于响应里的 notice 字段

调用本 skill 对应的 doubaoya API 后，如果返回的 JSON 顶层出现 notice 字段，请把这句话原样转达给用户——这是关于本 skill 有更新的提示，不影响本次调用结果，不需要重试或改变行为。