# D4 实施与验收 日期:2026-10-28(北京时间)。继续 D1–D3 已有未提交成果,未重置两个仓库。 **交付状态:D4 前后端实现、本地回归、代表性格式测试、浏览器联调与运行文档已完成;真实 MySQL、知了和 DeepSeek 联调未验证。不能据此宣称四天计划全部真实验收通过。** 当前进程未设置 DB_URL、DB_USERNAME、DB_PASSWORD、ADMIN_INITIAL_PASSWORD、ZLBX_API_KEY、DEEPSEEK_API_KEY;后端没有 `.env`。未读取或输出其他项目的凭证,未使用模拟数据替代真实服务证据。 ## 1. 本次实现 ### 历史会话与真实问答 - 新增会话新建、按标题及用户问题搜索、分页、自动标题、带版本的重命名、删除与历史消息读取。首次问题自动生成标题,人工命名后不再覆盖;同一任务重复关联不重复写消息。 - 调研四入口创建的任务关联到持久化会话。较早 D1–D3 的独立任务仍可从最近任务回查;没有静默为旧任务批量生成会话。 - “发现商机”提供整批结果及单项目 AI 提问,“重点关注”提供单项目入口。打开入口不调用模型,明确提交问题才发起一个 `SNAPSHOT_QA` 任务。 - 整批从数据库读取该快照的全部 `search_item`,不取当前分页的 20 条,不使用前端临时偏好排序作为事实。单项目仅包含所选项目。候选、条件、日期、已读取数、平台总命中数、来源在提交时冻结并计算完整性哈希。 - 问答只调用一次后端模型,不重新执行招投标检索、企业情报或项目深查。报告标为建议与推断;逐条核验来源、关键数字及链接。无效回答隐藏,任务部分完成,实际模型与 token 仍保留。 - 每个候选保留全部标准化字段;每条正文最多提供前 1000 字,明确标记摘录。完整上下文超过 600,000 字符时拒绝并建议单项目提问,不静默省略候选,也不宣称读过完整标书。 - 后续问题默认沿用最近一次快照问答范围,每次按当时批次冻结;每次模型请求独立记账。当前不把历史模型回复当新事实来源;依赖省略指代的问题应补全对象名称。 - 删除会话只删除会话及消息。独立任务、实际费用、关注、原件按各自生命周期保留;桌面与窄屏均有明确删除范围和确认交互。 - 移除原未接入后端的 AI 面板、本地模板回答、模拟逐字流及内存会话存储,当前页面不会将这些内容作为真实结果展示。 ### 文件生命周期与格式边界 - 到期文件在 GET 时立即清理,定时任务尚未运行也不能返回全文。定时清理每次最多 100 条,按到期顺序处理;重复清理/手动删除只保留一次删除审计。 - 文件绑定、证据记录同事务;发出新的依赖文件请求前再次检查删除、归属和过期。已经登记并发出的请求属于在途请求,删除不能撤回已发送内容和实际费用。 - 原件、提取全文与派生图片保存在有期限的临时表,删除统一置空。长期文件证据只保留每段最多 2000 字的必要摘录和定位,不再复制整份长文件全文;这部分摘录与费用账本不会随原件删除。 - 补充 DOC/DOCX、XLS/XLSX、PPT/PPTX 的内嵌图片提取;位图走相同视觉预算。无法可靠定位的图片只标资源编号及“位置需人工核对”,不伪造页码。不能解码的矢量图明确提示转换后补充。 - 既有 20 MiB、50 页、20 视觉页、200,000 字、临时图片总量保护值继续生效。Office 图片消耗同一视觉页预算,超限明确拆分。 - 公司档案导入仍关闭;文件只允许 `BID_PROJECT`。 ### 恢复、费用与错误 - SSE 保留事件游标、去重及重连;网络不可达时按退避延迟只读重试,最多 15 秒间隔,恢复后追完最终事件。401/403/404 停止重连,登录失效回登录页。 - 创建与继续任务仍通过持久化幂等键及请求指纹防重;浏览器重复点击、网络结果未知后手动重试保留当前请求键。页面刷新、历史读取、来源展开、用量读取均不创建新收费任务。 - 重启把正在执行的任务标为 PARTIAL,在途 STARTED 调用标 UNKNOWN / RESTART_INTERRUPTED,不自动重放。生产会话保存在实例内存,重启后需要重新登录。 - 失败、部分完成、预算暂停均保留已有来源、调用与费用,并提供补充资料、调整条件或返回入口的下一步。取消后可手动刷新结果与用量,核对仍在途的请求。 - 新增 `/api/usage`,只汇总本账号持久化调用;知了积分、模型 token、未知用量分别列示,不能把本地账本当平台余额。服务验证页可显式读取,不隐式发起余额查询。 ## 2. 已执行验证 运行环境:Java 21.0.12.1、Maven 3.9.16、Node 23.11.1、npm 10.9.2。Maven 启动命令明确指定 Java 21,避免主机默认 Java 8。 | 验证 | 实际结果 | | --- | --- | | `JAVA_HOME=$(/usr/libexec/java_home -v 21) mvn -q -Djava.awt.headless=true verify` | 102 项测试,0 失败、0 错误、0 跳过;生成后端 JAR | | `npm run build` | TypeScript 和 Vite 构建通过,生成 `rz-GB-web/dist` | | 本次修改涉及的 TS/TSX、Vite 配置 ESLint | 通过 | | 两仓库 `git diff --check` | 通过 | | 中文文字 PDF 额外样本 | 本机系统中文字体生成非敏感样本;中文、预算、行内报价文本完整提取,保留第 1 页定位,不调用视觉 | | 实际进程强制中断/重启 | 临时文件 H2 + 本机模拟 HTTP;重新登录后 PARTIAL,原调用 UNKNOWN,报告/事件可读;模拟请求始终一次,无自动重放 | | 浏览器 | 测试账号登录 → 模拟检索 → 整批问答 → 来源/费用 → 会话改名 → 刷新恢复 → 桌面侧栏搜索;同时检查窄屏会话操作 | 测试共六组:原基础业务 29 项、排序 5 项、摘要匹配 5 项、研究工作流 17 项、文件解析 30 项、D4 集成 16 项。D4 集成覆盖 25 个候选跨两页的末条问答、冻结范围、单项目范围、并发幂等、自动标题/搜索/版本冲突/删除、账号隔离、坏引用/坏数字、供应商认证/限流/超时/不可达、即时过期清理、长期摘录范围和只读用量。 测试最初在受限沙箱中因禁止本机 HTTP 端口失败,改为允许本机端口的测试进程后通过;文件解析以 `java.awt.headless=true` 运行。没有把环境启动失败记为业务测试通过。 ![D4 历史会话与快照问答(本地模拟)](images/D4-历史会话与快照问答-本地模拟.png) 截图里的 `d4-ui-fixture-only` 和“界面测试”均为本地模拟资料,不代表真实 DeepSeek 模型、知了数据或真实扣费证据。 ### 格式矩阵 | 格式/边界 | 本地结果 | 验证口径 | | --- | --- | --- | | TXT、MD、CSV、HTML | 通过 | UTF-8 中文、GB18030、CSV 原始行、HTML 脚本不执行 | | DOC | 通过 | POI 开源段落样本;真实中文老 DOC 复杂排版未验证 | | DOCX | 通过 | 中文段落/表格、内嵌位图;不伪造页码 | | XLS、XLSX | 通过 | 中文表格/行号、内嵌图片、公式读取缓存值,不更新外链 | | PPT、PPTX | 通过 | 中文幻灯片、内嵌位图,图像资源位置需人工核对 | | 文字 PDF | 通过 | 常规英文样本及额外中文样本;不触发视觉 | | 扫描/混合 PDF | 通过 | 逐页渲染、文字页与扫描页分流、文字页眉加扫描正文 | | JPG、PNG、WebP、GIF | 通过 | 实际解码;GIF 增加两帧样本与逐帧定位 | | 损坏/后缀伪装/加密/超限 | 通过 | 拒绝或要求拆分,不静默截断 | | 低清真实标书、复杂图表/矢量/动画合成语义 | 未验证 | 无真实标书和真实视觉凭证;不承诺完整版面还原或 OCR 准确率 | 扫描件测试验证了本地渲染、视觉请求结构、位置和成本记录,未证明真实模型识别质量。 ### 异常矩阵 | 场景 | 已验证行为 | | --- | --- | | 无结果、未知预算/地区、部分页成功 | 保留已读范围与缺口,未知金额不当零、不删除候选 | | 401/403、业务失败、余额不足 | 区分认证、业务与预算原因;等待或失败,不当作无结果 | | 429、网络超时、HTTP 503、网页域名不可达 | 明确原因及下一步;超时结果 UNKNOWN,不自动重试 | | 模型引用或数字不可验证 | 隐藏生成结论,保留事实与实际用量 | | 重复提交/同键不同内容 | 同键同内容复用;不同内容或会话冲突返回 409 | | SSE 事件重放、取消、服务重启 | 事件有序、重放不创建收费调用;取消停止后续;重启保留未知费用 | | 文件过期/删除/跨账号/跨任务 | 全文及派生物清理;拒绝非法复用,审计不重复 | | 冻结上下文过大 | 明确提示单项目提问,不删除候选凑入模型上下文 | ## 3. A01–A20 验收账 “本地通过”仅指合成样例、测试数据库和模拟 HTTP。真实验收列不能由本地结果自动推导。 | 编号 | 本地判定与证据 | 真实验收 | | --- | --- | --- | | A01 鉴权退出 | 通过;真实安全过滤链、CSRF、登录/退出测试及浏览器登录 | 待指定环境 | | A02 持久化 | 通过;数据库读取及临时文件 H2 进程重启 | MySQL 未验证 | | A03 四入口 | 通过;既有 D3 浏览器记录及工作流测试 | 未验证 | | A04 招投标实际请求 | 通过;本机 HTTP 调用与报告对应 | 知了未验证 | | A05 初始不深挖 | 通过;工具白名单与调用断言 | 待真实账本核对 | | A06 偏好不变候选 | 通过;候选集合、未知预算测试 | 待真实数据复核 | | A07 两种排序 | 通过;冻结排序及匹配测试 | 待真实数据复核 | | A08 召回范围 | 通过;分页、去重、平台总数、停止原因 | 供应商字段未验证 | | A09 主体确认 | 通过;确认前无深查、范围冲突测试 | 同名真实主体未验证 | | A10 双公司/项目 | 通过;单/双主体和快/完整工作流测试 | 未验证 | | A11 真实轨迹 | 通过;本机请求账本与事件、移除模拟流 | 真实模型流未验证 | | A12 来源与推断 | 通过;证据哈希、引用/数字拒绝、来源页面 | 来源事实仍需人工核验 | | A13 预算费用 | 通过;暂停恢复、未知费用、token 分账 | 真实积分/账单未验证 | | A14 八状态 | 通过;事务、版本、幂等、标签与历史测试 | 待指定环境演示 | | A15 全格式 | 通过;代表性格式矩阵 | 真实资料/真实 OCR 未验证 | | A16 清理删除 | 通过;归属、到期、手动清理、必要摘录审计 | 待指定环境定时任务核对 | | A17 无结果/失败 | 通过;异常矩阵与可执行提示 | 真实错误字段未验证 | | A18 幂等恢复 | 通过;SSE 测试及实际进程重启,无重复请求 | MySQL/反向代理断线未验证 | | A19 会话快照 | 通过;CRUD、浏览器刷新、跨两页整批 QA | 指定环境未验证 | | A20 评分 | 通过;非法权重、精确舍入、档案版本及高分样本 | 真实样本不硬造高分 | ## 4. 交付与尚未完成项 - 实现位于后端 `rz-GB` 与相邻前端 `rz-GB-web`;新增 Flyway V7,未修改 V1–V6 的已发布结构。代码按要求补充中文业务注释。 - 构建、部署、接口、事件/幂等/金额/日期单位和确认流程见 [接口契约与运行交付](接口契约与运行交付.md)。三个 Skill 锁定版本及本地工具映射也在该文档。 - 前端构建仍有主 JS 超过 500 kB 的提示,构建成功;本轮未扩展到全站拆包。 - 单实例任务执行器与内存会话沿用现有设计;多实例调度、自动通知、注册、标书生成和生产高可用不在本期。 - 仍需提供指定测试环境 MySQL 连接、admin 初始密码、知了和 DeepSeek 凭证/余额及代表性真实标书,再按四天计划 6.2 演示脚本和 D1–D3 的真实服务清单执行。届时记录实际模型 ID、工具字段、积分、token、Search/Fetch、扫描件识别及数据库重启结果。 - 未做生产部署,也没有提交、推送、创建 PR 或改动真实业务数据。真实凭证不足属于未验证条件,不等于已通过的交付承诺。