openclaw/1227323804/hj-check-test

错敏信息检测 API (Sensitive Content Detection)

一个基于 FastAPI 的错敏信息检测服务，用于检测文本中的敏感词、错别字和规范表述问题。

功能特性

• 敏感词检测：识别文本中的敏感词汇
• 错别字检测：发现拼写错误和输入错误
• 规范表述检测：检查专用表述是否符合规范
• RESTful API：简单的 HTTP 接口调用
• 详细日志记录：完整的请求/响应日志

快速开始

环境要求

• Python 3.11+
• pip

安装依赖

pip install -r requirements.txt

启动服务

python main.py

服务将在 http://localhost:8080 启动。

API 接口

检测接口

请求

POST /api/safeguard/check
Content-Type: application/json

请求参数

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | userKey | string | 是 | 用户密钥 | | content | string | 是 | 待检测的文本内容 | | sensitiveCodeList | array | 否 | 指定检测的错敏类型 |

请求示例

{
  "userKey": "your-user-key",
  "content": "这是一段需要检测的文本"
}

响应示例

{
  "code": 0,
  "message": "ok",
  "content": [
    {
      "sentencePos": 0,
      "termPos": 0,
      "wrongTerm": "错误的词",
      "expectTerms": ["正确的词"],
      "errLevel": 3,
      "type": 3,
      "newType": "A0200E01",
      "explain": "错误说明",
      "sentence": "错误词所在句子",
      "newTypeMeaning": "错误类型含义"
    }
  ]
}

响应字段说明

| 字段 | 类型 | 说明 | |------|------|------| | code | number | 响应码，0表示成功，1表示失败 | | message | string | 响应消息 | | content | array | 检测到的问题列表 |

其他接口

| 接口 | 方法 | 说明 | |------|------|------| | / | GET | 服务信息 | | /health | GET | 健康检查 | | /docs | GET | API 文档（Swagger UI） |

配置说明

环境变量

| 变量 | 默认值 | 说明 | |------|--------|------| | PORT | 8080 | 服务监听端口 | | SAFEGUARD_API_URL | https://safeguard-pre.ucap.com.cn/... | 上游API地址 | | API_TIMEOUT | 30 | API请求超时时间（秒） |

日志

日志文件位于 logs/app.log，记录了：

• 服务启动/关闭信息
• 每个请求的详细信息
• 上游API调用情况
• 错误和异常信息

使用示例

cURL

curl -X POST "http://localhost:8080/api/safeguard/check" \
  -H "Content-Type: application/json" \
  -d '{
    "userKey": "your-key",
    "content": "待检测文本"
  }'

Python

import requests

response = requests.post(
    "http://localhost:8080/api/safeguard/check",
    json={
        "userKey": "your-key",
        "content": "待检测文本"
    }
)
print(response.json())

JavaScript

fetch("http://localhost:8080/api/safeguard/check", {
  method: "POST",
  headers: {"Content-Type": "application/json"},
  body: JSON.stringify({
    userKey: "your-key",
    content: "待检测文本"
  })
})
.then(res => res.json())
.then(data => console.log(data));

项目结构

python-app/
├── main.py          # 主应用文件
├── models.py        # 数据模型定义
├── client.py        # HTTP客户端（已废弃）
├── service.py       # 业务服务（已废弃）
├── requirements.txt # 依赖清单
├── .env            # 环境变量配置
├── logs/           # 日志目录
│   └── app.log     # 应用日志
└── SKILL.md        # 本文件

许可证

MIT License