50 lines
2.3 KiB
Markdown
50 lines
2.3 KiB
Markdown
|
# 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。
|