fund-tracer/README.md

Fund Tracer - 电信诈骗资金追踪智能体

通过网页上传受害人手机 APP 账单截图，利用大模型多模态能力提取交易数据，自动汇总并可视化跨 APP 资金流向，支持案件管理、时间线分析、报告导出。

技术栈

• 后端: Python 3.11+ / FastAPI / SQLAlchemy / Pydantic
• 前端: React 18 + TypeScript / Ant Design / React Flow / Recharts
• 数据库: SQLite（可切换 PostgreSQL）
• LLM: 支持 OpenAI、Anthropic、DeepSeek 多模型切换
• 部署: Docker Compose

本地开发

后端

cd backend
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
# 配置 .env：OPENAI_API_KEY、ANTHROPIC_API_KEY、DEEPSEEK_API_KEY 等
uvicorn app.main:app --reload --port 8000

前端

cd frontend
npm install
npm run dev

浏览器访问 http://localhost:5173，API 代理到 http://localhost:8000。

环境变量示例（.env）

DATABASE_URL=sqlite+aiosqlite:///./fund_tracer.db
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=...
DEEPSEEK_API_KEY=...

Docker 部署

cp .env.example .env   # 编辑填入 API Key
docker compose up -d

• 前端: http://localhost:3000
• 后端 API: http://localhost:8000

功能概览

• 案件管理: 创建/编辑/删除案件，记录受害人信息
• 截图上传: 多图上传，自动调用 LLM Vision 提取交易
• 资金流向图: 以有向图展示账户间资金流动
• 时间线: 按时间顺序展示每笔交易
• 汇总表格: 交易明细筛选、排序
• 报告导出: Excel 明细、PDF 报告（含流向图与文字概述）

License

MIT