怎样找到 SAM.gov Opportunity 的当前记录与历史版本
先恢复 notice ID，再核对 Public API 的最新 active 记录；需要历史版本时转向 SAM.gov Data Services。
重点监测信号
- 截图显示旧 response date，却没有 notice ID 和截图时间
- 有人把 Public API 当前结果误当成完整历史
- 两个附件文件名相同，但版本、大小与来源记录仍不清楚
查 SAM.gov opportunity 的版本时，先用准确 notice ID 锚定记录，再用 Contract Opportunities Public API（应用程序编程接口）确认最新 active 状态；若任务需要历史版本，则转到 SAM.gov Data Services。 标题、solicitation number、转发链接和截图可以帮忙搜索，却不能单独充当版本键。
这个任务属于盯着获授权 Capture、分包与政府合同 Telegram 群的 proposal 研究协调员。群里一句“截止日改了”，背后可能只是旧 PDF 被重新转发。若第二天仍在比较错误记录，潜在的研究客户可能已经找了别人；但速度不能以把 superseded instruction（已被后续版本替代的说明）写进交接为代价。
先看消息究竟留下了什么
下面是示意性复合对话：
SAM 链接又变了。旧 PDF 日期不一样，谁留了 version 2？
sol number 应该相同，附件名看着也一样
目前只知道有人声称发生变化、可能存在旧文件。notice ID、版本日期、响应时区、文件元数据、amendment number 和适用于提交的记录都未知。
不要把“version 2”补成事实。先索取当前官方链接或 notice ID、旧文件及其观察时间，再问清具体哪个字段或文件被认为改变。
定义：身份、当前状态和历史是三个对象
SAM.gov Contract Opportunities 是公开入口。版本研究要分开保存：
- 身份：用 notice ID 与官方 URL 锚定一条公告。
- 当前状态：最新 active 记录与当前字段、资源链接。
- 历史：用于证明前后变化的更早公开版本或文件。
solicitation number 可以连接相关公告，但不一定唯一定位一个 notice version；标题可以被复用或修改；附件即使继续叫同一个名字，内容也可能变化。因此第一把钥匙是 notice ID。
第一步：恢复官方 notice ID
打开官方记录，原样保存 notice ID、solicitation number、notice type、posted date、response date 与时区、current status、机构、description 和 visible resource links，并写下观察时间。
若手里只有截图，把 agency、标题片段、solicitation number、日期、文件名作为独立搜索线索。找到候选记录后，在群消息与官方记录真正连上之前，仍标记为 candidate，不要因为标题最像就直接采用。
SAM.gov 公告证据图提供九个对象的记录卡，能避免把 A 公告的 response date 写到标题相似的 B 公告里。
第二步：取最新 active API 记录
GSA 的 Contract Opportunities Public API 文档说明了结构化查询方式。API 会返回 notice identifiers、dates、classification 与可用的 resourceLinks 等字段。
文档同时给出一条关键限制：Public API 提供的是最新 active version。它可以回答“当前 active 记录暴露了什么”，不能直接代替完整历史比较。
记录请求参数、获取时间与返回的 notice ID。日期和时区字段按原值保存，不要改写成“明天”。缺失值保持缺失。若查不到当前记录，先重新核对身份或状态，不要拿第三方镜像填补。
第三步：需要历史时进入 Data Services
同一份 GSA 文档把历史版本需求指向 SAM.gov Data Services。这是另一条数据路径，有自己的访问与数据集条件。当前 API 里出现 modifiedDate，不代表它包含完整历史。
如果能获得历史数据，选择最贴近群里所称变化前后的版本，并保存：
- notice ID 与版本日期或 extract date；
- 字段名、旧原值与新原值；
- 文件 URL、文件名、大小或 checksum（校验和）；
- 每个版本的获取来源；
- 与正式 solicitation 变化相关的 amendment identifier。
若 Data Services 不可用，就明确写“已确认当前记录，未恢复历史版本”。这比把截图包装成官方旧版本更可靠。
第四步：比较字段，不编变化故事
“恢复到的两个版本中，response deadline 从 X 改为 Y”是观察；“机构是为了获得更多报价”是推测，除非官方明确说明。
文件也不能只看名字。两个 SOW.pdf 可能内容不同，改名后的文件也可能字节完全一致。有条件时比较文件 bytes 或 checksum，并记录所在 package。附件缺口核对进一步区分文件缺失、外部系统依赖与访问受限材料。
一份可复现的版本记录
对开头的复合消息，合格交接可以写成：
已从官方 SAM.gov URL 恢复 notice ID。14:20 ET 获取的最新 active API 记录显示 response date 为 Y，并有 4 条 resource links。旧截图声称日期为 X，但尚未恢复 Data Services 历史记录或可认证旧文件。变化原因、amendment 关系与适用响应版本仍未知。
如果两个历史版本都已恢复，就用准确版本日期与字段差异替换“截图声称”，但仍不能自行补出编辑者或理由。
TOP Prospect 可保留用户主动连接、有权访问并启用的 Telegram 来源中的原文、来源、时间、AI 判断、证据与人工状态，让重复截图和链接与其排序理由放在一起。当前生产版的 matching target 只保存配置，不会自动产生新候选。
产品不能替用户查询受保护的 SAM.gov 数据集、认证历史文件、判断哪个版本约束某次 offer、识别编辑者或联系发言者。主要来源不可用时，可用官方来源层级准确记录证据缺口。产品访问方式见价格页，但付费本身不会改变官方数据访问条件。
关键事实
- notice ID 是锚定单条 Contract Opportunities 公告最稳妥的字段。
- Public API 文档说明它返回最新 active version，不是完整历史。
- GSA 把历史版本需求指向 SAM.gov Data Services。
- 当前状态、早期历史与转发截图必须分开记录。
- 字段变化不能证明是谁改的、为什么改。
- 文件名相同不能证明字节相同，也不能证明它适用于某次提交。
当另一位协调员能使用记录的 notice ID 重现当前查询，并找到同样的历史版本，或者清楚看到“历史未恢复”的说明，导航任务才完成。输出是一条可复现来源路径，不是关于机构动机的故事。
由 TOP Prospect 研究团队撰写，2026 年 8 月 25 日依据上述 SAM.gov 与 GSA API 官方来源复核。本文不构成法律意见，也不判断哪份文件约束具体提交。
常见问题
SAM.gov 版本核对应该从哪里开始？
从准确 notice ID 与官方 Contract Opportunities URL 开始。标题、solicitation number 和截图只能提供搜索线索，不能代替公告身份。
Contract Opportunities Public API 会返回历史版本吗？
GSA 文档说明 Public API 返回最新 active version；需要历史版本时，文档指向 SAM.gov Data Services。
旧附件能证明哪个版本适用于一次提交吗？
不能。要保留文件、来源、观察日期和可用元数据，再核对适用公告与 amendment 历史。相同文件名不够。
版本历史能解释机构为什么修改字段吗？
可用记录可以证明公开字段发生了什么变化，但不能单独证明编辑者、内部理由、批准路径或商业影响。
资料来源与延伸阅读
值得关注的潜在线索 Signal 是怎样被发现的
了解 Top商业线索怎样发现和整理值得核实的 Signal、保留 Telegram 原始上下文、去掉重复消息并安排查看顺序。是否跟进以及下一步做什么，仍由用户决定。
