af967b3345
docs: 添加 FaceFilterSettings 透明文件管理部署测试指南
...
内容:
- 完整的部署步骤
- 4 个测试场景（自动迁移、持久化、新文件、跨设备）
- API 行为变化说明
- 调试方法和故障排查
- 验证清单
测试文件: 020.mp4 (UUID: b496a68800f90770aa7246c877f38985)
相关:
- Core API: 86c776ce, 1379cf59
- Studio: 8789770f75ebfa
2026-10-09 21:14:55 +08:00
f75ebfac88
fix: 修复 Face Filter UI 参数持久化到后端数据库
...
问题:
- UI Filter Rules (min_confidence, min_bbox_size 等) 修改后只保存到 localStorage
- 不会持久化到后端数据库，导致刷新页面或换浏览器后设置丢失
修复:
- updateRules() 函数现在会调用 markSingleFrameSettingsModified()
- 触发 500ms debounce 的 auto-save 到后端 API
- 保存完整的 FaceFilterSettings (包括 ui_filter_rules, processing_thresholds, trace_settings)
变更:
1. src/composables/useFaceFilter.ts
- updateRules() 新增调用 markSingleFrameSettingsModified()
- 确保 UI Filter Rules 修改后自动保存到后端
2. docs/FACE_FILTER_PERSISTENCE_TEST_GUIDE.md
- 完整的测试指南
- 包含调试方法和后端 API 要求
持久化流程:
- FaceFilterPanel 打开 → loadSingleFrameSettings() 从后端加载
- 用户修改参数 → updateRules() → markSingleFrameSettingsModified() → auto-save
- 500ms debounce → saveSingleFrameSettings() → PUT /api/v1/file-profile
测试:
- ✅ TypeScript 编译通过
- ⏳ 需要验证后端 API 支持
测试文件: 020.mp4 (UUID: b496a68800f90770aa7246c877f38985)
2026-10-09 16:25:26 +08:00
6423eeed77
feat: 更新 FaceFilterSettings TypeScript 类型定义为三段式统一结构
...
变更内容：
- 创建 src/types/faceFilter.ts 类型定义文件
- 新增 UiFilterRules, ProcessingThresholds, TraceSettings 三个子结构
- 更新 FaceFilterSettings 为三段式统一结构
- min_confidence 范围从 0-100 改为 0.0-1.0
- min_size 重命名为 min_bbox_size
- 新增字段: max_confidence, max_bbox_size, source, backend_status
向后兼容性：
- FaceFilterSettingsMigration.fromLegacy() 自动转换旧格式
- FaceFilterSettingsMigration.defaults() 提供默认值
- 保留向后兼容字段（deprecated 标记）
更新文件：
- src/composables/useFaceFilter.ts: 使用新类型，更新变量名
- src/components/FaceFilterPanel.vue: 更新导入和变量引用
- docs/FACE_FILTER_SETTINGS_MIGRATION_GUIDE.md: 完整迁移指南
测试：
- ✅ TypeScript 编译通过
- ✅ Vite build 成功
对应 Core API commit: 86c776ce
2026-10-09 15:13:50 +08:00
2f9b44d4b3
docs: 添加 Deep Scan 队列功能需求文档
...
目的：
- 提交给 Core Team 实现后端队列功能
- 替代当前前端临时队列方案
主要内容：
1. 问题背景和当前限制
2. 核心需求说明
3. API 设计建议（包含详细示例）
4. 数据库设计
5. 后端架构建议
6. 前端集成简化方案
7. 配置选项
8. 实施里程碑
关键特性：
- 全局队列管理
- 优先级支持
- 动态并发控制
- 错误重试机制
- 实时状态跟踪
2026-10-08 01:50:38 +08:00
7b60ca3d2d
feat: add face filter components and integration guide
...
- useFaceFilter composable: manages face filtering state and API calls
- FaceFilterPanel component: UI for filtering controls
- FaceCard component: text-only face display card
- Integration guide: step-by-step guide for integrating into PeopleView
Implements hybrid filtering mode with:
- Instant mode: client-side filtering (5-10ms)
- Backend mode: server-side complex filtering
- Hybrid mode: backend + instant filtering (AND)
Uses actual Core API endpoints:
- GET /file/{uuid}/faces
- POST /file/{uuid}/faces/filter
- GET /file/{uuid}/face/{faceId}/filter-report
- GET /file/{uuid}/filter-stats
Preferences stored in localStorage.
2026-08-09 21:24:52 +08:00
5951aca086
feat: frame-based positioning and mark system foundation
...
Core Changes:
- Fix SearchView to use start_frame/end_frame directly (no time*fps conversion)
- Add hard_delete support to delete_trace API
- VideoPlayer: Main timeline + Mark system foundation
- Proxy: Add local routes for auth, media, identity-matches, cluster-results
- Add .gitignore to exclude build artifacts and dependencies
Design Documents:
- Multi-track Mark system design (.opencode/plans/)
- Video editing positioning standards research
Files Modified:
- src/views/SearchView.vue: Frame positioning, ensureMinDuration (240 frames)
- src/views/PeopleView.vue: batchDeleteGroups with hard_delete
- src/api/index.ts: delete_trace with hard_delete body
- src/components/VideoPlayer.vue: Timeline + Mark UI
- src-tauri/src/proxy.rs: New local routes
- AGENTS.md: Update documentation
2026-07-24 20:19:47 +08:00
299f58e883
docs: update cluster-agent implementation status
2026-07-20 21:49:25 +08:00
f915aaf794
feat: pending identity sorting, face detail modal, video player fps, processor counts
2026-06-24 02:02:33 +08:00
d910bac0bb
docs: People 頁面設計文件，基於實測 API 定義
2026-06-14 12:52:22 +08:00
6d6fd2d43c
docs: Core API 完整測試報告，所有端點實測驗證
2026-06-14 12:39:19 +08:00
