hololake-platform/research/progress/HLP-DEV-0004-HOLOLAKE-PAGE-BLOCKS-AND-THEME-RECOVERY.md

HLP-DEV-0004 · HoloLake Era 页面块与主题恢复

日期：2026-07-17

关联模块：HLP-MOD-0002

状态：已验证

为什么做

桌面同时存在三个同 Bundle ID、同图标的 App 副本，macOS LaunchServices 会将它们视为同一应用。上一轮所谓“Notion 类页面组件”实际只完成了 四种 callout；首页默认隐藏，浅色主题也没有同步应用的基础亮暗模式。

实际改动

1. 恢复并完善可携带 Markdown callout 块：info / success / warning / danger。
2. 增加 annotation / relationship / path 三种语义块，支持中英文斜杠命令搜索。
3. 重新开放 BlockNote 原生 toggle heading / toggle list 入口。
4. 保留并复用现有代码、引用、Mermaid、表格、白板和媒体块。
5. HoloLake Era 世界首页改为默认可见，首页直接显示页面组件已就绪。
6. 湖光浅色与湖心深色现在会切换实际 data-theme 亮/暗模式。

代码与补丁路径

• 可编译开发基线：bingshuo/guanghu（REPO-004，只作零件/上游基线）。
• 产品事实与付款路径：bingshuo/hololake-platform 的独立补丁。
• apps/tolaria/patches/0005-Add-portable-callout-page-blocks.patch
• apps/tolaria/patches/0006-fix-make-Guanghu-home-and-themes-visible.patch
• apps/tolaria/patches/0007-feat-complete-portable-page-block-set.patch

验证

• Vitest：5 个定向文件，24 项全部通过。
• ESLint：本次修改文件通过。
• TypeScript：tsc --noEmit 通过。
• Vite：production build 通过。
• Tauri：Apple Silicon release App 与 DMG 构建通过。
• 原生视觉验收：默认世界首页、光湖 Logo、页面组件入口、独立 0.1.3 版本号可见。
• 内测 Bundle ID：com.guanghu.desktop.review.20260717，不与旧 com.guanghu.desktop 副本串版。
• DMG SHA-256 本地已核验，仓库仅记缩略值：29bda0c9…40fda73。
• 在服务器最新 bingshuo/guanghu@514ab19 新克隆上，按 0003 → 0004 → 0005 → 0006 → 0007 应用成功。
• CodeScene / Codacy：当前本机没有 MCP、CLI 或 API 环境，未能执行，不伪造通过结果。

未完成项

1. 用户确认 0.1.3 Review 后，将桌面三个旧副本移入归档或废纸篓。
2. 安装 CodeScene / Codacy 验证环境后补跑两项质量门。
3. Windows 自动打包仍需 Gitea Actions runner。