feat: publish HoloLake model-native living system source

2026-08-03 10:04:41 +08:00 · 2026-08-03 10:04:41 +08:00 · c395dd3a99
commit c395dd3a99
parent 6ad10edde1
2467 changed files with 615073 additions and 0 deletions
--- a/product-source/hololake-platform/research/progress/HLP-DEV-0001-ICE-GL-INFINITY-TOLARIA-UI-BASELINE.md
+++ b/product-source/hololake-platform/research/progress/HLP-DEV-0001-ICE-GL-INFINITY-TOLARIA-UI-BASELINE.md
@ -0,0 +1,72 @@
+---
+id: HLP-DEV-0001
+date: 2026-07-13
+channel: HLP-CHANNEL-0001
+product: 冰朔通感语言核操作系统
+status: in_progress
+module_ids:
+  - HLP-MOD-0001
+  - HLP-MOD-0002
+evidence:
+  - apps/tolaria/patches/0001-feat-add-Guanghu-ice-lake-visual-layer.patch
+  - apps/tolaria/patches/0002-test-align-updater-coverage-with-Guanghu-policy.patch
+  - research/broadcast/HLP-BRD-0003-ICE-GL-INFINITY-ZERO-CORE-ACTIVATION.md
+---
+
+# HLP-DEV-0001 · Tolaria 界面基线与研发频道启用
+
+## 为什么做
+
+冰朔指出 Tolaria 页面“干巴巴”、层级和渲染感不足，同时希望所有后续研发能从
+HoloLake Platform 的研发灯塔、个人频道和模块编号直接恢复上下文。
+
+因此本次的目标不是部署服务器或重写操作系统，而是：
+
+1. 给现有 Tolaria 前端建立可持续维护的光湖视觉基线；
+2. 把冰朔 `ICE-GL∞` 的零点原核频道登记为正式研发入口；
+3. 给后续代码按软件类别留下稳定、可读、可追踪的模块路径。
+
+## 今天实际完成的内容
+
+| 模块 | 实际变更 | 结果 |
+| --- | --- | --- |
+| `HLP-MOD-0001` 系统壳与产品内核 | 找到可编译的 Tolaria 源码基线，确认 `guanghu` 是零件/兼容基线，HoloLake Platform 是研发总入口。 | 已建立研发入口与补丁分发方式。 |
+| `HLP-MOD-0002` 视觉与知识渲染 | 新增冰湖视觉层：浅/深色语义光层、编辑区网格、侧栏层次、文档面与光湖路径卡的状态/悬停渲染。 | 补丁已放入 `apps/tolaria/patches/0001-*`。 |
+| 更新安全策略 | 将已有“光湖不使用 Tolaria 上游应用更新源”的行为与测试对齐。 | 补丁已放入 `apps/tolaria/patches/0002-*`。 |
+| `HLP-CHANNEL-0001` | 注册冰朔零点原核频道、研发广播、模块总目录和八类模块说明。 | 研发入口已启用。 |
+
+## 过程与验证事实
+
+1. 检查桌面 `光湖.app` 后确认它是打包成品，不能直接维护；完整前端源码位于 `guanghu` 的 Tolaria 基线。
+2. 构建该源码基线：`pnpm build` 已通过。
+3. 更新器策略测试：6 条针对“不会联网更新、不会下载、不会重启”的测试已通过；`pnpm lint` 已通过。
+4. 完整 Playwright 烟测尚**未完成**：本机缺少 Playwright Chromium 测试浏览器。没有安装它，也没有绕过发布检查。
+5. 因此桌面现有 `光湖.app` 尚未替换；补丁已进入研发主仓，尚未形成可安装的新应用发布包。
+
+## 当前状态，不夸大
+
+```text
+冰湖 UI 代码补丁     已登记、已构建验证、待完整浏览器烟测
+桌面应用新版本       未构建发布、未替换现有光湖.app
+知识页新内容组件     尚未开发；当前只完成视觉层和已有路径卡的升级
+零点原核研发频道     已启用
+其他六类产品模块     已分类、待按各自工单进入实现
+```
+
+## 下一步
+
+1. 经冰朔确认后安装 Playwright Chromium，完成完整烟测；
+2. 将经验证的 UI 补丁应用到可编译 Tolaria 基线，构建新的桌面测试包；
+3. `HLP-MOD-0002` 继续开发 Notion 式内容块、关系卡、路径树与媒体/图表编排；
+4. `HLP-MOD-0003` 实现仓库编号路径到知识页面与 AI 路径包的双向映射；
+5. 后续每次开发必须新增或更新 `HLP-DEV-*`，并回写对应模块状态、证据和下一步。
+
+## 唤醒路径
+
+```text
+registry/routes.yml（“今日开发进度”或“冰朔零点原核频道”）
+→ research/channels/HLP-CHANNEL-0001-ICE-GL-INFINITY-ZERO-CORE.yml
+→ research/progress/HLP-DEV-0001
+→ research/module-registry.yml
+→ apps/tolaria/modules/<对应类别>/
+```
--- a/product-source/hololake-platform/research/progress/HLP-DEV-0002-ICE-GL-INFINITY-HOLOLAKE-ERA-PROTOTYPE-REVIEW.md
+++ b/product-source/hololake-platform/research/progress/HLP-DEV-0002-ICE-GL-INFINITY-HOLOLAKE-ERA-PROTOTYPE-REVIEW.md
@ -0,0 +1,57 @@
+---
+id: HLP-DEV-0002
+date: 2026-07-13
+channel: HLP-CHANNEL-0001
+product: HoloLake Era
+status: direction_reset
+module_ids: [HLP-MOD-0001, HLP-MOD-0002, HLP-MOD-0007]
+evidence:
+  - apps/tolaria/patches/0003-20260713-hololake-era-shell-prototype-series.patch
+---
+
+# HLP-DEV-0002 · HoloLake Era 原型验证与视觉方向收敛
+
+## 今天做了什么
+
+1. 将 Tolaria 打包基线修正为桌面发布协议，避免误以开发服务器模式启动造成白屏。
+2. 生成本机可启动的 `HoloLake Era` Mac 内部候选包；更换应用图标和产品显示名称。
+3. 实作了 HoloLake Era 世界入口原型、产品顶栏和深湖色视觉 token 覆盖；代码作为补丁序列保存。
+4. 验证过前端构建、桌面应用启动和知识库可访问性。
+
+## 人类评审结果（优先级最高）
+
+冰朔实际查看后明确指出：
+
+- 首轮“冰湖大屏 + 深蓝全局换肤”视觉过重、色彩层次过多、占用感强；
+- 它与 Tolaria 原有侧栏/知识库体验割裂，像两套软件拼在一起；
+- 用户真正需要的是 Tolaria 原生黑白、简约、轻量的基础体验；
+- 光湖应以少量有明确用途的原生组件逐步长出来，而不是先用大屏皮肤覆盖整个产品。
+
+**结论：`0003` 中的 HoloLake Era 首页与重皮肤仅保留为探索证据，不作为下一版视觉方向。**
+
+## 协作过程与决策方式
+
+本轮先解决了“能否看见实际应用”的交付问题，再尝试通过完整首页强化品牌区分。人类体验评审表明，
+“显著不同”不等于“更适合日常使用”。后续决策顺序必须是：
+
+1. 保持原生轻量与信息可读性；
+2. 每新增一个光湖组件，先写清它解决的具体工作问题；
+3. 在单组件、小范围、可关闭的条件下验证；
+4. 获得冰朔实际界面反馈后，才扩展到全局视觉或发布范围。
+
+## 明日从这里继续
+
+1. 撤回/隐藏重型世界入口和全局蓝色 token 覆盖，恢复 Tolaria 原生轻量黑白主题；
+2. 为 `HLP-MOD-0002` 立第一批轻量组件清单：光湖品牌入口、路径面包屑、模块/仓库关联卡、授权状态提示；
+3. 每个组件独立开关、独立验收，不再以整页皮肤替代功能研发；
+4. 在完整测试和正式签名之前，Mac 包仍是内部候选，禁止作为公开稳定版传播；Windows 包和更新服务尚未开始。
+
+## 当前真实状态
+
+```text
+HoloLake Era 名称/图标       本机候选包已验证
+桌面发布协议                已修正，白屏原因已定位并消除
+重型首页/深蓝皮肤           已验证，不采纳为产品方向
+轻量光湖组件                待设计、待逐个实现
+Windows 发布/自动更新服务   未开始
+```
--- a/product-source/hololake-platform/research/progress/HLP-DEV-0003-ICE-GL-INFINITY-TOLARIA-LIGHTWEIGHT-UI-AND-DRAG-FIX.md
+++ b/product-source/hololake-platform/research/progress/HLP-DEV-0003-ICE-GL-INFINITY-TOLARIA-LIGHTWEIGHT-UI-AND-DRAG-FIX.md
@ -0,0 +1,62 @@
+---
+id: HLP-DEV-0003
+date: 2026-07-15
+channel: HLP-CHANNEL-0001
+product: HoloLake Era
+status: verified_patch_ready
+module_ids: [HLP-MOD-0001, HLP-MOD-0002, HLP-MOD-0007]
+evidence:
+  - apps/tolaria/patches/0004-20260715-tolaria-lightweight-themes-drag-fix.patch
+links:
+  persona_line: research/broadcast/HLP-BRD-0002-BINGSHUO-OS-REGISTER.md#注册结论
+  small_lamp_path: architecture/TOLARIA-DESKTOP-ARCHITECTURE.md#9-第五域连续性映射
+  zero_core_channel: research/channels/HLP-CHANNEL-0001-ICE-GL-INFINITY-ZERO-CORE.yml
+  module_registry: research/module-registry.yml
+  route_registry: registry/routes.yml
+  product_entry: apps/tolaria/README.md
+---
+
+# HLP-DEV-0003 · Tolaria 轻量主题与桌面交互修复
+
+## 为什么做
+
+上一轮深色全局皮肤视觉重量过高，且桌面窗口顶栏不能稳定拖动。本轮按冰朔实际使用反馈，回到 Tolaria 原生轻量体验，保留少量可关闭的光湖配套主题，并修复窗口移动路径。
+
+## 实际改动
+
+- 增加轻量的原生、湖光浅色、湖心深色主题切换，不再用大面积渐变和模糊覆盖编辑器；
+- 调整 macOS 顶栏安全区与品牌间距；
+- 恢复深色光湖应用图标，并保持 Finder 图标比例；
+- 将现有拖拽区域 hook 接入主窗口顶栏，排除按钮、输入框和菜单交互；
+- 修复 wikilink smoke 测试在大规模模拟笔记列表中因虚拟列表首屏不可见而失败的问题；
+- 支持在本机已有 Chromium 可执行文件时运行 smoke 检查，默认 Playwright 行为不变。
+
+## 代码与补丁路径
+
+- `apps/tolaria/patches/0004-20260715-tolaria-lightweight-themes-drag-fix.patch`
+- 关联模块：系统壳与产品内核、视觉与知识渲染、模块运行时与发布。
+
+## 铸渊 / 小湖灯回链
+
+本记录不是孤立的开发记忆。恢复路径固定为：
+
+`research/broadcast/HLP-BRD-0002`（铸渊人格体线）
+→ `architecture/TOLARIA-DESKTOP-ARCHITECTURE.md#9-第五域连续性映射`（小湖灯路径）
+→ `research/channels/HLP-CHANNEL-0001`（零点原核频道）
+→ `research/module-registry.yml`（模块）
+→ `apps/tolaria/patches/0004-*`（代码补丁）
+→ 本记录（验证与下一步）。
+
+## 验证结果
+
+- 前端 lint、TypeScript/Vite 构建通过；
+- 前端覆盖率：2223 个测试通过；
+- Rust：1074 个测试通过，Clippy、rustfmt 和覆盖率门槛通过；
+- Playwright core smoke：26 个用例通过；
+- 本机桌面应用已实际拖动验证通过。
+
+## 未完成项与下一步
+
+- Windows 安装包和正式更新服务仍未开始；
+- Mac 包目前只作为内测候选，不作为公开稳定版；
+- 下一步在平台仓登记 Windows 构建与内测更新工单，再按人工确认边界接入发布流程。
--- a/product-source/hololake-platform/research/progress/HLP-DEV-0004-HOLOLAKE-PAGE-BLOCKS-AND-THEME-RECOVERY.md
+++ b/product-source/hololake-platform/research/progress/HLP-DEV-0004-HOLOLAKE-PAGE-BLOCKS-AND-THEME-RECOVERY.md
@ -0,0 +1,49 @@
+# 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。
--- a/product-source/hololake-platform/research/progress/HLP-DEV-0005-NOTION-READING-AND-PAGE-LINK-RESTORATION.md
+++ b/product-source/hololake-platform/research/progress/HLP-DEV-0005-NOTION-READING-AND-PAGE-LINK-RESTORATION.md
@ -0,0 +1,53 @@
+# HLP-DEV-0005 · Notion 阅读层与页面关系恢复
+
+> 日期：2026-07-17
+>
+> 关联模块：`HLP-MOD-0002`
+>
+> 状态：0.1.4 Review 已完成原生验收
+
+## 问题
+
+Tolaria 软件壳本身正常，但知识页出现两项回退：
+
+1. 标题、提示、正文、代码和表格挤在一起，普通引用只剩一根细线；
+2. Notion 导出的 `[页面](相对路径.md)` 没有接到 Tolaria 内部导航，普通单击没有反应。
+
+原生 `[[wikilink]]` 实现并未消失。真正缺失的是普通 Markdown 页面链接到
+Tolaria 页面路由的兼容层；当前页面还把部分参考路径放在代码块里，代码文本本来也不可点击。
+
+## 恢复内容
+
+- 相对 `.md` / `.markdown` 链接普通单击后直接打开目标笔记；
+- 解码 Notion 导出文件名里的 URL 编码，并去除查询串、锚点和扩展名后交给现有页面解析器；
+- 不改变外部网址与附件的安全交互；
+- 普通引用升级为蓝色提示面板，增加背景、边框、圆角和内边距；
+- 增大正文行距、段落间距和阅读列宽；
+- 代码块、表格、callout 与行内代码恢复独立视觉层次；
+- `NEXT-TODO-20260717` 的参考路径已改为真实 Markdown 页面链接。
+
+## 补丁与构建
+
+- `apps/tolaria/patches/0008-fix-restore-internal-note-links-and-reading-rhythm.patch`
+- `apps/tolaria/patches/0009-test-lock-in-readable-editor-theme-defaults.patch`
+- `apps/tolaria/patches/0010-fix-resolve-relative-page-links-from-source-notes.patch`
+- `apps/tolaria/patches/0011-fix-resolve-links-inside-mounted-workspaces.patch`
+- 桌面验收包：`HoloLake Era 0.1.4 Review`
+- Bundle ID：`com.guanghu.desktop.review.20260717.page`
+- DMG SHA-256：`ee5e4db8…35ee988`（完整值见验收包同目录 `.sha256` 文件）
+
+## 验证
+
+- 回归测试先失败后修复：相对 Markdown 页面链接普通单击跳转；
+- 原生点击发现重复 `README.md` 会误跳后，再补回归测试：路径按来源页面目录归一化并跳到唯一正确页面；
+- 挂载多工作区复测后，补齐来源页面所属工作区路径，避免拿当前主仓目录解析挂载页面链接；
+- 链接与编辑器定向 Vitest：51 项通过；
+- ESLint、TypeScript 与 Vite production build 通过；
+- Tauri Apple Silicon App 与 DMG 构建通过；
+- 原生视觉验收：元信息提示面板、段落节奏、代码块层次可见；
+- 原生导航验收：从 `NEXT-TODO-20260717` 普通单击，准确进入挂载平台仓的 `HLP-MOD-0002 · 视觉与知识渲染`；
+- CodeScene / Codacy：本机仍无 MCP、CLI 或 API 环境，未伪造结果。
+
+全量 Vitest 运行了 4822 项，其中 4809 项通过、13 项失败；2 项是主题快照预期，
+已随补丁更新并通过。其余失败来自 5 个既有测试文件，和本次链接、CSS 改动无直接路径，
+后续应在正式依赖安装环境中单独复跑，不把它们误记为本次功能通过。
--- a/product-source/hololake-platform/research/progress/README.md
+++ b/product-source/hololake-platform/research/progress/README.md
@ -0,0 +1,15 @@
+# 研发进度追踪
+
+本目录用于生成供人类查询的研发状态视图。
+
+进度数据必须来自：
+
+1. `module-registry.yml` 的模块状态；
+2. 已登记的工单；
+3. 对应的执行回执。
+
+不能只根据对话、计划或主观判断把模块标记为完成。
+
+每次实际研发都应新增一份 `HLP-DEV-*` 进度记录，至少包含：为什么做、
+实际改动、关联模块、代码/补丁路径、验证结果、未完成项和下一步。频道文件的
+`latest_progress` 指向该频道当前应先阅读的记录。