# 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 <目录>` 观察）。