131 lines
3.7 KiB
Plaintext
131 lines
3.7 KiB
Plaintext
---
|
||
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组件已经完成。
|
||
- 下一步应补：斜杠菜单插入、卡片可视化编辑、编号树视图、模块注册/卸载协议。
|
||
- 官方更新可能覆盖本地定制版；更新前应先将上游变更合并进光湖版。
|
||
|
||
> ⊢ 这不是“做了头和尾”的回执。
|
||
> ⊢ 源码、测试、原生构建、桌面安装、普通点击验收、双端记录均已闭环。
|