数据与高级能力
让内容保存到云端
页面里点了“保存”，不代表数据已经上传。先确定内容要给谁看、由谁修改，再选择合适的保存方式。
为什么添加了，别人却看不到？
如果网页把内容写进 localStorage，它只保存在当前设备、当前浏览器、当前访问地址对应的存储里。换手机、换浏览器，或从默认链接改用自定义子域名，都可能看到另一份数据。登录同一个 html2.link 账号也不会自动搬运这些本地内容。
本地保存适合个人偏好或临时草稿；要让访客看到你新增的内容，网页必须真的调用云端保存功能。编辑器里能预览、页面上有“保存”按钮，都不能证明已经接入。
先选对保存方式
| 需求 | 选择 |
|---|---|
| 自己的主题、临时草稿 | 本地保存，并提供备份方式 |
| 公开留言、共享清单、试玩排行榜 | 云端共享数据，接受访客可修改的规则 |
| 仅发布者维护案例、文章或课程 | 已开放内容管理能力的多文件站点 |
| 私人存档、账户余额、支付或防作弊 | 有服务端身份校验和权限控制的业务后端 |
共享数据不是私人数据库。当前作品的访客可读取、修改或删除共享数据。接入账号登录、隐藏按钮或设置网页内密码，都不会让这些记录变成仅本人可访问的数据。
怎样让 AI 接入云端共享数据
- 备份当前 HTML 或站点项目，尤其是已经保存在本地的内容。
- 打开原作品编辑页，找到数据管理或高级能力接入指南，选择“云端数据”，复制当前生成的完整提示词。
- 把提示词与最新代码一起交给 AI，说明哪些内容需要保存、进入页面时怎样读取、失败后怎样重试。
- 检查数据能力是否允许使用；名额、存储空间和状态以数据管理面板为准。已暂停的作品需要先恢复。
- 更新原作品，通过正式发布链接新增一条测试数据，再用另一台设备读取。
图片、视频需要先上传，数据记录只保存媒体地址。不要把大文件的 Base64 塞进数据记录；共享数据单条记录有大小限制，大存档应拆成独立记录。上传步骤见 图片和视频上传。
怎样避免“提示成功，刷新就没了”
- 等待云端保存请求成功后，才显示“保存成功”；失败时保留输入并提供重试。
- 读取失败时不要把默认空数据写回云端，否则可能覆盖原有内容。
- 多人编辑时不要反复覆盖整份旧列表。每项内容拆成独立记录；需要严格并发控制时使用合适的后端。
- 旧的本地数据不会自动进入云端，需要单独迁移。保留备份，确认云端能读取后再清理本地数据。
如果只是站长添加内容给别人看
这种需求通常不适合访客可改的共享数据。已开放能力的多文件站点可使用 发布者内容管理；单 HTML 页面不能直接使用该接口，可以先在代码中修改内容并更新原页面，或评估迁移为多文件站点。