附录 D · 术语表¶

本表是 TTD 文档中所有核心术语的唯一权威定义。正文首次出现某术语时链接到本表对应条目，避免重复定义与版本漂移。

缩写扩展表¶

缩写	全称	说明
AGE	Apache Graph Extension	PostgreSQL 的属性图扩展，支撑 Engine G
BFF	Backend for Frontend	前端专属后端层（TTD 中由 Next.js 承担）
CDC	Change Data Capture	变更数据捕获，用于增量数据同步
CTE	Common Table Expression	SQL 公用表表达式（WITH 子句）
HITL	Human-in-the-Loop	人工介入环节
HNSW	Hierarchical Navigable Small World	pgvector 的近似最近邻索引算法
JWKS	JSON Web Key Set	JWT 验签公钥集合端点
MCP	Model Context Protocol	Anthropic 提出的工具/资源标准化协议
RLS	Row-Level Security	PostgreSQL 行级安全策略
SSE	Server-Sent Events	服务器推送事件（单向流式通信）

字母索引¶

按英文术语首字母索引（链接到下方分类表）：

A · AGE · Apache AGE · AgentBench B · Better Auth · BFF C · Chasm Trap · Circuit Breaker · Columnar Mirror · Content Safety Guard · CTE · Context Compaction D · Data Plane · DeepEval · Dynamic Few-Shot E · Engine R/V/G/D F · Fanout Risk G · GraphRAG H · HAProxy · HITL · HNSW J · JWKS K · KMB Steiner Tree L · LangGraph · Langfuse M · MCP · MemGPT/Letta · Metadata Cache · ModelRegistry P · PG Supernode · PII 分级暴露 R · Ragas · RLS · Router S · Semantic Plane · SSE · SQL 护栏 · SQL 语义缓存 · Steiner Tree · Supervisor T · TTD · Two-Plane 分离

引擎与检索¶

术语	英文	定义
R/V/G/D 四引擎	R/V/G/D Quad-Engine	TTD 在 PG Supernode 上集成的四种检索范式。详见下表分解。
Engine R	Relational Engine	关系型精确查询，基于 PostgreSQL `semlayer.*` 表。用于 ID 查找、约束检查、术语精确匹配。
Engine V	Vector Engine	语义相似度检索，基于 pgvector 扩展的 `*_embedding` 表。用于自然语言与元数据的模糊匹配。
Engine G	Graph Engine	关系推理与路径发现，基于 Apache AGE 的 `ttd_governance` 属性图。用于 join 路径、术语网络、业务规则依赖。
Engine D	Dynamic Few-Shot Engine	在线自学习的 few-shot 缓存，基于 `semlayer.dynamic_few_shot_cache`（pgvector）。从 SQL 修复成功案例中自动积累，经管理员审批后注入 RAG。
PG Supernode	PG Supernode	将 R/V/G 三引擎（外加 D）统一部署在同一个 PostgreSQL 实例上的设计，实现"一个连接池、多种检索范式"。

术语统一说明

本站点统一采用 R/V/G/D 四引擎 表述：R/V/G 是核心三引擎，Engine D（动态 Few-Shot）是建立在其之上的在线学习增强层。凡见到"三引擎"之处，均指 R/V/G 三大基础引擎；强调完整检索能力时用"四引擎"。

架构与分层¶

术语	英文	定义
Two-Plane 分离	Two-Plane Separation	Semantic Plane（治理态，Git YAML）与 Data Plane（执行态，运行时 DB）分离的设计（ADR-1）。
Semantic Plane	Semantic Plane	治理态：三层治理元数据资产以 YAML 形式存储在 Git，经 pre-commit hooks + CI 校验、PR 审查、S3 发布、Backend 自动导入。
Data Plane	Data Plane	执行态：本地用 PG Supernode + pg_mooncake + MinIO，生产用 Redshift。
五层逻辑模型	Five-Layer Model	L1 交互 → L2 编排 → L3 智能 → L4 数据 → L5 治理，只能向下调用，治理层独立离线发布。
三层语义治理	Three-Layer Semantic Governance	Layer 1 元数据契约（表/列/指标/join/few-shot）/ Layer 2 术语治理（术语与关系）/ Layer 3 业务规则与上下文。详见第 9 章。
治理叠加层	Governance Overlays	按 tenant/region/industry/compliance_pack 注入的治理上下文，在 Supervisor 阶段一次性解析（ADR-11）。

Agent 编排¶

术语	英文	定义
Supervisor	Supervisor	LangGraph 图的入口节点，职责极轻量：计算 embedding、解析治理叠加层、委托 Query Understanding（ADR-3）。
Query Understanding	Query Understanding (QU)	LLM 意图解析节点，输出结构化 JSON：intent_type、entities、metric_candidates、约束等。
Router	Router	纯确定性路由节点，用 `_INTENT_TO_ROUTE` 映射表（非 ML）决定 7 条执行路径（ADR-4）。
AgenticBIState	AgenticBIState	贯穿全图的 TypedDict 全局状态，约 50 个字段。详见第 4 章。
7 路由	7 Routes	kpi_lookup / nl2sql_query / deep_analysis_workflow / analytical_workflow / graph_reasoning / business_knowledge_qa / clarification_required。
修复循环	Repair Loop	Guardrails 校验失败 → corrective_retrieval → sql_generator 重试，最多 2 次。
SQL Cache 快速路径	SQL Cache Fast Path	Router 检测问题 embedding 与缓存 SQL 的 embedding 相似度 ≥ 0.92 时，直接跳转 guardrails，跳过检索与生成。

SQL 与规划¶

术语	英文	定义
SQL 护栏	SQL Guardrails	五层校验：①语法解析 ②策略禁词 ③AST 列引用 ④术语绑定语义 ⑤EXPLAIN 成本估算（ADR-5）。详见第 6 章。
语义查询规划器	Semantic Query Planner	位于 reranker → sql_generator 之间的确定性规划层，用 KMB Steiner 树做 join 路由、用代数重写提供建议（Advisory 模式，ADR-18）。
Advisory 模式	Advisory Mode	规划器不直接编译 SQL，而是产出结构化 guidance 增强 LLM 生成，失败时安全回退为空。
术语绑定强路由	Term Binding Strong Routing	业务术语到物理列/指标的 `mapped_asset_id` 映射，贯穿检索→重排→Prompt→护栏→自愈五层（ADR-16）。
Chasm Trap	Chasm Trap	多事实表通过同一维度表关联时导致的扇出重复计数问题，规划器用 aggregate-before-join 重写解决。
Steiner Tree	Steiner Tree	给定图与终端节点，找到包含所有终端的最小权重子树（NP-hard，KMB 近似）。TTD 用 NetworkX 求解 join 路径。详见第 6 章。
Fanout Risk	Fanout Risk	join 操作中一方行数被另一方放大导致重复计数的风险，规划器据此加权避让高扇出 join。
Context Compaction	Context Compaction	上下文压缩，当历史超过 token 预算时压缩早期对话为摘要，保留最近轮次原样。详见第 7 章。

补充术语¶

术语	英文	定义
Circuit Breaker	Circuit Breaker	熔断器，连续 N 次失败后暂停模型调用一段时间（默认 3 次/60s），防止级联故障。
Content Safety Guard	Content Safety Guard	输入安全层，拦截 prompt 注入与 SQL 注入（DML 检测 + 注入模式检测）。详见第 14 章。
Columnar Mirror	Columnar Mirror	列存镜像，pg_mooncake 通过 `mooncake.create_table()` 从行存源表创建的列存副本，加速 OLAP 聚合。详见第 10 章。
Metadata Cache	Metadata Cache	元数据缓存，TTL 24h，减少 PG 元数据查询。

记忆与会话¶

术语	英文	定义
四层记忆	Four-Layer Memory	Working（短期）/ Profile / Episodic / Correction（长期）。详见第 7 章。
SQL 语义缓存	SQL Semantic Cache	只缓存生成的 SQL 文本（不缓存结果），pgvector 余弦相似度 ≥ 0.92 命中，TTL 15 分钟（ADR-10）。
动态 Few-Shot 缓存	Dynamic Few-Shot Cache	从 SQL 修复成功案例自动学习的 `{question, sql}` 对，经三步审批（pending_review → approved）且相似度 ≥ 0.95 后注入 RAG Engine D。

安全与认证¶

术语	英文	定义
Better Auth	Better Auth	托管在 Next.js 的统一身份源，签发 RS256 JWT，Backend 通过 JWKS 本地验签（ADR-17）。
PII 分级暴露	PII Tiered Exposure	`llm_exposure_policy: visible/masked/hidden`，hidden 列不参与 embedding（ADR-14）。
双语必备	Bilingual Requirement	所有元数据资产同时维护 `_zh`/`_en` 字段，CI 强制校验（ADR-13）。

部署与运维¶

术语	英文	定义
Agent Runtime Pool	Agent Runtime Pool	生产部署的多实例池化模式，每个实例跑 1 个 uvicorn worker，通过 Docker Swarm 编排。
HAProxy 一致性哈希	HAProxy Consistent Hash	基于 `X-Chat-ID` 的 ketama 一致性哈希做 session affinity，是性能优化非正确性依赖。
PG Advisory Lock	PG Advisory Lock	`pg_advisory_xact_lock(hashtext(chat_id))` 跨实例互斥，保证同一会话的并发安全。
ObservabilityFacade	ObservabilityFacade	整合 Langfuse（追踪）/ AutoMQ（事件流）/ structlog（日志）/ Prometheus（指标）的统一可观测网关。

语义层发布管道¶

术语	英文	定义
语义层知识库	Semantic Knowledge Base	TTD 后台配置的语义数据源，指向 S3 上的语义资产快照，Backend 定时轮询 manifest hash 检测变更。
自动同步	Auto-Sync	Backend 检测到 S3 语义资产变更后，自动执行 R/V/G pipeline：Upsert 关系表（R）、MERGE AGE 图（G）、生成 embedding（V），将索引同步到各 RAG 存储。
Changeset	Changeset	语义资产发布的变更集，支持增量（git diff）与全量两种构建模式。

模型¶

术语	英文	定义
ModelRegistry	ModelRegistry	多模型注册中心，支持代码默认 + Admin DB 覆盖两层配置（ADR-7）。
任务驱动路由	Task-Driven Routing	按任务类型（sql_generation/insights/...）而非提供商分配模型，DB 可在线覆盖。
Fallback 链	Fallback Chain	主模型不可用时按顺序尝试的备选模型列表。

模型版本权威

代码默认模型（见 backend/app/models/registry.py）：deepseek-v4-flash（理解/规划/轻量任务）、deepseek-v4-pro（SQL 生成/修复）、qwen3.7-max（洞察/可视化/解释/知识问答）。Embedding 默认 text-embedding-v4（部署 schema 1024 维；builtin 默认 1536，待统一，见 ADR-7）。