前言¶
抖音口播、商品详情和直播话术往往在发布前才做合规检查。人工对照平台规则容易漏词，通用敏感词库又未必对齐抖音侧的审核口径。文案一旦踩到违禁或极限表述，常见后果是限流、下架或反复改稿。
下面介绍 SkillHub 社区 Skill「抖音违禁词检测」（@user_ebee0fcc/dy-prohibited-word）。它把检测、标注和替换建议放进 Agent 对话流程：你粘贴文案、上传文件或给出网页链接，由助手按 Skill 规程调用脚本，输出命中词、替换建议和仅替换违禁词后的成稿。
这是什么¶
抖音违禁词检测是面向抖音内容创作的 Agent Skill，坐标 @user_ebee0fcc/dy-prohibited-word，当前版本 1.0.3，来源为 SkillHub community，分类 content-creation，发布者为 user_ebee0fcc。SkillHub 页面标注 requires_api_key=true，检测能力依赖红狐 Hub（RedFox）API，需在环境中配置 REDFOX_API_KEY。
它解决的是：在抖音场景下，快速发现文案中的违禁词、给出可读的替换建议，并生成只改风险词的优化版本，减少「凭感觉改词」带来的二次风险。
核心功能¶
以下能力均来自 Skill 官方说明（SKILL.md）与包内脚本设计，检测平台固定为抖音，无需在调用时指定平台参数。
- 多形态输入：支持直接粘贴文案；上传 TXT、DOC、DOCX 等文本类文件；上传图片并仅提取图中文字；粘贴
https://网页链接并由 Playwright（必要时回退 BeautifulSoup）抓取正文。 - 违禁词标记：在原文中对命中词加粗显示，便于定位风险点。
- 替换建议：为每个违禁词提供结合上下文的替换词及更换理由（以检测 API 返回为准，Skill 要求不得编造结果）。
- 优化文案：输出仅替换违禁词后的完整文案，替换处加粗；无违禁词时仅提示合规，不输出后两个板块。
- 文件交付：检测完成后将纯文本优化稿写入
./抖音_优化文案_{随机6位数字}.txt供下载。 - 长文案策略：单次检测上限约 3000 字符；3000～10000 字可经用户选择分批检测并合并；超过 10000 字建议手动分批。英文单词内部子串误匹配有过滤；HTTP 请求失败时最多自动重试 3 次。
安装与启用¶
1. 安装 SkillHub CLI 并安装 Skill¶
若尚未安装 CLI，可先按 SkillHub 安装说明 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 安装到当前 Agent 的 skills 目录（须使用 --dir，否则默认 ./skills/ 可能不被识别）：
skillhub install @user_ebee0fcc/dy-prohibited-word --dir <你的 Agent skills 目录>
常见路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中让 AI 按 https://skillhub.cn/install/skillhub.md 安装 @user_ebee0fcc/dy-prohibited-word。
2. Python 与 Playwright 依赖¶
Skill 元数据声明的运行依赖如下，需在可执行脚本的环境中安装：
pip install python-docx==1.1.0 beautifulsoup4==4.12.3 playwright==1.58.0
playwright install chromium
要求 Python 3.8+。网页检测依赖 Chromium；若 Playwright 不可用，说明文档称会回退静态页面提取，其他输入形态仍可使用。
3. 配置 API Key¶
- 在红狐 Hub 注册并登录（官网：https://redfox.hk/ ，注册页：https://redfox.hk/login ）。
- 在个人中心获取 API Key，格式为
ak_xxxxxxxx。 - 写入环境变量
REDFOX_API_KEY（脚本通过X-API-KEY请求头携带）：
export REDFOX_API_KEY=ak_xxxxxxxx
长期生效可写入 ~/.bashrc 或 ~/.zshrc 后 source 对应文件。
典型用法¶
安装并配置密钥后，在 Agent 中用自然语言触发即可；Skill 会在命中「抖音违禁词」「限流词」「脚本合规」等表述或你明确要求检测抖音文案时激活。助手应先阅读包内 references/core_workflow.md，再调用 scripts/check_sensitive_words.py。
粘贴文案（官方示例表述）：
帮我看下这段抖音脚本有没有违禁词：这款美白神器真的太有效了，用了三天就白了一个度
上传文档：
[上传 script.docx] 帮我检查这个文档
图片 OCR 后检测：
[上传字幕截图.png] 检测图片里的文字有没有违禁词
网页抓取后检测：
帮我检测这个网页 https://example.com/article
脚本参数约定：--content、--file、--url 三者互斥，每次只传一种；长文案会先走字数闸门，必要时暂停并等待你回复 1（仅前 3000 字）、2（分批全量）或 3（取消）。
成功时输出顺序固定为三块：违禁词检测结果 → 修改建议（表格）→ 建议优化文案，随后交付 txt 文件。
适用场景与注意¶
适合谁：短视频编导、电商运营、直播话术策划、需要在抖音发布前做文案合规自查的团队。
使用上需注意：
- 检测结果以远程 API 返回为准，Skill 明确禁止助手臆造违禁词或替换项。
- 文案经 HTTPS 发送至检测服务匹配，Skill 说明不在本地持久存储；涉及未公开内容时请自行评估合规与保密要求。
- 不支持 PDF，需先转为文本或图片；单次 3000 字上限与 10000 字分批策略需遵守，避免超长一次性硬跑。
- Playwright 与 pip 依赖需提前装好，否则文件/网页链路可能降级或失败。
SkillHub 统计（以页面抓取为准）：评分 100000，下载 1817 次；与部分摘要中的历史数字可能不一致，以 SkillHub 页面为准。
结尾¶
「抖音违禁词检测」把抖音侧的违禁词扫描、加粗标注、替换建议和成稿输出收敛进一套 Agent Skill 工作流，适合在写稿与发布之间的最后一道文本筛查。安装、依赖与 API Key 配置完成后，用粘贴、文件、图片或链接即可复用同一套规程。
官方 Skill 页：https://www.skillhub.cn/skills/user_ebee0fcc/dy-prohibited-word
Skill 坐标页：https://api.skillhub.cn/user_ebee0fcc/dy-prohibited-word
