﻿僵尸创意清理 · 上传部署说明
================================

一、上传
  把本目录里的这 4 项，原样上传到服务器 /tengxu/zanting/ 下面：
      index.php
      config.php
      accounts.csv   ← 兜底用，可传可不传
      data/          ← 整个目录一起传（里面有 .htaccess，隐藏文件别漏）

  上传后目录结构应该是：
      /tengxu/zanting/index.php
      /tengxu/zanting/config.php
      /tengxu/zanting/accounts.csv
      /tengxu/zanting/data/.htaccess
      /tengxu/zanting/data/index.html

二、打开
  浏览器访问：  https://sp.jjbbcc.com/tengxu/zanting/
  输入密码进入（密码在 config.php 里的 password，默认 beicheng2026）。
  第一次进去点一下「重新扫描」，等 10–30 秒出清单。

三、环境要求
  1) PHP 7.4 以上，建议 8.x（宝塔面板 → 网站 → 设置 → PHP版本 里切）
  2) 要有 curl 扩展（一般默认都有；没有会自动退回 file_get_contents）
  3) data 目录必须可写：权限 755，不行就 777
     （不可写时程序会自动改用系统临时目录，页面顶部会提示）

四、环境自检
  打开 https://sp.jjbbcc.com/tengxu/zanting/index.php?action=diag
  会列出 PHP 版本 / curl / 目录可写 / 接口连通 等，一项一项打勾。
  页面报错时先看这里。

五、页面上有什么
  · 只列「建满 7 天以上、近 7 天消耗 < 100 元、0 转化」的活创意
  · 所在单元已暂停/已删除的创意自动隐藏（整单元都不跑了，不用逐条处理）
  · 创意本身已暂停、已删除的也自动隐藏
  · 组件化创意接口改不了，单独一块列出来，去投放端处理
  · 两层扫描条件：「近 N 天转化 ≤ X」（近期不出单）+「曾出单回看 M 天」
    （默认 30，页面上都能改）；近 M 天出过单但近 N 天 0 转化的创意，
    单独列「需要处理」板块并置顶通知，给出逐条建议动作（复制翻新/提价试探），
    自动排除在暂停清单外——这类要复制翻新重启，不是暂停
  · 勾选 → 暂停选中创意，逐条串行提交，结果写进 data/pause-时间.json
  · 页面底部「操作记录」可一键还原那次暂停

六、账户清单（和盯盘助手共用同一张表）
  优先级：① 服务器上同站的 腾讯账户简称.xlsx（自动找 ../config/，
             即 https://sp.jjbbcc.com/tengxu/config/腾讯账户简称.xlsx 同一文件）
          ② 在线下载：accounts_url 指向的这张表（中文文件名自动编码）
          ③ 都拿不到时兜底用同目录 accounts.csv
  · 改表后最迟 5 分钟生效；点「重新扫描」立即重新拉取
  · 下载失败会自动用上一次缓存的账户清单顶着，页面顶部会提示
  · 表头：账户名称 | 账户ID | 简称（列序随意，多余列忽略，跟盯盘助手同一张表）
  · 页面顶部会显示当前账户表来源，环境自检页（?action=diag）里也有

七、改配置
  用记事本打开 config.php：
      password    登录密码，建议换成自己的
      api_key     腾讯广告 API Key（mkt_ 开头）
      accounts_local  本地账户表候选路径（相对本文件）
      accounts_url    账户表在线地址（默认 sp.jjbbcc.com 那张）
      accounts_ttl    账户表下载缓存秒数，默认 300
      data_dir    缓存目录，默认同目录 data；也可指向网站目录外
      days / max_cost / max_conv / days30   默认筛选条件（页面上也能改）
      max_batch   单次最多提交多少条，默认 200
      probe       扫描时是否探测各账户能否改创意，默认 true

八、常见问题
  Q: 打开是一片空白 / 500
  A: PHP 版本太低（低于 7.4）。到面板把站点 PHP 切到 8.0 以上。

  Q: 点扫描后转圈很久，然后没数据
  A: 主机 max_execution_time 太短（30 秒）。到 PHP 设置里调到 120 秒以上。

  Q: 提示「会话已过期」
  A: session 目录不可写，已自动兜底到 data/sess；若仍报，刷新页面重试。

  Q: 某个账户整批失败（错误码 1800368）
  A: 该账户的创意接口没开放写权限，只能去腾讯广告投放端手动暂停。
     页面已经把它单独分到「接口不支持暂停」区块。

  Q: data 目录会不会被外人下载
  A: Apache 靠 data/.htaccess 拦住了；Nginx 请在面板里加一条规则：
     location ^~ /tengxu/zanting/data/ { deny all; }
