部署到服务器指南（目标：https://sp.jjbbcc.com/juliang/sucai/）
============================================================

说明：工具侧（WorkBuddy 这边）无法直连你的服务器 sp.jjbbcc.com 去推送文件，需要你或运维
用 SFTP/FTP 把下面清单传上去。工具全部用相对路径，放在子目录 /juliang/sucai/ 下能正常
运行，无需改任何代码。

一、要上传的文件（整个项目目录）
--------------------------------------------------
必传：
  index.php            主程序（巨量本地推版，已实测）
  config.php           配置（含 access_token + 登录密码）
  账户简称.xlsx         账户清单（15 个本地推广告主）
                        ★ 别传 "~$账户简称.xlsx"（那是 Excel 打开时的临时锁文件，乱码且无用）
  accounts.csv         兜底账户表（xlsx 拿不到时启用，建议一起传）
  data/                目录，内含：
      .htaccess        禁止外网直读（已按 Apache 2.4 配好）
      index.html       占位
可选（参考资料，不传也能跑）：
  素材优化操作SOP.txt、巨量引擎适配清单.txt、部署说明-巨量引擎.txt

二、上传步骤
--------------------------------------------------
1) 在服务器网站根目录建子目录 /juliang/sucai/（即网址 /juliang/sucai/ 对应的物理路径，
   例如网站根若是 /wwwroot，则建 /wwwroot/juliang/sucai/）。
2) 用 SFTP（推荐 FileZilla / WinSCP）或 FTP 把清单原样传进去，保持目录结构：
     /juliang/sucai/index.php
     /juliang/sucai/config.php
     /juliang/sucai/账户简称.xlsx
     /juliang/sucai/accounts.csv
     /juliang/sucai/data/.htaccess
     /juliang/sucai/data/index.html
3) 设目录权限：data/ 设为 755（部分虚拟主机需 777，但 755 优先）。
   命令示例：chmod -R 755 /wwwroot/juliang/sucai/data

三、服务器环境要求
--------------------------------------------------
- PHP 7.4 以上（建议 8.x，已实测 8.3.36 通过）
- curl 扩展必须开启（接口走 curl；无 curl 不自动兜底）
- 若扫描超时：php.ini 里 max_execution_time 调到 120 以上；部分主机禁用 set_time_limit，
  只需调大 max_execution_time 即可
- session 目录可写（一般默认即可；若报错可在 php.ini 设 session.save_path 到一个可写目录）

四、保护 data 目录（关键安全项）
--------------------------------------------------
工具把扫描缓存(scan_*.json)和操作记录(operation_log.csv)写在 data/，含账户信息，
必须禁止外网直接访问。
- 服务器是 Apache：data/.htaccess 已写好 `Require all denied`（Apache 2.4 语法）。
  若是老版 Apache 2.2，请把该文件内容改为：
      Order allow,deny
      Deny from all
- 服务器是 Nginx：Apache 的 .htaccess 不生效，需在站点配置加一段后 reload：
      location ^~ /juliang/sucai/data/ { deny all; }
★ 上线后务必验证：浏览器直接打开
   https://sp.jjbbcc.com/juliang/sucai/data/scan_1864972662313024.json
   应提示 403 / 404，绝不能看到 JSON 内容。

五、上线前必做 2 件事
--------------------------------------------------
1) 改登录密码：打开 config.php，把
      'password' => 'beicheng2026'
   改成你自己的密码。
2) 确认 access_token 有效：config.php 里的 access_token 会过期；过期后扫描/诊断会报接口错。
   先访问 https://sp.jjbbcc.com/juliang/sucai/?act=diag 看 token_ok 是否为 true，不是就重填。

六、访问与首次使用
--------------------------------------------------
浏览器打开：https://sp.jjbbcc.com/juliang/sucai/
→ 输密码 → 点账户按钮（如「利是本地推A深」）逐个扫描 → 出素材表
→ 按 SOP 判定做标记 → 后台人工暂停/删除后回工具「登记」。
（也可点「扫描全部账户」一次拉全 15 个，可能耗时较久。）

七、安全提醒
--------------------------------------------------
- config.php 内含 access_token，切勿提交到公开代码仓库；确保服务器 PHP 正常解析 .php
  （否则源码会被当文本下载、泄露 token）。注意：直接访问 config.php 时 PHP 会执行 return、
  不出任何内容，只要 PHP 在工作就不会泄露 token。
- 这是你们自有服务器，业务数据只在你们服务器与巨量 API 之间流转，未上传任何第三方云。

八、常见问题
--------------------------------------------------
Q: 打开空白 / 500 → PHP 版本太低，升到 8.0+；或 .htaccess 语法与 Apache 版本不符（见四）。
Q: 扫描很久没数据 → max_execution_time 太短，调到 120+。
Q: 诊断 token_ok=false → access_token 过期或填错，重填 config.php。
Q: data 目录能被下载 → 见四，按 Apache/Nginx 补保护并验证。
Q: 导出 CSV 中文乱码 → 已带 UTF-8 BOM，用 Excel 打开正常；页面乱码查服务器默认编码(UTF-8)。
