makelore/.project-docs/30-worklog/tasks/20260808-device-preview-wip-c91e.md

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: 7b23cce67a
• 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 与当前状态文档；用户已确认产品方向。