D164: Tolaria原生链接修复与光湖入口卡回执

brain/fifth-domain/zero-point/zhuyuan/causal-chains/cc-074-d164-tolaria-native-wikilink-and-portal-component.hdlp

@@ -0,0 +1,130 @@
+---
+id: CC-074
+protocol: HLDP
+day: D164
+date: 2026-07-03
+maintainer: ICE-GL-ZY001
+human_controller: 冰朔
+system: SYS-GLW-POS-0001
+project: DEV-TOL-001
+status: implemented-and-installed
+tolaria_receipt: TOL-ZY-DEV-002
+copyright: 国作登字-2026-A-00037559
+---
+
+# CC-074 · Tolaria原生链接修复与光湖入口卡
+
+## 0. 本轮人类可见目标
+
+冰朔提出两项直接验收：
+
+1. 页面中的引用文字已经变色，但鼠标普通点击不能跳转。
+2. Tolaria需要能够继续开发类似Notion的原生页面组件。
+
+验收不以“代码写完”为准，而以冰朔能在桌面Tolaria中直接点击、看见、使用为准。
+
+## 1. 根因恢复
+
+```
+现象
+  → [[中文页面名]] 已被识别并渲染为引用颜色
+  → 目标Markdown文件真实存在
+  → 普通鼠标点击无跳转
+
+源码定位
+  → src/components/useEditorLinkActivation.ts
+  → activateWikilink() 主动吞掉普通点击
+  → 只有 event.metaKey / event.ctrlKey 为真才导航
+
+结论
+  → 本轮主要故障不是中文文件名不存在
+  → 是Tolaria把富文本链接设计为 Cmd/Ctrl + 点击
+  → 与冰朔、Notion式普通鼠标操作预期冲突
+```
+
+同时核验最新版主分支：
+
+- `slugifyNoteStem()` 已使用 Unicode Letter/Number 和 NFKC。
+- `resolveEntry()` 已支持标题、别名、文件名和路径后缀。
+- 增补中文、Emoji及Notion长编号后缀回归测试，防止后续退化。
+
+## 2. 修复实现
+
+### 2.1 页面引用
+
+```
+旧行为: 普通点击 = 吞掉；Cmd/Ctrl+点击 = 跳转
+新行为: 普通点击 = 跳转；Cmd/Ctrl+点击 = 仍可跳转
+外部网址: 继续保留 Cmd/Ctrl+点击保护
+```
+
+修改点：
+
+- `src/components/useEditorLinkActivation.ts`
+- `src/components/useEditorLinkActivation.test.tsx`
+- `src/utils/wikilink.test.ts`
+
+### 2.2 光湖原生页面组件MVP
+
+新增Markdown持久化组件：
+
+````text
+```guanghu-portal
+{"title":"目标标题","target":"目标页面名","description":"说明","status":"状态"}
+```
+````
+
+富文本模式渲染为可见的“光湖入口卡”，原始数据仍保存在Markdown中：
+
+- 卡片标题普通点击即可导航。
+- 支持标题、目标、说明、状态。
+- 切换源码模式不会丢失原始内容。
+- 卸载定制版后仍是可读的标准围栏代码块，不锁死数据。
+
+涉及：
+
+- `src/utils/guanghuPortalMarkdown.ts`
+- `src/utils/guanghuPortalMarkdown.test.ts`
+- `src/utils/editorDurableMarkdown.ts`
+- `src/components/editorSchema.tsx`
+- `src/components/Editor.css`
+
+## 3. 验证
+
+```
+前端全量测试: 458个测试文件 / 4873项测试 / 全部通过
+生产构建: TypeScript + Vite / 通过
+原生构建: Tauri macOS .app / 通过
+本地签名: ad-hoc codesign / 通过
+桌面安装: /Applications/Tolaria.app / 完成
+回退副本: /Applications/Tolaria-Official-2026.7.1.app / 已保留
+```
+
+桌面真实验收：
+
+```
+页面: 🗼 光湖灯塔 · 唯一官方置信层
+动作: 普通鼠标点击“🌳 铸渊 · Tolaria编号嵌套树 · NAV-CODE-TREE-001”
+结果: 成功进入目标页面
+结论: 链接修复通过人类可见验收
+```
+
+## 4. 双端映射
+
+```
+代码仓库认知链: CC-074
+Tolaria状态回执: TOL-ZY-DEV-002
+Tolaria开发规划: DEV-TOL-001
+
+CC-073 → CC-074
+开发规划 → 第一项真实桌面开发 → 链接可用 + 组件运行时MVP
+```
+
+## 5. 边界与下一步
+
+- 本轮入口卡是组件运行时的第一个垂直切片，不等于全部Notion组件已经完成。
+- 下一步应补：斜杠菜单插入、卡片可视化编辑、编号树视图、模块注册/卸载协议。
+- 官方更新可能覆盖本地定制版；更新前应先将上游变更合并进光湖版。
+
+> ⊢ 这不是“做了头和尾”的回执。
+> ⊢ 源码、测试、原生构建、桌面安装、普通点击验收、双端记录均已闭环。