前言¶

改完稿子、交作业或发短文前，很多人会问一句：这段像不像 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