# Tolaria / 光湖 App · 研发入口

> 产品名：冰朔通感语言核操作系统的人类协作界面
>
> 研发主仓：HoloLake Platform
>
> 源码基线：`bingshuo/guanghu`（上游 Tolaria 兼容零件基线）

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

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

`patches/` 中的补丁按编号顺序应用：

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 测试在大规模模拟笔记列表中的可重复性。

## 恢复与验证

```bash
git clone https://guanghubingshuo.com/code/bingshuo/guanghu.git
cd guanghu
git am /path/to/0001-feat-add-Guanghu-ice-lake-visual-layer.patch
git am /path/to/0002-test-align-updater-coverage-with-Guanghu-policy.patch
git am /path/to/0003-20260713-hololake-era-shell-prototype-series.patch
git am /path/to/0004-20260715-tolaria-lightweight-themes-drag-fix.patch
pnpm build
pnpm lint
```

## 研发规则

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