feat: 实现模板片段权重配置功能
新功能: - 模板片段级别的AI分类权重配置 - 权重继承机制（全局权重作为默认值） - 批量权重配置操作 - 直观的权重管理界面 后端实现: - 新增 template_segment_weights 数据表 - 实现 TemplateSegmentWeightRepository 仓储层 - 实现 TemplateSegmentWeightService 业务逻辑层 - 新增 Tauri 命令接口 前端实现: - TemplateSegmentWeightEditor 权重配置编辑器 - SegmentWeightIndicator 权重状态指示器 - BatchWeightConfigModal 批量配置模态框 - 集成到模板详情页面 测试: - 单元测试覆盖核心功能 - 集成测试验证端到端流程 - E2E测试确保用户体验 技术特性: - 权重范围：0-100，数值越大优先级越高 - 支持单个和批量更新操作 - 事务处理确保数据一致性 - 类型安全的API设计 文档: - 完整的功能文档和使用指南 - 技术架构说明 - 最佳实践建议 这个功能将显著提升模板匹配的灵活性和准确性！
This commit is contained in:
imeepos
318
docs/features/template-segment-weight-configuration.md
Normal file
318
docs/features/template-segment-weight-configuration.md
Normal file
@@ -0,0 +1,318 @@
|
||||
# 模板片段权重配置功能
|
||||
|
||||
## 概述
|
||||
|
||||
模板片段权重配置功能允许用户为每个模板片段设置不同的AI分类权重，实现更精细的素材匹配控制。该功能将权重配置从全局级别扩展到模板片段级别，提供更灵活的匹配策略。
|
||||
|
||||
## 功能特性
|
||||
|
||||
### 核心功能
|
||||
|
||||
1. **片段级权重配置**
|
||||
- 每个模板片段可以有独立的权重配置
|
||||
- 支持为不同AI分类设置不同权重值
|
||||
- 权重范围：0-100，数值越大优先级越高
|
||||
|
||||
2. **权重继承机制**
|
||||
- 新片段默认使用全局权重配置
|
||||
- 可以选择性地覆盖特定分类的权重
|
||||
- 支持重置为全局默认权重
|
||||
|
||||
3. **批量操作**
|
||||
- 批量复制权重配置到多个片段
|
||||
- 批量重置权重配置
|
||||
- 批量应用自定义权重配置
|
||||
|
||||
4. **可视化管理**
|
||||
- 直观的权重指示器
|
||||
- 实时权重预览
|
||||
- 权重配置编辑器
|
||||
|
||||
## 技术架构
|
||||
|
||||
### 后端架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Presentation Layer │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ template_segment_weight_commands.rs │
|
||||
│ - create_template_segment_weight │
|
||||
│ - get_segment_weights_with_defaults │
|
||||
│ - batch_update_template_segment_weights │
|
||||
│ - reset_segment_weights_to_global │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Business Layer │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ TemplateSegmentWeightService │
|
||||
│ - 权重继承逻辑 │
|
||||
│ - 权重验证 │
|
||||
│ - 批量操作 │
|
||||
│ - 统计信息 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Data Layer │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ TemplateSegmentWeightRepository │
|
||||
│ - CRUD操作 │
|
||||
│ - 权重映射查询 │
|
||||
│ - 批量更新 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Database │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ template_segment_weights 表 │
|
||||
│ - id, template_id, track_segment_id │
|
||||
│ - ai_classification_id, weight │
|
||||
│ - created_at, updated_at │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 前端架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ UI Components │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ TemplateSegmentWeightEditor │
|
||||
│ - 权重配置编辑界面 │
|
||||
│ - 滑块和数值输入 │
|
||||
│ - 验证和保存 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ SegmentWeightIndicator │
|
||||
│ - 权重状态指示器 │
|
||||
│ - 快速编辑入口 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ BatchWeightConfigModal │
|
||||
│ - 批量权重配置 │
|
||||
│ - 复制、重置、自定义 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Service Layer │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ TemplateSegmentWeightService │
|
||||
│ - API调用封装 │
|
||||
│ - 数据转换 │
|
||||
│ - 错误处理 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Tauri Commands │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ invoke('create_template_segment_weight', ...) │
|
||||
│ invoke('get_segment_weights_with_defaults', ...) │
|
||||
│ invoke('batch_update_template_segment_weights', ...) │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 数据模型
|
||||
|
||||
### 数据库表结构
|
||||
|
||||
```sql
|
||||
CREATE TABLE template_segment_weights (
|
||||
id TEXT PRIMARY KEY,
|
||||
template_id TEXT NOT NULL,
|
||||
track_segment_id TEXT NOT NULL,
|
||||
ai_classification_id TEXT NOT NULL,
|
||||
weight INTEGER NOT NULL DEFAULT 0,
|
||||
created_at DATETIME NOT NULL,
|
||||
updated_at DATETIME NOT NULL,
|
||||
|
||||
FOREIGN KEY (template_id) REFERENCES templates (id) ON DELETE CASCADE,
|
||||
FOREIGN KEY (track_segment_id) REFERENCES track_segments (id) ON DELETE CASCADE,
|
||||
FOREIGN KEY (ai_classification_id) REFERENCES ai_classifications (id) ON DELETE CASCADE,
|
||||
|
||||
UNIQUE(template_id, track_segment_id, ai_classification_id)
|
||||
);
|
||||
```
|
||||
|
||||
### TypeScript 类型定义
|
||||
|
||||
```typescript
|
||||
interface TemplateSegmentWeight {
|
||||
id: string;
|
||||
template_id: string;
|
||||
track_segment_id: string;
|
||||
ai_classification_id: string;
|
||||
weight: number;
|
||||
created_at: string;
|
||||
updated_at: string;
|
||||
}
|
||||
|
||||
interface CreateTemplateSegmentWeightRequest {
|
||||
template_id: string;
|
||||
track_segment_id: string;
|
||||
ai_classification_id: string;
|
||||
weight: number;
|
||||
}
|
||||
|
||||
interface BatchUpdateTemplateSegmentWeightRequest {
|
||||
template_id: string;
|
||||
track_segment_id: string;
|
||||
weights: SegmentWeightConfig[];
|
||||
}
|
||||
|
||||
interface SegmentWeightConfig {
|
||||
ai_classification_id: string;
|
||||
weight: number;
|
||||
}
|
||||
```
|
||||
|
||||
## 使用指南
|
||||
|
||||
### 基本使用
|
||||
|
||||
1. **查看权重配置**
|
||||
- 在模板详情页面的轨道标签页中
|
||||
- 每个片段显示权重指示器
|
||||
- 悬停查看详细权重信息
|
||||
|
||||
2. **编辑权重配置**
|
||||
- 点击片段的权重配置编辑按钮
|
||||
- 使用滑块或数值输入调整权重
|
||||
- 点击保存应用更改
|
||||
|
||||
3. **批量操作**
|
||||
- 在轨道标签页点击"批量权重配置"
|
||||
- 选择操作类型：复制、重置、自定义
|
||||
- 执行批量操作
|
||||
|
||||
### 高级功能
|
||||
|
||||
1. **权重继承**
|
||||
```typescript
|
||||
// 获取片段权重（包含默认值）
|
||||
const weights = await TemplateSegmentWeightService
|
||||
.getSegmentWeightsWithDefaults(templateId, segmentId);
|
||||
```
|
||||
|
||||
2. **自定义权重**
|
||||
```typescript
|
||||
// 设置自定义权重
|
||||
await TemplateSegmentWeightService.setSegmentWeights(
|
||||
templateId,
|
||||
segmentId,
|
||||
{
|
||||
'classification_1': 95,
|
||||
'classification_2': 30,
|
||||
'classification_3': 85,
|
||||
}
|
||||
);
|
||||
```
|
||||
|
||||
3. **重置权重**
|
||||
```typescript
|
||||
// 重置为全局权重
|
||||
await TemplateSegmentWeightService
|
||||
.resetSegmentWeightsToGlobal(templateId, segmentId);
|
||||
```
|
||||
|
||||
## 最佳实践
|
||||
|
||||
### 权重配置策略
|
||||
|
||||
1. **分层配置**
|
||||
- 全局权重作为基础配置
|
||||
- 模板级权重用于特殊需求
|
||||
- 片段级权重用于精细控制
|
||||
|
||||
2. **权重值设置**
|
||||
- 0-20：低权重，较少使用
|
||||
- 21-50：中等权重，常规使用
|
||||
- 51-80：高权重，优先使用
|
||||
- 81-100：最高权重，强制优先
|
||||
|
||||
3. **批量操作**
|
||||
- 使用模板复制快速配置相似片段
|
||||
- 定期重置不需要的自定义配置
|
||||
- 使用统计信息监控配置状态
|
||||
|
||||
### 性能优化
|
||||
|
||||
1. **缓存策略**
|
||||
- 权重配置会被缓存以提高查询性能
|
||||
- 修改后自动刷新相关缓存
|
||||
|
||||
2. **批量操作**
|
||||
- 使用批量API减少网络请求
|
||||
- 事务处理确保数据一致性
|
||||
|
||||
3. **索引优化**
|
||||
- 数据库索引优化查询性能
|
||||
- 复合索引支持复杂查询
|
||||
|
||||
## 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **权重配置不生效**
|
||||
- 检查权重值是否在有效范围内（0-100）
|
||||
- 确认AI分类是否激活
|
||||
- 验证模板和片段ID是否正确
|
||||
|
||||
2. **批量操作失败**
|
||||
- 检查目标片段是否存在
|
||||
- 验证权重配置是否有效
|
||||
- 查看错误日志获取详细信息
|
||||
|
||||
3. **性能问题**
|
||||
- 检查数据库索引是否正常
|
||||
- 监控权重配置数量
|
||||
- 考虑清理无用的配置
|
||||
|
||||
### 调试工具
|
||||
|
||||
1. **日志记录**
|
||||
```rust
|
||||
// Rust 后端日志
|
||||
tracing::info!("权重配置更新: template={}, segment={}", template_id, segment_id);
|
||||
```
|
||||
|
||||
2. **前端调试**
|
||||
```typescript
|
||||
// 开发者工具中查看权重配置
|
||||
console.log('Current weights:', weights);
|
||||
```
|
||||
|
||||
3. **数据库查询**
|
||||
```sql
|
||||
-- 查看片段权重配置
|
||||
SELECT * FROM template_segment_weights
|
||||
WHERE template_id = 'template_id' AND track_segment_id = 'segment_id';
|
||||
```
|
||||
|
||||
## 更新日志
|
||||
|
||||
### v1.0.0 (2024-01-01)
|
||||
- 初始版本发布
|
||||
- 基础权重配置功能
|
||||
- 权重继承机制
|
||||
- 批量操作支持
|
||||
- 可视化管理界面
|
||||
|
||||
### 未来计划
|
||||
|
||||
1. **权重模板**
|
||||
- 预定义权重配置模板
|
||||
- 快速应用常用配置
|
||||
|
||||
2. **智能推荐**
|
||||
- 基于历史数据推荐权重配置
|
||||
- 自动优化权重设置
|
||||
|
||||
3. **高级分析**
|
||||
- 权重配置效果分析
|
||||
- 匹配成功率统计
|
||||
|
||||
## 相关文档
|
||||
|
||||
- [AI分类管理](./ai-classification-management.md)
|
||||
- [模板匹配算法](./template-matching-algorithm.md)
|
||||
- [素材管理系统](./material-management-system.md)
|
||||
- [开发规范](../development/coding-standards.md)
|
||||
Reference in New Issue
Block a user