# D3 实施与验收 日期:2026-10-28(北京时间)。本次继续现有 D1/D2 未提交代码,没有重置或覆盖已有成果。 **状态:前后端代码、本地自动测试和浏览器联调已完成;真实 MySQL、知了、DeepSeek 账号联调未验证,因此不能把 D3 的真实服务验收门槛标为通过。** 本地 HTTP 模拟请求只用于可重复测试,不是实际供应商数据或计费凭证。 ## 1. 已实现范围 ### 企业情报与双公司对比 - `COMPANY_RESEARCH` 固定使用 company-intel 1.0.2。先查询企业候选;完整返回范围中仅有一个且全称精确匹配时可以自动确认。多主体、简称或模糊匹配均等待选择,不按记录量选择第一条。 - 双公司必须全部完成主体确认后才启动后续画像;两个主体不能相同。确认值与本任务候选比对,确认后锁定,预算继续不能把旧事实拼到新公司上。 - 基础画像、业务词、客户、供应商、中标明细、年度聚合和真实投标重叠竞对分别实际请求。历史明细与伙伴只覆盖返回页/Top20,不声称已取全量。单企业 Top3 竞对仅查基础画像,不递归展开。 - 双公司共同客户为两家客户样本的企业全称交集;交锋事实展示竞对工具原始 `co_bid_count` 等字段。没有交锋数据时不把行业头部当直接竞对。 - 公开资料通过后端 DeepSeek Search 查询,最多三条;首个安全来源再通过 Fetch 获取正文。每条网页来源单独登记证据;未检出风险不等于无风险。 - 已完成企业任务可选择画像、伙伴、业绩、竞对或公开资料局部追问。子任务复用经过校验的确认主体缓存,账本明确显示 `LOCAL / ENTITY_CACHE`,只补查选定部分,不重复执行整份工作流。 ### 项目研判 - `BID_RESEARCH` 固定使用 bid-decision 1.0.4。支持完整标题、知了公告链接、其他公开公告链接及投标文件。普通公开链接先 Fetch,再使用公开标题站内定位;知了链接走详情工具原生 `bid_url` 参数,不自行删改签名。 - 公告或采购方有歧义时等待候选选择。快速模式取得项目正文、采购方基础画像与证据建议;完整模式增加采购方历史供应商/采购史、潜在竞争者、公开资料,并在明确有品牌及型号时查询历史单价。 - 服务项目或无型号时不查询品牌价格;不混算项目总价、设备单价或不同规格,不产生利润承诺和精确胜率。 - 创建项目任务时冻结我方档案;档案完善且取得公开项目正文时复用既有四维规则输出我方适配、完整性、依据与档案版本。评分不是资格认定或胜率。 - 文件没有完整公开标题时可先创建任务,再等待补充;不会把文件全文送到公开搜索。无站内结果时保留文件/公开网页事实并明确未核实。文件与公告是否完全一致、是否最新版,仍需人工核对。 - 获客结果的“了解采购方”“深入研判”先展示对应输入,用户显式发起后才创建父子任务。后端检查账号、批次及所选对象,每批最多五个、串行执行;结果链接显示在原对象下。初始获客报告不隐式深查。 ### 文件与真实轨迹 - 上传只接受 `BID_PROJECT`,取当前会话账号为归属;沿用 CSRF。首次绑定后不能转移至另一个任务,公司档案导入不开放。 - 使用 Apache POI 5.5.1、PDFBox 3.0.8、jsoup 1.21.2 与 TwelveMonkeys WebP 解码。正文按段落/工作表与行/幻灯片/PDF 页保留定位;不伪造 Office 页码。依赖依据:[POI 提取文档](https://poi.apache.org/text-extraction.html)、[PDFBox 3 迁移文档](https://pdfbox.apache.org/3.0/migration.html)。 - 文字 PDF 本地提取,扫描页渲染后逐页视觉;同页存在文字页眉和大幅扫描图时仍走视觉。图片按帧解码,GIF 不只读取第一帧。Office 宏、HTML 脚本和外链不执行。 - 默认最大原件 20 MiB、PDF 50 页、视觉 20 页、提取全文 200,000 字符;工作表/幻灯片数复用 50 上限;临时解析图片总量最多为原件大小保护值的两倍(默认 40 MiB),按段检查。压缩包保留 POI 的压缩比防护,并限制单项解压大小。超限明确要求拆分,不静默截断。 - 原件、提取全文、临时页图都保存在数据库,24 小时到期或手动删除时统一清空,写入删除审计。任务报告必要摘录与调用账本保留,界面明确提示这一范围。 - 四个入口共享真实后端 SSE 和事件游标;移除 `runSkillTrace` 及原调研模板回答。收费步骤先落 STARTED,再发 HTTP;报告只展示持久化事件与已保存结果,不展示私有推理。 ## 2. 预算、恢复与证据规则 - 部署默认外部请求保护值提高为 25、积分保护值为 100;可通过 `TASK_MAX_CALLS` / `TASK_MAX_COST_UNITS` 降低。单企业最多 18 次,双企业和项目最多 25 次,每个任务拥有独立调用及积分预算;实际执行还受部署保护值限制。 - 知了积分、DeepSeek token、联网请求次数分别记录,合计由后端权威计算、前端只展示,不相加为同一费用。缺失费用保持未知;不会用零或预估值冒充实际扣费。 - 达到调用/积分预算时暂停;知了响应缺积分时也暂停。继续时显式确认已发生的请求与未知费用,或增加预算。未知单价的首个请求可能超出积分保护值,不能承诺事前精确控制。 - 每个成功步骤保留唯一快照,继续或幂等重试跳过成功步骤。取消与发请求使用同一任务锁;取消后不再发送后续请求,在途请求照实保存结果和费用。 - 失败/未知结果不自动重试;服务重启仍使用已有的 PARTIAL 恢复规则,避免重放收费请求。 - 事实绑定证据 ID、完整来源 URL、定位和原始快照哈希。报告重建校验所有事实;并发读取时先取步骤,再取来源,避免把刚提交的步骤误判为缺失。 - 模型生成稿属于服务端草稿,不作为事实来源展示。模型建议只允许引用本任务已登记来源;关键数字必须原样存在于引用依据。未通过校验的建议隐藏,任务标为部分完成,保留可核查事实与费用。 ## 3. 新增接口与请求示例 沿用 `/api/agent/tasks`、`/{id}/continue`、`/{id}/cancel`、`/{id}/events`、`/{id}/report`,写请求仍需会话、CSRF 和 `Idempotency-Key`。创建/继续幂等键各自作用于原有任务账本,刷新报告只读,不二次收费。 ```json { "operation": "COMPANY_RESEARCH", "workflow": "COMPANY_INTEL", "input": "", "entityConfirmed": false, "maxCalls": 18, "maxCostUnits": 10, "research": { "companies": ["待研究企业名称"], "selections": {}, "mode": "FULL", "fileId": null, "parentId": null, "targetProjectId": null, "focus": null, "acknowledgedCalls": 0 } } ``` - 项目改用 `BID_RESEARCH / BID_DECISION`、`companies: []`,`input` 为完整标题/公开链接;上传文件时填写 `fileId`。`mode` 为 `QUICK` 或 `FULL`。 - `research.selections` 的键与候选 `choices[].key` 一致,值必须是本任务返回候选 ID。不能用 `entityConfirmed: true` 绕过候选校验;新建任务不能预先提交选择或费用确认。 - 继续沿用完整原请求,只修改合法选择、预算,以及已经发生的请求数 `acknowledgedCalls`。定位后的项目、公司、文件、模式、父任务和追问范围不能改变。 - 局部企业追问使用已完成企业任务 `parentId` 和 `focus`:`profile / partners / performance / competitors / public`。 - 文件:`POST /api/files`,multipart 字段 `purpose=BID_PROJECT`、`file`;`GET /api/files/{id}` 读取本人元数据与提取预览;`DELETE /api/files/{id}` 清理本人原件、全文与临时图片。浏览器不手设 multipart Content-Type,以保留 boundary。报告页在任务结束或取消后提供明确范围的原件删除操作。 - 新增迁移 `V6__research_files.sql`:研究步骤、锁定主体、原件/派生文件字段、删除审计。保留 D1–D2 表和请求指纹兼容,不修改已发布迁移内容。 ## 4. 已执行验证 ### 自动化 - 后端 `JAVA_HOME=$(/usr/libexec/java_home -v 21) mvn -q verify`:**79 项测试通过,0 失败、0 错误**。包括原有 39 项、D3 工作流 17 项、文件解析 23 项。 - 前端 `npm run build`:通过。 - 对本次修改涉及的 TS/TSX 执行 ESLint:通过。包括调研页、统一任务组件、事件订阅、API 客户端、发现商机入口、App、Topbar 及移除演示代码涉及文件。 - 两个仓库 `git diff --check`:通过。 工作流测试覆盖:同名等待前无深查、双公司都确认、唯一精确匹配、非法/锁定选择、单/双企业、快速/完整研判、标题/知了链接/公开链接/文件路径、X-Client 路由、预算恢复幂等、未知积分确认、暂停取消与在途取消计费、局部追问缓存、父子任务五对象及串行约束、篡改证据拒绝、模型引用失败隐藏、视觉实际 HTTP 与隐私字段隔离、文件归属/用途/CSRF/过期/删除。 ### 格式矩阵 | 格式 | 本地代表性样本结果 | 定位/边界 | | --- | --- | --- | | TXT、MD、CSV、HTML | 通过 | UTF-8 中文、GB18030;HTML 不执行脚本;CSV 保留原始行 | | DOC | 通过 | Apache POI 官方开源样本;段落定位,来源及许可证见测试资源目录 | | DOCX | 通过 | 中文段落和表格,明确没有可靠分页 | | XLS、XLSX | 通过 | 中文工作表、行号、数值;伪装后缀拒绝 | | PPT、PPTX | 通过 | 中文文字、幻灯片编号 | | 文字 PDF | 通过 | 本地提取,不额外视觉 | | 扫描 PDF | 通过 | 按页生成视觉输入 | | 混合 PDF | 通过 | 文字页/扫描页分别处理;文字页眉加扫描正文也识别为需视觉 | | JPG、PNG、GIF、WebP | 通过 | 解码后转逐帧视觉输入;WebP 使用实际解码器 | | 损坏、伪装、加密、超页/超全文 | 通过 | 明确失败或提示拆分,没有静默截断 | 这些是代表性合成/开源样本,并非全量真实标书。中文复杂 PDF、低清扫描、GIF 动画合成、Office 嵌入图片/复杂图表、超大表格和复杂布局在 D4 继续扩大样本验收。 ### 浏览器(H2 + 本地 HTTP 模拟服务) 已实际登录测试账号并操作:四入口展示;同名企业只有一次主体查询即暂停;选择分公司后完成工作流;一次调用预算暂停及确认恢复;区域市场入口返回聚合/公告报告;从获客结果创建采购方子任务;multipart 上传非敏感 TXT 并完成文件项目快速研判。检查了真实事件、源链接、消耗、文件定位与缺口文案。 - [企业画像截图](images/D3-企业画像-本地模拟.png) - [文件研判截图](images/D3-文件研判-本地模拟.png) 截图和界面测试资料均明确使用“界面测试”样本,不能当作知了或 DeepSeek 真实业务验收证据。测试服务使用内存数据库,验收后停止,不更改生产数据。 ## 5. 尚未通过的真实验收与 D4 边界 1. 本地没有提供真实数据库连接、知了/DeepSeek 凭证,真实 MySQL 迁移/重启持久化、供应商字段/积分、模型、Search/Fetch 和视觉均**未验证**。需配置后按 D1/D2/D3 文档逐项实测,尤其核对各企业/项目工具的实际字段。 2. 模型事实名字、文件与公告一致性、历史价格可比规格仍需人工核验;服务端引用/数字校验不等于尽调结论真实或来源网站真实。 3. 明细与伙伴限返回首批,公开资料最多三条;共享客户是样本交集,不能称全量共同客户。未返回的事实显示缺口。 4. 多扫描页加完整研判可能达到累计 25 次保护上限,需要拆分资料或在创建时选择快速模式;不能无限增加预算绕过部署保护。 5. 前端构建有主 JS 包超过 500 kB 的体积提醒,构建成功;本次没有扩大到无关依赖清理或全站代码拆包。 6. D4 的完整历史会话 CRUD、整批问答、断线/服务重启场景扩大、全范围真实资料格式/异常验收和部署交付仍按四天计划继续。本次没有把这些项目提前标为完成。