预览、发布与上线后的观测

代码写完只是一半，让它真的对外生效还要走「预览 → 合并 → 发布」。这篇讲清三者的区别、发布失败怎么办，以及上线之后在哪看访问量和流量来源。

预览、合并、发布分别做了什么

三者互相独立：可以只预览不合并（试试看就丢掉），也可以合并了先不发布（攒几个改动一起上线）。

代码只有发布过才会真的对外生效。合并只是进了默认分支，没发布之前，生产域名上跑的还是上一次发布的版本。

推荐的上线节奏

1. 在 Chat 里提需求，等 Agent 跑完
2. 点 👀 预览，在测试域名上真实点一遍
3. 不满意就在同一个 Chat 里追问，改完再预览
4. 满意后点 合并到应用主版本
5. 点 🚀 发布，等状态变成成功
6. 打开生产域名复核一次

部署记录

每次预览和发布都会留下一条部署记录。消息里的部署徽章、以及 应用 列表里的「部署记录」都能进入发布详情页，那里有：

• 这次部署的环境（测试 / 生产）、状态和耗时
• 完整的构建与部署日志
• 失败时的错误摘要

部署失败不用自己读日志：直接在 Chat 里说"刚才发布失败了，帮我看一下"，Agent 会去查日志并修复。

在发布详情页发布

除了在 Chat 里点按钮，发布详情页本身也能发布生产，不需要你手动挑 commit，两种方式任选其一：

1. 直接发布生产

• 先在顶部「应用」筛选里选中目标应用，右上角的 发布生产 按钮才会出现
• 点开后写一段发布描述（必填，最多 512 字），提交
• 平台会基于默认分支当前的状态触发一次新的生产发布

1. 把已经验过的测试构建切到生产

• 表格里 测试 环境、状态 成功、且 Task ID 与 Chat ID 都是 0 的记录，行末会有 上线 按钮
• 这类记录是某次合并到默认分支后自动构建出来的
• 点 上线 → 确认 → 这次构建被切到生产环境

第二种适合"前面已经在测试环境验过了，希望把这一次的构建原样搬到线上"。

已发布应用

已发布应用 列出所有已经发布到生产的应用，是"我到底上线了哪些东西"的总览。

上线之后：看板

应用 页面的 看板 标签页展示应用上线后的真实表现，数据来自前端性能监控，最多看近 7 天：

• 访问量：页面浏览与访问会话
• 来源渠道：流量从搜索引擎、AI 引擎、社交平台还是直接访问来的
• 加载性能：首屏和关键渲染指标

可以把某个应用设为默认，打开看板就直接看它。如果应用还没接监控，看板上会有一个感叹号入口，点一下就能让 Agent 自动把监控接进去。

为什么要关心「来源渠道」

现在用户找到一个产品有两条路：搜索引擎（SEO）和 AI 助手推荐（GEO）。看板把这两类分开统计，你能直接看出来是 Google / 百度带来的人多，还是 ChatGPT / 豆包这类 AI 入口带来的人多，再决定内容往哪边补。

想提升这两个数字，可以在 Chat 里让 Agent 帮你补齐站点的结构化数据、sitemap.xml、llms.txt 和落地页文案。站外引流是另一条路：让 Agent 按各内容平台的规矩写可直接发布的稿子，见 07-marketing.md。

小程序和安卓：同一个按钮，不同的终点

上面讲的都是 Web 端——预览进测试域名、发布进生产域名。如果这个应用还带了微信小程序或安卓端，同样这两个按钮会顺带做另一件事：

两个差别要记住：

• 微信那边发布不等于上线。 平台只把代码送到「开发版本」，提交审核和发布上线要你自己去微信公众平台点。
• 安卓包不在域名上。 下载入口在你自己的网页里，要构建成功之后再部署一次才会出现；构建记录和签名密钥导出在应用配置的「安卓 App」一页。

小程序上传和安卓出包都挂在 Web 部署之后，失败只标记失败，不会把已经成功的 Web 发布回滚掉。完整流程见 09-multi-target.md。

常见疑问

Q：发布期间线上会不会短暂不可用？ A：构建在后台跑，构建完成后才替换正在运行的容器，这一步会有很短的中断。要紧的话尽量避开访问高峰发布。

Q：发上去发现有问题，怎么快速退回？ A：两条路。发布详情页里找一条更早的、已经验过的 测试 + 成功 记录点 上线，把那次构建切回生产；或者直接在 Chat 里说明要撤掉哪次改动，让 Agent 改回来再发一次。

Q：测试环境为什么搜不到？ A：测试环境全站禁止抓取，这是刻意的——避免测试内容被搜索引擎收录，跟生产域名抢排名。

下一步推荐：05-misc.md