# 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