发布你的项目

如果 Publish 或 Update 按钮显示 "Your Cloud Balance is insufficient to publish" 或 "Your Cloud Balance is insufficient to update," 表示你的 Cloud 钱包余额已用尽。

解决方法如下：

1. 前往 Settings > Cloud & AI 查看当前余额。

2. 选择 Top up now，向你的 Cloud 钱包充值。

3. 返回 Publish 面板并重试。

注意：你的 Cloud 钱包与订阅积分是分开的。Cloud 钱包用于托管和部署服务，而订阅积分用于 AI 智能体对话。

1. 检查存储使用情况视图，找出占用最大的聊天、项目和文件。
2. 下载或备份你之后可能需要的内容。
3. 仅删除不需要的项目。如果删除聊天时提供移除关联磁盘数据的选项，请仅在确认这些数据可以安全丢弃后再选择该选项。
4. 刷新页面并确认可用存储空间已增加。
5. 返回 Publish 并再次重试。

删除可能是永久性的，并且可能导致引用已删除文件的项目损坏。如果使用量没有下降，请联系 Support，并附上存储视图、套餐、项目链接以及发布失败的时间。

请等待安全扫描完成，然后在发布前检查每一个被标记的问题。

1. 选择 Resolve All 并检查受影响的行为。在投入生产使用前，修复涉及暴露的密钥、身份验证、权限、用户数据或不安全外部访问的问题。
2. 如果某个密钥可能已暴露，请先将其从项目中移除，并在发布前通过相关提供商进行轮换。
3. 再次运行扫描并验证受影响的流程。
4. 只有在有责任人理解并接受剩余的非关键风险时，才使用 Publish Anyway。请记录原因，并避免在生产站点上绕过未解决的风险。

如果你无法判断某个问题的影响，请不要发布。请联系 Support 或你的安全负责人，并提供问题文本和已脱敏的证据。

1. 分别测试平台生产 URL 和自定义域名。同时比较根页面与出错的具体页面或 API 路径。
2. 记录准确的状态码、完整 URL、时间和时区，以及故障是持续发生还是间歇发生。
3. 检查最新部署状态，以及最近的依赖项、环境变量、数据库或外部服务变更是否与故障开始时间一致。
4. 捕获相关的 Console 和 Network 错误。

如果故障持续存在，请联系 Support，并附上复现步骤、受影响版本和已脱敏的诊断信息。在发送 HAR、命令输出或截图前，请移除 cookies、Authorization 标头、tokens、敏感查询参数、个人数据和支付信息。

如果你的部署超时，或线上站点暂时不可用：

1. 检查平台 Prod 子域名和 Preview 是否都无法访问，还是只有其中一个无法访问。

2. 保持当前错误页面可见——不要反复点击 Publish。

3. 检查你最近是否修改了依赖项、启动入口或数据库连接，因为这些更改可能会影响部署。

如果问题持续存在，请联系 Support，并附上：

- 项目链接和线上 URL

- 故障发生时间和你的时区

- 版本号和错误页面截图

- Preview 是否正常工作

- 你最近是否修改了依赖项、启动入口或数据库连接

如果 Publish 面板显示 "latest" 且按钮呈灰色不可用，或一直停留在 "Building"：

1. 不要反复点击 Publish——这不会加快速度，反而可能创建重复的构建任务。

2. 等待几分钟后刷新页面。

3. 如果刷新后状态仍未变化，请联系 Support。

联系 Support 时，请附上以下信息：

- 聊天链接

- Publish 面板完整截图（包括页面 URL、版本号和按钮状态）

- 问题发生时间和你的时区

- 当前显示的版本号

- 从哪个步骤开始显示 "Building" 或按钮变灰

1. 检查图片是在 App 预览 中缺失、在已发布站点中缺失，还是两处都缺失。
2. 选择一次 Reload App Viewer。如果问题只出现在站点线上版本，请确认最新版本已经发布或更新。
3. 告诉智能体页面位置、应该显示的图片，以及图片最初来源。让它检查当前项目是否仍在使用正确的图片名称和位置。
4. 如果原始图片已被删除或重命名，请重新上传或重新选择目标图片，然后再次测试页面。
5. 如果图片使用了 App 存储 或其他已连接服务，请确认目标服务已连接，并且文件仍然存在。

如果图片仍然无法加载，请联系 Atoms Support，并附上 Chat Link、受影响页面的 URL、图片名称或来源，以及截图。不要包含私人访问链接、密码、密钥或 tokens。

如果导出的自托管包已成功下载，但运行失败：

1. 检查导出包中附带的 README，确认环境要求和设置步骤。

2. 验证你的运行环境是否符合要求（操作系统版本、Docker 版本、Node.js 版本）。

3. 运行启动命令，并查看完整输出中的错误信息。

如果问题持续存在，请联系 Support，并附上：

- 导出版本和下载时间

- 运行环境的操作系统和 Docker 版本

- 执行的完整命令和完整输出

- 失败的脚本或 API 路径

- 预期的部署方式

重要提示：请附上已脱敏的配置示例，但不要包含密码、密钥或 tokens。

App 预览 和已发布站点显示的是项目的不同阶段。保存可视化更改本身不会自动更新线上站点。

1. 在 Design 中选择 Save，并等待当前智能体任务或构建完成。
2. 打开 Publish。发布使用的是最新项目版本；Publish 面板中没有版本选择器。
3. 首次发布请选择 Publish，后续发布请选择 Update。等待直到面板显示 Up to date。
4. 在新标签页中打开线上站点，并刷新一次。
5. 如果默认的 Atoms 地址显示了更改，但自定义域名没有显示，请检查域名连接，而不是反复发布同一版本。

如果线上站点仍显示错误版本，请联系 Atoms Support，并附上 Chat Link、线上 URL、你想发布的版本、时间和时区，以及 App 预览 和线上站点的截图。

1. 立即控制风险。 如果此次发布暴露了敏感数据或造成了不安全行为，请打开 App Status，对符合条件的 Atoms 云应用使用 Pause，或使用 Unpublish 移除公开访问。如果当前没有实际风险，请避免造成不必要的中断。
2. 记录受影响的域名、发布时间、当前版本、目标版本以及业务影响。
3. 当前智能体任务停止后，打开 Versions，选择最后一个已知正常版本，然后选择 Restore this version。
4. 在 Preview 中验证恢复后的版本，包括关键的登录、支付和数据流程，然后再 Publish 或 Update。

恢复项目版本不一定会回滚生产数据库变更或外部操作。不要通过覆盖或删除生产数据来模拟回滚。如果涉及数据、凭据、支付或破坏性更改，请立即联系 Support。

1. 停止当前智能体任务，或等待其完成；当存在冲突中的工作时，无法恢复版本。
2. 打开 Versions，找到最后一个已知正常版本，然后选择 Restore this version。
3. 在 Preview 中检查恢复后的项目，并测试发生过更改的关键流程。
4. 仅在 Preview 结果正确后再 Publish 或 Update。

恢复项目版本并不一定会回滚生产数据库记录、架构更改、环境变量、支付、邮件或其他外部操作。如果此次发布更改了生产数据，或目标版本不可用，请停止操作并联系 Support，同时提供两个版本号、受影响域名以及所需的数据保留结果。

Pause 和 Unpublish 是两种不同的操作：

Pause（仅限 Atoms 云项目）：

- 应用将对访客不可用。

- 服务器资源仍会保留，且继续计费。

- 你可以随时从 App Status 恢复应用。

Unpublish（适用于所有项目）：

- 网站将完全下线。任何使用已发布 URL 的人都将失去访问权限。

- 对于 Atoms 云项目，服务器资源会被释放。

- 你之后可以再次发布该项目，但在此之前访客无法访问。

如果只是临时下线并希望快速恢复，请使用 Pause。若要彻底移除站点，请使用 Unpublish。

如果浏览器显示 "too many redirects"，或页面不断重新加载却不显示内容：

1. 尝试平台默认的 Prod 子域名（而不是你的自定义域名），以判断重定向循环是由域名配置引起，还是由应用本身引起。
2. 如果默认 Prod 子域名可以正常工作，请检查你的自定义域名 DNS 设置，以及域名注册商中可能与平台冲突的重定向规则。
3. 清除浏览器缓存，或在无痕窗口中测试，以排除缓存的重定向影响。

如果问题持续存在，请联系 Support，并附上：

- 出现重定向循环的完整 URL

- 默认 Prod 子域名是否可访问

- 域名和 DNS 提供商

- 完整错误截图

如果你的应用在 Preview 中正常，但在生产环境中因环境变量缺失或为空而失败：

1. 检查环境变量是在上次发布之前还是之后保存的。如果是在发布之后保存的，你需要重新发布才能使更改生效。
2. 确认该变量是为正确环境设置的（Development 与 Production）。
3. 检查下游服务的错误信息是否提供线索——例如，"unauthorized" 通常意味着该环境中的 API key 为空或不正确。

如果问题持续存在，请联系 Support，并附上：

- 项目链接或线上 URL

- 受影响的键名，以及哪个环境存在问题

- 下游服务返回的完整错误信息

- 配置页面的已脱敏截图

- 配置是在发布前还是发布后保存的

重要提示：只提供键名。不要发送密钥值、密码或 tokens。

问题项可能使用相似措辞，但指向不同位置。措辞相似并不一定表示结果重复。

1. 比较每条结果显示的问题名称和位置。
2. 检查每个唯一位置，而不是因为措辞重复就忽略它们。
3. 如果多个问题具有相同根本原因，请修复该原因，然后再次检查每个位置。
4. 在更新后的版本上再次运行安全扫描。

如果相同的问题和位置仍然重复出现多次，请联系 Atoms Support，并附上 Chat Link、扫描时间和时区、问题数量以及已打码截图。请移除问题中可能出现的任何密码、密钥、tokens 或其他敏感信息。

已完成且未报告问题的扫描是一项有用检查，但它不能保证已经发现了所有安全或运行时问题。扫描检查的是所选项目版本；你的应用仍需要按照真实用户的使用方式进行测试。

发布前，请测试应用中的重要流程，包括登录、用户角色、私人数据访问、支付和已连接服务。请为不同角色使用单独的测试账号，并确认每个账号只能访问其预期的信息和操作。

如果你发现某个生产问题可能暴露账号、私人数据、支付信息或凭据，请先停止使用或限制对受影响功能的访问。轮换任何可能已暴露的凭据，然后联系 Atoms Support，并附上 Chat Link、受影响版本、问题复现步骤、时间和时区，以及已打码截图。不要分享已暴露的凭据本身。

如果扫描报告某个仅管理员可执行的操作可能未受保护，在你确认未授权用户无法使用它之前，应将该问题视为未解决。仅隐藏管理员按钮是不够的，如果该操作仍可通过其他方式发起请求。

1. 打开该问题并确认其指出的操作或位置。
2. 确定哪些已登录角色应被允许使用该操作。
3. 让智能体在请求该操作时检查用户权限，而不仅仅是在显示按钮时检查。
4. 在未登录状态下、使用普通测试账号以及使用已授权管理员测试账号分别测试该操作。
5. 确认被拒绝的尝试不会泄露私人数据，也不会产生任何更改，然后再次运行安全扫描。

如果未授权账号仍然可以使用该操作，请不要发布受影响功能。如果你无法解决，请联系 Atoms Support，并附上 Chat Link、问题文本、受影响版本以及已打码截图。

HTTPS 用于保护用户与服务之间传输的信息。如果扫描报告 HTTPS 问题，请根据具体问题定位受影响的地址、资源、回调或域名配置。

1. 打开该问题，并记录其报告的准确位置和地址。
2. 让智能体将该特定连接替换为其提供商支持的安全地址，或修正相关域名配置。
3. 如果外部服务未提供安全等效地址的文档，请不要忽略证书警告，也不要盲目更改地址。
4. 重新测试受影响的用户流程，并确认没有密码、token、支付详情或私人信息通过不安全连接发送。
5. 在更新后的版本上再次运行安全扫描。

如果该问题涉及你无法修正的自定义域名或证书，请联系 Atoms Support，并附上 Chat Link、受影响 URL、问题文本、时间和时区，以及已打码截图。

Row Level Security，即 RLS，是 Supabase 的一项功能，用于控制每位用户可以读取或更改哪些数据库行。只有当项目使用 Supabase，且扫描识别出某个需要检查访问规则的数据表时，这个问题才相关。

1. 打开该问题并确认其指出的数据表。
2. 写下哪些人应该能够查看、添加、编辑或删除该表中的数据。
3. 让智能体创建支持这些用户流程且权限最小化的 Supabase 策略。
4. 在未登录状态下，以及为每种角色使用单独测试账号进行测试。确认每个账号只能访问预期的行和操作。
5. 在应用这些策略后再次运行安全扫描。

不要为了消除警告而禁用 RLS 或允许所有用户访问。在进行可能影响现有数据的更改前，请先确认方案，并在适当情况下保留安全备份或导出。切勿在聊天或截图中分享 Supabase 密钥或数据库凭据。