EveryPublish/docs/client-test-checklist.md

EveryPublish Windows 客户端测试清单（检查点②）

版本 0.2.0 · 交付形态：dist/EveryPublish-Client-0.2.0-win-x64.zip（WinUI 壳 + agent-core.exe 同目录）。 前置：网页端已部署（http://<服务器>:8090 单进程），客户端与服务器网络可达。

一、构建/获取安装包

• 方式 A（推荐）：Windows 机器上执行 client/ui/Packaging/build-installer.ps1（自动生成图标 → Go 交叉编译 agent-core.exe → dotnet publish → 打包 zip）。
• 方式 B：直接用 client/dist/agent-core.exe + 手工编译 WinUI 壳（见 client/ui/README.md）。

二、第一轮：安装与假任务闭环（无需真实账号）

1. 解压 zip → 双击 EveryPublish.Client.exe：窗口出现「未配对」，右下角托盘出现图标。
2. 设置页：打开「模拟执行」开关 → 保存并重启核心（此模式下所有平台走假执行器，不碰真实平台）。
3. 网页端（管理员/owner 登录）→「设置 → Agent 设备」→ 生成配对码。
4. 客户端「配对」页输入配对码 → 配对成功 → 「状态」页显示在线（服务器/设备号）。
5. 网页端：账号管理 → 添加账号（任选平台）→ 指定刚配对的设备 → 绑定 → 客户端「挑战」页出现挑战 → 点选提交「我已确认」→ 网页端账号变已绑定。
6. 网页端：素材库上传一个视频 → 新建发布（选素材+账号）→ 任务列表「提交审核」→ 审核中心「通过」→ 任务自动下发 → 变绿「发布成功」（假执行器秒回）。
7. 系统行为：关闭窗口 → 最小化到托盘（进程仍在）；托盘右键「退出」才退出；设置页开「开机自启」→ 注销重登自动运行；任务管理器手动结束 agent-core.exe → 5 秒内看门狗自动拉起（3 次失败弹窗提示）。

三、第二轮：B站真实发布（无浏览器投稿）

1. 设置页**关闭「模拟执行」**并保存（重启核心）。
2. 网页端添加 B站账号 → 指定设备 → 绑定 → 客户端「挑战」页显示 B站登录二维码（API 生成）→ 手机 B站 App 扫码确认 → 网页端账号变已绑定（cookie 加密存入本机保险库，服务器零凭据）。
3. 新建发布（选该 B站账号）→ 审核通过 → 客户端自动执行：preupload → 分片上传 → 投稿 → 网页端任务变成功，发布链接为 https://www.bilibili.com/video/BV...。
4. 到 B站「创作中心 → 内容管理」核对稿件已上线；客户端数据目录 receipts/ 有截图回执。

四、第三轮：抖音/快手/小红书真实发布（CDP）

1. 分别添加对应平台账号 → 绑定 → 客户端「挑战」页显示该平台登录页二维码（CDP 截图）→ 手机 App 扫码。
2. 新建发布 → 审核通过 → 客户端拉起浏览器（每账号独立档案，首次会下载 Chromium 或使用系统 Chrome）→ 自动上传/填表/发布 → 任务成功 + 截图回执。
3. 选择器容错：平台改版可能导致找不到元素——失败时查看客户端日志（数据目录下）与 receipts/ 失败截图，把截图发我调整选择器（架构上只需改配置，无需改流程）。

五、验收标准（与九项最终验收第 6-7 项对应）

#	项	通过条件
1	安装	解压即用，双击启动
2	配对	配对码绑定成功，状态页在线
3	假任务闭环	第一轮步骤 5-6 全通过
4	B站真实发布	稿件真实上线
5	抖音/快手/小红书真实发布	至少 1 个平台真实上线（可先交付可跑子集）
6	凭据安全	平台凭据仅存本机 %APPDATA%\EveryPublish（加密 vault），服务器零凭据
7	常驻行为	托盘/自启/watchdog 均正常

六、常见问题

• 核心进程未就绪：安装目录缺少 agent-core.exe，或看门狗 3 次失败弹窗——检查打包脚本是否复制了 core。
• 配对码无效：5 分钟过期，网页端重新生成。
• 任务一直排队：账号绑定的设备离线（IP 隔离设计），确认客户端状态页在线。
• 日志位置：数据目录（设置页可打开）：%APPDATA%\EveryPublish（core 日志经看门狗输出，可用「打开数据目录」查看 config.json/local.json；进程日志在 Windows 事件查看器或直接命令行运行 agent-core.exe -dir <目录> 观察）。