momentry_studio/release/RELEASE_NOTES.md

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：

export MOMENTRY_API_KEY=your_api_key_here
export DATABASE_URL=postgres://user:password@localhost:5432/momentry

Momentry Proxy：

export MOMENTRY_API_KEY=your_api_key_here
export MOMENTRY_DATA_DIR=/path/to/data/users

配置文件

momentry.toml (Core API)：

[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

./momentry-core server --host 0.0.0.0 --port 3002

2. 启动 Proxy（如果需要独立部署）

./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