指南
将 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 中,界面显示可能经过舍入。
将已核对发现制作成演示稿 — 在叙事中保留计算限制。
检查当前示例产出 → — 将可见结果与本节说明的导出文件和检查对应起来。
报告无法证明什么?
目录标价之和不是销售收入。每月计数不能证明用户采用情况。输出描述的是所提供数据行;重复事件审核、因果解释和源系统准确性需要另外检查。将来源、精确计算与质量说明和报告一起交付。