# 造浪2025AIAgent创新赛

**Repository Path**: water-sybil/AgentCompetition

## Basic Information

- **Project Name**: 造浪2025AIAgent创新赛
- **Description**: 造浪2025AIAgent创新赛 作品提交仓
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 23
- **Created**: 2025-12-22
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智能合同审查Agent

## 🌟 项目概述

智能合同审查系统是一款基于Web的合同智能审查应用，利用AI技术和关键字匹配算法，为用户提供便捷的合同风险识别和分析服务。系统支持多种文档格式（PDF、Word、TXT、图片等）的上传和解析，并能识别合同中的潜在风险点，如高额违约金、争议解决条款、知识产权归属等问题。

项目采用前后端分离架构，前端使用原生HTML/CSS/JavaScript构建，后端采用Python FastAPI框架，结合LazyLLM框架接入大语言模型，提供智能化的合同分析能力。

![image](https://gitee.com/want595/markdown-images/raw/master/images/207/3/2025/12/22/2025122213453488792.png)


## 💼 应用场景与商业价值

在企业日常运营中，合同管理是一项重要而复杂的工作。本系统可以帮助企业和个人：

1. **提高审查效率**：自动化识别合同风险，大幅减少人工审查时间
2. **降低法律风险**：及时发现合同中的潜在问题，避免经济损失
3. **标准化审查流程**：建立统一的合同审查标准，提升业务规范性
4. **节约人力成本**：减少对专业法务人员的依赖，降低企业运营成本

## ✨ 核心功能

1. **多格式文档支持**：支持PDF、DOC、DOCX、TXT、PNG、JPG、JPEG等多种格式的合同文档上传和解析
2. **智能风险识别**：基于预定义的风险关键词库，自动识别合同中的潜在风险点
3. **大语言模型分析**：集成DeepSeek-V3大语言模型，提供自然语言形式的合同分析和建议
4. **可视化界面**：直观的Web界面展示审查结果，包括风险统计和详细说明
5. **流式响应**：支持流式输出大模型分析结果，提供更好的用户体验

## 🎯 技术亮点

- **多格式文档解析**：支持PDF、Word、TXT、图片等多种文档格式的解析
- **OCR文字识别**：集成Tesseract OCR引擎，支持图片类合同文档的文字提取
- **关键字匹配算法**：基于正则表达式的智能风险识别算法
- **大语言模型集成**：通过LazyLLM框架接入DeepSeek-V3大语言模型
- **流式响应处理**：支持大模型输出的流式传输，实现实时响应效果
- **现代化Web技术**：采用原生HTML/CSS/JavaScript构建前端界面

## 📁 项目结构

```
contract_review/
├── contracts/               # 上传的合同文件存储目录
├── contract_llm.py          # 大语言模型集成模块
├── contract_review_mcp.py   # 合同审查核心逻辑模块
├── web_server.py            # Web服务主程序
├── index.html               # 前端界面文件
├── requirements.txt         # Python依赖包列表
├── contract_review_server.log  # 运行日志文件
└── README.md                # 项目说明文档
```

## 🔧 部署说明

### 环境要求

- Python >= 3.8
- pip包管理器
- LazyLLM框架
- Tesseract OCR引擎（用于图片文字识别）

### 快速开始

#### 1. 安装依赖

```bash
# 安装LazyLLM库
pip install lazyllm

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

```

#### 2. 配置环境变量

```bash
# 设置LazyLLM服务的API密钥（在商汤大模型平台获取）
export LAZYLLM_SENSENOVA_API_KEY=your_api_key_here
```

#### 3. 启动服务

```bash
# 启动Web服务
python web_server.py
```

#### 4. 访问应用

打开浏览器访问 `http://localhost:8001`

## 🛠️ 技术栈

![image](https://gitee.com/want595/markdown-images/raw/master/images/207/4/2025/12/22/2025122213472418938.png)



### 后端

- Python 3.8+
- FastAPI（Web框架）
- LazyLLM框架
- DeepSeek-V3大语言模型
- PyMuPDF（PDF解析）
- python-docx（Word文档解析）
- Pillow + pytesseract（图像OCR）

### 前端

- HTML5
- CSS3
- JavaScript ES6+
- Font Awesome（图标库）

### 第三方服务

- LazyLLM服务（Sensenova）
- Tesseract OCR（光学字符识别）

## 📱 使用指南

1. **上传合同文件**：
   - 点击"上传合同文件"区域或拖拽文件到该区域
   - 支持PDF、DOC、DOCX、TXT、PNG、JPG、JPEG格式
   - 选择文件后点击"开始审查"按钮

2. **查看审查结果**：
   - 左侧面板显示风险统计（高、中、低风险数量）
   - 右侧详细列出发现的风险项及其描述和建议
   - 中间面板显示大语言模型的智能分析结果

3. **重新审查**：
   - 点击"清除文件"按钮可重新上传新合同
   - 系统支持连续审查多个合同文件

## 📡 API接口文档

### 上传文件
```
POST /upload
Content-Type: multipart/form-data

参数:
- file: 合同文件

返回:
{
  "filename": "文件名",
  "file_path": "文件存储路径",
  "message": "文件上传成功"
}
```

### 审查合同
```
POST /review
Content-Type: application/json

参数:
{
  "file_path": "文件存储路径"
}

返回:
{
  "risks": [
    {
      "category": "风险类别",
      "severity": "风险等级(高/中/低)",
      "location": "风险位置上下文",
      "description": "风险描述",
      "suggestion": "修改建议"
    }
  ],
  "summary": "总体评估",
  "total_risks_found": 风险总数
}
```

### 审查合同并使用大模型分析
```
POST /review_with_llm
Content-Type: application/json

参数:
{
  "file_path": "文件存储路径"
}

返回:
{
  "review_result": { /* 关键字匹配审查结果 */ },
  "llm_analysis": "大语言模型分析结果"
}
```

### 审查合同并流式返回大模型分析
```
POST /review_with_llm_stream
Content-Type: application/json

参数:
{
  "file_path": "文件存储路径"
}

返回:
文本流（大语言模型分析结果）
```

## � 常见问题

1. **上传文件后没有反应**：
   - 检查文件格式是否受支持
   - 查看浏览器控制台是否有错误信息
   - 确认后端服务是否正常运行

2. **大模型分析结果为空**：
   - 检查LAZYLLM_SENSENOVA_API_KEY环境变量是否正确设置
   - 确认网络连接是否正常
   - 查看contract_review_server.log日志文件

3. **图片文件无法识别文字**：
   - 确认已正确安装Tesseract OCR引擎
   - 检查图片质量是否足够清晰
   - 尝试调整图片对比度和亮度

4. **响应速度慢**：
   - 大语言模型分析需要一定时间，请耐心等待
   - 检查网络连接状况
   - 确认服务器资源配置是否充足

## 📄 许可证

本项目仅供学习和参考使用，未经许可，禁止任何形式的商业使用。

## 💡 总结

智能合同审查系统结合了传统的关键字匹配技术和先进的大语言模型能力，为企业和个人提供了一套完整的合同风险识别解决方案。通过自动化和智能化的手段，大幅提升了合同审查的效率和准确性，具有广泛的实用价值和商业前景。