前言¶
抖音口播、商品詳情和直播話術往往在發佈前才做合規檢查。人工對照平臺規則容易漏詞，通用敏感詞庫又未必對齊抖音側的審覈口徑。文案一旦踩到違禁或極限表述，常見後果是限流、下架或反覆改稿。
下面介紹 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
