labor-law-ai
劳动法智能维权 AI 工具
面向普通劳动者的 AI 法律维权工具——引导式填表 → AI 自动分析 → 一键生成仲裁材料。
⚡ 接入你自己的 AI 即可使用 — DeepSeek / 通义千问 / 智谱 GLM / GPT-4o / Ollama / 任意 OpenAI 兼容接口。 配置指南 →
特点
- 🧠 8 个专业 Agent — 案件分析、违法识别、赔偿计算、合同审查、证据分析、文书起草、仲裁指导、维权路线，级联执行
- 🪄 引导式交互 — 不用会写 Prompt，选问题类型 → 填表 → 看报告，三步搞定
- 📜 内置法律库 — 4 部法律 71 条 YAML 条文 + 2-gram 倒排索引 + 10 个典型案例
- 🤖 可替换 AI — 适配器层，只改
.env或界面上填 Key，不改代码 - 📱 响应式 Web — 移动端底部 Tab + PC 端顶部导航
- 📄 SSE 流式输出 — 实时 AI 分析结果 + 结构化数据提取 + 赔偿自动计算
3 分钟上手
# 1. 安装后端依赖
cd fastapi-server && pip install -e ".[dev]"
# 2. 配置 AI Key
cp .env.example .env
# 编辑 .env，填入 LLM_API_KEY。或者启动后在「设置」页面直接填入。
# 3. 启动（前后端一体，一个端口）
uvicorn app.main:app --host 127.0.0.1 --port 8000
浏览器打开 http://localhost:8000
开发模式下如需前端热更新：
cd web-app && npm run dev，访问http://localhost:3000
AI Key 配置
两种方式任选：
| 方式 | 怎么做 |
|---|---|
| 界面配置（推荐） | 启动后点底部「设置」→ 输入 API Key → 保存 |
| 环境变量 | 编辑 .env → LLM_API_KEY=sk-your-key |
界面配置实时生效，优先于 .env。
切换 AI 模型
# DeepSeek（默认）
LLM_PROVIDER=deepseek
LLM_API_KEY=sk-your-key
LLM_BASE_URL=https://api.deepseek.com
LLM_MODEL=deepseek-chat
# 通义千问
# LLM_PROVIDER=qwen
# LLM_API_KEY=sk-your-key
# LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# LLM_MODEL=qwen-plus
# 本地 Ollama
# LLM_PROVIDER=ollama
# LLM_API_KEY=ollama
# LLM_BASE_URL=http://localhost:11434/v1
# LLM_MODEL=qwen2.5:7b
技术栈
| 层 | 技术 |
|---|---|
| 前端 | Next.js 16 + React 19 + Tailwind v4 + TypeScript（静态导出） |
| 后端 | Python FastAPI + Pydantic v2 |
| AI 层 | OpenAI 兼容适配器（可替换任意模型） |
| 数据库 | SQLite（默认）/ PostgreSQL 17（可选） |
| 部署 | Docker Compose + Nginx / PyInstaller 桌面打包 |
项目结构
labor-law-ai/
├── fastapi-server/
│ ├── app/
│ │ ├── ai/ # LLM 适配器层（可替换任意模型）
│ │ ├── agents/ # 8 个劳动法 Agent + 路由器
│ │ ├── legal_engine/ # 法律库（71 条 YAML + 内存索引 + 10 个案例）
│ │ ├── api/ # 10 个 REST API 路由
│ │ ├── models/ # 9 个 SQLAlchemy 数据模型
│ │ └── schemas/ # 9 个 Pydantic 请求/响应
│ ├── tests/ # 8 个测试文件，31 个用例
│ ├── run.py # 桌面应用启动器
│ └── labor-law-ai.spec # PyInstaller 打包配置
├── web-app/ # 用户端（9 个页面，静态导出）
├── .github/workflows/ # CI（GitHub Actions）
├── DESIGN.md # 视觉设计系统
└── HOW_TO_CONFIGURE_AI.md # AI 配置指南
功能状态
| 模块 | 状态 | 说明 |
|---|---|---|
| 引导式咨询 | ✅ | 3 步 Wizard：选类型→填表→AI 分析+SSE 流 |
| 违法识别 | ✅ | 5 类自动检测 + 法条引用 |
| 赔偿计算 | ✅ | 公式 + 表格 + 结构化提取 |
| 案件管理 | ✅ | CRUD + JSONB 画像 |
| 合同审查 | ✅ | 上传 + AI 审查 |
| 证据分析 | ✅ | 上传 + AI 强度评分 |
| 文书生成 | ✅ | Markdown 模板输出 |
| PDF 下载 | ✅ | xhtml2pdf/WeasyPrint 双引擎 |
| 法律条文 | ✅ | 4 部法律 71 条（WebSearch 校验） |
| 案例库 | ✅ | 10 个劳动仲裁典型案例 |
| AI Key 界面配置 | ✅ | 设置页直接填入，实时生效 |
| 桌面打包 | ✅ | PyInstaller exe 43MB，双击即用 |
| OCR | ⚠️ | 桌面板暂不启用（PaddleOCR 体积太大，考虑用 AI Vision 替代） |
| 前端测试 | ❌ | 待实现 |
| 前端 Error Boundary | ✅ | error/loading/not-found 页面全覆盖 |
| CI 质量门控 | ✅ | ruff + pre-commit + GitHub Actions lint |
已内置的专业化内容
| 模块 | 内容 |
|---|---|
| 法律条文 | 71 条 YAML（劳动法/劳动合同法/社保法/调解仲裁法） |
| Agent Prompt | 8 个领域完整中文 System Prompt |
| 赔偿公式 | 双倍工资 / 经济补偿 N / 违法解除 2N / 加班费 1.5x-3x |
| 文书模板 | 仲裁申请书 / 投诉信 / 证据清单 |
| 违法检测 | 工资/合同/辞退/加班/社保 5 类自动识别 |
| 案例匹配 | 标签 + 关键词检索 |
相关链接
免责声明
本系统不替代律师正式法律意见。 所有 AI 分析仅供用户参考。涉及重大权益请咨询执业律师。