.env.hf.example

# Hugging Face Spaces 推荐运行配置
# 说明：这个文件是示例模板，不要把真实密钥直接写进仓库
#
# 使用方式：
# 1. GitHub Actions 中配置自动同步所需变量
#    - Secret: HF_TOKEN
#    - Variable: HF_SPACE_ID=DanielleNguyen/Qwen2API-A
# 2. Hugging Face Space 中按下面两类分别配置：
#    - HF Secrets：敏感信息，例如 API_KEY、HF_TOKEN
#    - HF Variables：普通运行配置，例如端口、目录、开关
# 3. 不建议在仓库中提交真实 .env 文件

# ==================================================
# HF Secrets 建议新建这些
# ==================================================
# API_KEY=sk-admin-yourkey,sk-user-yourkey
# HF_TOKEN=hf_xxx
# HF_BUCKET_TOKEN=
# ACCOUNTS=
# REDIS_URL=
# PROXY_URL=
# QWEN_CHAT_PROXY_URL=
# QWEN_CLI_PROXY_URL=

# ==================================================
# HF Variables 建议新建这些
# ==================================================

# ==============================
# 服务监听配置
# Hugging Face Docker Space 建议固定如下：
# - SERVICE_PORT=7860
# - LISTEN_ADDRESS=0.0.0.0
# ==============================
SERVICE_PORT=7860
LISTEN_ADDRESS=0.0.0.0

# ==============================
# 运行模式配置
# Hugging Face 免费空间当前建议单进程运行，更稳定
# PM2_MAX_MEMORY 是自动重启阈值，不是实际只给 4G 内存
# ==============================
PM2_INSTANCES=1
PM2_MAX_MEMORY=4G
NODE_ENV=production

# ==============================
# API 访问密钥
# 第一个密钥是管理员密钥，后面的密钥是普通调用密钥
# 这是敏感信息，建议放到 HF Secrets
# ==============================
API_KEY=sk-admin-demo,sk-user-demo

# ==============================
# 功能配置
# 这些属于普通配置，建议放到 HF Variables
# ==============================
OUTPUT_THINK=true
SEARCH_INFO_MODE=table
SIMPLE_MODEL_MAP=false

# ==============================
# 数据存储配置
# 当前推荐方案：使用 Hugging Face Bucket 做文件持久化
# - 项目内部使用 DATA_SAVE_MODE=file
# - 启动时从 Bucket 拉取数据到本地目录
# - 运行中定时同步本地目录回 Bucket
# ==============================
DATA_SAVE_MODE=file

# 下面两项通常属于敏感信息，建议放到 HF Secrets
REDIS_URL=
ACCOUNTS=

# 下面这些路径配置建议放到 HF Variables
DATA_DIR=/data/qwen2api/data
CACHE_DIR=/data/qwen2api/caches
LOG_DIR=/data/qwen2api/logs

# ==============================
# Hugging Face Bucket 持久化配置
# HF_BUCKET_REPO：你的 Bucket 名称，建议放到 HF Variables
# HF_TOKEN：Hugging Face 账号 Token，Space 通过它访问 Bucket，建议放到 HF Secrets
# HF_BUCKET_TOKEN：可选；如果单独给 Bucket 配 token，则优先使用它，也建议放到 HF Secrets
# ==============================
HF_BUCKET_REPO=DanielleNguyen/Qwen2API-A-Storage
HF_TOKEN=
HF_BUCKET_TOKEN=
HF_BUCKET_LOCAL_DIR=/data/qwen2api
HF_BUCKET_REMOTE_DIR=runtime
HF_BUCKET_SYNC_INTERVAL=300
HF_BUCKET_SYNC_DEBOUNCE_SECONDS=5
HF_BUCKET_STARTUP_GRACE_SECONDS=30

# ==============================
# 日志配置
# Hugging Face 一般不建议开启文件日志，直接看容器日志即可
# ==============================
LOG_LEVEL=INFO
ENABLE_FILE_LOG=false
MAX_LOG_FILE_SIZE=10
MAX_LOG_FILES=5

# ==============================
# 代理 / 上游反代配置
# 按需填写；不需要就留空
# 如果地址中带认证信息，建议放到 HF Secrets
# ==============================
QWEN_CHAT_PROXY_URL=
QWEN_CLI_PROXY_URL=
PROXY_URL=

# ==============================
# 图片缓存配置
# 配合 Bucket 持久化时建议使用 file
# ==============================
CACHE_MODE=file