Files
makelore/.project-docs/30-worklog/tasks/20260808-device-preview-wip-c91e.md
brother7 1a19ad9808 实现项目真机预览与待审版本扫码验收
需求:接管客户端未提交 WIP,保留真机预览,移除旧登录原型并维持 2.0.0。

实现:由 Main 核对项目与精确 Release,签发短时 Owner preview;补充一键提交映射能力及 Windows ZIP 预检兼容。
2026-08-08 17:57:36 +08:00

47 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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