chengshishouce/AI_AUDIT_API.md

# AI 审核 API 文档

## 概述

AI 审核模块提供自动内容审核功能，支持文章、评论、特色服务的自动审核。

## 功能特性

- ✅ 敏感词检测
- ✅ 广告内容检测
- ✅ 内容质量评估
- ✅ 自动审核决策

## API 端点

### 1. 审核文章

**端点**: `POST /api/audit/article/`

**认证**: 需要 JWT Token

**请求体**:
```json
{
  "title": "文章标题",
  "content": "文章内容"
}
```

**响应**:
```json
{
  "approved": true,
  "reason": "审核通过",
  "details": {
    "quality_score": 100
  }
}
```

**拒绝示例**:
```json
{
  "approved": false,
  "reason": "内容包含敏感词：暴力",
  "details": {
    "sensitive_words": ["暴力"]
  }
}
```

---

### 2. 审核评论

**端点**: `POST /api/audit/comment/`

**认证**: 需要 JWT Token

**请求体**:
```json
{
  "content": "评论内容"
}
```

**响应**:
```json
{
  "approved": true,
  "reason": "审核通过"
}
```

---

### 3. 审核特色服务

**端点**: `POST /api/audit/service/`

**认证**: 需要 JWT Token

**请求体**:
```json
{
  "name": "服务名称",
  "description": "服务描述"
}
```

**响应**:
```json
{
  "approved": true,
  "reason": "审核通过"
}
```

---

### 4. 审核服务状态

**端点**: `GET /api/audit/status/`

**认证**: 需要 JWT Token

**响应**:
```json
{
  "status": "active",
  "service": "AI Audit Service",
  "version": "1.0.0",
  "features": [
    "敏感词检测",
    "广告检测",
    "内容质量评估"
  ]
}
```

---

## 测试用例

| 测试 | 输入 | 预期结果 | 状态 |
|------|------|----------|------|
| 文章审核 (正常) | 北京旅游攻略 | ✅ 通过 | ✅ |
| 文章审核 (敏感词) | 包含暴力内容 | ❌ 拒绝 | ✅ |
| 评论审核 (广告) | 加微信 123456 | ❌ 拒绝 | ✅ |
| 服务审核 (正常) | 老北京烤鸭店 | ✅ 通过 | ✅ |
| 内容质量 (太短) | 好 | ❌ 拒绝 | ✅ |

---

## 敏感词库

当前敏感词库包含：
- 暴力、恐怖、色情、赌博、毒品
- 诈骗、传销、假币、枪支、弹药

## 广告关键词

- 加微信、QQ 群、联系电话、手机号
- www.、.com、.cn、http

## 内容质量规则

- 最小长度：10 个字符
- 重复字符检测
- 中文内容比例检查

---

## 集成示例

### Python 示例

```python
import requests

TOKEN = 'your_jwt_token'
HEADERS = {
    'Authorization': f'Bearer {TOKEN}',
    'Content-Type': 'application/json'
}

# 审核文章
response = requests.post(
    'http://cssc.datalibstar.com/api/audit/article/',
    headers=HEADERS,
    json={
        'title': '北京旅游攻略',
        'content': '北京是中国的首都...'
    }
)
result = response.json()
print(result['approved'])  # True/False
```

### JavaScript 示例

```javascript
const TOKEN = 'your_jwt_token';

// 审核文章
fetch('http://cssc.datalibstar.com/api/audit/article/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${TOKEN}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: '北京旅游攻略',
    content: '北京是中国的首都...'
  })
})
.then(res => res.json())
.then(data => {
  console.log(data.approved);  // True/False
});
```

---

## 部署状态

- ✅ 本地开发环境
- ✅ 云服务器 (cssc.datalibstar.com)
- ✅ 所有测试用例通过