ilovezerotwo02/ElderGuard

# ElderGuard - 老年人反欺诈保护系统 [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://fastapi.tiangolo.com/) 一个旨在保护老年人免受诈骗的智能反欺诈检测系统。支持中文和英文双语检测，提供基于规则的引擎，并可通过 Ollama 或 OpenAI 进行 AI 增强。 ## 功能特性 - **开箱即用**：无需 AI 模型即可立即使用，基于预定义规则进行检测 - **双语检测**：支持中文和英文欺诈检测 - **多模型支持**：兼容本地 Ollama 和云端 OpenAI AI 模型 - **网页配置界面**：基于浏览器的界面用于配置检测模式 - **老年人友好 UI**：大字体、简洁布局、操作简单 - **多模态检测**：支持 URL、短信、电话和语音分析 - **实时告警**：分级风险警告，提供清晰建议 - **API 文档**：Swagger 文档自动生成，位于 /docs ## 快速开始 ### 安装 1. 克隆并进入仓库： ``` git clone https://github.com/ilovezerotwo02/ElderGuard.git cd ElderGuard ``` 2. 安装依赖： ``` pip install -r requirements.txt ``` 或者在 Windows 上，直接双击 `install_dependencies.bat`。 3. 初始化数据库并启动： ``` python scripts/init_db.py python run.py ``` 或者在 Windows 上，双击 `start.bat`。 4. 在浏览器中打开 http://localhost:8000。 | 页面 | URL | 描述 | |------|------|------| | 检测 | http://localhost:8000 | 主检测界面 | | 配置 | http://localhost:8000/config | 配置 AI 模型 | | API 文档 | http://localhost:8000/docs | 交互式 API 文档 | ## 配置 ### 检测模式 ElderGuard 支持三种模式： **1. 规则检测模式（默认，免费）** 无需设置。开箱即用，支持中文和英文欺诈模式预定义规则。 **2. Ollama 本地 AI（免费，注重隐私）** ``` USE_RULES_ONLY=False USE_OLLAMA=True OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL_NAME=qwen2.5:7b ``` 请参阅 [docs/OLLAMA_GUIDE.md](docs/OLLAMA_GUIDE.md) 获取安装说明。 **3. OpenAI API（付费，更高精度）** ``` USE_RULES_ONLY=False USE_OLLAMA=False OPENAI_API_KEY=sk-your-api-key OPENAI_API_BASE=https://api.openai.com/v1 LLM_MODEL_NAME=gpt-3.5-turbo ``` ### 网页配置 1. 启动服务 2. 访问 http://localhost:8000/config 3. 选择检测模式 4. 填写必要字段并保存 ### 手动配置 ``` cp .env.example .env ``` 使用你偏好的设置编辑 `.env` 文件。 ## 检测能力 ### URL 分析 - 钓鱼和恶意域名检测 - HTTPS 安全验证 - 可疑关键词和模式匹配 - TLD 黑名单和域名信誉检查 ### 短信分析 - 欺诈关键词检测（中文 + 英文） - 常见诈骗格式的正则表达式匹配 - 情感和紧急性分析 - 实体提取（电话号码、链接、金额、银行卡） - 欺诈类型分类 ### 电话分析 - 使用与短信分析相同的检测引擎 - 支持中文和英文内容 - 语音 AI 合成检测（框架已就绪） ## 项目结构 ``` ElderGuard/ ├── app/ # Backend code │ ├── main.py # FastAPI entry point │ ├── api/ # API routes │ ├── core/ # Configuration │ ├── database/ # Database models and sessions │ ├── llm/ # AI service integration │ └── services/ # Detection engines ├── static/ # Frontend │ ├── index.html # Detection page │ └── config.html # Configuration page ├── scripts/ # Utilities │ └── init_db.py # Database initialization ├── docs/ # Documentation ├── .env.example # Config template ├── requirements.txt # Dependencies └── run.py # Entry point ``` ## 开发 ### 运行测试 ``` python test.py ``` ### 双语检测测试 ``` python test_bilingual.py ``` ### 查看日志 ``` # Linux/Mac tail -f logs/antifraud.log # Windows type logs\antifraud.log ``` ## 故障排除 **依赖安装失败** 请确保已安装 Python 3.10+。尝试运行 `pip install --upgrade pip`。 **端口 8000 已被占用** 在 `.env` 中修改端口或在命令行中指定： ``` uvicorn app.main:app --host 0.0.0.0 --port 8080 ``` **AI 检测未工作** 检查 `.env` 中的配置。查看日志 `logs/antifraud.log`。 **Ollama 连接被拒绝** 请确保 Ollama 正在运行：`ollama serve` ## 安全 - 所有处理均在本地进行（除非启用 OpenAI 模式） - 规则模式或 Ollama 模式下数据不会发送到外部服务器 - 数据库和日志默认被排除在 Git 之外 - 敏感配置保存在 `.env` 中（不会被 Git 跟踪） ## 许可证 MIT 许可证。详情见 [LICENSE](LICENSE)。 ## 紧急联系人 如果遇到真实欺诈情况： - **中国**：报警电话 110 / 反诈专线 96110 - **美国**：911 / FTC 欺诈报告 https://reportfraud.ftc.gov - **英国**：999 / 诈骗防范 https://www.actionfraud.police.uk - **欧盟**：112 / 国家网络犯罪举报门户 ## 感谢 - 基于 [FastAPI](https://fastapi.tiangolo.com/) 构建 - AI 集成支持 [Ollama](https://ollama.com/) 和 [OpenAI](https://openai.com/) - 设计时考虑了老年用户的可访问性

标签：AI反诈, AI风险缓解, AV绕过, FastAPI, LLM评估, Ollama, OpenAI, Python, Swagger文档, URL检测, Web配置, 中文英文双语, 云端AI, 云计算, 内存规避, 反欺诈系统, 多模型支持, 多模态检测, 异步传输, 数据库初始化, 无后门, 时间线生成, 本地AI, 检测模式配置, 电话检测, 短信检测, 老年人友好UI, 老年人防骗, 规则引擎, 语音分析, 逆向工具, 风险分级