实现项目真机预览与待审版本扫码验收

需求:接管客户端未提交 WIP,保留真机预览,移除旧登录原型并维持 2.0.0。

实现:由 Main 核对项目与精确 Release,签发短时 Owner preview;补充一键提交映射能力及 Windows ZIP 预检兼容。
This commit is contained in:
2026-08-08 17:57:36 +08:00
parent 7b23cce67a
commit 1a19ad9808
20 changed files with 1890 additions and 12 deletions

View File

@@ -0,0 +1,46 @@
# Task: 接管并整理客户端真机预览 WIP
## Identity
- Task ID: 20260808-device-preview-wip-c91e
- Mode: Feature
- Branch: codex/20260808-device-preview-wip-c91e-device-preview
- Worktree: D:\Datas\OthersProjects\makelore
- Base commit: 7b23cce67a1b9e61a48d89dedbd088d37b10ecd4
- Owner: codex
- Status: Done
## Scope
- 接管原 `main` 工作区中已知未提交改动,收敛为独立真机预览功能。
- 保留项目级入口、Main-owned 状态核对、二维码页面与测试;移除已被登录集成 `5792b07` 替代的旧认证尝试,并保持产品版本 `2.0.0`
- 对接待审 Release 的短时 Owner preview URL同时保留已发布精确版本的同源 Runtime 预览。
## Intent And Constraints
- 用户已明确授权接管这批已知 WIP并确认登录实现以 `5792b07` 为准。
- Renderer 只接收可展示的短期预览 URL不接收账号 TokenMain 必须核对当前项目、app/version/release 身份、同源 HTTPS 与非回环地址。
- 真机预览不新增顶层模块、发布上传工作台或云部署页面;版本号不从 `2.0.0` 回退。
## Outcome
- 新增项目真机预览路由和二维码页;待审版本通过精确 Release 的 Owner preview ticket 验收,已发布版本使用核对过版本号的 Runtime。
- 新增一键提交后的本地 app/version/review 映射写入能力,供集成阶段的发布成功响应调用。
- Windows ZIP 预检改用系统自带 `tar` 作为条目读取兜底,测试 fixture 同步支持 Windows不再要求额外安装 `zip/unzip`
- 旧登录刷新原型已从 WIP 中移除,包版本保持 `2.0.0`
## Verification
- `pnpm exec vitest run tests/unit/works-cloud-deployment.test.ts tests/unit/device-preview-routes.test.ts tests/unit/device-preview-page.test.tsx tests/unit/chat-device-preview-navigation.test.tsx tests/unit/agent-conversation-sidebar.test.tsx`5 files / 57 tests passed。
- `pnpm run typecheck`passed。
- scoped ESLint本任务涉及的 Electron、Renderer 与测试文件passed。
- `git diff --check`passed仅工作区 CRLF 提示)。
## Follow-ups
- Integration 阶段将本提交与登录 `5792b07`、一键发布 `724290e` 合并,并在一键提交成功后调用 `recordSubmitted` 写入精确 app/version/release 关联。
- `opencode-chat-panel` 中依赖新登录续期实现的既有用例在本 Feature 基线上不单独修正,由登录集成覆盖后统一回归。
## Promotion Candidates
- Integration 将真机预览的 Main-owned 安全边界和一键发布映射写入同步到 README 与当前状态文档;用户已确认产品方向。