dd131ff814
Some checks are pending
Build Windows Internal Installer / Build Windows x64 internal installer (push) Waiting to run
Source snapshot: 789bd691f530f915fc870bf72ecb7c96c5d5101c
83 lines
4.5 KiB
Markdown
83 lines
4.5 KiB
Markdown
# 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、密码、验证码或私钥；现实操作仍须走工单、授权、回执闭环；
|
||
- 后续模块以可安装/可移除包发布，并声明依赖、权限与兼容版本。
|