标书智能解析（Bid Analysis）
通过 HTTP API 驱动"标书智能解析"系统，完成招标文件解析全流程：上传 → 等待解析 → 查看章节/废标风险 → 导出报告。
前置配置
所有命令依赖环境变量（缺失时脚本按默认值执行，密码缺失会在登录时报错）：
export BID_BASE_URL="http://<服务地址>:8080" # 默认 http://localhost:8080
export BID_USERNAME="<登录账号>" # 默认 admin
export BID_PASSWORD="<登录密码>"
export BID_TENANT_ID="<租户ID>" # 默认 1（系统租户，跨租户数据用此账号）
数据隔离：账号属于哪个租户就只能操作该租户的会话；系统租户账号可跨租户。
标准流程
统一入口：python3 scripts/bid_api.py <命令>（完整参数见脚本头部 docstring）。
1. 上传招标文件并解析
python3 scripts/bid_api.py upload /path/to/招标文件.pdf
# 输出 sessionId=<uuid>，后续所有命令都用它
- 支持 pdf/doc/docx（扫描件不支持）
- 同文件重复上传：命中历史报告直接复用（返回 cached 提示），不会重复解析
2. 等待解析完成
python3 scripts/bid_api.py wait <sessionId> # 每 5 秒轮询，默认超时 15 分钟
大文件解析耗时分钟级（每章一次 LLM 生成）。也可用 status <sessionId> 单次查看。
解析失败的会话会用 errorMessage 说明原因，修复后可重新上传同文件触发重试。
3. 查看结果
python3 scripts/bid_api.py chapters <sessionId> # 章节清单（名称/生成状态/摘要）
python3 scripts/bid_api.py disclaimers <sessionId> # 废标风险清单（含已核对标记）
- 章节内容对应系统配置的输出模块清单（资格预审/符合性审查/评分材料清单等）
- 废标风险为投标红线项（★/▲条款与否决性表述），务必逐条核对
4. 导出报告
python3 scripts/bid_api.py export <sessionId> excel # 解析报告 Excel
python3 scripts/bid_api.py export <sessionId> bid-draft # 投标草稿 Word
python3 scripts/bid_api.py export <sessionId> qa-excel # 点对点应答表 Excel
python3 scripts/bid_api.py export <sessionId> word [输出路径]
- 格式：excel / word / markdown（解析报告）；qa-excel（点对点应答表）；bid-draft（投标草稿）
- qa-excel 与 bid-draft 含逐章 AI 生成，耗时分钟级，脚本会等待至完成（超时 15 分钟）
- Excel 报告首两个 Sheet 为"温馨提示"与"废标风险清单"（含核对状态），导出即投标前自查清单
注意事项
- 命令输出
sessionId=xxx时优先用正则提取该值再传给后续命令，不要让用户手抄 - 遇到"登录失败"提示时检查 BID_PASSWORD 是否配置、租户 ID 是否正确
- 详细接口规格（路径/参数/状态枚举/错误码）见
references/api_reference.md - 脚本纯标准库实现（urllib），无需安装依赖
