复用已维护的定义
重建流程先核对已有指标，再补齐缺失定义。名称相近，并不能证明计算含义一致。
Datus + Apache Superset
Apache Superset AI Agent 集成
将 Superset 看板背后的 SQL 与业务逻辑转为可复用的指标和 Agent 上下文。基于团队已有知识追问分析、构建 Datus 看板，或生成 HTML 报告。
Superset 看板选定 SQL + 图表分析意图
经审核的指标 + Reference SQL
Datus Agent、报告与看板
从看板到共享上下文
把图表背后的定义一起带过来。
选择看板和图表、确认范围，再由 Datus 基于导出的查询依据构建上下文。匹配的已有指标会被复用；缺失指标可以在选定范围内创建并验证。
从真实的 Superset 看板开始。
插件解析看板、图表、数据集及底层数据库连接。团队确认哪些查询作为 Reference SQL，哪些查询提供指标依据。
- 看板与图表清单
- 物理数据源匹配
- 已确认的查询选择
Superset → Datus
Superset dashboard ├─ selected chart queries ├─ dataset / database identity └─ measures, filters, time grain
依据插件与 Agent 源码绘制的流程示意。仍需核对源筛选条件、权限与不受支持的图表行为；外观相似不代表计算等价。
查看看板上下文构建教程三种输出，各有用途
保留已有看板，拓展它能支持的工作。
按结果的用途选择输出位置。Superset 看板、Datus HTML 报告与 Datus HTML 看板的交互方式和运行条件不同。
保存在 Superset
在 Superset 内创建和维护可视化。
让 Datus Agent 使用 Superset 创作插件查看或创建数据集、图表和看板布局，并回读产出、检查代表性查询。
使用现有 Superset 部署与数据连接。
查看 Superset 看板创作教程Apache Superset
按地区
月度趋势
此处展示布局示意，不包含实时数据或生成的客户结果。
为什么把 BI 知识带入 Datus？
让一张看板背后的工作服务更多问题。
保留来源依据
将图表与查询的对应关系、导出 SQL 和生成的上下文一起保留，方便团队审核计算来源。
选择合适的输出界面
日常 BI 报表继续保留在 Superset，用报告完成汇报，或用 Datus 看板开展新的交互探索。
- 安装并启用 Superset 插件，配置已授权的连接。
- 将所选 Superset 数据集实际使用的数据库配置为 Datus 数据源。
- 选择看板、确认导入范围，并在扩大使用前审核生成的上下文。
插件面向 Apache Superset 4.x 及更高版本，具体部署需要核对认证、来源身份和逐图表覆盖情况。
常见问题
Apache Superset 集成常见问题
Datus 能把 Superset 看板逻辑转为指标吗？
Datus 可以导出选中图表的查询，将其作为 Reference SQL 与语义建模的依据。看板上下文构建需要确认范围并匹配物理数据源。目标为 Datus 看板时，匹配的已有指标会被复用，缺失的选定指标可以创建。仍应审核计算、筛选条件与时间粒度，不能只根据图表标题推断指标定义。
可以把 Superset 看板转换为 Datus 看板吗？
当前插件提供这一目标的操作指引，由共享的 dashboard-bootstrap 工作流程协调。流程解析来源、导出选定 SQL、准备所需指标，再交给 gen_visual_dashboard。覆盖范围需要逐图表检查；筛选、权限、不受支持的计算和布局差异，需要明确验证后才能认定目标与来源等价。
Datus 报告与 Datus 看板有什么区别？
Datus HTML 报告是叙述式数据快照，结果在生成时写入。Datus HTML 看板则是交互数据视图，受支持的筛选操作会向配置的后端发起查询。CLI 工作流程中后端由 datus --web 提供。两者都可以使用指标与 SQL，但分别适合阅读汇报与持续探索。
导入上下文会修改 Superset 原有看板吗？
以 Datus 为目标的重建流程保持源 BI 资源只读，仅将选定依据导出到本地文件。在 Superset 内创建或修改看板，使用单独的 Superset 创作流程，写操作需要确认。请明确输出目标，让 Agent 使用对应的来源与写入边界。
数据查询在哪里执行？
查询使用配置的数据源及其访问权限。Superset 来源发现会解析数据集背后的真实数据库，Superset 服务地址本身不是数仓连接。Datus 看板的筛选需要配置查询后端。仅生成文件不能替代后端，也不能证明源与目标查询的结果等价。