APP 发布
在应用中制作和检查网站，配置变量与 Secret，发布到 Cloudflare 并持续更新。
MargoWork 的应用将制作对话、文件和开发预览放在同一个工作空间中。你可以先与 Agent 完成页面，再由应用所有者配置发布目标，将网站发布到 Cloudflare。后续修改沿用这个应用，检查后重新发布。
本页从打开一个已有 App 开始，按制作、预览、配置、发布和更新的顺序说明。
开始前
- 打开要制作的网站所对应的 App，确认当前运行环境可用，能够正常发送任务。
- 在应用内选择 Agent 和模型。对话与文件的使用方式见 Agent 使用。
- 应用所有者（Owner）负责网站配置和发布；协作者按照各自权限参与制作。
- 发布需要已授权的 Cloudflare MCP 连接和可用的 Cloudflare 账号。尚未连接时，可以先制作和检查应用，再完成发布准备。
描述需求并制作应用
在当前应用的对话中说明网站的用途、内容、主要操作和预期结果。有图片、文案或参考文件时，一起提供给 Agent。
例如：
制作一个个人作品集网站，包含自我介绍、三张作品卡片和联系入口。点击作品卡片可以查看详情，手机上也要能正常阅读。先完成可以预览的版本。
Agent 完成初版后，在同一应用中继续提出修改。描述具体位置和期望行为，例如“作品详情页增加返回按钮”，或“手机上把三列作品卡片改成单列”。
涉及外部服务时，在任务中写明要展示哪些数据、允许访问哪些内容，以及谁会使用网站。密钥的具体值在后面的「网站配置」中填写。
检查开发预览
- 打开应用工作区中的预览，等待页面加载。
- 检查文字、图片、导航和主要按钮。
- 使用预览工具栏切换手机等尺寸，确认内容能完整显示、按钮能操作。
- 完成一条主要使用流程，例如打开作品详情、搜索内容或提交表单。
- 把问题反馈到当前应用的对话中。Agent 修改后，再检查对应结果；需要时使用预览工具栏刷新。
预览就绪后，可以从工具栏在新窗口打开。折叠右侧面板只会收起视图，不会主动停止应用预览。
开发预览运行在当前 Server 上，用来查看制作过程中的结果。Server 重启后，重新打开预览并等待启动；有编辑权限时，页面会尝试自动启动预览。发布成功后的网站使用单独的线上地址。
预览和线上网站有什么区别？
| 内容 | 开发预览 | 已发布网站 |
|---|---|---|
| 展示的内容 | 当前应用的开发结果 | 最近一次确认发布成功的内容 |
| 访问入口 | 应用工作区的预览及预览新窗口 | 发布区域展示的线上地址 |
| 网站配置 | 不自动获得生产环境的 Secret | 使用该次发布包含的变量和 Secret |
| 修改后的变化 | 在开发预览中继续检查 | 重新发布成功后才更新 |
预览能打开，说明页面已经可以加载；表单提交、外部数据读取和保存结果仍需按网站的实际功能检查。
预览失败时，保留当前应用和已经完成的修改，根据错误提示修复后重试。具体处理见 预览无法打开。
按需配置变量和 Secret
静态展示网站通常不需要额外配置。网站需要从外部服务读取数据，或需要服务端使用的参数时，由 Owner 打开当前应用的设置，在「网站配置」中填写。
图中尚未添加网站配置，也未设置发布连接；先完成对应准备，再发布网站。
| 字段 | 填写内容 |
|---|---|
| 名称 | 与网站代码使用的名称一致，例如 SUPABASE_URL。名称可以包含字母、数字和下划线，首字符不能是数字。 |
| 类型 | 普通参数选择「变量」；令牌、密钥等凭据选择「Secret」。 |
| 值 | 参数或凭据的实际值。Secret 输入框会隐藏输入内容。 |
| 必需 | 网站运行不可缺少的配置勾选「必需」；未填写必需项时，发布会提示缺少的名称。 |
- 让 Agent 说明网站需要的配置名称及用途。
- 在「网站配置」填写名称、类型、值和必需状态，点击「添加配置」。
- 查看列表中的「已配置」或「缺少值」，确认必需项已填好。
- 修改已有配置时，点击「编辑」，填写新值后保存；不再使用的配置可以删除。
- 完成配置后，按下一节发布网站。
保存后不会回显已有配置值。编辑配置时填写完整的新值，核对名称和类型后再保存。Agent 只查看配置名称、类型及是否已填写，不读取配置值。
保存或删除失败时，按错误提示处理。提示配置已发生变化时，先刷新并核对当前配置，再重新保存。已有条目显示「已配置」可能仍对应旧值；以本次操作无错误且列表更新后的状态为准。
场景：展示 Cloudflare 或 Supabase 数据
以展示 Supabase 数据为例，网站可能需要 SUPABASE_URL 作为变量，以及用于访问服务的 Secret。实际名称由网站代码决定；让 Agent 先说明需要的名称，再在配置页面填写值。
网站的服务端使用这些配置请求外部服务，并把允许展示的数据返回页面。不要把服务端密钥写进网页代码或普通对话。
用于发布网站的 Cloudflare 连接和网站读取业务数据所需的 Secret用途不同，需要分别完成配置。添加一个 Secret 不会自动创建数据库、连接数据源或实现页面的数据读取功能。
「待发布生效」是什么意思？
添加、修改或删除网站配置后，当前线上网站仍使用上一次成功发布的配置。只有下一次发布成功，变更才会生效。
生产 Secret 不自动提供给开发预览。如果预览中的真实数据请求因缺少配置失败，需要明确识别这个状态；不能把示例数据当作连接成功。发布后，再检查线上网站是否按预期读取数据。
设置目标并发布
由 Owner 在当前应用的设置中找到「发布」区域。首次发布先选择目标，之后在同一目标上更新网站。
首次设置发布目标
- 在「Cloudflare 连接」中选择已授权的连接。
- 选择要使用的 Cloudflare 账号。
- 点击「设置发布目标」。设置完成后，页面显示该应用对应的 Worker。
每个应用使用固定的独立 Worker。发布目标绑定后，后续发布沿用这个目标。
如果页面显示「暂无已授权的 Cloudflare 连接」，先完成 Cloudflare MCP 的连接和授权，再回到发布区域刷新。连接与授权操作见 Agent 使用。
发布网站
- 确认开发预览中的主要内容和操作已检查。
- 确认网站需要的必需配置已填写。
- 点击「发布网站」，等待发布状态返回。
- 页面显示「已发布」并提供线上地址后，打开地址检查实际结果。
目标配置完成后，Owner 也可以在该应用的对话中明确要求 Agent 发布。制作完成或预览就绪不会自动代表网站已经发布。
如何理解发布状态？
| 页面显示 | 当前含义 | 接下来做什么 |
|---|---|---|
| 正在发布… | 发布请求正在处理，尚未确认完成。 | 等待结果；状态刷新暂停时，使用「刷新状态」。 |
| 已发布 | 本次发布已确认成功。 | 打开线上地址，检查页面和主要功能。 |
| 缺少配置 | 某个必需配置没有值，当前发布未完成。 | 按提示到「网站配置」补齐对应名称，再重新发布。 |
| 发布失败 | 本次操作未确认发布成功。 | 按提示检查配置、连接或构建问题，修复后重新发布。 |
| 发布结果待确认 | 系统暂时不能确认这次发布的最终结果。 | 点击「核对发布结果」，先确认原操作的结果。 |
已有网站时，发布区域可能继续保留上一次成功发布的地址。因此，看到线上链接本身不能证明最新修改已经上线；要同时查看本次状态，并打开网站核对内容。
遇到失败或结果待确认时，详细处理见 发布问题。
分享发布后的地址
发布成功后，从发布区域复制线上地址，交给使用网站的人。分享前打开该地址，确认页面和主要操作符合预期。
需要别人参与制作时，使用 协作共创 中的邀请流程。工作空间的成员权限与网站本身的访客权限分别管理；邀请协作者不会自动给网站增加登录或访问限制。
修改并更新网站
- 回到原 App 的对话，说明需要修改的内容。
- 在开发预览中检查修改，并确认原有主要操作仍正常。
- 网站新增或更换了配置时，由 Owner 在「网站配置」中保存。
- 点击「重新发布」，等待明确的成功状态。
- 打开原发布地址，检查新内容是否生效。
修改源文件、完成预览检查或保存配置，都不会直接替换已经发布的网站。每次重新发布以本次应用内容和配置为准。
如果本次发布失败，先确认当前线上网站实际提供的内容，再修复问题。结果待确认时，使用「核对发布结果」处理原操作。
应用包含数据时
网站涉及数据读取、保存或登录时，需要另外确认这些功能确实由应用实现：
- 展示外部数据：检查线上页面使用的是真实服务返回的数据，以及展示范围是否符合需求。
- 保存记录：完成一次保存，再刷新页面，确认记录仍能读取。
- 使用网站账户：按网站实际的登录和权限流程，确认不同用户能访问的内容。
发布网站不会自动开通数据库、登录服务或数据迁移。更新代码也不会自动回退外部服务中的数据。需要这些能力时，在当前应用任务中说明具体行为，由 Agent 完成相应功能后再检查。