EastmallBuy 本地采集端
版本号：2026.11.15.01
=======================

这是在新电脑上使用 EastmallBuy 的本地部署包。任务参数和浏览器采集在当前电脑执行，采集结果会按登录账号同步到服务器。

一、安装 Python
---------------
1. 打开 Python 官方 Windows 下载页：
   https://www.python.org/downloads/windows/
2. 下载 Python 3.10 或更高版本。建议使用 Python 3.11 或 3.12 的 Windows installer (64-bit)。
3. 启动安装程序后，在第一个界面务必勾选 “Add Python.exe to PATH”。
4. 点击 “Install Now” 完成安装。
5. 关闭并重新打开 PowerShell 或命令提示符，执行下面命令确认版本：

   python --version

   版本必须是 Python 3.10 或更高版本。即使安装时没有勾选 “Add Python.exe to PATH”，安装脚本也会自动检查 Python 官方安装器常见的目录（包括 Python315）和 Python Launcher；如果脚本仍提示找不到，请关闭当前命令窗口后重新双击运行安装脚本。

二、安装本地部署依赖
--------------------
1. 将本压缩包完整解压到有写入权限的目录，例如 D:\EastmallBuy\tk。
2. 双击运行 “安装本地采集器.bat”。脚本会在压缩包目录创建独立的 `.venv` 环境，并把 requirements-browser.txt 中的依赖安装到这个环境，不会污染系统 Python；如果电脑已有 Google Chrome 或 Microsoft Edge，会直接使用已安装的浏览器并跳过约 190 MB 的 Chromium 下载。没有系统浏览器时，脚本默认从国内镜像下载 Playwright Chromium，镜像失败才回退到官方 CDN。
3. 如果系统提示安全确认，请确认这是从 EastmallBuy 网站下载的部署包后继续。

三、启动并登录
--------------
1. 双击运行 “启动项目.bat”，保持窗口运行。
2. 在同一台电脑的浏览器打开：
   https://tk.reeast.shop
3. 进入“设置”，输入分配给你的 EastmallBuy 账号和密码并登录。
4. 登录成功后，点击“连接本机采集器”，不需要机器码、注册密钥或管理员密钥。
5. 进入“设置 → TikTok 采集账号”，点击“登录当前账号”。新电脑会打开本机可见浏览器；请在浏览器里完成扫码、密码和验证码登录。登录成功后窗口会自动关闭并保存会话，再在网页点击“检查登录状态”。
6. 只有检测到 TikTok 登录会话后，回到“发现任务”开始采集；如果没有保存登录态，采集任务会先停止并提示登录。

四、以后使用
------------
每次使用前先双击“启动项目.bat”，再打开网站并使用账号登录。登录和设备绑定状态保存在本机；删除本机应用数据或更换 Windows 用户后，需要重新登录。

更新部署包时
------------
如果这台电脑之前运行过旧版本地工作台，覆盖文件后必须替换旧进程，否则浏览器仍会连接旧的 8788 端口服务。请在本目录运行：

   重启项目.bat

也可以运行 `启动项目.bat -Restart`。重启脚本会先停止旧的本地工作台，再加载当前目录中的最新代码。

如果旧窗口已经关闭，也可以直接双击“启动项目.bat”。启动后在浏览器按 Ctrl+F5 强制刷新网站。

安装速度慢时
------------
如果安装窗口停在“Installing Chromium for Playwright”，通常是浏览器文件下载速度慢。可以按 Ctrl+C 停止当前下载，重新运行最新版“安装本地采集器.bat”；新版会优先使用已经安装的 Chrome/Edge，或者使用国内镜像。也可以在命令提示符中手动执行：

   set PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright
   python -m playwright install chromium --no-shell

如果 Chrome 或 Edge 已经安装，通常不需要执行上面的下载命令。`.venv` 目录保留后，后续重复运行安装脚本会复用已安装的依赖；若要彻底重装，可以关闭工作台后删除 `.venv`，再重新运行安装脚本。

五、常见问题
------------
* 网站提示本地采集器未连接：确认“启动项目.bat”仍在运行，并且网站和本地采集器在同一台电脑上。
* 网站提示登录失败：确认账号密码正确，或联系管理员创建/重置账号。
* python 不是内部或外部命令：重新安装 Python 3.10+，在安装程序第一个界面勾选 “Add Python.exe to PATH”，然后重新打开 PowerShell。
* 浏览器无法启动：重新运行“安装本地采集器.bat”，或确认安全软件没有拦截 Chromium。
* 任务失败或浏览器打开后马上关闭：进入“采集任务”查看阶段、错误码和下一步建议。若显示代理认证、代理隧道或网络错误，先在“发现任务”点击“测试代理”；若显示浏览器启动错误，重新运行安装包。浏览器随后关闭是失败任务的清理动作，不代表浏览器安装损坏。
* 网络临时中断：采集结果会先保存在本机 outbox，网络恢复后自动重试；设置页中的“失败数据”只有在需要重新登录或达到终止条件时才需要人工处理。

本压缩包不包含 VPS 密码、数据库密码、其他电脑的浏览器 Cookie 或 EastmallBuy 账号密码。请勿把账号密码写入压缩包或发送给他人。

代理输入格式：
- URL：http://host:port、https://host:port、socks5://host:port
- 带认证 URL：http://username:password@host:port、socks5://username:password@host:port
- 代理商导出格式：host:port:username:password、username:password@host:port、username:password:host:port
如果更新部署包后页面仍显示旧提示，请运行 启动项目.bat -Restart，让本地工作台加载新代码。

六、服务器统一打码账号
----------------------
所有电脑共用服务器保存的一份 TTShitu 打码账号。新电脑安装新版采集器、在网站登录并连接本机采集器后即可使用，无需填写打码账号和密码。

打码账号已由管理员迁入服务器。仅在需要修改统一账号时，由设置者在任意一台已连接的电脑运行“配置旋转验证.bat”。密码留空保留服务器已存密码；其他工作台账号不能修改这份配置。

密码在服务器加密保存，识别由服务器调用打码平台完成，不返回到各台电脑。识别或拖动失败后仍可人工完成验证。

已有电脑须结束当前任务、覆盖新版程序并运行“重启项目.bat”一次，保留原有 data、config、.venv 和浏览器资料。
旧的 tiktok_rotation.local.env 仅用于兼容本机配置；新电脑不需要创建这个文件。本机关闭自动验证的设置仍有效。


切换 TikTok 采集账号：进入设置 → TikTok 采集账号，填写备注并新增，点击登录当前账号，在新窗口登录另一个 TikTok 号。已有账号可从列表选择并切换。切换前结束采集任务并关闭登录窗口。详细说明见 docs/tiktok-accounts.md。


切换网站账号：先结束或取消正在运行的采集任务，并关闭 TikTok 登录窗口；退出当前网站账号，登录另一个账号，再点击“连接本机采集器”。同一台电脑可反复切换，无需管理员解绑。每个账号的数据分别保留；旧账号尚未上传的结果会在切回并连接原账号后继续同步。网站账号切换不会删除本机的 TikTok 登录资料。同一网站账号也可以在多台电脑上同时连接采集器。
