00. 先认识 Dev Console
在你开始手动敲一大堆命令之前，先认识一下 ZShip 自带的图形化控制台。
它的作用很简单：
- 帮你少记命令
- 帮你少切目录
- 帮你少漏步骤
如果你是第一次接触这个项目，建议先把 Dev Console 打开，再开始后面的部署步骤。
1. 什么是 Dev Console
Section titled “1. 什么是 Dev Console”Dev Console 是 ZShip 自带的本地控制台。
启动后，你会在浏览器里看到一个本地页面，用来管理：
- 新手引导
- 本地启动
- Cloudflare 部署
- 环境变量
- 数据库迁移
- 服务状态
- 品牌配置
- 文档入口
它本质上就是一个本地管理面板。
你不需要背很多命令，也能知道当前系统到底哪里没配好。
2. 怎么启动
Section titled “2. 怎么启动”在仓库根目录执行：
pnpm dev:console启动后，浏览器会自动打开：
http://localhost:3900如果浏览器没有自动打开，你就手动访问这个地址。
3. Dev Console 适合拿来做什么
Section titled “3. Dev Console 适合拿来做什么”如果你是新手，最常用的是下面这几个功能：
1. 新手入门
Section titled “1. 新手入门”它会按步骤带你做：
- 前置条件检查
- 安装依赖
- 环境变量检查
- 数据库迁移
- 启动服务
- 验证环境
这部分非常适合第一次跑本地开发环境。
2. 本地启动
Section titled “2. 本地启动”你可以在界面里看到：
- 后端服务列表
- 前端应用列表
- 每个服务当前是否启动
- 每个服务本地端口
- 每个服务的日志
不用自己一个个窗口去盯。
3. 环境变量
Section titled “3. 环境变量”你可以直接在浏览器里查看和编辑：
- 后端
wrangler.jsonc - 前端
.env
这对新手非常有用，因为很多人第一次就是卡在”到底哪个文件该改”。
4. 数据库迁移
Section titled “4. 数据库迁移”控制台里可以帮你做本地数据库迁移。
这对第一次本地启动很重要。
5. 部署 Cloudflare
Section titled “5. 部署 Cloudflare”控制台里还有部署相关页面，可以帮助你整理：
- 部署配置
- Secrets
- 部署顺序
但你要注意：
- 这份用户指南里的 Cloudflare 主流程，仍然会把命令行步骤写清楚
- 因为命令行步骤更适合作为正式部署文档
- 控制台则更适合作为”减少出错的辅助工具”
4. 什么时候优先用 Dev Console
Section titled “4. 什么时候优先用 Dev Console”推荐优先用 Dev Console 的场景：
- 你第一次跑本地环境
- 你想看服务是否启动成功
- 你想看哪个服务没迁移数据库
- 你想看某个服务的日志
- 你不确定有哪些环境变量要改
5. 什么时候还是看命令行文档
Section titled “5. 什么时候还是看命令行文档”下面这些场景，仍然建议你严格跟着本指南的命令行步骤：
- 第一次创建 Cloudflare 线上资源
- 第一次部署生产 Worker
- 第一次部署生产 Pages
- 需要给团队写标准 SOP 的时候
原因很简单：
- 命令行步骤更容易固化成文档
- 也更适合团队复制执行
6. 你可以把它理解成什么
Section titled “6. 你可以把它理解成什么”你可以把 Dev Console 理解成：
- 本地开发驾驶舱
而这份用户指南：
- 是正式上线说明书
两者不是替代关系。
最合理的用法是：
- 用 Dev Console 降低上手门槛
- 用这份文档确保线上部署步骤标准化
7. 你现在应该先做什么
Section titled “7. 你现在应该先做什么”如果你还没打开过控制台，现在就执行：
pnpm dev:console然后先点一遍：
新手入门本地启动部署 Cloudflare
你不用马上把每个按钮都点完。
先知道它能帮你做什么，后面再回来配合文档一起用。