前言¶
做页面的人经常遇到同一个问题:HTML 文件在自己电脑上能打开,发给别人就打不开。发给同事、发给领导、发到微信里,对方要么没装编辑器,要么下载后浏览器直接拦截本地文件。你自己刚用 AI 生成的 HTML,也想立刻要一个能点开的链接。htmlrun 解决的就是这件事:把本地 HTML 发布成一个 https://html.run/s/xxx 链接,谁都能打开。
这是什么¶
htmlrun 是一个通用 SKILL.md 格式的 Agent Skill,由「索引科技」发布(来源归属 enterprise)。坐标 @org-q447viqi/htmlrun,当前版本 3.0.1,分类 it-ops-security。它的核心只有一件事:把 HTML(以及 Markdown、纯文本转成的 HTML)发布成可分享的 https 链接,别人用手机、电脑、微信打开就能看。
核心功能¶
1、发布。把本地 HTML 或代码发布成一个 https://html.run/s/xxx 链接,替代「发文件给别人」的做法。
2、同链接更新。同一个文件重复发布只更新内容,链接不变。改完页面说「更新一下」「重发一遍」走的就是这条,不用重新生成新链接。
3、展示时间管理。对已发布页面做定时上线、到期自动关闭、临时下线撤回、重新打开,例如「几点开始能看」「到期就关掉」「先别让人看到」。
安装与启用¶
htmlrun 来自 SkillHub,坐标 @org-q447viqi/htmlrun。它带有 requires_api_key=true 标签,说明启用前需要 API Key。具体的安装命令、配置文件路径与字段,以官方页面为准:
官方地址:https://api.skillhub.cn/org-q447viqi/htmlrun
SkillHub 页面:https://www.skillhub.cn/skills/org-q447viqi/htmlrun
需要注意的是,本次核对时官方页面无法访问,抓取资料中也没有给出安装命令与配置字段,因此这里不写未经核实的步骤,避免误导。
典型用法¶
按照官方简介,常见触发方式有几种:
1、用户单独发 /html,或 /html 后面跟着文件、代码,都算要发布。
2、用户刚拿到生成的 HTML,紧接着要一个链接,例如「发我看看」「给个链接」「弄个在线的」。
3、改完页面说「更新一下」「重发一遍」,默认走同链接更新。
4、涉及时间控制的说法,例如「几点开始能看」「到期就关掉」「暂时下线」「撤回」「重新打开」。
这里给出官方的一句话定位,便于判断该不该用它:凡是用户想让别人能打开某个页面,就用它。
适用场景与注意¶
适合谁:需要把 HTML 页面快速给别人看的开发者和内容制作者,尤其是对方不在电脑前、通过微信或手机接收的场景。
限制与坑:
1、它发布的是公开链接,页面内容可以被任何拿到链接的人打开,不要用于需要鉴权或私密的内容。
2、同链接更新意味着内容会覆盖,如果你需要保留历史版本,得自己留底。
3、来源是 enterprise、分类是 it-ops-security,使用前确认组织的 API Key 权限。
4、安装命令与配置字段本次未能从官方页面核实,启用前以官方页面为准。
结尾¶
htmlrun 的价值很明确:把「发个 HTML 文件」变成「发个链接」,同链接可更新,还能管展示时间。如果你经常需要把页面发出去给别人看,值得装一个。官方地址:https://api.skillhub.cn/org-q447viqi/htmlrun