记录客户端本地构建发布主分支晋升

.project-docs/30-worklog/tasks/20260811-package-win-a7c3.md

@@ -0,0 +1,53 @@
+# Task: Build Makelore 1.0.0 Windows package
+
+## Identity
+
+- Task ID: 20260811-package-win-a7c3
+- Mode: Feature
+- Branch: main
+- Worktree: D:\Datas\OthersProjects\makelore
+- Base commit: be9bc84474cd23aa3861c0cb059082785e72abf2
+- Owner: developer
+- Status: Completed
+
+## Scope
+
+- 基于最新 `main` HEAD 构建 Windows x64 Electron 安装包。
+- 通过 electron-builder 的 `extraMetadata.version` 将安装包及包内版本固定为 `1.0.0`，不修改源码 `package.json` 版本。
+- 交付 `release/Makelore-1.0.0-win-x64.exe`，并完成运行时、原生模块、内置工具和 SHA256 校验。
+
+## Intent And Constraints
+
+- 保留内部 `niancode` 兼容标识及现有 Makelore 打包边界。
+- 不恢复发布/上传工作台，不修改产品代码或共享 canonical 文档；仅生成本地构建产物与本任务记录。
+- 使用仓库锁定的 pnpm 版本；若外部运行时下载不可用，必须验证并复用同版本的本地运行时，不能静默交付未验证文件。
+
+## Plan
+
+1. 核对源码版本、当前提交和 Windows 打包前置运行时。
+2. 执行 Renderer/Main/Preload 编译与 Windows x64 打包，覆盖安装包版本为 `1.0.0`。
+3. 校验安装包内部版本、Electron/Node、Python/uv/OpenCode、原生模块、Unicode 路径和 SHA256。
+
+## Outcome
+
+- 已基于最新 `main` HEAD `3a80625fe2fb74ab4e0a883188a52eade8cd23b9` 完成 Windows x64 安装器重建。
+- 源码 `package.json` 版本为 `2.0.0`；通过 electron-builder `extraMetadata.version=1.0.0` 生成并确认包内版本为 `1.0.0`，未改动源码版本。
+- 交付产物为 `release/Makelore-1.0.0-win-x64.exe`。
+- 复用已验证的本地 `uv 0.10.0` x64 运行时，避免外部下载波动。
+
+## Verification
+
+- `pnpm run package:stage:win-x64`：通过。
+- `node scripts/run-electron-builder.mjs --win --publish never --config.extraMetadata.version=1.0.0`：通过。
+- `pnpm run verify:artifact:win -- --allow-dirty --installer .\\release\\Makelore-1.0.0-win-x64.exe`：通过。
+- 包内版本：`1.0.0`；Electron：`40.10.6`；Node：`24.15.0`；OpenCode：`1.18.9`；uv：`0.10.0`。
+- 原生模块、Python/uv/OpenCode/Playwright MCP、Unicode 路径校验均通过。
+- 安装器大小：`219861126` bytes（约 `209.68 MiB`）；SHA256：`10785C90A3C7D45DCDF26DC9C81171DE3914D673B441EE33EB2E36575A2888CB`；签名状态：`NotSigned`。
+
+## Follow-ups
+
+- 如需正式分发，后续应配置并验证 Windows Authenticode 签名。
+
+## Promotion Candidates
+
+- None recorded；本任务仅生成本地构建产物，不改变产品行为或 canonical 项目记忆。