这个项目能做什么

dbt Charts 来自 dbt Labs(包名 `dbt-charts`,命令行工具 `dct`),将 YAML 板定义编译为多种格式的交互式仪表板和报告。SQL 定义要查看的数据;YAML 声明如何呈现。它通过清晰、可审计的语法解决了随意编码仪表板的混乱问题。 **入门:** 需要 Python 3.10-3.13。通过 `uv tool install dbt-charts` 或 `pip install dbt-charts` 安装。添加仓库适配器作为附加组件(BigQuery、Snowflake、PostgreSQL 等;DuckDB 内置)。命令:`dct init`、`dct validate`、`dct serve` 用于实时预览。play.dbtcharts.com 上的游乐场允许无需安装即可试用。 **命令行工具(`dct`):** 验证、渲染为 HTML/PDF/PNG/SVG/JSON、运行查询、搜索板、追踪列影响,并包含离线 YAML 参考。动词:`validate`、`serve`、`render`、`query`、`search`、`impact`、`docs`、`examples`。 **代理技能和 MCP:** 附带捆绑技能(`dct skills intro`)和本地 MCP 服务器,适用于 VS Code、Cursor、Claude Desktop 等。`dct init mcp` 进行配置。 **VS Code 扩展:** 添加语法高亮、自动补全、诊断和实时预览(需要命令行工具)。可在 Marketplace 和 Open VSX 上获取。 **功能:** 支持本地数据源(CSV、Parquet、JSON、DuckDB)和通过 dbt 适配器的仓库。16 种核心图表类型(条形图、折线图、面积图、散点图、热力图、饼图、环形图、KPI、表格、地图等)以及 13 种语义类型(棒棒糖图、子弹图、斜率图、漏斗图、小倍数图)。五种内置主题,支持自定义 YAML 扩展。验证提供可操作的错误代码;`dct init ci` 添加 GitHub Actions 工作流。迁移自动处理旧语法。 **dbt 集成:** 可选;板可以独立存在,也可以放在 dbt 项目中使用 `ref()`、共享凭据并获得 CI 验证。基于 Pydantic、Jinja2、Vega-Lite 和 FastAPI 构建。Apache License 2.0。只读镜像;欢迎问题,不接受拉取请求。