evidence-dev/evidence

这是什么？

核心功能

• 01使用 SQL 和 Markdown 编写报表，无需拖拽组件。
• 02通过 evidence dev 命令启动本地开发服务器。
• 03生成可自行托管的静态站点。
• 04可将报表发布到 Evidence Studio 托管。
• 05可配合 Claude Code、Cursor 等本地 AI 编程助手使用。

适用场景

• 为数据团队构建可通过 Git 版本管理的内部仪表盘。
• 制作将文字说明与 SQL 驱动图表结合的数据报告。
• 数据团队希望用代码化流程替代拖拽式 BI 工具。

快速上手

1. 1

   运行 README 中适用于 macOS 或 Linux 的官方安装脚本

2. 2

   查看命令行帮助

   evidence help
3. 3

   创建新项目

   evidence init my-project
4. 4

   进入项目目录并启动开发服务器

   cd my-project evidence dev

使用前须知

• !安装依赖通过管道执行的 curl 或 PowerShell 脚本，部分团队可能不接受这种方式。
• !托管报告需通过 Evidence Studio 发布，自托管则需要您自己的基础设施。

标签

常见问题

evidence 是什么？

开源的代码化商业智能工具，用 SQL 和 Markdown 编写交互式数据报表与仪表盘。 Evidence 是一款以代码方式编写报表的商业智能工具，不依赖拖拽式界面。每个页面都是一个 Markdown 文件，其中嵌入 SQL 查询和图表组件，因此报表可以像其他代码一样放进 Git 管理、逐次审查修改。

evidence 可以免费使用吗？用的什么许可证？

evidence 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

evidence 还在维护吗？

活跃维护中。evidence 最近一次提交是在 2026年10月16日。

evidence 适合用来做什么？

为数据团队构建可通过 Git 版本管理的内部仪表盘。 制作将文字说明与 SQL 驱动图表结合的数据报告。 数据团队希望用代码化流程替代拖拽式 BI 工具。

evidence 怎么安装和运行？

运行 README 中适用于 macOS 或 Linux 的官方安装脚本 查看命令行帮助: evidence help 创建新项目: evidence init my-project 进入项目目录并启动开发服务器: cd my-project evidence dev

在哪里获取 evidence？

源代码和安装说明在 GitHub 上：https://github.com/evidence-dev/evidence