报表

报表是由通过校验的 ReportSpec 渲染出的长期、可复核交付物，不是聊天答案的截图。

创建报表

打开 报表 工作区使用创建动作，或者在“分析”中直接提出：

基于这次证据生成报表，包含管理摘要、KPI 对比、趋势图、明细表和限制说明。

新的分析型报表在声明结果前必须有已验证的 Analysis / Query evidence。

浏览与查看

截图由当前 Flutter 报表组件使用合成数据渲染，展示阅读布局和交互，不代表真实业务分析结果。

报表默认打开可搜索的目录；运行刚交付新报表时直接进入阅读页。选择目录行打开持续存在的阅读页，也可返回目录改选其他报表。普通读者和冻结的公共分享使用同一套 ReportSpec renderer。

报表可以包含 narrative section、KPI group、table、chart、filter 和 evidence/provenance 区域。布局是声明式的；ReportSpec 不允许任意 HTML 或 JavaScript。

手机或平板上可通过阅读页的目录入口浏览和搜索报表，按标题或报表 ID 查找、清除搜索、选择报表或返回当前阅读页。关闭目录会保留当前报表及筛选状态，不会重新加载报表。重新读取目录或报表详情会保留当前选择；有新报表交付时才优先打开新报表。

目录刷新或详情加载期间，仍可搜索并改选其他报表。系统以最后一次选择为准，并取消过期读取。加载失败时保留可用目录并支持重试；刷新同一报表会保留当前阅读页。同一版本的报表重复交付不会触发重新加载。

使用 目录 跳转到报表章节。长篇叙述随整份文档滚动，不再限制在小块内部阅读区。报表列表将版本和组件数量放在报表 ID 前，便于快速浏览标题和主要信息。

数据来源与覆盖范围

报表是一份有界分析快照。展开 数据来源，可查看报表声明的各个数据集、来源 ID、查询产物、已加载行数，以及可用时的声明总行数。缺失的数据载荷仍显示为不可用，不会当作零行结果。数据时点来自报表的来源记录；没有可用时间时，阅读页明确显示未知。

这里的覆盖范围描述收到的报表数据载荷，并不代表整个源数据库。载荷不完整时，阅读页会给出提示；图表和表格自身也可能采用展示上限，并在结果旁说明。看到较少的行或数据点，不能据此判断源数据只有这些记录。

本地筛选

报表筛选作用于已加载快照。搜索筛选项时，会查找有界范围内的已加载选项，包括初始列表中没有显示的值；数字、文本和布尔值保持不同身份。多选在确认后生效，取消不会改变当前报表。报表要求至少一个选项时，清空多选后不能确认。滑块无法精确表示大整数时，点击范围输入精确上下界；范围必须落在已加载边界内。传输或平台已经舍入的值无法恢复。

阅读页会列出当前本地筛选值。恢复报表默认值会恢复报表声明的参数默认值，默认值也可能不是“全部”。本地筛选不会重新执行 SQL、获取尚未加载的记录或产生新的数据时点。组件之间的联动只按报表声明的交互生效。

筛选草稿属于打开它时的快照。切换报表、替换报表版本或数据、恢复默认值后，旧对话框不能覆盖当前选择；其他操作已经改变选择时，旧草稿也会失效。确认过期草稿只会关闭该对话框，请重新打开筛选器选择当前快照中的值。快照未变化时，普通界面重建不会使有效草稿失效。选择、应用或关闭筛选弹窗只结束一次：重复操作不会重复提交，也不会关闭底层报表；弹窗关闭后，旧选择不能再提交。选择操作打开的新页面会保留，连续滑块调整仍可连续生效。

精确明细与图表数值

表格支持稳定排序、固定表头、分页，以及窄屏横向滚动。列超出阅读区时，底部滚动条持续可见并可拖动。报表的初始排序可以使用未显示的字段；点击显示列的表头可改用该列排序。数字保留已加载数据中的精度，缺失值、空文本与无效数值仍可区分。使用行审阅动作打开完整、可选择复制的字段值；审阅一行不会触发该行的选择联动。

数值图表的坐标轴按当前语言显示简写，例如“100万”或“1M”，提示框保留完整数值。查看数值会将图表切换为可滚动的已加载字段与精确值列表，支持键盘和屏幕阅读器。密集类别图可横向滚动。报表声明了选择联动时，数值选择使用对应的原始数据行。

正负数比较围绕同一零线绘制，趋势中的缺失观测保持断点。表示占比的图表会拒绝负数，不会把负数改成正数。热力图需要唯一坐标，箱线图需要有序的摘要统计；数据无效时，应先在查询中修正，再解释图表。

KPI 整数比较保留精确差值供审阅，包括超出原生 64 位整数范围的差值。紧凑标签可以近似，提示框与屏幕阅读器保留精确差和已声明单位；零基准不能产生确定的百分比变化。

重新分析

需要当前数据或调整分析范围时，使用 重新分析。报表库中的此动作会通过“分析”发起请求，重新完成相关分析并取得新的已验证证据。按钮不会直接查询来源，也不会直接覆盖现有报表快照；结果取决于 Agent 运行及其证据校验。

重新读取目录或报表详情只会读取保存的报表状态，不会刷新底层业务数据。已发布的公共分享仍冻结在分享时的报表版本。

AI 细化

细化会通过 Agent 发起明确的 report-refinement 请求。纯展示变化应复用现有证据；如果数据问题、指标定义或范围变化，Scopwis 会先要求新证据，再把结果写进报表。

直接编辑

报表编辑器会先校验完整候选 ReportSpec，再提交带 revision 的更新。revision 冲突会失败，而不是静默覆盖更新版本。

分享

公共分享是用户显式创建、不可猜测、可撤销、绑定具体 revision 的只读快照。公共 projection 不包含内部 evidence 坐标，只暴露渲染当前报表真正需要的数据。分享状态读取失败或响应内容无效时，先重试再创建链接。创建或撤销请求失败、无法确定实际结果时，界面会重新读取分享状态，避免沿用过期链接或误显示为私有；公网地址不可用时，已确认的分享仍可撤销。身份或冻结版本与请求链接不符的快照会显示为不可访问，可重试读取。分享创建时间不能作为数据时点。

数据保留

报表 metadata 和 lineage 可以比大 query payload 保留更久。当底层有界 payload 过期时，Scopwis 保留 ReportSpec 和 provenance，并把对应 dataset 标记为不可用，而不是伪造空结果。

更多信任边界见安全、证据与血缘。