Evidence 数据分析框架

它解决什么问题

拖拽式 BI 工具上手很快，但产出物通常是一个二进制工程文件或某家厂商的私有格式。想要审计“上个月那份报表是怎么算出来的”，往往只能靠截图和口头交接。口径一旦变化，也很难定位是哪次改动引入的回归。

Evidence 把分析过程重新拉回代码仓库：SQL 和 Markdown 就是全部产物，报表的每一次变更都对应一次可 review、可回滚的提交。

它是怎么工作的

• Markdown 即分析单元：在 Markdown 文件里直接写 SQL 语句，框架会针对你的数据源执行查询。
• 查询结果渲染成视图：Markdown 中嵌入的 SQL 输出会渲染进页面，和正文、图表混排，形成可交互的仪表板与报告。
• 产出静态站点：最终交付物是静态站点，可以直接部署，不需要常驻一个交互式 BI 服务。
• 脚手架由编辑器扩展提供：安装 VSCode 扩展后，在命令面板（F1）执行 Evidence: New Evidence Project 即可初始化项目。

因为所有查询都是文本，口径调整和数据源切换都能通过 diff 暴露出来，配合版本控制实现可复现。

适用边界与注意点

• 它生成的是静态站点，页面交互来自静态产物本身。如果需要用户在浏览器里临时拖字段、换维度，这种即席探索不是它的定位。
• 上游文档列出了安装要求与注意事项，CLI、Docker 等其他安装方式也要参考官方文档，不要假设默认路径在所有环境都成立。
• 数据源连接方式、项目结构等细节以 Evidence 官方文档为准，本技能只覆盖框架的定位与基本用法。