[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7ATWD22GKRCPZCE7ZDHKASF":3,"skill-same:01M7ATWD22GKRCPZCE7ZDHKASF":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":35,"repositoryHtmlUrl":36,"repositoryHomepageUrl":37,"ownerHtmlUrl":38,"ownerBlogUrl":37,"ownerDescription":39,"updatedAt":40,"install":41,"resources":54},"01M7ATWD22GKRCPZCE7ZDHKASF","html-spec",null,"转换 HTML 为 PPT 元素——把 HTML 转成可编辑 PPT 元素的契约：白名单决定可编辑范围，data-tabslide-rasterize 兜底复杂视觉。","tabtin-ai\u002FTabTin","tabtin-ai","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F318455733?v=4","01M7ATGMM5SE688ACWMP1PKRRB","TabTin","01M7ATGMMV4YXJ83EFKXAZVHR3",454,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fapps\u002Ftabslide\u002Fskills\u002Fhtml-spec\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: html-spec\ndescription: >\n  转换 HTML 为 PPT 元素——把 HTML 转成可编辑 PPT\n  元素的契约：白名单决定可编辑范围，data-tabslide-rasterize\n  兜底复杂视觉。\nmetadata:\n  version: 0.4.0\n  tabtin:\n    category: doc\n    displayName: \"TabSlide HTML 生成规范\"\n    autoActivateFor: [tabslide]\n---\n\n# TabSlide HTML 生成规范\n\nTabSlide 的 HTML 转页能力（`tabtin slide create --html` \u002F `tabtin slide add-page --html`；整份覆盖才用 `tabtin slide generate --replace`）会把你写的 HTML 转成可编辑的 PPTElement。这份文档定义两件事：\n\n1. **哪些 HTML 模式我们能完整解析为可编辑 PPTElement**（用户能拖、能改文字、能改色）\n2. **超出白名单的视觉怎么用 `data-tabslide-rasterize` 兜底**（截图为 image，视觉对但整块拖）\n\n## 一、设计哲学：白名单 + SVG\u002F栅格化兜底\n\n我们不是 Chrome，只能识别 HTML 表现力的一个子集。约定如下：\n\n- **白名单内** → 可编辑 PPTElement（text \u002F shape \u002F image \u002F line \u002F table \u002F chart）\n- **白名单外的矢量视觉** → 用 `\u003Csvg>` 画（转成清晰图片，视觉稳定）\n- **白名单外的复杂视觉** → 用 `\u003Cdiv data-tabslide-rasterize>...\u003C\u002Fdiv>` 主动包起来，整块截图为 image\n\n这是契约：你写白名单内的内容，我保证可编辑；你写复杂装饰，主动标 rasterize，我保证视觉对。**不要写\"差不多能识别但又拿不准\"的东西** —— 拿不准就 rasterize，宁可降级一块为图片，也别让整页错位。\n\n> **⚠️ HTML 能做的样式，PPT 不一定能还原。** PPT 的元素模型比 CSS 窄得多——很多纯 CSS 装饰（径向渐变、滤镜、毛玻璃、裁剪形状、异形\u002F曲线、复杂阴影、伪元素画的图形、CSS 画的图标\u002F箭头\u002F连接线等）在转成 PPTElement 时会丢失或走样。**这类\"用 CSS 硬凑的图形\"应当改用 `\u003Csvg>` 画**：SVG 会被转成一张清晰的图片元素，视觉在任何机器 \u002F 导出的 .pptx 里都稳定一致，不受 CSS→PPT 能力差异影响。\n>\n> 原则：**能进白名单的用白名单（可编辑）；做不进白名单的矢量图形优先用 `\u003Csvg>`（视觉稳定）；再不行才 `data-tabslide-rasterize` 截图兜底。** 代价是 SVG \u002F 栅格化产物是整块图片，不能在编辑器里改文字改色——所以正文、标题、可编辑数据不要塞进 SVG。\n\n## 二、画布容器（**必须**）\n\n每页用一个 `.ppt-slide` div 包裹，宽高固定 1280×720：\n\n```html\n\u003Cdiv class=\"ppt-slide\" style=\"width:1280px;height:720px;position:relative;overflow:hidden\">\n  \u003C!-- 页面内容 -->\n\u003C\u002Fdiv>\n```\n\n多页幻灯片在 `\u003Cbody>` 中依次排列多个 `.ppt-slide`。\n\n## 三、可用资源（自动注入）\n\n- **样式：只用原生 CSS** — 用 `\u003Cstyle>` 写 class 或元素上写 `style=\"...\"`。**不提供 Tailwind**，不要写 `class=\"bg-blue-500 p-8\"` \u002F `bg-[#2563EB]` 这类工具类（不会生效）。也**不要用与常见框架同名的 class**（如 `list-item`\u002F`grid`\u002F`flex`\u002F`block`\u002F`table`\u002F`hidden`），用语义化命名（如 `.bullet-row`）。\n- **Font Awesome 6** — `\u003Ci class=\"fa-solid fa-...\">`（⚠️ 必须 rasterize 才能出现在 PPT 里，详见 §五）\n- **ECharts** — `echarts.init(dom).setOption({...})`（图表容器必须同时声明确定的 `width` 和 `height`；不要只依赖 `flex:1` 或百分比高度）\n- **Chart.js** — `new Chart(ctx, {...})`\n- **MathJax** — `$$E=mc^2$$`\n- **字体** — Inter（英文）、Noto Sans SC（中文），自动应用\n\n## 四、可编辑白名单（推荐写法）\n\n> 8 类可编辑元素（文字 \u002F 简单形状 \u002F 线段 \u002F 线性渐变 \u002F 图片 \u002F SVG 图标 \u002F 图表 \u002F 表格）的逐项推荐写法与示例见 [`references\u002Feditable-whitelist.md`](references\u002Feditable-whitelist.md)。\n\n**真实图片必须内嵌数据，别只贴外链（重要）**：把网页 \u002F 素材里的真实图片（截图、产品图、logo）放进 PPT 时，先把图**下载到本地**，再读成 `data:image\u002F(png|jpeg|gif|webp|bmp);base64,...` 写进 `\u003Cimg src>`——这样图数据会落到 slide 自己的存储、长期不掉。`\u003Cimg src=\"https:\u002F\u002F第三方...\">` 是原样引用第三方链接，会过期 \u002F 防盗链 \u002F 离线掉图。**绝不要用文字 \u002F 色块假装图片。** 细节见 `references\u002Feditable-whitelist.md §4.5`。\n\n## 资源导航（按需读取）\n\n- `references\u002Feditable-whitelist.md`：当你要判断某个元素是否可编辑、以及该怎么写成稳定白名单形态时读取。\n- `examples\u002Fpage-templates.md`：仅在需要快速起草整页结构或复用模板时读取；示例用于套版，不默认整份注入上下文。\n\n## 五、栅格化兜底（⚠️ 写法）\n\n### 5.1 何时用\n\n**主动选择 rasterize 的场景：**\n\n| 视觉效果 | 为什么走 rasterize |\n|---|---|\n| **Font Awesome 图标**（`\u003Ci class=\"fa-*\">`） | dom_extractor 会把 FA 元素 `display:none` 隐藏，**直接写不会出现在 PPT 里** |\n| **径向渐变**（`radial-gradient`） | 仅支持 linear |\n| **毛玻璃**（`backdrop-filter: blur`） | PPT 无对应能力 |\n| **裁剪形状**（`clip-path`、`mask-image`） | PPT 无对应能力 |\n| **混合模式**（`mix-blend-mode`） | PPT 无对应能力 |\n| **复杂 filter**（`drop-shadow`、多个 filter 叠加） | 转换不稳定 |\n| **复杂 SVG**（含动画 \u002F 滤镜 \u002F 渐变填充） | 序列化后可能视觉退化 |\n| **拿不准能不能识别的复杂视觉** | 主动声明意图，避免错位 |\n\n### 5.2 怎么写\n\n把要整块截图的内容包在 `\u003Cdiv data-tabslide-rasterize>` 里：\n\n```html\n\u003C!-- Font Awesome 图标兜底（极其常用） -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"position:absolute;top:80px;left:80px;width:48px;height:48px;\n            display:flex;align-items:center;justify-content:center;\n            color:#2563EB;font-size:32px\">\n  \u003Ci class=\"fa-solid fa-chart-line\">\u003C\u002Fi>\n\u003C\u002Fdiv>\n\n\u003C!-- 复杂 SVG 装饰兜底 -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"position:absolute;top:80px;left:80px;width:200px;height:60px\">\n  \u003Csvg viewBox=\"0 0 200 60\">\n    \u003Cdefs>\n      \u003ClinearGradient id=\"g\">\n        \u003Cstop offset=\"0\" stop-color=\"#2563EB\"\u002F>\n        \u003Cstop offset=\"1\" stop-color=\"#7C3AED\"\u002F>\n      \u003C\u002FlinearGradient>\n    \u003C\u002Fdefs>\n    \u003Cpath d=\"M0,30 Q50,0 100,30 T200,30\" stroke=\"url(#g)\" stroke-width=\"3\" fill=\"none\"\u002F>\n  \u003C\u002Fsvg>\n\u003C\u002Fdiv>\n\n\u003C!-- 径向渐变兜底 -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"width:300px;height:300px;border-radius:50%;\n            background:radial-gradient(circle at 30% 30%, #FFD700, #FF8C00)\">\u003C\u002Fdiv>\n```\n\ndom_extractor 看到 `data-tabslide-rasterize` 属性后：\n\n1. 截图整个 div（含所有子元素，@2x 分辨率）\n2. 上传到 OSS\n3. 当一个 image PPTElement 输出\n4. 子元素**不再被其他识别函数提取**（不会有\"图片 + 文字\"双重提取）\n\n### 5.3 规则\n\n- ✅ rasterize 区域**必须**有明确的 `width` \u002F `height`（截图 clip 来自 getBoundingClientRect，无尺寸截不出来）\n- ✅ 在编辑器里 rasterize 出的 image 只能整块拖动、缩放，**不能改文字 \u002F 颜色**\n- ❌ 别用 rasterize 包裹本来就能识别的简单卡片 \u002F 文字 —— 浪费，且失去可编辑性\n- ❌ rasterize 内不要再嵌套 rasterize（只截最外层）\n\n## 六、明确禁止 \u002F 不识别\n\n以下用法即使写了也会被忽略或导致异常 —— 看到下表的视觉需求**第一反应应该是走 rasterize**：\n\n| 用法 | 后果 |\n|------|------|\n| `\u003Ci class=\"fa-*\">` 不包 rasterize | 图标被 `display:none` 隐藏，PPT 里看不到 |\n| `radial-gradient` 不包 rasterize | 形状仍输出但渐变丢失（保留 bg \u002F 边框） |\n| `backdrop-filter` 不包 rasterize | 毛玻璃丢失 |\n| `clip-path` \u002F `mask-image` \u002F `mix-blend-mode` 不包 rasterize | 视觉丢失 |\n| `\u003Cp>` \u002F `\u003Ch*>` 上写 `background` \u002F `border` \u002F `box-shadow` | 文字识别成功，但背景边框丢失 |\n| `position: fixed` | 坐标计算异常（相对视口而非 `.ppt-slide`） |\n| CSS `animation` \u002F `transition` \u002F `@keyframes` | PPT 不支持，渲染期被忽略 |\n| `\u003Ciframe>` `\u003Cvideo>` `\u003Caudio>` | 不识别（slide generate 不输出此类元素） |\n| `\u003Cul>` \u002F `\u003Col>` 嵌套结构（多层） | 识别不稳；改用 `\u003Cdiv>` 排列 |\n\n## 七、配色与样式约定\n\n### 7.1 颜色写法（任选其一，能识别）\n\n- ✅ CSS 变量：`var(--slide-primary)`（保证全局一致，推荐多页演示统一用）\n- ✅ 直接写 hex \u002F rgb \u002F rgba：`style=\"background:#2563EB\"` \u002F `style=\"color:rgba(255,255,255,0.7)\"`\n- ✅ 自定义 class 里写原生 CSS：`.title{color:#1F2937}`\n\n**优先使用 CSS 变量** —— 主题切换时统一更新。多页演示混着用容易出现某页跳色。**不要用 Tailwind 工具类**（`bg-blue-500`\u002F`bg-[#2563EB]` 等不会生效）。\n\n### 7.2 CSS 变量速查\n\n| 变量 | 默认值 | 用途 |\n|------|--------|------|\n| `--slide-primary` | #2563EB | 主色 |\n| `--slide-accent` | #DC2626 | 强调色 |\n| `--slide-text` \u002F `--slide-text-secondary` | #1F2937 \u002F #64748B | 正文 \u002F 辅助文字 |\n| `--slide-bg` \u002F `--slide-bg-subtle` | #FFFFFF \u002F #F8FAFC | 背景白 \u002F 浅底 |\n| `--slide-border` | #E2E8F0 | 边框色 |\n| `--slide-success\u002Fwarning\u002Ferror\u002Finfo` | 绿\u002F橙\u002F红\u002F蓝 | 状态色 |\n| `--slide-blue\u002Fteal\u002Fgreen\u002Forange\u002Fred\u002Fpurple` | — | 六色板（图表 \u002F 卡片配色） |\n| `--slide-radius-sm\u002Fmd\u002Flg\u002Fxl\u002Ffull` | 8 \u002F 12 \u002F 16 \u002F 24 \u002F 9999 px | 圆角 |\n| `--slide-shadow-sm\u002Fmd\u002Flg\u002Fxl` | — | 阴影 |\n\n### 7.3 组件 class 速查\n\n| class | 说明 |\n|------|------|\n| `.slide-cover` | 居中封面页（flex column center） |\n| `.slide-content` | 标准内容页（纵向 + 60\u002F80 px 内边距） |\n| `.slide-split` \u002F `.slide-split-40-60` | 1:1 \u002F 2:3 分栏 |\n| `.slide-grid-2\u002F3\u002F4` | 等宽网格 |\n| `.slide-title` \u002F `.slide-title-lg` \u002F `.slide-subtitle` | 48 \u002F 64 \u002F 28 px |\n| `.slide-heading` \u002F `.slide-body` \u002F `.slide-caption` \u002F `.slide-label` | 36 \u002F 20 \u002F 14 \u002F 14 px |\n| `.slide-number` | 56 px 数字高亮 |\n| `.slide-card` \u002F `.slide-card-bordered` \u002F `.slide-card-accent` \u002F `.slide-card-filled` | 卡片变体 |\n| `.slide-card-glass` | ⚠️ 含 backdrop-filter，毛玻璃效果**必须 rasterize** |\n| `.slide-kpi`（内含 `.kpi-label \u002F .kpi-value \u002F .kpi-change.up\u002F.down`） | KPI 指标卡 |\n| `.slide-table` \u002F `.slide-table-minimal` | 表格主题 |\n| `.slide-badge` \u002F `-primary\u002Fsuccess\u002Fwarning\u002Ferror` | 标签（不要塞 FA 图标） |\n| `.slide-list` | 带圆点列表（CSS `::before` 实现，识别为 div 文字） |\n| `.slide-divider` \u002F `.slide-divider-accent` \u002F `.slide-accent-bar` | 装饰线 \u002F 条 |\n| `.slide-step-number` | 数字圆圈（识别为 shape + text） |\n| `.slide-timeline` + `.slide-timeline-item` | 时间线 |\n\n## 八、页面模板\n\n> 6 套可直接套用的整页 HTML 模板（封面 \u002F KPI 仪表盘 \u002F 图表页 \u002F 对比分析 \u002F 表格页 \u002F 总结页）见 [`examples\u002Fpage-templates.md`](examples\u002Fpage-templates.md)。\n\n## 九、自查清单（生成前过一遍）\n\n- [ ] 复杂装饰 \u002F 图标 \u002F 示意图 \u002F 渐变描边优先用内联 `\u003Csvg>` 矢量，而不是 CSS 硬凑再 rasterize\n- [ ] 自定义 class 没有与 Tailwind 工具类同名（`list-item` \u002F `grid` \u002F `flex` \u002F `block` \u002F `hidden` \u002F `table` \u002F `container` 等）\n- [ ] 每个 `\u003Ci class=\"fa-*\">` 都包在 `data-tabslide-rasterize` 容器内\n- [ ] 没有用到 `radial-gradient` \u002F `backdrop-filter` \u002F `clip-path` \u002F `mask-image` \u002F `mix-blend-mode`（除非包 rasterize）\n- [ ] `\u003Cp>` \u002F `\u003Ch*>` 上没有 `background` \u002F `border` \u002F `box-shadow`（搬到外层 div）\n- [ ] 渐变只用 `linear-gradient`，stop 位置和颜色清晰\n- [ ] rasterize 容器都有明确的 `width` \u002F `height`\n- [ ] 没有 CSS `animation` \u002F `transition` \u002F `@keyframes`\n- [ ] 元素不超出 1280×720 边界（遵守 design-guide 容量预算；`slide render` 对 `html_overflow` 默认拒绝导出）\n- [ ] 图表用 ECharts \u002F Chart.js canvas，不是手画的 div 柱状图\n- [ ] 每个图表容器都有非零的显式 `width` \u002F `height`；初始化放在布局完成后，并在需要时调用 `chart.resize()`\n- [ ] 表格用 `\u003Ctable>` 而不是 div 网格模拟\n- [ ] 真实图片走 `data:image\u002F*;base64` 内嵌（不是只贴第三方外链，更不是用文字\u002F色块假装）\n","# TabSlide HTML 生成规范\n\nTabSlide 的 HTML 转页能力（`tabtin slide create --html` \u002F `tabtin slide add-page --html`；整份覆盖才用 `tabtin slide generate --replace`）会把你写的 HTML 转成可编辑的 PPTElement。这份文档定义两件事：\n\n1. **哪些 HTML 模式我们能完整解析为可编辑 PPTElement**（用户能拖、能改文字、能改色）\n2. **超出白名单的视觉怎么用 `data-tabslide-rasterize` 兜底**（截图为 image，视觉对但整块拖）\n\n## 一、设计哲学：白名单 + SVG\u002F栅格化兜底\n\n我们不是 Chrome，只能识别 HTML 表现力的一个子集。约定如下：\n\n- **白名单内** → 可编辑 PPTElement（text \u002F shape \u002F image \u002F line \u002F table \u002F chart）\n- **白名单外的矢量视觉** → 用 `\u003Csvg>` 画（转成清晰图片，视觉稳定）\n- **白名单外的复杂视觉** → 用 `\u003Cdiv data-tabslide-rasterize>...\u003C\u002Fdiv>` 主动包起来，整块截图为 image\n\n这是契约：你写白名单内的内容，我保证可编辑；你写复杂装饰，主动标 rasterize，我保证视觉对。**不要写\"差不多能识别但又拿不准\"的东西** —— 拿不准就 rasterize，宁可降级一块为图片，也别让整页错位。\n\n> **⚠️ HTML 能做的样式，PPT 不一定能还原。** PPT 的元素模型比 CSS 窄得多——很多纯 CSS 装饰（径向渐变、滤镜、毛玻璃、裁剪形状、异形\u002F曲线、复杂阴影、伪元素画的图形、CSS 画的图标\u002F箭头\u002F连接线等）在转成 PPTElement 时会丢失或走样。**这类\"用 CSS 硬凑的图形\"应当改用 `\u003Csvg>` 画**：SVG 会被转成一张清晰的图片元素，视觉在任何机器 \u002F 导出的 .pptx 里都稳定一致，不受 CSS→PPT 能力差异影响。\n>\n> 原则：**能进白名单的用白名单（可编辑）；做不进白名单的矢量图形优先用 `\u003Csvg>`（视觉稳定）；再不行才 `data-tabslide-rasterize` 截图兜底。** 代价是 SVG \u002F 栅格化产物是整块图片，不能在编辑器里改文字改色——所以正文、标题、可编辑数据不要塞进 SVG。\n\n## 二、画布容器（**必须**）\n\n每页用一个 `.ppt-slide` div 包裹，宽高固定 1280×720：\n\n```html\n\u003Cdiv class=\"ppt-slide\" style=\"width:1280px;height:720px;position:relative;overflow:hidden\">\n  \u003C!-- 页面内容 -->\n\u003C\u002Fdiv>\n```\n\n多页幻灯片在 `\u003Cbody>` 中依次排列多个 `.ppt-slide`。\n\n## 三、可用资源（自动注入）\n\n- **样式：只用原生 CSS** — 用 `\u003Cstyle>` 写 class 或元素上写 `style=\"...\"`。**不提供 Tailwind**，不要写 `class=\"bg-blue-500 p-8\"` \u002F `bg-[#2563EB]` 这类工具类（不会生效）。也**不要用与常见框架同名的 class**（如 `list-item`\u002F`grid`\u002F`flex`\u002F`block`\u002F`table`\u002F`hidden`），用语义化命名（如 `.bullet-row`）。\n- **Font Awesome 6** — `\u003Ci class=\"fa-solid fa-...\">`（⚠️ 必须 rasterize 才能出现在 PPT 里，详见 §五）\n- **ECharts** — `echarts.init(dom).setOption({...})`（图表容器必须同时声明确定的 `width` 和 `height`；不要只依赖 `flex:1` 或百分比高度）\n- **Chart.js** — `new Chart(ctx, {...})`\n- **MathJax** — `$$E=mc^2$$`\n- **字体** — Inter（英文）、Noto Sans SC（中文），自动应用\n\n## 四、可编辑白名单（推荐写法）\n\n> 8 类可编辑元素（文字 \u002F 简单形状 \u002F 线段 \u002F 线性渐变 \u002F 图片 \u002F SVG 图标 \u002F 图表 \u002F 表格）的逐项推荐写法与示例见 [`references\u002Feditable-whitelist.md`](references\u002Feditable-whitelist.md)。\n\n**真实图片必须内嵌数据，别只贴外链（重要）**：把网页 \u002F 素材里的真实图片（截图、产品图、logo）放进 PPT 时，先把图**下载到本地**，再读成 `data:image\u002F(png|jpeg|gif|webp|bmp);base64,...` 写进 `\u003Cimg src>`——这样图数据会落到 slide 自己的存储、长期不掉。`\u003Cimg src=\"https:\u002F\u002F第三方...\">` 是原样引用第三方链接，会过期 \u002F 防盗链 \u002F 离线掉图。**绝不要用文字 \u002F 色块假装图片。** 细节见 `references\u002Feditable-whitelist.md §4.5`。\n\n## 资源导航（按需读取）\n\n- `references\u002Feditable-whitelist.md`：当你要判断某个元素是否可编辑、以及该怎么写成稳定白名单形态时读取。\n- `examples\u002Fpage-templates.md`：仅在需要快速起草整页结构或复用模板时读取；示例用于套版，不默认整份注入上下文。\n\n## 五、栅格化兜底（⚠️ 写法）\n\n### 5.1 何时用\n\n**主动选择 rasterize 的场景：**\n\n| 视觉效果 | 为什么走 rasterize |\n|---|---|\n| **Font Awesome 图标**（`\u003Ci class=\"fa-*\">`） | dom_extractor 会把 FA 元素 `display:none` 隐藏，**直接写不会出现在 PPT 里** |\n| **径向渐变**（`radial-gradient`） | 仅支持 linear |\n| **毛玻璃**（`backdrop-filter: blur`） | PPT 无对应能力 |\n| **裁剪形状**（`clip-path`、`mask-image`） | PPT 无对应能力 |\n| **混合模式**（`mix-blend-mode`） | PPT 无对应能力 |\n| **复杂 filter**（`drop-shadow`、多个 filter 叠加） | 转换不稳定 |\n| **复杂 SVG**（含动画 \u002F 滤镜 \u002F 渐变填充） | 序列化后可能视觉退化 |\n| **拿不准能不能识别的复杂视觉** | 主动声明意图，避免错位 |\n\n### 5.2 怎么写\n\n把要整块截图的内容包在 `\u003Cdiv data-tabslide-rasterize>` 里：\n\n```html\n\u003C!-- Font Awesome 图标兜底（极其常用） -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"position:absolute;top:80px;left:80px;width:48px;height:48px;\n            display:flex;align-items:center;justify-content:center;\n            color:#2563EB;font-size:32px\">\n  \u003Ci class=\"fa-solid fa-chart-line\">\u003C\u002Fi>\n\u003C\u002Fdiv>\n\n\u003C!-- 复杂 SVG 装饰兜底 -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"position:absolute;top:80px;left:80px;width:200px;height:60px\">\n  \u003Csvg viewBox=\"0 0 200 60\">\n    \u003Cdefs>\n      \u003ClinearGradient id=\"g\">\n        \u003Cstop offset=\"0\" stop-color=\"#2563EB\"\u002F>\n        \u003Cstop offset=\"1\" stop-color=\"#7C3AED\"\u002F>\n      \u003C\u002FlinearGradient>\n    \u003C\u002Fdefs>\n    \u003Cpath d=\"M0,30 Q50,0 100,30 T200,30\" stroke=\"url(#g)\" stroke-width=\"3\" fill=\"none\"\u002F>\n  \u003C\u002Fsvg>\n\u003C\u002Fdiv>\n\n\u003C!-- 径向渐变兜底 -->\n\u003Cdiv data-tabslide-rasterize\n     style=\"width:300px;height:300px;border-radius:50%;\n            background:radial-gradient(circle at 30% 30%, #FFD700, #FF8C00)\">\u003C\u002Fdiv>\n```\n\ndom_extractor 看到 `data-tabslide-rasterize` 属性后：\n\n1. 截图整个 div（含所有子元素，@2x 分辨率）\n2. 上传到 OSS\n3. 当一个 image PPTElement 输出\n4. 子元素**不再被其他识别函数提取**（不会有\"图片 + 文字\"双重提取）\n\n### 5.3 规则\n\n- ✅ rasterize 区域**必须**有明确的 `width` \u002F `height`（截图 clip 来自 getBoundingClientRect，无尺寸截不出来）\n- ✅ 在编辑器里 rasterize 出的 image 只能整块拖动、缩放，**不能改文字 \u002F 颜色**\n- ❌ 别用 rasterize 包裹本来就能识别的简单卡片 \u002F 文字 —— 浪费，且失去可编辑性\n- ❌ rasterize 内不要再嵌套 rasterize（只截最外层）\n\n## 六、明确禁止 \u002F 不识别\n\n以下用法即使写了也会被忽略或导致异常 —— 看到下表的视觉需求**第一反应应该是走 rasterize**：\n\n| 用法 | 后果 |\n|------|------|\n| `\u003Ci class=\"fa-*\">` 不包 rasterize | 图标被 `display:none` 隐藏，PPT 里看不到 |\n| `radial-gradient` 不包 rasterize | 形状仍输出但渐变丢失（保留 bg \u002F 边框） |\n| `backdrop-filter` 不包 rasterize | 毛玻璃丢失 |\n| `clip-path` \u002F `mask-image` \u002F `mix-blend-mode` 不包 rasterize | 视觉丢失 |\n| `\u003Cp>` \u002F `\u003Ch*>` 上写 `background` \u002F `border` \u002F `box-shadow` | 文字识别成功，但背景边框丢失 |\n| `position: fixed` | 坐标计算异常（相对视口而非 `.ppt-slide`） |\n| CSS `animation` \u002F `transition` \u002F `@keyframes` | PPT 不支持，渲染期被忽略 |\n| `\u003Ciframe>` `\u003Cvideo>` `\u003Caudio>` | 不识别（slide generate 不输出此类元素） |\n| `\u003Cul>` \u002F `\u003Col>` 嵌套结构（多层） | 识别不稳；改用 `\u003Cdiv>` 排列 |\n\n## 七、配色与样式约定\n\n### 7.1 颜色写法（任选其一，能识别）\n\n- ✅ CSS 变量：`var(--slide-primary)`（保证全局一致，推荐多页演示统一用）\n- ✅ 直接写 hex \u002F rgb \u002F rgba：`style=\"background:#2563EB\"` \u002F `style=\"color:rgba(255,255,255,0.7)\"`\n- ✅ 自定义 class 里写原生 CSS：`.title{color:#1F2937}`\n\n**优先使用 CSS 变量** —— 主题切换时统一更新。多页演示混着用容易出现某页跳色。**不要用 Tailwind 工具类**（`bg-blue-500`\u002F`bg-[#2563EB]` 等不会生效）。\n\n### 7.2 CSS 变量速查\n\n| 变量 | 默认值 | 用途 |\n|------|--------|------|\n| `--slide-primary` | #2563EB | 主色 |\n| `--slide-accent` | #DC2626 | 强调色 |\n| `--slide-text` \u002F `--slide-text-secondary` | #1F2937 \u002F #64748B | 正文 \u002F 辅助文字 |\n| `--slide-bg` \u002F `--slide-bg-subtle` | #FFFFFF \u002F #F8FAFC | 背景白 \u002F 浅底 |\n| `--slide-border` | #E2E8F0 | 边框色 |\n| `--slide-success\u002Fwarning\u002Ferror\u002Finfo` | 绿\u002F橙\u002F红\u002F蓝 | 状态色 |\n| `--slide-blue\u002Fteal\u002Fgreen\u002Forange\u002Fred\u002Fpurple` | — | 六色板（图表 \u002F 卡片配色） |\n| `--slide-radius-sm\u002Fmd\u002Flg\u002Fxl\u002Ffull` | 8 \u002F 12 \u002F 16 \u002F 24 \u002F 9999 px | 圆角 |\n| `--slide-shadow-sm\u002Fmd\u002Flg\u002Fxl` | — | 阴影 |\n\n### 7.3 组件 class 速查\n\n| class | 说明 |\n|------|------|\n| `.slide-cover` | 居中封面页（flex column center） |\n| `.slide-content` | 标准内容页（纵向 + 60\u002F80 px 内边距） |\n| `.slide-split` \u002F `.slide-split-40-60` | 1:1 \u002F 2:3 分栏 |\n| `.slide-grid-2\u002F3\u002F4` | 等宽网格 |\n| `.slide-title` \u002F `.slide-title-lg` \u002F `.slide-subtitle` | 48 \u002F 64 \u002F 28 px |\n| `.slide-heading` \u002F `.slide-body` \u002F `.slide-caption` \u002F `.slide-label` | 36 \u002F 20 \u002F 14 \u002F 14 px |\n| `.slide-number` | 56 px 数字高亮 |\n| `.slide-card` \u002F `.slide-card-bordered` \u002F `.slide-card-accent` \u002F `.slide-card-filled` | 卡片变体 |\n| `.slide-card-glass` | ⚠️ 含 backdrop-filter，毛玻璃效果**必须 rasterize** |\n| `.slide-kpi`（内含 `.kpi-label \u002F .kpi-value \u002F .kpi-change.up\u002F.down`） | KPI 指标卡 |\n| `.slide-table` \u002F `.slide-table-minimal` | 表格主题 |\n| `.slide-badge` \u002F `-primary\u002Fsuccess\u002Fwarning\u002Ferror` | 标签（不要塞 FA 图标） |\n| `.slide-list` | 带圆点列表（CSS `::before` 实现，识别为 div 文字） |\n| `.slide-divider` \u002F `.slide-divider-accent` \u002F `.slide-accent-bar` | 装饰线 \u002F 条 |\n| `.slide-step-number` | 数字圆圈（识别为 shape + text） |\n| `.slide-timeline` + `.slide-timeline-item` | 时间线 |\n\n## 八、页面模板\n\n> 6 套可直接套用的整页 HTML 模板（封面 \u002F KPI 仪表盘 \u002F 图表页 \u002F 对比分析 \u002F 表格页 \u002F 总结页）见 [`examples\u002Fpage-templates.md`](examples\u002Fpage-templates.md)。\n\n## 九、自查清单（生成前过一遍）\n\n- [ ] 复杂装饰 \u002F 图标 \u002F 示意图 \u002F 渐变描边优先用内联 `\u003Csvg>` 矢量，而不是 CSS 硬凑再 rasterize\n- [ ] 自定义 class 没有与 Tailwind 工具类同名（`list-item` \u002F `grid` \u002F `flex` \u002F `block` \u002F `hidden` \u002F `table` \u002F `container` 等）\n- [ ] 每个 `\u003Ci class=\"fa-*\">` 都包在 `data-tabslide-rasterize` 容器内\n- [ ] 没有用到 `radial-gradient` \u002F `backdrop-filter` \u002F `clip-path` \u002F `mask-image` \u002F `mix-blend-mode`（除非包 rasterize）\n- [ ] `\u003Cp>` \u002F `\u003Ch*>` 上没有 `background` \u002F `border` \u002F `box-shadow`（搬到外层 div）\n- [ ] 渐变只用 `linear-gradient`，stop 位置和颜色清晰\n- [ ] rasterize 容器都有明确的 `width` \u002F `height`\n- [ ] 没有 CSS `animation` \u002F `transition` \u002F `@keyframes`\n- [ ] 元素不超出 1280×720 边界（遵守 design-guide 容量预算；`slide render` 对 `html_overflow` 默认拒绝导出）\n- [ ] 图表用 ECharts \u002F Chart.js canvas，不是手画的 div 柱状图\n- [ ] 每个图表容器都有非零的显式 `width` \u002F `height`；初始化放在布局完成后，并在需要时调用 `chart.resize()`\n- [ ] 表格用 `\u003Ctable>` 而不是 div 网格模拟\n- [ ] 真实图片走 `data:image\u002F*;base64` 内嵌（不是只贴第三方外链，更不是用文字\u002F色块假装）\n",{"name":5,"metadata":24,"description":31},{"tabtin":25,"version":30},{"category":26,"displayName":27,"autoActivateFor":28},"doc","TabSlide HTML 生成规范",[29],"tabslide","0.4.0","转换 HTML 为 PPT 元素——把 HTML 转成可编辑 PPT 元素的契约：白名单决定可编辑范围，data-tabslide-rasterize 兜底复杂视觉。\n","main","b84fb2b9810cd71df8350a0e52486c5327c2c929","packages\u002Fapps\u002Ftabslide\u002Fskills\u002Fhtml-spec",115,"https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin","https:\u002F\u002Fwww.tabtin.com\u002F","https:\u002F\u002Fgithub.com\u002Ftabtin-ai","People, teammates, and Agents, meeting in one workspace. \u002F 你、搭子、Agent，在同一工作区里碰头。","2026-10-08 06:44:53",{"source":8,"skillName":5,"commands":42,"prompt":52,"zipAvailable":53},[43,46,49],{"tool":44,"command":45},"npx","npx skills add tabtin-ai\u002FTabTin --skill html-spec",{"tool":47,"command":48},"bunx","bunx skills add tabtin-ai\u002FTabTin --skill html-spec",{"tool":50,"command":51},"pnpm","pnpm dlx skills add tabtin-ai\u002FTabTin --skill html-spec","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fapps\u002Ftabslide\u002Fskills\u002Fhtml-spec\u002FSKILL.md",true,[55,61],{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"examples\u002Fpage-templates.md","REFERENCE","参考文档",5826,"https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fapps\u002Ftabslide\u002Fskills\u002Fhtml-spec\u002Fexamples\u002Fpage-templates.md",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Feditable-whitelist.md",6279,"https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fapps\u002Ftabslide\u002Fskills\u002Fhtml-spec\u002Freferences\u002Feditable-whitelist.md",[66,73,80,87,94,101],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M7AV7T04TVTA6639VSJA1MDM","tabtracker","管理自动化任务——创建、列出、暂停、恢复、立即触发（产品模块名「自动化」， 具体条目称「自动化任务」；CLI 命令仍为 tabtin tracker）。当用户表达\"派活\"意图时使用： 关键词包括\"帮我...\"、\"以后...\"、\"每天...\"、\"工作日...\"、 \"提醒我...\"、\"定时...\"、\"每周...\"。区分一次性指令（直接执行）和长期任务（创建 自动化任务，由调度器在指定时间唤起 Agent）。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Ftabtracker\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7AV7NXF303AF687GR2RZPG3","tabtin-project","在 Project Task 执行会话中工作：先读取当前任务工作面，再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task，或用户要求继续修改过程中的中间产物时使用。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Ftabtin-project\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M7AV7JYFJ6HN80D12TGMMSTF","skill-market","管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达\"装个技能 \u002F 卸载技能 \u002F 看看有什么技能 \u002F 启用禁用技能\"意图时使用。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Fskill-market\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AV7F28TS1PCC9XE0859AVM","tabtin-widget","渲染可视化组件——用 show_widget 编译 SVG \u002F HTML(no-script) \u002F Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget；长期可编辑产物 → TabData\u002F TabDoc\u002FTabSlide。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Fbundled\u002Fplatform\u002Fvisualization\u002Ftabtin-widget\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M7AV7AWNVX8A2RXRX675350G","resource-link","插入资源链接——在 chat 文字流里给资源链接，markdown link 形态 [显示文本](tabtin:\u002F\u002Fresource\u002F\u003Ctype>\u002F\u003Cid>?hint=\u003CcarrierApp>)， 用户点击直接在 Space 内打开。行业格式（http\u002Fhttps\u002F file\u002Fmailto）也兼容；不要写 file:\u002F\u002F 让用户自己复制粘贴。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Fbundled\u002Fplatform\u002Fvisualization\u002Fresource-link\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M7AV77XTH24EH30RYN9N5TKB","mcp-operations","操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools\u002Fresources\u002F prompts，并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到\"使用 Playwright MCP\"\"调用本机安装的 MCP 工具\"\"读取某个 MCP resource\"\"获取某个 MCP prompt\"时激活。","https:\u002F\u002Fgithub.com\u002Ftabtin-ai\u002FTabTin\u002Fblob\u002Fmain\u002Fpackages\u002Fskills\u002Fbundled\u002Fplatform\u002Fmcp\u002Foperations\u002FSKILL.md",[],[]]