如何建立竞品文档变更日志

1. 确定一个买方任务，选择少量页面

先确定买方任务，也就是买方需要用产品完成的工作。例如，研究人员可能需要查看文档为某个报表流程列出了哪些导出格式。问题范围应足够小，便于审核完整的相关段落。

保存页面前，先写一份简短的采集计划：

1. 列出要检查的竞争对手及其产品。
2. 用一句话说明买方任务。
3. 选择可能解答该问题的官方文档章节。
4. 如果页面注明了产品版本、语言和套餐，请记录这些信息。
5. 确定下次观察日期。
6. 说明哪些变更会影响买方任务。

不要把未知的套餐或版本当成“所有套餐”或“所有版本”。应将其记为未知。如果帮助页面与版本说明表达的是不同类型的信息，请分开记录。

用页面登记表明确选定的页面。这是你要再次检查的页面清单，并不表示你已找到全部相关文档。

重定向会将请求从一个网址转到另一个网址。两个网址都要记录。网址变化可能影响你判断两次保存的副本是否属于同一页面。

2. 用搜索寻找页面，再直接检查页面

如果你已知道官方帮助页面的网址，请直接打开。需要寻找候选页面或相关版本说明时，搜索会有帮助。仅靠搜索结果，无法建立已保存页面的历史记录。

Google Search Scraper Actor 适合用于寻找页面。Actor 是托管运行的数据采集程序。Task 是为 Actor 保存的预设输入配置。这两个术语都不表示本指南已采集页面的历史版本或测试该产品。

所提供的检查结果表明，公开默认构建版本 1.0.15 声明了下文使用的输入和输出字段。下方这份简短输入通过了针对已声明输入规则的静态检查，也就是不实际运行程序的规则检查。本简报未运行 Actor。该检查不能证明实际运行结果、覆盖是否完整，或采集是否成功。参见公开默认构建版本证据（检查于2026年10月25日；仅涉及已声明字段和输入静态检查）。

可使用这份建议输入，尝试进行一次小范围的页面查找：

{"country":"US","engines":["google"],"language":"en","maxResultsPerExecutedQuery":3,"queries":["reporting software export release notes"]}

将示例查询替换为与你选定的竞争对手、产品和买方任务相关的词语。如果研究面向其他市场，请更改国家和语言。运行前，审核完整输入。本例建议使用 Google 作为搜索引擎；静态检查不能确认它当前的实际运行行为。

每个实际执行的查询最多返回三条结果。这是数量上限，并不保证一定有三条结果。这份示例是建议用于替换原配置的输入，并非复制自已核实的已保存 Task 配置。

公开的 Competitor SERP Research Task（检查于2026年10月25日；仅确认页面存在）页面确实存在，其准确 Task ID 为 `Pjq0JLkzo0wHTcabU`。其已保存设置和实际运行行为仍未核实。可以将它作为起点，但使用前应检查设置。

如果采集搜索结果，请保留以下已声明的搜索字段：

摘要是搜索结果提供的一小段文字。将其措辞用作证据前，请先打开页面。已核查页面证据指南说明了如何从搜索结果进一步核查来源段落。

将保存的搜索输入与结果一同保留。如果多个查询都找到了同一页面，请保留这些观察记录。搜索导出结果合并指南说明了如何保留查询和排名证据。在本方法中，变更比较针对的是选定页面及其已保存版本。

3. 比较版本前，先确认页面身份

页面身份记录用于说明某个已保存副本对应哪份文档。仅凭网址可能无法确定这一点。页面可能发生重定向、切换语言，或显示另一产品版本的文档。

此后每次访问，都要检查请求网址、最终网址、页面标题、章节标题和注明的适用范围。比较文本前，先记录这些信息是否发生变化。

不要仅因旧导出指南重定向到了新的综合帮助页面，就将两者直接比较而不作说明。保留两个副本，并将比较标记为待确认，直到弄清每个页面分别是什么文档。

同样，不同语言和产品版本的内容应分开保存。如果研究范围发生变化，请记录下来。扩大页面范围可能有用，但不会因此获得新增页面过去的快照。

4. 保存文本及其观察时间

每次都要保存完整的相关公开页面文本。同时保留与买方任务相关的段落原文。截图有助于保留可见布局，但你还需要保留文本，以便准确比较和引用。

保留相关陈述的适用条件。关于 JSON 导出的某句话，可能受到附近文字中所述的套餐限制、产品版本或访问要求约束。只保存格式名称，可能会丢失决定其含义的条件。

每次观察一个页面，都建立一条记录：

将观察时间与页面显示日期分开记录。保存时间说明你何时看到了这些措辞。显示日期的含义取决于页面本身的说明。两者都不能自动证明某句话何时发生了变化。

将公开证据与你自己的记录分开。官方页面文本是公开来源材料。快照编号、已保存副本、审核备注和买方优先事项，则是你自行维护的记录。已声明的搜索字段不能证明 Actor 会替你创建这些记录。

不要用新副本覆盖旧副本。如果不保留旧文本，之后就无法核查差异。

5. 比较具有可比性的段落，并对措辞差异分类

在相关适用范围相同的前提下，比较同一页面的两个已确认可用的快照。并排阅读完整段落。文本比较可以找出待核查的差异，但每处差异都要结合上下文审核。

将措辞差异分为以下类别：

删除措辞不能证明功能已删除。新增措辞不能证明功能刚刚发布。对买方任务而言，限定条件的变化可能比新增列出一种格式更重要。

用直白的语言记录观察区间：“10月1日与10月8日保存的副本之间存在措辞差异。”不要将其改写成证据并未提供的确切编辑日期。

为每处待核查的差异保存一条变更记录：

6. 逐步分析一个严谨的示例

原创教学虚构示例。这不是 Actor 运行记录、客户成果或对真实公司的观察结果。下文所有网址、段落、日期和记录均为虚构。

假设一名研究人员正在检查某个报表流程的导出文档。研究人员分别在2026年10月1日和10月8日，保存了虚构页面 A（`https://example.com/help/exports`）的完整公开文本。两次观察的时间均为 12:00:00 UTC。UTC 即协调世界时，是一种标准时间基准。

两个副本的页面身份、语言和相关适用范围一致。研究人员还在10月8日找到了虚构页面 B（`https://example.com/help/report-formats`）。页面 B 没有较早的已保存副本。

以下是本例保留的完整相关段落：

CSV 和 JSON 是数据格式。本例提到它们，是为了展示如何比较措辞，并未测试任何一种格式。

对于页面 A，已确认的变更记录写道：“在10月1日和10月8日两次观察之间，导出段落新增了 JSON 相关措辞。”两次保存的完整页面副本和两段原文均保留，可供审核。

对于页面 B，记录写道：“10月8日的段落记载了 JSON 导出。没有可用的较早快照。”这条记录并不代表第二处已证实的变更。

计算时，各类数量应分开统计：

• 页面 A 有 2 次已保存的观察。页面 B 有 1 次已保存的观察。合计：2 + 1 = 3 次已保存的观察。
• 页面 A 提供了 1 对可比较的副本。页面 B 因缺少较早副本，无法组成一对。
• 这对可比较的副本显示：1 个页面上有 1 处观察到的措辞变更。
• 页面 B 提供了 1 次仅反映当前状态的页面观察。其变更状态未知。

这些数字统计的是页面、已保存副本和比较次数，不是客户数、用户数、功能发布次数或成功导出次数。页面 B 缺少较早副本，不能证明较早文本中 JSON 相关措辞的数量为零。

买方任务备注指出，关于 JSON 的陈述可能影响导出功能审核。下一步是在买方要求的产品适用范围内核实该功能。这条记录没有提供发布日期或使用结果。

7. 明确记录失败和证据缺失

不能把一次检查失败写成措辞已消失。使用明确的状态，让之后的读者能判断哪些比较有效。

“未观察到措辞变更”仅适用于已检查的段落和观察区间，并不表示整个产品都没有变化。

缺失的日期和段落应继续标记为缺失。只有在已确认有效的比较确实支持零计数时，才能使用零。例如，审核完成后，可以记录确认的变更为零。如果缺少较晚的页面文本，就不能这样记录。

在历史记录中保留失败的观察。不要用空白或不完整的副本替换最后一个可用快照。

8. 核查产品证据并撰写简报

将措辞变更称为功能发布前，先寻找另一份带日期的官方来源，确认其能支持该说法。版本说明可能有帮助，但仅凭附近出现的日期，无法确定该具体功能的发布日期。

如果买方决策需要经过测试的功能证据，请另行安排检查，并使用要求的产品版本、套餐和工作流程。检查实际进行前，应将其标记为计划进行。文档记载的支持情况与经过测试的实际行为，属于不同的证据状态。

围绕买方任务撰写简报。先说明观察到的措辞差异。然后提供页面链接、两次观察时间、两段原文的引用位置，以及相关适用范围。解释这些措辞为何可能影响决策。最后写明尚未解决的问题和下一步所需的证据。

分享简报前，请完成以下审核：

1. 确认两个已保存版本仍然可用。
2. 检查两段文字是否属于同一页面，且相关适用范围一致。
3. 对照保留的文本，逐字核对所有引文。
4. 将观察时间与所声称的编辑日期或发布日期分开。
5. 将仅有当前观察的页面与已证实的措辞变更分开记录。
6. 删除证据不支持的采用情况、性能或业务影响相关说法。