Momentry Studio v0.1.0

视频分析和搜索平台 | Video Analysis and Search Platform

---

🎯 简介

Momentry Studio 是一个强大的视频分析和搜索平台，提供：

• ✅ 视频搜索 - 关键词搜索 + LLM 智能搜索
• ✅ 人脸识别 - 自动人脸检测、聚类和身份管理
• ✅ 文件管理 - 上传、下载、共享文件
• ✅ 用户认证 - 安全的用户管理和权限控制
• ✅ 三层架构 - Admin/Group/User 数据隔离

---

🚀 快速开始

一键安装

# 克隆代码
git clone <repo_url> momentry_studio && cd momentry_studio

# 运行安装脚本
./scripts/install.sh

# 启动应用
./start.sh

详细步骤: INSTALLATION_GUIDE.md

---

📋 系统要求

必需软件

• Node.js v18+
• Rust 1.77.2+
• PostgreSQL 12+ (带 pgvector 扩展)
• Qdrant 1.7+
• MongoDB 5+

系统资源

• CPU: 4 核心
• 内存: 8GB
• 存储: 100GB

---

📚 文档

核心文档

文档	用途
INSTALLATION_GUIDE.md	详细安装指南
QUICK_REFERENCE.md	快速参考卡片
DEPLOYMENT_CHECKLIST.md	部署检查清单

架构文档

文档	用途
DATABASE_SUMMARY.md	数据库架构概览
docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md	三层架构设计
docs/CLIENTVIEW_STORAGE_ARCHITECTURE.md	文件存储架构

系统文档

文档	用途
docs/DEFAULT_PASSWORD_SYSTEM.md	密码系统说明
docs/DATABASE_DEPENDENCIES.md	数据库依赖关系

---

🔧 功能特性

1. 视频搜索

• 关键词搜索 - 基于字幕和语音转文字
• LLM 搜索 - 自然语言查询
• 多维度过滤 - 时间、人物、场景

2. 人脸识别

• 自动检测 - 视频中的人脸
• 智能聚类 - 相同人脸分组
• 身份管理 - 命名和管理人脸

3. 文件管理

• 上传下载 - 支持 SMB/SFTP
• 文件夹管理 - 创建、移动、删除
• 文件共享 - 群组内共享

4. 用户认证

• 安全登录 - Argon2id 密码哈希
• 权限控制 - 多层级权限
• 审计日志 - 操作记录

---

🏗️ 架构设计

三层架构

Admin Layer (系统管理)
  └─ admin.sqlite
      ├─ 系统配置
      ├─ 用户管理
      ├─ 群组管理
      └─ 权限管理

Group Layer (群组管理)
  └─ group_{id}.sqlite
      ├─ 群组配置
      ├─ 群组成员
      ├─ 群组文件
      └─ 群组权限

User Layer (用户数据)
  └─ {username}.sqlite
      ├─ 用户文件
      ├─ 搜索历史
      ├─ 书签
      └─ 个人设置

详细设计: docs/MARKBASE_THREE_LAYER_ARCHITECTURE.md

---

📂 目录结构

momentry_studio/
├── src/                    # 前端源代码 (Vue 3 + TypeScript)
├── src-tauri/              # 后端源代码 (Rust + Tauri)
├── public/                 # 静态资源
├── config/                 # 配置模板
├── scripts/                # 工具脚本
├── docs/                   # 文档
├── data/                   # 数据目录
│   ├── admin/              # Admin 数据库
│   ├── groups/             # Group 数据库
│   └── users/              # User 数据库
└── release/                # 发布包

---

🛠️ 开发指南

环境设置

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build

# Tauri 应用
cargo tauri dev

数据库管理

# 初始化数据库
./scripts/init_three_layer_db.sh

# 检查数据库
./scripts/check_three_layer.sh

# 用户管理
./src-tauri/target/release/user_tool list

---

📊 数据库架构

Momentry Studio

• SQLite - 本地数据 (搜索历史、书签、用户认证)

Momentry Core

• PostgreSQL - 核心业务数据 (文件、人脸、身份)
• Qdrant - 向量搜索 (语义搜索、人脸嵌入)
• MongoDB - 文档存储 (分析结果、大对象)

详细说明: docs/DATABASE_DEPENDENCIES.md

---

🚢 部署

生产部署

# 1. 准备环境
./scripts/install.sh

# 2. 配置
vim .env

# 3. 构建
cargo tauri build

# 4. 部署
./start.sh

检查清单

• 所有服务运行中
• 数据库已初始化
• 默认密码已修改
• 权限已配置
• 备份已设置

详细清单: DEPLOYMENT_CHECKLIST.md

---

🔑 默认账号

管理员

• 用户名: admin
• 密码: admin123
• 角色: 系统管理员

普通用户

• 用户名: demo
• 密码: 查看安装输出或 .env 文件
• 角色: 普通用户

安全建议: 立即修改默认密码！

---

📖 API 文档

Momentry Core API

• 地址: http://localhost:3002
• 文档: docs/ADMIN_API_REFERENCE.md

MarkBase API

• 地址: http://localhost:11438
• 文档: docs/MARKBASE_SERVICE_MANAGEMENT.md

Studio 代理

• 地址: http://localhost:8888
• 路由:
  • /api/v1/* → Momentry Core API
  • /api/v2/* → MarkBase API

---

🧪 测试

功能测试

# 启动应用
./start.sh

# 测试搜索
curl http://localhost:8888/api/v1/search-history

# 测试文件管理
curl http://localhost:11438/api/v2/myfiles/demo/files

系统检查

# 数据库检查
./scripts/check_db_dependencies.sh

# 架构检查
./scripts/check_three_layer.sh

---

🔄 版本历史

v0.1.0 (2026-10-12)

新功能:

• ✅ 视频搜索和分析
• ✅ 人脸识别和管理
• ✅ 文件管理
• ✅ 用户认证
• ✅ 三层架构设计

改进:

• ✅ 动态路径系统
• ✅ 动态密码系统
• ✅ 用户管理工具

已知问题:

• ⚠️ 用户数据库隔离需要修复
• ⚠️ sqlx 遗留依赖需要移除

---

v0.2.0 (计划中)

• 实现三层架构代码
• 修复用户数据库隔离
• Admin 管理界面
• Group 管理界面
• 完善权限系统

---

🤝 贡献

开发流程

1. Fork 仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

代码规范

• 前端: ESLint + Prettier
• 后端: rustfmt + clippy
• 提交: 遵循 Conventional Commits

---

📞 支持

获取帮助

• 文档: docs/ 目录
• Issues: GitHub Issues
• Email: support@momentry.ai

报告问题

请提供以下信息:

1. 系统版本
2. 错误信息
3. 复现步骤
4. 日志文件

---

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

---

🙏 致谢

• Vue.js
• Tauri
• Rust
• PostgreSQL
• Qdrant
• MongoDB

---

版本: v0.1.0
状态: ✅ 生产就绪
更新: 2026-10-12

---

Made with ❤️ by Momentry Team