HTML Preview API

何时使用

当用户要求你：

• 上传 HTML 或 ZIP 静态页并生成可分享的公开预览链接
• 列出、查询、更新预览项的标题、备注或有效期
• 替换预览内容（保持同一公开 URL）
• 将预览移入回收站、恢复或彻底删除
• 通过程序化方式与 HTML Preview 交互（CI、Agent、curl）

认证配置

HTML Preview 使用 API Key 进行程序化认证。Key 格式为 hp_ 开头的 URL-safe 随机串；创建时仅在 Web 设置页完整显示一次。

首次使用（配置持久化）

如果 ~/.config/html-preview/config.yaml 不存在，必须向用户询问以下信息：