Momentry Studio
14fe2eda07
确认结论:
- ClientView (/client) 使用 MarkBase API
- 文件存储位置: ~/momentry/var/sftpgo/data/{user}/
- 不是 ~/markbase 目录
架构详解:
1. API 端点
- MarkBase API: localhost:11438
- /api/v2/myfiles/{user}/folders
- /api/v2/myfiles/{user}/files
2. 文件存储
- 实际路径: ~/momentry/var/sftpgo/data/demo/
- 包含所有上传的文件 (*.mp4)
3. MarkBase 目录
- ~/markbase/data/ 存储 MarkBase 自身数据
- 认证数据库 (auth.sqlite)
- 配置文件
- 不是文件存储位置
4. 配置映射
- admin_config.json: server.storage_root
- 环境变量: STORAGE_ROOT
关键区别:
- ~/markbase = MarkBase 项目代码和自身数据
- ~/momentry/var/sftpgo/data = 实际文件存储位置
部署注意:
- 需要创建 ~/momentry/var/sftpgo/data/{user}/
- 设置正确的权限
- 配置 STORAGE_ROOT 环境变量
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)