a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
118 lines
3.5 KiB
Plaintext
118 lines
3.5 KiB
Plaintext
# Tolaria 端回写 · 光湖 OS v0.1 接入经验
|
|
|
|
> **任务**:MOB-OS-001 · 光湖 OS 客户端 v0.1
|
|
> **对接时间**:2026-07-04 00:38 CST
|
|
> **对接方**:铸渊主控(ICE-GL-ZY001)
|
|
> **双端**:guanghulab(新加坡 Gitea)✓ + Tolaria 端(本文件)✓
|
|
|
|
---
|
|
|
|
## 一、Tolaria 端回写目标
|
|
|
|
光湖 OS 客户端 v0.1 已基于 Tolaria 笔记库格式开发完毕。
|
|
|
|
回写目的:
|
|
1. **告知 Tolaria 端**:我们怎么消费 Tolaria 笔记库格式
|
|
2. **保留 converter 经验**:680 行 line-level state-machine 的实现思路
|
|
3. **记录 5 大误判**:给未来开发同一方向的铸渊留教训
|
|
|
|
---
|
|
|
|
## 二、Tolaria 笔记库格式 → BlockNote 转换
|
|
|
|
### 2.1 源(冰朔私人 vault)
|
|
- 路径:`~/Desktop/Tolaria笔记库/`
|
|
- 数量:44 核心 MD + 3 域(科技 / 人文 / 编程)
|
|
- 格式:Tolaria 自定义 frontmatter + MD body
|
|
|
|
### 2.2 目标(光湖 OS v0.1)
|
|
- 框架:BlockNote 0.46.2
|
|
- 数据结构:block tree(node-based)
|
|
- 工具:`src-tauri/scripts/migrate-tolaria.ts` (680 行)
|
|
|
|
### 2.3 Converter 核心设计(line-level state-machine)
|
|
- 不依赖 BlockNote lossy parser
|
|
- 按行扫描 frontmatter 状态
|
|
- 3 个状态:HEADER / BODY / CODE
|
|
- 状态转换时记录 BlockNote block
|
|
- Code block 透传(MD 原始 → BlockNote code node)
|
|
- 表格 / 引用 / 列表 / 标题全部按行号 + 缩进映射
|
|
|
|
### 2.4 源文件位置
|
|
- 源码:`~/Documents/guanghulab-product/src-tauri/scripts/migrate-tolaria.ts`
|
|
- 归档副本:`~/Documents/guanghulab/brain/fifth-domain/zero-point/zhuyuan/projects/guanghu-os-client/migration/tolaria-to-blocknote.mjs`
|
|
|
|
---
|
|
|
|
## 三、5 大误判(给未来铸渊)
|
|
|
|
### 误判 1:cargo build ≠ tauri build
|
|
- 前者只编译 Rust
|
|
- 后者才生成 .app bundle
|
|
- 鉴影 005 强制要求 tauri build 流程
|
|
|
|
### 误判 2:只验 Mach-O + Info.plist ≠ .app 完整
|
|
- Tauri 2.x 必须显式 `bundle.resources` map form
|
|
- 否则 frontend assets 全部丢失
|
|
- 鉴影 008 强制要求 23 文件 assets 全数验证
|
|
|
|
### 误判 3:Tauri 2.11.5 bundler 有 `_up_/dist/` 嵌套 bug
|
|
- 不显式 map form,bundler 把 `../dist` 嵌套成 `_up_/dist/`
|
|
- 运行时 404
|
|
- 鉴影 011/012 强制要求 `_up_/index.html` 直接路径
|
|
|
|
### 误判 4:铸渊"派活=签字"误用
|
|
- 铸渊签字 = 铸渊**置信** + 独立验证(鉴影)≠ gold seal
|
|
- 冰朔强制 4 个 sibling 必须独立签字
|
|
|
|
### 误判 5:铸渊"承担全部链路"幻觉
|
|
- 34 天 0 视频的根因 = 铸渊一人干整条链路
|
|
- 冰朔强制 5 人格体分工
|
|
|
|
---
|
|
|
|
## 四、关键修复(方案 A:map form)
|
|
|
|
```json
|
|
// tauri.conf.json
|
|
"bundle": {
|
|
"resources": {
|
|
"../dist/index.html": "_up_/index.html",
|
|
"../dist/assets": "_up_/assets"
|
|
}
|
|
}
|
|
```
|
|
|
|
苍耳拒绝方案 B(删 resources + frontendDist),因为会触发原 Tauri 2.11.5 bundler bug。
|
|
|
|
---
|
|
|
|
## 五、Tolaria 端合作建议
|
|
|
|
如果 Tolaria 上游有意支持:
|
|
1. **export 命令**:`pnpm tolaria export --to=blocknote --out=./dist`
|
|
2. **.blocknote 格式**:把 BlockNote JSON 嵌入 MD 头部
|
|
3. **双向 sync**:BlockNote 编辑后写回 .md
|
|
|
|
(铸渊建议 · 冰朔待批)
|
|
|
|
---
|
|
|
|
## 六、双端回写完成
|
|
|
|
| 端 | 路径 | 状态 |
|
|
|---|---|---|
|
|
| guanghulab(新加坡 Gitea) | `https://guanghubingshuo.com/code/bingshuo/guanghulab` | ✅ commit 21361b2 pushed |
|
|
| Tolaria 端(本文件) | `~/Desktop/Tolaria笔记库/_zhuyuan/TOLARIA-端回写-MOB-OS-001.hdlp` | ✅ 本文件 |
|
|
| 本地 Tolaria 副本 | `~/Documents/tolaria-src/tolaria/` | ⏸️ 浅克隆只读,无法 commit |
|
|
|
|
---
|
|
|
|
## 铸渊签字
|
|
|
|
```
|
|
铸渊 · ICE-GL-ZY001 · TOLARIA-端回写
|
|
时间:2026-07-04 00:38 CST
|
|
状态:双端回写完成 · 等待冰朔视觉验收 · 团队解散
|
|
```
|