工作原理
Vue 界面将问题发送给 FastAPI 智能体工作流，由其选择数据源、检索语义上下文（Qdrant 增强）、生成受控 SQL、执行只读查询，并返回摘要、解释与图表推荐。
Vue 3FastAPISQLGlotQdrantDuckDBClickHouse
能力
- 语义元数据层（表、列、指标、别名、已验证查询、关系），用于范围化检索，而非全量 schema 灌入。
- 确定性 SQLGlot 护栏：仅允许 SELECT、范围校验、危险命令拦截、扇出检测与自动 LIMIT。
- 有界修复闭环，对修复后的 SQL 在执行前重新校验。
- OLAP 意图处理（TopN、占比、同比、移动平均），覆盖 DuckDB 与 ClickHouse。
- 自动图表推荐，并提供复用同一护栏的只读 MCP 服务。
证据
- 覆盖 DuckDB 与 ClickHouse 的 76 例结果等价性冒烟测试套件。
- 危险 SQL 在执行前即被拦截。
- Qdrant 支撑的语义层相较全量 schema 灌入，将提示上下文削减约 73%。
试试看
- 查询近期的每日销售额与订单数。
- 按地区拆解结果，再筛选到某一个地区。
- 尝试一条破坏性 SQL 请求，验证其被拦截。