# 复制为 .env 后填入真实值。.env 已在 .gitignore 中,不要提交。 # dev/staging/prod 由部署平台注入环境变量,不使用 .env(架构文档 §11.2)。 APP_ENV=local APP_NAME=meida-backend API_PREFIX=/api/v1 DEBUG=true LOG_LEVEL=INFO LOG_JSON=true # 需要额外脱敏的字段名,逗号分隔;默认清单见 packages/shared/logging.py LOG_EXTRA_REDACT_KEYS= # ── 数据库 / Redis ───────────────────────────────────────────────────────── # 端口刻意用 55432 / 56379,避免与本机已有的 PostgreSQL、Redis 抢端口 DATABASE_URL=postgresql+asyncpg://meida:meida@localhost:55432/meida DB_POOL_SIZE=10 DB_MAX_OVERFLOW=20 DB_ECHO=false REDIS_URL=redis://localhost:56379/0 CELERY_BROKER_URL=redis://localhost:56379/1 CELERY_RESULT_BACKEND=redis://localhost:56379/2 # ── 鉴权 ────────────────────────────────────────────────────────────────── # 生成:openssl rand -hex 32 。staging/prod 若沿用占位值会启动失败 JWT_SECRET=change-me-local-only-do-not-use-outside-local JWT_ALGORITHM=HS256 JWT_ACCESS_TTL_SECONDS=900 JWT_ISSUER=meida # 免登录换 token 的调试入口,仅本地/联调可开 DEV_AUTH_ENABLED=true # ── LLM 路由 ────────────────────────────────────────────────────────────── LLM_PRIMARY_PROVIDER=deepseek LLM_BACKUP_PROVIDER=zhipu LLM_STRUCTURED_MAX_RETRIES=2 LLM_CIRCUIT_FAILURE_THRESHOLD=3 LLM_CIRCUIT_COOLDOWN_SECONDS=30 # 按场景覆盖模型与采样参数,如 {"agent_chat":{"temperature":0.5}} LLM_SCENE_OVERRIDES_JSON={} DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx DEEPSEEK_BASE_URL=https://api.deepseek.com/v1 DEEPSEEK_MODEL=deepseek-v4-flash DEEPSEEK_TIMEOUT_SECONDS=30 ZHIPU_API_KEY= ZHIPU_BASE_URL=https://open.bigmodel.cn/api/paas/v4 ZHIPU_MODEL=glm-4-flash ZHIPU_TIMEOUT_SECONDS=30 # ── Prompt 缓存纪律 ─────────────────────────────────────────────────────── # strict:固定前缀里出现时间戳/随机值等易变 token 直接启动失败。 # 命中缓存的输入价格只有未命中的 1/30,前缀被污染会让输入成本翻数十倍。 LLM_CACHE_PREFIX_MODE=strict PROMPTS_DIR=prompts # ── 成本单价(单位:分 / 百万 token)────────────────────────────────────── # 取自 DeepSeek 官方价目表。2026-08-17 00:00 起改为峰谷定价: # 高峰(北京时间 09:00-12:00、14:00-18:00)单价是空闲时段的 2 倍。 # 因此这里要配两套,由 packages/llm/cost.py 按调用时刻选择。 # flash 空闲:缓存命中 ¥0.05 / 输入 ¥1.5 / 输出 ¥4.5 每百万 token LLM_COST_RATES_JSON={"deepseek-v4-flash":{"input_cents_per_mtok":"150","cached_input_cents_per_mtok":"5","output_cents_per_mtok":"450"},"deepseek-v4-pro":{"input_cents_per_mtok":"450","cached_input_cents_per_mtok":"15","output_cents_per_mtok":"1350"},"glm-4-flash":{"input_cents_per_mtok":"10","cached_input_cents_per_mtok":"10","output_cents_per_mtok":"10"}} # flash 高峰:缓存命中 ¥0.10 / 输入 ¥3 / 输出 ¥9 每百万 token LLM_COST_RATES_PEAK_JSON={"deepseek-v4-flash":{"input_cents_per_mtok":"300","cached_input_cents_per_mtok":"10","output_cents_per_mtok":"900"},"deepseek-v4-pro":{"input_cents_per_mtok":"900","cached_input_cents_per_mtok":"30","output_cents_per_mtok":"2700"},"glm-4-flash":{"input_cents_per_mtok":"10","cached_input_cents_per_mtok":"10","output_cents_per_mtok":"10"}} # 未登记的模型按这个价算。刻意取高档:宁可高估触发熔断,也不要低估成本形成盲区 LLM_DEFAULT_COST_RATE_JSON={"input_cents_per_mtok":"300","cached_input_cents_per_mtok":"10","output_cents_per_mtok":"900"} LLM_PEAK_PRICING_ENABLED=true # ── 全局日成本熔断(NFR-COST-02)───────────────────────────────────────── # 按用户配额封不住总成本(总成本 = 用户数 × 人均,用户数无上限), # 真正封顶的只有这个全局开关。 # 100000 分 = ¥1000/天,是按 8-17 之前旧单价推的占位,不是验收值。 # 峰谷生效后须用实测 token 分布重算(T-P1-25b),否则熔断会在错误位置触发。 LLM_DAILY_BUDGET_ENABLED=true LLM_DAILY_BUDGET_CENTS=100000 LLM_BUDGET_TIMEZONE_OFFSET_HOURS=8 # ── 可观测性 ────────────────────────────────────────────────────────────── OTEL_ENABLED=false OTEL_SERVICE_NAME=meida-api OTEL_EXPORTER_OTLP_ENDPOINT= PROMETHEUS_ENABLED=true # ── 四档分级降级(T-P1-25b,架构 §13.3)────────────────────────────────── # JSON 为列表;blocked 支持 "*";allow 仅 block_all 档有意义(纯文本对话放行)。 # 留空则使用内置默认四档(与下面示例一致)。 LLM_BUDGET_TIERS_JSON=[{"threshold":0.6,"name":"warn","blocked":[]},{"threshold":0.8,"name":"degrade_secondary","blocked":["hd_export","report_regen"]},{"threshold":0.9,"name":"degrade_generation","blocked":["hairstyle","tryon"]},{"threshold":1.0,"name":"block_all","blocked":"*","allow":["agent_chat"]}] # ── 会话(FR-ACC-05)─────────────────────────────────────────────────────── REFRESH_TOKEN_TTL_SECONDS=2592000 # ── 任务奖励(FR-BILL-03/04)─────────────────────────────────────────────── # amount 均为占位值 1:正式数值待产品在产品方案 §3.2 定稿后改此处,不改代码。 # claim_period 决定幂等粒度(同一任务同周期只能领一次)。 TASK_BONUS_RULES_JSON={"sign_in":{"quota_key":"agent_chat","amount":1,"claim_period":"day"},"profile_complete":{"quota_key":"agent_chat","amount":1,"claim_period":"lifetime"},"report_feedback":{"quota_key":"report_regen","amount":1,"claim_period":"day"},"share_report":{"quota_key":"tryon","amount":1,"claim_period":"day"},"invite_friend":{"quota_key":"tryon","amount":1,"claim_period":"day"}} # ── 客户端埋点(FR-SYS-06)───────────────────────────────────────────────── EVENTS_MAX_BATCH=50 EVENTS_PROPS_MAX_BYTES=8192 # ── 腾讯云 COS 直传(FR-SYS-03 / T-P1-27)────────────────────────────────── # 密钥只在此文件对应的真实 .env 里出现;四桶按《前置开通清单》创建后填名称。 COS_REGION=ap-shanghai COS_SECRET_ID= COS_SECRET_KEY= COS_BUCKET_TEMP=meida-temp COS_BUCKET_USER=meida-user COS_BUCKET_KB=meida-kb COS_BUCKET_REPORT=meida-report COS_PRESIGN_EXPIRE_SECONDS=600 UPLOAD_MAX_BYTES=20971520 UPLOAD_ALLOWED_TYPES=image/jpeg,image/png,image/webp UPLOAD_SCENES_JSON={"report_photo":{"bucket":"temp"},"avatar":{"bucket":"temp"}}