6.9 KiB
6.9 KiB
Task: 集成 Makelore 本地构建发布事实
Identity
- Task ID: 20260812-integrate-client-built-release-makelore-72ce
- Mode: Integration
- Branch: codex/20260812-integrate-client-built-release-makelore-72ce-integrate-client-built-release
- Worktree: D:\Datas\OthersProjects\makelore-integrate-client-built-release-72ce
- Base commit:
5b44864265 - Owner: codex
- Status: Completed
Scope
- 从源任务
20260812-client-built-release-makelore-7e5b晋升 Main-owned 本地 npm/Vite 构建、同字节 Electron 双视口预检、双归档上传和服务端固化边界。 - 更新 canonical current state、architecture、domain、evidence、commitments、history、success criteria,以及仍在使用的
.opencode发布课程说明。 - 只修改 canonical 文档、现行发布 skill 和本 integration task record;不修改生产代码、source task 或其他历史 task record。
Intent And Constraints
- 用户已明确批准架构反转:客户端用安装版 Electron Node、固定 npm 11.6.2 和项目 lockfile Vite 本地构建;服务端不再运行项目 Vite,只校验并固化不可信字节。
- Vite config/plugins 以桌面用户权限执行,不是 sandbox;仅适用于用户信任的本地项目,依赖安装需要网络。
- Electron 预检检查与最终
built_archive相同的内存字节,但无可信 receipt、不复刻生产 opaque-origin,不得替代服务端摘要/合同/不可变 Release 校验或人工审核。 - 旧客户端与旧 sandbox/browser 任务提示升级后重新构建提交;新版
BUILD_STALE、归档存储和 ReleaseStore 瞬时失败由运营在“构建异常”中重试。 - 当前 Windows 安装器证据固定为 223,547,912 bytes、SHA-256
08A0BB7BC66EE4AD8B120E8955B149951CD86AF53CC966C7973AD4D77A5815C1;仅记录为已验证但未上传、未发布。
Project Context Loaded
Task context:
- Task ID:
20260812-integrate-client-built-release-makelore-72ce - Mode: Integration
- Branch:
codex/20260812-integrate-client-built-release-makelore-72ce-integrate-client-built-release - Worktree:
D:\Datas\OthersProjects\makelore-integrate-client-built-release-72ce - Base commit:
5b44864265eb8a85484e38e49f5e177d108328a3 - Other active local tasks: release-client、login-sliding、browser-preflight、static-release-only、cloud-build diagnosis、source client-built-release、design multisession、design enter-send、Windows package。
- Overlap or semantic-conflict assessment: browser-preflight canonical 曾明确禁止客户端执行 Vite,与本任务相反;用户已明确批准架构反转,因此冲突已获人类决策。其余 peers 不改变本次计划;Windows package 只提供旧安装产物背景,不覆盖本次最终产物证据。
Read:
.project-docs/05-agent-entry/read-before-planning.md.project-docs/05-agent-entry/memory-index.md.project-docs/30-worklog/current-state.md.project-docs/00-brief/project-positioning.md.project-docs/00-brief/success-criteria.md.project-docs/10-decisions/decision-index.md.project-docs/20-architecture/system-overview.md.project-docs/20-architecture/module-map.md.project-docs/20-architecture/data-flow.md.project-docs/40-domain/business-rules.md.project-docs/40-domain/glossary.md.project-docs/50-evidence/evidence-index.md.project-docs/60-reflection/reflection-index.md.project-docs/80-commitments/commitments.md.project-docs/90-maintenance/stale-items.md- source task record and every active peer task record through its registry-owned worktree
Relevant understanding:
- Project goal: 为非专业用户提供一个 Main-owned、安全投影且无需 Docker/ZIP/服务器操作的一键静态发布链。
- Current integrated focus: 旧 snapshot 仍以开发 loopback preview + 服务端构建为主,本任务明确替换该边界。
- Active task scope: 只晋升源提交
5b44864已验证的长期事实,不改生产代码。 - Active constraints: Renderer 不得持有凭据、路径、归档或 origin;客户端结果不成为服务端信任声明。
- Decisions affecting this task: 用户已确认本地构建架构反转;ADR-001 与发布链无冲突。
- Evidence, reflections, or commitments affecting this task: source task 129 focused tests、真实 Electron E2E、npm/Vite smoke、packaged verifier;生产整链仍未验收。
- Files or modules likely involved: canonical
.project-docs、.opencode/skills/youth-ai-product-course/SKILL.md、.opencode/skills/dev-build-test/SKILL.md。 - Unknowns, stale docs, or conflicts: 服务端新协议、OSS/CDN、运营/App 生产整链未验证;项目 positioning 仍是旧模板占位,但不影响本次局部晋升。
Gate result:
- Passed.
Plan
- 以源 task outcome/promotion candidates 和
5b44864生产差异为证据,替换旧本地预检/云端构建 canonical 描述。 - 同步发布运行时、双归档合同、错误重试、安装器证据和生产整链 commitment。
- 运行 project-docs、drift、diff 和聚焦语义扫描,提交中文 integration commit,完成 task context;保留 worktree ownership。
Outcome
- 已将发布 canonical 链路更新为 Main-owned local npm/Vite build → final built snapshot Electron 双视口预检 → source+built+artifact contract 上传 → 服务端逐字节校验与不可变 Release 固化。
- 已明确固定 npm 11.6.2、项目 lockfile Vite、桌面权限执行 config/plugins(非 sandbox)、无全局 PATH/既有
node_modules回退和依赖网络要求。 - 已保留客户端预检可绕过、无可信 receipt、不复刻 opaque-origin,以及 Renderer 不接触路径/归档/origin/凭据的安全边界。
- 已固化旧客户端/旧 sandbox-browser 任务重提、新版瞬时固化失败由运营重试,并登记最终 Windows 安装器大小/SHA 和“未上传、未发布”事实。
- 已同步两份仍在使用的
.opencode发布课程 skill;未修改生产代码、source task 或任何 peer/historical task record。
Verification
check_project_docs.py: PASS。check_doc_drift.py --task-id 20260812-integrate-client-built-release-makelore-72ce: PASS,写入边界仅包含 canonical project docs 与本 integration task record。git diff --check: PASS(仅 Git LF/CRLF 工作区提示)。- 聚焦语义扫描核对固定 npm、Vite、双归档、
preflightStaticArtifact、BUILD_STALE和旧 sandbox/browser 协议表述;canonical 现行描述已与5b44864源实现/任务证据一致。 - source tip
5b44864265eb8a85484e38e49f5e177d108328a3已存在且正是 integration base;Integrated Through已登记5b44864。
Follow-ups
- 服务端新协议、不可变 Release、运营审核、CDN/App 播放仍需真实生产整链验收。
- 每次正式 Windows 安装器发布前继续运行 publish runtime 与 artifact verifier。
Promotion Candidates
- None. Accepted source facts are being promoted by this Integration Gate.