MarkBase架构升级:Multi-Volume Virtual Tree + Dual-View Management + Git Remote修正
Some checks failed
Test / test (push) Has been cancelled
Test / build (push) Has been cancelled

核心功能:
-  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)
This commit is contained in:
Warren
2026-06-12 12:59:54 +08:00
parent 4cb7e80568
commit 1300a4e223
4559 changed files with 195840 additions and 4244 deletions

View File

@@ -0,0 +1,214 @@
# 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