全部指南
指南

将 CSV 制作成可核对的分析报告

先定义指标,制作可溯源报告,再与源 CSV 核对。使用多视图回答不同问题,同时明确展示排除行与精确值。

快速开始

让 AI 助手帮你完成

将这段提示粘贴到你正在使用的 AI 助手中:

使用 CSV Story Report 分析我提供的 CSV。先询问要回答的问题、维度、指标、聚合方式和单位。计算前检查表头及异常行。生成到新目录,独立核对总值与两个分组,并展示源行与质量说明。多视图需要分别检查。不要默默排除数据行,也不要擅自推断收入或因果关系。

可核对的 CSV 报告包含什么?

CSV Story Report 生成交互报告、浏览器幻灯片、分组 CSV、精确汇总与质量说明。多视图工作流支持 2–8 个视图。可选 PowerPoint 是独立导出,需要 Python 依赖和单独视觉检查。

计算前定义问题

选择分组维度、数值列、聚合方式、单位与报告周期。检查表头唯一性、行宽、缺失值和重复事件。解析器支持最多 2 MiB、10,000 行数据、100 个分组的 UTF-8 CSV;它不会自动确定业务指标的含义。

明确选择计数、求和或平均值

可手工计算的虚构三行检查
运算数值 2、4、9 的含义使用前检查
数据行计数3 行数据,不一定是 3 个独立客户定义每行表示的事件
可加指标求和按原始单位计算得 15不要对百分比或不同货币直接求和
按行加权平均值15 除以 3 等于 5不要将它与各组均值的简单平均混淆

先运行一个问题,再增加视图

阅读 references/input.md 并查看包内生成器。从已安装内容包目录,使用 Node.js 24 及以上运行下面的虚构示例。多个问题请阅读 references/workspaces.md,并从 examples/workspace.json 开始。月份分组本身不证明增长。

node scripts/build-report.mjs --input examples/report.json --csv examples/data.csv --output ./practice-report

独立核对总值与两个分组

  • 将 summary.json 与 groups.csv 和原始 CSV 行核对。平均值需要检查分子与分母。
  • 检查 data-quality.md。修正被拒绝的数值;只有明确决定后才排除行,并保留排除记录。
  • 测试搜索、排序与幻灯片导航。显示筛选不会从底层汇总中删除分组。
  • 将分组标签作为文本导入,并保留保护性前缀。精确值位于 JSON 中,界面显示可能经过舍入。

报告无法证明什么?

目录标价之和不是销售收入。每月计数不能证明用户采用情况。输出描述的是所提供数据行;重复事件审核、因果解释和源系统准确性需要另外检查。将来源、精确计算与质量说明和报告一起交付。

全部指南