38 lines
9.9 KiB
Markdown
38 lines
9.9 KiB
Markdown
# EveryPublish 开发进度跟踪
|
||
|
||
> 状态：进行中 · 阶段一（网页端 D1-D7）。目标：goal-8c8e81e4-d2ed-4ba9-a4f7-d413c4f9e00b。
|
||
> 更新规则：每天结束更新本表；检查点①/②需用户确认后才进入下一阶段。
|
||
|
||
## 总览
|
||
|
||
| 阶段 | 状态 | 说明 |
|
||
|---|---|---|
|
||
| 阶段一 网页端 D1-D7 | 🟡 进行中 | D1-D7 全部完成，进入检查点①网页端手动测试 |
|
||
| 检查点① 网页端手动测试 | ✅ 用户已验收确认 | 用户确认进入阶段二 |
|
||
| 阶段二 客户端 D8-D11 | 🟡 进行中 | D8-D11 代码全部交付，进入检查点②交付用户测试 |
|
||
| 检查点② 交付用户测试 | ✅ 已交付 | 最终产物切换为 Electron 壳（client/desktop，正规安装包+正常 UI 四页签）替代 WinUI3 源码交付；NSIS 安装包 `EveryPublish Setup 0.2.0.exe` 构建成功（图标 app.ico 修复后 EB_EXIT=0，内嵌 agent-core.exe）；服务器部署包 dist/deploy（linux-amd64/windows-amd64+web+docker-compose+.env 样例）齐备；内网连接/填写说明（docs/client-install-guide.md + dist/deploy/deploy-README.md + 测试账号方案）交付；模拟 E2E 第 N 轮实测：登录→设备在线(winui-fakeall/core-d8)→账号 active→素材 ready→任务→submit→approve→假执行→status success；等用户在内网 192.x 实机验收 |
|
||
| 阶段三 联调交付 D12-D13 | ⚪ 未开始 | |
|
||
|
||
## 逐日验收
|
||
|
||
| 日 | 任务 | 验收标准 | 状态 | 证据 |
|
||
|---|---|---|---|---|
|
||
| D1 | 工程化与骨架 | dev 无报错、菜单空壳可点、/health 200、DB 连上 | ✅ 通过 | 后端：/health 200（db:true,redis:true）、12 表 AutoMigrate、go build/vet/run 通过（:8090）；前端：示例页+mock 清理、17 个页面空壳+2 组菜单路由、vite dev :3003 启动 200、代理到后端 404(gin) 正常、tsc --noEmit 0 错误 |
|
||
| D2 | 认证与工作区 API | 单测过；前端登录页真实登录 | ✅ 通过 | 后端：Argon2id 口令、JWT access 15min/refresh 7d 轮换（Redis jti 吊销）、register/login/refresh/logout/me、workspaces CRUD、members 邀请(JWT)/加入/改角色/移除、审计中间件落库；go test 单测 4 项+集成测试 2 场景全过（真 MySQL everypublish_test + 真 Redis）；前端：登录/注册页接真实 API、401 自动刷新重试（单飞）、路由守卫、启动拉取用户信息、Header 显示昵称+登出；tsc 0 错误；经 vite 代理 curl 验证登录 200/错误密码 401 |
|
||
| D3 | 业务 API | 单测+接口文档；curl 全接口可跑 | ✅ 通过 | 账号台账 CRUD+bind→challenge（平台白名单/绑定中禁删）；素材 multipart 流式 sha256+同工作区去重+签名直链(10min 一次性 200→404 已验证)；任务状态机(纯函数 4 项单测：happy path/失败重试/挂起恢复/非法转移) + CRUD/submit/approve/reject/resubmit/retry/cancel+驳回/通过自动通知；挑战 solve/resend/suspend+过期软置；通知列表/已读/全部已读；go test 全过；curl E2E 账号/素材/直链/任务/通知全链路 200；接口文档 docs/api.md（含状态机图） |
|
||
| D4 | WSS 网关+假执行器 | 假执行器闭环 <300ms | ✅ 通过 | 双通道 WSS：/ws/agent（Ed25519 hello 验签，坏签名拒绝已验证）+ /ws/browser（JWT 订阅）；心跳/hello.ack 签名；task.push→ack→result 全链路；challenge.new→solve→账号激活；设备配对码（5min 一次性）；下发器（审批即时触发+1s 轮询兜底，先落库后推送防竞态）；假执行器 server/cmd/fake-agent；集成测试全链路 PASS，下发延迟实测 28.7ms(<300ms)；前端 utils/ws.ts 自动重连 + 工作台真实页面（设备在线状态+最近任务实时变绿），经浏览器通道收到 3 条 task.status 事件（末条 success） |
|
||
| D5 | 页面① | 页面与真实 API 联通 | ✅ 通过 | 登录/仪表盘（D2/D4 已真实化）+ 成员页（列表/邀请弹窗生成链接+复制/行内改角色/移除，owner 保护）+ 设置 4 页（工作区资料可改名保存、我的账号、2FA 默认关留位、通知渠道二期留位、设备列表+吊销）+ 邀请接受页 /invite（登录态判断/邮箱校验/成功引导）；后端补 PUT /agent/devices/:id/revoke（吊销+强制下线）与 PUBLIC_BASE_URL（浏览器链接与 Agent 直链分离）；tsc 0 错误；6 页面全 200；邀请链接实测指向 3003 前端；吊销实测生效 |
|
||
| D6 | 页面② | 全流程可点通 | ✅ 通过 | 素材库（Upload 组件接真实上传、类型/分组筛选、sha256/大小/签名直链弹窗+复制、删除）；账号台账（平台标签/状态/健康度/IP 画像、添加弹窗、绑定弹窗监听 challenge.status WS 自动关闭）；任务列表（状态筛选、按状态渲染操作：提交/通过/驳回(批注弹窗)/重提/重试/取消/删除、详情 Drawer、WS 实时刷新）；新建发布四步向导（选素材→选账号(仅 active)→填内容(TagInput/定时 DatePicker)→确认提交）；排期日历（Calendar 组件按日展示任务 Tag）；tsc 0 错误；5 页面全 200；全流程模拟：素材经前端代理上传→新账号→bind→假执行器扫码→active→向导 payload 建任务→提交→审核→自动下发→status:success |
|
||
| D7 | 页面③+admin | 角色权限正确、admin 入口可用 | ✅ 通过 | 审核中心（待审列表+预览抽屉+通过/驳回批注）；挑战中心（QR 本地渲染 TDesign QRCode+验证码输入+挂起/一键重发，WS 实时刷新）；通知（未读角标+已读/全部已读）；审计（动作筛选+分页）；admin 两页（租户列表/停用启用、Agent 总览/强制吊销）；菜单按角色过滤（meta.admin 仅 admin 可见）；后端 /admin 组 AdminRequired 守卫；实测：普通用户 admin API=403、admin 账号=200；tsc 0 错误；6 页面全 200 |
|
||
| D8 | agent-core | core 单测过；与服务器假执行闭环 | ✅ 通过 | client/core（Go）：设备身份(Ed25519 密钥 0600 持久化)、凭据保险库(AES-256-GCM，主密钥独立文件，防篡改单测)、执行器框架(Registry+兜底+ChallengeSolver)、假执行器、WSS 客户端(1s/5s/15s/60s 指数退避重连+握手重置、15s 心跳、写锁防并发写、任务幂等：已执行任务重放缓存结果不重复执行)、配对(AutoPair/PairWithCode)、配置持久化；单测 4 包全过（含 stub 服务器握手验签/任务往返/幂等重放/断线重连）；Windows 交叉编译 agent-core.exe 9.0M 成功；真服务器闭环：core 设备指定绑定→挑战自动解决→账号 active→任务下发→执行→success（core 日志全程确认） |
|
||
| D9 | WinUI3 壳 | Windows 实机：安装→配对→假任务→回传 | ✅ 代码交付（实机验收并入检查点②） | Go 侧：core 新增 localhost 控制服务（随机端口+token 写 local.json，/status 含 server/deviceId/name、/challenges、/challenges/:id 提交、/pair 配对回调，401 鉴权）+ 挑战队列/人工解决/在线状态接口，单测 5 包全绿，curl 实测 401/状态/配对错误传播全通过；WinUI 壳：csproj(net8.0-windows10.0.19041.0+WindowsAppSDK 1.5 自包含+H.NotifyIcon.WinUI)+MainWindow(顶部导航4页/关闭最小化托盘/托盘右键打开退出)+状态页(3s轮询)/配对页/挑战页(2s轮询+验证码提交)/设置页(服务器地址+开机自启+重启核心)+Watchdog(5s心跳/崩溃自拉起/3次失败弹窗)+AutoStart(HKCU Run)+打包脚本 build-installer.ps1(生成图标→Go 交叉编译→dotnet publish→组装→zip)；Mac 无法编译 C#/WinUI，Windows 构建步骤与验证清单见 client/ui/README.md |
|
||
| D10 | B站真实发布 | B站真实发布成功 | ✅ 代码交付（真实账号发布验证并入检查点②） | client/core/internal/exec/bilibili：无浏览器投稿全链路（preupload→upos/bda2 分片上传→分片合并→x/vu/web/add 投稿，协议依据 biliup MIT 源码）+ 扫码登录（passport web qrcode generate→poll 轮询 86101/86090/0→跨域 URL 提取 SESSDATA/bili_jct/DedeUserID→加密保存保险库）；ChallengeSolver 接口扩展 onQR 回调（二维码推壳展示）；执行器接入 main（B站走真实链路，其它平台假兜底）；单测 3 项全过（stub 全链路：分片参数/合并 parts 数/csrf/投稿体校验；QR 登录二次轮询成功+凭据落库；未扫超时）；go vet 干净；agent-core.exe 交叉编译成功 |
|
||
| D11 | 抖音/快手/小红书 | 三平台真实发布+截图回执 | ✅ 代码交付（真实账号发布验证并入检查点②） | client/core/internal/exec/{cdp,cdnbase,douyin,kuaishou,xiaohongshu}：CDP 基础设施（rod-launcher 启动、每账号独立档案 UserDataDir、proxy-server 代理绑定、go-rod/stealth 指纹反自动化、系统 Chrome/Edge 自动探测、cookie 注入/导出、扫码登录通用流程：登录页→QR 截图落盘 file://→onQR 推壳→轮询 URL 离开登录页→cookie 加密入库）；通用发布流程（上传页→注 cookie→传视频→等表单 180s→填标题/描述话题→点发布→等成功跳转→截图回执 PNG）；三平台选择器按 social-auto-upload 2026-06 版配置（抖音 creator-micro/content/manage 成功特征、快手 article/manage/video、小红书 publish/success）；main 注册三平台真实链路；单测 4 项（JSON 转义往返/素材下载/HTTP 错误/Chrome 路径探测）；WinUI 挑战页补 Image 二维码显示（http/file:// 均可）；go vet 干净；agent-core.exe 交叉编译 14M 成功 |
|
||
| D12 | 联调+异常注入 | 验收清单全过 | ⚪ | |
|
||
| D13 | 打包+内部试用 | 新机安装走通、交付物齐 | 🟡 打包完成待用户试用 | Electron 壳（四页签 UI/托盘/开机自启/fakeAll）+NSIS 安装包构建成功（见检查点②）；部署包+安装指南+测试账号说明齐；用户内网实机安装与联调由 D12-D13 继续 |
|
||
|
||
## 服务端口约定
|
||
|
||
- 本机开发：Go 后端 :8090（8080 被 nginx 占用）；MySQL 3306（Docker everypublish-mysql）；Redis 6379（本机）。
|
||
- 前端 dev：Vite :3002（starter 默认），/api 走 vite proxy 到 :8090。
|