feature：优化 2026_01_13

app.py

@@ -35,6 +35,7 @@ DETECT_FORCE_DARK = '''<script>
 })();
 </script>'''
 from ai_service import design_mahjong_game
+from reference_retriever import match_variants_in_text, load_variant_md
 # 优先尝试原生流式；没有则自动回退为伪流式
 try:
     from ai_service import design_mahjong_game_stream
@@ -146,6 +147,54 @@ def _chunk_fake_stream(text, step=40):
         yield s[i:i + step]
 
 
+def _is_design_intent(text: str) -> bool:
+    """判断是否明确进入“新玩法设计/融合/生成”路径。"""
+    s = (text or "").strip()
+    if not s:
+        return False
+    keywords = [
+        "设计", "生成", "做一个", "做个", "新玩法", "创新", "融合", "组合", "改造", "迭代",
+        "玩法设计", "规则设计", "番型设计", "出一套", "给我一套",
+    ]
+    return any(k in s for k in keywords)
+
+
+def _is_rules_query(text: str) -> bool:
+    """判断是否为“询问现有玩法细节/规则”的问题。"""
+    s = (text or "").strip()
+    if not s:
+        return False
+    keywords = [
+        "规则", "玩法", "番型", "细节", "说明", "机制", "怎么打", "怎么胡", "如何胡", "计分", "流程",
+        "介绍", "讲讲", "是什么", "有哪些",
+    ]
+    return any(k in s for k in keywords)
+
+
+def _normalize_question(text: str) -> str:
+    s = str(text or "").strip().lower()
+    if not s:
+        return ""
+    punct = "？?！!。；;：:、，,．.()（）[]【】<>《》\"'“”‘’ "
+    for ch in punct:
+        s = s.replace(ch, "")
+    return s
+
+
+def _merge_asked_questions(existing, new_items):
+    merged = [str(q).strip() for q in (existing or []) if str(q).strip()]
+    seen = {_normalize_question(q) for q in merged if _normalize_question(q)}
+    for q in (new_items or []):
+        q_text = str(q).strip()
+        if not q_text:
+            continue
+        key = _normalize_question(q_text)
+        if key and key not in seen:
+            merged.append(q_text)
+            seen.add(key)
+    return merged
+
+
 def _load_base64_image(path):
     """读取本地图片并返回 data URI"""
     import base64
@@ -465,6 +514,7 @@ with gr.Blocks(
                 ready_to_generate = gr.State(False)
                 design_state_history = gr.State(create_empty_history())  # 版本历史
                 interaction_phase_state = gr.State(create_phase_state())  # 多阶段交互状态
+                asked_questions_state = gr.State([])  # Analyse 模式：已问过的问题
 
                 with gr.Group(elem_classes="side-card"):
                     gr.Markdown("### 可控迭代（推荐）")
@@ -590,23 +640,40 @@ with gr.Blocks(
                     ds_ver_prev,
                     ready_prev,
                     history_data,
+                    asked_questions,
                 ):
                     user_text = (user_text or "").strip()
                     diff_md_prev = "_尚无变更记录_"  # 保留上次的差异摘要
                     cur_choices = get_history_choices(history_data)
+                    asked_questions = asked_questions or []
                     if not user_text:
                         # 不提交空消息：输出不变
-                        yield history_msgs, "", history_msgs, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：未变更", ready_prev, "READY_TO_GENERATE：未知", "输出校验：未运行", diff_md_prev, history_data, gr.update(choices=cur_choices), "_无版本历史_" if not cur_choices else f"共 {len(cur_choices)} 个版本"
+                        yield history_msgs, "", history_msgs, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：未变更", ready_prev, "READY_TO_GENERATE：未知", "输出校验：未运行", diff_md_prev, history_data, gr.update(choices=cur_choices), "_无版本历史_" if not cur_choices else f"共 {len(cur_choices)} 个版本", asked_questions
                         return
 
                     # 立即显示"用户消息"
                     history = list(history_msgs or [])
                     history.append({"role": "user", "content": user_text})
-                    yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：处理中…", ready_prev, "READY_TO_GENERATE：未知", "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_"
+                    yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：处理中…", ready_prev, "READY_TO_GENERATE：未知", "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
 
                     # 添加空的助手气泡，用于逐步填充
                     history.append({"role": "assistant", "content": ""})
-                    yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：处理中…", ready_prev, "READY_TO_GENERATE：未知", "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_"
+                    yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：处理中…", ready_prev, "READY_TO_GENERATE：未知", "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
+
+                    # ====== 现有玩法细节查询：直接返回本地玩法库内容 ======
+                    if (not analyse_enabled) and (not iterative_enabled) and _is_rules_query(user_text) and (not _is_design_intent(user_text)):
+                        matched = match_variants_in_text(user_text)
+                        if matched:
+                            parts = []
+                            for name in matched:
+                                md_text = (load_variant_md(name) or "").strip()
+                                if md_text:
+                                    parts.append(f"### {name}\n\n{md_text}")
+                                else:
+                                    parts.append(f"### {name}\n\n（未找到该玩法的本地规则文件）")
+                            history[-1]["content"] = "\n\n---\n\n".join(parts).strip()
+                            yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：未变更", ready_prev, "READY_TO_GENERATE：未知", "输出校验：未运行", "_未生成设计_", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
+                            return
 
                     # 流式生成内容
                     tuples_hist = _messages_to_tuples(history)
@@ -623,15 +690,22 @@ with gr.Blocks(
 
                     if analyse_enabled:
                         tuples_to_send = []  # Analyse 模式不吃长history，避免漂移
+                        asked_block = ""
+                        if asked_questions:
+                            asked_block = "已问过的问题（禁止重复）：\n" + "\n".join(
+                                f"- {q}" for q in asked_questions[:20]
+                            ) + "\n\n"
                         effective_user_text = (
                             "<ANALYSE_MODE>true</ANALYSE_MODE>\n"
                             "你正在进行【Analyse 模式】（单问题迭代）。\n"
                             "目标：通过多轮问答把需求场景收敛到可生成完整玩法。\n"
                             "限制：本轮禁止输出 mGDL/完整规则/自检报告。\n\n"
+                            "{asked}"
                             "当前已有 DesignState（如为空表示尚未建立初版）：\n"
                             "<DESIGN_STATE_JSON>\n{ds}\n</DESIGN_STATE_JSON>\n\n"
                             "用户本轮补充信息：\n{req}\n"
-                        ).format(ds=(ds_raw_prev or "{}").strip(), req=user_text)
+                            "要求：本轮只能问 1 个问题；不得重复已问过的问题；若信息已足够则直接 READY_TO_GENERATE: true。\n"
+                        ).format(asked=asked_block, ds=(ds_raw_prev or "{}").strip(), req=user_text)
                         status_hint = "DesignState：Analyse模式中…"
                     elif iterative_enabled and (ds_raw_prev or "").strip():
                         tuples_to_send = []  # 用“当前 DesignState”替代长历史，减少漂移
@@ -653,10 +727,10 @@ with gr.Blocks(
                                 if not piece:
                                     continue
                                 history[-1]["content"] += str(piece)
-                                yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, status_hint, ready_to_gen, ready_md, "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_"
+                                yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, status_hint, ready_to_gen, ready_md, "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
                         except Exception as e:
                             history[-1]["content"] += f"\n（流式出错）{type(e).__name__}: {e}"
-                            yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：流式出错（未变更）", ready_to_gen, "READY_TO_GENERATE：未知", "输出校验：未运行", "_处理出错_", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_"
+                            yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, "DesignState：流式出错（未变更）", ready_to_gen, "READY_TO_GENERATE：未知", "输出校验：未运行", "_处理出错_", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
                     else:
                         try:
                             full = design_mahjong_game(effective_user_text, tuples_to_send, files, custom_prompt, mode)
@@ -664,7 +738,7 @@ with gr.Blocks(
                             full = f"（出错）{type(e).__name__}: {e}"
                         for piece in _chunk_fake_stream(str(full), step=40):
                             history[-1]["content"] += piece
-                            yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, status_hint, ready_to_gen, ready_md, "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_"
+                            yield history, "", history, "", "", "", ds_raw_prev, ds_obj_prev, ds_ver_prev, status_hint, ready_to_gen, ready_md, "输出校验：运行中…", "_处理中..._", history_data, gr.update(choices=cur_choices), f"共 {len(cur_choices)} 个版本" if cur_choices else "_无版本历史_", asked_questions
 
                     # 提取 GDL 和自然语言描述并保存
                     new_ds_obj, new_ds_raw = extract_design_state(history[-1]["content"])
@@ -717,7 +791,9 @@ with gr.Blocks(
 
                         # Analyse 模式不产出完整规则，不导出GDL/自然语言文件
                         if analyse_enabled:
-                            yield history, "", history, "", "", "", (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, "输出校验：Analyse 模式跳过", diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md
+                            new_questions = extract_clarify_questions(history[-1]["content"])
+                            asked_questions = _merge_asked_questions(asked_questions, new_questions)
+                            yield history, "", history, "", "", "", (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, "输出校验：Analyse 模式跳过", diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md, asked_questions
                             return
 
                         gdl_content, narrative_content = extract_gdl_and_narrative(history[-1]["content"])
@@ -728,10 +804,10 @@ with gr.Blocks(
                         design_log_path = save_design_log(design_log_content)
 
                         # 返回文件路径，以便下载
-                        yield history, "", history, gdl_path, narrative_path, design_log_path, (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, render_validation_md(history[-1]["content"]), diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md
+                        yield history, "", history, gdl_path, narrative_path, design_log_path, (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, render_validation_md(history[-1]["content"]), diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md, asked_questions
                     except Exception as e:
                         print(f"保存GDL和自然语言文件时出错: {e}")
-                        yield history, "", history, "", "", "", (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, render_validation_md(history[-1]["content"]), diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md
+                        yield history, "", history, "", "", "", (new_ds_raw or ds_raw_prev), (new_ds_obj or ds_obj_prev), ds_ver, ds_status, ready_to_gen, ready_md, render_validation_md(history[-1]["content"]), diff_summary_md, updated_history_data, gr.update(choices=new_choices, value=new_choices[-1] if new_choices else None), history_status_md, asked_questions
 
                 def on_generate_from_state(
                     history_msgs,
@@ -838,6 +914,7 @@ with gr.Blocks(
                         design_state_version,
                         ready_to_generate,
                         design_state_history,
+                        asked_questions_state,
                     ],
                     outputs=[
                         chatbot,
@@ -857,6 +934,7 @@ with gr.Blocks(
                         design_state_history,
                         version_dropdown,
                         history_status,
+                        asked_questions_state,
                     ],
                     preprocess=True,
                 )
@@ -878,6 +956,7 @@ with gr.Blocks(
                         design_state_version,
                         ready_to_generate,
                         design_state_history,
+                        asked_questions_state,
                     ],
                     outputs=[
                         chatbot,
@@ -897,6 +976,7 @@ with gr.Blocks(
                         design_state_history,
                         version_dropdown,
                         history_status,
+                        asked_questions_state,
                     ],
                     preprocess=True,
                 )
@@ -1212,6 +1292,7 @@ with gr.Blocks(
                         gr.update(visible=False), gr.update(choices=[], value=None),
                         gr.update(visible=False), gr.update(visible=False),
                         create_scope_config(), "_范围约束: 预设模式_",
+                        [],
                     )
 
                 clear_dialog_btn.click(
@@ -1243,6 +1324,7 @@ with gr.Blocks(
                         diverge_action_row,
                         scope_config_state,
                         scope_status,
+                        asked_questions_state,
                     ],
                 )
 

reference_retriever.py

@@ -124,6 +124,35 @@ def _build_variant_index() -> Dict[str, Dict[str, str]]:
     return cleaned
 
 
+def list_variant_names() -> List[str]:
+    """
+    返回本地玩法库中可用的玩法名列表（含“麻将机制说明”）。
+    """
+    index = _build_variant_index()
+    names = sorted(index.keys(), key=lambda x: len(x), reverse=True)
+    return names
+
+
+def match_variants_in_text(text: str) -> List[str]:
+    """
+    从用户文本中匹配玩法名（优先更长的名称）。
+    """
+    candidates = list_variant_names()
+    return _find_mentions(text, candidates)
+
+
+def load_variant_md(name: str) -> str:
+    """
+    读取指定玩法的 .md 内容（若不存在则返回空字符串）。
+    """
+    index = _build_variant_index()
+    entry = index.get(name) or {}
+    md_path = entry.get("md_path")
+    if not md_path or not os.path.exists(md_path):
+        return ""
+    return _read_text(md_path) or ""
+
+
 def _find_mentions(text: str, candidates: List[str]) -> List[str]:
     """
     朴素子串匹配（中文玩法名通常稳定），返回按“更长优先”的去重命中列表。