---
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 构建与内测更新工单，再按人工确认边界接入发布流程。