htmlrun · 本地 HTML 在线分享

问题场景

你刚在本地写好或让 AI 生成了一份 单文件 HTML（演示页、报告、小工具界面），下一步往往是「给别人一个能直接打开的链接」。自建静态托管、配 CDN 或走完整 CI 对这类一次性产物来说偏重；而截图或发文件又不好协作、也不方便后续改一版再分享。

技能如何工作

本技能随包分发 scripts/htmlrun.cjs：在已安装 Node（建议 16+）的环境里用 node 执行即可，无需再单独安装 htmlrun 包。典型流程是：

1. 环境与凭据：首次发布前用 --check 检查 Node 与是否已激活；未激活时会给出网页链接（及可能的终端二维码）完成设备激活，也可通过管理端的 bind 配对码 或 login --token 写入已有 token。
2. 内容归一化：若输入是 Markdown 或片段，先整理成完整、独立的 HTML；样式与脚本应写在同一文件内（<style> / <script>），本地图片由 CLI 自动内联，一般不必手转 base64。
3. 发布与更新：publish <文件> 上传到 html.run；CLI 输出里的 链接: 应原样交给用户。同一路径再次发布且不加 --new 会沿用原链接并递增版本；只有明确要新地址时才加 --new。
4. AI 协助编辑：用户从页面拿到 d_ 开头的协助码时，走 draft pull → 改 HTML → draft push；改动在浏览器里预览，发布须用户在页面上确认，协助码不能替代 token 直接上线。

执行时应相信 CLI 原文：链接、敏感词提示、⚠ 已被限制访问、指引: 等字段按输出转达，不要自行改写或宣称「发布成功」而忽略限制。

边界与注意点

• 只支持单文件静态 HTML，不是需要构建或多文件工程、也不是带后端的应用；这类需求应如实说明本服务不合适。
• 用户只要本地预览、没有「要链接给别人」的意图时，不必调用发布流程。
• token（h_ 开头）与协助码（d_ 开头） 均不应出现在对话或写入文件的明文里；token 失效时不要拿协助码或 publish 权限绕开用户确认。
• 命中敏感词、访问被限制、429 限流或 token 无效时，按 CLI 提示处理，限流不要自动重试。更细的 API 与限流见技能内 references/api.md。