SuperAPI AI 工具集

artifact-preview

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:在编码智能体中,把持久化的 Markdown 产物呈现为一个可读、自包含的 HTML 审阅界面,便于用户查看与检查。源 Markdown 始终是权威版本。

主要能力与流程:在写入持久化 Markdown 产物后(或源文件后续发生变化时),计算源文件的 SHA-256 摘要,并在源文件旁创建或刷新 <basename>.preview.html。审阅页头部包含产物标题、源路径、源状态值(存在时原样呈现,否则标注未声明)和摘要;多章节文档附加目录。页面需包含所属技能提供的审阅范围,使用其真实标签(如内容结构审阅、视觉方向板、动态分镜审阅),说明页面验证的内容,并区分语义声明与渲染证据。

渲染要求:将 frontmatter 渲染为元数据,把每个 Markdown 标题章节渲染为语义化 HTML,包括标题、段落、列表、表格、代码块和安全链接。保留审批状态、未完成检查、证据链接、稳定 ID 以及影响审阅的谱系字段。原始源码附录可选,不以 <pre> 转储作为主要审阅界面。视觉方向板需包含所属技能渲染的 16:9 证明状态并标注项目版本与场景/状态 ID;动态分镜审阅需提供时间轴播放与拖动,以及起始、中间、边界、结束状态。页面应标注为派生审阅材料。

技术约束:使用单个自包含 HTML 文件,内联 CSS 与可选内联 JavaScript;不得依赖服务器、构建步骤、网络请求、外部字体、样式表、脚本、图片或其他本地文件;渲染的图片和媒体可嵌入为 data: 资源。源文本须作为数据转义后再插入 HTML,避免注入。

呈现方式:通过宿主原生 HTML 或浏览器预览呈现页面;在编辑器中打开 HTML 源码不算呈现。Codex 中优先打开渲染的浏览器/文件预览,否则在最终回复中提供指向绝对路径的可点击 Markdown 链接。Claude Code 中使用其浏览器或平台文件打开能力,否则给出绝对 file:// URI 与文件系统路径。只有打开工具确认成功,或宿主渲染出可点击链接/URI 时,呈现分支才算成功;纯未链接路径文本不算呈现。

限制:呈现预览从不记录审批,只有产物所属技能的审批规则才能更改状态或审批元数据;后续源变更会使预览过期。对散文的语义 HTML 渲染不等同于视觉原型、样式帧、动态证明或动态分镜;只有预览包含所属技能实际渲染的证据并标注源项目版本时,才能声称进行了视觉或动态审阅。完成条件是:预览文件存在于源旁、显示的源路径与摘要与当前 Markdown 一致、frontmatter 与所有 Markdown 章节出现在语义审阅界面、所属技能声明的每项渲染证据均可直接检查或播放并归属当前项目版本、静态审计无外部自动加载资源与网络调用、在 1280 px 下无水平溢出,并已通过宿主分支成功呈现。