| name | huxiang-present |
| description | 演讲铸造器（Outline-Faithful）。基于 orgmode/markdown outline 层级 1:1 视觉化呈现——色块大字、ultra-bold 错位，原文不动只做美化。三档主题色 black/red/yellow（默认 black 或按 filetags 推断），可用 -r/-b/-y 显式覆盖；可用 --cyber 走黑底绿字 cyber-hacker 风。使用时用户会说：'讲这个'、'present'、'做成演讲'、'呈现一下'、'铸成演示'、'做个 slides'、'标语流'、'宣言体'、'slogan'、'manifesto'、'按 outline 美化'。输出单文件 HTML 到 ~/Downloads/，页脚默认带 @虎小象 头像与昵称。 |
| user_invocable | true |
| version | 3.0.0 |
huxiang-present: 演讲铸造器
把 outline 铸成色块——视觉化渲染器，把舞台还给讲的人。
这不是什么
- 不是 manifesto 提炼器——不抽"那句话"，不写"完整断言句"，不重组顺序
- 不是高桥流——不削词到单字
- 不是 deck-style——不是企业 PPT 那种规整版式
这是什么
Outline → 视觉化渲染器：
- 输入 = orgmode 文件（
* ** 层级 + 列表 + 表格 + 强调）
- 输出 = 视觉美化的 slogan-style HTML，1:1 保留 outline 结构
- 不抽提、不重写、不浓缩——只决定怎么把这一行/这一节渲染为页面
视觉语言（参考审美：Felipe Franco / BIG STUDIOS 的 manifesto 美学）：
- 整篇一个主题色——red/black/yellow 三选一
- left-aligned 舞台美学——文字左对齐，超大字号自然撑屏
- 超大字 ultra-bold——单字 70vmin、长句 11vmin
- 多行错位——按 outline 嵌套深度自动 indent 0/1/2
- 关键词自动换色——
*强调* ~code~ 自动 hl
- 章节切换打节拍——一级标题
* → emphasis 封面页，其余 → theme 页
核心哲学
Outline 是真理。Skill 是渲染器。
不动内容是一条铁律：
- 标题不改字
- 段落不改字
- 列表项不改字
- 表格不改结构
- 顺序不重排
唯一允许的"动"是：物理分页（一段太长拆成多页），并保持视觉一致性。
Orgmode → 页面映射规则
标题层级
| Org 元素 | 页面 |
|---|
* 一级标题 | 独占 emphasis 封面页（accent 底色） |
** 二级标题 | 独占 theme 页（大字标题独占一页） |
*** 三级标题+ | 独占 theme 页（字号降一档） |
内容元素
| Org 元素 | 页面行为 |
|---|
| 段落 | theme 页，按句号/换行/字数分页 |
- 列表项 | theme 页，每项一行，indent 按嵌套深度（0/1/2） |
1. 编号列表 | 同上，保留序号前缀 |
| 嵌套列表 | 子项 indent +1（最多 indent=2） |
| 表格 | | 单页或多页，保留表格结构（首行加粗） |
*强调* | 自动 hl: true |
~code~ 或 =verbatim= | 自动 hl: true |
「」 内的关键词 | 视觉单元（保留括号，不强制 hl） |
引用 > ... | theme 页，indent 1 显示 |
分隔符 ----- | 独立 emphasis 休止页（无内容，纯色块） |
#+begin_example 块 | 独立 pre 页（monospace 渲染 ASCII art） |
文件级元数据
| Org 元素 | 用途 |
|---|
#+title: | → JSON title（浏览器 tab） |
#+author: 或 #+date: | → JSON subtitle（页脚右下，覆盖默认的 @虎小象） |
#+filetags: | 用于推断 theme（见下） |
#+identifier: | 忽略 |
默认 subtitle = @虎小象（无 #+author:/#+date: 时）。页脚同时显示头像（assets/avatar.jpg 内联为 base64 data URL），头像为 28px 圆形，与文字同行。
Theme 推断
优先级：显式参数 > filetags 推断 > 默认 black
显式覆盖（参数）：
-r / --theme=red → red-b / --theme=black → black-y / --theme=yellow → yellow--cyber → cyber-hacker（黑底绿字 + CRT 扫描线 + HUD + 终端光标）
filetags 自动推断：
| filetags 含 | theme | 调性 |
|---|
:share: :talk: :manifesto: :keynote: | red | 宣言、号召 |
:essay: :think: :learn: :note: | black | 沉思、论证 |
:critique: :warn: :rant: | yellow | 反讽、警觉 |
| 都没有 | black | 默认沉思调 |
分页规则（内容多时）
铁律：拆分后保持视觉一致性。同一逻辑块的页用同样的字号档位/底色/缩进规则。
| 情形 | 拆法 |
|---|
| 段落 ≤ 30 字 | 单页 |
| 段落 30-80 字，含多句号 | 每句一页（每页 medium 档字号） |
| 段落 > 80 字 | 按 ~30 字一页拆，加 ⋯ 续标 |
| 列表 ≤ 4 项 | 单页全部展示（错位 indent） |
| 列表 5-8 项 | 拆 2 页，每页 3-4 项（保持每页项数接近） |
| 列表 > 8 项 | 拆多页，每页 4 项 |
| 嵌套列表（如 4 革命×4 属性） | 父项 1 页 + 每个子项独立成组（标题 1 页 + 子项 1 页） |
| 表格 ≤ 6 行 | 单页 |
| 表格 > 6 行 | 拆多页，每页保留表头 |
一致性检查：拆完后扫一遍——同源拆分的页要长得像同一种东西，字号/缩进/底色都对齐。
自动 emphasis（节拍）
- 所有
* 一级标题 → emphasis 封面页
- 文件首页（标题或第一行非空文本）→ emphasis 开场页（如已是一级标题则合并）
- 文件末页（最后一段或最后一项）→ emphasis 收束页
----- 分隔符 → emphasis 休止页- 其他全是 theme 页
不要为了凑节奏强行加 emphasis——一级标题就是天然的章节断点。
自动 hl（高亮）
- org
*强调* → hl: true
- org
~code~ =verbatim= → hl: true
- emphasis 页内的 hl 自动忽略（CSS
color: inherit）
映射举例
输入（org 节选）：
#+title: 美团分享
#+filetags: :share:
* AI
** 为什么说 AI 是一次革命？
人类革命：能力让渡的层级跃迁
- 「人之为人」重新定义
- 社会组织重排
映射结果：
| # | 类型 | 内容 | 来源 |
|---|
| 1 | emphasis | 「AI」 | * AI（一级标题封面） |
| 2 | theme | 「为什么说 AI 是一次革命？」 | ** ... 二级标题独占页 |
| 3 | theme | 「人类革命：能力让渡的层级跃迁」 | 段落，单句 |
| 4 | theme | 两行错位：「『人之为人』重新定义」/「社会组织重排」 | 列表 ≤4 项一页 |
theme 自动选 red（filetags :share:），title=美团分享。
视觉规范
色板（仅 4 色）
--c-black: #1A1A1A
--c-red: #E63956
--c-yellow: #FFD400
--c-white: #FFFFFF
--c-gold: #FFE082
主题映射（一篇只用 ≤3 色）
| theme | 默认页 | emphasis 页 | hl 色（仅 theme 页） |
|---|
| black 沉思 | 黑底白字 | 红底白字 | 红色 #E63956 |
| red 宣言 | 红底白字 | 黑底白字 | 柔金黄 #FFE082 |
| yellow 反讽 | 黄底黑字 | 黑底白字 | 红色 #E63956 |
| cyber 终端 | 黑底矩阵绿 | 绿底黑字 | 白色 #FFFFFF（带绿光 + CRT 扫描线 + 顶部 HUD） |
字体栈
"Helvetica Neue", "Arial Black", "Inter", "PingFang SC", "Heiti SC", -apple-system, sans-serif
font-weight: 900
letter-spacing: -0.05em
cyber 主题额外字体（用于 HUD/footer/pre）：
"JetBrains Mono", "Fira Code", "IBM Plex Mono", "Source Code Pro", "Menlo", monospace
字号自适应
按本页"最长那一行"的字符数（CJK 字符按 1.8 计权）自动分档：
| 档位 | 字符数 | 字号 |
|---|
| single | ≤ 2 | 70vmin |
| short | 3-6 | 48vmin |
| medium | 7-14 | 28vmin |
| long | 15-26 | 16vmin |
| xlong | 27+ | 10vmin |
多行页自动降一档。
排版
- 内容区域 padding 6vmin 7vmin（贴近边缘，让大字有撑满感）
- lines 块水平居中 + 行内左对齐——
align-items: center 让 lines 块整体在屏幕水平居中（消除 16:9 右侧空白），但每一行的文字仍是 left-aligned 起始，indent 0/1/2 在块内制造错位
- letter-spacing
-0.05em——ultra-bold 应有的字字挤压感
- line-height
1.05、行间 gap 0.15em——多行折行也有呼吸空间
- 文字垂直方向：居中
- 页脚：左下页码 + 右下副标题，13px monospace，opacity 0.5
JSON Schema
{
"theme": "black|red|yellow|cyber",
"title": "演讲标题（浏览器 tab）",
"subtitle": "副标题/品牌（页脚右下，可选）",
"slides": [
{
"lines": [
{
"indent": 0,
"align": "left|center|right",
"chunks": [
{"t": "句子前段"},
{"t": "高亮词", "hl": true},
{"t": "句子后段"}
]
}
]
},
{ "emphasis": true, "lines": [...] },
{ "preTitle": "diagram_name", "pre": "...preformatted text..." }
]
}
字段省略约定：
- 不写
emphasis = 默认 theme 页
- emphasis 页内
chunks[].hl: true 会被忽略
- 写
pre 字段则该页为 ASCII art 页（monospace 渲染）
调用流程
- 获取内容（文件 → Read / 粘贴 → 直接用 / URL → WebFetch）
- 解析 outline：
- org：识别
* ** 标题层级、- 1. 列表、|...| 表格、*强调* / ~code~、#+begin_example 块
- markdown（兼容）：
# ## 标题、- * 列表、| 表格、**强调**、``` 代码块
- 纯文本（fallback）：按空行分段，每段一页
- 推断 theme：显式参数 >
#+filetags: > 默认 black
- 应用映射规则生成 slides 数组：
* 标题 → emphasis 封面**+ 标题 → theme 独占页- 段落 → theme 页（按分页规则）
- 列表 → theme 页（错位 indent + 分页规则）
- 表格 → theme 页（保留结构 + 分页规则）
- 强调 → 自动 hl
- example 块 → 独立 pre 页
- Read
assets/slogan_template.html（cyber 主题需在模板基础上注入扫描线/HUD/光标 CSS）；同时读取 assets/avatar.jpg 作为字节数据，base64 编码为 data:image/jpeg;base64,...
- 替换占位符：
{{TITLE}} → 文件 #+title: 或显式参数{{SUBTITLE}} → #+author: #+date: 拼接，无则默认 @虎小象{{THEME}} → 推断或显式参数（black|red|yellow|cyber）{{SLIDES_JSON}} → JSON.stringify(slides){{AVATAR_DATA_URL}} → assets/avatar.jpg 的 base64 data URL（让输出 HTML 单文件自包含）
- 写文件到
~/Downloads/{name}.html（{name} 取自 #+title: 或文件名，去标点，≤ 20 字）
- 报告路径 + 翻页键
→ ← Space F Home End
品味准则
- outline 是真理——不动字、不抽提、不重写、不重排
- 一级标题 = emphasis 封面——天然的章节断点，自动节拍
- 二级标题 = 独占 theme 页——给标题应有的重量
- 列表错位——靠 indent 0/1/2 体现 outline 嵌套深度
*强调* 自动 hl——尊重作者的标记意图- 拆页保持一致——同一逻辑块的视觉处理一致（字号档位/缩进/底色）
- 页脚保留——页码 + 副标题不要删，那是品牌的冷气
- 左对齐不居中——VACAT 美学的灵魂
禁区
- 不抽 manifesto——不要"找钉子"，作者已经写好了 outline
- 不写新句子——不要"完整断言句"重组
- 不重排顺序——按 outline 顺序输出，作者怎么排就怎么呈现
- 不删内容——所有列表项/段落都要呈现，不挑挑拣拣
- 不放图片/图标——色块就是图（cyber 主题的 HUD/扫描线除外，那是主题的一部分）
- 不用过渡动画——硬切
- 不在 emphasis 页用 inline hl——emphasis 整页就是高亮，再 hl 就乱了
- 不混用多个 theme——一篇一个气质，不切换
- 不要副标题字过大——页脚 13px，气场不能抢主标
- 不擅自加 emphasis——只有一级标题、首末页、
----- 是 emphasis，别的不要
中文默认
默认输出中文。除非原文是英文且用户要求保留英文。
通用交互
→ Space Enter j PageDown：下一页（含蓝牙翻页笔）← k PageUp：上一页（含蓝牙翻页笔）Home/End：跳首末f/F：全屏切换- 触屏左右滑：翻页
- 点击右半屏：下一页；点击左半屏：上一页
