# ── 数字我 / Digital Me — backend env ─────────────────────────────────
# Copy to `.env` and fill in. Everything optional degrades gracefully
# (the product stays usable end-to-end even with no AI keys).

PORT=3701
NODE_ENV=development

# 系统版本（独立部署两个系统时各自锁定）：
#   adult = 成人系统（社交/广场/群聊/专家付费/钱包）
#   teen  = 青少年教育系统（错题/互考/排行榜/家长监护）
#   both  = 单体平台（默认）
# 两系统应各自独立部署：独立 EDITION + 独立 MONGO_DB(或 COLLECTION_PREFIX) + 独立域名。
EDITION=both

# Public origin of THIS api. DashScope pulls media (photo/audio) BY URL,
# so for avatar 捏脸 / 口播视频 to work this MUST be publicly reachable
# (a localhost URL fails — those features degrade, chat still works).
PUBLIC_URL=http://localhost:3701

# Web app origin(s), comma-separated.
CORS_ORIGINS=http://localhost:5173

# Auth
JWT_SECRET=change-me-in-prod
JWT_EXPIRES=7d

# 登录方式：邮箱密码（内置）+ 手机短信 + 微信扫码。
# 短信：设 SMS_PROVIDER=aliyun 走真实发送（需下列四项全配齐）；留空=stub（验证码在
# 响应 devCode 返回，仅 dev；生产 stub 默认 fail-closed，除非 ALLOW_STUB_LOGIN=true）。
SMS_PROVIDER=stub
ALIYUN_SMS_KEY_ID=            # 阿里云 AccessKey ID（建议用 RAM 子账号，仅授 AliyunDysmsFullAccess）
ALIYUN_SMS_KEY_SECRET=        # 对应 AccessKey Secret
ALIYUN_SMS_SIGN=             # 短信签名(控制台「国内消息-签名管理」审核通过的签名名称)
ALIYUN_SMS_TEMPLATE=         # 短信模板 CODE(如 SMS_123456789，验证码类模板)
# 模板正文里的验证码变量名。默认 code(对应模板 ${code})；模板用别的变量名时改这里。
ALIYUN_SMS_CODE_PARAM=code
# 微信【网站应用】扫码登录（open.weixin.qq.com 开放平台，scope=snsapi_login）。
#   留空=stub 二维码（本地可模拟扫码；生产 fail-closed 除非 ALLOW_STUB_LOGIN=true）。
#   ⚠ 开放平台后台「网站应用 → 授权回调域」必须填 WECHAT_REDIRECT_URI 的域名(只填域名,不带路径/协议)。
#   ⚠ 拿真实昵称/头像会调 sns/userinfo；unionid 需该应用已绑定到【开放平台账号】才返回(用于统一身份)。
WECHAT_APP_ID=
WECHAT_APP_SECRET=
# 回调地址,须公网可达。留空默认 ${PUBLIC_URL}/api/auth/wechat/callback。
WECHAT_REDIRECT_URI=

# MongoDB — Digital Me owns its own DB. Never share another product's.
MONGO_URI=mongodb://localhost:27017
MONGO_DB=digital_me

# ── AI: 阿里云 DashScope (one key powers LLM + embeddings + 万相 + EMO + CosyVoice) ──
DASHSCOPE_API_KEY=
DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
LLM_MODEL=qwen-max
EMBED_MODEL=text-embedding-v3
# 通用图片生成(万相文生图)模型。复用 DASHSCOPE key,有 key 即可用(需百炼已开通万相文生图)。
# 可选：wanx2.1-t2i-turbo(快省·默认) / wanx2.1-t2i-plus(更精更贵)。经统一入口 POST /api/create(modality=image)。
WANX_T2I_MODEL=wanx2.1-t2i-turbo

# ── 二创·AI 音乐生成：昆仑万维 Mureka ──────────────────────────────────
# 配 MUREKA_API_KEY 即启用(经 POST /api/create type=music:词+曲风→成品歌)。缺 key → 音乐生成 503。
# ⚠ 数据出境：歌词/曲风会发往 MUREKA_BASE_URL(默认 api.mureka.ai);合规要境内就指到 Mureka 境内 API 域。
MUREKA_API_KEY=
MUREKA_BASE_URL=https://api.mureka.ai
MUREKA_MODEL=auto              # auto / mureka-6 / V8 等

# ── 二创·AI 视频生成：字节 Seedance（火山方舟）──────────────────────────
# 配 SEEDANCE_API_KEY(=火山方舟 API Key)即启用(经 POST /api/create type=drama:文/图生视频)。缺 key → 503。
# 端点走火山方舟【境内北京】域,数据不出域友好。model 需与你账号已开通的一致;若账号要求推理接入点,
# 把 SEEDANCE_MODEL 设成 ep-xxxxx。
SEEDANCE_API_KEY=
SEEDANCE_BASE_URL=https://ark.cn-beijing.volces.com
SEEDANCE_MODEL=doubao-seedance-1-0-pro-250528
# 知识检索精排模型。gte-rerank 已于 2026-05-30 下线，默认用后继 qwen3-rerank。
RERANK_MODEL=qwen3-rerank

# ── 语音合成 CosyVoice ──────────────────────────────────────────────
# 新克隆音色的注册版本（默认已升 v3.5-flash；高质可用 cosyvoice-v3.5-plus）。
#  ⚠ v3.5 仅北京地域，需在百炼【北京】工作空间开通 CosyVoice；旧 v2 克隆音仍按各自版本合成。
COSYVOICE_MODEL=cosyvoice-v3.5-flash
# 预置音色 TTS（助手讲解 / 无克隆音兜底）的模型。预置音色名分版本、v3.5 官方未公布 →
# 默认仍 v2；待 v3.5 音色公布后，改这里 + 相应 TWIN_COSY_PRESET/ASSISTANT_COSY_VOICE 音色名。
COSYVOICE_PRESET_MODEL=cosyvoice-v2
# 实时合成 WebSocket 端点。默认北京全局端点；若工作空间要求专属 MaaS 端点再填。
# COSYVOICE_WS_URL=wss://<WorkspaceId>.cn-beijing.maas.aliyuncs.com/api-ws/v1/inference

# 向量索引后端。留空 → memory(MongoDB 内联向量 + 内存暴力余弦,有 2000 块上限,适合小规模)。
# 配了 DASHVECTOR_ENDPOINT + DASHVECTOR_API_KEY → 自动切阿里云 DashVector(境内托管向量库,ANN 索引,
# 数据不出域,去掉 2000 块上限)。首次接入或换维度后跑一次:node scripts/reindex-vectors.js
# DASHVECTOR_DIM 必须与 EMBED_MODEL 维度一致(text-embedding-v3 = 1024)。
DASHVECTOR_ENDPOINT=
DASHVECTOR_API_KEY=
DASHVECTOR_COLLECTION=digitalme_knowledge
DASHVECTOR_DIM=1024

# Optional Claude fallback when Qwen is unavailable.
ANTHROPIC_API_KEY=
ANTHROPIC_MODEL=claude-haiku-4-5-20251001

# 标准英文发音 (Azure Neural TTS) — 英语陪练用原生发音。留空则英文回退
# CosyVoice(克隆音色) 或浏览器 TTS。
AZURE_SPEECH_KEY=
AZURE_SPEECH_REGION=eastasia
AZURE_VOICE_EN=en-US-JennyNeural

# Avatar 捏脸 (通义万相 wanx-style-repaint). Blank → uploaded photo used flat.
# 'dashscope' reuses DASHSCOPE_API_KEY. Style: a name (3d/anime/ink/fresh)
# or raw wanx style_index 0-9. For a realistic "self" twin, leaving the
# uploaded photo flat (blank provider) is often the most faithful.
AVATAR_PROVIDER=
AVATAR_STYLE=3d

# Storage: 配齐下面 OSS_* 四要素 → 自动用阿里云 OSS(推荐:公网直链、免公网穿透、
# 重部署不丢片、DashScope 直接按 URL 拉);否则回落本地磁盘 + /uploads。
STORAGE_DRIVER=local
STORAGE_LOCAL_DIR=./data/uploads
# ── 阿里云 OSS(媒体存储,生产推荐)──────────────────────────────────
# ⚠ OSS_REGION 必须带 oss- 前缀(如 oss-cn-hangzhou),否则 SDK 拼错域名 ENOTFOUND。
# 存进 DB 的是持久直链(头像/成片长期展示)→ bucket 需「公开读」,或用 OSS_PUBLIC_BASE
# 指向自定义域名/CDN。共享 bucket 靠 OSS_PREFIX 隔离(digital-me 用 digitalme)。
OSS_REGION=
OSS_BUCKET=
OSS_ACCESS_KEY_ID=
OSS_ACCESS_KEY_SECRET=
OSS_ENDPOINT=
OSS_PREFIX=digitalme
OSS_PUBLIC_BASE=

# ── 生产级安全 (production hardening) ─────────────────────────────────
# In production (NODE_ENV=production) the server REFUSES to boot unless
# JWT_SECRET is set to a strong random value (not the default).

# Encrypt visitor chat logs at rest (AES-256-GCM). Any string → hashed to
# a 32-byte key. Strongly recommended in prod; empty = plaintext (dev only).
DATA_ENC_KEY=

# Emails (comma-separated) allowed to grant 蓝V verification & admin actions.
SUPER_ADMIN_EMAILS=

# Content moderation. Tiers (highest available wins, falls back down):
#   external — set MODERATION_URL (plug a pro service; POST {text} → {allowed,category?})
#   llm      — set MODERATION_MODE=llm to classify via DashScope (Qwen)
#   local    — built-in regex floor (always on)
MODERATION_MODE=
MODERATION_URL=
MODERATION_KEY=

# Max length of any chat/visitor message (cost + abuse control).
MAX_QUESTION_LEN=2000

# Set 'true' when behind nginx/cloudflare so client IP (rate-limit key) is
# correct. Auto-on in production; set 'false' to force off.
TRUST_PROXY=

# ── 请求访问日志 ──────────────────────────────────────────────────────
# 每个请求打一行(方法/路径/状态码/耗时/IP/请求ID)。只记元数据,不记 query/body。
LOG_REQUESTS=on            # off 关闭访问日志
LOG_SLOW_MS=5000           # 超过该耗时(ms)的请求标记 ⚠slow
LOG_SKIP_PATHS=/health     # 不记的高频噪声路径(逗号分隔,前缀匹配)

# ── 付费咨询 / 钱包 (FR-4.2) ──────────────────────────────────────────
# 支付通道：
#   stub   = 即时到账（最快开发态）
#   mock   = 完整模拟「下单→支付→回调入账」异步链路（不涉及真钱，可本地验证）
#   stripe = Stripe Checkout（需 STRIPE_SECRET_KEY + STRIPE_WEBHOOK_SECRET）
#   wechat = 预留（在 payments.js 实现下单 + 回调）
PAYMENT_PROVIDER=stub
TOKENS_PER_YUAN=10
PAY_CURRENCY=cny
# 用户支付后返回的前端地址（默认取 CORS_ORIGINS 第一个）。
WEB_BASE_URL=

# 分享卡片 og meta（/me/:slug、/s/:token 的微信/IM 富卡片）。见 DEPLOY.md。
# 填了→读真 SPA index 注入 meta（页面仍是完整 App）；空→回落 meta+跳转独立壳。
SPA_INDEX_PATH=
# 可选：无头像时的兜底卡片图（绝对 URL）。
OG_FALLBACK_IMAGE=

# 微信 JS-SDK（公众号「转发给朋友/朋友圈」自定义卡片）。填【公众号】appId/secret
# （非开放平台扫码登录的那个）。空 → 签名接口 {configured:false}、前端休眠。见 DEPLOY.md。
# 还需在公众号后台把 digitalme.invoratec.cn 加进「JS 安全域名」。
WX_MP_APP_ID=
WX_MP_APP_SECRET=
# Stripe（provider=stripe 时必填）。Webhook 配到 /api/wallet/webhook/stripe。
STRIPE_SECRET_KEY=
STRIPE_WEBHOOK_SECRET=

# ── 产品工厂 购买通道 (商店/buy → 购买即开通) ─────────────────────────
# STORE_PROVIDER：只管【stub ↔ 真实支付】总闸，与「用哪个渠道」正交（渠道见 PAY_METHODS）。
#   stub        = 即时开通（无真实收款，开发/演示用，默认）
#   live(或wechat) = 真实支付（非 stub 即视为开）。具体渠道由 PAY_METHODS 决定：
#            · 微信：需 WXPAY_* 配齐（微信内 JSAPI 还需 WX_MP_* + 公众号绑商户号）
#            · 支付宝：需 ALIPAY_* 证书三件套配齐
STORE_PROVIDER=stub
# 测试收款：PAY_ENV=dev 或 test 时，所有付费订单只收 1 分钱——走真实通道验证下单→
# 收银台→回调→开通全链，但只花 1 分。免费 SKU(¥0) 不受影响。生产留空。
PAY_ENV=
# 支付弹窗展示哪些收款方式 + 顺序（逗号分隔，只认 wechat/alipay）。留空默认 wechat,alipay。
#   PAY_METHODS=wechat,alipay → 微信在前；=alipay → 只显示支付宝；=wechat → 只微信。
PAY_METHODS=wechat,alipay
# 下单显式超时（分钟）：过期后二维码/支付链接失效，渠道自动关单。前端轮询时长与之对齐。
PAY_ORDER_TIMEOUT_MIN=10

# 微信支付 v3（商户平台 → API 安全）。Webhook 配到 /api/store/webhook/wechat。
WXPAY_APP_ID=            # 商户绑定的 appid（JSAPI 用 WX_MP_APP_ID 那个公众号；Native 可公众号/开放平台）
WXPAY_MCH_ID=            # 商户号
WXPAY_API_V3_KEY=        # APIv3 密钥（必须 32 位）
WXPAY_CERT_SERIAL=       # 商户 API 证书序列号
# 商户私钥 PEM：二选一。直接给内容(把换行写成 \n) 或给文件路径。
WXPAY_PRIVATE_KEY=
WXPAY_PRIVATE_KEY_PATH=
# 微信支付【平台证书】(回调验签用公钥)。配上即启用「回调验签闸」(防伪造/重放)；
# 未配时回调仅靠 APIv3 GCM 鉴权放行。二选一：贴内容(\n 转义) 或给文件路径。
WECHATPAY_PLATFORM_CERT=
WECHATPAY_PLATFORM_CERT_PATH=

# 支付宝 · 电脑网站支付【证书模式/RSA2】。Webhook 配到 /api/store/webhook/alipay。
# 证书三件套从开放平台下载；每项二选一：贴内容(\n 转义) 或给 *_PATH 文件路径。
#   ALIPAY_APP_CERT      = 应用公钥证书 appCertPublicKey_2021xxx.crt
#   ALIPAY_CERT          = 支付宝公钥证书 alipayCertPublicKey_RSA2.crt
#   ALIPAY_ROOT_CERT     = 支付宝根证书 alipayRootCert.crt
# 沙箱：ALIPAY_GATEWAY=https://openapi.alipaydev.com/gateway.do（生产留空即用默认生产网关）。
ALIPAY_APP_ID=
ALIPAY_PRIVATE_KEY=
ALIPAY_PRIVATE_KEY_PATH=
ALIPAY_APP_CERT=
ALIPAY_APP_CERT_PATH=
ALIPAY_CERT=
ALIPAY_CERT_PATH=
ALIPAY_ROOT_CERT=
ALIPAY_ROOT_CERT_PATH=
ALIPAY_GATEWAY=

# ── 拟人化互动合规 ────────────────────────────────────────────────────
# 《人工智能拟人化互动服务管理暂行办法》(网信办/发改委/工信部/公安部/市场监管总局
#  五部门，2026-04-10 公布，2026-07-15 施行)。本产品的「数字分身」命中第二条
# 「模拟自然人人格特征、思维模式和沟通风格」要件，故第十四/十八条的义务适用。
#
# 未成年人模式(第十四条)总开关。⚠ 默认【开】——它是法定义务不是产品特性，
# 不配这个变量也是开的。设 off 仅供【误伤大面积用户时先关再修】的紧急止血，
# 关闭期间本站不符合第十四条，必须同步上报。
FEATURE_MINOR_MODE=on
# 未成年人模式下单日累计使用时长上限(分钟)。法条只写「使用时长限制」没给数字，
# 这里取《未成年人网络保护条例》的通行口径 60 分钟。调整前请过法务。
MINOR_DAILY_LIMIT_MIN=60
# 「定期现实提醒」周期(分钟)：每隔这么久提醒一次"这是 AI，去看看现实里的人和事"。
MINOR_REALITY_CHECK_MIN=20
# 第十四条要求「提供相应申诉渠道」。站内申诉入口已内置(minor_appeals 集合 + 超管处理)，
# 但法条要的是【用户看得见、联系得上】的渠道 → 生产【应当】填一个真实邮箱或电话。
# 留空时前端只显示站内申诉，并诚实写明"仅站内受理"。
COMPLIANCE_APPEAL_CONTACT=