# 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=9 DAILY_ROI_MINUTE=0 DAILY_ROI_RUN_ON_STARTUP=0 # 每天14:30运行独立内部测试,只将“自动化投放”分表发送到“内部”Webhook,不进入腾讯审批执行。 ROI_INTERNAL_TEST_ENABLED=0 ROI_INTERNAL_TEST_HOUR=14 ROI_INTERNAL_TEST_MINUTE=30 # 生产默认去重;测试环境显式设0时每次触发使用独立测试批次。 ROI_INTERNAL_TEST_DEDUP_ENABLED=1 ROI_APPLY_ENABLED=0 ROI_SHEET_APPROVAL_ENABLED=0 ROI_SHEET_APPROVAL_POLL_SECONDS=60 ROI_APPROVAL_TTL_MINUTES=120 # 合格小程序创意三日ROI前20%且广告age>=3时生成扩量建议。 ROI_SCALE_RATIO=1.10 ROI_SCALE_COOLDOWN_DAYS=3 ROI_MAX_BASE_RATIO=2.00 # 连续三天合格的小程序创意+公众号实体等权整体P20。 ROI_SELF_STOP_MIN_AGE=4 ROI_STOP_QUANTILE=0.20 ROI_UP_QUANTILE=0.80 ROI_OBSERVE_MIN_LATEST_UV=200 # 非三日正式样本的小程序创意单日补充:UV>200且ROI<=0.20,或UV>500且ROI<=P30;关停仍要求广告age>3天。 ROI_ONE_DAY_MIN_UV=200 ROI_ONE_DAY_P30_MIN_UV=500 ROI_ONE_DAY_HARD_STOP_ROI=0.20 ROI_ONE_DAY_STOP_QUANTILE=0.30 ROI_FISSION_PARAMETER_VERSION=20260712_A0-A15_v2 # ROI报表发送到此群;同时抄送 FEISHU_OPERATOR_CHAT_ID,重复ID自动去重。 # 审批表链接为获得链接者可编辑,黄色审批列选择“批准”即自动执行。 # 为空时依次复用 FEISHU_AD_PROJECT_CHAT_ID / RTC_COMMAND_CHAT_ID ROI_FEISHU_CHAT_ID= # 日级ROI定时任务失败告警群;为空时回退FEISHU_OPERATOR_CHAT_ID。 ROI_FAILURE_FEISHU_CHAT_ID= # 代理表由飞书应用上传后,通过各代理自定义机器人发送在线表卡片。 # 默认关闭;JSON 的 key 使用代理简称(如“棱镜”),“内部”为内部测试专用路由。 ROI_AGENCY_WEBHOOK_ENABLED=0 ROI_AGENCY_WEBHOOKS_JSON={} 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 RTC_COMMAND_NEXT_DELIVERY_HOUR=6 RTC_COMMAND_DRAFT_TTL_MINUTES=5 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 OPEN_ROUTER_API_KEY= # ======================================== # 飞书 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 服务端口