用途：将单个本地 .html 文件通过 Frevana 自定义域名上传流程发布或更新，成功后在 Frevana 自定义域名上生成可访问页面，并向调用方返回 url、file_key、content_id。
主要能力与固定契约：脚本先通过 GET /subscriptions/user 检查 custom_domain；未配置时在申请上传地址前停止，并引导用户到 https://www.frevana.com/dashboard/domain。发布使用固定取值：category 为 agent_app_result，scene_type 为 content_html，publish_type 为 custom_domain，file_extension 固定 html，content_type 固定 text/html；agent_id 按可用 Agent ID 解析，回退为 frevana-space-cms；team_id 按可用团队 ID 或会话 ID 解析，均无则省略。file_title 优先用 --title，其次从 HTML 的 h1、title、og:title/twitter:title 提取，最后用文件名主干。不得修改待发布文件，也不要用自建 API 调用复现该负载。
使用方式：需要用户指定一个本地 .html 文件路径、环境变量 FREVANA_TOKEN（或一次性 --token）、curl、bash、python3 以及访问 https://api.frevana.com 的网络。新发布执行：bash <skill-path>/scripts/publish_file.sh --file /absolute/path/to/result.html；更新已有内容需带上次返回的 file-key：bash <skill-path>/scripts/publish_file.sh --file /absolute/path/to/result.html --file-key "previous/file_key.html"。文件路径未知时应先询问，不要猜测。
执行顺序：确认路径存在、为普通文件且以 .html 结尾（不区分大小写），其他类型一律在联网前拒绝并说明仅支持 .html；判断是新发布还是更新，更新必须由调用方提供上次 file_key；优先用脚本而非手工 HTTP；脚本读取令牌后调用 POST /s3/custom-upload-url，新发布省略 file_key，更新携带原值，随后直接 PUT 到返回的预签名地址，再调用 PUT /s3/content/{content_id}/publish?op_type=publish；上传与发布均返回 2xx 才算成功，最后输出仅含 url、file_key、content_id 的 JSON。
适用场景与限制：适用于把本地生成的 HTML 结果页发布到 Frevana 自定义域名，并由调用方负责把结果与其 Agent App ID 关联持久化；技能本身无状态，不写历史或边车文件。不支持 .htm、Markdown、JSON、图片、PDF、文档等；未配置自定义域名时无法发布；缺少令牌、缺少更新所需 file_key、上传或发布失败时须如实报错，不得返回公开 URL 或声称已发布；不得泄露预签名 URL、查询参数、令牌或凭据文件。