# AI Agent 真能把网站从零部署到上线吗？我用 OpenCode + 星图 API + UCloud CLI 跑通了完整链路

> 作者/来源: admin
> 发布时间: 2026-08-13T10:13:16.911Z
> 分类: 解决方案
> 标签: AI Agent, 部署, OpenCode, 星图API, UCloud CLI
> 原文链接: http://117.50.162.249:3000/yun/articles/2686

---

## 先说结论：AI Agent 现在更像“执行部署任务的人”，不是只会写代码的助手

如果要把一个个人网站从本地文件夹一路部署到公网可访问地址，我会优先看三件事：**它能不能调用真实工具、能不能操作真实云资源、能不能把结果交付出来**。

OpenCode 负责接住自然语言任务，星图 API 负责把模型接进来，UCloud CLI 负责把云资源、网络和部署动作真正跑起来。三者串在一起后，AI Agent 不再只是生成代码，而是能把“安装环境、打开项目、授权云平台、部署服务、返回公网地址”做成一个完整闭环。

这套方案最适合的场景不是大型生产系统，而是**已经有项目文件夹、希望快速上线个人网站或演示项目**的人。它的价值不是替代所有 DevOps，而是把最容易卡住的那一段先跑通。

## 一、问题背景：上线难的地方，通常不是写代码

三星期前，我帮一个朋友看过一个摄影作品集网站的需求。

他有产品思路，也有审美，页面内容也准备得差不多了，但卡在了最常见的地方：默认欢迎页还在，真正上线还没开始。

这类问题看起来很小，实际上会把人拖住很久。因为从“有一个想法”到“公网能访问”，中间会经过一长串技术杂务：

- 写代码或整理静态页面
- 配本地运行环境
- 申请云资源
- 配安全组和端口
- 上传文件
- 启动服务
- 排查访问问题

这些动作本身不难，但它们分散、重复、容易出错，而且每一步都和创意本身关系不大。对很多刚起步的个人开发者来说，真正消耗时间的不是项目本身，而是部署链路。

我更关心的问题也不是“AI 能帮我写什么”，而是“AI 能不能把上线这件事直接做完”。

## 二、核心痛点：部署链路里最麻烦的是“重复劳动 + 工具切换”

如果把传统部署拆开看，最麻烦的地方通常有四个：

1. **工具太多**：代码编辑器、命令行、云平台控制台、远程登录工具来回切换。
2. **步骤太碎**：一个网站上线往往要手动完成十几步。
3. **依赖容易缺**：Node.js、Git、CLI 工具、权限配置，任何一环缺失都会卡住。
4. **验证成本高**：最后拿到一个地址，不代表页面真的能打开。

AI Agent 的意义就在于把这些步骤纳入同一个执行循环里。只要任务边界明确，它就能在授权范围内继续往下跑，而不是只停留在建议层面。

## 三、不同方案对比：我会怎么判断要不要用这套组合

| 方案 | 特点 | 适合场景 | 局限 |
|------|------|----------|------|
| 纯手动部署 | 所有步骤都自己做 | 熟悉云平台、流程固定的团队 | 学习成本高，容易在细节上出错 |
| 只用聊天模型 | 能给建议、生成脚本 | 需要思路、模板、排错建议 | 不能直接操作真实工具和云资源 |
| OpenCode + 模型 API | 能接任务并执行本地操作 | 本地项目整理、代码修改、流程执行 | 还需要外部工具完成云资源动作 |
| OpenCode + 星图 API + UCloud CLI | 能把本地项目、模型调用、云资源操作串起来 | 个人网站、demo、快速上线 | 生产环境还要补安全、监控和审计 |

我选择这套组合，核心原因不是“它听起来先进”，而是它真的把问题闭环了：

- OpenCode 负责执行
- 星图 API 负责模型接入
- UCloud CLI 负责云资源和部署动作

换句话说，它解决的不是“能不能写出一段代码”，而是“能不能把一个网站真的上线”。

## 四、我为什么选这套方案：问题、解决方案、验证能连起来

这次实践的判断逻辑很简单：

**问题**：个人网站从本地到上线，步骤太散，手工操作太多。  
**解决方案**：让 AI Agent 接管可标准化的部署流程。  
**验证**：最终能拿到公网访问地址，并且浏览器里能正常打开。

这套逻辑成立的前提也很清楚：

- 已经有一个可运行的项目目录
- 云资源授权明确
- CLI 和模型配置正确
- 结果可以人工验证

它不是“什么都能自动化”的万能方案，但对于明确、标准、低复杂度的部署任务，已经足够好用。

## 五、实际使用步骤：从装环境到拿到公网地址

### 1）先把基础环境装好

基础工具一共三样：OpenCode、Node.js、Git。

它们分别负责：

- **OpenCode**：AI 编程和任务执行入口
- **Node.js**：让 npm、npx 等命令能正常工作
- **Git**：项目管理和常见代码操作

### 安装 OpenCode

OpenCode 是这次流程的核心。我这里用的是 Windows 桌面版，安装入口如下：

https://opencode.ai/zh/download

界面本身比较简洁，后续配置模型、打开项目、输入部署指令，都是在这里完成。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384011045-303b2f5ec32f143406735b63f36e2661.jpg)

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384011045-303b2f5ec32f143406735b63f36e2661.jpg)

### 安装 Node.js 并配置环境变量

Node.js 需要提前装好，因为后面 Agent 跑流程时会用到 npm 或 npx。

下载入口：

https://nodejs.org

这里以 Windows 的 `node-v24.18.0-win-x64.zip` 为例，解压到 `D:\dev` 文件夹后，再把路径加入系统环境变量。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010996-1518dbc385c8128cc07074ed99aad6cf.jpg)

具体步骤如下：

1. 将 `node-v24.18.0-win-x64.zip` 解压到 `D:\dev` 文件夹。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010933-79eb8f80e165345bdda0d27de171878d.jpg)

1. 进入“系统”页面，打开“高级系统设置”。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010912-25393a569d5bdc6f0ab0942b7b4550f1.jpg)

1. 在“高级”选项卡中进入“环境变量”。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010897-ce7fc8ca2efb470d0da55b0eabab49d3.jpg)

1. 找到“系统变量”里的 `Path`，点击“编辑”后再点击“新建”。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010875-69c656bd7ab32b859f74a1a713f68356.jpg)

1. 把 `D:\dev\node-v24.18.0-win-x64` 加进去。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010860-8b4594070b2755bcdc0931cbed464c27.jpg)

1. 点击“确定”保存。

配置完以后，在 cmd 里执行：

```text
node -v
npm -v
```

如果能看到版本号，说明 Node.js 和 npm 已经可以正常使用。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010840-2c16b0591022e892cb8d049f142b4cf3.jpg)

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010825-45aea5fbcb7b60d05f2d332b003827f7.jpg)

### 安装 Git

Git 的安装比较直接，进入下面这个地址下载对应系统版本，按默认选项安装即可：

https://git-scm.com

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010810-ccbc12017409b3d24dd3289548f29b8e.jpg)

## 2）把 OpenCode 和星图 API 接起来

基础工具准备好后，下一步是让 Agent 能调用模型。

先登录星图控制台，在左侧找到“密钥管理”，点击“创建 API Key”，填完名称后创建。创建完成后，第一时间复制完整 Key。这个 Key 通常只展示一次，关闭窗口后就看不到明文了。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010793-4b12c5c79b38589e368c5d11a08efe34.jpg)

然后找到 OpenCode 的配置文件。Windows 下示例路径是：

```text
C:\Users\Administrator\.config\opencode\opencode.json
```

实际使用时，把 `Administrator` 换成自己的用户名。

## OpenCode 配置示例

用记事本打开 `opencode.json`，写入下面的配置。通常只需要替换两处：`YOUR_API_KEY` 和模型 ID。

```text
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "modelverse": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "UModelverse",
      "options": {
        "baseURL": "https://api.modelverse.cn/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro",
          "limit": {
            "context": 1000000,
            "output": 65536
          }
        }
      }
    }
  }
}
```

这里的 `baseURL` 填 `https://api.modelverse.cn/v1`，`apiKey` 换成刚才复制的 Key，模型 ID 示例用 `deepseek-v4-pro`，也可以按控制台里实际可用模型替换。

## 3）打开项目目录，准备执行部署

配置完成后，在 OpenCode 里打开准备部署的项目目录。这里以 `D:\website` 为例。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010778-cf7ec1b04a52c2a38268ec3a4cbf7abe.jpg)

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010761-75c2750441756e2db3fcb8773494874e.jpg)

再选择前面配置好的模型。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010747-19dab05cec1808758f47a7d84642cdba.jpg)

## 4）让 Agent 调用 UCloud CLI 去部署

这一步才是整条链路里最关键的地方。

我给 Agent 的任务很直接：

```text
使用 UCloud CLI 将 D:\website 下的项目部署到乌兰察布云主机，部署完成后返回外网访问地址。
```

这个指令里有三个最重要的信息：

- 项目在哪里
- 部署到哪里
- 最终要返回什么结果

任务边界越清楚，Agent 执行得越稳定。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010732-a00fbfc8c8980a86e4c37dad65733211.jpg)

## Agent 实际会做什么

1. 先检查本地环境。如果发现没有 UCloud CLI，会先补上相关能力，例如通过 `npx skills add ucloud/skills ucloud-cli` 添加能力。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010716-1a5bea388ee22a46d3e8f39c28705441.jpg)

2. 下载 UCloud CLI 客户端到本地，准备把网站发布到云主机。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010698-714b3e9ab568abd46628bf85dcb4048d.jpg)

3. 发起授权流程。可以在本地登录，把 OpenCode 里提示的登录命令复制到 cmd 里执行。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010673-b72b2df8545756ca4278dc7820cb1423.jpg)

4. 浏览器弹出登录窗口后，确认授权，再回到 OpenCode 继续。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010657-705c7723d62bf2f78d6e8e6749c844cf.jpg)

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010642-95904d79d31f6824959ca89d3ac8d3bb.jpg)

5. 正式执行部署。它会创建云主机、配置安全组、上传文件、启动服务。遇到权限确认时，确认无误后再允许。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010628-7a0ee425307fe30644539debed4611a0.jpg)

6. 部署完成后，OpenCode 对话窗口会返回结果。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010611-1f3be81ccd0362e29dc1cf58afa2e7d8.jpg)

7. 最后，公网访问地址会出现在对话窗口里。

![](https://ucloud-blog.cn-bj.ufileos.com/imagebed/0998213384010591-84a7f49e55767436da21d0919ec8007e.jpg)

把地址复制到浏览器里回车，页面能正常打开，这才算真正完成部署。

## 六、这套方法的实际价值：把“部署难”变成“执行一条任务”

过去部署一个网站，往往要自己拆成很多动作：

- 注册云平台账号
- 实名认证
- 充值
- 选云主机
- 下单等待开通
- 远程登录
- 安装环境
- 配安全组
- 开放端口
- 上传文件
- 改配置
- 启动服务

现在，这些事情可以被 Agent 串在一起。用户只需要提供三类信息：

1. 项目路径
2. 部署目标
3. 期望结果

对比下来很明显：

| 传统方式 | Agent 方式 |
| --- | --- |
| 手动查文档、手动切工具 | 用自然语言直接描述任务 |
| 手动安装 CLI、登录云平台 | Agent 自动检测缺失依赖并发起授权 |
| 手动创建云主机和安全组 | Agent 通过 UCloud CLI 执行 |
| 手动上传文件、启动服务 | Agent 按步骤完成部署 |
| 手动排查结果 | 直接用公网地址验证 |

我会把这类能力理解成一种“执行型 AI”，它不只是给建议，而是接住任务后一步一步完成。

## 七、实际使用建议：别把它当成无条件自动化

让 AI Agent 操作真实云资源时，边界一定要留清楚。

### 我会特别注意这几件事

- **授权最小化**：API Key、云账号权限和 CLI 授权都只给必要范围。
- **指令写清楚**：项目路径、地域、云主机目标、返回结果都要说明确。
- **结果必须验证**：拿到公网地址后，一定要在浏览器里打开确认。
- **成本要可控**：云主机创建后会产生费用，测试完及时确认是否保留。
- **密钥要保护**：API Key 不要写进公开仓库，也不要随手截图传播。

## 八、适合什么场景，不适合什么场景

### 适合

1. **个人作品站上线**：比如摄影作品集、设计作品集、个人主页。
2. **演示项目部署**：把本地 demo 快速放到公网，给客户、同事、朋友访问。
3. **低频开发者试验**：平时不想长期维护复杂 DevOps，但想快速验证想法。

### 不适合

1. **高并发业务**
2. **强合规业务**
3. **复杂微服务系统**
4. **对权限、审计、备份要求很高的生产环境**

如果是生产环境，通常还要补这些能力：

- 权限控制
- 日志监控
- 备份恢复
- 安全审计
- 成本管理
- 灾备和告警

## 九、工具清单

- OpenCode：https://opencode.ai/zh/download
- Node.js：https://nodejs.org
- Git：https://git-scm.com
- 星图 API：登录星图控制台创建 API Key，并配置到 `opencode.json`
- UCloud CLI：由 Agent 在执行过程中安装和调用

## 十、FAQ

### Q1：OpenCode 在这套流程里负责什么？

OpenCode 负责打开本地项目目录、接收自然语言部署指令、调用配置好的模型，并在授权范围内执行工具操作。它是 Agent 执行任务的入口。

### Q2：为什么一定要安装 Node.js？

后续流程可能会用到 npm 或 npx 安装和调用工具。如果本机没有 Node.js，Agent 在执行命令时可能无法运行相关依赖。

### Q3：星图 API 的作用是什么？

星图 API 负责给 OpenCode 提供模型调用能力。配置 `baseURL`、API Key 和模型 ID 后，OpenCode 就可以通过该接口调用指定模型。

### Q4：UCloud CLI 在部署中做什么？

UCloud CLI 负责和云平台交互。它可以帮助 Agent 创建云主机、配置网络、安全组、上传文件并启动服务。

### Q5：这套流程能直接用于生产环境吗？

不建议不加改造就直接用于生产环境。个人网站、演示项目和低风险试验更适合这套流程；生产环境还需要权限控制、日志监控、备份恢复、安全审计和成本管理。

### Q6：如果 API Key 只展示一次，应该怎么处理？

创建后应立即复制并保存到安全位置。不要把 API Key 提交到公开代码仓库，也不要在截图或公开文档中暴露。

## 最后总结

我对这类方案的判断很简单：如果一个 AI Agent 能把“本地项目、模型调用、云资源操作、网络配置、最终验证”连成一条链，它就已经不只是聊天工具了。

OpenCode、星图 API 和 UCloud CLI 组合起来后，AI 可以从本地项目出发，在授权范围内创建云资源、配置网络、部署网站，并返回公网访问地址。对于想快速上线个人网站的人来说，这条链路已经足够清晰：先装 OpenCode、Node.js 和 Git，再配好星图 API，最后把项目目录和部署目标交给 Agent。

剩下的关键动作，可以交给它执行；最终结果，还是用公网地址直接验证。