更新日志

本文件记录 Proposa AI 的正式发布与上线代码基线。日期采用 Asia/Shanghai 时区。

2026-08-31

变更

JSON 请求的 REFERENCE_IS_ABSOLUTE=false 时，参考投书相对路径由单目录拼接改为依次在 REFERENCE_DIR、REFERENCE_DIR1 下检查文件是否存在。
新增第二候选目录配置 REFERENCE_DIR1=/data/dms/dms_upload；首选目录不存在目标文件时自动回退到第二目录，两处都存在时仍优先使用 REFERENCE_DIR。
两个候选目录均未配置或均不存在目标文件时，在创建任务和启动 worker 前返回 HTTP 400。
README、.env.example 和 API 开发文档已同步双目录配置与查找规则。

验证记录

API 专项测试 30 项全部通过，覆盖首选目录、第二目录回退、两处同时存在和两处均缺失场景。
完整快速回归 188 项全部通过。

2026-08-28

发布基线：由 wangxi 提升至 master，并保持两个分支代码一致。

新增

新增可编辑的 HTTP 回调联调脚本 scripts/test_api_callback.py：默认仅预览回调 JSON，显式使用 --send 后才发起请求，并同时检查 HTTP 状态和响应业务码。
新增回调脚本专项测试，覆盖成功与失败载荷、UTF-8 JSON 请求、响应输出以及 HTTP 200 中携带业务错误的场景。
JSON 路径模式新增 TPC_IS_ABSOLUTE，用于明确控制招标文件、采购需求和非空澄清公告是否与 TPC_DIR 拼接。

变更

JSON 请求必须显式提供布尔值 TPC_IS_ABSOLUTE 和 REFERENCE_IS_ABSOLUTE；接口不再根据路径文本猜测绝对或相对模式。
相对路径模式会移除文件值开头的路径分隔符，再分别与 TPC_DIR 或 REFERENCE_DIR 拼接。
README 与 .env.example 已同步路径参数、目录配置和回调联调方式。

校验与上线说明

路径模式参数缺失、类型非法或相对模式缺少对应目录配置时，会在 worker 启动前返回 HTTP 400。
回调联调脚本使用测试数据访问目标地址时，网络与 URL 可达；接收端返回业务码 400，真实业务验收仍需有效的 txbId。
本次发布只同步 master 和 wangxi；han 不纳入发布，也不修改。

2026-08-26 (`20260826-01`)

部署

完善 Linux deploy.sh：支持 uv 缺失时自动安装、ModelScope 模型准备、锁定依赖同步、API 后台启动、健康检查以及 status、stop、restart 子命令。
默认使用清华 PyPI 镜像，并允许通过 UV_INDEX_URL 覆盖。
将 uv.lock 纳入版本控制，服务器可直接执行 uv sync --frozen。
修复新 shell 中 uv 位于 $HOME/.local/bin 但不在 PATH 时后台启动失败的问题。

架构与流程

HTTP API 后台任务固定顺序执行 Step1 至 Step6。
移除已弃用的 Step7；Step6 直接生成最终 DOCX，并保持用户指定输出路径。
加固 Step1 跨页表格合并，避免续行合并后错误扩大纵向合并范围。

验证记录

发布标签：20260826-01。
部署脚本已完成语法、依赖同步、启动、健康检查、状态查询和停止闭环验证。