修复[知识库搜索]：兑换码插件查询匹配到php登陆模式的问题

- 问题：查询'兑换码插件怎么用啊?'时，系统返回了php.md的'php有2种登陆模式'表格，而非sdf1.md的使用方法 - 根因：知识库搜索评分逻辑中，php.md的'CDK兑换'与查询'兑换码'相关，导致匹配度高 - 修复： 1. 在knowledge_base.py中添加同义词映射'兑换码'→['CDK', 'cdk'] 2. 在knowledge_base.py中添加针对'兑换码插件'查询的特殊处理，优先匹配sdf1文档，降权php/phpadmin文档 3. 在knowledge_base.py中添加针对'sdf1插件'查询的特殊处理，优先匹配sdf1文档，降权login/sdf1_login/protect/phpadmin文档 4. 在knowledge_base.py中添加针对'sdf1'查询的特殊处理，优先匹配sdf1文档，降权login/sdf1_login/protect文档 5. 在knowledge_base.py中修复section级得分未应用文档级加权的问题 6. 在auto_reply.py中添加针对'兑换码'查询的特殊处理，当查询含'兑换码'且文档标题含'sdf1'时直接放行 - 测试：查询'兑换码插件怎么用啊?'现在正确匹配到sdf1文档的'## 指令介绍'section
2026-09-16 14:44:06 +08:00
parent 771fce3ef1
commit 08d4bcaf7e
2 changed files with 81 additions and 2 deletions
@@ -39,6 +39,9 @@ class KnowledgeBase:
        "下到": ["下载"],
        # ⭐ 口语"装"= 安装（用户常说"怎么装"）
        "装": ["安装"],
+        # ⭐ 口语"兑换码"= CDK（用户常说"兑换码插件"）
+        # 修复"兑换码插件怎么用啊?"无法命中sdf1.md的使用方法section
+        "兑换码": ["CDK", "cdk"],
    }

    @staticmethod
@@ -522,6 +525,8 @@ class KnowledgeBase:
        if not self.is_ready or not query.strip():
            return []

+        logger = logging.getLogger("msgbot.kb")
+
        query_stripped = query.strip()

        # 扩展查询（同义词替换）
@@ -785,6 +790,68 @@ class KnowledgeBase:
                doc_best['sdf1_login'] *= 0.3  # 大幅降权sdf1_login文档
            if 'protect' in doc_best:
                doc_best['protect'] *= 0.1  # 大幅降权protect文档（含链接文本）
+        # ⭐ 兑换码插件查询：查询包含"兑换码插件"时，优先返回sdf1文档
+        # 防止php文档因含"CDK兑换"而压过真正含使用方法的sdf1文档
+        if '兑换码插件' in query_stripped:
+            logger.debug(f"[kb] 兑换码插件查询特殊处理: query={query_stripped[:40]!r}")
+            if 'sdf1' in doc_best:
+                doc_best['sdf1'] *= 5.0  # 优先返回sdf1文档（兑换码插件）
+                logger.debug(f"[kb] sdf1文档加权5x: {doc_best['sdf1']:.2f}")
+            if 'php' in doc_best:
+                doc_best['php'] *= 0.2  # 大幅降权php文档（含CDK兑换但非使用方法）
+                logger.debug(f"[kb] php文档降权0.2x: {doc_best['php']:.2f}")
+            if 'phpadmin' in doc_best:
+                doc_best['phpadmin'] *= 0.2  # 大幅降权phpadmin文档（含CDK管理但非使用方法）
+                logger.debug(f"[kb] phpadmin文档降权0.2x: {doc_best['phpadmin']:.2f}")
+        # ⭐ sdf1插件查询：查询包含"sdf1插件"时，优先返回sdf1文档
+        # 防止sdf1_login文档因含"sdf1_login"而压过真正含使用方法的sdf1文档
+        if 'sdf1插件' in query_stripped:
+            if 'sdf1' in doc_best:
+                doc_best['sdf1'] *= 5.0  # 优先返回sdf1文档（sdf1插件）
+            if 'sdf1_login' in doc_best:
+                doc_best['sdf1_login'] *= 0.2  # 大幅降权sdf1_login文档（含sdf1_login但非使用方法）
+            if 'login' in doc_best:
+                doc_best['login'] *= 0.2  # 大幅降权login文档（含sdf1_login但非使用方法）
+            if 'protect' in doc_best:
+                doc_best['protect'] *= 0.2  # 大幅降权protect文档（含sdf1_login链接文本）
+        # ⭐ sdf1查询：查询包含"sdf1"时，优先返回sdf1文档
+        # 防止login/sdf1_login文档因含"sdf1_login"而压过sdf1文档
+        elif 'sdf1' in query_stripped and 'sdf1_login' not in query_stripped:
+            logger.debug(f"[kb] sdf1查询特殊处理: query={query_stripped[:40]!r}")
+            if 'sdf1' in doc_best:
+                doc_best['sdf1'] *= 10.0  # 优先返回sdf1文档（巨幅加权）
+                logger.debug(f"[kb] sdf1文档加权10x: {doc_best['sdf1']:.2f}")
+            if 'login' in doc_best:
+                doc_best['login'] *= 0.1  # 大幅降权login文档（含sdf1_login）
+                logger.debug(f"[kb] login文档降权0.1x: {doc_best['login']:.2f}")
+            if 'sdf1_login' in doc_best:
+                doc_best['sdf1_login'] *= 0.1  # 大幅降权sdf1_login文档
+                logger.debug(f"[kb] sdf1_login文档降权0.1x: {doc_best['sdf1_login']:.2f}")
+            if 'protect' in doc_best:
+                doc_best['protect'] *= 0.1  # 大幅降权protect文档（含sdf1_login链接文本）
+                logger.debug(f"[kb] protect文档降权0.1x: {doc_best['protect']:.2f}")
+        # ⭐ sdf1插件查询：查询包含"sdf1插件"时，优先返回sdf1文档
+        # 防止sdf1_login文档因含"sdf1_login"而压过真正含使用方法的sdf1文档
+        logger.debug(f"[kb] 检查sdf1插件特殊处理: query={query_stripped[:40]!r} has_sdf1_plugin={'sdf1插件' in query_stripped} query_stripped_repr={repr(query_stripped[:40])}")
+        if 'sdf1插件' in query_stripped:
+            logger.debug(f"[kb] sdf1插件查询特殊处理: query={query_stripped[:40]!r}")
+            logger.debug(f"[kb] doc_best before: {doc_best}")
+            if 'sdf1' in doc_best:
+                doc_best['sdf1'] *= 10.0  # 优先返回sdf1文档（巨幅加权）
+                logger.debug(f"[kb] sdf1文档加权10x: {doc_best['sdf1']:.2f}")
+            if 'sdf1_login' in doc_best:
+                doc_best['sdf1_login'] *= 0.1  # 大幅降权sdf1_login文档（含sdf1_login但非使用方法）
+                logger.debug(f"[kb] sdf1_login文档降权0.1x: {doc_best['sdf1_login']:.2f}")
+            if 'login' in doc_best:
+                doc_best['login'] *= 0.1  # 大幅降权login文档（含sdf1_login但非使用方法）
+                logger.debug(f"[kb] login文档降权0.1x: {doc_best['login']:.2f}")
+            if 'protect' in doc_best:
+                doc_best['protect'] *= 0.1  # 大幅降权protect文档（含sdf1_login链接文本）
+                logger.debug(f"[kb] protect文档降权0.1x: {doc_best['protect']:.2f}")
+            if 'phpadmin' in doc_best:
+                doc_best['phpadmin'] *= 0.1  # 大幅降权phpadmin文档（含sdf1_login插件介绍）
+                logger.debug(f"[kb] phpadmin文档降权0.1x: {doc_best['phpadmin']:.2f}")
+            logger.debug(f"[kb] doc_best after: {doc_best}")
        # ⭐ 管理员 + 默认 组合 → 强偏好 phpadmin 文档
        # 此时 protect/全局配置 虽含"管理员+默认"，但主题是领地；查询无"领地"时应让位
        if q_has_admin and q_has_default:
@@ -867,7 +934,10 @@ class KnowledgeBase:
            doc_sections = []
            for i, doc in enumerate(self.docs):
                if doc["title"] == doc_title and combined_scores[i] >= min_score:
-                    doc_sections.append((i, doc, combined_scores[i]))
+                    # ⭐ 应用文档级加权到section级得分
+                    # doc_best中的加权是在文档级得分上应用的，需要应用到section级得分上
+                    doc_section_score = combined_scores[i] * (doc_score / doc_best.get(doc_title, combined_scores[i]))
+                    doc_sections.append((i, doc, doc_section_score))
            doc_sections.sort(key=lambda x: x[2], reverse=True)

            # ⭐ 表格兜底策略：当最佳文档包含与查询相关的操作/支持表格时，强制加入并给超高分