附录 B · 环境变量完整参考¶

本表是 TTD 所有环境变量的唯一权威完整列表。所有变量使用 TTD_ 前缀，通过 backend/app/config.py 的 Pydantic Settings 单例读取。完整 .env.example 在仓库根目录。

标记说明

服务器¶

变量	类型	默认值	说明
`TTD_AURORA_DSN`	str	`postgresql://postgres:postgres@localhost:5435/ttd_db`	PG Supernode 连接串
`TTD_PG_POOL_MIN`	int	`5`	连接池最小（per instance）
`TTD_PG_POOL_MAX`	int	`20`	连接池最大（per instance）

变量	类型	默认值	说明
`TTD_DATA_PLANE_BACKEND`	str	`redshift`	数据面后端 (`redshift` / `pg_mooncake`)
`TTD_REDSHIFT_HOST`	str	`localhost`	Redshift 主机
`TTD_REDSHIFT_PORT`	int	`5439`	Redshift 端口
`TTD_REDSHIFT_DATABASE`	str	`ttd_gold`	Redshift 数据库
`TTD_REDSHIFT_USER`	str	`ttd_service`	Redshift 用户
`TTD_REDSHIFT_PASSWORD`	str	—	Redshift 密码（必填，生产）
`TTD_REDSHIFT_TIMEOUT_MS`	int	`30000`	Redshift 查询超时
`TTD_PG_MOONCAKE_DSN`	str	`postgresql://...@localhost:5436/ttd_lake`	pg_mooncake 连接串

变量	类型	默认值	说明
`TTD_ANTHROPIC_API_KEY`	str	—	Anthropic API Key（必填，若用 Anthropic）
`TTD_DASHSCOPE_API_KEY`	str	—	DashScope API Key（必填，默认 LLM provider）
`TTD_DASHSCOPE_BASE_URL`	str	`https://dashscope.aliyuncs.com/compatible-mode/v1`	DashScope Base URL
`TTD_SUPERVISOR_MODEL`	str	`deepseek-v4-flash`	Supervisor 模型
`TTD_SQL_GENERATION_MODEL`	str	`deepseek-v4-pro`	SQL 生成模型
`TTD_INSIGHTS_MODEL`	str	`qwen3.7-max`	Insights 模型
`TTD_VISUALIZATION_MODEL`	str	`qwen3.7-max`	Visualization 模型
`TTD_FOLLOWUP_MODEL`	str	`deepseek-v4-flash`	Follow-up 模型
`TTD_EMBEDDING_MODEL`	str	`text-embedding-v4`	Embedding 模型

变量	类型	默认值	说明
`TTD_BETTER_AUTH_URL`	str	`http://localhost:3000`	Better Auth URL（JWKS 来源）
`TTD_BETTER_AUTH_ISSUER`	str	`http://localhost:3000`	JWT issuer 校验值
`TTD_JWKS_CACHE_TTL_SECONDS`	int	`3600`	JWKS 公钥缓存（秒）
`TTD_JWT_AUDIENCE`	str	`talk-to-data`	JWT 受众校验值
`TTD_JWT_SECRET`	str	`change-me-in-production`	旧 HS256 密钥（迁移期回退，将移除；生产路径为 RS256 via JWKS，见 ADR-17）
`TTD_JWT_ALGORITHM`	str	`HS256`	旧 JWT 算法（迁移期回退，将移除；生产路径为 RS256 via JWKS，见 ADR-17）
`TTD_RATE_LIMIT_PER_USER`	int	`60`	每用户请求限制（**当前为死配置，代码未引用，实际限流为硬编码 60/minute，见第 14 章）
`TTD_BURST_LIMIT`	int	`100`	突发限制（**当前为死配置，代码未引用，见第 14 章）
`TTD_MAX_QUESTION_LENGTH`	int	`2000`	问题最大长度
`TTD_CORS_ORIGINS`	list	`["*"]`	CORS 允许源（生产设为 Better Auth URL）

变量	类型	默认值	说明
`TTD_SESSION_TTL_HOURS`	int	`24`	会话 TTL
`TTD_SESSION_MAX_TURNS`	int	`20`	最大轮次
`TTD_CONTEXT_WINDOW`	int	`5`	上下文窗口
`TTD_CLEANUP_INTERVAL_MINUTES`	int	`60`	清理间隔

变量	类型	默认值	说明
`TTD_SHORT_TERM_WINDOW`	int	`5`	短期记忆窗口
`TTD_CONTEXT_COMPACTION_TOKEN_BUDGET`	int	`3000`	上下文压缩 token 预算
`TTD_CONTEXT_COMPACTION_RECENT_WINDOW`	int	`3`	保留原样的最近轮数
`TTD_SQL_CACHE_SIMILARITY`	float	`0.92`	SQL 缓存匹配阈值
`TTD_SQL_CACHE_TTL_MINUTES`	int	`15`	SQL 缓存 TTL
`TTD_METADATA_CACHE_TTL_SECONDS`	int	`86400`	元数据缓存 TTL (24h)
`TTD_SQL_EXECUTE_CACHE_TTL_SECONDS`	int	`86400`	SQL 执行缓存 TTL

变量	类型	默认值	说明
`TTD_MAX_REPAIR_RETRIES`	int	`1`	SQL 修复最大重试
`TTD_CIRCUIT_BREAKER_THRESHOLD`	int	`3`	熔断器阈值
`TTD_MAX_ESTIMATED_ROWS`	int	`10000000`	EXPLAIN 预估行数上限
`TTD_MAX_ESTIMATED_COST`	int	`100000`	EXPLAIN 预估成本上限
`TTD_FORBIDDEN_KEYWORDS`	list	`[INSERT, UPDATE, DELETE, ...]`	禁止的 SQL 关键词