巨量本地推盯盘系统 - 维护说明 ======================================== 一、系统组成 ---------------------------------------- 本系统分两部分: 1. 整点自动推送(每小时自动跑一次,推送到企业微信群) 2. 实时查询(两个入口): (a) 群里@机器人发"数据" → wechat_callback.php 调 exe → 发文字+图片到群里 (b) 私聊"巨量钉盘助手"应用发"数据" → wechat_bot.py 后台查数据 → 发预警文字+表格图片到企业群,私聊回一句"正在查询"提示 3. 预算查询/修改指令(私聊"巨量钉盘助手"应用,和上面(b)同一个入口): - 发「账户简称 预算」→ 查询该账户当前预算(只读,例:追觅F 预算) - 发「账户简称 金额」→ 发起修改日预算,机器人二次确认后回复「确认」才真正执行(例:追觅F 2000) - 发「账户简称 无限」→ 改为不限预算(同样需二次确认,例:追觅F 无限) - 金额后加「次日」则次日生效(例:追觅F 2000 次日) - 注意:改预算是真实动账户金额的操作,必须先经二次确认;单账户24小时内修改≤20次 二、文件清单(本地项目目录:D:\WorkBuddy\巨量引擎\巨量引擎账户数据监控与微信推送\) ---------------------------------------- 1. 账户简称.xlsx ★账户列表唯一数据源 - 3列:A=账户名称(全名)、B=账户ID(形如 ID:1873...)、C=简称(展示用短名) - 增删改账户只改这个表,改完重新打包exe并把这个 xlsx 一起上传 2. config.json - 推送配置文件 - 包含:企业微信群机器人webhook、巨量API token、预警阈值(intention_cost_threshold) - 账户列表已移到 账户简称.xlsx,这里不再放 accounts 3. monitor.py - 整点推送主程序(Python源码) - 功能:读 xlsx 账户 → 拉取巨量数据 → 生成预警文字 → 生成表格图片 → 推送到企业微信群 3.1 wechat_bot.py - 企业微信自建应用"巨量钉盘助手"回调服务(Python源码,需 flask + pycryptodome + requests + openpyxl,运行在公网可达的 5000 端口) - 功能:接收私聊"数据"等关键词 → 后台调用同目录 juliang_monitor.exe --query 查数据 → 把预警文字+表格图片发到企业微信群,私聊立即回一句"正在查询"提示(避免企业微信5秒回调超时) - 新增:接收预算指令(账户简称+金额/无限/预算)→ 查预算或发起改预算(二次确认后执行并回传结果) - 应用凭证(CORP_ID/SECRET等)在文件内;群webhook与巨量token从 config.json 读取 4. wechat_callback.php - 企业微信回调接口(部署在服务器上) - 功能:接收@机器人消息 → 调用exe拉数据 → 发文字+图片到群里 - 群webhook 已从 config.json 读取(与 exe / wechat_bot.py 共用单一来源) 5. juliang_monitor.exe - 打包好的exe程序(由 monitor.py 打包,部署在服务器上) - 两种运行模式: · 不带参数:整点推送模式,自动发消息到群里 · --query:查询模式,生成文字输出和query_table.png图片,不推送 三、服务器部署位置(39.108.208.79) ---------------------------------------- 目录:D:\txshiping\juliang\ 文件: - juliang_monitor.exe - 账户简称.xlsx ← 账户列表(必须和 exe 同目录,重打包后一起上传) ← 整点推送exe - wechat_callback.php ← 企业微信回调接口 - config.json ← 配置文件(和exe同目录,含 webhook/token/阈值) - query_table.png ← 整点推送/实时查询生成的临时图片(自动生成,exe 所在目录) - query_text.txt ← 整点推送/实时查询生成的预警文字(自动生成,便于手动验证;不影响推送) - debug.log ← 回调调试日志(php 侧) - monitor.lock ← 整点推送"同一小时只推一次"的防重复锁(自动生成,exe 所在目录) - .query_lock ← 群@机器人实时查询的10秒防重复锁(自动生成) Windows任务计划: - 名称:巨量本地推整点盯盘 - 频率:每整点执行一次 - 时间范围:8:00-22:00(脚本内置判断,其他时间自动退出) 四、常见维护操作 ======================================== 【1】增加/删除/修改账户 ---------------------------------------- 账户列表统一在 账户简称.xlsx 里维护(不再改 config.json / php / bot): 步骤: 1. 打开 账户简称.xlsx 2. 按列填写:A列=账户名称(全名),B列=账户ID(形如 ID:1873...),C列=简称(展示短名) - 新增一行即新增账户;删除整行即删除账户 3. 重新打包exe(见下面"重新打包exe")—— 因为 exe 在运行时读取这个 xlsx 4. 把新的 exe 和 账户简称.xlsx 一起上传到服务器覆盖 注意: - 账户ID是巨量后台的广告主ID,在巨量引擎后台"账户管理"里能看到 - wechat_callback.php 和 wechat_bot.py 都自动读这个 xlsx,无需再手工同步账户 【2】修改预警阈值 ---------------------------------------- 打开 config.json,修改: - "intention_cost_threshold": 300 ← 意向成本预警线(元) 其他两个阈值在 monitor.py 里: - 消耗>200无转化预警(搜索 "cost > 200") - 消耗>300无意向预警(搜索 "cost > 300") 改完后重新打包exe,上传覆盖。 【3】修改推送群(换企业微信群机器人) ---------------------------------------- 打开 config.json,修改 wechat_webhook 字段: - 新的webhook地址(在企业微信群里添加机器人,复制webhook地址) wechat_callback.php 里的群webhook 现在已从同目录 config.json 自动读取,无需再单独改 php。 改完后: - config.json 直接上传到服务器覆盖 - exe 不需要重新打包(webhook 在 config.json 里,php/exe/bot 共用) 【4】修改推送时间 ---------------------------------------- 整点推送时间由 Windows任务计划 控制: - 打开"任务计划程序" → 找到"巨量本地推整点盯盘" - 修改触发器,改成你想要的频率(比如每半小时一次) 脚本内置了8:00-22:00的时间判断,其他时间运行会自动退出。 如果要改这个时间范围,打开 monitor.py,搜索 "hour < 8" 或 "hour > 22",修改数字。 【5】重新打包exe ---------------------------------------- 每次修改 monitor.py 后,都要重新打包: 1. 打开PowerShell,进入项目目录: cd D:\WorkBuddy\巨量引擎\巨量引擎账户数据监控与微信推送 2. 打包环境准备(必须用 Python 3.11,与原版一致): - 安装依赖:pip install requests Pillow openpyxl pyinstaller - openpyxl 是新增依赖(账户改从 账户简称.xlsx 读取) 3. 执行打包命令: C:\Users\Administrator\AppData\Local\Programs\Python\Python311\python.exe -m PyInstaller juliang_monitor.spec --noconfirm (或直接:... -m PyInstaller --onefile --name "juliang_monitor" monitor.py --noconfirm) 4. 打包完成后,exe在 dist\juliang_monitor.exe 5. 把 exe 和 账户简称.xlsx 一起上传到服务器 D:\txshiping\juliang\ 覆盖 (exe 运行时读同目录的 账户简称.xlsx,缺了该文件会回退到 config.json 的 accounts) 【6】测试推送效果 ---------------------------------------- 本地测试(不需要服务器): cd D:\Doubao\巨量引擎\dist .\juliang_monitor.exe 会直接推送到群里,看看效果对不对。 实时查询测试: .\juliang_monitor.exe --query 会在当前目录生成 query_table.png,控制台输出预警文字。 五、关键参数说明 ======================================== 巨量引擎API Token: - 在 config.json 的 oceanengine_access_token 字段 - 有效期90天(当前 key 创建于 2026-10-30,过期时间 **2027-01-28**)。到期前在巨量开放平台 api-key 页面(https://open.oceanengine.com/api-key)点「查看 API Key」拿新 key,只改 config.json 的 oceanengine_access_token 一处、重传服务器覆盖即可(无需重打包 exe) - 改完后只需上传 config.json(monitor.py 的 exe 与 wechat_bot.py 都会自动读取,无需再改 php) 企业微信配置: - wechat_callback.php / wechat_bot.py 顶部:CORP_ID、AGENT_ID、SECRET、TOKEN、ENCODING_AES_KEY(企业微信自建应用凭证,几乎不变,保留在文件内) - 巨量API Token 与 群webhook:统一在 config.json(oceanengine_access_token / wechat_webhook),monitor.py / wechat_bot.py / wechat_callback.php 都从它读,改一处即可 六、常见问题排查 ======================================== 【问题1】整点没推送 - 检查服务器上exe能不能手动运行(远程桌面进去双击试试) - 检查 Windows任务计划 是否正常运行 - 检查是不是在8:00-22:00之外的时间(脚本会自动退出) 【问题2】@机器人没反应 - 打开 debug.log 看看最新的日志 - 检查 wechat_callback.php 是不是最新版本 - 检查服务器上PHP能不能正常访问(浏览器打开 https://sp.jjbbcc.com/juliang/wechat_callback.php) 【问题3】预算显示不对/都显示预算不限 - 检查 fetch_budgets 函数,确认账户ID转成了整数数组传给API - 手动调用预算API测试: python -c "import requests,json; r=requests.get('https://api.oceanengine.com/open_api/v3.0/local/advertiser/budget/get/', params={'local_account_id':'[1864972662313024]'}, headers={'Access-Token':'你的token'}); print(r.json())" 【7】用巨量钉盘助手改/查预算(私聊指令) ---------------------------------------- 前提:服务器上 wechat_bot.py 正在运行(python wechat_bot.py,端口5000),且企业微信"巨量钉盘助手"应用的回调URL已指向服务器。 支持指令(账户名用监控里显示的简称,如 追觅F / 中代F / 利是A): - 查预算:发「追觅F 预算」→ 回复该账户当前日预算或"不限"(仅私聊,不推群) - 改日预算:发「追觅F 2000」或「中代F修改预算为1000」→ 机器人回"确认将【中代F】日预算改为¥1000(立即生效)?回复确认执行/取消" → 你回「确认」才真正改 - 改不限:发「追觅F 无限」→ 同样二次确认 - 次日生效:在金额后加「次日」,如「追觅F 2000 次日」 重要:预算指令要发到「巨量钉盘助手/巨量盯盘助手」这个自建应用的【私聊】,不要发到群里或发到企业微信自带的"智能机器人"(后者会回一张名片卡片,不是我们的机器人)。 - 收到「可自动将消息推送到聊天 / 创建日期 / 创建者」这种卡片 = 发错了对象(智能机器人),请改发到上述自建应用私聊。 预算修改结果同步到群: - 发起修改时,企业群会收到一条「📝 预算调整申请」通知(含账户/目标/等待确认) - 确认执行成功后,企业群收到「📢 预算已调整 ✅」含新预算 - 失败则群内收到「📢 预算调整失败 ❌」含错误原因 - 中途取消则群内收到「📝 预算调整已取消」 (私聊仍会收到同样的执行结果回执) 安全设计: - 改预算是真实动金额操作,必须二次确认;误发可回「取消」 - 单账户24小时内修改≤20次(巨量官方限制),批量请节制 - 查预算是只读 GET,随时可发,不会改动任何设置 底层接口(已在 wechat_bot.py 内实现,无需另装工具): - 改:POST https://api.oceanengine.com/open_api/v3.0/local/budget/update/ 【8】重启 wechat_bot.py(更新代码后必须做) ---------------------------------------- wechat_bot.py 是服务器上直跑的 Flask 进程(端口5000),不是 Windows 服务, 改完代码要"停旧进程 + 启新进程"才会生效。 方法A(推荐,一键): 1. 把部署包里的 重启_wechat_bot.bat 传到服务器 D:\txshiping\juliang\ 2. 服务器上双击它 → 自动结束5000端口旧进程 → 弹出新窗口重新运行 3. 新窗口出现「Running on http://0.0.0.0:5000」即成功 方法B(手动命令行): 1. 服务器打开 cmd,先停旧进程: netstat -ano | findstr :5000 (记下 LISTENING 那一行的 PID) taskkill /PID <上面查到的PID> /F 2. 重新启动: cd D:\txshiping\juliang python wechat_bot.py 3. 保持该黑窗口开着(直接点右上角 X 断开远程即可;不要"注销/登出",否则进程会随会话结束) 重要提醒:wechat_bot.py 只在"有窗口常驻"时才运行。 - 若希望服务器重启/注销后也能自动拉起,请用 Windows 任务计划程序建一个 "不管用户是否登录都要运行"的任务来启动它(需要我可另给配置步骤)。 - 验证重启成功:私聊「巨量钉盘助手」发「追觅F 预算」,能回当前预算即正常。 - 查:GET https://api.oceanengine.com/open_api/v3.0/local/advertiser/budget/get/ (注:原 D:\WorkBuddy\巨量引擎\ 下的 ocean_budget_tool.py 等独立脚本仍可单独用于批量改预算,但日常在微信里改用本指令即可) 【问题4】重复推送多条(整点推送发了两遍) - 整点推送由 Windows任务计划触发,防重复靠 exe 内的 monitor.lock(同小时只推一次)。 - 旧版 exe 用的 msvcrt.LK_NB 文件锁在 Python 3.13 已被移除,导致锁失效、出现"同一小时推两遍"。 2026-11-01 已改为 os.open(O_EXCL) 原子锁,已验证:同小时第2次运行会被直接跳过。 - 若仍重复,先确认任务计划触发器没有设"重复任务间隔"(如每5分钟),monitor.lock 同一小时会拦掉重复; 若想彻底只跑一次,把触发器设为"每天 8:00 起,每隔1小时,持续14小时"且不要勾选重复间隔。 - 注意区分:群@机器人"数据"走 php 的 .query_lock(10秒锁),与整点推送的 monitor.lock 是两回事。 【问题5】图片生成失败 - 检查服务器上有没有微软雅黑字体(C:/Windows/Fonts/msyh.ttc) - 一般Windows服务器都自带,不用管 【问题6】整点推送时弹出黑色/蓝色命令行窗口 - 现象:任务计划整点跑 exe 时,桌面上弹出黑框(里面可能还有 "Lock check error" 之类文字)。 - 原因旧版:exe 是控制台程序,任务计划运行必弹窗;且旧锁报错会打印到这个窗口。 - 已修复:2026-11-01 起重打包的 exe 已改为"无控制台(窗口化)",整点推送不再弹任何窗口; 同时修好了锁,不再打印 Lock check error。 - 如果你上传的是 2026-11-01 之前的旧 exe,请重新上传最新 dist\\juliang_monitor.exe 覆盖即可消除黑框。 - 手动在 cmd 里跑 exe --query 想看输出:因为无控制台窗口,屏幕不显示,请直接看生成的 query_text.txt(预警文字)和 query_table.png(表格图)。 七、指标说明 ======================================== - stat_cost:消耗(元) - attribution_convert_cnt:转化数 - attribution_convert_cost:转化成本(元) - attribution_message_action_cnt:私信咨询数 - attribution_clue_confirm:确认意向数 - attribution_clue_confirm_cost:确认意向成本(元) 预警规则: 1. 意向成本 > 300元 → 红色预警 2. 消耗 > 200元 且 转化=0 → 橙色预警 3. 消耗 > 300元 且 意向=0 → 橙色预警 4. 意向成本 < 300元 → 绿色提示(效果好,可加预算) 5. 预算-消耗 < 1000元 → 黄色提示(预算快花完了)