1300a4e223
核心功能： - ✅ Categories/Series双视图管理（category_view.rs + import_markdown.rs） - ✅ FUSE Multi-Volume支持（tree_type参数） - ✅ SSH/SFTP/SCP/rsync协议完整实现（4042行） - ✅ NFS/SMB Module Phase 1-3完成 - ✅ Archive Module Phase 1-4完成（2916行） - ✅ Download Center API完整实现 - ✅ S3兼容API实现（560行） Git配置修正： - ✅ 删除错误origin（gitea.momentry.ddns.net） - ✅ 删除m5max128（指向机器名） - ✅ 设置origin = m5max128gitea.momentry.ddns.net/admin/markbase - ✅ 设置m4minigitea = m4minigitea.momentry.ddns.net/warren/markbase 数据清理： - ✅ 删除38个临时SQLite（保留accusys.sqlite、demo.sqlite） - ✅ 删除.bak、test_*.bin、调试脚本等临时文件 - ✅ 删除临时目录（build/、download files/、raid_test/等） - ✅ 更新.gitignore排除临时文件 架构优化： - 52个文件修改，2434行新增，4739行删除 - Workspace成员整合（16个crate） - 数据库状态：accusys.sqlite保留（主demo测试） 远程同步： - ✅ 准备推送到m5max128gitea（远程Gitea） - ✅ 准备推送到m4minigitea（本地Gitea）
215 lines
3.9 KiB
Markdown
215 lines
3.9 KiB
Markdown
# 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
|