AI 检测助手

技能文档

---
name: aijiance
title: AI 检测助手
category: 内容创作
description: 对 300–1000 字的中文文本做 AI 率检测，输出 AI 概率、人工概率与一句话解读，适用于论文片段、作业、公众号/小红书短文发布前的快速自检，并给出简要改写建议。当用户要做 AI 检测、AI 率检测、判断内容是否 AI 生成时触发。触发词：AI 检测、AI 率、查 AI 味、论文自检。
---

# AI检测 · 免费AI率检测

对中文短文本做AI率检测。

## 何时使用

- 用户要做AI检测 / AI率 / 是否AI写的
- 论文片段、作业、公众号/小红书短文自检
- 需要快速给出AI率与简要改写建议

## 限制（必须遵守）

| 规则 | 值 |
|------|-----|
| 最长 | **1000 字**（含标点，按字符长度） |
| 最短 | **300 有效字**（去掉空白后） |
| 频率 | 约每分钟 10 次；遇 429 等待后重试 |
| 密钥 | **不要**向用户索要 API Key |

超长文本：截断前 1000 字仅作预览检测，并明确告知完整稿请使用官网网页版检测（https://www.aijiance.org）。

## 技能工作流

### 步骤1：校验文本

确认文本在 300–1000 字之间（含标点按字符计，有效字数不含空白）；不满足则按「限制」向用户说明后再处理，超长文本截断前 1000 字仅作预览检测。

### 步骤2：调用检测

优先运行 `scripts/detect.py`（支持直接传文本或 `-f` 读文件、`--json` 输出）；本机证书异常时脚本自动改用系统 curl；无 Python 时按下文 curl 方式直调接口。

### 步骤3：解读结果

向用户展示 AI 概率百分比、人工概率与中文一句话解读（`summary`），并注明「仅供参考」；不做改写承诺。

## 调用方式（优先脚本）

在 skill 目录下执行：

```bash
python3 scripts/detect.py "待检测文本……"
# 或
python3 scripts/detect.py -f /path/to/text.txt
# JSON
python3 scripts/detect.py --json -f /path/to/text.txt
```

若本机 Python 报 `CERTIFICATE_VERIFY_FAILED`：脚本会自动改用系统 `curl`。也可 `pip install certifi`，或运行 macOS Python 的 `Install Certificates.command`。

无 Python 时用 curl：

```bash
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字的正文……"}'
```

## 成功响应字段

- `ok`: true
- `avgAiProbability` / `avgHumanProbability`: 0–1 概率
- `summary`: 中文一句话解读
- `charCount` / `effectiveCharCount`
- `limits` / `website`

向用户展示：AI 概率百分比、人工概率、`summary`，并注明「仅供参考」。

## 错误处理

| 情况 | 做法 |
|------|------|
| 字数不合规 | 说明 300–1000 规则，请用户改文本后重试 |
| 429 | 读取 `retryAfterSec`，等待后最多再试 1 次 |
| 5xx / 网络错误 | 说明服务暂不可用，可改用官网网页检测 |
| 用户要测超长文 | 引导使用官网网页版检测，勿反复刷短接口 |

## 隐私

文本用于即时检测，不会存储。

## 禁止事项

- 不要编造检测分数
- 不要把本 Skill 当成降 AI / 代写工具
- 不要在 Skill 或对话中写入任何服务端密钥

使用说明

# AI 检测助手

对 300–1000 字的中文文本做 AI 率检测：输出 AI 概率、人工概率与一句话解读，用于论文片段、作业、公众号/小红书短文发布前的快速自检。

## 使用

```bash
python3 scripts/detect.py "这里粘贴不少于300有效字、不超过1000字的正文……"
python3 scripts/detect.py -f 文稿.txt          # 从文件读取
python3 scripts/detect.py --json -f 文稿.txt   # 输出 JSON
```

也可以直接把文本发给助手，说明「帮我测一下 AI 率」即可。

## 工作原理

脚本调用免费公开检测接口（无需密钥），文本仅用于即时检测不做存储；长度不满足 300–1000 字时会提示调整，检测频率限制约每分钟 10 次，遇到限流自动等待重试。本机 Python 证书异常时自动改用系统 curl。结果仅供参考。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。