Momentry Studio
be3cef2e0d
架构设计:
- Admin Layer: 系统管理 (admin.sqlite)
* system_config - 系统配置
* users - 用户管理
* groups - 群组管理
* permissions - 权限管理
* audit_logs - 审计日志
- Group Layer: 群组管理 (group_{id}.sqlite)
* group_config - 群组配置
* group_members - 群组成员
* group_files - 群组文件
* group_permissions - 群组权限
* group_shares - 群组共享
- User Layer: 用户数据 ({username}.sqlite)
* user_config - 用户配置
* user_files - 用户文件
* user_bookmarks - 用户书签
* search_history - 搜索历史
* video_marks - 视频标记
目录结构:
data/
├── admin/admin.sqlite
├── groups/group_{id}.sqlite
└── users/{username}.sqlite
权限模型:
- Admin: 系统管理
- Group Owner: 群组管理
- Group Member: 群组访问
- User: 个人数据
文档:
- MARKBASE_THREE_LAYER_ARCHITECTURE.md - 完整架构设计
- THREE_LAYER_IMPLEMENTATION_GUIDE.md - 实施指南
脚本:
- init_three_layer_db.sh - 数据库初始化
- check_three_layer.sh - 架构检查
预计工作量: 3-5 天
优先级: 高
Momentry Studio
Version: 0.1.0
Status: Production Release
Release Date: 2026-10-11
Overview
Momentry Studio is a video analysis platform with intelligent search capabilities, built with Vue 3, TypeScript, and Tauri 2.
Key Features
- 🔍 Multi-Mode Search: Keyword, Semantic, Visual, Agent, People
- 📄 Progressive Loading: Top 5 results initially, load more on demand
- 📚 Library Management: 118+ files with status tracking
- 🎭 Face Recognition: Identity management and clustering
- 📊 Pipeline Visualization: 10-stage processing progress
- 🎨 Advanced Mode: QC tools and detailed controls
Quick Start
Prerequisites
- Node.js 18+
- Rust 1.70+
- PostgreSQL 14+
- Qdrant 1.6+
- Momentry Core API (port 3002)
- MarkBase API (port 11438)
Installation
# Clone repository
git clone https://github.com/anomalyco/momentry_studio.git
cd momentry_studio
# Install dependencies
npm install
# Build frontend
npm run build
# Start proxy (requires Core API running)
npm run proxy
# Access: http://localhost:8888
Development
# Start dev server (proxy + vite)
npm run dev
# Access: http://localhost:5173
Desktop App
# Build native macOS app
cargo tauri build
# Output: src-tauri/target/release/bundle/dmg/momentry-studio_0.1.0_arm64.dmg
Architecture
4 Core Modules
- Search Module - Multi-mode search with history and bookmarks
- File Prep/Processing - Pipeline management and status tracking
- Admin Module - System monitoring and configuration
- File Management - Upload, download, and file organization
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Vue 3 + TypeScript + Vite |
| Desktop | Tauri 2 (Rust) |
| API Gateway | Axum (Rust) on port 8888 |
| Core API | Rust on port 3002 |
| MarkBase API | Go on port 11438 |
| Database | PostgreSQL + Qdrant + SQLite |
| Cache | Redis (optional) |
API Endpoints
Momentry Core API (v1)
/api/v1/search/*- Search operations/api/v1/files/*- File management/api/v1/identities/*- Identity management
MarkBase API (v2)
/api/v2/admin/*- Admin operations/api/v2/myfiles/*- File storage
Studio Proxy (8888)
- Gateway for v1 and v2 APIs
- Local SQLite for history/bookmarks
- Face thumbnail generation
Documentation
User Documentation
- Changelog:
CHANGELOG.md - Installation Guide:
RELEASE_v0.1.0_INSTALLATION_GUIDE.md - Architecture:
docs/ARCHITECTURE.md
Developer Documentation
- Agent Guide:
AGENTS.md - API Reference:
docs_v1.0/GUIDES/API_REFERENCE.md - Quick Start:
docs/Quick_Implementation_Checklist.md
Deployment
Production (m5max48)
# Access: https://studio.momentry.ddns.net
# SSH deployment
ssh accusys@m5max48
cd /Users/accusys/momentry_studio
git pull origin main
npm install
npm run build
pkill -f momentry-proxy
npm run proxy
Configuration
Environment Variables
Create .env file:
MOMENTRY_API_URL=http://localhost:3002
MOMENTRY_API_KEY=your_api_key_here
MARKBASE_API_URL=http://localhost:11438
DATABASE_URL=postgres://accusys@localhost:5432/momentry
QDRANT_URL=http://localhost:6333
Tauri Configuration
Edit src-tauri/tauri.conf.json for desktop app settings.
Troubleshooting
Port 8888 in Use
lsof -i :8888
kill -9 <PID>
npm run proxy
Build Errors
# Clean and rebuild
npm run build
cd src-tauri && cargo clean && cargo build --release
No Search Results
# Check Core API
curl http://localhost:3002/health
# Check database
psql -d momentry -c "SELECT COUNT(*) FROM videos;"
Support
- Issues: https://github.com/anomalyco/momentry_studio/issues
- Internal Git: http://localhost:3000/admin/momentry_studio
- Logs:
logs/studio.log,/tmp/momentry_proxy.log
Version History
v0.1.0 (2026-10-11)
- ✅ Search pagination with "Load More" button
- ✅ Library displays 118 files correctly
- ✅ Scene VLM status visualization
- ✅ Advanced Mode toggle
- ✅ Complete architecture documentation
See CHANGELOG.md for full history.
License
Proprietary - Momentry Studio Team
Team
- Development: Momentry Studio Team
- Release: Production v0.1.0
Project Status: ✅ Production Ready
Next Release: v0.2.0 (WebSocket, Session API, Resumable Upload)