Agent/runtime.env.example

# ad-put-agent 双服务统一生产运行配置
# 复制为部署机 .env，填写真实密钥；本文件只保留安全默认值，不得写入真实凭证。

# 基础运行
TZ=Asia/Shanghai
LOG_LEVEL=INFO

# MySQL（两个服务共用）
DB_HOST=
DB_PORT=3306
DB_USER=
DB_PASSWORD=
DB_NAME=auto_put_ad_mini
DB_CONNECT_TIMEOUT=10
DB_READ_TIMEOUT=30
DB_WRITE_TIMEOUT=30

# 腾讯广告 API
TENCENT_AD_BASE_URL=https://api.e.qq.com/v3.0
TENCENT_AD_TOKEN_API=https://api.piaoquantv.com/ad/put/tencent/getAccessToken
TENCENT_AD_USER_TOKEN_API=https://api.piaoquantv.com/ad/put/tencent/getUserToken
TENCENT_AD_ACCESS_TOKEN=
TENCENT_AD_USER_TOKEN=
TENCENT_AD_TIMEOUT_SECONDS=30
TENCENT_AD_TOKEN_PREFETCH_WORKERS=8
TENCENT_AD_ACCOUNT_SCAN_WORKERS=8
TENCENT_AD_GET_RETRY_ATTEMPTS=3
TENCENT_AD_GET_RETRY_BACKOFF_SECONDS=1
# 仅作兼容默认账户；生产创建账户以飞书/数据库为准。
TENCENT_AD_ACCOUNT_ID=
TENCENT_AUDIENCE_SOURCE_ACCOUNT_ID=
TENCENT_AUDIENCE_GRANT_BUSINESS_ID=

# 飞书应用与生产群
FEISHU_APP_ID=
FEISHU_APP_SECRET=
# 投放调控通知群；同时接收创意审核异常处理全量汇总。
FEISHU_OPERATOR_CHAT_ID=
FEISHU_OPERATOR_OPEN_ID=
FEISHU_AD_PROJECT_CHAT_ID=
# 广告审批、创意审批和创建执行汇报专用群；为空时回退运营审批群。
FEISHU_CREATION_CHAT_ID=

# ODPS
ODPS_ACCESS_ID=
ODPS_ACCESS_SECRET=
ODPS_PROJECT=loghubods
ODPS_ENDPOINT=http://service.odps.aliyun.com/api

# 内容/素材/模型服务
DATANEXUS_ACCESS_TOKEN=
DATANEXUS_TOKEN_API=
OPEN_ROUTER_API_KEY=
# 兼容部分素材模块使用的无下划线变量名；生产可与上一项填同一值。
OPENROUTER_API_KEY=
OPENROUTER_IMAGE_MODEL=google/gemini-3-pro-image
OPENROUTER_TEXT_MODEL=
QWEN_API_KEY=

# AI/外部派生图片与 OSS
ALIYUN_OSS_ENDPOINT=
ALIYUN_OSS_BUCKET=
ALIYUN_OSS_ACCESS_KEY_ID=
ALIYUN_OSS_ACCESS_KEY_SECRET=
AI_IMAGE_OSS_PREFIX=auto_put_tencent/image
AI_IMAGE_PUBLIC_BASE_URL=
AI_IMAGE_ASPECT_RATIO=16:9
AI_IMAGE_RESOLUTION=1K
AI_IMAGE_OUTPUT_FORMAT=jpeg
AI_IMAGE_TARGET_WIDTH=1280
AI_IMAGE_TARGET_HEIGHT=720
AI_IMAGE_USE_PATTERN_SELECTOR=1
AI_IMAGE_PATTERN_TOP_K=1
AI_IMAGE_PATTERN_PLACEMENT=WECHAT_OFFICIAL_ACCOUNTS
PATTERN_SELECTOR_MIN_MODEL_SCORE=0.8
AI_MATERIAL_REVIEW_MODEL=
AI_COVER_COPY_REQUIRED=0
AI_COVER_COPY_MAX_TOKENS=512
AI_COVER_COPY_TITLE_MAX_LEN=30

# 创建账户范围来自飞书每账户最新配置 + MySQL 白名单；不要在生产 env 固定单账户。
WHITELIST_ENABLED=true
WHITELIST_ACCOUNTS=
EXECUTION_ENABLED=false
TARGET_CREATIVES_PER_AD=8
CREATION_APPROVAL_REQUIRED=true
CREATION_APPROVAL_TIMEOUT_MINUTES=120
CREATIVE_PREPARE_MAX_WORKERS=1
CREATIVE_PREPARE_TASK_BUFFER=1
MAX_SAME_LANDING_PER_AD_IN_RUN=1
CREATION_RECOVERY_LOOKBACK_HOURS=24
CREATIVE_MATERIAL_DEDUPE_LOOKBACK_DAYS=7
CREATIVE_LANDING_DEDUPE_LOOKBACK_DAYS=7
LANDING_EXCLUDED_CATEGORIES=早中晚好,祝福音乐,历史名人
VIDEO_RISK_MAX_ALLOWED_LEVEL=5
VIDEO_RISK_API_TIMEOUT_SECONDS=20
RECALL_PARALLEL_MAX_WORKERS=4
RECALL_QUERY_LIMIT_PER_VIDEO=4
PIAOQUANTV_VIDEO_SOURCE=prior
PIAOQUANTV_HOT_FALLBACK_SOURCE=hot
PIAOQUANTV_VIDEO_TYPE=1
PIAOQUANTV_VIDEO_MAX_PAGES=3
VIDEO_RECALL_CROWD_PACKAGE_MAP={}
VIDEO_RECALL_SOURCE_MAP={}
EXTERNAL_RECALL_SOURCE_LABEL=外部合作
EXTERNAL_RECALL_CANDIDATE_LIMIT=300
EXTERNAL_RECALL_EDIT_LIMIT_PER_LANDING=3
EXTERNAL_RECALL_UV_WINDOW_DAYS=90

# ad-daily-service：创建 10:30、审核每 2 小时、拒审清理默认 11:00。所有开关默认关闭。
DAILY_CREATION_ENABLED=0
DAILY_CREATION_HOUR=10
DAILY_CREATION_MINUTE=30
DAILY_CREATION_MISFIRE_GRACE_SECONDS=3600
DAILY_CREATION_LOCK_NAME=ad_daily_creation
DAILY_REVIEW_ENABLED=0
DAILY_REVIEW_INTERVAL_HOURS=2
DAILY_REVIEW_LOCK_NAME=ad_creative_review_scan
CREATIVE_REVIEW_LOOKBACK_HOURS=72
CREATIVE_REVIEW_SCAN_LIMIT=1000
CREATIVE_REVIEW_BATCH_SIZE=100

DAILY_REJECTED_CREATIVE_CLEANUP_ENABLED=0
DAILY_REJECTED_CREATIVE_APPLY_ENABLED=0
# 同一清理任务内先执行审核异常，再执行长期未起量；已删除或审核已命中的创意不会重复判断。
# 未起量范围取 ad_put_tencent_creative_day 最新 is_delete=0 创意；新素材累计指标含今日，
# 老素材另查当日消耗；当日有消耗时不删除。
# 账户名称及内部 Excel 代理商昵称取 ad_put_tencent_account 最新 is_delete=0 记录。
# 未起量结果只单独通知 FEISHU_AD_PROJECT_CHAT_ID，绝不发代理群。
DAILY_UNDERPERFORMING_CREATIVE_CLEANUP_ENABLED=0
DAILY_UNDERPERFORMING_CREATIVE_APPLY_ENABLED=0
DAILY_UNDERPERFORMING_CREATIVE_NEW_MIN_AGE_DAYS=5
DAILY_UNDERPERFORMING_CREATIVE_NEW_MAX_AGE_DAYS=7
DAILY_UNDERPERFORMING_CREATIVE_NEW_IMPRESSIONS_THRESHOLD=100
DAILY_UNDERPERFORMING_CREATIVE_OLD_DAILY_IMPRESSIONS_THRESHOLD=100
DAILY_UNDERPERFORMING_CREATIVE_WINDOW_DAYS=7
# 全部创意判断结束后，再判断创建>5天、近3个完整日及当日消耗都为0的广告。
# 广告扫描要求 DAILY_UNDERPERFORMING_CREATIVE_CLEANUP_ENABLED=1。
DAILY_UNDERPERFORMING_AD_CLEANUP_ENABLED=0
DAILY_UNDERPERFORMING_AD_APPLY_ENABLED=0
DAILY_UNDERPERFORMING_AD_WINDOW_DAYS=3
DAILY_UNDERPERFORMING_AD_MIN_AGE_DAYS=5
# 大批量候选复用事务连接并按批次并发落库；小批量保留原逐条路径。
DAILY_CLEANUP_CANDIDATE_BATCH_MIN_SIZE=20
DAILY_CLEANUP_CANDIDATE_BATCH_SIZE=100
DAILY_CLEANUP_CANDIDATE_STORE_WORKERS=4
TENCENT_AD_AD_PROCESS_WORKERS=8
DAILY_PARTIAL_CREATIVE_COST_THRESHOLD_YUAN=50
DAILY_PARTIAL_CREATIVE_PROTECTION_DAYS=3
DAILY_WECHAT_MINI_PROGRAM_CREATIVE_COST_THRESHOLD_YUAN=100
DAILY_REJECTED_CREATIVE_CLEANUP_HOUR=11
DAILY_REJECTED_CREATIVE_CLEANUP_MINUTE=0
DAILY_REJECTED_CREATIVE_LOCK_NAME=ad_rejected_creative_cleanup
DAILY_REJECTED_CREATIVE_MISFIRE_GRACE_SECONDS=3600
DAILY_REJECTED_CREATIVE_RUN_ON_STARTUP=0

DAILY_RUN_ON_STARTUP=0
DAILY_REVIEW_RUN_ON_STARTUP=0
DAILY_SYNC_DELIVERY_TEMPLATE=0

# 日级 ROI：生产09:00开始检查，未就绪时每30分钟重试，18:00最后检查后截止。
DAILY_ROI_ENABLED=0
DAILY_ROI_HOUR=9
DAILY_ROI_MINUTE=0
DAILY_ROI_POLL_INTERVAL_MINUTES=30
DAILY_ROI_POLL_CUTOFF_HOUR=18
DAILY_ROI_POLL_CUTOFF_MINUTE=0
DAILY_ROI_RUN_ON_STARTUP=0
DAILY_ROI_MISFIRE_GRACE_SECONDS=3600
DAILY_ROI_LOCK_NAME=ad_daily_roi
ROI_APPLY_ENABLED=0
ROI_SHEET_APPROVAL_ENABLED=0
ROI_SHEET_APPROVAL_POLL_SECONDS=60
ROI_APPROVAL_TTL_MINUTES=120
ROI_FISSION_PARAMETER_VERSION=20260712_A0-A15_v2
ROI_SCALE_RATIO=1.10
ROI_SCALE_COOLDOWN_DAYS=3
ROI_MAX_BASE_RATIO=2.00
ROI_SELF_STOP_MIN_AGE=4
ROI_SELF_STOP_COST_SOFT_LOWER_RATIO=0.045
ROI_SELF_STOP_COST_TARGET_RATIO=0.05
ROI_SELF_STOP_COST_SOFT_UPPER_RATIO=0.055
ROI_SELF_STOP_COST_HARD_CAP_RATIO=0.06
ROI_SELF_STOP_THREE_DAY_SHARE=0.60
ROI_SELF_STOP_ONE_DAY_SHARE=0.40
ROI_PARTNER_STOP_QUANTILE=0.20
ROI_UP_QUANTILE=0.80
ROI_OBSERVE_MIN_LATEST_UV=200
ROI_ONE_DAY_MIN_UV=200
ROI_ONE_DAY_HARD_STOP_ROI=0.20
ROI_ONE_DAY_STOP_QUANTILE=0.10
ROI_SELF_MIN_AVG_UV=200
ROI_PARTNER_MIN_AVG_UV=200
ROI_SELF_UP_MIN_AGE=3
ROI_STOP_QUANTILE=0.20
ROI_STOP_WEIGHT_CAP_QUANTILE=0.95
ROI_FEISHU_CHAT_ID=
ROI_FAILURE_FEISHU_CHAT_ID=
# 清理任务阻断失败和删除失败独立通知使用同一位置；为空时按失败告警默认路由回退。
CREATIVE_CLEANUP_FAILURE_FEISHU_CHAT_ID=
# 逗号分隔、精确匹配；默认“小程序-自动化”只通知内部群。
CREATIVE_CLEANUP_INTERNAL_ONLY_AGENCIES=小程序-自动化
ROI_AGENCY_WEBHOOK_ENABLED=0
ROI_AGENCY_WEBHOOKS_JSON={}

# 独立 ROI 内部测试，默认关闭。
ROI_INTERNAL_TEST_ENABLED=0
ROI_INTERNAL_TEST_HOUR=15
ROI_INTERNAL_TEST_MINUTE=30
ROI_INTERNAL_TEST_DEDUP_ENABLED=1
DAILY_ROI_INTERNAL_TEST_LOCK_NAME=ad_daily_roi
ROI_INTERNAL_TEST_MISFIRE_GRACE_SECONDS=3600

# ad-control-service：实时 CPM 与飞书命令。腾讯写操作默认关闭。
RTC_START_HOUR=12
RTC_STOP_HOUR=21
RTC_POLL_SECONDS=600
RTC_INVENTORY_REFRESH_MINUTES=60
RTC_HIGH_CPM=250
RTC_LOW_CPM=190
RTC_BID_UP_RATIO=1.05
RTC_MAX_PARTITION_LAG_HOURS=2
RTC_DB_LOCK_NAME=tencent_realtime_control
RTC_VERIFY_ATTEMPTS=3
RTC_VERIFY_DELAY_SECONDS=1
RTC_FEISHU_NOTIFY_ENABLED=1
RTC_FEISHU_CHAT_ID=
RTC_FEISHU_TIMEOUT_SECONDS=30
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_DRAFT_TTL_MINUTES=5
RTC_COMMAND_WORKERS=2
RTC_ACCOUNT_STATUS_QUERY_WORKERS=8
RTC_COMMAND_NEXT_DELIVERY_HOUR=6
RTC_NL_COMMAND_ENABLED=0
RTC_COMMAND_LLM_MODEL=google/gemini-3-flash-preview
RTC_COMMAND_LLM_TIMEOUT_SECONDS=20
RTC_COMMAND_LLM_CONFIDENCE_THRESHOLD=0.85

# 可选网络代理与 SLS 日志；为空时关闭。
HTTP_PROXY=
HTTPS_PROXY=
SLS_ENDPOINT=
SLS_PROJECT=
SLS_LOGSTORE=
SLS_ACCESS_KEY_ID=
SLS_ACCESS_KEY_SECRET=