windows.md

Windows 使用与构建

安装与运行

在 GitHub Release 下载 setup EXE，按当前用户安装，无需管理员权限。便携 ZIP 解压后双击 SecondEye.exe，请保留相邻的 _internal 目录。两种形式使用相同的数据目录。

启动器显示“本地服务运行中”后自动打开默认浏览器。网页里配置模型、扫码登录并建立任务。重复启动会打开已运行的实例。“退出”会停止后台服务及所属抓取浏览器；用户的默认浏览器独立运行。无需 Python、Node.js、Docker。

任务中的“品相要求”请填写具体购买属性，例如“九成新、无盒可以接受”，最低品相分用于设置评分硬门槛。单独填写“请根据图片判断”等操作指令，可能在仅接收文字的需求筛选阶段被判为信息不足。

当前发行包为未签名的 x64 程序，Windows 11 x64 已实机验证，未进行 Windows 10 或 ARM64 实机验收。源码和 Docker 仍提供其他平台的部署方式。

数据与迁移

默认数据目录为 %LOCALAPPDATA%\SecondEye，包括 goodprice.db、.env、browser_profile、缓存和日志。启动器的“打开日志目录”可定位日志。设置既可以在网页填写，也可以在这个目录的 .env 中填写。安装目录和当前工作目录的 .env 不会自动被读取。

升级前退出启动器并备份整个数据目录。安装升级和卸载不会删除该数据目录。不要让两个应用进程操作同一数据库。

从源码或 Docker 迁移时，先停止原服务并备份原数据。将原数据目录内容复制到上述目录，保留媒体子目录的相对结构。桌面版会将数据库定位到新目录的 goodprice.db，不使用旧 .env 的 DATABASE_URL、DATA_ROOT 或容器运行模式。浏览器登录资料不一定能跨运行环境复用，迁移后重新登录并检查媒体路径。原数据不应直接被覆盖。

可以用命令指定隔离目录：

.\SecondEye.exe --data-dir "D:\SecondEye 数据"

可选视频工具

首版 Windows 包未捆绑第三方 FFmpeg，图片与文本能力可直接使用。要启用视频抽帧，自行安装适合本机的 FFmpeg，并确保 ffmpeg 和 ffprobe 都可用；也可将它们和对应 DLL 放在数据目录下的 media-tools\bin。重启启动器后检查设置页媒体能力。工具包的授权信息应随原工具保留。

从源码构建

构建使用 Python 3.11、锁定的应用依赖、Playwright Chromium、PyInstaller 6.22.3 和 Inno Setup 6.7.1。安装 uv 与 Inno Setup 后执行：

.\scripts\build-windows.ps1 -InnoCompiler "C:\path\to\ISCC.exe"

脚本下载匹配锁定 Playwright 的完整 Chromium，仅收集 chromium-*。可用 -BrowserRoot 指向已有 Playwright 浏览器缓存。可选 -MediaToolsRoot 指向包含 bin\ffmpeg.exe、bin\ffprobe.exe 及根目录许可证的工具目录，公开首版不传此参数。

产物位于 dist\windows，包括便携 ZIP、setup EXE、SHA256SUMS.txt。构建会在含中文和空格的数据路径下、限制 PATH 后运行冻结程序，验证网页、静态资源、设置持久化、单实例、浏览器和退出流程。--smoke-test --data-dir <目录> 可重跑该验收。