# 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，不接收账号 Token；Main 必须核对当前项目、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 与当前状态文档；用户已确认产品方向。