# 更新日志

本文件记录 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`。
- 部署脚本已完成语法、依赖同步、启动、健康检查、状态查询和停止闭环验证。