# 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`
   - 使用来源页面所属的挂载工作区解析相对路径；
   - 主仓与挂载知识库同时打开时仍能跳到正确页面。

## 恢复与验证

```bash
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、密码、验证码或私钥；现实操作仍须走工单、授权、回执闭环；
- 后续模块以可安装/可移除包发布，并声明依赖、权限与兼容版本。