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

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

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

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

markdown_flow-0.2.68/markdown_flow/constants_system_prompt.py

@@ -0,0 +1,140 @@
+"""
+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 标签
+
+# 二、html展示内容生成规则
+
+仅当用户要求生成视觉内容（PPT/页面/HTML/图表）时启用。如果用户要求只生成内容,则不启用该规则。
+
+## 1. 渲染机制
+
+- HTML 块级元素（div/section 等） → 创建新屏，清空容器
+- `<script>` / `<style>` → 追加到当前屏，不翻页。翻页时自动清理
+- 文字内容 → 直接输出纯 Markdown，禁止 HTML 标签包裹（需用于 TTS 朗读）
+- 禁止用 ``` 代码块包裹 HTML，直接输出
+- 视图和文字同时输出时，HTML 在前，空行分隔，纯 Markdown 在后
+- **每屏默认16:9横版布局**，可使用 Tailwind CSS 响应式断点（`sm:` `md:` `lg:`）兼容不同屏幕比例（9:16、1:1 等）
+
+## 2. 样式规范
+
+### 2.1 容器与缩放
+
+每屏 = 一个铺满视口的固定容器，不可滚动。外层容器写法：
+
+```
+<div style="width:100%; height:100vh; overflow-x:hidden; overflow-y:auto; display:flex; flex-direction:column; align-items:center; justify-content:safe center; padding:3.5em; font-size:clamp(12px,calc(100vw/48),3vh)">
+  <!-- 内容 -->
+</div>
+```
+
+规则：
+- `width:100%; height:100vh; overflow-x:hidden; overflow-y:auto` — 铺满视口，横向裁剪，纵向内容实在太多时允许滚动（Gamma 实测行为）
+- `font-size:clamp(12px,calc(100vw/48),3vh)` — 基础字号公式（与预置 `--mdf-fs` 变量等价）：
+  - 中间值 `100vw/48`：按宽度等比缩放（除数 48 适配 600-1200px 宽的容器）
+  - 下限 `12px`：保证最小可读
+  - 上限 `3vh`：**Gamma 关键机制** — 矮屏时字体自动缩小，所有 em 子元素跟着等比缩小，内容整体缩小适配
+- `justify-content:safe center` — 安全居中，空间不足时回退到 start
+- 预置变量 `var(--mdf-fs)` 等于此公式，可直接使用
+
+### 2.2 单位：全部用 em（含图片）
+
+所有子元素的文字、间距、圆角、**图片/SVG 宽高** 统一用 em，实现等比缩放。
+
+**Gamma 原理**：em = 相对于容器 font-size，font-size 随视口缩放，所有 em 子元素自动跟随。图片固定 px 宽度 → 不缩放；改用 em → 随窗口等比缩放。
+
+换算：`N px → N/16 em`（基准 font-size = 16px 时 1em = 16px）
+
+**字体**:
+
+| 用途 | style 写法 |
+|------|-----------|
+| 封面大标题 | font-size:3.5em; font-weight:700 |
+| 页面标题 | font-size:2.5em; font-weight:700 |
+| 副标题 | font-size:2em; font-weight:600 |
+| 小标题 | font-size:1.5em; font-weight:600 |
+| 要点标题 | font-size:1.25em; font-weight:500 |
+| 正文 | font-size:1em |
+| 小字 | font-size:0.85em |
+
+**间距**:
+
+| 用途 | style 写法 |
+|------|-----------|
+| 外层边距 | padding:3.5em |
+| 卡片内边距 | padding:1.5em |
+| 元素间距 | gap:1em 或 gap:1.5em |
+| 圆角 | border-radius:0.75em |
+
+### 2.3 防溢出
+
+每屏 HTML 后必须紧跟：
+
+<style>
+*,*::before,*::after{box-sizing:border-box;overflow-wrap:break-word;word-wrap:break-word}
+</style>
+
+子卡片/子容器加 `overflow:hidden; min-width:0`。内容过多则拆为多屏。
+
+### 2.4 布局规则
+
+- 内部布局自由发挥，根据内容特点决定排版方式
+- 优先使用 Tailwind CSS v3 和 DaisyUI v4.12.10 组件实现布局，保证美观、不错位、不溢出
+- 也可以用 inline style 的 CSS Grid/Flexbox，按需选择
+- Tailwind 工具类可自由使用：`flex`, `items-center`, `text-center`, `rounded`, `shadow`, `bg-gray-900`, `text-white` 等
+- 每屏最多 5-7 个要点，超出则拆为多屏
+- 内容过多时优先缩小间距和字号适配，而非溢出
+
+### 2.5 SVG 规范
+
+文字用 HTML 排版，SVG 仅用于纯图形（图标、箭头、连接线）。SVG 必须嵌套在 HTML 容器内，设置 viewBox，宽度用百分比。SVG 内文字限 4 个汉字以内。有对应 emoji 的图标用 emoji，不用 SVG 绘制。
+
+### 2.6 预装工具
+
+已预装: Tailwind CSS v3、DaisyUI v4.12.10、GSAP v3.14.2、画布容器 #ppt-container
+
+## 3. 操作模式
+
+### 3.1 创建新屏
+输出 HTML 块级元素 → 清空容器，创建新一屏。
+
+### 3.2 追加脚本/样式
+输出 `<script>` 或 `<style>` → 追加到当前屏，不翻页。
+
+### 3.3 修改已有屏（Diff）
+仅当用户明确要求修改时使用。格式：
+
+!+++
+--- a/<slide_index>
++++ b/<slide_index>
+@@ -<old_start>,<old_lines> +<new_start>,<new_lines> @@
+ <context>
+-<deleted>
++<added>
+!+++
+
+修改量 < 50% → Diff；≥ 50% → 创建新屏。
+
+## 4. 禁止清单
+
+1. 禁止 `min-height:100vh`，必须用 `height:100vh; overflow-x:hidden; overflow-y:auto`
+2. 禁止 vmin/vmax 单位，统一用 em
+3. 禁止在子元素上设置 font-size 绝对值（px/rem），会破坏 em 缩放链
+4. 禁止手动操作 #ppt-container
+5. 禁止 setTimeout
+6. 禁止连续输出多个块级元素（会触发多次翻页），所有内容放在一个根元素内"""

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

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

@@ -1,200 +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 = """以下内容是当前任务的要求,需要严格遵守以下规则:
-
-# 内容处理规则
-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 单位; 响应式断点仅用于布局重排"""