客户端安装与使用指引

💡 更省事的方式：在 WorkBuddy 里以本技能目录为工作区间新建任务，让它学习全部文档、提炼出采集技能后，直接说「我要采集 尾号」即可全自动引导部署 + 登录 + 采集 + 每日核对。详见下方「⭐ WorkBuddy 智能安装」。

⭐ WorkBuddy 智能安装（推荐 · 单一下载即用）

下载技能包后，让 WorkBuddy 直接学习文档并提炼技能，全程自动引导部署 + 登录 + 采集 + 每日核对，无需手动复制到技能目录。技能包已内置完整采集端脚本与一键部署工具。

1. 下载技能包：下载 temu-collector-guide.zip
2. 解压到任意目录（如 D: emu-collector-guide 或 ~/temu-collector-guide）。
3. 在 WorkBuddy 中新建一个任务，并把该解压目录设为工作区间（workspace）。
4. 让 WorkBuddy 学习目录内全部文档（SKILL.md / README.md 等），它会自动提炼出「Temu 采集引导」技能。
5. 然后直接对它说「我要采集 6194」，即可全自动引导。

运行环境：本机需 Python 3.10+ 与 Google Chrome。技能运行时会自动建虚拟环境并装好全部依赖，无需手动 pip；Chrome 仅需本机已安装（走 CDP 遥控，无需 playwright 下载浏览器）。详见包内 README.md。

下载下面的通用安装包（内含一份 config.yaml 模板）。解压后直接用里面的 config.yaml，把 owner.name 改成你的名字即可（无需选手机号或账号）。登录 Temu 后，采集器会自动枚举该账号下的所有店铺并逐一采集，中央看板按「账号」维度统计。

下载通用安装包（collector-agent.zip）

1. 安装 Python 3.10+：到 python.org 下载，安装时勾选 “Add Python to PATH”。
2. 安装 Google Chrome 浏览器（系统已装可跳过）。
3. 最省事（推荐）：在解压出的 collector-agent 文件夹里，双击 install.bat 即可一键装好全部依赖（会弹出一个黑窗口，装完自动关闭，约几分钟，请耐心等）。
4. 或手动装：打开「终端 / 命令提示符」，进入解压后的文件夹：

   cd collector-agent
   pip install -r requirements.txt

   注意：采集用的是本机已装的 Google Chrome 走 CDP 遥控，无需执行 playwright install chromium（那会额外下载一个 ~150MB 的浏览器，用不上）。

1. 用记事本（或 VS Code）打开 config.yaml，把 owner.name 改成你的名字（其余已配好，勿动）。配置文件已带 UTF-8 编码标记，记事本可正常显示中文。
2. 最省事（推荐）：在 collector-agent 文件夹里双击 run.bat 直接启动（使用默认 config.yaml）。
3. 或手动启动：

   python agent.py

   常驻运行即可，本机访问 http://127.0.0.1:5003 看本机面板。

1. 打开本机面板 http://127.0.0.1:5003，点「打开浏览器登录」。
2. 在弹出的真实 Chrome 里用账号密码登录 Temu（密码见「账号密码.xlsx」）。
3. 登录态会存在本机，之后无需每次登录；保持浏览器开着即可。

1. 每天 06:30 客户端自动采集并上报中央看板，无需人工干预。
2. 如需补采：面板点「开始采集」即可。
3. 把 agent.py 设成开机自启，保持一直运行。

👉 查看谁没采集：打开中央看板