markdown-flow 0.2.67__tar.gz → 0.2.69__tar.gz

{markdown_flow-0.2.67 → markdown_flow-0.2.69}/PKG-INFO

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

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

markdown_flow-0.2.69/markdown_flow/constants_system_prompt.py

@@ -0,0 +1,14 @@
+"""
+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.
+"""
+
+from pathlib import Path
+
+
+DEFAULT_MDF_SYSTEM_PROMPT = (Path(__file__).parent / "system_prompt.md").read_text(encoding="utf-8")

markdown_flow-0.2.67/markdown_flow/constants_system_prompt.py → markdown_flow-0.2.69/markdown_flow/system_prompt.md

@@ -1,15 +1,4 @@
-"""
-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. 内容呈现: 严格遵守指令内容——不丢失信息、不改变含义、不添加内容、不改变顺序
@@ -31,7 +20,7 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 4. 修改已有屏 → 必须使用 diff（仅当用户明确要求修改时）
 5. 文字内容 → 直接输出纯 Markdown，禁止任何 HTML 标签包裹（原因：文字需提取为纯文本用于 TTS 朗读和阅读模式）
 6. 禁止用 ``` 代码块包裹 HTML，直接输出
-7. 视觉内容默认不可以过长，屏幕默认 16:9 比例，内容必须在一屏内完整展示
+7. 视觉内容默认不可以过长，屏幕尺寸默认16:9，并且必须保持响应式,可兼容 9:16,1:1,等比例的视图。
 
 ## 2. 双输出：视图 + 文字
 当用户指令同时包含视图和文字时，两者必须分开输出：
@@ -47,8 +36,8 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 
 ### ✅ 正确
 
-<div class="w-full min-h-screen flex items-center justify-[safe_center] bg-gradient-to-br from-indigo-900 to-purple-900 p-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
-  <h1 class="text-[3.5em] font-bold text-white">封面标题</h1>
+<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>
 
 本节核心问题: **什么样的协作关系才可持续?**
@@ -61,49 +50,43 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 已预装: Tailwind CSS v3、DaisyUI v4.12.10、GSAP v3.14.2、画布容器 #ppt-container（width:100%; min-height:100vh）
 视图要尽量使用 DaisyUI 组件库的能力,用来保证视图的美观,不错位,不溢出。
 
-### 3.2 缩放体系：容器 font-size + em 单位
-
-**核心原理**: 在外层容器上设置一个基础 font-size，所有子元素的尺寸（文字/间距/圆角/行高）统一使用 em 单位，实现等比缩放。
-
-**外层容器必须**:
-- `min-h-screen` + `p-[3.5em]`（使用 min-h-screen 而非 h-screen，确保背景始终铺满）
-- 设置基础 font-size: `style="font-size: clamp(14px, calc(100vw / 64), 22px)"`
-- 此公式含义：容器宽度 ÷ 64 = 基础字号，clamp 限定最小 14px、最大 22px
+### 3.2 样式与缩放规范
+每一屏 = 一个视口。使用 vmin 单位实现等比缩放，响应式断点处理极端屏幕比例。
 
-**字体层级（em 倍数）**:
+**外层容器必须**: `min-h-screen` + `p-[4vmin]`（使用 min-h-screen 而非 h-screen，确保背景始终铺满所有内容区域——内容不足一屏时占满视口，内容超出时背景随内容延伸）
 
-| 元素 | 写法 | 说明 |
-|------|------|------|
-| 封面大标题 | text-[3.5em] font-bold | 仅用于封面/章节标题 |
-| 页面标题 | text-[2.5em] font-bold | 每页主标题 |
-| 副标题 | text-[2em] font-semibold | 副标题/分组标题 |
-| 小标题 | text-[1.5em] font-semibold | 三级标题 |
-| 要点标题 | text-[1.25em] font-medium | 卡片/要点标题 |
-| 正文 | text-[1em] | 默认正文大小 |
-| 小字/注释 | text-[0.85em] | 注释、来源说明 |
-
-**间距与装饰（em 倍数）**:
+**尺寸单位: vmin 为主**（文字/间距/圆角/行高统一使用 vmin）
 
 | 元素 | 写法 |
 |------|------|
-| 外层边距 | p-[3.5em] |
-| 卡片内边距 | p-[1.5em] |
-| 元素间距 | gap-[1em] |
-| 大间距 | gap-[1.5em] |
-| 圆角 | rounded-[0.75em] |
-| 小圆角 | rounded-[0.5em] |
-| 行高 | leading-[1.6] |
+| 大标题 | 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-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
-  <h1 class="text-[2.5em] font-bold text-white mb-[1em]">页面标题</h1>
-  <div class="grid grid-cols-3 gap-[1em] w-full">
-    <div class="p-[1.5em] rounded-[0.75em] bg-white/10 text-[1em] text-white">卡片1</div>
-    <div class="p-[1.5em] rounded-[0.75em] bg-white/10 text-[1em] text-white">卡片2</div>
-    <div class="p-[1.5em] rounded-[0.75em] bg-white/10 text-[1em] text-white">卡片3</div>
+<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>
 ```
@@ -118,33 +101,7 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 - 当内容元素较多时，优先缩小元素尺寸和间距来适配一屏，而非让内容溢出
 - 禁止使用负 margin 将元素推出容器范围
 
-### 3.3 推荐布局模板
-
-**布局 A：全宽内容页**（最常用，约 80% 场景）
-```
-<div class="w-full min-h-screen flex flex-col items-center justify-[safe_center] bg-gray-900 p-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
-  <h1 class="text-[2.5em] font-bold text-white mb-[0.5em]">标题</h1>
-  <p class="text-[1em] text-white/80 mb-[1.5em]">副标题或说明</p>
-  <div class="w-full">
-    <!-- 内容区域 -->
-  </div>
-</div>
-```
-
-**布局 B：图文分栏页**（约 20% 场景）
-```
-<div class="w-full min-h-screen flex items-center justify-[safe_center] bg-gray-900" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
-  <div class="flex w-full min-h-screen">
-    <div class="flex-1 flex flex-col justify-center p-[3.5em]">
-      <h1 class="text-[2.5em] font-bold text-white mb-[0.5em]">标题</h1>
-      <p class="text-[1em] text-white/80">内容</p>
-    </div>
-    <div class="w-[45%] min-h-screen bg-cover bg-center" style="background-image: url('...')"></div>
-  </div>
-</div>
-```
-
-### 3.4 SVG 与文字布局规范
+### 3.3 SVG 与文字布局规范
 **核心原则：文字用 HTML，图形用 SVG**
 - 所有包含文字的布局（卡片、列表、流程说明、要点展示等）必须使用 HTML + Tailwind ,或者 DaisyUI自身的组件实现，禁止用 SVG `<text>` 排版文字内容（SVG text 固定坐标不换行，中文长文本必然溢出）
 - SVG 仅用于纯图形元素：图标、箭头、连接线、装饰图形、数据图表的图形部分
@@ -156,14 +113,13 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 - 禁止在 SVG 的 width/height/style 中使用视口单位（vh/vw/vmin）
 - SVG 内部禁止放置长文本，如需标注文字请控制在 4 个汉字以内
 - 如果绘制图标有对应的 emji，请使用 emji 表示，不要使用SVG绘制
-}
 
 **正确示例**（流程图 = HTML 卡片布局 + SVG 箭头）:
 ```
-<div class="flex items-center gap-[1em]">
-  <div class="bg-blue-100 rounded-[0.75em] p-[1.5em] text-center text-[1em]">组织效率 > 个体效率</div>
+<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-[0.75em] p-[1.5em] text-center text-[1em]">个体让渡主权</div>
+  <div class="bg-blue-100 rounded-[1.5vmin] p-[2.5vmin] text-center text-[2.5vmin]">个体让渡主权</div>
 </div>
 ```
 
@@ -172,8 +128,8 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 ### 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-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
-  <h1 class="text-[3.5em] font-bold text-white">完整的 PPT 内容</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 块级元素都会翻页并清空上一屏。
@@ -227,9 +183,6 @@ gsap.to("#element", { duration: 2, rotation: 360, repeat: -1 });
 - ❌ 非全屏元素追加: 输出 `<div>` 后再输出 `<p>` — 第二个元素会触发翻页! 所有视图内容放在一个 HTML 块中。
 - ❌ 禁止手动操作 #ppt-container: 禁止 `document.getElementById('ppt-container').innerHTML = ...`。前端框架自动管理。
 - ❌ 禁止 setTimeout: 已改为流式渲染，无需 setTimeout 控制时序。
-- ❌ 禁止使用响应式断点（sm:/md:/lg:/xl:）：所有缩放通过 em 单位 + 容器 font-size 自动处理。
-- ❌ 禁止使用 vmin/vmax 单位：统一使用 em 单位。
-- ❌ 禁止在子元素上重新设置 font-size 的绝对值（px/rem）：会破坏 em 缩放链。如需调整大小，使用 em 倍数。
 
 ## 6. 速查表
-**核心记忆**: HTML 块级元素 = 翻页; Script/Style = 追加（翻页时清理）; Diff = 仅用户明确要求修改; 文字 = 纯 Markdown; 容器 = min-h-screen + font-size: clamp(14px, calc(100vw/64), 22px) + em 单位; 所有尺寸用 em"""
+**核心记忆**: HTML 块级元素 = 翻页; Script/Style = 追加（翻页时清理）; Diff = 仅用户明确要求修改; 文字 = 纯 Markdown; 容器 = min-h-screen + vmin 单位; 响应式断点仅用于布局重排

{markdown_flow-0.2.67 → markdown_flow-0.2.69}/markdown_flow.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.67
+Version: 0.2.69
 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.67 → markdown_flow-0.2.69}/markdown_flow.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ markdown_flow/enums.py
 markdown_flow/exceptions.py
 markdown_flow/llm.py
 markdown_flow/models.py
+markdown_flow/system_prompt.md
 markdown_flow/tag_filter.py
 markdown_flow/utils.py
 markdown_flow.egg-info/PKG-INFO

{markdown_flow-0.2.67 → markdown_flow-0.2.69}/pyproject.toml

@@ -28,6 +28,9 @@ where = ["."]
 include = ["markdown_flow*"]
 exclude = ["tests*"]
 
+[tool.setuptools.package-data]
+markdown_flow = ["*.md"]
+
 [tool.setuptools.dynamic]
 version = {attr = "markdown_flow.__version__"}