什么叫“单文件 HTML”？
就是一个完整的 .html 文件，页面需要的样式和脚本尽量都放在里面。这样上传后更稳定，不容易出现“本地能看、线上缺东西”。
给第一次使用的人
让 AI 做页面，再把它上传到线上
你不需要先学会服务器、部署或复杂代码。你只要准备好页面想做什么，项目展示台负责接住 AI 生成的 HTML，并给你一条可以分享的私密链接。
你说清楚想做什么
AI生成单文件 HTML
平台上传并生成链接
一句话
AI 负责“做页面”，项目展示台负责“发出去”。
你不需要把两个角色混在一起：先让 AI 把内容和样式做好，再让它用项目 token 调用发布接口。
照着做就行
第一次发布，按这 5 步走
整个过程通常只需要几分钟。第一次最重要的是把 token 保存好。
- 01
登录后，先创建一个项目
项目就是一个页面的“家”。例如「8 月周报」「课程介绍页」「客户方案」都可以各自建一个项目。
进入控制台 → 新建项目 - 02
生成发布 token，并保存好
在项目里点击“生成 token”。它像一把只属于这个项目的钥匙，AI 需要它才能代你上传页面。
只在第一次生成时保存完整 token - 03
把接入信息交给 AI
把项目展示台提供的项目参数和下面的提示词，一起发给 Codex、Claude、小龙虾或其他能执行操作的 AI。
重点是 endpoint、projectSlug、token - 04
让 AI 生成并上传单文件 HTML
AI 会先把页面做成一个完整的 HTML 文件，再通过发布接口上传。遇到预检错误时，让 AI 先修正，再重试。
发布成功后会得到版本号 - 05
打开私密链接，确认后再分享
先自己打开一次页面，确认手机和电脑上都正常，再把完整链接发给客户、群成员或合作方。
以后更新版本，链接不用换
最关键的一步
把这段话交给 AI，让它完成上传
在控制台里生成 token 后，把真实的项目参数替换进来，再整段复制给 AI。
可复制提示词AI 发布指令模板
请把你生成好的单文件 HTML 发布到项目展示台。
项目参数（请替换成控制台里真实的值）：
- publishEndpoint: https://你的项目展示台域名/api/publish
- projectSlug: 你的项目 slug
- token: psk_你的项目 token
请按下面要求执行：
1. 先生成完整、可直接打开的单文件 HTML，CSS 和必要的脚本都放在文件里。
2. 使用 POST ${publishEndpoint} 发布。
3. 请求头使用：Authorization: Bearer ${token}，Content-Type: application/json。
4. 请求体包含：projectSlug、title、note、html。
5. 如果预检返回错误，先解释错误并修正 HTML，再重新发布。
6. 发布成功后告诉我：版本号、公开链接，以及页面是否通过检查。
不要把 token 展示给其他人，也不要把它写进页面内容。AI 需要能执行操作
如果 AI 只能聊天、不能调用接口，就让它先生成 HTML，再回到控制台的“粘贴 HTML”方式手动发布。
Token 是秘密
不要把 token 发进群里、写进公开页面，或放在截图中。它只应该交给你信任的 AI 或自动化脚本。
不想让 AI 直接上传？
去控制台试一次也可以手动粘贴 HTML
在控制台选择“粘贴 HTML”，把 AI 生成的完整内容贴进去，先做预检，再点击“发布新版本”。这条路更适合你已经拿到 HTML 文件，或者想自己最后确认内容的情况。
遇到问题时
先看这几个最常见的情况
我只会和 AI 聊天，不会写代码，也能用吗？
可以。你只需要创建项目、生成 token，然后把接入指令发给支持执行操作的 AI。页面内容和上传动作都可以让 AI 完成。
为什么 token 只显示一次？
出于安全考虑，服务端不会再次显示完整 token，只保留一小段提示。第一次生成后，请立即复制保存；如果丢了，就作废旧 token，再重新生成一个。
AI 说发布失败，我该怎么办？
先看错误属于哪一类：token 无效就重新生成；HTML 预检失败就让 AI 根据错误修正；项目已归档就先恢复项目。不要反复盲目重试。
分享链接打不开，或者页面不对？
请确认复制的是完整私密链接，尤其是链接末尾的 ?k= 参数没有被截断。发布后先在控制台点“打开私密页”检查，再转发给别人。
现在就试试
创建第一个项目先做一个最简单的页面，跑通第一次发布。
比如让 AI 做一张“本周项目进展”卡片。小目标最容易验证整条链路。