Momentry Studio 3080c57c54 docs: 添加 2026-10-12 工作总结
完成工作:
1. ✅ 动态路径系统 - 消除硬编码路径
2. ✅ ClientView 架构确认 - 文件存储位置
3. ✅ 默认密码系统 - 每次安装唯一密码
4. ✅ 数据库依赖确认 - SQLite/PostgreSQL/Qdrant/MongoDB
5. ✅ 用户隔离问题发现 - 硬编码 demo.sqlite

关键成果:
- 完全消除硬编码 (路径 + 密码)
- 架构清晰化
- 7 个核心文档
- 4 个检查脚本

发现问题:
- ❌ 用户数据库隔离问题 (高优先级)
- ⚠️ sqlx 遗留依赖 (建议移除)

文档统计:
- CLIENTVIEW_STORAGE_ARCHITECTURE.md
- DEFAULT_PASSWORD_SYSTEM.md
- DATABASE_DEPENDENCIES.md
- DATABASE_OPTIMIZATION.md
- DATABASE_SUMMARY.md
- USER_DATABASE_ISOLATION_FIX.md
- DEPLOYMENT_CHECKLIST.md

Commits: 8 个提交
Status: ✅ 主要任务完成
2026-10-12 14:51:38 +08:00
2026-06-13 17:50:02 +08:00
2026-10-12 09:40:44 +08:00

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

  1. Search Module - Multi-mode search with history and bookmarks
  2. File Prep/Processing - Pipeline management and status tracking
  3. Admin Module - System monitoring and configuration
  4. 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


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)

Description
No description provided
Readme 1.1 GiB
Languages
D 64.9%
Rust 20.2%
Vue 9.6%
TypeScript 2.1%
CSS 1.7%
Other 1.5%