前言¶

改完稿子、交作業或發短文前，很多人會問一句：這段像不像 AI 寫的？單獨打開網頁檢測可以，但在 Cursor、Claude Code 等帶 Skills 的環境裏，更省事的做法是讓 Agent 在對話裏直接調用檢測能力。下面介紹 SkillHub 上的 AI率檢測助手（@user_34343d1f/ailv-aijiance）：面向中文短文本的免費 AI 率檢測，通過腳本或 HTTP 調用 aijiance.org 的 Skill 接口，把概率和一句話解讀帶回對話，無需自行配置 API Key。

這是什麼¶

AI率檢測助手 是社區來源（community）的 Agent Skill，當前版本 1.0.1，發佈座標 @user_34343d1f/ailv-aijiance，分類爲 content-creation。SkillHub 頁面標註作者爲 Robin；簡介關鍵詞包括 AI 率檢測、AI 檢測、中文 AI 免費檢測。標籤 requires_api_key=false，表示使用側不需要向用戶索要密鑰。

它解決的是：在 Agent 會話中，當用戶提到 AI 檢測、AI 率、AI 痕跡或機器寫作痕跡，需要對論文片段、作業或自媒體短文做快速自檢時，按統一規則調用檢測服務並解釋結果，而不是讓模型憑感覺「猜」一個分數。

核心功能¶

依據 Skill 包內 SKILL.md 與腳本，已覈實能力如下：

1. 中文短文本 AI 率檢測：調用 https://www.aijiance.org/api/skill/detect，返回 AI / 人工概率及中文 summary。
2. 本地腳本入口：在 Skill 目錄執行 scripts/detect.py，支持直接傳字符串、讀文件、輸出 JSON。
3. 無 Key 設計：Skill 明確要求不要向用戶索要 API Key，也不要在對話或 Skill 中寫入服務端密鑰。
4. 結果字段：成功時包含 avgAiProbability、avgHumanProbability（0–1）、summary、charCount、effectiveCharCount、limits、website 等；向用戶展示時需註明「僅供參考」。
5. 錯誤與限流：字數不合規時提示規則；HTTP 429 時按 retryAfterSec 等待後最多再試一次；5xx 或網絡錯誤時建議改用官網網頁檢測。

安裝與啓用¶

先確認本機是否已有 SkillHub CLI：

command -v skillhub && skillhub --version

未安裝時可僅安裝 CLI（完整安裝腳本見 SkillHub 安裝說明）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安裝 Skill 時須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。常見路徑示例：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝命令：

skillhub install @user_34343d1f/ailv-aijiance --dir ~/.cursor/skills/

將 ~/.cursor/skills/ 換成你當前環境對應的目錄即可。也可把 SkillHub 頁面上的安裝提示發給 Agent：按 https://skillhub.cn/install/skillhub.md 安裝 @user_34343d1f/ailv-aijiance。

典型用法¶

在對話中觸發¶

當用戶要求檢測 AI 率、判斷是否 AI 生成，或需要對短文自檢時，Agent 應加載本 Skill，並遵守字數與頻率限制（見下一節）。超長全文應引導至官網，而不是反覆刷短接口。

命令行檢測（Skill 目錄內）¶

在已安裝的 Skill 目錄下執行：

python3 scripts/detect.py "待檢測文本……"

從文件讀取：

python3 scripts/detect.py -f /path/to/text.txt

需要結構化結果時：

python3 scripts/detect.py --json -f /path/to/text.txt

若本機 Python 出現 CERTIFICATE_VERIFY_FAILED，腳本會嘗試改用系統 curl；也可安裝 certifi 或按 macOS Python 文檔處理證書。

無 Python 時可直接請求 API：

curl -sS -X POST "https://www.aijiance.org/api/skill/detect" \
  -H "Content-Type: application/json" \
  -H "X-Skill-Client: aijiance-detect" \
  -d '{"text":"這裏粘貼不少於300有效字、不超過1000字的正文……"}'

向用戶彙報時：將 avgAiProbability 等轉爲百分比，附上 summary，並說明結果僅供參考。

適用場景與注意¶

適合誰

• 需要在 Agent 工作流裏對中文短稿做 AI 率快速自檢的寫作者、學生或運營。
• 希望檢測邏輯與展示格式由 Skill 約束，避免模型編造分數的場景。

硬性限制（Skill 要求必須遵守）

超過 1000 字：可截斷前 1000 字僅作預覽檢測，並明確告知完整稿請打開 https://www.ailv.run/ 。Skill 說明文本會發往檢測服務做即時分析，並聲明不會存儲。

不應期待的能力

• 本 Skill 不是降 AI 率或代寫工具；禁止編造檢測分數。
• 超長論文、全書級稿件應使用官網 ailv.run，而非依賴免費短文本接口。

SkillHub 公開頁當前顯示評分 100000、下載 4707 次（以頁面展示爲準，會隨時間變化）。

結尾¶

AI率檢測助手 把中文短文本 AI 率檢測嵌進 Agent Skills：免 API Key、有字數與限流邊界、腳本與 curl 雙路徑可復現。若你的場景是「在 IDE 裏改完一段話就想知道 AI 痕跡」，安裝 @user_34343d1f/ailv-aijiance 即可按 Skill 規範調用。

• Skill API 地址：https://api.skillhub.cn/user_34343d1f/ailv-aijiance
• SkillHub 詳情頁：https://www.skillhub.cn/skills/user_34343d1f/ailv-aijiance