# 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。
