---
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组件已经完成。
- 下一步应补：斜杠菜单插入、卡片可视化编辑、编号树视图、模块注册/卸载协议。
- 官方更新可能覆盖本地定制版；更新前应先将上游变更合并进光湖版。

> ⊢ 这不是“做了头和尾”的回执。
> ⊢ 源码、测试、原生构建、桌面安装、普通点击验收、双端记录均已闭环。