hololake-platform/apps/tolaria/README.md

Tolaria / 光湖 App · 研发入口

产品名：冰朔通感语言核操作系统的人类协作界面

研发主仓：HoloLake Platform

源码基线：bingshuo/guanghu（上游 Tolaria 兼容零件基线）

这里是 Tolaria / 光湖 App 的研发入口，不把整份第三方上游源码复制进 平台仓。平台仓保存产品边界、可审计的定制补丁、验证约定与发布说明； guanghu 仅承担上游兼容与零件基线的职责。

当前界面迭代 · 冰湖视觉层

patches/ 中的补丁以系列入口恢复。0003 已包含 0001、0002， 因此不能将 0001、0002、0003 连续重复应用：

1. 0001-feat-add-Guanghu-ice-lake-visual-layer.patch
   • 为浅色与深色模式增加冰湖光层、网格层和语义颜色；
   • 升级侧栏、文档面与编辑区的视觉层次；
   • 将 HLDP 光湖入口渲染为有状态、可聚焦的路径卡片。
2. 0002-test-align-updater-coverage-with-Guanghu-policy.patch
   • 固化“光湖不使用 Tolaria 上游应用更新源”的既有策略；
   • 使更新器测试验证不联网、不下载、不重启的安全边界。
3. 0003-20260713-hololake-era-shell-prototype-series.patch
   • 登记 HoloLake Era 原型壳层与产品入口探索结果；
   • 仅作为原型证据，不代表采用重型全局皮肤。
4. 0004-20260715-tolaria-lightweight-themes-drag-fix.patch
   • 收敛为轻量、可切换的光湖配套主题；
   • 修正 macOS 顶栏间距、深色应用图标和桌面窗口拖拽；
   • 增强本地 smoke 测试在大规模模拟笔记列表中的可重复性。
5. 0005-Add-portable-callout-page-blocks.patch
   • 在 BlockNote 编辑器中增加 info / success / warning / danger 彩色提示块；
   • 以可携带 Markdown callout 语法保存，重新打开不丢失。
6. 0006-fix-make-Guanghu-home-and-themes-visible.patch
   • 首次启动默认显示 HoloLake Era 世界首页；
   • 使湖光浅色与湖心深色同步实际亮/暗模式，不再只改按钮文字。
7. 0007-feat-complete-portable-page-block-set.patch
   • 恢复 toggle heading / toggle list 折叠块入口；
   • 增加批注块、关系卡和路径包，继续复用可携带 Markdown callout 协议；
   • 保留现有代码块、引用、Mermaid、表格、白板与媒体块。
8. 0008-fix-restore-internal-note-links-and-reading-rhythm.patch
   • 将 Notion 导出的相对 Markdown 页面链接接回 Tolaria 内部导航；
   • 普通单击直接打开目标笔记，外部网址仍保留 ⌘ + 点击；
   • 增强引用提示面板、段落节奏、代码块、表格与行内代码层次。
9. 0009-test-lock-in-readable-editor-theme-defaults.patch
   • 固化更宽的阅读列与带颜色的行内代码主题默认值。
10. 0010-fix-resolve-relative-page-links-from-source-notes.patch

• 按当前笔记所在目录归一化 ../ 与 ./ 页面路径；
• 避免多个页面都叫 README.md 时跳到错误页面。

11. 0011-fix-resolve-links-inside-mounted-workspaces.patch

• 使用来源页面所属的挂载工作区解析相对路径；
• 主仓与挂载知识库同时打开时仍能跳到正确页面。

恢复与验证

git clone https://guanghubingshuo.com/code/bingshuo/guanghu.git
cd guanghu
git am /path/to/0003-20260713-hololake-era-shell-prototype-series.patch
git am /path/to/0004-20260715-tolaria-lightweight-themes-drag-fix.patch
git am /path/to/0005-Add-portable-callout-page-blocks.patch
git am /path/to/0006-fix-make-Guanghu-home-and-themes-visible.patch
git am /path/to/0007-feat-complete-portable-page-block-set.patch
git am /path/to/0008-fix-restore-internal-note-links-and-reading-rhythm.patch
git am /path/to/0009-test-lock-in-readable-editor-theme-defaults.patch
git am /path/to/0010-fix-resolve-relative-page-links-from-source-notes.patch
git am /path/to/0011-fix-resolve-links-inside-mounted-workspaces.patch
pnpm build
pnpm lint

0001、0002 保留为早期两补丁拆分档案；只有在不使用 0003 原型系列时才单独应用。上述 0003 → 0011 顺序已于 2026-07-17 在服务器最新 bingshuo/guanghu@514ab19 的新克隆上完整复现。

研发规则

• 新的页面、渲染模块和交互协议先在本目录登记，再以独立补丁落到可编译基线；
• 知识库、仓库路径、关系和编号以仓库文件为事实源，界面只做可读转译；
• UI 不保存服务器 token、密码、验证码或私钥；现实操作仍须走工单、授权、回执闭环；
• 后续模块以可安装/可移除包发布，并声明依赖、权限与兼容版本。