docs: 添加功能清单和 AI 审核 API 文档
- 新增 FEATURES.md 功能清单 - 新增 AI_AUDIT_API.md API 文档 - 记录所有已完成功能 - 记录 AI 审核测试结果
This commit is contained in:
209
AI_AUDIT_API.md
Normal file
209
AI_AUDIT_API.md
Normal file
@@ -0,0 +1,209 @@
|
||||
# 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)
|
||||
- ✅ 所有测试用例通过
|
||||
Reference in New Issue
Block a user