═══════════════════════════════════════════════════════════════
   复购信号雷达  ·  Windows 启动指南（写给非技术店主）
═══════════════════════════════════════════════════════════════

这个工具帮你做这一件事：
    把「评论里说『又回购了』『老客户』的人」从几千条评论里
    几秒钟挖出来，告诉你今天该先联系谁、用什么话。

不需要懂代码。下面 4 步走完就能用。

───────────────────────────────────────────────────────────────
 第 1 步：装 Python（如果还没装）
───────────────────────────────────────────────────────────────

   1. 打开浏览器，访问：
      https://www.python.org/downloads/

   2. 点最大的黄色按钮 "Download Python 3.x.x"

   3. 双击下载好的安装包
      ⚠️ 第一个勾选框：☑ Add Python to PATH   ← 一定要勾！
      ⚠️ 然后再点 "Install Now"

   4. 等 2-3 分钟装完，关闭安装窗口

如果你电脑上已经有 Python（3.10 或以上版本都行），跳过这步。

───────────────────────────────────────────────────────────────
 第 2 步：准备两份 CSV
───────────────────────────────────────────────────────────────

   A. 评论 CSV：
      登录你的商家后台 → 评价管理 → 筛选「最近 90 天」
      → 导出 CSV（UTF-8 编码）

      ⚠️ 表格里的字段名要叫：
         rating（1-5星） / content（评价内容） / date（日期） / user_id（买家编号）

   B. 订单 CSV：
      商家后台 → 订单管理 → 导出 CSV（UTF-8）

      ⚠️ 字段名要叫：
         order_id / user_id / amount（金额）/ order_date（下单日期）

   ⚠️ **重要**：把买家手机号、地址、姓名**全部删掉**，
   只保留平台给你的脱敏 user_id（一串字母数字）。

───────────────────────────────────────────────────────────────
 第 3 步：启动工具
───────────────────────────────────────────────────────────────

   在本工具文件夹里，双击这个文件：

   start-windows.bat    ← 双击它！

   - 第一次会弹黑窗，自动装一些依赖（1-2 分钟，别关）
   - 装完后会自动打开浏览器到 http://127.0.0.1:5057
   - 如果浏览器没自动开，手动复制这个地址到浏览器

───────────────────────────────────────────────────────────────
 第 4 步：用
───────────────────────────────────────────────────────────────

   在浏览器里：
   1. 勾上「使用示例评论」和「使用示例订单」试试看
   2. 点绿色按钮「开始分析」
   3. 3 秒钟后跳到结果页
   4. 下载 4 个文件：
      · repurchase_signals.csv     ← Top 20 该联系的人
      · at_risk_silent.csv         ← 沉默 30+ 天的高价值老客
      · recruit_action_pack.md     ← 7 天召回话术（直接复制用）
      · dashboard.html             ← 可视化报告（可发老板/客服）

   之后每次分析，浏览器关闭后想再开，**再双击一次 start-windows.bat** 即可。

───────────────────────────────────────────────────────────────
 常见问题
───────────────────────────────────────────────────────────────

 Q：弹窗说「未检测到 Python」？
 A：说明 Python 没装，或装的时候没勾 "Add Python to PATH"。
    卸载 Python 重装一次，并**确认第一个勾选框要勾上**。

 Q：浏览器没自动打开？
 A：手动复制 http://127.0.0.1:5057 到浏览器地址栏，回车。

 Q：弹窗说「文件编码不是 UTF-8」？
 A：CSV 编码错了。用 Excel 打开 → 「另存为 CSV UTF-8 逗号分隔」再上传。

 Q：弹窗说「user_id 疑似手机号」？
 A：你上传的 CSV 里 user_id 是手机号，把它替换成平台脱敏 ID（一串字母数字）。
    Excel 里可以用 =RIGHT(A1,10) 取后 10 位。

 Q：跑完后在哪里找文件？
 A：点击结果页的「下载」按钮。或者直接去项目目录的 tmp_uploads/ 文件夹。

 Q：端口 5057 被占了？
 A：跑工具时换端口：打开命令提示符输入
      set FLASK_RUN_PORT=5060
    再双击 start-windows.bat

───────────────────────────────────────────────────────────────
 不会改你店铺里的任何东西
───────────────────────────────────────────────────────────────

   这个工具**只在你电脑上跑**，不会自动发短信 / 企微 / 改店铺。
   你下载的 CSV / 话术由你和客服手动执行。

   如果你哪天不想用了，直接删掉整个文件夹就行。

───────────────────────────────────────────────────────────────
 祝召回顺利  ❤️
═══════════════════════════════════════════════════════════════
