# 四天计划完成度核查 核查日期:2026-10-29(北京时间)。范围:`rz-GB`、相邻 `rz-GB-web`、四天开发计划、需求分析和 D1–D4 验收记录。本轮只新增核查报告,未修改业务代码、配置或数据库,未使用真实供应商密钥。 ## 结论 四天计划的主要业务已有实现,本地自动测试和构建通过;**不能判定四天计划全部验收完成,也不能判定现在能直接运行完整真实业务**。当前最先需要解决的是数据库及首次管理员配置,再完成知了、DeepSeek 和指定环境的真实联调。另有若干功能与原计划存在差距,不能统一归因为“只差 API Key”。 “已实现”表示代码和本地测试证据存在;“真实待验收”表示尚未证明真实数据库、供应商响应、模型质量及实际部署满足要求。没有用文档中的完成声明替代本次代码检查和测试。 ## 四天逐项核对 | 计划 | 本轮确认存在的实现 | 尚未完成的验收或功能 | | --- | --- | --- | | D1:基础工程和真实依赖 | Java 21 工程、Flyway V1–V7、admin 初始化、会话/CSRF、手填档案及版本、统一任务、幂等、事件/SSE、工具白名单和调用账本 | MySQL 初始化与重启持久化;真实知了余额/检索/详情/企业字段;真实模型文本/JSON/流、Search/Fetch、视觉及实际计费记录 | | D2:检索、获客和跟进 | 分页与去重、硬条件/偏好分离、普通检索与获客两种排序、范围统计、规则摘录与四维匹配、方案快照、关注八状态、标签/备注/历史事务及版本 | 真实数据字段、金额单位、分页总数、召回效果及积分核对;真实网页从检索到跟进的完整演示 | | D3:企业、项目和文件 | 四入口、主体选择、单/双企业、采购方历史、项目快/完整模式、来源与引用检查、局部补查、文件解析/视觉调用、预算暂停、父子任务 | 同名真实企业和双公司报告核验;真实标题/链接/文件三路研判;真实扫描件/复杂标书质量;自然语言任务路由尚缺 | | D4:恢复和交付 | 历史会话 CRUD、固定快照单项目/整批问答、到期/手动文件清理、删除审计、取消/重启中断、SSE 重放、用量读取、代表性格式和异常测试、运行文档 | 指定环境 MySQL/SSE 代理与重启验收;供应商真实账单;真实文件矩阵;超大问答分段汇总、审计保留期执行和文档一致性仍有差距 | 列表摘要目前是已有正文的规则摘录,并非逐公告模型总结;代码和界面已说明这一口径。无正文会提示缺口。这不应被宣传为读完标书后的完整 AI 研判。 ## 直接影响启动和真实业务的缺项 ### 1. 数据库和首次管理员配置 本轮检查时,后端目录只有 `.env.example`,没有 `.env`;当前工具进程未设置 `DB_URL`、`DB_USERNAME`、`DB_PASSWORD`、`ADMIN_INITIAL_PASSWORD`、`ZLBX_API_KEY`、`DEEPSEEK_API_KEY`。未读取其他项目的凭证,也没有据此断言用户的其他主机或 IDE 不存在配置。 本机 3306、8240、3000 未观察到监听进程;这只描述本轮检查时的本机状态,不排除远端数据库或非默认端口。 要先运行登录、档案和本地业务接口,需要: 1. 可连接的 MySQL 8 数据库,建议空库 `rz_gb`、字符集 `utf8mb4`。 2. 应用账号具有该库迁移建表、索引和读写权限。 3. 配置数据库三项变量;首次设置管理员密码,至少 12 字符、UTF-8 最多 72 字节。 4. 显式导出环境变量再启动;Spring Boot 不会自动读取 `.env`。 5. 实际执行 Flyway V1–V7,登录并保存档案,重启后再次读取,证明 MySQL 持久化有效。 证据:[application.yaml](../src/main/resources/application.yaml:14)、[SecurityConfig.java](../src/main/java/com/example/rzgb/auth/SecurityConfig.java:34)、[运行说明](../README.md)。本机已具备 Java 21、Maven、Node/npm,不需要把这些再次列为未安装的软件。 ### 2. 知了与 DeepSeek 真实服务 完整检索、获客、企业情报、联网研究、模型问答和扫描件解析,还需要后端 `ZLBX_API_KEY`、`DEEPSEEK_API_KEY`,并确认账户余额、接口使用权限和部署主机网络可达。 不能只补密钥就宣布完成。必须用少量请求核对真实响应与当前适配契约:`data.items`、企业/聚合字段、`meta.cost_units`、实际模型标识、token usage;然后再跑完整工作流。如果字段不同,需要修改适配与对应测试。 本轮查阅的知了官方 API 概述与 DeepSeek Search/Fetch、视觉文档支持代码采用的基础路径、认证方式及能力方向,未发现足以直接判定这些能力不存在的依据;但这不能证明当前账号权限、具体工具参数或真实效果已经通过。 - [知了官方 API 概述](https://ai.zhiliaobiaoxun.com/docs/api) - [DeepSeek Search](https://api-docs.deepseek.com/api/search/) - [DeepSeek Fetch](https://api-docs.deepseek.com/api/fetch/) - [DeepSeek Vision](https://api-docs.deepseek.com/guides/vision/) ### 3. 指定环境的启动和代理 本地开发需实际启动后端 8240 和前端 3000。部署构建产物时需配置静态站点、路由回退及同源 `/api` 反向代理;SSE 关闭代理缓冲并允许长连接。HTTPS 部署启用安全会话 Cookie。 当前按单实例设计运行,内存登录会话在重启后失效,需要重新登录;这与业务数据是否持久化是两回事。多实例调度和生产高可用不在本期,不是本地单实例启动的前置条件。 操作见 [接口契约与运行交付](接口契约与运行交付.md)。 ## 除环境以外,确认存在的计划差距 | 项目 | 原计划/需求 | 当前实现与影响 | 建议 | | --- | --- | --- | --- | | 自然语言统一任务入口 | 自然语言与场景表单统一进入意图、参数确认和工作流 | 前端根据所选场景直接指定 operation/workflow;后端接收显式类型,没有自然语言意图解析及条件提取。输入完整企业名/标题可用,但一句“找浙江近三个月的水务项目”不会自动转成对应查询 | 若保留原需求,补意图路由、结构化参数预览/确认和歧义补问;在此之前明确只支持场景表单 | | 超大整批问答 | 超上下文时分段汇总并展示覆盖范围 | 已冻结全部候选,但超过 600,000 字符时返回 `QA_CONTEXT_LIMIT`,要求改单项目;没有分段汇总。普通大小批次仍可用 | 增加分段与最终汇总,保留各段覆盖对象、引用及费用;或明确收窄需求 | | 手动导入项目后关注 | 计划草案含 URL/投标文件解析预览,确认后关注 | 已有标题/URL/文件研判入口,但没有独立 `/projects/import` 及手动导入后进入关注的完整链路;关注依赖已经存在的 project。交付文档承认未提供该接口 | API 名称可以调整,但若保留该业务需求,需补解析预览、确认落库及关注闭环 | | 审计数据保留期 | 需求建议审计元数据 180 天,可配置 | `auditRetentionDays` 可配置且对外显示,但代码未消费该值执行归档/删除;原件/全文/派生图片清理已实现。不能把“配置为 180 天”理解为届时自动清理 | 明确保留范围和引用关系后补归档/清理,或说明目前长期保留 | | 文档及检查收尾 | 交付说明应与最终功能一致 | 前端 README 开头仍说 D3 是原型、按钮不发深查,末尾又描述 D3/D4 已接入;全量 lint 也未通过 | 更新过期说明,处理遗留 lint;不阻塞已通过的构建,但不能称全部工程检查通过 | 定位:[ResearchPage.tsx](/Users/ruzhoukeji/rz-GB-web/src/pages/ResearchPage.tsx:70)、[TaskRequest.java](../src/main/java/com/example/rzgb/task/TaskRequest.java:10)、[SnapshotQa.java](../src/main/java/com/example/rzgb/conversation/SnapshotQa.java:58)、[文件清理](../src/main/java/com/example/rzgb/files/BidFileService.java:76)、[AppProperties.java](../src/main/java/com/example/rzgb/config/AppProperties.java:18)。 已额外确认:深挖串行控制不是缺项。`TaskService.validateParent` 已在父任务锁内检查同批最多五个子任务、已有未结束子任务则拒绝新建。前端当前逐个进入对象,没有批量勾选界面;本轮不把批量界面当作串行能力缺失。 ## 本轮实际执行的检查 | 检查 | 2026-10-29 本轮结果 | | --- | --- | | Java 21,`mvn -o -q -Djava.awt.headless=true verify` | 通过;102 项,0 失败、0 错误、0 跳过;后端 JAR 存在 | | 后端测试范围 | 基础 29、排序 5、摘录匹配 5、研究工作流 17、文件解析 30、D4 集成 16 | | `npm run build` | TypeScript 与 Vite 通过,生成 dist;主 JS 554.06 kB,存在大于 500 kB 的体积提示 | | `npm run lint` | 未通过,8 个错误,集中在既有 UI 组件导出规则及 sidebar 渲染期间 Math.random | | 两仓库 `git diff --check` | 通过;没有因此修改或清理已有未提交代码 | | 当前配置与默认端口 | 当前进程缺上述数据库和供应商变量;后端无 .env;默认端口未见监听 | | MySQL、真实供应商、真实标书和部署代理 | 未执行,不记为通过 | | 浏览器完整业务演示 | 本轮未重跑;D3/D4 文档保留的是此前 H2 + 本机模拟 HTTP 的浏览器记录 | 首次后端测试因沙箱不允许监听本机临时 HTTP 端口而失败;允许测试在沙箱外使用本机端口后,同一命令全部通过。测试使用 H2 和本地模拟服务,没有外部收费请求。日志:`/tmp/rzgb-review-maven-approved.log`、`/tmp/rzgb-review-web-build.log`、`/tmp/rzgb-review-web-lint.log`。 ## 建议执行顺序与通过标准 1. **先让基础服务启动**:配置 MySQL/管理员、运行迁移,验证健康检查、登录、档案读写及重启持久化。 2. **再验证真实依赖**:少量核对余额、公告检索/详情、企业搜索/画像、文本/JSON/流、Search/Fetch、视觉;对照响应修正适配。 3. **跑完整业务闭环**:检索→获客→关注状态/标签→企业及双公司→项目快/完整研判→标题/URL/真实文件→会话与整批提问,核对来源和账单。 4. **补齐保留的计划差距**:自然语言、超大问答分段、手动项目关注、审计保留期;更新交付文档和 lint。 5. **指定环境验收**:代理下 SSE 断线恢复、重复提交、预算暂停/取消、进程重启、原件过期/删除与复杂真实文件。每项有脱敏证据后再更新 A01–A20 的真实验收列。 当前可以确认“核心代码和本地回归具备”,不能确认“真实业务已经正常运行”或“四天计划 100% 完成”。