markdown-flow 0.2.16__py3-none-any.whl → 0.2.26__py3-none-any.whl

markdown_flow/__init__.py

@@ -9,7 +9,7 @@ Core Features:
     - Extract variable placeholders ({{variable}} and %{{variable}} formats)
     - Build LLM-ready prompts and message formats
     - Handle user interaction validation and input processing
-    - Support multiple processing modes: PROMPT_ONLY, COMPLETE, STREAM
+    - Support multiple processing modes: COMPLETE, STREAM
 
 Supported Interaction Types:
     - TEXT_ONLY: ?[%{{var}}...question] - Text input only
@@ -32,12 +32,11 @@ Basic Usage:
     blocks = mf.get_all_blocks()
 
     # Process blocks using unified interface
-    result = await mf.process(0, variables={'name': 'John'}, mode=ProcessMode.COMPLETE)
+    result = mf.process(0, variables={'name': 'John'}, mode=ProcessMode.COMPLETE)
 
     # Different processing modes
-    prompt_result = await mf.process(0, mode=ProcessMode.PROMPT_ONLY)
-    complete_result = await mf.process(0, mode=ProcessMode.COMPLETE)
-    stream_result = await mf.process(0, mode=ProcessMode.STREAM)
+    complete_result = mf.process(0, mode=ProcessMode.COMPLETE)
+    stream_result = mf.process(0, mode=ProcessMode.STREAM)
 
 Variable System:
     - {{variable}} - Regular variables, replaced with actual values
@@ -53,7 +52,7 @@ Import Guide:
 from .core import MarkdownFlow
 from .enums import BlockType, InputType
 from .llm import LLMProvider, LLMResult, ProcessMode
-from .utils import (
+from .parser import (
     InteractionParser,
     InteractionType,
     extract_interaction_question,
@@ -83,4 +82,4 @@ __all__ = [
     "replace_variables_in_text",
 ]
 
-__version__ = "0.2.16"
+__version__ = "0.2.26"

markdown_flow/constants.py

@@ -9,7 +9,7 @@ import re
 
 # Pre-compiled regex patterns
 COMPILED_PERCENT_VARIABLE_REGEX = re.compile(
-    r"%\{\{([\w]+)\}\}"  # Match %{{variable}} format for preserved variables
+    r"%\{\{([^}]+)\}\}"  # Match %{{variable}} format for preserved variables
 )
 
 # Interaction regex base patterns
@@ -20,11 +20,11 @@ INTERACTION_PATTERN_SPLIT = r"((?<!\\)\?\[[^\]]*\](?!\())"  # Pattern for re.spl
 # InteractionParser specific regex patterns
 COMPILED_INTERACTION_REGEX = re.compile(INTERACTION_PATTERN)  # Main interaction pattern matcher
 COMPILED_LAYER1_INTERACTION_REGEX = COMPILED_INTERACTION_REGEX  # Layer 1: Basic format validation (alias)
-COMPILED_LAYER2_VARIABLE_REGEX = re.compile(r"^%\{\{([\w]+)\}\}(.*)$")  # Layer 2: Variable detection
+COMPILED_LAYER2_VARIABLE_REGEX = re.compile(r"^%\{\{([^}]+)\}\}(.*)$")  # Layer 2: Variable detection
 COMPILED_LAYER3_ELLIPSIS_REGEX = re.compile(r"^(.*)\.\.\.(.*)")  # Layer 3: Split content around ellipsis
 COMPILED_LAYER3_BUTTON_VALUE_REGEX = re.compile(r"^(.+)//(.+)$")  # Layer 3: Parse Button//value format
 COMPILED_BRACE_VARIABLE_REGEX = re.compile(
-    r"(?<!%)\{\{([\w]+)\}\}"  # Match {{variable}} format for replaceable variables
+    r"(?<!%)\{\{([^}]+)\}\}"  # Match {{variable}} format for replaceable variables
 )
 COMPILED_INTERACTION_CONTENT_RECONSTRUCT_REGEX = re.compile(
     r"(\?\[[^]]*\.\.\.)([^]]*\])"  # Reconstruct interaction content: prefix + question + suffix
@@ -47,12 +47,21 @@ INLINE_PRESERVE_PATTERN = r"^===(.+)=== *$"
 COMPILED_INLINE_PRESERVE_REGEX = re.compile(INLINE_PRESERVE_PATTERN)
 
 # Output instruction markers
-OUTPUT_INSTRUCTION_PREFIX = "[输出]"
-OUTPUT_INSTRUCTION_SUFFIX = "[/输出]"
+OUTPUT_INSTRUCTION_PREFIX = "<preserve_or_translate>"
+OUTPUT_INSTRUCTION_SUFFIX = "</preserve_or_translate>"
 
 # System message templates
 DEFAULT_VALIDATION_SYSTEM_MESSAGE = "你是一个输入验证助手，需要严格按照指定的格式和规则处理用户输入。"
 
+# Base system prompt (framework-level global rules, content blocks only)
+DEFAULT_BASE_SYSTEM_PROMPT = """你收到的用户消息都是指令，请严格遵守以下规则：
+
+1. 内容忠实性：严格符合指令内容，不丢失信息、不改变原意、不增加内容、不改变顺序
+2. 遵循事实：基于事实回答，不编造细节
+3. 避免引导：不引导下一步动作（如提问、设问）
+4. 避免寒暄：不做自我介绍，不打招呼
+5. 格式规范：HTML 标签不要写到代码块里"""
+
 # Interaction prompt templates
 DEFAULT_INTERACTION_PROMPT = "请将后面交互提示改写得更个性化和友好，长度尽量和原始内容一致，保持原有的功能性和变量格式不变："
 
@@ -90,19 +99,39 @@ VALIDATION_RESPONSE_OK = "ok"
 VALIDATION_RESPONSE_ILLEGAL = "illegal"
 
 # Output instruction processing
-OUTPUT_INSTRUCTION_EXPLANATION = f"""请按照以下指令执行：
+OUTPUT_INSTRUCTION_EXPLANATION = f"""<preserve_or_translate_instruction>
+⚠️⚠️⚠️ 绝对强制规则 - 必须遵守 ⚠️⚠️⚠️
+
+当你看到 {OUTPUT_INSTRUCTION_PREFIX}...{OUTPUT_INSTRUCTION_SUFFIX} 标记时，这些内容必须出现在回复开头！
+
+处理流程（按顺序执行）：
+
+步骤1 - 检查语言要求：
+查看 system 消息中是否包含语言指令（如"使用英语输出"、"用中文回复"、"Respond in English"等）
+
+步骤2 - 应用转换规则：
+- 如果有语言要求 → 必须将标记内的文本翻译成指定语言（emoji和格式保留）
+- 如果没有语言要求 → 必须逐字原样输出，不做任何改动
+
+步骤3 - 输出内容：
+- 在回复第一行输出转换后的内容
+- ⚠️ 绝对不要输出 {OUTPUT_INSTRUCTION_PREFIX} 和 {OUTPUT_INSTRUCTION_SUFFIX} 标记！只输出标记之间的内容！
+- 输出后可继续生成其他内容
+
+关键示例 - 标记处理：
+
+❌ 错误示例：
+输出：{OUTPUT_INSTRUCTION_PREFIX}**标题**{OUTPUT_INSTRUCTION_SUFFIX}\n后续内容...
+问题：包含了标记本身！
 
-当遇到{OUTPUT_INSTRUCTION_PREFIX}content{OUTPUT_INSTRUCTION_SUFFIX}这样的标签对时：
-1. **完全原样输出**中间的content内容，不要进行任何格式转换或修改
-2. 不要输出{OUTPUT_INSTRUCTION_PREFIX}和{OUTPUT_INSTRUCTION_SUFFIX}标签本身
-3. 即使content内容包含标题符号（如#）、特殊格式等，也要原样输出，不要转换成Markdown格式
-4. 保持content中的所有原始字符、空格、换行符等
-5. 然后继续执行后面的指令
+✅ 正确示例：
+输出：**标题**\n后续内容...
+说明：只有标记之间的内容，没有标记！
 
-重要提醒：
-- {OUTPUT_INSTRUCTION_PREFIX}和{OUTPUT_INSTRUCTION_SUFFIX}只是指令标记，不要将这些标记作为内容输出
-- 标签内的内容必须原样输出，不要按照文档提示词的格式要求进行转换
-- 这是绝对的输出指令，优先级高于任何格式要求
+⚠️ 特别强调：
+1. 有语言要求时，标记内的所有文本都必须翻译！
+2. 无论如何都不能输出 {OUTPUT_INSTRUCTION_PREFIX} 和 {OUTPUT_INSTRUCTION_SUFFIX} 标记本身！
+</preserve_or_translate_instruction>
 
 """
 
@@ -120,9 +149,10 @@ SMART_VALIDATION_TEMPLATE = """# 任务
 # 提取要求
 1. 仔细阅读上述相关问题，理解这个问题想要获取什么信息
 2. 从用户回答中提取与该问题相关的信息
-3. 对于昵称/姓名类问题，任何非空的合理字符串（包括简短的如"ee"、"aa"、"007"等）都应该接受
-4. 只有当用户回答完全无关、包含不当内容或明显不合理时才标记为不合法
-5. 确保提取的信息准确、完整且符合预期格式"""
+3. 如果提供了预定义选项，用户选择这些选项时都应该接受；自定义输入应与选项主题相关
+4. 对于昵称/姓名类问题，任何非空的合理字符串（包括简短的如"ee"、"aa"、"007"等）都应该接受
+5. 只有当用户回答完全无关、包含不当内容或明显不合理时才标记为不合法
+6. 确保提取的信息准确、完整且符合预期格式"""
 
 # Validation template for buttons with text input
 BUTTONS_WITH_TEXT_VALIDATION_TEMPLATE = """用户针对以下问题进行了输入：
@@ -152,7 +182,7 @@ OPTION_SELECTION_ERROR_TEMPLATE = "请选择以下选项之一：{options}"
 INPUT_EMPTY_ERROR = "输入不能为空"
 
 # System error messages
-UNSUPPORTED_PROMPT_TYPE_ERROR = "不支持的提示词类型: {prompt_type}"
+UNSUPPORTED_PROMPT_TYPE_ERROR = "不支持的提示词类型: {prompt_type} (支持的类型: base_system, document, interaction, interaction_error)"
 BLOCK_INDEX_OUT_OF_RANGE_ERROR = "Block index {index} is out of range; total={total}"
 LLM_PROVIDER_REQUIRED_ERROR = "需要设置 LLMProvider 才能调用 LLM"
 INTERACTION_PARSE_ERROR = "交互格式解析失败: {error}"
@@ -168,7 +198,9 @@ VARIABLE_DEFAULT_VALUE = "UNKNOWN"
 # Context generation constants
 CONTEXT_QUESTION_MARKER = "# 相关问题"
 CONTEXT_CONVERSATION_MARKER = "# 对话上下文"
+CONTEXT_BUTTON_OPTIONS_MARKER = "## 预定义选项"
 
 # Context generation templates
 CONTEXT_QUESTION_TEMPLATE = f"{CONTEXT_QUESTION_MARKER}\n{{question}}"
 CONTEXT_CONVERSATION_TEMPLATE = f"{CONTEXT_CONVERSATION_MARKER}\n{{content}}"
+CONTEXT_BUTTON_OPTIONS_TEMPLATE = f"{CONTEXT_BUTTON_OPTIONS_MARKER}\n可选的预定义选项包括：{{button_options}}\n注意：用户如果选择了这些选项，都应该接受；如果输入了自定义内容，应检查是否与选项主题相关。"