智慧监督AI文书写作服务

基于大模型的智能文书生成服务，支持从非结构化文本中提取结构化字段数据。

功能特性

• ✅ AI解析接口 (/api/ai/extract) - 从输入文本中提取结构化字段
• ✅ 字段配置管理 - 从数据库读取字段配置
• ✅ 支持硅基流动大模型（DeepSeek）
• 🔄 预留华为大模型接口支持
• ✅ Web测试界面 - 可视化测试解析功能

项目结构

.
├── app.py                 # Flask主应用
├── requirements.txt      # Python依赖
├── .env.example          # 环境变量配置示例
├── services/             # 服务层
│   ├── ai_service.py     # AI服务（大模型调用）
│   └── field_service.py  # 字段服务（数据库操作）
├── utils/                # 工具类
│   └── response.py       # 响应格式化
└── static/               # 静态文件
    └── index.html        # 测试页面

快速开始

1. 环境准备

Windows系统：

# 运行安装脚本
setup_env.bat

Linux/Mac系统：

# 运行安装脚本
chmod +x setup_env.sh
./setup_env.sh

手动安装：

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

2. 配置环境变量

复制 .env.example 为 .env 并填入配置：

# Windows:
copy .env.example .env

# Linux/Mac:
cp .env.example .env

编辑 .env 文件，填入你的API密钥：

# 硅基流动API配置（必需）
SILICONFLOW_API_KEY=your_api_key_here
SILICONFLOW_MODEL=deepseek-ai/DeepSeek-V3.2-Exp

# 数据库配置（已默认配置，如需修改可调整）
DB_HOST=152.136.177.240
DB_PORT=5012
DB_USER=finyx
DB_PASSWORD=6QsGK6MpePZDE57Z
DB_NAME=finyx

3. 启动服务

# 确保虚拟环境已激活
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# 启动服务
python app.py

服务启动后，访问：

• 测试页面: http://localhost:7500/
• API接口: http://localhost:7500/api/ai/extract

API接口说明

解析接口

接口地址: POST /api/ai/extract

请求参数:

{
    "businessType": "INVESTIGATION",
    "inputData": [
        {
            "fieldCode": "clue_info",
            "fieldValue": "被举报用户名称是张三，年龄30岁"
        },
        {
            "fieldCode": "target_basic_info_clue",
            "fieldValue": "张三，男，汉族，1980年5月出生，山西太原人"
        }
    ]
}

响应格式:

{
    "code": 0,
    "data": {
        "outData": [
            {
                "fieldCode": "target_name",
                "fieldValue": "张三"
            },
            {
                "fieldCode": "target_gender",
                "fieldValue": "男"
            }
        ]
    },
    "msg": "ok",
    "timestamp": "1764204337101",
    "errorMsg": "",
    "isSuccess": true
}

获取字段配置接口

接口地址: GET /api/fields?businessType=INVESTIGATION

响应格式:

{
    "code": 0,
    "data": {
        "input_fields": [...],
        "output_fields": [...]
    },
    "isSuccess": true
}

测试方法

方法1: 使用Web测试页面

1. 启动服务后，在浏览器访问 http://localhost:7500/
2. 在"输入数据"区域填写输入字段
3. 点击"开始解析"按钮
4. 查看解析结果

方法2: 使用curl命令

curl -X POST http://localhost:7500/api/ai/extract \
  -H "Content-Type: application/json" \
  -d '{
    "businessType": "INVESTIGATION",
    "inputData": [
      {
        "fieldCode": "clue_info",
        "fieldValue": "被举报用户名称是张三，年龄30岁，某公司总经理"
      }
    ]
  }'

方法3: 使用Python脚本

import requests

url = "http://localhost:7500/api/ai/extract"
data = {
    "businessType": "INVESTIGATION",
    "inputData": [
        {
            "fieldCode": "clue_info",
            "fieldValue": "被举报用户名称是张三，年龄30岁"
        }
    ]
}

response = requests.post(url, json=data)
print(response.json())

错误码说明

错误码	说明	处理建议
0	成功	-
400	请求参数错误	检查请求参数格式
1001	模板不存在	检查businessType是否正确
2001	AI解析超时	重新尝试解析
2002	字段识别失败	检查输入文本质量

开发说明

添加新的AI服务提供商

在 services/ai_service.py 中：

1. 在 __init__ 方法中添加配置读取
2. 在 _determine_ai_provider 中添加判断逻辑
3. 实现对应的 _extract_with_xxx 方法

扩展业务类型支持

在 services/field_service.py 中修改 get_output_fields_by_business_type 方法，根据不同的 business_type 返回对应的字段配置。

注意事项

1. API密钥安全: 请勿将 .env 文件提交到版本控制系统
2. 数据库连接: 确保数据库服务可访问
3. 网络连接: AI服务需要访问外部API，确保网络畅通
4. 字段配置: 当前仅支持"初步核实审批表"模板，其他模板需要先在数据库中配置

常见问题

Q: 提示"未配置AI服务"？ A: 检查 .env 文件中的 SILICONFLOW_API_KEY 是否已正确配置。

Q: 解析结果为空？ A: 检查输入文本是否包含足够的信息，可以尝试更详细的输入文本。

Q: 数据库连接失败？ A: 检查数据库配置和网络连接，确保数据库服务可访问。

许可证

内部项目，仅供内部使用。