SuperAPI AI 工具集

html-to-bento-slides

前端与建站

查看项目

更新于 10-16 09:59

技能介绍

用途:把已有的 HTML/CSS/JavaScript 幻灯片重建为原生 bento/slides 文档数据,属于迁移工作流,而非 HTML 包装。bento 文档是纯数据,不能携带任意源 JavaScript、框架运行时或未净化 HTML。

主要能力与原则:保留源内容、页序、视觉标识与交互语义,除非用户要求重新设计;不擅自改排版、改文案、加动效。若通用 bento-slides 编写技能同时激活,其约束用于外壳/模式,但迁移选择由本技能主导,不能借设计默认值重做现有 HTML 幻灯片。

必要用法:阅读 references/source-analysis.md,同时检查源文件与渲染结果,把源 HTML 视为不可信可执行内容,用隔离浏览器上下文而非已登录个人配置。确定演示视口、页边界、页序、增量构建状态、链接、悬停/点击状态、字体及全部本地或远程资源;响应式源需固定在目标视口并报告该选择。为每张可见幻灯片及不同状态在字体图片加载后截取渲染参考。逐对象选择处理方式:native(可编辑文本、形状、图像、svg、表格、图表、代码、媒体)、hybrid(原生内容叠加不透明 svg/位图装饰)、rasterized(仅当无法诚实表达或用户明确优先像素保真时)。不要整页截图图省事。阅读 references/bento-mapping.md 构建文档,维护保真账本记录保留、近似和丢失项,每次近似或丢失都须指明源页/对象与回退方案。获取新的 bento/slides 外壳:curl -fsSL https://bento.page/releases/slides/Bento_Slides.bento.html -o "<name>.bento.html",并从 https://bento.page/slides/agents.md 获取当前编写指南。离线时使用用户提供的指南或本地 docs/agents.md 加 slides/src/model.ts;两者皆无则请求,不要臆造文档结构。只在明文 #bento-doc 块内写 JSON;新转换省略 docId 与 collab;编辑已有文件保留 docId,若 collab 含 ownerPriv、writerPriv 或邀请凭据需先警告。使用确定性元素 id,仅当节点为同一概念对象时保持 id/morphId 跨状态稳定,保留绘制顺序。把图像、svg、可用字体嵌入 doc.assets 以离线可用;仅当嵌入不实用时链接大型媒体并说明播放时需该 URL。阅读 references/output-and-qa.md,渲染结果并在同视口与源对比,运行 window.bento.validate(),逐一测试每页、构建步骤、内部链接、状态、悬停与媒体控件。

交互映射要点:源片段/构建步骤不是普通入场效果,入场在到达页时运行而非点击推进;除非确为入场定时,否则用相邻复制页加共享 id 和 morph/cut 保留手动构建。非线性点击揭示细节映射到 stateOf 页加元素链接;线性下一步点击映射到下一普通页。源悬停切换可映射到 hover 加 showOnHover,不得因省事互换点击与悬停。源过渡仅在行为匹配时映射到最接近的整页过渡;用稳定 id/morphId 重建对象连续性,否则干净切换比虚假 morph 更诚实。原生 bento 链接指向页 id;外部超链接无通用可编辑元素字段,保留可见标签、在交接说明中记录目标并报告丢失的点击;仅当点击必要且用户接受非原生对象时用安全不透明 svg 链接。

完成标准:交付仍为单个自包含 .bento.html 文件,交接需说明输出文件、是否完全离线自包含、多少源页与状态转为 bento 页、显著的近似与丢失项、验证结果及执行的视觉/交互检查。未打开并逐页检查前不得声称转换完成。

限制:资料未提供具体收费、价格、平台兼容范围或性能指标。