# MarkBase FUSE - macOS 挂载指南

## 📋 快速开始

### 1. 挂载到 /tmp（最简单）

```bash
# 从项目根目录执行
cd /Users/accusys/markbase

# 设置库路径
export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH

# 挂载
docs/fuse_poc/markbase_v15_balanced /tmp/mb_mount

# 在 Finder 中打开
open /tmp/mb_mount
```

### 2. 挂载到 /Volumes（需要 sudo）

```bash
# 创建挂载点（需要 sudo）
sudo mkdir -p /Volumes/MarkBase

# 挂载（需要 sudo）
sudo DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH \
  docs/fuse_poc/markbase_v15_balanced /Volumes/MarkBase

# 在 Finder 中打开
open /Volumes/MarkBase
```

---

## 🔍 在 macOS Finder 中查看

### 方法1: 终端命令打开
```bash
open /tmp/mb_mount
open /Volumes/MarkBase
```

### 方法2: Finder 手动导航
1. 打开 Finder
2. 前往文件夹（Cmd+Shift+G）
3. 输入路径: `/tmp/mb_mount` 或 `/Volumes/MarkBase`
4. 按 Enter

### 方法3: Finder 边栏
- `/Volumes/MarkBase` 会自动出现在 Finder 左侧边栏
- `/tmp/mb_mount` 需要手动导航（tmp 是隐藏目录）

---

## 📁 查看文件树

```bash
# 查看根目录
ls -la /tmp/mb_mount/

# 查看 Home 文件夹
ls -la /tmp/mb_mount/Home/

# 查看 12659 个文件节点
ls -R /tmp/mb_mount/Home/ | wc -l
```

---

## 🎬 使用示例

### 1. 查看文件
```bash
# 打开视频文件（270MB）
open /tmp/mb_mount/Home/羅安禾素描自畫像.mp4

# 复制文件到本地
cp /tmp/mb_mount/Home/download-1.jpg ~/Downloads/

# 查看文件内容
cat /tmp/mb_mount/Home/readme.txt
```

### 2. Finder 操作
- 可以像普通文件夹一样浏览
- 可以拖拽文件到其他位置
- 可以双击打开文件
- 可以右键查看文件信息

---

## 🔧 卸载方法

### 方法1: 终端卸载
```bash
umount /tmp/mb_mount
umount /Volumes/MarkBase
```

### 方法2: Finder 卸载
- 右键点击挂载点 → "弹出"
- Finder 边栏点击 eject 图标

### 方法3: 强制卸载
```bash
sudo umount -f /tmp/mb_mount
```

---

## ⚠️ 注意事项

### 1. FUSE 进程
- FUSE 进程会持续运行直到卸载
- 可以用 `ps aux | grep markbase_v15` 查看进程
- 卸载后进程会自动终止

### 2. 性能建议
- 大文件读取: 使用 512KB chunks
- 并发读取: 支持 50+ 并发
- 缓存预热: 启动时缓存 1000 个大文件

### 3. 稳定性
- 已验证无 crash
- MD5 checksum 验证通过
- 支持并发读写

---

## 📊 性能测试

```bash
# 测试大文件吞吐量
dd if=/tmp/mb_mount/Home/羅安禾素描自畫像.mp4 \
   of=/tmp/test.mp4 bs=1M

# 验证 MD5
md5 /tmp/test.mp4
# Expected: f5ec6f581f74f188c51c12acad044f73

# 测试并发读取
for i in {1..50}; do 
  cp /tmp/mb_mount/Home/download-1.jpg /tmp/test_$i.jpg & 
done
wait
```

---

## 🎯 推荐挂载位置

|位置 |优势 |劣势 |
|------|------|------|
| `/tmp/mb_mount` | ✅ 不需要 sudo | ⚠️ tmp 是隐藏目录 |
| `/Volumes/MarkBase` | ✅ Finder 自动显示 | ⚠️ 需要 sudo |
| `~/MarkBase` | ✅ 用户目录 | ⚠️ 需要创建目录 |

---

## 📞 问题排查

### 问题1: 挂载失败
```bash
# 检查 FUSE-T 是否安装
ls -la /usr/local/lib/libfuse3.dylib

# 检查数据库是否存在
ls -la data/users/warren.sqlite

# 检查 binary 是否编译
ls -la docs/fuse_poc/markbase_v15_balanced
```

### 问题2: Finder 看不到
```bash
# 手动打开
open /tmp/mb_mount

# 检查挂载状态
mount | grep mb_mount
```

### 问题3: 权限问题
```bash
# 使用 sudo
sudo DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH \
  docs/fuse_poc/markbase_v15_balanced /Volumes/MarkBase
```

---

## 🎊 快速命令总结

```bash
# 启动
export DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH
docs/fuse_poc/markbase_v15_balanced /tmp/mb_mount &
open /tmp/mb_mount

# 使用
ls /tmp/mb_mount/Home/
open /tmp/mb_mount/Home/羅安禾素描自畫像.mp4

# 卸载
umount /tmp/mb_mount
```

---

**文档版本**: 1.0
**日期**: 2026-05-28
**作者**: MarkBase Team