SuperAPI AI 工具集

create-html-app

前端与建站

查看项目

更新于 10-15 17:17

技能介绍

用途:创建或更新 Hubble HTML App。这类应用是文件夹内的单个 .html 文件,Hubble 将其作为自包含交互界面运行,打开后显示在主内容面板,可用于工具、仪表盘或其他交互体验。若要在 Markdown 文件中内嵌 HTML App,应改用 create-embed。

主要能力与运行时:Hubble 提供运行环境,编写普通 HTML 即可假定已存在 hubble、Alpine、Tailwind 浏览器 v4 和 Hubble 主题令牌等全局对象。默认使用 Alpine 与 Tailwind,不要添加依赖 script 标签,也不要创建 package 文件、锁文件或 node_modules。

文件访问:应用通过 hubble.files 异步代理访问工作区文件,而非直接访问文件系统。路径为工作区相对路径,指向 Markdown 文件。可用方法包括 list、read、open、create、update、remove,方法失败会抛错,且各有 safe* 变体。

使用方式:简单状态可用内联 x-data;涉及异步加载、多个方法或计算逻辑时,应在 script 中通过 Alpine.data() 注册组件并按名称引用,注册需放在 alpine:init 事件内。界面应使用 Hubble 令牌对应的 Tailwind 类以贴近原生观感,保持紧凑间距。

限制:应用运行在沙箱 iframe 中,允许 allow-scripts 与 allow-forms;不允许 allow-same-origin、allow-top-navigation、allow-popups、allow-downloads、allow-modals,因此无法使用同源存储、Cookie、导航桌面框架、打开弹窗或直接下载。具体 API 形状、补丁语义与错误处理需参考 Files API 文档。