edit | blame | history | raw

2026-07-01 MEXP09 价值包

用户目标

领取 P-20260701-mexp09-value-dmg-release 的 MD-MEXP09-REL-01，生成体现 MEXP09 用户价值的 Mindraw 可安装 DMG 候选包。版本从 1.0.0 升到 1.1.0，因为项目本地规则要求用户可感知新 feature 至少递增 0.1。

MEXP09 价值边界固定为：

target Frame -> visualContext.snapshot -> visualScopeAudit -> m4c sanitized package

本轮不做 H8 / formal release，不触碰 m4c，不实现新功能，不把 OCR-only、文本摘要或整文档读取写成 MEXP09 价值。

已完成事项

  • 将已跟踪版本元数据升级到 1.1.0：package.json、src-tauri/tauri.conf.json、src-tauri/Cargo.toml。
  • 本地同步忽略项 lockfile：package-lock.json 和 src-tauri/Cargo.lock，但未强制纳入 Git，因为 .gitignore 明确忽略 package-lock.json 与 *.lock。
  • 将 CHANGELOG.md 的 MEXP09 / MEXP08B / frame-only context 条目收口到 1.1.0 - 2026-07-01，并明确 MEXP09 不是 OCR 增强。
  • 更新 scripts/package-mindraw.sh，让 MINDRAW_RELEASE_CLASS=mexp09-value 输出正确 package type、release class 和 known limitations。
  • 更新 CODEGRAPH.md、03-O/C2.builds/README.md、INDEX.md、02-P/plan-progress.markdown。
  • 创建固定 source commit：d0bd0083d4b789bdb361e2687e017cdc0f8308a8。
  • 创建 annotated tag：v1.1.0-Build202607011703，tag target 为 source commit。
  • 生成 DMG 候选包：03-O/C2.builds/releases/Build202607011703/Mindraw_1.1.0_aarch64-Build202607011703.dmg。
  • 产出 QA：02-P/qa/mindraw-mexp09-value-dmg-release-check.md 和 .json。

核心事实 / 变更快照

  • 变更对象：Mindraw App metadata / release package line。
  • 变更前：App version 1.0.0；MEXP09 已用户验收但未有价值包 DMG。
  • 变更后：App version 1.1.0；build Build202607011703；build number display 20260701.1703。
  • Source commit：d0bd0083d4b789bdb361e2687e017cdc0f8308a8。
  • Release tag：v1.1.0-Build202607011703，target d0bd0083d4b789bdb361e2687e017cdc0f8308a8。
  • DMG SHA256：e112c6105d79d3e6876d9770998dae7a33c00ac7e35814a9ac4f9ac95f5f0e1e。
  • Manifest SHA256：9351314d8ece23382d21399ca4d63cc5f4a3644ba860583b8aaea5bc437ae8f0。
  • Signing boundary：App ad-hoc signed；DMG unsigned；notarization not requested；spctl / stapler rejection is expected warning for this acceptance candidate.
  • Scope boundary：not H8 formal release, not App Store release, not Windows / Linux / macOS Intel release, not formal MCP server, not real AI provider release.

文件变更

  • package.json
  • src-tauri/tauri.conf.json
  • src-tauri/Cargo.toml
  • CHANGELOG.md
  • scripts/package-mindraw.sh
  • CODEGRAPH.md
  • 03-O/C2.builds/README.md
  • INDEX.md
  • 02-P/plan-progress.markdown
  • 02-P/qa/mindraw-mexp09-value-dmg-release-check.md
  • 02-P/qa/mindraw-mexp09-value-dmg-release-check.json

Ignored local consistency files:

  • package-lock.json
  • src-tauri/Cargo.lock

验证证据

  • npm test -- --run src/lib/mindrawAppReadApi.test.ts src/lib/mindrawAppApiTransport.test.ts：PASS，2 files / 15 tests。
  • npm run build：PASS，保留既有 font URL、Tauri dialog import、large chunk warnings。
  • BUILD_ID=202607011703 MINDRAW_RELEASE_CLASS=mexp09-value MINDRAW_BUILD_AGENT=coder2@mindraw npm run package:mindraw：PASS。
  • hdiutil verify <DMG>：PASS。
  • DMG mount check：PASS，包含 Mindraw.app 与 Applications -> /Applications。
  • codesign --verify --deep --strict --verbose=2 <Mindraw.app>：PASS，exit 0。
  • npm run doctor:mindraw -- --app <Mindraw.app> --pretty：PASS，metadata pass；runtime endpoint / token 未存档。
  • spctl / xcrun stapler validate：预期 warning，因本包未 Developer ID notarize。
  • git diff --check：PASS。

可复用命令 / Runbook

用途：从固定 source commit 生成 MEXP09 value DMG acceptance candidate，并验证 DMG / metadata / signing boundary。

前置条件：

  • 在 /Users/ar/Projects/ExcalidrawX。
  • 已将 App version / changelog / package script metadata 提交为固定 source commit。
  • 已创建指向 source commit 的 v1.1.0-BuildYYYYMMDDHHMM tag。
  • 本命令默认生成 ad-hoc / non-notarized local acceptance candidate；若要 Developer ID / notarization，必须另走 H8/formal release 规则。

设置命令：

BUILD_ID=202607011703 MINDRAW_RELEASE_CLASS=mexp09-value MINDRAW_BUILD_AGENT=coder2@mindraw npm run package:mindraw

验证步骤：

npm test -- --run src/lib/mindrawAppReadApi.test.ts src/lib/mindrawAppApiTransport.test.ts
npm run build
shasum -a 256 03-O/C2.builds/releases/Build202607011703/Mindraw_1.1.0_aarch64-Build202607011703.dmg 03-O/C2.builds/releases/Build202607011703/release-manifest.json
python3 -m json.tool 03-O/C2.builds/releases/Build202607011703/release-manifest.json
hdiutil verify 03-O/C2.builds/releases/Build202607011703/Mindraw_1.1.0_aarch64-Build202607011703.dmg
codesign --verify --deep --strict --verbose=2 src-tauri/target/release/bundle/macos/Mindraw.app
npm run doctor:mindraw -- --app src-tauri/target/release/bundle/macos/Mindraw.app --pretty
git diff --check

清理 / 恢复：

hdiutil detach /tmp/mindraw-mexp09-Build202607011703

搜索关键词：MEXP09价值包、MD-MEXP09-REL-01、Build202607011703、mexp09-value、v1.1.0-Build202607011703。

未决问题

  • PM 需要执行 PM-MEXP09-REL-GATE，复核 DMG、SHA、manifest、tag target、QA 和签名 / 公证边界，再决定是否进入用户验收。
  • 若需要更接近公众分发的安装体验，需另派正式 Developer ID signing / notarization 任务，不能把本候选包直接改称 formal release。