Files
momentry_studio/CHANGELOG.md
Momentry Studio e7bab6c4c6 release: v0.1.0 - Production Release
Release Date: 2026-10-11

New Documents:
- CHANGELOG.md - Complete version history
- RELEASE_v0.1.0_INSTALLATION_GUIDE.md - Installation guide for admin team
- README.md - Project overview and quick start
- build_release.sh - Automated build script

Features:
- ✅ Search pagination with "Load More" button
- ✅ Library displays 118 files correctly
- ✅ Scene VLM status visualization
- ✅ Advanced Mode toggle
- ✅ Complete architecture documentation

Release Package:
- tar.gz archive with all necessary files
- Startup/stop scripts
- Installation guide
- Checksum verification

For Admin Team:
- See RELEASE_v0.1.0_INSTALLATION_GUIDE.md
- Run ./build_release.sh to create package
- Package includes: frontend, proxy, docs, scripts
2026-10-12 09:40:44 +08:00

237 lines
6.2 KiB
Markdown

# Changelog
All notable changes to Momentry Studio will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
---
## [0.1.0] - 2026-10-11
### ✨ Features
#### Search Pagination
- **Initial search returns top 5 results** for faster response
- **"Load More" button** to fetch additional 10 results progressively
- Supports all 5 search modes: Keyword, Semantic, Visual, Agent, People
- **Deduplication logic** ensures no duplicate results across pages
- **Remaining count display** shows how many results are left
#### Library Management
- **118 files display** correctly in Library view
- **Unregistered files** show complete metadata (file_size, modified_time)
- **Scene VLM status** always visible with "—" fallback for no data
#### Pipeline Progress
- **10-stage pipeline visualization**
- Scene VLM stage added (3% weight)
- Real-time progress tracking
#### Advanced Mode Toggle
- 🔒/🔓 Toggle button for advanced features
- Controls visibility of QC buttons, marks, and advanced controls
- Persists in localStorage
---
### 🐛 Bug Fixes
#### Search Pagination
- Fixed duplicate results in "Load More" button
- Changed Visual search from `page` to `offset` parameter
- Implemented `existingIds` Set for deduplication
#### Library Display
- Fixed file count showing only 20 instead of 118
- Corrected API parameter name: `limit` → `page_size`
- Fixed `per_page` → `page_size` mismatch
#### Unregistered Files
- Added `file_size` and `modified_time` to FileItem structure
- Fixed parameter passing in `get_files` API call
---
### 🔧 Technical Improvements
#### API Layer
- Dual-mode API (Tauri IPC + HTTP) with automatic detection
- `apiCall()` function handles both desktop and browser modes
- Proper error handling and loading states
#### State Management
- Global store with `filesCache`, `thumbnailsCache`, `profilesCache`
- LRU-style thumbnail caching (max 4 concurrent requests)
- Search history and bookmarks in SQLite
#### Architecture
- **4 core modules**: Search, File Prep/Processing, Admin, File Management
- Modular Vue 3 Composition API design
- TypeScript type definitions for all data structures
---
### 📚 Documentation
#### New Documentation
- **ARCHITECTURE.md** - Complete system architecture overview
- **Agent_Search_Integration_Analysis.md** - React to Vue 3 migration guide
- **Vue3_Pagination_Implementation_Guide.md** - Complete pagination implementation
- **Quick_Implementation_Checklist.md** - 5-step quick start guide
- **Pagination_Implementation_Roadmap.md** - Implementation roadmap
#### API Documentation
- Two-API architecture clarified (v1 → Momentry Core, v2 → MarkBase)
- All endpoints documented with examples
- Error codes and troubleshooting guides
---
### 🎨 UI/UX Improvements
#### Search Interface
- Responsive search bar with mode selector
- Search history dropdown with Pin/Rename/Delete
- Bookmark system for quick access
- Result cards with thumbnails and metadata
#### Library Interface
- Collapsible sections for Completed/Registered/Unregistered files
- File status badges with icons
- Progress bars for processing files
- Processor QC buttons (Advanced Mode)
#### Video Player
- Frame-accurate seeking
- Mark timeline visualization (Advanced Mode)
- VLM description display
- Full-screen support
---
### ⚡ Performance
#### Search Performance
- Initial search: **~2s → ~0.5s** (4x faster)
- Memory usage: **Progressive loading** instead of all-at-once
- User experience: **Immediate feedback**
#### Library Performance
- Correct pagination with `page_size` parameter
- Efficient thumbnail loading with queue
- No duplicate API calls
---
### 🛠️ Build & Deployment
#### Build Process
- Vue 3 + TypeScript + Vite frontend
- Tauri 2 (Rust) desktop wrapper
- Production build: `npm run build` + `cargo tauri build`
- Development mode: `npm run dev` (proxy + vite)
#### System Requirements
- macOS 12+ (Apple Silicon or Intel)
- Node.js 18+ and npm
- Rust 1.70+ and Cargo
- PostgreSQL 14+
- Qdrant 1.6+
- Redis 7+ (optional)
---
### 🔐 Security
- API key injection by Studio proxy (never exposed to frontend)
- Per-user SQLite database in `data/users/`
- No secrets in localStorage
- HTTPS only in production
---
### 📦 Dependencies
#### Frontend
- Vue 3.5.13
- Vue Router 4.5.0
- VueUse Core 14.3.0
- Vue i18n 9.14.5
- Tauri API 2.11.0
#### Backend (Rust)
- Tauri 2.0
- Axum 0.7 (proxy server)
- SQLx 0.8 (PostgreSQL)
- Rusqlite 0.32 (SQLite)
- Reqwest 0.12 (HTTP client)
- Tokio 1.40 (async runtime)
---
### 🌐 API Endpoints
#### Momentry Core API (v1)
- `/api/v1/search/*` - Search endpoints
- `/api/v1/files/*` - File management
- `/api/v1/identities/*` - Identity management
- `/api/v1/agents/*` - Agent search
#### MarkBase API (v2)
- `/api/v2/admin/*` - Admin endpoints
- `/api/v2/myfiles/*` - File management
- `/api/v2/service/*` - Service control
#### Studio Proxy (8888)
- Gateway for v1 and v2 APIs
- Local SQLite for history/bookmarks
- Face thumbnail generation
- Identity profile images
---
### 🚀 Known Issues
1. **Visual Search API** does not support `offset` parameter (using `page_size` as fallback)
2. **Agent Search** does not have dedicated `/api/v1/agent/search` endpoint (using semantic search fallback)
3. **WebSocket** state push not implemented (using polling)
4. **Search history** limited to 30 items (no full-text search)
---
### 🎯 Next Release (0.2.0)
#### Planned Features
- WebSocket real-time state updates
- Session-based search API
- Resumable file upload
- Advanced search filters
- Multi-language support expansion
#### Performance Improvements
- IndexedDB for persistent caching
- Lazy loading for large result sets
- Service Worker for offline support
#### Architecture Improvements
- Unified API Gateway
- Plugin system for custom processors
- Multi-tenant architecture
---
## Release Team
- **Development**: Momentry Studio Team
- **QA**: Manual testing on macOS (Apple Silicon)
- **Documentation**: Complete guides and architecture docs
- **Deployment**: Production-ready on m5max48
---
**Full Changelog**: https://github.com/anomalyco/momentry_studio/compare/v0.0.1...v0.1.0
---
**Installation Guide**: See `RELEASE_v0.1.0_INSTALLATION_GUIDE.md`