Momentry Studio
bb374dd374
发布内容：
- Tauri Desktop App (.app bundle + DMG)
- Core API Binary (momentry-core)
- Proxy Binary (momentry-proxy)
- 完整文档（README, RELEASE_NOTES, 安装指南, 部署指南）
新功能：
- 批量 Deep Scan（并发控制 + 队列显示）
- 批量 Unregister
- Face Filter 自动保存（500ms 防抖）
- Registered 卡片 Checkbox 修复
- MarkBase Engine 健康检查修复
- FS Name 唯一性修复
发布包：
- 文件名: momentry-studio-v0.1.0-macos-aarch64.tar.gz
- 大小: 37MB
- SHA256: 154ef0e02a6199278ea6bc6a5073d11c631527f2825ba78ceeafcb5f486cf969
平台: macOS (Apple Silicon)
构建日期: 2026-10-08
Git Commit: 8e71996
251 lines
6.1 KiB
Markdown
251 lines
6.1 KiB
Markdown
# Momentry Studio v0.1.0 Release Notes
|
||
|
||
**发布日期：** 2026-10-08
|
||
**构建类型：** Production Release
|
||
**平台：** macOS (Apple Silicon)
|
||
|
||
---
|
||
|
||
## 📦 发布包内容
|
||
|
||
### 1. Tauri Desktop Application
|
||
- **Momentry Studio.app** - macOS 原生桌面应用
|
||
- **Momentry Studio_0.1.0_aarch64.dmg** - DMG 安装包
|
||
|
||
### 2. Backend Services
|
||
- **momentry-core** - Core API server binary
|
||
- **momentry-proxy** - HTTP proxy server binary
|
||
|
||
---
|
||
|
||
## ✨ 新功能
|
||
|
||
### 1. 批量操作增强
|
||
|
||
**批量 Deep Scan：**
|
||
- 在 Registered 和 Completed section 添加批量 Deep Scan 按钮
|
||
- 使用 p-limit 控制并发（maxConcurrent = 2）
|
||
- 超过并发的文件自动排队
|
||
- 实时显示队列状态：`Processing 1/5 (3 queuing, 2 active)...`
|
||
|
||
**批量 Unregister：**
|
||
- 在 Registered 和 Completed section 添加批量 Unregister 按钮
|
||
- 支持确认对话框
|
||
- 显示成功/失败统计
|
||
|
||
### 2. Face Filter 自动保存
|
||
|
||
**实时自动保存（500ms 防抖）：**
|
||
- 修改后自动保存到后端数据库
|
||
- 离开页面时自动保存未保存的修改
|
||
- 组件卸载时清理定时器
|
||
- 显示自动保存状态：`✓ Auto-saved` 或 `⏳ Saving...`
|
||
|
||
### 3. Registered 卡片 Checkbox 修复
|
||
|
||
**修复问题：**
|
||
- toggleSelect 函数使用正确的 key（file_uuid）
|
||
- 修复 HTML 缩进问题
|
||
- 确保勾选功能正常工作
|
||
|
||
---
|
||
|
||
## 🐛 Bug 修复
|
||
|
||
### 1. MarkBase Engine 健康检查修复
|
||
|
||
**问题：**
|
||
- Admin 页面显示 MarkBase Engine 为 `offline`
|
||
- 实际服务正在运行
|
||
|
||
**修复：**
|
||
- 支持 JSON 和纯文本格式的健康检查响应
|
||
- 根据 Content-Type 判断响应格式
|
||
- 从 JSON 提取 version 和 uptime 信息
|
||
|
||
### 2. FS Name 唯一性问题修复
|
||
|
||
**问题：**
|
||
- 两个自动命名源导致名称混乱
|
||
- Person_X 和 Face Trace X 格式并存
|
||
|
||
**修复：**
|
||
- 移除所有自动命名逻辑
|
||
- 新 traces 默认为 "Unassigned"
|
||
- 统一 trace_profiles.name 为唯一名称来源
|
||
|
||
### 3. 性能优化
|
||
|
||
**并发控制：**
|
||
- thumbnail 并发数从 32 降到 10
|
||
- search_agents API timeout 提升到 90s
|
||
|
||
**排序优化：**
|
||
- scanning/preparing 文件优先显示
|
||
- 改进用户体验
|
||
|
||
---
|
||
|
||
## 📋 系统要求
|
||
|
||
### macOS
|
||
- macOS 12.0 (Monterey) 或更高版本
|
||
- Apple Silicon (M1/M2/M3) 或 Intel (需单独构建)
|
||
- 4GB RAM minimum, 8GB recommended
|
||
- 1GB 可用磁盘空间
|
||
|
||
### 依赖服务
|
||
- PostgreSQL 14+
|
||
- Qdrant (v1.7+)
|
||
- MarkBase Core API (v2.3+)
|
||
- MarkBase Engine (v1.0+)
|
||
|
||
---
|
||
|
||
## 🚀 安装指南
|
||
|
||
### 方法 1: DMG 安装（推荐）
|
||
|
||
1. 下载 `Momentry Studio_0.1.0_aarch64.dmg`
|
||
2. 双击打开 DMG 文件
|
||
3. 拖拽 "Momentry Studio.app" 到 Applications 文件夹
|
||
4. 从 Applications 启动应用
|
||
|
||
### 方法 2: 直接使用 .app
|
||
|
||
1. 复制 "Momentry Studio.app" 到 Applications 文件夹
|
||
2. 首次运行可能需要在"系统偏好设置 > 安全性与隐私"中允许运行
|
||
|
||
---
|
||
|
||
## ⚙️ 配置
|
||
|
||
### 环境变量
|
||
|
||
**Momentry Core API：**
|
||
```bash
|
||
export MOMENTRY_API_KEY=your_api_key_here
|
||
export DATABASE_URL=postgres://user:password@localhost:5432/momentry
|
||
```
|
||
|
||
**Momentry Proxy：**
|
||
```bash
|
||
export MOMENTRY_API_KEY=your_api_key_here
|
||
export MOMENTRY_DATA_DIR=/path/to/data/users
|
||
```
|
||
|
||
### 配置文件
|
||
|
||
**momentry.toml (Core API)：**
|
||
```toml
|
||
[server]
|
||
host = "0.0.0.0"
|
||
port = 3002
|
||
|
||
[database]
|
||
url = "postgres://user:password@localhost:5432/momentry"
|
||
|
||
[face_settings]
|
||
min_confidence = 0.5
|
||
min_bbox_size = 80
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 部署指南
|
||
|
||
### 1. 启动 Core API
|
||
|
||
```bash
|
||
./momentry-core server --host 0.0.0.0 --port 3002
|
||
```
|
||
|
||
### 2. 启动 Proxy（如果需要独立部署）
|
||
|
||
```bash
|
||
./momentry-proxy
|
||
```
|
||
|
||
### 3. 启动 Tauri 应用
|
||
|
||
- 双击 "Momentry Studio.app" 启动
|
||
- 或从终端运行：`open "Momentry Studio.app"`
|
||
|
||
---
|
||
|
||
## 📊 服务架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────┐
|
||
│ Momentry Studio (Tauri App) │
|
||
│ ┌─────────────┐ ┌────────────────┐ │
|
||
│ │ Frontend │───▶│ Proxy (Rust) │ │
|
||
│ │ (Vue 3) │ │ Port 8888 │ │
|
||
│ └─────────────┘ └────────────────┘ │
|
||
└─────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
┌───────────────────────────┐
|
||
│ Momentry Core API │
|
||
│ Port 3002 │
|
||
│ - Files │
|
||
│ - Faces │
|
||
│ - Search │
|
||
└───────────────────────────┘
|
||
│
|
||
┌───────────────┴───────────────┐
|
||
▼ ▼
|
||
┌──────────┐ ┌──────────┐
|
||
│PostgreSQL│ │ Qdrant │
|
||
│ Port 5432│ │Port 6333 │
|
||
└──────────┘ └──────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 已知问题
|
||
|
||
1. **批量 Deep Scan 队列**
|
||
- 当前前端临时实现，未来需要后端队列支持
|
||
- 参考：`docs/DEEP_SCAN_QUEUE_FEATURE_REQUEST.md`
|
||
|
||
2. **System Stats Validation**
|
||
- 已暂时禁用，待后续修复
|
||
|
||
---
|
||
|
||
## 📝 版本历史
|
||
|
||
**v0.1.0 (2026-10-08)**
|
||
- 初始正式发布版本
|
||
- 包含所有核心功能
|
||
- 批量操作增强
|
||
- Face Filter 自动保存
|
||
- 多项 Bug 修复
|
||
|
||
---
|
||
|
||
## 🛠️ 技术栈
|
||
|
||
- **Frontend**: Vue 3 + TypeScript + Vite
|
||
- **Desktop**: Tauri 2 (Rust backend)
|
||
- **Backend**: Rust (Axum, SQLx)
|
||
- **Database**: PostgreSQL 14+
|
||
- **Search Engine**: Qdrant
|
||
- **Build**: Cargo + npm
|
||
|
||
---
|
||
|
||
## 📞 支持联系
|
||
|
||
- **技术支持**: tech@momentry.ai
|
||
- **Bug 报告**: https://github.com/momentry/studio/issues
|
||
- **文档**: https://docs.momentry.ai
|
||
|
||
---
|
||
|
||
## 📜 许可证
|
||
|
||
Proprietary Software - All Rights Reserved
|
||
|