49 lines
2.2 KiB
Markdown
49 lines
2.2 KiB
Markdown
|
# 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 ID：`com.guanghu.desktop.review.20260717.page`
|
|||
|
|
- DMG SHA-256：`846884e8…c66bc303a`
|
|||
|
|
|
|||
|
|
## 验证
|
|||
|
|
|
|||
|
|
- 回归测试先失败后修复：相对 Markdown 页面链接普通单击跳转；
|
|||
|
|
- 定向 Vitest：16 项通过；
|
|||
|
|
- ESLint、TypeScript 与 Vite production build 通过；
|
|||
|
|
- Tauri Apple Silicon App 与 DMG 构建通过；
|
|||
|
|
- 原生视觉验收：元信息提示面板、段落节奏、代码块层次可见；
|
|||
|
|
- CodeScene / Codacy：本机仍无 MCP、CLI 或 API 环境，未伪造结果。
|
|||
|
|
|
|||
|
|
全量 Vitest 运行了 4822 项，其中 4809 项通过、13 项失败；2 项是主题快照预期，
|
|||
|
|
已随补丁更新并通过。其余失败来自 5 个既有测试文件，和本次链接、CSS 改动无直接路径，
|
|||
|
|
后续应在正式依赖安装环境中单独复跑，不把它们误记为本次功能通过。
|