营运与维护 · 实作指南
AI 报告读到第一页，不等於读完全部
比较完整、部分与空结果，让收集范围先于结论。
AAHouse 原创解说视频，采用 AI 辅助概念画面、合成旁白及原创音乐。
简体中文普通话逐字稿 · 英文逐字稿 · 台湾华语逐字稿 · 香港粤语逐字稿 · 澳门粤语逐字稿
同一份报告，三种结局
想象一家美国服务团队让 AI 汇总未完成工单。第一批记录已经返回，屏幕也出现了流畅的总结，但后台可能还有下一页。我们用三个假设结局比较这一流程：完整收集、部分收集和确认没有记录。它们不应共享同一个“完成”标签。本文讨论数据收集边界，不是已发生的客户事故。
结局甲：第一批看起来很完整
若连接器只把第一页交给模型，文字再准确也可能漏掉后面的工单。GitHub 文档说明，分页接口返回结果的子集，并通过链接头提供后续页面入口。[1] 这是一种具体产品行为，不是所有系统的统一格式。我们的建议是先核对连接器是否持续跟进后续页，再评价摘要质量。
结局乙：中途失败，却被写成完成
第二种情况是已读几页，下一次请求失败。可用的部分资料仍有价值，但不能冒充全部。建议保留已确认记录、范围和停止原因，并显示“部分结果”。业务负责人可以决定等待或审阅部分内容；模型不应自行把缺页解释为没有更多工单。恢复时继续原收集任务，避免把重试记录重复计入。
结局丙：空页不一定是终点
Google 的 AIP-158 指南允许服务在尚未结束时返回少于请求数量、甚至零条记录；它用空的下一页令牌表示集合结束。[2] 因而不能仅凭“这一页很短”或“这一页为空”停止。应读取实际服务的文档，按其结束信号执行，而不是把这份设计指南当成每个接口都会遵守的保证。
比较依据：范围保持一致
每次收集都应写清筛选条件、账号范围、排序及报告窗口。Google 指南要求翻页时保持其他参数一致，页大小另有规定。[2] 对实际产品，还要核实记录变化时的行为。读完所有页面并不自动获得某一时刻的快照；如果没有快照保证，应在报告中说明这个限制，不伪造精确截止时刻。
证据卡：比一句“已读完”更可靠
建议让连接器输出一张证据卡：已读页数、唯一记录数、继续位置、结束依据和异常状态。原始续页令牌留在受控状态中，不必展示给读者。模型只接收获准使用的记录与范围说明。页数与记录数用于核对，不是对完整性的独立证明，更不是让模型自行猜测总量的提示。
对照实验：先写预期，再生成文字
用虚构数据准备单页、多页、空页仍可继续、重复记录和中断恢复五类样本。先写明应收集哪些记录、何时结束以及哪些情况必须标为部分结果，再检查摘要。这里提出的是验收计划，不宣称已测试任何生产接口。测试还应确认权限和筛选范围不会因恢复流程而扩大。
选择：先保证范围，再润色结论
优先改造一份经常使用的报告，让完整、部分与确认空结果分别显示。把翻页规则及测试样本留给维护者，接口变化后重跑。这样，审核者知道自己面对的是哪一类证据，再决定是否采用结论。收集完整不等于分析正确，但跳过这一关，语言再自然也无法补回没有读到的资料。
