使用 htmlcode.fun 将 HTML 内容或文件部署到网页,适用于用户要求“部署到网页”“托管此 HTML”“生成此前端...的实时链接”等场景。
HTML 即时部署是一项面向实际任务的技能,主要用于Overview.;Use htmlcode.fun 当可交付文件是一个独立的 HTML 文件时, 速度比完整的项目托管更重要;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
当交付物为单个独立 HTML 文档,且速度比完整项目托管更重要时,请使用 htmlcode.fun。该服务是一个开放的 HTML 应用市场:智能体(agents)可部署或更新 HTML,用户可在 Web 界面中手动“点赞”某个版本,被点赞的版本将被保留为不可变快照。
实时指南:
配套脚本:
scripts/htmlcode_deploy.py:支持部署、追加版本、查看版本信息、获取内容及对未锁定版本进行编辑。在以下情况下使用该能力:
请勿使用该能力的情况:
curl -F。description 字段为必填项:需为一句简洁描述,最多 240 个字符。enableCustomCode=true 并提供 customCode。createVersion=true 追加新版本,而非每日/随机生成短码。likeCount > 0,则该版本已被锁定,禁止覆盖或删除。likeCount == 0)在必要时可被覆盖或下线。url、detailUrl 和/或 versionUrl;若存在 preserveHint,也一并告知。429 响应,请遵守响应头中的 retryAfterSeconds 值。、viewport 设置及有用的元数据。POST /api/deploy 发起部署,并提供必需的 description。脚本示例:
python scripts/htmlcode_deploy.py deploy page.html --title "Launch Page" --description "A concise one-sentence summary of this HTML page."
使用稳定的 customCode;后续更新通过追加新版本实现。
python scripts/htmlcode_deploy.py deploy page.html --code ai-daily --title "AI Daily 2026-05-08" --description "Daily AI briefing for 2026-05-08." python scripts/htmlcode_deploy.py append ai-daily page.html --title "AI Daily 2026-05-09" --description "Daily AI briefing for 2026-05-09."
python scripts/htmlcode_deploy.py versions ai-daily python scripts/htmlcode_deploy.py get ai-daily --version 3 --output ai-daily-v3.html
默认情况下,get --output 将响应中 HTML 的 content 字段写入目标文件。仅在明确需要服务器原始下载响应时,才使用 --download 参数。
覆盖前请先检查版本列表。仅当目标版本满足 likeCount == 0 时方可覆盖;若已获点赞,请改用追加新版本方式。
python scripts/htmlcode_deploy.py versions landing-demo python scripts/htmlcode_deploy.py overwrite landing-demo 2 fixed.html --description "Fixes layout issues in version 2."
该脚本在执行 overwrite、status 及 delete-version 操作前,会自动进行 likeCount 检查。
python scripts/htmlcode_deploy.py status landing-demo 2 inactive python scripts/htmlcode_deploy.py status landing-demo 2 active
POST /api/deploy — 部署新应用,或通过设置 createVersion=true 追加版本。GET /api/deploy/content?code={code}&version={version} — 获取元数据与源码。GET /api/deploys/{code}/versions — 列出版本历史及各版本的 likeCount。PATCH /api/deploys/{code}/versions/{version} — 对未锁定版本执行覆盖或状态变更。DELETE /api/deploys/{code}/versions/{version} — 删除一个未锁定版本。删除操作视为敏感操作;除非用户明确要求,否则请先征得确认。PATCH /api/deploys/{code}/current — 在必要时切换公开的当前版本。成功响应时,请保存并反馈以下关键字段:
codeurldetailUrlversionUrlversionNumberqrCodepreserveHint若 API 响应中包含 errorCode、hint、detail、stage、requestId 或 retryAfterSeconds 字段,请在问题排查中充分利用这些信息。对于因版本被锁定导致的错误,请追加新版本,而非尝试覆盖。
ai-daily),而非每次生成带日期的短码(如 ai-daily-0508)。