guangshu100/BidMaster-Pro

全流程智能招投标 Agent：标书生成 · 招投标解读 · 标书检查 · 标书文档ai排版 · 商机发现一键完成。 21 项合规检查 · 多模型切换 · RAG 知识库 · OCR 抽取。从招标公告到可交付 docx 文档，全流程 AI 自动化。

BidMaster Pro – AI 驱动的端到端投标（招投标）平台

是什么

BidMaster Pro 是一个桌面+服务器应用程序，利用大语言模型（LLMs）自动化整个从招标到投标的工作流程。它通过基于 LangGraph/LangChain 的 Agent + Skill 引擎，将四个阶段——解读（招标文件解析）、生成（投标初稿撰写）、检查（合规性审查）、格式化（文档排版）——串联起来。系统可切换多个 LLM 提供商（DeepSeek、OpenAI、Alibaba Tongyi、SiliconFlow、本地 Ollama 模型），并通过 RAG 知识库（公司文档和历史投标记录的向量存储）和 MinerU OCR（支持扫描 PDF）增强生成能力。

核心功能

阶段	主要功能
解读	解析 PDF/DOCX/TXT 招标文件，提取评分标准、资质要求、技术规格、风险提示，并生成评分矩阵。
生成	自动生成大纲，借助 LLM 辅助撰写各章节，从 RAG 存储中检索相关历史案例，并生成支持性图表/图表。
检查	执行 21 项预设合规性检查（如保证金、签名、有效期、一致性、抄袭、价格合理性等），并标记任何违规项。
格式化	应用选定的投标模板，自动排版文档，并导出为 DOCX、DOC 或 PDF。支持与模板的差异对比和协同修订。
辅助功能	• AI 驱动的问答聊天，引用来源片段。 • 招标监控服务，抓取公开招标网站，按关键词过滤，并评估机会价值。 • 多用户团队的 RBAC 权限控制。

架构概览

桌面客户端（React + Electron + TypeScript）
   ⇆ REST API ⇆ FastAPI 服务器（Python 3.12+）
        ├─ 路由层（项目、解读、生成等）
        ├─ 核心引擎
        │   • Agent 引擎（LangGraph） – 协调 Skills
        │   • Skill 引擎 – 插件式业务逻辑
        │   • RAG 引擎（ChromaDB） – 向量搜索与语义重排序
        │   • LLM 网关（LiteLLM） – 统一访问多个 LLM 提供商
        │   • 文档引擎（pdfplumber、python‑docx 等）
        └─ 基础设施
            • PostgreSQL（asyncpg） – 关系型数据
            • Redis + Celery – 任务队列与缓存
            • MinIO – 上传文件的对象存储

主要技术栈

后端: FastAPI, SQLAlchemy, asyncpg, PostgreSQL 16, Redis 7, Celery, MinIO
AI/LLM: LiteLLM（多提供商）、LangGraph、LangChain‑Core、ChromaDB、Sentence‑Transformers、ONNX Runtime（本地模型）
前端: React 19, Electron 41, TypeScript 5, Vite, TailwindCSS, Zustand, TanStack Query, Radix UI
文档处理: python‑docx, pdfplumber, PyMuPDF, Mammoth, WeasyPrint, BeautifulSoup4

快速入门

克隆与配置 – 将 .env.example 复制为 .env，填写 LLM API 密钥、数据库 URL 等信息。

Docker 部署（推荐）

docker-compose up -d   # 启动 Postgres、Redis、MinIO、FastAPI、Celery

API 文档位于 http://localhost:8000/docs。

本地开发（如希望自行运行代码）
- 创建 Python 虚拟环境，安装包（pip install -e .）。
- 执行迁移（alembic upgrade head）。
- 启动 FastAPI（uvicorn services.main:app --reload）。
- 启动 Celery 工作器（celery -A services.celery_app worker）。
- 在 packages/desktop 中安装 Node 依赖并启动 Electron 应用（npm run electron:dev）。

可扩展性

技能是封装单一功能的 Python 类（如大纲生成、OCR 提取）。新技能可通过类似 JSON 的 DSL 添加并接入 LangGraph 流水线。
Agent 流水线 定义技能执行顺序；门卫（Gate Keeper）确保前序步骤完成后才启动后续步骤。
LLM 提供商切换 由 LiteLLM 管理，可添加任何遵循 OpenAI 兼容 API 的提供方。

适合谁使用

定期响应公共招标，需加快投标准备并确保合规性的企业。
构建内部投标自动化工具的咨询公司。
寻找带桌面 UI 的多 LLM、RAG 支持工作流参考实现的开发者。

许可证: MIT – 详见 LICENSE。联系: 扫描 README 中的二维码，关注微信公众号，并发送 bidmaster 获取作者信息与支持。