Agent/examples/auto_put_ad_mini/.env.example

# auto_put_ad_mini 环境变量配置
# 复制此文件为 .env 并填入真实值

# ========================================
# 腾讯广告 API 配置
# ========================================
TENCENT_AD_ACCOUNT_ID=80769799

# Access Token（应用级认证）
# TENCENT_AD_ACCESS_TOKEN=xxx        # 可选，优先使用 Token API 动态获取

# User Token（用户级实名认证令牌）
# ⚠️ 重要：写操作（暂停广告/修改出价）必须配置 user_token
# 获取方式：https://docs.qq.com/doc/DSVdkdk1LQ1hOam5n
TENCENT_AD_USER_TOKEN=xxx
# 可选,默认使用内部接口按 accountId 动态获取最新 user_token
# TENCENT_AD_USER_TOKEN_API=https://api.piaoquantv.com/ad/put/tencent/getUserToken

# TENCENT_AD_BASE_URL=https://api.e.qq.com/v3.0

# 统一生产服务
DAILY_CREATION_ENABLED=0
DAILY_CREATION_HOUR=10
DAILY_CREATION_MINUTE=30
DAILY_REVIEW_ENABLED=0
DAILY_REVIEW_INTERVAL_HOURS=2
DAILY_RUN_ON_STARTUP=0
DAILY_REVIEW_RUN_ON_STARTUP=0
DAILY_SYNC_DELIVERY_TEMPLATE=0

# 日级 ROI 北极星指标与整批审批。默认只关闭,分阶段启用。
DAILY_ROI_ENABLED=0
DAILY_ROI_HOUR=11
DAILY_ROI_MINUTE=0
DAILY_ROI_RUN_ON_STARTUP=0
ROI_APPLY_ENABLED=0
ROI_APPROVAL_TTL_MINUTES=120
ROI_SCALE_RATIO=1.10
ROI_SCALE_COOLDOWN_DAYS=3
ROI_MAX_BASE_RATIO=2.00
ROI_FISSION_PARAMETER_VERSION=20260712_A0-A15_v1
# ROI报表发送到此群；同时抄送 FEISHU_OPERATOR_CHAT_ID，重复ID自动去重
# 为空时依次复用 FEISHU_AD_PROJECT_CHAT_ID / RTC_COMMAND_CHAT_ID
ROI_FEISHU_CHAT_ID=

RTC_START_HOUR=12
RTC_STOP_HOUR=21
RTC_POLL_SECONDS=600
RTC_HIGH_CPM=250
RTC_LOW_CPM=190
RTC_BID_UP_RATIO=1.05
RTC_MAX_PARTITION_LAG_HOURS=2
RTC_APPLY_ENABLED=0
RTC_COMMAND_ENABLED=1
RTC_COMMAND_CHAT_ID=
RTC_COMMAND_ALLOWED_OPEN_IDS=
RTC_COMMAND_CONFIRM_TTL_MINUTES=10
RTC_COMMAND_WORKERS=2

# ========================================
# 飞书 IM 审批配置
# ========================================
FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx

# 运营审批群聊（需要审批回复的群）
FEISHU_OPERATOR_OPEN_ID=ou_498988d823b61ab89c9afe4310f85bb4
FEISHU_OPERATOR_CHAT_ID=oc_88e0a1970a7de02eb5ac225a8b0cedea

# 投放项目群聊（仅通知，不需审批）— 可选配置
# 如何获取群聊ID：运行 python3 get_chat_id.py
# FEISHU_AD_PROJECT_CHAT_ID=oc_xxxxxxxxxxxxxxxxxxxxxx

# ========================================
# ODPS 数据平台配置
# ========================================
# ODPS_ACCESS_ID=xxx
# ODPS_ACCESS_SECRET=xxx
# ODPS_PROJECT=loghubods

# ========================================
# LLM API Key
# ========================================
# QWEN_API_KEY=xxx
# OPEN_ROUTER_API_KEY=xxx
# AI 图片生成模型。当前默认使用 OpenRouter Images API 可用的 pro 图片模型。
# OPENROUTER_IMAGE_MODEL=google/gemini-3-pro-image

# 外部素材召回账户专用。飞书「素材来源」填“外部素材”或“外部素材召回”时生效。
EXTERNAL_RECALL_SOURCE_LABEL=外部合作
EXTERNAL_RECALL_CANDIDATE_LIMIT=300
EXTERNAL_RECALL_EDIT_LIMIT_PER_LANDING=3
EXTERNAL_RECALL_UV_WINDOW_DAYS=90
# 默认复用 OPENROUTER_IMAGE_MODEL；可单独指定支持 input_references 的图片模型。
# EXTERNAL_IMAGE_MODEL=google/gemini-3.1-flash-image

# ========================================
# 数据库配置（MySQL）
# ========================================
DB_HOST=localhost
DB_PORT=3306
DB_USER=ad_rw
DB_PASSWORD=your_password
DB_NAME=auto_put_ad_mini

# ========================================
# 生产环境配置（海外部署）
# ========================================

# 白名单账户（逗号分隔）
# 注意：优先从数据库读取，数据库不可用时降级到环境变量
WHITELIST_ENABLED=true
WHITELIST_ACCOUNTS=80769799,71305011

# 代理配置（海外访问腾讯 API）
# HTTP_PROXY=http://proxy-server:port
# HTTPS_PROXY=http://proxy-server:port

# 时区配置（默认 UTC，可选 Asia/Shanghai）
TZ=UTC

# 执行开关（生产环境谨慎开启）
# 注意：优先从数据库读取，数据库不可用时降级到环境变量
EXECUTION_ENABLED=false

# API 端点（可选覆盖）
# TENCENT_AD_BASE_URL=https://api.e.qq.com/v3.0

# APScheduler 定时调度（使用 server.py 时）
# CRON_SCHEDULE=0 2 * * *  # 每天凌晨2点UTC
# RUN_ON_STARTUP=false     # 启动时是否立即执行
# PORT=8080                # FastAPI 服务端口