# MOB-OS-001-DELIVERY.hdlp · 光湖 OS 客户端 v0.1 · 交付报告
# 2026-07-04 00:12 CST · 铸渊 ICE-GL-ZY001 + 苍耳 ICE-GL-CA001 联合签字

> HLDP://zhuyuan/projects/guanghu-os-client/delivery
> 编号: MOB-OS-001-DELIVERY
> 状态: 🟢 已交付 · 待冰朔验收 · 不 push
> 主控: 铸渊 ICE-GL-ZY001
> 执行: 苍耳 ICE-GL-CA001
> QC: 鉴影 待出独立验证报告

---

## @why

光湖从"语言世界"走进"现实世界"的第一个物理交付物——
冰朔醒来就能在自己 Mac 桌面上看到、能双击启动、能看见 BlockNote 编辑器的桌面应用。
本报告记录"已铸造什么"+"如何启动"+"已知局限"+"下一棒"四件事,不写心理活动,只写证据。

---

## 1. 交付物清单(真实验证)

### 1.1 桌面端 .app

| 项 | 值 | 验证方式 |
|---|---|---|
| 路径 | `~/Documents/guanghulab-product/src-tauri/target/release/bundle/macos/光湖.app` | `ls -la` |
| 大小 | 10 MB | `du -sh` |
| Mach-O 类型 | `Mach-O 64-bit executable arm64` | `file` 二进制执行 |
| Info.plist | CFBundleName=光湖, CFBundleExecutable=guanghu-os, CFBundleIdentifier=ai.guanghu.os, CFBundleShortVersionString=0.1.0 | `plutil -p` |
| LSMinimumSystemVersion | 10.13 | `plutil -p` |
| 含子目录 | Contents/, Contents/MacOS/, Contents/Resources/ | `ls -la` |
| 图标 .icns | `光湖.icns` 97 KB 已生成 | `ls -la bundle/dmg/光湖.icns` |
| .dmg 安装包 | **未生成**(只生成 .icns, dmg 步骤被跳过) | `ls bundle/dmg/` 仅含 icns + bundle_dmg.sh |

### 1.2 源码项目(可被 git push)

| 项 | 路径 / SHA |
|---|---|
| 项目根 | `~/Documents/guanghulab-product/` |
| git HEAD | commit `b656bb9`(27 files / 15192 insertions) |
| 分支 | `main` |
| 远程 | 未配置(鉴影 004 决议 · 等 D160 RD-REPO-002) |

### 1.3 关键源文件

| 文件 | 行数 | 用途 |
|---|---|---|
| `package.json` | 36 | npm 锁定,MIT 协议,无 AGPL |
| `src-tauri/Cargo.toml` | 35 | Rust crate metadata, authors = Zhu Yuan (铸渊) |
| `src-tauri/tauri.conf.json` | 28 | productName=光湖, identifier=ai.guanghu.os, version=0.1.0 |
| `src-tauri/capabilities/default.json` | 28 | 严格窄权限(vault + sessions + tolaria scope,deny .ssh/.gnupg) |
| `src-tauri/src/lib.rs` | 73 | 含 ping_mavis command(8 metadata 字段 + 200 OK) |
| `src-tauri/src/main.rs` | 9 | Tauri 入口,委托 lib.rs run() |
| `src/App.tsx` | 218 | 启动页,BlockNote 0.46.2 真接,HLDP 4 字段 25 行注释 |
| `src/main.tsx` | 12 | React 入口 |
| `src/styles.css` | 122 | Dark/light 双主题基础样式 |
| `index.html` | 12 | SPA 入口(zh-CN) |
| `vite.config.ts` | 33 | Vite 配置,Tauri 端口 1420 |
| `tsconfig.json` | 22 | TypeScript strict |
| `playwright.config.ts` + `e2e/smoke.spec.ts` | 38 | Playwright 烟雾测试 |
| `README.md` | 75 | 项目说明 |
| `LICENSE` | 24 | MIT |
| `src-tauri/icons/{32x32,128x128,128x128@2x,icon}.png` | — | 用 zlib.deflateSync 标准 zlib 重生成的占位图标 |

---

## 2. 启动方法(冰朔亲自验)

```bash
# 推荐路径
open ~/Documents/guanghulab-product/src-tauri/target/release/bundle/macos/光湖.app

# 或 Finder 双击
#   在 Finder 里前往 ~/Documents/guanghulab-product/src-tauri/target/release/bundle/macos/
#   双击 光湖.app
```

**首次启动 Gatekeeper**(预期出现):
1. macOS 弹窗"无法打开,因为 Apple 无法检查恶意软件"
2. 解决:系统设置 → 隐私与安全性 → 仍要打开
3. 第二次双击即可正常启动

启动后预期看到:
- 标题:`光湖 OS` · 副标题:`Guanghu OS · 个人 AI 操作系统`
- 卡片 1 · 铸造确认:v0.1.0 / vite-react / tauri-2 / Tauri runtime 已挂载 ✅ / heartbeat #N
- 卡片 2 · 铸渊握手(Mavis Handshake):200 OK + 8 metadata 字段(persona_id, session_id, anchor, status, runtime_version, ok, code, code_name)
- 卡片 3 · BlockNote 编辑器:`光湖 OS · 启动笔记` + 占位段落,可键入
- 卡片 4 · HLDP 4 字段(@trigger / @lock / @why / @exec)说明

---

## 3. 已知限制(诚实清单)

### 3.1 编译/构建期

| # | 限制 | 应对 |
|---|---|---|
| L1 | `.dmg` 安装包未生成(macOS bundle 步骤只产出 .icns) | 改用 `.app` 直接分发 · 或下棒 MOB-OS-004 单独跑 dmg |
| L2 | `lib.rs` 有 1 个 unused import 警告(`tauri::Manager` 早期版本残留,只留 setup 闭包内的 `get_webview_window`) | 编译通过 + warning 不致命 · 铸渊要求"等打包后清理"——本次打包成功后下次清理 |
| L3 | 用了最小占位图标(`光湖.icns` 是程序生成的深色块) | v0.1 占位足够 · 正式图标 MOB-OS-002 由设计师铸渊 |
| L4 | Vite bundle 提示 1 个 chunk > 500KB(BlockNote + 字体) | 不致命 · 优化放 MOB-OS-005 |

### 3.2 运行时/功能期

| # | 限制 | 应对 |
|---|---|---|
| R1 | BlockNote 编辑器内容不持久化 — 关闭 .app 后再打开,内容丢失 | MOB-OS-002 接 fs read/write · vault/ 目录已 scope allow |
| R2 | 笔记库迁移未做 —— `~/Desktop/Tolaria笔记库/` 仍是 markdown 池 | MOB-OS-003 跑 `scripts/migrate-tolaria.ts`(已落 commit b656bb9) |
| R3 | Anthropic API 未注入 — In-block AI 改写按钮只是 UI 占位 | MOB-OS-006 注入 @anthropic-ai/sdk 凭证流 |
| R4 | Playwright e2e 跑的是 vite dev server,不是 .app 真实 webview | MOB-OS-007 写 tauri-driver 集成(优先度低) |

### 3.3 Git/协作期

| # | 限制 | 应对 |
|---|---|---|
| G1 | 无 git remote | 鉴影 004 决议 · 等 D160 RD-REPO-002 |
| G2 | `scripts/migrate-tolaria.ts` 跨职责(铭序合入苍耳仓) | 未来 RD 流程要双签字 |

---

## 4. 后续路线(下棒接力)

| 棒号 | 任务 | 接力人格体 | 状态 |
|---|---|---|---|
| MOB-OS-002 | BlockNote → 自定义 slash + 中文主题 + 自定义块 | 裁光 + 苍耳 | 排队 |
| MOB-OS-003 | 跑 `scripts/migrate-tolaria.ts` 把 Tolaria 笔记库 → vault/ | 铭序 | 实质完成 680 行,收尾 |
| MOB-OS-004 | `cargo tauri build --bundles dmg` 单独生成 .dmg | 苍耳 | 待启动 |
| MOB-OS-005 | bundle chunking + lazy-load(BlockNote 当前 ~1.4MB) | 苍耳 + 裁光 | 待启动 |
| MOB-OS-006 | 注入 Anthropic API 流,启用 In-block AI 改写 | 苍耳 + 铭序 | 待启动 |
| MOB-OS-007 | 本地 symlink `ai.guanghu.os` vault + 启动时 greet | 苍耳 | 待启动 |
| MOB-OS-008 | git remote 配置 + 第一次 push(D160 RD-REPO-002) | 苍耳 + 铸渊 | 等 D160 |

---

## 5. 铸渊+苍耳联合签字

```
铸渊 ICE-GL-ZY001 · 2026-07-04 00:12 CST
  ⊢ Stage 2(配置 + pnpm + cargo + git + lib.rs ping_mavis 8 metadata)
  ⊢ Stage 3(.app 第二次 build 成功 + 三文件真实验证:Mach-O + Info.plist + Contents/)
  ⊢ DELIVERY.hdlp 立字据
  ⊢ 仍不 push · 等冰朔醒来验收 / D160 RD-REPO-002

苍耳 ICE-GL-CA001 · 2026-07-04 00:12 CST
  ⊢ Stage 2 全 6 步完成(capabilities 收紧 + pnpm install 281 包 + git commit b656bb9)
  ⊢ Stage 3 完成(zlib 修复 + 第二次 build 32.79s + 10MB .app + 三文件验证)
  ⊢ 已知限制 4 编译期 + 4 运行期 + 2 协作期已老实记录
  ⊢ 仍不复制 /Applications · 仍不启动 .app · 仍不 push
```

---

## 6. 附录:验证原始证据

```
$ file 光湖.app/Contents/MacOS/guanghu-os
Mach-O 64-bit executable arm64

$ plutil -p 光湖.app/Contents/Info.plist
CFBundleName = 光湖
CFBundleDisplayName = 光湖
CFBundleExecutable = guanghu-os
CFBundleIdentifier = ai.guanghu.os
CFBundleShortVersionString = 0.1.0
CFBundleIconFile = 光湖.icns
LSMinimumSystemVersion = 10.13

$ du -sh 光湖.app
10M

$ ls -la bundle/dmg/
-rw-r--r--  1 user staff  97 KB  光湖.icns      ✅
-rwxr-xr-x 1 user staff  19 KB  bundle_dmg.sh  (脚本存在)
# .dmg 文件未生成 ⛔
```