# 如昼商机助手:需求分析与 Skill 集成方案 编制日期:2026-10-26(北京时间) 文档状态:基于本轮已确认范围的开发基线;尚未实现或通过真实接口验收。 配套排期:[四天开发计划](./四天开发计划.md)。 ## 1. 已确认的产品与交付范围 产品面向水行业销售、BD、商务及售前人员,以一个主 Agent 编排三个专用 Skill,完成商机发现、企业调研、项目研判和人工跟进。它提供带证据的辅助判断,最终参与、报价、合作及合规决策由用户作出。 | 项目 | 已确认口径 | | --- | --- | | 交付 | 由 AI 编写后端与前端代码,完成联调;本次任务先交付需求与四天计划 | | 项目 | `rz-GB` 为后端;相邻的 `rz-GB-web` 为前端 | | 数据源 | 本期以三个 Skill 共用的知了标讯 API 为主,不自建各公告网站的全网爬虫 | | 飞书来源清单 | 用户稍后补充,作为后续扩展资料;不作为本期主链路的前置条件 | | 模型 | 接入 DeepSeek 当前最新可用模型;模型名、地址及凭证通过后端配置管理 | | 调研 | 查询真实招中标数据,并按 Skill 工作流补充公开互联网资料 | | 账号 | 预设一个 `admin` 账号,不做注册、组织成员和多租户管理 | | 原有功能 | 保留发现商机、检索方案、列表匹配度、标签、重点关注八状态、公司档案、历史会话 | | 新增功能 | 四个“我要调研”入口;“我要获客”四种推荐方式;统一任务、真实调用轨迹、证据与成本审计 | | 两种排序 | 原检索列表按发布时间顺序展示,匹配度不参与重排;获客报告允许相关度与偏好排序 | | 文件用途 | 最新确认:本期仅允许投标项目文件,公司档案手动填写;原公司档案 AI 导入入口移除或隐藏 | | 文件类型 | TXT/MD、PDF(含扫描件)、DOC/DOCX、XLS/XLSX/CSV、PPT/PPTX、HTML、JPG/PNG/WebP/GIF | “全网”描述数据平台的检索来源,不构成对全部公开公告、全部地区或实时完整性的承诺。“未查到”必须写明查询范围,不能写成“没有”。 ## 2. 现有项目与需求差距 以下为静态代码核对结果,不代表运行测试结果。 | 位置 | 当前实现 | 本期需要补齐 | | --- | --- | --- | | 后端 `pom.xml`、`src/main` | Java 21、Spring Boot 4.1.2、Web MVC、MySQL 驱动;仅启动类和应用名配置 | 持久化、鉴权、业务接口、Skill 工作流、模型与联网调用、任务执行、文件解析 | | 前端 `src/App.tsx`、`LoginPage.tsx` | 任意非空账号密码,本地布尔登录态 | 服务端验证 admin、会话恢复和退出 | | `src/lib/store.tsx` | 项目检索、关注、档案、方案、会话均使用内置数据和 localStorage | 改为后端权威数据;浏览器仅保存必要界面偏好,不自动上传旧演示数据 | | `DiscoverPage.tsx` | 默认近 30 天;档案完善后按匹配度排序;本地每页 8 条 | 原检索移除匹配度重排;增加独立获客入口,默认全国、近 90 天;后端分页 | | `ResearchPage.tsx` | 客户、竞对、区域三个入口;模板回答 | 增加项目评估入口;自然语言与表单统一任务,真实调用三个工作流 | | `useStreaming.ts` | 定时逐字显示文本;定时展示预设 Skill 名称 | 使用后端真实事件与模型流;不能把定时动画当作执行证据 | | `WatchPage.tsx` | 八状态、标签、备注、历史;文件仅保存名称 | 数据落库;状态与备注在同一事务写入历史;项目文件实际解析 | | `ProfilePage.tsx` | 八组表单;文本文件启发式导入 | 保留八组表单与版本,后端判定完善状态;按最新确认关闭文件导入 | | `AiPanel.tsx`、`src/lib/ai.ts` | 单项目和整批模板分析;规则分数 | 绑定实际项目/检索快照,提供有来源的摘要与追问;深度投标决策显式触发 | 原匹配度规则的四维上限分别为 95、90、85、75;默认权重 40/20/20/20 下综合最高 88 分。因此不能原样迁移后声称已满足“90 分以上项目可识别”。需要调整评分标尺并用明确的测试样例验证,不能为制造高分而篡改真实数据。 ## 3. 三个 Skill 的能力与集成方式 ### 3.1 实际交付内容 | Skill | 读取来源 | 实际形态 | 业务职责 | | --- | --- | --- | --- | | tender-search 2.3.0 | `/Users/ruzhoukeji/tender-search-2.3.0/` | SKILL.md 与搜索、企业、市场、账户 API 参数文档 | 搜公告、项目召回、区域市场、采购方/供应商统计 | | company-intel 1.0.2 | `/Users/ruzhoukeji/zlbx-company-intel-1.0.2/` | 工作流、API 速查、报告模板、Python HTML 渲染脚本 | 单企业调研、双企业对比、历史客户供应商与竞对 | | bid-decision 1.0.4 | `/Users/ruzhoukeji/zlbx-bid-decision-1.0.4/` | 工作流、API 速查、报告模板、Python HTML 渲染脚本 | 具体项目参与建议、竞争信号、历史价格参照与风险 | 三个目录不是三个独立 HTTP 服务,也不存在已实现的“一次调用完整 Skill 报告”接口。后端需把其工作流转为受控执行步骤,调用已列出的数据工具,再由 DeepSeek 解释与生成报告。不能只把 Skill 名称放入提示词,就标记为“真实调用”。 主 Agent 是应用内的编排模块,不等于另外部署多个自主 Agent。本期使用明确的工具白名单、输入校验和有限工作流,不引入通用多 Agent 平台。 ### 3.2 数据工具适配 共同数据地址为 `https://mcp-server.zhiliaobiaoxun.com/api_v2/`。数据工具使用 POST,账户余额为 `GET /account/balance`。请求头使用 `X-API-Key`,并按实际工作流保留版本标识: | 工作流 | X-Client | | --- | --- | | 招投标检索 | `zlbx-bidding/2.3.0` | | 企业情报 | `company-intel/1.0.2` | | 投标决策 | `bid-decision/1.0.4` | 重点适配约束: - `search_bids` 的金额条件为 `min_amount/max_amount`;`query_bids_advanced` 为 `min_money/max_money`;聚合接口放在 `filters.min_money/max_money`。上游均以元为单位,前端万元转换必须集中处理。 - 基础关键词数组在上游为 OR;`keyword_groups` 表示组间 AND、组内 OR。不能直接沿用原前端“空格分词全部命中”的规则而不说明。 - 公告阶段与用户跟进状态分开:上游 1/2/4/7/8 等为采购意向、预招标、招标、中标、合同等事实阶段,不自动推进“已报名”等个人跟进状态。 - 搜索分页 `page_size` 最大 50;企业搜索最大 20。API 总命中数、实际拉取公告数、去重项目数、展示数分别记录。 - `find_competitors` 使用已确认企业全称,不能沿用其他工具可传公司 ID 的方式。 - API 返回的公告/企业 URL 原样保留,包括签名参数;日志不记录签名值。原公告网址只有在上游确实提供时展示,不能将平台详情页冒充原发布网站。 - 某些参考文件对竞对字段写法不一致,如 `name/product/caller/province`。首日用真实小样本确认响应,适配层兼容已核实变体,缺字段明确报缺口。 - 业务成功同时检查 HTTP 状态与响应 `success/error`;不得将 HTTP 200 中的额度错误当作无结果。 ### 3.3 产品规则与 Skill 文档的冲突处理 用户在本轮明确的产品要求优先;目录内说明是实现参考,不是自动执行注册、收费查询或扩展产品范围的授权。 | 文档差异 | 本产品处理 | | --- | --- | | tender-search 企业接口说明允许自动合并总部和分支;产品要求同名主体确认 | 多候选进入主体选择,未确认不启动企业深查;未经确认不汇总集团口径 | | 检索说明允许无结果自动放宽时间/关键词 | 原条件结果始终保留;优先提供“一键扩大范围”。如执行补充检索,独立记录新条件,不替换原结果或悄悄改变任务 | | Skill 引导安装 opportunity-radar、标书生成工具或配置持续监控 | 本期只承诺三个已提供 Skill,不安装或转调第四个 Skill,不做自动写标书与监控通知 | | 两个 Skill 默认额外生成 HTML 报告 | 本期核心交付为结构化数据与 Markdown 报告;HTML 属于现成可复用资源,不自动扩大为分享、导出产品功能 | | Skill 含自动注册、设备特征采集流程 | 本产品使用后端预配置凭证;不自动注册、不采集设备标识、不自动充值 | | Skill 的调用次数与积分预算存在不同口径 | 两项分别限额;价格参考仅用于预计值,以响应 `meta.cost_units` 记录实际扣费,未知不记为零 | | 投标工作流包含报价带和竞争结论 | 有可比样本才给历史价格参考;缺少自身成本不能声称利润底线,历史成交特征不能证明违法或确定中标概率 | ## 4. 场景、路由与对话规则 | 入口/意图 | 必要输入 | 主工作流 | 初始交付 | | --- | --- | --- | --- | | 查目标客户 | 一个可确认的企业主体 | 企业情报 | 主营、采购/中标表现、客户供应商、竞对、数据缺口 | | 查竞争对手 | 一个或两个企业主体;我方可选 | 企业情报 | 单企业画像或双企业对比;共同客户与投标重叠证据 | | 查区域市场 | 地区;水务业务词可选 | 招投标检索 | 采购热度、Top 买方/供应商、时间趋势和统计范围 | | 评估投标项目 | 公告链接、完整标题、投标文件三选一 | 投标决策 | 参与建议、竞争信号、历史报价参考、风险及缺口 | | 我要获客 | 至少一个水务关键词;时效默认近 90 天 | 招投标检索,必须真实执行 | 带来源的初始商机报告;不自动调用另外两个工作流 | | 普通公告查询 | 明确关键词与显式筛选条件 | 招投标检索 | 符合条件的公告列表,发布时间倒序 | 具体项目且提问“是否值得投/如何报价”优先项目研判;明确企业的背调/对比优先企业情报;地区、行业、产品与“找项目/看市场”走招投标检索。混合多个业务目标时先让用户选本轮目标,不并行发起多个深度任务。 区域市场未提供业务词时,使用公开展示的水行业基础关键词集合,并写入实际检索条件。API 需要关键词,不能传空数组后假装做过全行业查询。地区未明确时可使用全国默认值,但需在执行前摘要与结果中显示。 每次补问最多 1–2 项,仅询问执行必需的信息。会话继承已经确认的关键词、地区、主体和项目;与新输入冲突时生成选择项,不静默覆盖。已经执行的任务保留条件快照,新确认产生后续任务。 四个调研入口的“两步”验收指正常输入情况下“选择入口 → 提交必要输入”;企业同名确认等必要澄清不通过猜测来省略。 ## 5. 获客的召回、排序与深挖 ### 5.1 硬条件与偏好分离 统一任务必须分别保存 `hardFilters` 与 `preferences`。获客基础召回使用关键词、时效及公告阶段;默认全国、近 90 天,初始阶段按 Skill 默认 `[1,2,4,7,8]` 展示并允许明确选择。 | 获客方式 | 召回行为 | 排序行为 | | --- | --- | --- | | 综合推荐 | 使用相同基础召回 | 关键词相关度为主 | | 地域推荐 | 不把重点省市传为排除其他地区的条件 | 重点省市命中加分;周边范围先用用户确认城市,不虚构实际距离 | | 业务推荐 | 使用用户选择的关键词与可解释同义词集合 | 按标题、标的物、已取得正文的相关性排序 | | 金额推荐 | 不把偏好预算区间传为金额硬过滤 | 已披露预算与目标区间的接近程度加分;未披露预算保留并标“待核验” | 用户明确说“仅限浙江”“必须 100–500 万元”时才升级为硬条件,并在执行摘要说明;不能把档案偏好自动变成硬条件。原普通检索表单的地区与预算仍为用户显式硬条件,保持该场景语义。 实现采用版本化、可解释的相关度与偏好加分,不让模型自由删改候选集。字段缺失不是零金额、不匹配地区或不具备资质;缺失字段不能被判定为负面事实。排序分与公司匹配分为不同字段,不混用。 ### 5.2 “先找全”的可验收边界 先遍历允许的分页,再对已取得候选集统一排序;不能只拉第一页就声称给出了全量 Top 项目。单次调用/积分预算、最大页数与外部接口上限均需记录。 建议开发默认每批最多拉取 5 页、每页 50 条,作为可配置的成本保护值,而不是已承诺的全量规模。若总数超出本批覆盖,结果必须显示“平台命中 N 条,本批已读取 M 条,去重后 K 个项目,排序仅覆盖本批”,提供继续检索动作,不写“全部已找全”。实际页数上限以首日额度验证后锁定。 优先以公告 ID/唯一键去重;跨公告用项目编号、采购方、标段等可靠字段归并,保留意向、变更、候选、中标、合同的阶段链。仅标题相似时标记可能关联,不将两个项目强行合并。归并不得丢失阶段和来源。 市场总量优先使用上游聚合接口。仅有前几页时不得把样本计数或金额累计标成全市场统计;中标结果与合同可能对应同一交易,无法归并时注明按公告统计。 ### 5.3 深挖与原有评分 初始获客报告仅调用招投标检索工作流。用户点击“了解采购方/竞对”后才新建企业情报任务;点击“深入研判”后才新建投标决策任务。每批建议只选择前 3 个,最多 5 个重点对象,串行执行并在预算不足时等待选择,不自动把 Top5 全部深查。 公司档案完善后可计算原列表的四维匹配分:业务贴合、服务地区、金额匹配、业绩与资质;维度名称固定,默认权重 40/20/20/20,可调权重。建议维度得分统一使用 0–100,综合分由后端按未提前舍入的归一化权重计算,最终一次取整;全零或负权重拒绝保存。证据缺失的维度标“待核验”,完整性与得分分开展示。分数不表示已满足硬资质或中标概率。 档案未完善时不给综合匹配分。沿用原型最低要求“企业名称+主营业务”,其他字段缺失仍应逐项提示。档案/权重版本变化使新计算使用新版本,历史报告保留当时版本与分数。 ## 6. 统一任务、运行状态与可审计事件 统一任务至少保存:任务 ID、用户/会话 ID、入口、原始问题、意图、已确认主体/项目、硬条件、偏好、输入文件 ID、继承上下文版本、Skill 名称与版本、调用和积分预算、幂等键、父任务、实际范围及结果。 推荐状态:`RECEIVED → PLANNING → RUNNING → SUCCEEDED/PARTIAL/FAILED/CANCELLED`。缺信息、同名企业、预算不足分别进入 `WAITING_INPUT`、`WAITING_ENTITY`、`WAITING_BUDGET`,确认后继续;不阻塞请求线程等待用户。 前端只展示可审计的“计划 → 行动 → 结果 → 下一步”: | 事件 | 内容与真实性要求 | | --- | --- | | 计划摘要 | 业务目标、实际筛选条件、预计 Skill 和预算;标注“计划调用”,不能提前记成已调用 | | 工具开始 | 实际发出调用后产生;包含产品化工具名和任务步骤 | | 工具完成/失败 | 对应一次真实请求;记录返回条数、耗时、错误类别和成本是否已知 | | 等待输入/主体/预算 | 展示候选项或必要问题;不继续昂贵调用 | | 报告片段 | 模型实际生成的报告内容,引用已登记证据 | | 结束 | 最终状态、实际范围、实际调用及费用摘要;部分成功不能显示全部完成 | 不传输或展示原始私有推理链、系统提示词、密钥、原始认证头。原前端的预设调用动画必须撤换。 后端先持久化有序事件,再通过 SSE 推送。事件含递增 ID,断线可按最后 ID 重放;重连只读事件,不重新发起收费工具。任务创建和继续操作使用幂等键,用户连点不重复执行。取消后停止未发出的步骤,已发出的调用可能继续计费,真实记录该事实。 本期单实例、有限工作线程和有界队列即可。服务重启时将未完成任务标记为中断/部分结果,提供明确重试入口,不自动重放无法确认是否扣费的请求。 ## 7. 事实、引用、费用与文件 ### 7.1 报告结构与来源 报告统一包含:一句话结论;实际条件和数据时间范围;结果表;事实;Agent 推断及依据;数据缺口和置信说明;数据来源与分析范围;实际 Skill/工具调用和成本;一个最相关的下一步。 每条事实绑定证据 ID,证据记录工具调用 ID、记录标识、完整来源 URL、发布时间/抓取时间及必要摘录。模型只能引用已登记证据,不得生成“看起来正确”的链接。用户文件事实标注文件名、页码/工作表/幻灯片定位,不能写成已获公开公告核实。 模型生成的数字与企业名称须能回溯到工具结果或用户提供资料;统计计算由后端完成。缺少关键证据时返回数据缺口,不让模型补齐。一般项目问答限于已取得上下文;需要新外部资料时记录真实补查。 ### 7.2 成本控制 - 分开保存工具调用次数、知了积分、联网检索/抓取次数、DeepSeek 输入/输出 token。不同单位不能相加为一个“总次数”。 - Skill 文档的参考预告为企业单查约 10–18 积分、双查约 20–28 积分;投标完整模式约 12–25 次调用、快速模式约 5–8 次。它们是文档估计,不是本项目已验证价格。 - 企业单查调用上限参考 18、双查 25,投标决策参考 25;另外设独立积分预算。具体价格、余额、免费主体查询以真实账号验证,不能认定“一个工具永远扣一分”。 - 执行前展示预计范围;下一步可能超预算时暂停,用户增加额度后再继续。联系人默认不查,只有明确请求时执行。 - 实际积分读取响应 `meta.cost_units`;缺失时标“待核对”,不能以余额差推断并发任务的准确费用。模型未返回 usage 也标未知。 - 缓存命中与真实外部调用分别展示。每次新建获客报告至少真实调用一次招投标检索工具;重复打开历史报告不重复扣费。 - 超时不能盲目自动重试可能已扣费的调用;优先使用供应商支持的幂等能力,未明确支持时记录结果未知并提供用户可理解的重试动作。 ### 7.3 投标文件处理 本轮最终确认覆盖前述所有格式,但仅用于对应投标项目任务。不得用于训练、自动建立其他客户档案或无关调研;公司档案本期手动填写,不接受文件导入。 | 格式 | 处理路径 | 验收边界 | | --- | --- | --- | | TXT/MD/CSV/HTML | 检测类型与编码,提取文本/表格单元格 | 不执行 HTML 脚本,不把文档中的指令当系统指令 | | DOC/DOCX、XLS/XLSX、PPT/PPTX | 使用成熟解析库提取文字及定位信息 | 不执行宏;复杂表格可失去排版,但不得虚构单元格关系 | | 文字 PDF | 提取逐页文本 | 保留页码和原始证据定位 | | 扫描/混合 PDF | 识别无文本页,逐页渲染后使用模型视觉能力解析 | 有页数、大小与成本限额;超过限额提示拆分,不能静默漏页 | | JPG/PNG/WebP/GIF | 模型视觉理解并提取内容 | 动画 GIF 按首帧处理并提示;低清、缺页或不可辨认内容提示核验 | 建议首版保护值:单文件 20 MB、PDF 最多 50 页、视觉处理每任务最多 20 页/张;工作簿/幻灯片/提取文本也设置大小和条数上限。它们是可配置的实施默认值,应在上传界面事先显示,不冒充“任意大小均支持”。加密、损坏、未知类型或内容不符的文件必须给出具体错误与下一步。 原文件及解析临时内容建议上传后最多保留 24 小时,用户可提前删除。清理包括临时图片、提取全文、模型供应商文件引用(如使用)和失败任务残留;报告仅保留已引用的必要摘录与来源定位。删除文件不等于删除已有报告摘录,界面说明区别,并提供删除报告/会话入口。供应商侧留存政策不能承诺由本系统控制。 仅允许在当前账号/任务权限内下载或删除文件。审计保留文件类型、哈希、上传/删除时间等必要元数据,避免保留正文。审计元数据建议保留 180 天,可配置;原文件期限与审计期限分别管理。 ### 7.4 网址与资料出入边界 知了详情链接优先通过详情工具读取。其他公开公告链接走受控网页正文获取,再按标题/采购方与标讯交叉核实;登录、验证码、付费或无法访问时提示上传文件或完整标题,不声称已抓取正文。 本地文件可按既定 DeepSeek 模型方案发送必要文字/图片用于当次解析;上传界面明确该用途。知了数据查询仅发送项目/企业名等查询参数,不上传本地文件全文。联网补充仅使用必要公开实体查询,不能将文件全文或内部商务内容送入搜索引擎。 URL 获取需防止访问本机/内网地址、重定向绕过及超大响应。所有外部内容均视为待分析数据,不能借公告内容改变系统工具、预算、权限或执行命令。Markdown 与外链渲染需做协议校验和内容清理。 ## 8. 原有业务闭环 | 模块 | 保留与修正要求 | | --- | --- | | 公司档案 | 八组表单、保存、版本、完善状态、四维权重;关闭文件导入;不自动填入虚构演示公司 | | 检索方案 | 保存/修改/删除/手动执行;执行条件、项目集与顺序冻结为快照,Tab 不按当前条件悄悄重算 | | 重点关注 | 已关注、准备投标、已报名、已提交投标文件、已中标、未中标、已流标、暂不考虑 | | 状态规则 | 允许人工跳转和恢复;结果页与暂不考虑分组保留;不会因截止时间、公告更新或 AI 建议自动变更 | | 历史与备注 | 一次提交原子保存状态、备注快照、操作人与时间;仅改备注也留痕;重复提交不产生重复历史 | | 标签 | 自定义、增删、关注绑定与筛选;删除标签同步解绑;关注唯一约束避免重复 | | 取消关注 | 沿用原页面确认后删除该关注的状态/备注/历史;不删除公共公告、来源与已生成报告;暂缓项目建议用“暂不考虑” | | 会话 | 新建、标题搜索、重命名、删除、任务历史;删除进行中会话时先阻止后续步骤并处理文件引用 | | 单项目/整批提问 | 项目使用项目快照,整批使用实际检索批次而非当前分页;超上下文时分段汇总并显示覆盖范围 | ## 9. 技术与持久化设计建议 沿用 Java 21、Spring Boot MVC、MySQL、React/TypeScript/Vite。采用业务模块内的 Controller/Service/Repository,三个受控工作流复用数据客户端;不新增向量数据库、消息中间件或独立 Agent 微服务。 后端使用成熟安全组件处理预设 admin、密码哈希和服务端会话。密码由部署环境提供,不提交默认弱口令。前端同源代理 `/api`,会话 Cookie 配合 CSRF 防护;鉴权覆盖任务、会话、文件、报告与跟进数据。 | 数据组 | 必要记录 | | --- | --- | | 用户与档案 | 用户、公司档案、档案/权重版本 | | 公告与检索 | 公告、公告阶段来源关系、检索方案、执行批次及有序公告快照 | | 人工跟进 | 关注记录、历史、标签及绑定 | | 会话与任务 | 会话、消息、任务、确认参数、父子任务、结果与报告版本 | | 轨迹与证据 | 有序任务事件、实际工具调用、耗时/状态/费用、事实证据引用 | | 临时文件 | 账号/任务归属、类型、位置、过期/删除时间、解析状态 | 金额以精确十进制和明确单位保存;时刻返回带时区的 ISO 8601,业务日期按 Asia/Shanghai 解释;报名/投标截止只有日期时标明精度,不臆造具体时分。需要用户人工确认的事实不能被模型输出直接覆盖。 注释要求:后续代码按用户要求补充详细中文注释,重点解释硬条件/偏好边界、主体确认、金额转换、计费预算、幂等、状态事务、引用校验、文件清理和降级原因,避免只注释语法表面。 ## 10. 开工依赖与当前验证边界 1. 后端环境需要配置可用的 `ZLBX_API_KEY`、`DEEPSEEK_API_KEY`、数据库连接与 admin 初始密码。只通过本地环境配置,不在聊天、提交记录或前端包中保存密钥。 2. 知了账号需有足够额度且允许部署应用访问;使用条款、返回链接有效性与接口字段需在首日实测。本轮未发起收费查询或注册。 3. DeepSeek 模型、联网 Search/Fetch、视觉能力及账号权限需做真实验证。公开文档显示 `deepseek-flash` 当前对应 V4.1-Flash-1017;配置可变,发布时再次核实,不能把网页聊天能力当作 API 已可用。 4. 未核实凭证不等于没有凭证;本轮没有读取或打印密钥。没有真实服务调用证据时只能标记开发/模拟验证,不能标“真实联调通过”。 5. 本期交付以本地或指定测试环境可运行、前后端联调通过为界;生产域名、TLS、服务器与上线运维不因四天计划而自动视为已交付。 ## 11. 资料依据 - 产品需求:本次会话中的原型说明、Agent 方案及后续确认;冲突以最新确认优先。 - 本地三个 Skill 的 `SKILL.md`、`references`、两个报告渲染脚本;版本按第 3 节固定,文档内容尚未全部经过在线 API 验证。 - [DeepSeek 更新记录](https://api-docs.deepseek.com/updates/)与[模型调用说明](https://api-docs.deepseek.com/quick_start/agent_integrations/):核对日期 2026-10-26。 - [DeepSeek Search & Fetch](https://api-docs.deepseek.com/guides/search/)与[视觉输入说明](https://api-docs.deepseek.com/guides/vision/):联网与图片能力需独立接入并验证,不默认随模型回答自动发生。 - [Apache Tika](https://tika.apache.org/)与[PDFBox 文档](https://pdfbox.apache.org/3.0/migration.html):用于多格式提取、PDF 处理的候选实现;开发时选择兼容且维护中的依赖版本,不把支持格式说明等同于实际解析通过。