markdown-flow 0.2.77__tar.gz → 0.2.79__tar.gz

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.77
+Version: 0.2.79
 Summary: An agent library designed to parse and process MarkdownFlow documents
 Project-URL: Homepage, https://github.com/ai-shifu/markdown-flow-agent-py
 Project-URL: Bug Tracker, https://github.com/ai-shifu/markdown-flow-agent-py/issues

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/markdown_flow/__init__.py

@@ -88,5 +88,5 @@ __all__ = [
     "replace_variables_in_text",
 ]
 
-__version__ = "0.2.77"
+__version__ = "0.2.79"
 # __version__ = "0.2.45-alpha-1"

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/markdown_flow/constants.py

@@ -86,24 +86,21 @@ OUTPUT_LANGUAGE_INSTRUCTION_BOTTOM = """<output_language_final_check>
 </output_language_final_check>"""
 
 # Interaction prompt templates (Modular design)
-INTERACTION_PROMPT_BASE = """<interaction_processing_rules>
-⚠️⚠️⚠️ JSON 处理任务 ⚠️⚠️⚠️
+INTERACTION_PROMPT_BASE = """# JSON 交互翻译任务
 
-## 任务说明
-
-你将收到一个包含交互元素的 JSON 对象（buttons 和/或 question 字段）。
+你将收到一个包含交互元素的 JSON 对象（`buttons` 和/或 `question` 字段），需要把其中的文本翻译为目标语言。
 
 ## 输出格式要求
 
-- **必须返回纯 JSON**，不要添加任何解释或 markdown 代码块
-- **格式必须与输入完全一致**，包括空格、标点、引号
-- 不要添加或删除任何字段
-- 不要修改 JSON 的结构"""
+- 必须返回纯 JSON，不要添加任何解释或 markdown 代码块
+- JSON 结构必须与输入完全一致：不增删字段、不修改键名、不调整顺序
+- 保留原有的空格、标点和引号"""
 
 INTERACTION_PROMPT_NO_TRANSLATION = """
 ## 处理规则
 
-**逐字符原样返回输入的 JSON**
+逐字符原样返回输入的 JSON：
+
 - 不翻译任何文本
 - 不修改任何格式
 - 不添加任何内容（如 display//value 分离）
@@ -112,23 +109,22 @@ INTERACTION_PROMPT_NO_TRANSLATION = """
 
 ## 示例
 
-输入：{"buttons": ["产品经理", "开发者"], "question": "其他身份"}
-
-✅ 输出：{"buttons": ["产品经理", "开发者"], "question": "其他身份"}
-</interaction_processing_rules>"""
+- 输入 `{"buttons": ["产品经理", "开发者"], "question": "其他身份"}`
+- 输出 `{"buttons": ["产品经理", "开发者"], "question": "其他身份"}`"""
 
 INTERACTION_PROMPT_WITH_TRANSLATION = """
-## 处理规则
+## 翻译规则
+
+- 将 `buttons` 和 `question` 中的文本翻译为目标语言
+- 仅翻译显示文本（Display 部分），不改变 JSON 结构
+- 如果存在 `display//value` 分离（如 `Yes//1`），只翻译 `//` 前的 Display 部分，保留 value 不变
+- 100% 使用目标语言，不允许混排；先把所有非目标语言的词翻译完再输出
+- 若某段文本的原文语言已与目标语言一致，则原样返回该文本（例如目标语言为中文、原文也是中文时不做任何改写）
 
-**将 buttons 和 question 文本翻译到指定语言**
-- 保持 JSON 格式完全不变
-- 仅翻译显示文本（Display 部分），不改变结构
-- 如果存在 display//value 分离，只翻译 display 部分，保留 value 不变
-- 100% 纯目标语言，ZERO 混排
-- 先翻译所有非目标语言的词，再输出
+## 示例
 
-示例：{"buttons": ["Yes//1", "No//0"]} → 西班牙语 → {"buttons": ["Sí//1", "No//0"]}
-</interaction_processing_rules>"""
+- 输入 `{"buttons": ["Yes//1", "No//0"]}`，目标语言西班牙语 → `{"buttons": ["Sí//1", "No//0"]}`
+- 输入 `{"buttons": ["初级", "高级"], "question": "其他"}`，目标语言英语 → `{"buttons": ["Beginner", "Advanced"], "question": "Other"}`"""
 
 # Default: use no translation version (backward compatible)
 DEFAULT_INTERACTION_PROMPT = INTERACTION_PROMPT_BASE + "\n" + INTERACTION_PROMPT_NO_TRANSLATION

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/markdown_flow/core.py

@@ -690,6 +690,20 @@ class MarkdownFlow:
                 },
             )
 
+        # If no output language is configured, skip translation entirely:
+        # return the interaction content as-is without any LLM call.
+        if not self._output_language:
+            return LLMResult(
+                content=processed_block.content,
+                type=ElementType.INTERACTION,
+                number=block_index,
+                metadata={
+                    "block_type": "interaction",
+                    "block_index": block_index,
+                    "translation_skipped": True,
+                },
+            )
+
         # Build translation messages
         messages = self._build_translation_messages(translatable_json)
 
@@ -1315,26 +1329,19 @@ class MarkdownFlow:
         """
         messages = []
 
-        # Build system message: choose template based on whether outputLanguage exists
+        # Build system message. This method is only reached when an output
+        # language is configured (callers short-circuit otherwise), so the
+        # prompt always performs translation.
         system_parts = []
 
-        # Determine if translation is needed
-        need_translation = self._output_language is not None and self._output_language != ""
+        # 1. Output language anchoring (top)
+        system_parts.append(OUTPUT_LANGUAGE_INSTRUCTION_TOP.format(self._output_language))
 
-        if need_translation:
-            # Translation scenario: language anchoring + translation rules
-            # 1. Output language anchoring (top)
-            system_parts.append(OUTPUT_LANGUAGE_INSTRUCTION_TOP.format(self._output_language))
+        # 2. Interaction processing base + translation rules
+        system_parts.append(INTERACTION_PROMPT_BASE + "\n" + INTERACTION_PROMPT_WITH_TRANSLATION)
 
-            # 2. Interaction processing base + translation rules
-            system_parts.append(INTERACTION_PROMPT_BASE + "\n" + INTERACTION_PROMPT_WITH_TRANSLATION)
-
-            # 3. Output language anchoring (bottom)
-            system_parts.append(OUTPUT_LANGUAGE_INSTRUCTION_BOTTOM.format(self._output_language))
-        else:
-            # No translation scenario: use default no-translation prompt
-            # Use default prompt (includes Base + NoTranslation)
-            system_parts.append(self._interaction_prompt)
+        # 3. Output language anchoring (bottom)
+        system_parts.append(OUTPUT_LANGUAGE_INSTRUCTION_BOTTOM.format(self._output_language))
 
         # Combine all parts
         system_content = "\n\n".join(system_parts)

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/markdown_flow/system_prompt.md

@@ -33,6 +33,7 @@
 ```
 
 每屏 HTML 后必须紧跟：
+
 ```
 <style>
 *,*::before,*::after{box-sizing:border-box;overflow-wrap:break-word;word-wrap:break-word}
@@ -60,6 +61,7 @@
 
 **方式 B：浮动层 DOM 节点**
 若必须使用独立元素，必须同时满足：
+
 - `position:absolute`（父级须为 `position:relative`，外层容器已默认满足）
 - `pointer-events:none`（不拦截交互）
 - `z-index:0` 或负值（置于主内容之下）
@@ -81,6 +83,7 @@
 - **禁止使用 DaisyUI 的 steps 组件**（`.steps` / `.step`）：该组件仅承载"一行短标签"的进度指示，不支持图标+标题+描述多层内容，塞入多个 `<span>` 或 `<div>` 都会让 grid 布局崩坏（圆点错位、文字被挤成窄列竖排换行等）；凡是"步骤"需求全部走 timeline
 
 **timeline 组件正确用法**
+
 - 容器：`<ul class="timeline timeline-vertical">`（横向用 `timeline-horizontal`，紧凑用 `timeline-compact`），直接子元素必须是 `<li>`
 - 每个 `<li>` 按需组合以下槽位（块级元素只能是这些 class，不能放无 class 的裸 `<div>`）：
   - `<div class="timeline-start timeline-box">起始侧内容</div>`：左/上侧内容，加 `timeline-box` 会渲染为卡片
@@ -95,12 +98,15 @@
 ## 3. 操作模式
 
 ### 3.1 创建新屏
+
 输出 HTML 块级元素 → 清空容器，创建新一屏。
 
 ### 3.2 追加脚本/样式
+
 输出 `<script>` 或 `<style>` → 追加到当前屏，不翻页。
 
 ### 3.3 修改已有屏（Diff）
+
 仅当用户明确要求修改时使用。格式：
 
 !+++
@@ -129,5 +135,6 @@
 11. 禁止在布局流中出现纯装饰性的块级/行内元素，装饰必须遵循 2.2 节的 CSS 背景或浮动层方式
 12. 视图中禁止生成body 之外的元素基本已div 为主 禁止生成`<head>` `<!DOCTYPE html>`
 13. 以纯文本形式输出HTML，**禁止**使用```html或任何代码块标记。比如：
+
 ```html
 <div style="width:100%; min-height:100vh; overflow-x:hidden; overflow-y:auto; display:flex; flex-direction:column; align-items:center; padding:1em; font-size:clamp(12px,calc(100vw/48),3vh)">

{markdown_flow-0.2.77 → markdown_flow-0.2.79}/markdown_flow.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.77
+Version: 0.2.79
 Summary: An agent library designed to parse and process MarkdownFlow documents
 Project-URL: Homepage, https://github.com/ai-shifu/markdown-flow-agent-py
 Project-URL: Bug Tracker, https://github.com/ai-shifu/markdown-flow-agent-py/issues