hololake-platform/research/progress/HLP-DEV-0005-NOTION-READING-AND-PAGE-LINK-RESTORATION.md

2.2 KiB
Raw Blame History

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
  • 桌面验收包:HoloLake Era 0.1.4 Review
  • Bundle IDcom.guanghu.desktop.review.20260717.page
  • DMG SHA-256846884e8…c66bc303a

验证

  • 回归测试先失败后修复:相对 Markdown 页面链接普通单击跳转;
  • 定向 Vitest16 项通过;
  • ESLint、TypeScript 与 Vite production build 通过;
  • Tauri Apple Silicon App 与 DMG 构建通过;
  • 原生视觉验收:元信息提示面板、段落节奏、代码块层次可见;
  • CodeScene / Codacy本机仍无 MCP、CLI 或 API 环境,未伪造结果。

全量 Vitest 运行了 4822 项,其中 4809 项通过、13 项失败2 项是主题快照预期, 已随补丁更新并通过。其余失败来自 5 个既有测试文件和本次链接、CSS 改动无直接路径, 后续应在正式依赖安装环境中单独复跑,不把它们误记为本次功能通过。