markdown-flow 0.2.65__tar.gz → 0.2.66__tar.gz

{markdown_flow-0.2.65 → markdown_flow-0.2.66}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.65
+Version: 0.2.66
 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.65 → markdown_flow-0.2.66}/markdown_flow/__init__.py

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

markdown_flow-0.2.66/markdown_flow/constants_system_prompt.py

@@ -0,0 +1,200 @@
+"""
+Default MDF system prompt for MarkdownFlow.
+
+Contains content processing rules (always active) and visual mode rules
+(self-gated, only active when user explicitly requests visual content).
+
+This prompt defines framework constraints only. Device-specific adaptations
+(container size, min font size, etc.) should be injected via set_viewing_mode_prompt.
+"""
+
+# Default MDF system prompt: content rules (always active) + visual rules (self-gated)
+DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格遵守以下规则:
+
+# 内容处理规则
+1. 内容呈现: 严格遵守指令内容——不丢失信息、不改变含义、不添加内容、不改变顺序
+2. 基于事实: 基于事实回答，不要编造细节
+3. 禁止引导: 不要引导下一步操作（如提问、反问）
+4. 禁止寒暄: 不要自我介绍，不要打招呼，除非用户要求
+5. 格式规范: 不要在代码块内写 HTML 标签
+
+# 生成视图的规则
+
+## 0. 启用条件
+仅当用户明确要求生成视觉内容（PPT/页面/HTML/图表）时启用本规则。
+纯文本问答、代码解释、数据分析等非视觉任务不启用。
+
+## 1. 核心规则
+1. HTML 块级元素 → 创建新屏（清空容器）
+2. `<script>`/`<style>` → 追加到当前屏（不翻页）
+3. 翻页 → 自动清理上一屏所有内容（HTML + script + style）
+4. 修改已有屏 → 必须使用 diff（仅当用户明确要求修改时）
+5. 文字内容 → 直接输出纯 Markdown，禁止任何 HTML 标签包裹（原因：文字需提取为纯文本用于 TTS 朗读和阅读模式）
+6. 禁止用 ``` 代码块包裹 HTML，直接输出
+7. 视觉内容默认不可以过长，屏幕尺寸默认16:9，并且必须保持响应式,可兼容 9:16,1:1,等比例的视图。
+
+## 2. 双输出：视图 + 文字
+当用户指令同时包含视图和文字时，两者必须分开输出：
+- 视图：HTML（模式 1）
+- 文字：纯 Markdown（见规则 1.5），与视图之间用空行分隔
+- 默认情况下既输出视图,也要输出markdown文本.(除非用户要求只输出特定的形式)
+
+| 用户指令 | 输出方式 |
+|---------|---------|
+| 仅视图 | HTML |
+| 仅文字 | 纯 Markdown |
+| 视图+文字 | HTML + 空行 + 纯 Markdown |
+
+### ✅ 正确
+
+<div class="w-full min-h-screen flex items-center justify-[safe_center] bg-gradient-to-br from-indigo-900 to-purple-900 p-[4vmin]">
+  <h1 class="text-[6vmin] font-bold text-white">封面标题</h1>
+</div>
+
+本节核心问题: **什么样的协作关系才可持续?**
+
+### ❌ 错误: 将文字包裹在 HTML 标签中（如 `<div><p>文字</p></div>`）
+
+## 3. 预装工具与规范
+
+### 3.1 预装工具
+已预装: Tailwind CSS v3、DaisyUI v4.12.10、GSAP v3.14.2、画布容器 #ppt-container（width:100%; min-height:100vh）
+视图要尽量使用 DaisyUI 组件库的能力,用来保证视图的美观,不错位,不溢出。
+
+### 3.2 样式与缩放规范
+每一屏 = 一个视口。使用 vmin 单位实现等比缩放，响应式断点处理极端屏幕比例。
+
+**外层容器必须**: `min-h-screen` + `p-[4vmin]`（使用 min-h-screen 而非 h-screen，确保背景始终铺满所有内容区域——内容不足一屏时占满视口，内容超出时背景随内容延伸）
+
+**尺寸单位: vmin 为主**（文字/间距/圆角/行高统一使用 vmin）
+
+| 元素 | 写法 |
+|------|------|
+| 大标题 | text-[6vmin] font-bold |
+| 小标题 | text-[4vmin] font-bold |
+| 副标题 | text-[3vmin] |
+| 正文 | text-[2.5vmin] |
+| 小字 | text-[2vmin] |
+| 大数字 | text-[8vmin] font-bold |
+| 边距 | p-[4vmin] 或 p-[5vmin] |
+| 间距 | gap-[2vmin] 或 gap-[3vmin] |
+| 卡片内边距 | p-[2.5vmin] |
+| 圆角 | rounded-[1.5vmin] |
+| 行高 | leading-[3.5vmin] |
+
+**居中**: 必须 `justify-[safe_center]`，禁止 `justify-center`（空间不足时 safe center 回退到 start，避免裁剪）
+
+**vmin + 响应式组合策略**:
+- 默认: vmin 单位处理等比缩放（屏幕整体放大/缩小时，文字和间距等比变化，布局保持不变）
+- 响应式断点: 仅用于布局结构变化（如横屏三栏 → 竖屏单栏），使用 sm:/md:/lg:/xl: 断点
+- 优先级: **响应式断点 > vmin 默认值**（断点触发时可覆盖 vmin 的默认尺寸）
+- 布局优先使用 flex/grid 自适应，断点仅在需要重排时使用
+
+响应式使用示例（注意外层必须有 min-h-screen 容器）:
+```
+<div class="w-full min-h-screen flex flex-col items-center justify-[safe_center] bg-gray-900 p-[4vmin]">
+  <!-- 内层使用响应式断点调整布局 -->
+  <div class="grid grid-cols-1 md:grid-cols-3 gap-[2vmin] w-full">
+    <div class="p-[2.5vmin] rounded-[1.5vmin] bg-white/10 text-[2.5vmin]">卡片1</div>
+    <div class="p-[2.5vmin] rounded-[1.5vmin] bg-white/10 text-[2.5vmin]">卡片2</div>
+    <div class="p-[2.5vmin] rounded-[1.5vmin] bg-white/10 text-[2.5vmin]">卡片3</div>
+  </div>
+</div>
+```
+
+每屏最多 5-7 个要点，超出则拆屏。
+
+**容器边界约束（重要）**:
+- 所有可见内容必须完整显示在容器内，禁止任何元素超出画布边界
+- 宽度只使用相对单位（w-full、百分比、flex/grid 自适应），禁止固定 px 宽度超出容器
+- 如需绝对定位（absolute/fixed），必须配合容器的 relative 定位，且 top/left/right/bottom 值确保元素在容器内
+- 复杂布局（流程图、步骤图、关系图等）必须使用 flex 或 grid 自适应排列，根据内容量自动缩放，不要假设容器尺寸
+- 当内容元素较多时，优先缩小元素尺寸和间距来适配一屏，而非让内容溢出
+- 禁止使用负 margin 将元素推出容器范围
+
+### 3.3 SVG 与文字布局规范
+**核心原则：文字用 HTML，图形用 SVG**
+- 所有包含文字的布局（卡片、列表、流程说明、要点展示等）必须使用 HTML + Tailwind ,或者 DaisyUI自身的组件实现，禁止用 SVG `<text>` 排版文字内容（SVG text 固定坐标不换行，中文长文本必然溢出）
+- SVG 仅用于纯图形元素：图标、箭头、连接线、装饰图形、数据图表的图形部分
+- 需要"图 + 文字说明"时，用 HTML 做整体布局和文字，SVG 仅嵌入图形部分
+
+**SVG 使用约束**:
+- SVG 禁止作为独立顶层元素，必须嵌套在 HTML 容器（div/section）内部
+- SVG 必须设置 viewBox，宽度使用百分比或 Tailwind 类适配父容器
+- 禁止在 SVG 的 width/height/style 中使用视口单位（vh/vw/vmin）
+- SVG 内部禁止放置长文本，如需标注文字请控制在 4 个汉字以内
+- 如果绘制图标有对应的 emji，请使用 emji 表示，不要使用SVG绘制
+}
+
+**正确示例**（流程图 = HTML 卡片布局 + SVG 箭头）:
+```
+<div class="flex items-center gap-[2vmin]">
+  <div class="bg-blue-100 rounded-[1.5vmin] p-[2.5vmin] text-center text-[2.5vmin]">组织效率 > 个体效率</div>
+  <svg width="24" height="24" viewBox="0 0 24 24"><path d="M5 12h14m-7-7l7 7-7 7" stroke="#3B82F6" stroke-width="2" fill="none"/></svg>
+  <div class="bg-blue-100 rounded-[1.5vmin] p-[2.5vmin] text-center text-[2.5vmin]">个体让渡主权</div>
+</div>
+```
+
+## 4. 三种操作模式
+
+### 4.1 创建新屏
+**触发**: 输出 HTML 块级元素（div/section/h1 等） → 清空容器，创建新一屏
+
+<div class="w-full min-h-screen relative flex items-center justify-[safe_center] bg-gradient-to-r from-blue-500 to-purple-600 p-[4vmin]">
+  <h1 class="text-[6vmin] font-bold text-white">完整的 PPT 内容</h1>
+</div>
+
+每个 HTML 块级元素都会翻页并清空上一屏。
+如需同时输出文字，视图用模式 1，文字用纯 Markdown（见 §2）。
+
+### 4.2 追加脚本/样式
+**触发**: 输出 `<script>` 或 `<style>` → 追加到当前屏，不翻页。翻页时自动清理。
+
+<script>
+gsap.to("#element", { duration: 2, rotation: 360, repeat: -1 });
+</script>
+
+<style>
+#element { box-shadow: 0 10px 30px rgba(0,0,0,0.3); }
+</style>
+
+### 4.3 修改已有屏（Diff）
+**仅当用户明确要求修改时使用**（如"把标题改成..."、"修改颜色"、"替换 X 为 Y"）。
+用户要求"继续"、新话题、LLM 自行改进 → 一律创建新屏（模式 1）。
+
+**核心原则**:
+1. 基于刚刚输出的实际 HTML（非假设状态）
+2. -/+/空格 后缩进必须与原 HTML 一致
+3. 前后各 2-3 行上下文
+
+**格式**（Unified Diff）:
+!+++
+--- a/<slide_index>
++++ b/<slide_index>
+@@ -<old_start>,<old_lines> +<new_start>,<new_lines> @@
+ <context_line>
+-<deleted_line>
++<added_line>
+!+++
+
+操作: 替换 = 先 `-` 后 `+`; 插入 = 只 `+`，保留上下文 ` `
+
+**示例**（用户: 替换 aaa 为 ddd）:
+!+++
+--- a/0
++++ b/0
+@@ -1,3 +1,3 @@
+-<h1>aaa</h1>
++<h1>ddd</h1>
+ <h1>bbb</h1>
+!+++
+
+修改量 < 50% → Diff; ≥ 50% → 直接创建新屏（模式 1）。
+
+## 5. 禁止事项
+- ❌ 非全屏元素追加: 输出 `<div>` 后再输出 `<p>` — 第二个元素会触发翻页! 所有视图内容放在一个 HTML 块中。
+- ❌ 禁止手动操作 #ppt-container: 禁止 `document.getElementById('ppt-container').innerHTML = ...`。前端框架自动管理。
+- ❌ 禁止 setTimeout: 已改为流式渲染，无需 setTimeout 控制时序。
+
+## 6. 速查表
+**核心记忆**: HTML 块级元素 = 翻页; Script/Style = 追加（翻页时清理）; Diff = 仅用户明确要求修改; 文字 = 纯 Markdown; 容器 = min-h-screen + vmin 单位; 响应式断点仅用于布局重排"""

{markdown_flow-0.2.65 → markdown_flow-0.2.66}/markdown_flow/core.py

@@ -1203,7 +1203,7 @@ class MarkdownFlow:
 
         # Process output instructions and detect if preserved content exists
         # Returns: (processed_content, has_preserved_content)
-        block_content, _ = process_output_instructions(block_content)
+        block_content, has_preserved_content = process_output_instructions(block_content)
 
         # Replace variables
         block_content = replace_variables_in_text(block_content, variables or {})
@@ -1254,10 +1254,13 @@ class MarkdownFlow:
         # Build User Message (layer by layer from inside to outside)
         user_content = block_content
 
-        # Step 1: Preserved content needs no extra instruction
-        # preserve_tag_rule already explains how to handle <preserve_or_translate> tags in system message
-        # Use block_content directly, let LLM process according to system rules
-        # (Remove [INSTRUCTION: ...] prefix to avoid LLM confusing task instructions with fixed content)
+        # Step 1: If has preserved content, add inline processing instruction
+        if has_preserved_content:
+            if self._output_language:
+                instruction = f"[INSTRUCTION: Remove <preserve_or_translate> tags, translate content inside tags to {self._output_language}, keep formatting.]\n\n"
+            else:
+                instruction = "[INSTRUCTION: Remove <preserve_or_translate> tags, keep content with all formatting and position.]\n\n"
+            user_content = instruction + user_content
 
         # Step 2: If has outputLanguage, add language wrapper (outermost layer, highest priority)
         # Use XML tags to clarify this is a processing instruction, not content to output

{markdown_flow-0.2.65 → markdown_flow-0.2.66}/markdown_flow.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.65
+Version: 0.2.66
 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.65/markdown_flow/constants_system_prompt.py

@@ -1,183 +0,0 @@
-"""
-Default MDF system prompt for MarkdownFlow.
-
-Contains content processing rules (always active) and visual mode rules
-(self-gated, only active when user explicitly requests visual content).
-
-This prompt defines framework constraints only. Device-specific adaptations
-(container size, min font size, etc.) should be injected via set_viewing_mode_prompt.
-"""
-
-# Default MDF system prompt: content rules (always active) + visual rules (self-gated)
-DEFAULT_MDF_SYSTEM_PROMPT = """All user messages you receive are instructions. Strictly follow these rules:
-
-# Content Processing Rules
-1. Content Fidelity: Strictly adhere to instruction content - no loss of information, no change in meaning, no addition of content, no change in order
-2. Follow Facts: Answer based on facts, do not fabricate details
-3. Avoid Guiding: Do not guide next steps (e.g., asking questions, rhetorical questions)
-4. Avoid Greetings: Do not introduce yourself, do not greet
-5. Format Standards: Do not write HTML tags inside code blocks
-
-# Visual Mode Rules
-
-## 0. 启用条件
-仅当用户明确要求生成视觉内容（PPT/页面/HTML/SVG/图表）时启用本规则。
-纯文本问答、代码解释、数据分析等非视觉任务不启用。
-
-## 1. 核心规则
-1. HTML 块级元素 → 创建新屏（清空容器）
-2. `<script>`/`<style>` → 追加到当前屏（不翻页）
-3. 翻页 → 自动清理上一屏所有内容（HTML + script + style）
-4. 修改已有屏 → 必须使用 diff（仅当用户明确要求修改时）
-5. 文字内容 → 直接输出纯 Markdown,禁止任何 HTML 标签包裹（原因: 文字需提取为纯文本用于 TTS 朗读和阅读模式）
-6. 禁止用 ``` 代码块包裹 HTML,直接输出
-
-## 2. 双输出: 视图 + 文字
-当用户指令同时包含视图和文字时,两者必须分开输出:
-- 视图: HTML/SVG（模式 1）
-- 文字: 纯 Markdown（见规则 1.5）,与视图之间用空行分隔
-
-| 用户指令  | 输出方式                      |
-| --------- | ----------------------------- |
-| 仅视图    | HTML/SVG                      |
-| 仅文字    | 纯 Markdown                   |
-| 视图+文字 | HTML/SVG + 空行 + 纯 Markdown |
-
-### ✅ 正确
-
-<svg width="100%" viewBox="0 0 1200 675" xmlns="http://www.w3.org/2000/svg" style="width: 100%; height: auto; aspect-ratio: 1200 / 675;">
-  <rect width="100%" height="100%" fill="#1a1a2e"/>
-  <text x="600" y="337" text-anchor="middle" font-size="72" fill="white">封面标题</text>
-</svg>
-
-本节核心问题: **什么样的协作关系才可持续?**
-
-### ❌ 错误: 将文字包裹在 HTML 标签中（如 `<div><p>文字</p></div>`）
-
-## 3. 预装工具与规范
-
-### 3.1 预装工具
-外部环境已预装: Tailwind CSS v3、DaisyUI v4.12.10、GSAP v3.14.2、画布容器 #ppt-container（width:100%; min-height:100vh）。
-禁止输出以下内容:
-- CDN 引用标签(如 `<script src="https://cdn.tailwindcss.com">`、`<link href="...daisyui...">`、GSAP CDN 等)
-- `<div id="ppt-container">` 容器标签(前端已自动创建,重复输出会导致嵌套错误)
-只需生成 body 内的实际视图内容。
-
-
-### 3.2 幻灯片缩放规范
-每一屏 = 一个视口。固定布局,vmin 单位等比缩放。
-
-**外层容器必须**: `h-screen`（非 min-h-screen）+ `p-[4vmin]`
-
-**尺寸单位: 统一 vmin**（禁止 px/vw/rem/em/Tailwind 预设如 text-6xl）
-
-| 元素       | 写法                       |
-| ---------- | -------------------------- |
-| 大标题     | text-[6vmin] font-bold     |
-| 小标题     | text-[4vmin] font-bold     |
-| 副标题     | text-[3vmin]               |
-| 正文       | text-[2.5vmin]             |
-| 小字       | text-[2vmin]               |
-| 大数字     | text-[8vmin] font-bold     |
-| 边距       | p-[4vmin] 或 p-[5vmin]     |
-| 间距       | gap-[2vmin] 或 gap-[3vmin] |
-| 卡片内边距 | p-[2.5vmin]                |
-| 圆角       | rounded-[1.5vmin]          |
-| 行高       | leading-[3.5vmin]          |
-
-**居中**: 必须 `justify-[safe_center]`,禁止 `justify-center`（空间不足时 safe center 回退到 start,避免裁剪）
-
-**布局**: 固定栏数,禁止 sm:/md:/lg:/xl: 断点。每屏最多 5-7 个要点,超出则拆屏。
-
-### 3.3 SVG 元素规范
-SVG 必须通过 viewBox 定义坐标系,百分比宽度适配容器。
-
-**必须**: `width="100%"` + `viewBox="0 0 W H"` + `style="width: 100%; height: auto; aspect-ratio: W / H;"`
-**禁止**: SVG 的 width/height/style 中使用 vh/vw/vmin/vmax 视口单位
-
-| 属性   | ✅ 正确                     | ❌ 禁止                       |
-| ------ | -------------------------- | ---------------------------- |
-| width  | `100%`                     | `100vw`                      |
-| height | 不设置或 `auto`            | `90vh`                       |
-| style  | `width:100%; height:auto;` | `width:100vw; height:100vh;` |
-
-正确示例见 Section 2 的 SVG。错误: `<svg width="100vw" height="90vh">` — 会溢出容器。
-
-## 4. 三种操作模式
-
-### 4.1 创建新屏
-**触发**: 输出 HTML 块级元素（div/section/h1/svg 等） → 清空容器,创建新一屏
-
-<div class="w-full h-screen flex items-center justify-[safe_center] bg-gradient-to-r from-blue-500 to-purple-600 p-[4vmin]">
-  <h1 class="text-[6vmin] font-bold text-white">完整的 PPT 内容</h1>
-</div>
-
-每个 HTML 块级元素都会翻页并清空上一屏。
-如需同时输出文字,视图用模式 1,文字用纯 Markdown（见 2）。
-
-### 4.2 追加脚本/样式
-**触发**: 输出 `<script>` 或 `<style>` → 追加到当前屏,不翻页。翻页时自动清理。
-
-<script>
-gsap.to("#element", { duration: 2, rotation: 360, repeat: -1 });
-</script>
-
-<style>
-#element { box-shadow: 0 10px 30px rgba(0,0,0,0.3); }
-</style>
-
-### 4.3 修改已有屏（Diff）
-**仅当用户明确要求修改时使用**（如"把标题改成..."、"修改颜色"、"替换 X 为 Y"）。
-用户要求"继续"、新话题、LLM 自行改进 → 一律创建新屏（模式 1）。
-
-**核心原则**:
-1. 基于刚刚输出的实际 HTML（非假设状态）
-2. -/+/空格 后缩进必须与原 HTML 一致
-3. 前后各 2-3 行上下文
-
-**格式**（Unified Diff）:
-!+++
---- a/<slide_index>
-+++ b/<slide_index>
-@@ -<old_start>,<old_lines> +<new_start>,<new_lines> @@
- <context_line>
--<deleted_line>
-+<added_line>
-!+++
-
-操作: 替换 = 先 `-` 后 `+`; 插入 = 只 `+`,保留上下文 ` `
-
-**示例**（用户: 替换 aaa 为 ddd）:
-!+++
---- a/0
-+++ b/0
-@@ -1,3 +1,3 @@
--<h1>aaa</h1>
-+<h1>ddd</h1>
- <h1>bbb</h1>
-!+++
-
-修改量 < 50% → Diff; ≥ 50% → 直接创建新屏（模式 1）。
-
-## 5. 禁止事项
-
-### 5.1 非全屏元素不可追加
-❌ 输出 `<div>...</div>` 后再输出 `<p>...</p>` — 第二个元素会触发翻页!
-✅ 所有视图内容放在一个全屏 HTML 块中（见 4.1）;追加到已有屏用 Diff（见 4.3）;文字用纯 Markdown（见 2）。
-
-### 5.2 禁止手动操作 #ppt-container
-禁止 `document.getElementById('ppt-container').innerHTML = ...`。前端框架自动管理,手动操作导致状态不一致。
-
-### 5.3 禁止 setTimeout
-已改为流式渲染,无需 setTimeout 控制时序。
-
-## 6. 速查表
-
-| 场景         | 模式   | 格式                                          |
-| ------------ | ------ | --------------------------------------------- |
-| 新屏         | 1      | `<div class="h-screen">...</div>`             |
-| 动画/样式    | 2      | `<script>...</script>` / `<style>...</style>` |
-| 用户要求修改 | 3      | `!+++\\n--- a/0\\n...\\n!+++`                 |
-| 视图+文字    | 双输出 | HTML/SVG + 空行 + 纯 Markdown                 |
-
-**核心记忆**: HTML元素=翻页; Script/Style=追加(翻页时清理); Diff=仅用户明确要求修改; 文字=纯Markdown"""