# ai-bid-local

**Repository Path**: daniel1231/ai-bid-local

## Basic Information

- **Project Name**: ai-bid-local
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-02
- **Last Updated**: 2026-11-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 今探科技AI大模型 浏览器版

2026-09-16：初审新增具体修改建议，提供“生成修改建议”（只出稿）与“AI 修改正文”联动；评审结束后可导出 PDF，包含问题、修改建议和各位置最近保存的正文修改稿与灰色追溯附注。详见[实现与验收说明](docs/06-研发与质量/评审修改建议与报告导出-20260916.md)。

2026-09-15：技术方案新增“章节配图”，支持本项目原图选用、裁剪标注、三种本地关系示意和 Word 插图。配图操作保留已保存的人工 Word 内容，预览/采用不调用模型。见[首版实现与本地验收](docs/06-研发与质量/施工组织配图-首版实现与本地验收-20260915.md)。

> 2026-09-13：企业知识库已改为不依赖项目的企业资料中心，支持公司材料、资质证照、合同业绩、历史投标、技术方案等分类上传，自动/手动标签、筛选、预览下载及技术方案真实评分入口。复用已有 S3/MinIO 或桌面本地对象存储与安全扫描，不新增存储服务；需迁移至 `20260913_0035`。详见[企业知识库设计](docs/01-产品与业务/企业知识库与大模型规则库业务设计.md)。

**当前评审实现（2026-10-11）**：网页新任务统一执行十视角评审管线：冻结三份材料 → 解析招标文件、工程量清单和施工组织设计 → 构建模型输入、事实与图片索引 → 各视角按需检索取证 → 汇总裁定 → 保存问题卡片和诊断评分。旧 A/B 初审、段落提升及缺资料回退执行路径已移除，历史结果保留只读。

新任务必须提供一份招标 PDF、一份清单 PDF/XLSX 和一份技术标主文件 DOCX。缺少、重复或不支持的材料在创建时返回 422，不会静默换用其他引擎。新结果使用 `issue_cards`；`complete` 表示流程结束，不表示结论已经人工确认。接口和实现边界见 [网页正式对接](docs/04-数据与接口/R1网页正式对接.md) 与 [管线集成说明](backend/PIPELINE_INTEGRATION.md)。

旧版 v74 与 A/B 的实测数据仅说明历史版本，保留在 [历史验收记录](docs/06-研发与质量/R1第一阶段D1-D3精简整合与对照-20260913.md)，不能作为十视角管线的质量或耗时验收。

2026-09-14：`/generation` 扩展为完整技术方案编制：选定招标文件、附件与历史参考，冻结原文、识别工程范围和技术要求，校核共享进度资源计划后分节写作。生成后在 ONLYOFFICE 中预览与编辑整份 Word，保留依据、计划修改后重新编制及工程复核包导出。编制编辑稿需迁移至 `20260915_0039`；生成、文件和工程质量的实际验证分别记录，不把写作完成等同于专业审核。见[实现与验收记录](docs/06-研发与质量/技术方案完整生成-实现与验收记录-20260914.md)。

2026-09-15：方案正文区复用评审的 ONLYOFFICE，支持自动保存、章节定位和保存后下载 Word。左侧目录与右侧依据保留；人工 Word 修订不回写生成结构，复核包仍包含生成原稿。调整计划或版式先确认当前 Word 已保存，新生成修订单独建立编辑稿，旧稿可下载。见[编辑接入](docs/03-架构与技术/评审文档编辑接入.md)。

技术方案提供“青蓝分项式”“商务蓝标准式”“黑白简约式”三套内置模板。工作台“版式设置”可预览模板，修改页眉、页脚、页码、字体、字号及行距，并随方案保存；默认页眉为方案名称，页脚为“施工组织设计 · 技术部分”，页码为“第 X 页 / 共 Y 页”。模板设置影响生成原稿和复核包；调整后创建新 Word，原人工编辑稿可从“历史编辑稿”下载。当前 Word 的版式可直接在编辑器中修改。见[模板配置与验收](docs/06-研发与质量/青蓝分项式内置模板-20260914.md)。

2026-09-15：修复技术方案大纲遗漏要求关联时直接中止的问题。初次规划和独立校核都会反馈具体遗漏并有限修复，禁止删除已提取要求绕过校验；失败、停止或中断时不再显示后台仍在生成。校核共用现有来源容量上限，保留必读依据。既有资料与任务可继续使用，未增加数据库字段。见[修复与实跑记录](docs/06-研发与质量/技术方案无法生成-修复与实跑记录-20260915.md)。

本机开发已配置：执行 `powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\dev.ps1 start`，访问管理系统 `http://127.0.0.1:5173/admin/`，官网在根路径 `http://127.0.0.1:5173/`。使用独立本地PostgreSQL、文件目录和现有阿里云百炼账号；实际模型按业务路由及调用审计核对。本机不连接管理端账号、授权、模型配置或额度接口，详见[本地开发环境](docs/07-部署与运维/本地开发环境.md)。

本项目无默认远程发布服务器。需要部署时显式提供 `scripts/publish.ps1 -Target all -Server <目标服务器>`；仅本地打包使用 `-PackageOnly`。[简易部署教程](docs/07-部署与运维/简易部署教程.md)包含仅上传、服务器执行、备份与故障处理。

## 评审网页入口

选择招标文件、工程量清单与技术标主文件，提交后查看解析、事实提取、图片理解、索引、十视角评审和汇总裁定阶段。任务保存到 PostgreSQL，刷新后可继续查看；取消、失败、中断和执行限制按实际状态展示。

`ReviewTaskService` 负责资料冻结、任务身份、后台执行和保存；`ReviewPipelineService` 连接现有解析器与 `app/review_engine`。所有新建与重跑任务使用相同管线。旧任务仍可查看和导出，重新运行时需符合当前三份材料要求。

结果页和 PDF 报告读取保存的 `issue_cards`、证据、修改建议与诊断评分。PDF 也兼容历史问题/建议快照，不触发模型重算。文档编辑继续使用独立副本和保存回执，原件只读；见 [编辑接入](docs/03-架构与技术/评审文档编辑接入.md)。

启动前执行 `alembic upgrade head`。本机开发脚本关闭后端自动重载；确认后台任务结束后再重启。完整契约见 [网页正式对接](docs/04-数据与接口/R1网页正式对接.md)。

## 运行边界

- 新评审只接受招标 PDF、清单 PDF/XLSX、技术标 DOCX 各一份，所有处理基于冻结版本，原件只读。
- 后端仍使用单API进程和本地有界线程池；所有环境均使用本项目数据库内的账号、菜单和功能权限，保留同源 Cookie 和 CSRF 校验。
- 浏览器不接触模型密钥。独立评分、编辑与生成沿用共享模型网关；十视角引擎当前使用独立模型客户端，所有模型选型由本项目配置决定，审计接入状态见下文。
- 本地账号会话保存在项目数据库中，按期限和账号状态校验。不会替中断任务自动重新发起付费调用；可在原结果页明确重新运行。
- 独立评分与样章编制仍各自运行，不随R1问题评审自动串行启动。

## AI 配置

十视角引擎当前由 `app/review_engine/model_client.py` 读取本项目统一 Settings：固定位置的 `backend/.env` 优先，缺项才使用本机进程环境变量，使用 `DASHSCOPE_API_KEY`、`DASHSCOPE_BASE_URL`、`MODEL_REVIEW_NAME`、`MODEL_FAST_NAME`、`MODEL_OCR_NAME`、`MODEL_REVIEW_REASONING_EFFORT` 与 `MODEL_REQUEST_TIMEOUT_SECONDS`。实际型号以部署配置为准。

该客户端直接调用供应商兼容接口，使用同一套本地配置，但尚未复用共享网关的 `model_invocations` 审计；不能将其他业务网关的用量保证当作新引擎已通过的验收。独立评分、文档 AI 编辑及技术方案生成继续使用各自的网关配置。

## 本地开发

只启动后端：`powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\start-backend.ps1`。使用已准备的虚拟环境和数据库，在当前终端监听8000端口；[使用说明](docs/07-部署与运维/本地开发环境.md#单独启动后端)。

升级已有环境时，先从 `backend/.env` 移除已废弃的 `R1_REVIEW_MAX_BATCHES` 和 `LICENSE_SERVICE_URL`；配置采用 `extra=forbid`，残留旧键会阻止启动。

准备 PostgreSQL，复制 `backend/.env.example` 为不提交的 `backend/.env`，填写数据库、`DASHSCOPE_API_KEY`、本地租户编号和文件签名密钥。开发使用 `WEB_COOKIE_SECURE=false`，浏览器打开 localhost；公网生产必须 HTTPS。

```bash
python -m venv backend/.venv
# 激活虚拟环境后
pip install -e './backend[dev]'
cd backend
alembic upgrade head
uvicorn app.main:app --host 127.0.0.1 --port 8000 --no-access-log
```

另开终端：

```bash
npm --prefix frontend ci
npm run dev
```

Vite 将 `/api` 转发至本机 8000；不要再启动 Electron 或 Celery Worker。

## 构建与验证

```bash
npm run type-check
npm test
npm run build
# backend 目录、已激活虚拟环境
ruff check app tests
mypy app
pytest
```

前后端镜像分别构建；执行 `backend/docker/deploy-web.sh` 部署到管理端服务器。详见部署文档。桌面打包入口及发布流水线已移除。

## 服务器部署

在生产服务器上执行（先确认没有残留的部署进程，再拉取代码并部署）：

```bash
cd /opt/huiyan/repo && pgrep -af deploy.sh; git pull origin master && bash deploy.sh
```

- 部署前需先把代码推送到 gitee。
- `deploy.sh` 带互斥锁，同一时间只允许一个部署；`pgrep` 有输出说明还有部署在运行，请等它结束，不要并发执行。
- 后端镜像按 `backend/pyproject.toml` 缓存依赖，只改业务代码时部署很快；前端有改动时会重新构建，`npm install` 较慢，请勿中途 Ctrl-C。
- 部署后 `docker ps` 应看到 `huiyan-api`、`huiyan-frontend`、`huiyan-postgres` 三个容器；后端启动失败时脚本会打印容器日志并中止。

大模型规则库当前仅保留技术方案相关内容：D1 32 条、D2 16 类、施工 D3 46 条、监理 D3 19 条；已移除商务、报价、资格审查和提交操作规则。

评审结果页读取已保存的问题卡片、诊断评分与执行限制。`partial`、`failed` 和中断状态不代表评审通过；诊断建议不自动改写正文。

通用解析与 OCR 继续服务独立招标分析、评分和方案编制；新评审由三类专用解析与模型输入模块组织材料，DOCX 图片进入独立图片事实阶段。图片存在或解析成功不代表图内专业事实已经验证。

项目页面通过review_projects.wizard_step恢复资料/技术标步骤，和R1任务状态分开。迁移0033保留旧资料和历史结果，将旧活动评审标为已被R1替换的失败记录。迁移0029/0030的向导进度回填仍保留。

项目列表支持删除已有资料或评分历史的项目：采用软删除，从列表移除并关闭项目入口，关联文件及历史记录继续保留。


### 真实评审结果

已移除演示项目、静态结果、演示 PDF 和仅本地模拟核对的评分反馈页面。真实结果采用问题与文档两栏，保留签名原件与Word/PDF编辑副本；原始证据及评审详情按需打开。同一副本同时只允许一个页面编辑；其他页面只读，失联先确认保存结果。问题卡片 AI 修改先回读资料核查，有依据的问题自动修复，无需修改或证据不足时保留原文；已接入正文替换、候选核验、保存恢复及撤销，应用后保持“已修改 · 待复核”。G0 已通过，功能综合验收尚未完成；真实模型质量未测，详见[功能联调与验收记录](docs/06-研发与质量/问题卡片AI修改-功能联调与验收记录-20260914.md)。

### 模型用量

已移除本客户端的演示 Token 额度查询、预检、预占和结算。共享模型网关继续记录供应商返回的真实输入、输出及缓存 Token，并保留企业授权校验和并发容量限制。外部授权管理服务不随此变更修改。

### 当前开发与验证

当前清理移除了旧评审执行服务、旧提示词、专属契约和验收脚本，保留报告历史读取以及评分、编辑和生成所需的公共能力。测试验证任务分派、输入拒绝、结果转换与只读报告，不等于真实模型质量或端到端性能验收。

开发入口见[本地环境](docs/07-部署与运维/本地开发环境.md)，接口见[网页契约](docs/04-数据与接口/R1网页正式对接.md)，管线职责与验证方式见[集成说明](backend/PIPELINE_INTEGRATION.md)。

PDF 转 Word 编辑副本已接入本地试验：核对预览后统一进行 AI 修改和人工编辑，保存后选择 DOCX 或 PDF 导出。合成样本已通过真实浏览器的普通表格／合并格修改、人工长文、保存重开和安全撤销；复杂件仍有稀疏续页及未普遍重建的页眉／编号。该路径默认关闭，原 PDF 能力继续保留。需安装转换 extra 并核验部署许可，见[转换决策](docs/03-架构与技术/架构决策记录/0022-PDF转Word采用隔离候选与质量门禁.md)及[最新验收记录](docs/06-研发与质量/问题卡片AI修改-功能联调与验收记录-20260914.md)。

### 项目列表与方案恢复

`/projects` 每个项目显示一行，按是否存在方案生成任务区分“评审项目”和“方案生成项目”。方案行显示最新创建任务的名称、状态和入口，进入 `/generation?project=项目ID&run=任务ID` 后可继续查看进度、处理失败或切换历史方案；无生成任务时保留评审恢复入口。类型筛选、当前业务状态筛选、名称搜索与分页均在服务端执行。该分类是列表操作视图，不改变项目资料模型或评审历史。