feat: 2026-07-12~13 全量更新 - AI对话链路改造+H5 v4/v5+坐席端v5+上下文感知诊断+知识库迭代3

## H5 员工端 v4 (2026-07-13 00:48 已部署) - 人工按钮三态文案统一为"人工坐席" - 按钮位置移至发送键和语音按钮上方(垂直堆叠) - 点按钮直接调 store.shakeAgent()，删除 CallAgentModal 弹窗动画 - 截图快捷键提示改为"截图->粘贴：Alt+Shift+A-Ctrl+V ---> Ctrl+V" - 移动端隐藏截图提示(CSS 媒体查询) - AI转人工提示改为"已为您呼叫人工坐席，请稍等!" - 坐席接入提示改为"坐席正在查看您的信息，请等待处理回复！" - 删除"摇铃呼叫坐席"入口和文案 - 删除孤儿组件 MessageList.vue + shake 动画 CSS ## H5 员工端 v5 (2026-07-13 02:08 已部署) - RightPanel v2.1：删除"软件安装"和"资源权限"标签页 - 移除标签栏，智能推荐(DynamicRecommend)直接展示 - 删除 SoftwareDownloads/ApprovalLinks 引用和相关 CSS ## AI 对话链路全栈改造 Phase 1-6 (已部署) - Phase 1: Dify JSON输出 + 后端blocking解析 + 双WS推送 + 错误降级 - Phase 2: 关键词收窄(~25强意图词) + 两级分类Prompt + 删除前端checkApprovalIntent - Phase 3: WS扩展(ai_thinking+dynamic_recommend) + ai_structured气泡 + RightPanel v2 + 选项回传 - Phase 4: VisionService接入 + 图片消息融合(5秒窗口) + 降级策略 - Phase 5: 坐席端ai_thinking指示器 + ai_structured/byod_card渲染 + handleNewMessage修复 - Phase 6: diagnosis_stage(6值) + response_time_ms计时 + 慢响应告警(>10s) ## 坐席端 v5 (2026-07-13 01:38 已部署) - ai_structured/byod_card 只读渲染 - AI思考指示器 UI - handleNewMessage 透传 msg_type/extra_data 修复 - 布局优化v2.0: QuickReplyBar L1+L2悬浮 + ReplyBox左右分区 + 右栏260/560px切换 - 键盘快捷键v2.3: 纯数字路由 + ESC分层撤销 + Shift+Space用event.code ## 上下文感知智能诊断闭环 (2026-07-12 已部署) - 三层诊断(API→Script→AI) + 三段排队(VIP→info_locked→not locked) - 答题插队 + 五场景关闭 - 迁移052(6表+6列) + queue_service + quiz_service + closing_service - H5前端: QueueWaiting + RightPanel双Tab + InputBar三态 + ResolveConfirmCard - 坐席前端: pending_close结单流程 + 信息锁定(Dify步骤完成+有效回答率≥70%) ## 知识库迭代3 (2026-07-12 已部署) - 分诊交互(H5+坐席+Dify独立应用) - 拓扑预览(ECharts只读) - 代答排除(4种匹配器: keyword/regex/intent/category) - 迁移051 + 44文件43测试通过 ## 后端变更 - 6个Python文件改造(h5_ai_task.py/h5.py/ai_service.py/closing_service.py等) - funny_phrase_service.py: shake/connected/keyword 默认文案更新 - session_service.py: 企微消息文案同步 - 新增: queue.py/quiz.py/triage.py/exclusion_rules.py 等API端点 - 新增: diagnostic.py/quiz.py/triage_session.py 等模型 - 新增: closing_service/queue_service/quiz_service/triage_service 等服务 ## 文档更新 - CHANGELOG.md: 新增 [未发布] 区全部变更记录 - 项目管理主文档 v2.5: 新增v0.7.3版本 + 已完成看板 + 最近搞定 - 版本记录: 新增v0.7.3条目 - AI对话链路实施计划: Phase 1-6 全部标记✅已实施 - 新增架构图/时序图/类图(mermaid) ## 部署路径修正 - 服务器项目根路径: /opt/wecom-it-desk/ - 所有前端dist均为ro bind mount，只能在宿主机源路径操作 - 服务器nginx /h5/ 是静态文件服务(非proxy_pass) - elFinder上传二进制不可靠(MD5不匹配)，改用base64分块上传
2026-07-13 02:17:03 +08:00
parent bea288e414
commit 449c6d4875
176 changed files with 46637 additions and 4805 deletions
@@ -0,0 +1,125 @@
+# =============================================================================
+# 企微IT智能服务台 — 正则匹配器
+# =============================================================================
+# 说明：使用 Python re.search 进行正则匹配，带编译缓存和 ReDoS 超时保护。
+#   编译缓存：同一 pattern 只编译一次，缓存在类变量 _compile_cache 中。
+#   ReDoS 保护：使用 signal.alarm 超时机制，防止恶意正则导致 CPU 打满。
+# =============================================================================
+
+import logging
+import re
+import signal
+from typing import Optional
+
+from app.services.matchers.base import BaseMatcher, MatchResult
+
+logger = logging.getLogger(__name__)
+
+# 正则匹配超时时间（秒），防止 ReDoS
+_REGEX_TIMEOUT_SEC: float = 2.0
+
+# 正则编译缓存最大条目数
+_MAX_CACHE_SIZE: int = 200
+
+
+class RegexMatcher(BaseMatcher):
+    """正则匹配器。
+
+    匹配逻辑：
+    1. 编译 condition 为正则 Pattern（带缓存）
+    2. 在消息文本中搜索匹配
+    3. 命中则返回匹配详情和位置
+
+    安全措施：
+    - 正则编译缓存：同一 pattern 只编译一次
+    - ReDoS 超时保护：匹配超过 2 秒自动中断，返回未命中
+
+    Example:
+        condition = "密码.*过期"
+        message = "我的密码好像过期了"
+        → 命中，matched_detail="密码好像过期"
+    """
+
+    # 类级正则编译缓存：pattern_str → compiled Pattern
+    _compile_cache: dict[str, re.Pattern] = {}
+
+    def _get_compiled(self, pattern_str: str) -> Optional[re.Pattern]:
+        """获取编译后的正则 Pattern（带缓存）。
+
+        Args:
+            pattern_str: 正则表达式字符串
+
+        Returns:
+            Optional[re.Pattern]: 编译后的 Pattern，编译失败返回 None
+        """
+        # 缓存命中
+        if pattern_str in self._compile_cache:
+            return self._compile_cache[pattern_str]
+
+        # 缓存清理：超过上限时清空（简单 LRU 策略）
+        if len(self._compile_cache) >= _MAX_CACHE_SIZE:
+            self._compile_cache.clear()
+
+        # 编译正则
+        try:
+            compiled = re.compile(pattern_str, re.IGNORECASE | re.MULTILINE)
+            self._compile_cache[pattern_str] = compiled
+            return compiled
+        except re.error as e:
+            logger.warning("正则编译失败: pattern=%s, error=%s", pattern_str, e)
+            return None
+
+    @staticmethod
+    def _timeout_handler(signum, frame):
+        """正则匹配超时信号处理器。"""
+        raise TimeoutError("Regex matching timed out (possible ReDoS)")
+
+    async def match(
+        self,
+        message: str,
+        condition: str,
+        context: Optional[dict] = None,
+    ) -> MatchResult:
+        """检查消息是否匹配正则表达式。
+
+        Args:
+            message: 用户消息文本
+            condition: 正则表达式字符串
+            context: 上下文（本匹配器不需要）
+
+        Returns:
+            MatchResult: 命中时 matched=True, matched_detail=匹配到的文本
+        """
+        if not message or not condition:
+            return MatchResult(matched=False)
+
+        compiled = self._get_compiled(condition)
+        if compiled is None:
+            return MatchResult(matched=False)
+
+        # 使用 signal 超时保护（仅 Unix 平台可用，Windows 降级为无超时）
+        try:
+            # 设置超时信号
+            old_handler = signal.signal(signal.SIGALRM, self._timeout_handler)
+            signal.setitimer(signal.ITIMER_REAL, _REGEX_TIMEOUT_SEC)
+            try:
+                m = compiled.search(message)
+            finally:
+                signal.setitimer(signal.ITIMER_REAL, 0)
+                signal.signal(signal.SIGALRM, old_handler)
+        except (TimeoutError, OSError):
+            logger.warning("正则匹配超时（ReDoS 保护）: pattern=%s", condition)
+            return MatchResult(matched=False)
+        except Exception as e:
+            logger.error("正则匹配异常: pattern=%s, error=%s", condition, e)
+            return MatchResult(matched=False)
+
+        if m:
+            matched_text = m.group(0)
+            return MatchResult(
+                matched=True,
+                matched_detail=f"正则匹配: {matched_text}",
+                match_position=f"位置 {m.start()}-{m.end()}",
+            )
+
+        return MatchResult(matched=False)