# AuditLens

**Repository Path**: reepu/auditlens

## Basic Information

- **Project Name**: AuditLens
- **Description**: AuditLens（审计透镜） 是一款基于 LiteParse、LangChain 与 Milvus 构建的开源智能审计引擎。项目专为海量项目材料处理而生，采用高度解耦的架构设计，支持用户自由接入任意大模型 API。只需通过自定义提示词（Prompt），即可将非结构化的复杂文档转化为精准的审计洞察，让 AI 审计工作流的搭建变得前所未有的灵活与高效。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AuditLens 审计透镜

> 基于 LiteParse + LangChain + Milvus 的开源智能审计引擎

## 项目简介

AuditLens 是一款专为海量项目材料处理而生的智能审计引擎。采用高度解耦的架构设计，支持用户自由接入任意大模型 API。只需通过自定义提示词（Prompt），即可将非结构化的复杂文档转化为精准的审计洞察。

### 核心特性

| 特性 | 说明 |
|------|------|
| **文档解析** | 基于 LiteParse，支持 PDF/DOCX/XLSX/PPTX/图片，内置 OCR |
| **LLM 编排** | 基于 LangChain，支持 OpenAI 兼容接口（通义/智谱/DeepSeek 等） |
| **向量检索** | 基于 Milvus，高效语义检索，RAG 增强生成 |
| **提示词驱动** | 自定义审计提示词模板，灵活定义审计视角 |
| **高度解耦** | LLM / 解析器 / 向量库 / 嵌入模型均可插拔替换 |
| **异步处理** | Celery 异步任务队列，支持海量文档批量处理 |

### 技术栈

| 层级 | 技术 |
|------|------|
| API 框架 | FastAPI + Uvicorn |
| ORM | SQLAlchemy 2.0 (async) + Alembic |
| 文档解析 | LiteParse (Rust + PDFium) |
| LLM 编排 | LangChain |
| 向量数据库 | Milvus |
| 元数据库 | PostgreSQL |
| 缓存/队列 | Redis + Celery |
| 对象存储 | MinIO |
| 部署 | Docker Compose |

## 快速开始

### 1. 环境准备

```bash
# 复制环境变量模板
cp .env.example .env

# 编辑 .env，配置 LLM API Key 等参数
vim .env
```

### 2. 启动服务

```bash
# 构建并启动所有服务
make up

# 或手动启动
docker compose up -d
```

### 3. 初始化数据库

```bash
make migrate
```

### 4. 访问服务

| 服务 | 地址 |
|------|------|
| API 文档 (Swagger) | http://localhost:8000/docs |
| MinIO 控制台 | http://localhost:9001 |
| Milvus | localhost:19530 |

## API 概览

| 接口 | 方法 | 说明 |
|------|------|------|
| `/api/v1/projects` | GET/POST | 审计项目管理 |
| `/api/v1/documents/project/{id}/upload` | POST | 上传文档 |
| `/api/v1/audit` | POST | 创建审计任务 |
| `/api/v1/prompts` | GET/POST | 提示词模板管理 |
| `/api/v1/llm-configs` | GET/POST | LLM 配置管理 |

## 项目结构

```
auditlens/
├── docker-compose.yml          # 服务编排
├── .env.example                # 环境变量模板
├── Makefile                    # 快捷命令
│
├── docker/                     # Docker 构建文件
│   ├── api/Dockerfile
│   └── worker/Dockerfile
│
├── backend/                    # 后端主项目
│   ├── pyproject.toml
│   ├── alembic.ini
│   ├── alembic/                # 数据库迁移
│   ├── app/
│   │   ├── main.py             # FastAPI 入口
│   │   ├── config.py           # 全局配置
│   │   ├── api/v1/             # API 路由
│   │   ├── core/               # 核心引擎（解耦设计）
│   │   │   ├── llm/            # LLM 适配器（可插拔）
│   │   │   ├── parser/         # 文档解析器
│   │   │   ├── vectorstore/    # 向量存储
│   │   │   ├── embedding/      # 嵌入模型
│   │   │   └── chain/          # LangChain 链
│   │   ├── models/             # ORM 数据模型
│   │   ├── schemas/            # Pydantic 模型
│   │   ├── services/           # 业务逻辑
│   │   ├── tasks/              # Celery 异步任务
│   │   ├── prompts/            # 预置审计提示词
│   │   └── utils/
│   └── tests/
│
├── data/                       # 数据存储（gitignore）
└── docs/                       # 项目文档
```

## 架构设计

核心数据流：

```
文档上传 → LiteParse 解析 → 文本分块 → Embedding 向量化 → Milvus 存储
                                                              ↓
用户定义审计提示词 → 审计任务触发 → RAG 检索相关文档块 → LLM + 自定义提示词 → 审计洞察
```

### 解耦设计

每个核心组件都有抽象基类 + 工厂模式，支持独立替换：

- **LLM**: `BaseLLMAdapter` → OpenAI / Anthropic / 自定义
- **解析器**: `BaseParser` → LiteParse / 自定义
- **向量库**: `BaseVectorStore` → Milvus / 自定义
- **嵌入模型**: `BaseEmbedding` → OpenAI / 自定义

## License

MIT