feat(server): 完善 LLM 集成基础设施与规则配置

2026-06-16 11:41:07 +08:00
parent fe2b569046
commit 66c0eb27c8
5 changed files with 207 additions and 8 deletions
@@ -0,0 +1,63 @@
+# ============================================
+# JC Video Recognize - 服务端配置模板
+# ============================================
+# 使用方法: 复制本文件为 .env 并填入真实配置
+#   cp .env.example .env
+# ⚠️ 严禁将真实 API Key / 密码 提交到 Git!
+# ============================================
+
+# --- 服务器 ---
+API_HOST=0.0.0.0
+API_PORT=8000
+
+# --- 检测 ---
+DETECTION_DEFAULT_CONFIDENCE=0.5
+DETECTION_MIN_CONFIDENCE=0.3
+
+# --- LLM 二次判断 (MVP-3) ---
+# 支持的 provider: openai (兼容协议) / mock (离线测试)
+# 火山方舟接入示例:
+#   LLM_API_BASE=https://ark.cn-beijing.volces.com/api/v3
+#   LLM_MODEL=<你在火山方舟控制台开通的 Endpoint ID>
+LLM_ENABLED=false
+LLM_PROVIDER=mock
+LLM_API_BASE=https://ark.cn-beijing.volces.com/api/v3
+LLM_API_KEY=your-api-key-here
+LLM_MODEL=doubao-vision-pro-32k
+LLM_TIMEOUT=20.0
+LLM_MAX_RETRIES=2
+LLM_MAX_TOKENS=512
+LLM_TEMPERATURE=0.0
+LLM_MAX_CONCURRENCY=2
+LLM_IMAGE_MAX_SIDE=768
+
+# --- LLM 触发器 (D26-D28) ---
+# [生产模式] 推荐: HITS=3, CONFIDENCE=0.55, COOLDOWN=20.0
+# [测试模式] 调低阈值: HITS=1, CONFIDENCE=0.1, COOLDOWN=2.0
+LLM_TRIGGER_ENABLED=true
+LLM_TRIGGER_WINDOW_SECONDS=3.0
+LLM_TRIGGER_MIN_CONSECUTIVE_HITS=3
+LLM_TRIGGER_MIN_AVG_CONFIDENCE=0.55
+LLM_TRIGGER_COOLDOWN_SECONDS=20.0
+
+# --- 融合策略 (D30) ---
+# strategy: weighted / conservative / llm_priority
+FUSION_STRATEGY=weighted
+FUSION_YOLO_WEIGHT=0.4
+FUSION_LLM_WEIGHT=0.6
+FUSION_SUPPRESS_ON_LLM_NEGATIVE=true
+FUSION_FALLBACK_TO_YOLO=true
+
+# --- 成本追踪 / 降级 (D34) ---
+# daily_budget_usd=0.0 表示不限制预算
+LLM_COST_DAILY_BUDGET_USD=0.0
+LLM_COST_ERROR_RATE_THRESHOLD=0.5
+LLM_COST_COOLDOWN_SECONDS=60.0
+
+# --- 事件引擎 ---
+EVENT_DEDUP_WINDOW_SECONDS=30.0
+EVENT_RULES_DIR=config/rules
+EVENT_MAX_ACTIVE_EVENTS=1000
+
+# --- MQTT (可选) ---
+MQTT_ENABLED=false