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

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

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

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

{markdown_flow-0.2.66 → markdown_flow-0.2.67}/markdown_flow/constants_system_prompt.py

@@ -31,7 +31,7 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 4. 修改已有屏 → 必须使用 diff（仅当用户明确要求修改时）
 5. 文字内容 → 直接输出纯 Markdown，禁止任何 HTML 标签包裹（原因：文字需提取为纯文本用于 TTS 朗读和阅读模式）
 6. 禁止用 ``` 代码块包裹 HTML，直接输出
-7. 视觉内容默认不可以过长，屏幕尺寸默认16:9，并且必须保持响应式,可兼容 9:16,1:1,等比例的视图。
+7. 视觉内容默认不可以过长，屏幕默认 16:9 比例，内容必须在一屏内完整展示
 
 ## 2. 双输出：视图 + 文字
 当用户指令同时包含视图和文字时，两者必须分开输出：
@@ -47,8 +47,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-[4vmin]">
-  <h1 class="text-[6vmin] 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-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
+  <h1 class="text-[3.5em] font-bold text-white">封面标题</h1>
 </div>
 
 本节核心问题: **什么样的协作关系才可持续?**
@@ -61,43 +61,49 @@ 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 样式与缩放规范
-每一屏 = 一个视口。使用 vmin 单位实现等比缩放，响应式断点处理极端屏幕比例。
+### 3.2 缩放体系：容器 font-size + em 单位
 
-**外层容器必须**: `min-h-screen` + `p-[4vmin]`（使用 min-h-screen 而非 h-screen，确保背景始终铺满所有内容区域——内容不足一屏时占满视口，内容超出时背景随内容延伸）
+**核心原理**: 在外层容器上设置一个基础 font-size，所有子元素的尺寸（文字/间距/圆角/行高）统一使用 em 单位，实现等比缩放。
 
-**尺寸单位: vmin 为主**（文字/间距/圆角/行高统一使用 vmin）
+**外层容器必须**:
+- `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
+
+**字体层级（em 倍数）**:
+
+| 元素 | 写法 | 说明 |
+|------|------|------|
+| 封面大标题 | 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 倍数）**:
 
 | 元素 | 写法 |
 |------|------|
-| 大标题 | 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] |
+| 外层边距 | p-[3.5em] |
+| 卡片内边距 | p-[1.5em] |
+| 元素间距 | gap-[1em] |
+| 大间距 | gap-[1.5em] |
+| 圆角 | rounded-[0.75em] |
+| 小圆角 | rounded-[0.5em] |
+| 行高 | leading-[1.6] |
 
 **居中**: 必须 `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 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>
 </div>
 ```
@@ -112,7 +118,33 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 - 当内容元素较多时，优先缩小元素尺寸和间距来适配一屏，而非让内容溢出
 - 禁止使用负 margin 将元素推出容器范围
 
-### 3.3 SVG 与文字布局规范
+### 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 与文字布局规范
 **核心原则：文字用 HTML，图形用 SVG**
 - 所有包含文字的布局（卡片、列表、流程说明、要点展示等）必须使用 HTML + Tailwind ,或者 DaisyUI自身的组件实现，禁止用 SVG `<text>` 排版文字内容（SVG text 固定坐标不换行，中文长文本必然溢出）
 - SVG 仅用于纯图形元素：图标、箭头、连接线、装饰图形、数据图表的图形部分
@@ -128,10 +160,10 @@ DEFAULT_MDF_SYSTEM_PROMPT = """以下内容是当前任务的要求,需要严格
 
 **正确示例**（流程图 = 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>
+<div class="flex items-center gap-[1em]">
+  <div class="bg-blue-100 rounded-[0.75em] p-[1.5em] text-center text-[1em]">组织效率 > 个体效率</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 class="bg-blue-100 rounded-[0.75em] p-[1.5em] text-center text-[1em]">个体让渡主权</div>
 </div>
 ```
 
@@ -140,8 +172,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-[4vmin]">
-  <h1 class="text-[6vmin] 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-[3.5em]" style="font-size: clamp(14px, calc(100vw / 64), 22px)">
+  <h1 class="text-[3.5em] font-bold text-white">完整的 PPT 内容</h1>
 </div>
 
 每个 HTML 块级元素都会翻页并清空上一屏。
@@ -195,6 +227,9 @@ 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 + vmin 单位; 响应式断点仅用于布局重排"""
+**核心记忆**: HTML 块级元素 = 翻页; Script/Style = 追加（翻页时清理）; Diff = 仅用户明确要求修改; 文字 = 纯 Markdown; 容器 = min-h-screen + font-size: clamp(14px, calc(100vw/64), 22px) + em 单位; 所有尺寸用 em"""

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: markdown-flow
-Version: 0.2.66
+Version: 0.2.67
 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