# 如昼商机助手:四天开发计划 编制日期:2026-10-26(北京时间) 适用范围:[需求分析与 Skill 集成方案](./需求分析与Skill集成方案.md)中的已确认需求。 执行方式:由 AI 完成两个项目的代码、必要测试与联调;D1–D4 指开工后的四个开发日,不假定已确定具体开工日期。 ## 1. 交付目标与排期前提 第四天交付一个可在指定测试环境运行的版本:预设 admin 登录;发现商机与检索方案;带真实招投标检索调用的获客报告;四类调研入口;企业情报与双公司对比;具体项目投标研判;指定格式投标文件解析;重点关注八状态;手填公司档案;历史会话;可回查的来源与实际消耗。 本次改版的主链路是: `输入/场景卡 → 意图与参数确认 → 受控 Skill 工作流 → 真实数据 → 标准化与证据 → 结论/报告 → 用户选择深挖或跟进` 本计划按单条 AI 实施主线估算,每天约 8–10 小时的集中开发与验证,约 32–40 小时;这是排期估计,不是对外部服务可用性或固定工时完成全部需求的保证。用户无需承担开发工作,但真实服务的凭证、余额和部署环境必须可用。 | 前置条件 | 最晚验证点 | 不满足时的处理 | | --- | --- | --- | | MySQL 可连接、Java 21、Maven、Node/npm 可运行 | D1 前段 | 先修复环境;数据库未真实连接不能算持久化完成 | | 知了数据 API 凭证、余额、应用使用权限可用 | D1 中段 | 保留适配开发与契约测试;暂停真实数据验收并记录阻塞,不替换为演示数据通过 | | DeepSeek 文本、视觉和 Search/Fetch 可用 | D1 中段 | 分别记录可用项;联网和扫描件不能因文本模型可用而自动视为通过 | | 指定格式的可解析测试样例 | D1 准备,D3–D4 验收 | 可创建无敏感信息的自测样例;真实资料不足时明确样本局限 | | 三个 Skill 版本及关键工具参数锁定 | D1 | 使用提供的版本;实测字段差异记录在适配层,不在线悄悄升级工作流 | 本期不增加全网站爬虫、第四个 Skill、定时通知、注册、多租户、自动报名/投标、标书生成、报价自动执行、报告对外分享服务。公司档案文件导入按最新确认关闭。 ## 2. 四天里程碑总览 | 日期 | 主目标 | 后端交付 | 前端交付 | 当日可演示结果 | | --- | --- | --- | --- | --- | | D1 | 工程与真实服务打通 | 数据迁移、admin 会话、档案/关注基础接口、统一任务骨架、数据与模型小样本验证 | API 客户端、登录、手填档案、任务状态基础组件 | 正确密码登录;档案落库;发起一条真实数据/模型任务并回查记录 | | D2 | 招投标检索与获客闭环 | 召回分页、去重、方案快照、排序、摘要与匹配度、关注事务 | 发现商机、获客表单/报告、方案 Tab、关注八状态与标签 | 全国近 90 天真实获客;偏好不漏掉其他候选;关注后可查看变更历史 | | D3 | 企业情报与项目研判闭环 | 同名确认、单/双企业工作流、投标快/完整模式、文件解析、公开资料补充、预算暂停 | 四个调研入口、主体选择、项目文件、真实流式轨迹、显式深挖按钮 | 从获客结果选择采购方背调,再对具体项目研判;无自动深挖 | | D4 | 全范围验收与交付 | 格式补齐、清理/删除、恢复/错误处理、审计核对、集成验证 | 历史会话、整批提问、断线/失败/预算提示、来源和覆盖范围完善 | 完整业务演示+格式矩阵+异常用例+真实服务证据+运行说明 | 前后端每天联调,不把界面接入集中到第四天。D4 主要用于补齐和验收,不应到 D4 才首次尝试联网、视觉或文件解析。 ## 3. D1:基础工程、账号与服务验证 ### 3.1 前段:本地运行与数据边界 1. 检查项目实际 JDK、Maven、Node/npm 及 MySQL。当前静态检查显示后端目标 Java 21,主机另有其他 JDK,开发命令需明确使用兼容版本。 2. 补齐后端数据库访问、迁移、输入校验、安全配置及统一错误返回;明确前端代理 `/api`,不要把外部密钥放进 `VITE_*`。 3. 建立用户、公司档案、公告/批次、关注与历史、方案、会话、任务/事件、工具调用、证据、临时文件等必要表;按可独立验证的模块拆分迁移。 4. 实现预设 admin 初始化、密码哈希、登录/当前用户/退出、会话和 CSRF;初始密码从部署环境提供,配置示例只保留占位符。 5. 实现公司档案读取/保存、版本与完善状态;前端接入登录和八组表单,关闭原 AI 导入入口,停止自动加载演示公司。 ### 3.2 后段:先验证真实依赖,再展开业务 1. 封装知了白名单工具客户端,正确设置各工作流的 `X-Client`;区分传输失败、业务失败、余额不足和无结果。 2. 在可用凭证下进行少量真实请求:余额、公告检索/详情、企业主体搜索及代表性画像响应;记录脱敏后的字段契约、返回时间、状态和计费字段。不要跑全量深度报告来验证一个字段。 3. 验证 DeepSeek 最新模型的真实文本请求、结构化输出、流式响应;分别验证 Search/Fetch 和一张非敏感样例图的视觉解析。记录实际返回模型标识与 token usage。 4. 实现统一任务的创建、状态查询、幂等、必要补问、实际工具调用记录、有序事件与基础 SSE。明确“计划调用”与“实际调用”不同。 5. 实现关注基础增删与关联权限;为 D2 的状态事务和标签联调准备稳定接口。 6. 前端建立统一请求和错误处理、任务事件订阅基础组件,清除对“本地 authed 即已登录”的依赖。 ### 3.3 D1 验收门槛 - 错误密码不能登录,未登录不能读取档案/任务/文件;退出后会话失效。 - 保存档案后刷新页面、重启后端仍可读取;完善状态与版本由后端决定。 - 有一份脱敏的真实依赖验证记录,分别注明知了、DeepSeek 文本、联网、视觉是否通过,不能只写“API 已打通”。 - 同一幂等键重复创建不多扣一次费用;一次实际工具请求对应一条可追溯调用记录。 - 明确首版分页/调用/积分及文件保护值,写入配置与接口说明。 ## 4. D2:发现商机、获客与人工跟进 ### 4.1 招投标检索工作流 1. 实现统一条件对象,把基础硬条件与偏好拆开。对话默认全国/近 90 天;提供今天、近三天、近一周、近一个月、近半年、近一年和自定义范围。 2. 明确 UI 关键词组合方式,适配上游 OR/AND;地区和金额单位集中转换,校验金额非负、上下限和日期范围。 3. 拉取预算允许的分页,再对已拉取集合去重和排序;记录平台总命中数、已取数、去重数、展示数、截断原因。继续检索追加同一范围的新页,不重跑已成功页。 4. 标准化采购方、预算、公告阶段、原始来源和缺失字段;可靠编号归并公告阶段,不因标题相似而错误合并项目。 5. 区域市场复用检索和聚合工具,输出买方、供应商和时间趋势;关键词缺失时显示实际水行业关键词集合。样本统计与全库聚合明确区分。 ### 4.2 获客、列表分析与检索方案 1. 新增获客输入:关键词、时效、四种推荐方式,地域/金额作为可选偏好。初始报告只执行招投标检索工作流。 2. 原检索保持发布时间顺序;获客使用版本化相关度与偏好排序,附排序原因。未知金额/地区不丢弃,换偏好不得改变基础候选集合。 3. 有正文时生成建设内容、地区、节奏、资质业绩等结构化结论;无正文时显示信息缺口。批次较大时摘要分批执行并显示进度,不能为列摘要自动执行完整投标决策。 4. 四维匹配分与权重落到后端,保留依据、完整性及档案版本;修复默认规则不能产生 90 分以上样例的问题。评分、模型失败不影响检索列表正常显示。 5. 保存/编辑/删除方案和手动执行;执行记录绑定固定条件、项目版本/必要字段及有序结果。切换 Tab 读取历史快照,不按最新条件临时重算。 6. 前端联调发现商机表格、摘要、来源、获客报告和方案 Tab;为企业情报、项目研判提供明确的深挖按钮,按钮点击前不发起深查。 ### 4.3 重点关注闭环 1. 关注与取消关注、标签管理及筛选;关注唯一约束避免重复。 2. 状态/备注/历史在同一事务写入,支持八状态人工跳转、暂不考虑后恢复、备注单独编辑留痕;采用版本检查避免两次保存互相覆盖。 3. 跟进中、已有结果、暂不考虑三个页面分组统计正确;截止或 AI 结论变化不自动改状态。 4. 前端接入取消关注的既有确认交互;明确它删除关注历史但不删除公告和独立报告。 ### 4.4 D2 验收门槛 - 不提供地域偏好时全国召回;选择浙江偏好后,非浙江高相关项目仍保留;金额未知项目也保留。 - 获客初始报告有实际招投标工具请求,企业情报与投标决策调用数为零。 - 普通检索的顺序不随档案/权重变更而改变;获客排序原因可解释。 - 页面能区分“平台命中 800 条、本批读取 250 条、去重 210 个”,不会宣称全量排名。 - 用标为测试的数据验证精确权重计算与高分呈现;真实结果不为验收硬造高分。 - 页面完成检索→关注→准备投标→已报名→提交→结果,并可恢复、编辑备注和回查历史;重复提交不重复记历史。 ## 5. D3:企业情报、投标研判与文件 ### 5.1 企业情报与双公司对比 1. 实现主体定位与候选选择;多候选停在等待确认,不因第一条记录量大就自动认定,也不自动将集团分支混入统计。 2. 实现基础画像、业务关键词、客户供应商、中标表现、竞对及公开资料补充;Top 竞对仅轻查,不递归展开。 3. 双公司对比只比较两家已经确认的主体;共同客户和交锋事实来自真实数据,行业头部不能冒充直接竞对。 4. 单/双企业分别设置调用与积分预算;追问只补查相关部分,不重新跑整份深度工作流。 5. 接入 DeepSeek Search/Fetch 补充官网、公开新闻及风险信息;每个事实保留来源。未查到公开风险不能转成“无风险”。 ### 5.2 具体项目与投标决策 1. 支持知了公告链接、其他公开公告链接、完整标题或投标文件;定位歧义时让用户选项目。 2. 实现项目画像、采购方历史、潜在竞争者、历史价格参照、可选我方适配;“快速判断”与“完整研判”有明确步骤和预算差异。 3. 服务类或无品牌型号时不伪造品牌价;不同规格、总价与单价不能混合计算。没有成本和可比样本时输出缺口,不生成利润承诺或精确胜率。 4. 在获客结果中显式选择企业/项目后创建父子任务,把深度结果追加在对应对象下;首批建议 3 个、最多 5 个对象,逐个执行。 5. 报告绑定事实/推断、证据 ID、样本范围和实际调用;生成后校验引用和关键数字。 ### 5.3 文件链路与真实轨迹 1. 建立仅供投标项目的上传、类型检测、权限、解析、过期及删除流程;文件先归属当前用户,绑定指定项目任务后不能串用到其他用途。 2. 接入成熟库提取文本、Office、表格、幻灯片和文字 PDF;按页/工作表/幻灯片保留证据定位。首日选型,D3 先跑完全部格式的代表性样例,D4 修复边界。 3. 扫描页渲染后使用 DeepSeek 视觉解析;混合 PDF 按页决定路径。限制大小、页数和视觉页数,超限提示拆分而不是静默截断。 4. 前端新增第四个“评估投标项目”入口,四入口均复用统一任务组件;展示必要补问、主体选择、预算暂停、工具动作与报告片段。 5. 删除 `runSkillTrace` 的伪造执行用途;后台未实际发请求时不能出现“已调用”。可展示加载动画,但文案必须对应真实状态。 ### 5.4 D3 验收门槛 - 输入同名企业时可以选主体;未选之前没有发生后续企业深查扣费。 - 单公司、双公司、区域市场、项目评估四个入口均有真实完整链路;正常输入两步内能发起任务。 - “了解采购方”仅执行企业情报工作流;“深入研判”仅执行项目决策工作流,内部工具调用照实计入,不冒充另一 Skill 被调用。 - 至少完成标题、公开链接、投标文件三条项目输入路径;站内未核实时如实说明资料来自用户文件。 - 一次预算暂停可确认继续,取消后不再发出后续工具请求;已发生的费用不因取消而清零。 - 页面流式事件与后台调用记录可逐条核对,报告不展示私有推理链。 ## 6. D4:完整验收、异常恢复与交付 ### 6.1 功能补齐与边界验证 1. 完成会话新建、搜索、自动标题、重命名、删除,以及原单项目/整批 AI 提问;整批始终绑定检索快照,不只读当前页。 2. 补齐格式矩阵的全部代表性样例、扫描/混合页、中文文本、表格以及错误文件。原公司档案导入入口不得残留可用路径。 3. 实现原件/临时图片/提取全文过期清理、手动删除及必要删除审计;删除原件与报告摘录的范围分别提示。 4. 联调 SSE 断线重连、幂等、重复点击、取消、服务重启后的中断状态;重连不能重新触发收费调用。 5. 核对任务报告中的筛选条件、日期、范围、来源、事实/推断、工具调用、积分和模型 token。缓存读取不得显示为新一次调用。 6. 覆盖无结果、字段缺失、认证失败、余额不足、限流、超时、部分成功、外部网页不可达;每种情况提供调整条件、补充信息、重试或查看已有结果的下一步。 ### 6.2 联调演示脚本 1. 使用 admin 登录,手动填写公司档案,调整四维权重并刷新验证。 2. 选择智慧水务关键词,使用全国/近 90 天生成获客报告,查看真实调用、条件、覆盖范围、来源和成本。 3. 切换地域/业务/金额偏好,对比同一候选集的顺序,检查未知预算保留。 4. 保存并执行检索方案;切换历史 Tab,验证固定条件和结果快照。 5. 选择一个采购方做企业情报,遇到多候选则确认;再发起双公司对比。 6. 对一个项目分别使用快速判断和完整研判;切换标题/链接/文件三种输入方式,检查证据定位。 7. 加入重点关注、打标签、经历八状态中的代表路径,查看备注与历史;AI 不改变状态。 8. 断线恢复和重复提交,证明不会重复发起同一收费请求;模拟额度不足、无结果和服务失败。 9. 新建、重命名、搜索、删除历史会话;删除投标原文件,验证清理与审计,不混淆报告摘录。 真实业务演示与可重复异常测试分开记录。固定测试样例可验证边界,但不能代替真实数据与模型联调。 ### 6.3 交付物 - 两个仓库中的实现代码、数据库迁移和必要测试;按用户要求补充详细中文业务注释。 - 后端运行文档、前端运行文档、环境变量示例;示例不得包含真实密钥和固定弱密码。 - 接口契约说明,明确分页、事件、幂等、错误、金额/日期单位与任务确认流程。 - 三个 Skill 版本、实际工具映射、真实 API 差异与预算设置记录。 - 格式验收矩阵、异常用例结果、真实接口联调记录和未完成项清单。 - 前端构建产物或明确构建方式、数据库初始化方式及测试环境启动步骤;不把原免构建 HTML 演示页视为后端交付。 ## 7. 计划中的接口契约 以下接口是待实现设计,不代表当前后端已经存在。统一前缀 `/api`,所有业务资源按当前账号鉴权,状态改变请求需匹配会话和 CSRF 策略。 | 模块 | 接口建议 | 关键行为 | | --- | --- | --- | | 登录 | `POST /auth/login`、`GET /auth/me`、`POST /auth/logout` | admin 验证、恢复会话、会话失效 | | 档案 | `GET/PUT /company-profile` | 八组字段、完整性、版本、四维权重;不提供文件导入 | | 公告检索 | `POST /searches`、`GET /searches/{id}`、`GET /searches/{id}/items` | 真实执行、查询快照、稳定分页,区分总命中与读取范围 | | 继续召回 | `POST /searches/{id}/continue` | 在预算与相同基础条件下追加新页,幂等,不盲目重复已成功页 | | 公告 | `GET /projects/{id}` | 返回来源、阶段和已取得的结构化内容 | | 手动项目 | `POST /projects/import` | URL 或已上传投标文件二选一,解析预览;用户确认后关注 | | 检索方案 | `GET/POST /search-schemes`、`PUT/DELETE /search-schemes/{id}`、`POST /search-schemes/{id}/runs` | CRUD 和手动执行,执行结果绑定批次 | | 关注 | `GET /watch`、`POST/DELETE /watch/{projectId}` | 分组与筛选;取消关注沿用确认语义 | | 状态历史 | `POST /watch/{projectId}/changes`、`GET /watch/{projectId}/history` | 状态/备注/版本/幂等键,原子写入 | | 标签 | `GET/POST /tags`、`DELETE /tags/{id}`、`PUT /watch/{projectId}/tags` | 标签唯一、删除解绑、按账号隔离 | | 会话 | `GET/POST /conversations`、`PATCH/DELETE /conversations/{id}`、`GET /conversations/{id}/messages` | 搜索、标题、消息与任务历史 | | Agent 任务 | `POST /agent/tasks`、`GET /agent/tasks/{id}` | 场景卡/自然语言统一创建,含意图、硬条件、偏好和父任务 | | 确认/取消 | `POST /agent/tasks/{id}/continue`、`POST /agent/tasks/{id}/cancel` | 主体/参数/预算确认,显式选择、幂等、合法状态校验 | | 轨迹/报告 | `GET /agent/tasks/{id}/events`、`GET /agent/tasks/{id}/report` | SSE/重放、结构化结果、Markdown、证据与实际费用 | | 文件 | `POST /files`、`GET/DELETE /files/{id}` | 仅投标用途,类型/大小/归属/过期,删除覆盖临时派生物 | | 用量 | `GET /usage` | 本地任务账本和平台余额分别标注,明确统计范围与未知费用 | 任务状态、事件和核心对象在 D1 先出最小契约,前端按此接入;D2–D3 的新增字段向后兼容。前端不得直接调用知了或 DeepSeek,也不在前端重新计算权威分数和成本。 ## 8. 验收矩阵 所有行均属于本期目标;“未验证”或“失败”不可在交付时改写为“通过”。 | 编号 | 验收项 | 判定证据 | | --- | --- | --- | | A01 | 预设 admin 的真实鉴权与退出 | 正误密码、未登录资源访问、退出后失效记录 | | A02 | 原功能保留与持久化 | 页面刷新/服务重启后档案、关注、方案、会话仍在 | | A03 | 四调研入口两步发起 | 客户、竞对、区域、项目的界面操作记录;歧义按规则补问 | | A04 | 获客必调招投标检索 | 新任务存在真实外部请求、响应记录和对应报告 | | A05 | 初始报告不隐式深挖 | 企业情报/投标决策工作流启动次数为零 | | A06 | 偏好不误作过滤 | 固定候选数据下地域/金额偏好变化前后集合一致,未知字段仍在 | | A07 | 两场景排序分开 | 原检索时间倒序;获客排序有依据;匹配分不重排原列表 | | A08 | 分页与“找全”边界 | 总命中/已读取/去重/截断提示准确,统一排序覆盖已读全部分页 | | A09 | 主体确认与上下文冲突 | 同名候选可选,确认前无深查;新旧条件冲突可选择 | | A10 | 双企业对比与项目研判 | 真实来源数据、对比口径、项目结论/风险/缺口与事实对应 | | A11 | 轨迹真实且不泄露私有推理 | 每条实际动作对应后台记录;无预设假调用、密钥或私有推理链 | | A12 | 来源与事实/推断分层 | 引用能定位工具记录/文件页;模型未知链接被拒绝或标缺口 | | A13 | 成本与预算 | 次数/积分/token 分账,实际扣费字段保留,超预算能暂停继续 | | A14 | 八状态与历史 | 状态/备注同事务、人工跳转/恢复、重复提交和冲突保存用例 | | A15 | 全格式与损坏文件 | TXT、MD、CSV、HTML、DOC、DOCX、XLS、XLSX、PPT、PPTX、文字/扫描/混合 PDF、JPG、PNG、WebP、GIF 各有样例与结果 | | A16 | 文件用途、清理与删除 | 档案导入关闭;文件不能跨任务使用;到期、手动删除及派生文件清理记录 | | A17 | 无结果/缺数/失败 | 页面有数据边界、已有结果和可执行下一步,无空白或虚构回答 | | A18 | 幂等、重连、取消与重启 | 重放不二次收费,取消停止后续步骤,重启中断任务不显示成功 | | A19 | 会话与检索快照 | 搜索/重命名/删除、旧条件回查、整批问答覆盖实际批次 | | A20 | 匹配分正确性 | 非法权重拒绝、只舍入一次、档案版本可查、高分测试样例明确标为测试 | ## 9. 验证命令与测试分层 后端先执行与当前修改相关的单元/集成测试,再完成 Maven 的 `test`/`verify`;前端完成 `npm run build`,并检查本次改动相关的 lint。实际命令与版本在实施时记录,不把命令列在文档里等同于已运行。 重点自动化覆盖:条件与偏好分离、关键词映射、金额转换、日期边界、分页去重与阶段归并、权重计算、同名等待、幂等计费、状态/备注事务、引用校验、权限和文件清理。外部接口使用记录过的脱敏样例做契约测试,另用受控的真实请求验证集成。 界面验收从浏览器执行完整业务链路,至少检查加载、空态、错误、暂停、取消和报告引用。只通过编译不能证明 Agent 路由、真实数据、视觉解析或跟进闭环已经正确。 ## 10. 风险、缓冲与变更规则 | 风险 | 对排期的影响 | 处理方式 | | --- | --- | --- | | 第三方接口字段/价格与 Skill 文档不一致 | 适配和成本计算返工 | D1 小样本锁定契约;预计成本标来源版本,实际成本读响应 | | 全国近 90 天命中很多 | 召回耗时、额度和排序覆盖扩大 | 有界分页、继续检索、明确本批覆盖;不能靠静默漏页“优化” | | Office 老格式、混合 PDF、扫描件质量差 | 文件集成与验收工时增加 | D1 验证视觉,D3 跑全部格式代表样例;D4 只修边界,无法识别明确失败 | | 同步深查多个企业/项目 | 额度和执行时间快速增长 | 初始报告不深查;用户选择后串行,建议 3 个、最多 5 个 | | 全范围功能集中四天 | 稳定性缓冲较少 | 每日门槛必须真实通过;D4 留出回归,不新增第四个 Skill 或生产运维范围 | | 凭证/余额/网络不可用 | 无法完成真实联调验收 | 记录阻塞与恢复条件;独立开发继续,不用模拟成功掩盖未完成 | 若 D1–D3 门槛未通过,先修复主链路,再按实际剩余工时重排。不能擅自把已确认的文件格式、八状态、双公司对比或真实调用删除;需要缩小范围时提交具体未完成项、原因及替代排期,由用户决定。四天结束时逐项报告“通过/失败/未验证”,真实服务验收未通过则不宣称全部交付。