Your Name 0ef7650c09 feat: 审核体系全面改造 — 多维度评分 + 卖点优先级 + AI 语义匹配 + 品牌方 AI 状态通知
后端:
- 审核结果拆分为 4 个独立维度 (法规合规/平台规则/品牌安全/Brief匹配度)
- 卖点优先级从 required:bool 改为三级 (core/recommended/reference)
- AI 语义匹配卖点覆盖 + AI 整体 Brief 匹配度分析
- BriefMatchDetail 评分详情 (覆盖率+亮点+问题点)
- min_selling_points 代理商可配置最少卖点数 + Alembic 迁移
- AI 语境复核过滤误报
- Brief AI 解析 + 规则 AI 解析
- AI 未配置/异常时通知品牌方
- 种子数据更新 (新格式审核结果+brief_match_detail)

前端:
- 三端审核页面展示四维度评分卡片
- 卖点编辑改为三级优先级选择器
- BriefMatchDetail 展示 (覆盖率进度条+亮点+问题)
- min_selling_points 配置 UI
- AI 配置页未配置时静默处理
- 文件预览/下载/签名 URL 优化

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-11 19:11:54 +08:00

189 lines
5.0 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""
AI 服务工厂
根据租户配置创建和管理 AI 客户端
"""
from typing import Optional
from cachetools import TTLCache
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession
from app.models.ai_config import AIConfig
from app.services.ai_client import OpenAICompatibleClient
from app.utils.crypto import decrypt_api_key
class AIServiceFactory:
"""
AI 服务工厂
根据租户的 AI 配置创建对应的 AI 客户端
使用 TTL 缓存避免频繁创建客户端
"""
# 客户端缓存TTL 10 分钟
_cache: TTLCache = TTLCache(maxsize=100, ttl=600)
@classmethod
async def get_client(
cls,
tenant_id: str,
db: AsyncSession,
) -> Optional[OpenAICompatibleClient]:
"""
获取租户的 AI 客户端
Args:
tenant_id: 租户 ID
db: 数据库会话
Returns:
AI 客户端实例,未配置返回 None
"""
# 检查缓存
cache_key = f"ai_client:{tenant_id}"
if cache_key in cls._cache:
return cls._cache[cache_key]
# 从数据库获取配置
result = await db.execute(
select(AIConfig).where(
AIConfig.tenant_id == tenant_id,
AIConfig.is_configured == True,
)
)
config = result.scalar_one_or_none()
if config:
# 解密 API Key
api_key = decrypt_api_key(config.api_key_encrypted)
client = OpenAICompatibleClient(
base_url=config.base_url,
api_key=api_key,
provider=config.provider,
)
else:
# 回退到全局 .env 配置
from app.config import settings
if not settings.AI_API_KEY or not settings.AI_API_BASE_URL:
return None
client = OpenAICompatibleClient(
base_url=settings.AI_API_BASE_URL,
api_key=settings.AI_API_KEY,
provider=settings.AI_PROVIDER,
)
# 缓存客户端
cls._cache[cache_key] = client
return client
@classmethod
def invalidate_cache(cls, tenant_id: str) -> None:
"""
使缓存失效
当租户更新 AI 配置时调用
"""
cache_key = f"ai_client:{tenant_id}"
if cache_key in cls._cache:
del cls._cache[cache_key]
@classmethod
def clear_cache(cls) -> None:
"""清空所有缓存"""
cls._cache.clear()
@classmethod
async def get_config(
cls,
tenant_id: str,
db: AsyncSession,
) -> Optional[AIConfig]:
"""
获取租户的 AI 配置
Args:
tenant_id: 租户 ID
db: 数据库会话
Returns:
AI 配置模型,未配置返回 None
"""
result = await db.execute(
select(AIConfig).where(AIConfig.tenant_id == tenant_id)
)
return result.scalar_one_or_none()
@classmethod
async def create_or_update_config(
cls,
tenant_id: str,
provider: str,
base_url: str,
api_key_encrypted: str,
models: dict,
temperature: float,
max_tokens: int,
db: AsyncSession,
) -> AIConfig:
"""
创建或更新 AI 配置
Args:
tenant_id: 租户 ID
provider: 提供商
base_url: API 地址
api_key_encrypted: 加密的 API Key
models: 模型配置
temperature: 温度参数
max_tokens: 最大 token 数
db: 数据库会话
Returns:
更新后的配置
"""
# 查找现有配置
result = await db.execute(
select(AIConfig).where(AIConfig.tenant_id == tenant_id)
)
config = result.scalar_one_or_none()
if config:
# 更新现有配置
config.provider = provider
config.base_url = base_url
config.api_key_encrypted = api_key_encrypted
config.models = models
config.temperature = temperature
config.max_tokens = max_tokens
config.is_configured = True
else:
# 创建新配置
config = AIConfig(
tenant_id=tenant_id,
provider=provider,
base_url=base_url,
api_key_encrypted=api_key_encrypted,
models=models,
temperature=temperature,
max_tokens=max_tokens,
is_configured=True,
)
db.add(config)
await db.flush()
# 使缓存失效
cls.invalidate_cache(tenant_id)
return config
# 便捷函数
async def get_ai_client_for_tenant(
tenant_id: str,
db: AsyncSession,
) -> Optional[OpenAICompatibleClient]:
"""获取租户的 AI 客户端"""
return await AIServiceFactory.get_client(tenant_id, db)