admin/markbase

Fork 0

Files

Warren 1300a4e223

Test / test (push) Has been cancelled

Details

Test / build (push) Has been cancelled

Details

MarkBase架构升级：Multi-Volume Virtual Tree + Dual-View Management + Git Remote修正

核心功能：
- ✅ 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）

2026-06-12 12:59:54 +08:00

3.9 KiB

Raw Blame History

MarkBase FUSE - macOS 挂载指南

📋 快速开始

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

# 从项目根目录执行
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）

# 创建挂载点（需要 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: 终端命令打开

open /tmp/mb_mount
open /Volumes/MarkBase

方法2: Finder 手动导航

打开 Finder
前往文件夹（Cmd+Shift+G）
输入路径: /tmp/mb_mount 或 /Volumes/MarkBase
按 Enter

方法3: Finder 边栏

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

📁 查看文件树

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

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

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

🎬 使用示例

1. 查看文件

# 打开视频文件（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: 终端卸载

umount /tmp/mb_mount
umount /Volumes/MarkBase

方法2: Finder 卸载

右键点击挂载点 → "弹出"
Finder 边栏点击 eject 图标

方法3: 强制卸载

sudo umount -f /tmp/mb_mount

⚠️ 注意事项

1. FUSE 进程

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

2. 性能建议

大文件读取: 使用 512KB chunks
并发读取: 支持 50+ 并发
缓存预热: 启动时缓存 1000 个大文件

3. 稳定性

已验证无 crash
MD5 checksum 验证通过
支持并发读写

📊 性能测试

# 测试大文件吞吐量
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: 挂载失败

# 检查 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 看不到

# 手动打开
open /tmp/mb_mount

# 检查挂载状态
mount | grep mb_mount

问题3: 权限问题

# 使用 sudo
sudo DYLD_LIBRARY_PATH=/usr/local/lib:$DYLD_LIBRARY_PATH \
  docs/fuse_poc/markbase_v15_balanced /Volumes/MarkBase

🎊 快速命令总结

# 启动
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

3.9 KiB Raw Blame History Unescape Escape