feishu-deck-h5

总控 skill for Feishu / Lark-style HTML decks. Use for 飞书风格 PPT, Lark deck, 汇报材料, 客户提案, h5 deck, 16:9 网页演示, HTML deck generation/editing/validation, source parsing, Magic Page/Miaobi/html-box publishing, and feishu-slide-library importing. Routes work to subskills; generation is DeckJSON/render-deck first, normally raw-first, with validation before handoff or publish. For real `.pptx`, use a PowerPoint/keynote workflow instead.

把 Apple Keynote（`.key`）演示文稿转成 `deck.json` + HTML deck：逐页遍历， 把每一页重建为绝对定位的 HTML——图片仍是 `<img>`、文本是可编辑的 HTML 文本、视频是 `<video>`。与 `feishu-deck-h5` skill 配合使用：本 skill 产出 `deck.json`，`feishu-deck-h5/deck-json/render-deck.py` 把它包装成带演示模 式 chrome（← → 翻页 / F 全屏 / 进度条 / 移动端滚动模式）的最终 HTML。 触发词：「把 Keynote 转成 HTML」、「import keynote」、「.key 转 deck」、 「.pptx 转 HTML」（先用 Keynote 打开 PPTX 另存为 .key 即可），或者用户给出 `.key` 文件路径 / Keynote 里已打开的文稿。 每一页的处理流程： 1. AppleScript 遍历该页所有 iWork 元素，输出 (类型, 位置, 尺寸, 文件名, 文本, 字体 / 字号 / 颜色)。 2. 图片的文件引用按 .key bundle 的 Data/ 目录解析：先精确前缀匹配； 对模糊的 "pasted-image.pdf" 类情况退回尺寸 / 长宽比匹配。 3. 每个非文本元素变成原始 (x, y, w, h) 处的 `<img>` / `<video>`； 每个文本变成带原字体 + 字号的真实 HTML 元素。 4. 该页以 `layout: "raw"` 形式写入 deck.json。 5. `feishu-deck-h5/deck-json/render-deck.py` 包装成带演示模式 chrome 的 HTML。 可接受的失真（不要因此阻断）： · 自定义 Keynote 字体（鸿蒙 / 阿里巴巴普惠 / 方正兰亭）退回到 web-safe 中文字体栈（PingFang SC、Microsoft YaHei）。 · 1–2 个模糊的 pasted-image 文件可能匹配错源 —— 记录后继续。 · 母版背景渐变尚未解析（best-effort）。 · 动画 / 入场效果会被丢弃（有意为之 —— HTML 不需要）。

Convert an existing PowerPoint (.pptx) into an EDITABLE feishu-deck-h5 deck — a structured `canvas` deck.json that renders to a 16:9 present-mode HTML deck. STANDALONE skill that uses feishu-deck-h5 as its RENDER BACKEND (shells into its deck-json/render-deck.py; the final deck needs that skill's framework CSS/JS). feishu-deck-h5's parser also delegates .pptx import to this skill. Triggers: "把 PPT/PPTX 转成 deck/HTML/H5", "import pptx", ".pptx 转 deck", "把这份 PowerPoint 还原成网页/可编辑 deck", or when the user hands over a .pptx and wants it as an editable deck. Do NOT use for `.key` Keynote (use keynote-to-html), a from-scratch redesign (use feishu-deck-h5 directly), or producing a real .pptx. ONE pipeline: build_pptx.py = PURE CODE RECONSTRUCTION (python-pptx) → a `layout:"canvas"` deck.json of fully editable typed elements, rendered by render-deck.py. No extra deps (no LibreOffice / PyMuPDF). Decorative elements (gradients/glow/freeform/cropped images) are best-effort APPROXIMATE — the trade for full editability. (A LibreOffice/raster "hybrid" pipeline once existed; it was retired — see skills/_deprecated/.) See the SKILL.md body for deps, the lossy/approximation list, and placeholder + retired-flag (--raster/--full-raster are no-ops) behavior.

把 .pptx（或 Keynote 导出的 PPTX）转成「浏览 100% 保真 + 文字可编辑」的单文件 HTML deck。核心是**双背景架构**：浏览模式显示含文字的原始渲染图（字体/排版 与 PPT 完全一致），按 E 进入编辑模式才切到无文字底图 + 结构化可编辑文字框； 改过的文字框用「无文字底图的同位置裁片」做背景，精确遮住原图文字（无重影）。 自带演示导航、目录（缩略图点击跳转 / 多选拖拽排序 / 单页隐藏）、页码直跳、 本地保存与导出 HTML、视频(点播)与 GIF(自动循环) overlay、CJK 字体子集内嵌。 可选挂 FaaS 存储后端（--faas）实现「共享同一份、跨设备、改了即存」——专治妙笔 html-box 沙箱 iframe 禁用 localStorage 导致存不住的问题。 【网页翻译版】内置「可见真文字 + 浏览器翻译此页」模式（🌐 翻译模式 / body.xl）：正文 平时是原图、一点翻译就显示可被浏览器/豆包整页翻译的真文字；配 --fit/--gfit autofit 防溢出、bg 懒加载防首屏黑屏。专为发布到飞书妙搭（顶层渲染、可浏览器翻译）而做。 触发词：「PPT 转可编辑 HTML」、「PPTX → 可编辑网页」、「PPT 转 HTML 但文字 要能改」、「双背景可编辑 deck」、「把这个 PPT 做成能在线改文字的网页」。 与 keynote-to-html 的区别：keynote-to-html 走 .key→iWA 纯结构化重建（文字直接 渲染，字体/排版会失真）；本 skill 走 .pptx + 双背景，浏览是原图所以零失真， 结构化文字只在编辑态出现。两者可独立使用。 失真与边界（不要因此阻断）： · 浏览模式 = 原始渲染图，零失真。 · 编辑模式文字用 CJK web 字体（子集化原字体最佳；否则回退 PingFang）， 字形可能与原图有细微差异——这是编辑态，可接受。 · 自定义 Freeform 形状、复杂阴影/渐变、入场动画：浏览靠原图保真，无需重建。 · 媒体音轨探测决定 GIF(无声→自动循环) 还是视频(有声→点播)。