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

一、上传
  把本目录里的这 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 转化」的活创意
  · 所在单元已暂停/已删除的创意自动隐藏（整单元都不跑了，不用逐条处理）
  · 创意本身已暂停、已删除的也自动隐藏
  · 组件化创意接口改不了，单独一块列出来，去投放端处理
  · 勾选 → 暂停选中创意，逐条串行提交，结果写进 data/pause-时间.json
  · 页面底部「操作记录」可一键还原那次暂停

六、改配置
  用记事本打开 config.php：
      password    登录密码，建议换成自己的
      api_key     腾讯广告 API Key（mkt_ 开头）
      data_dir    缓存目录，默认同目录 data；也可指向网站目录外
      days / max_cost / max_conv   默认筛选条件（页面上也能改）
      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; }
