Momentry Studio
bb45f0981a
问题: - 100+ 处硬编码路径 /Users/accusys - 配置文件 (admin_config.json) 无法适应新环境 - Rust 代码 (main.rs) 中 10+ 处路径硬编码 - 服务启动/停止命令依赖固定路径 影响: - 无法在 m4promini (/Users/nextorageai) 上部署 - Admin 页面服务控制失效 - Worker 管理失败 解决方案: 1. 文档: docs/DEPLOYMENT_PATH_ISSUES.md - 详细分析所有硬编码路径 - 提供 3 种修复方案 - 环境变量优先级建议 2. 脚本: fix_paths_for_m4promini.sh - 自动替换所有硬编码路径 - 创建备份 - 生成环境变量模板 - 创建部署说明 目标环境: - 用户: nextorageai - 主目录: /Users/nextorageai - 项目目录: /Users/nextorageai/momentry_studio 下一步: 1. 在 m4promini 上运行 fix_paths_for_m4promini.sh 2. 配置环境变量 (.env) 3. 构建项目 4. 启动服务
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)