---
url: /zh/workspaces/web-agent.md
description: >-
  介绍基于云原生开发的移动端 Vibe Coding 解决方案 Happy CNB，支持手机随时随地下达编程任务、跟踪进度，并提供 24
  小时云端编程助手与随身助理能力。
---
`云端智能体` 是基于云原生开发能力打造的移动端 Vibe Coding 解决方案，开源代号为 [`Happy CNB`](https://cnb.cool/cnb/cool/happy-cnb)。它把云原生开发环境包装成一个常驻在云端的 Agent，让你通过手机或浏览器即可随时随地驱动它工作，无需在本机安装任何 IDE。

## 使用方式

在仓库分支页面点击右上角 `云原生开发` 按钮，然后选择 `WebAgent` 即可进入云端智能体工作区。

## 典型场景

### 24 小时云端编程助手

> 通过手机下达编程任务，实时反馈做决策、查看进度。

不需要带电脑，也不用挂着 SSH。在通勤路上、会议间隙、夜里临时来灵感时，直接打开手机：

* 描述需求、修改点、Bug 现象，让 Agent 自动改代码、提 PR
* 查看 Agent 当前正在执行的命令、文件 diff、构建日志
* Agent 卡住或需要授权时，手机弹出确认，点一下即可继续

### 24 小时云端随身助理

> 配合手机语音输入，把灵感、问题反馈自动落地到 CNB 平台 Issue 跟进。

镜像默认装好了 CNB Skills 与 CNB Token，Agent 直接具备操作 CNB 平台的能力：

* 想到什么说一句，Agent 把内容整理为 Issue/Comment 并提交到对应仓库
* Bug 反馈可以附带语音转写、截图，Agent 自动归类并 @ 相关同学
* 也可以让它定期巡检 Issue 列表、生成日报/周报

## 与普通云原生开发的差异

云端智能体复用了 [云原生开发](./intro.md) 的全部底层能力，并在此基础上做了四点适配：

| 维度       | 普通云原生开发                         | 云端智能体 (Happy CNB)                                          |
| ---------- | -------------------------------------- | -------------------------------------------------------------- |
| 入口       | WebIDE / VSCode / Cursor 客户端        | 浏览器（含手机浏览器），无需安装任何客户端                     |
| 交互形态   | 用户直接编辑代码                       | 用户通过自然语言驱动 Agent，Agent 编辑代码并执行命令           |
| 环境回收   | 受 [工作区回收机制](./workspace-recycling.md) 限制     | Agent 工作中或等待用户确认时持续上报心跳，不会被回收             |
| 预装能力   | 取决于自定义环境镜像                   | 默认安装 CNB Skills、注入 CNB Token、内置 agent browser 插件   |

## 模型与底层

* **模型**：CNB 平台默认提供 GLM、Kimi、混元（HY）等国内模型，可在 Agent 设置中切换。
* **Agent 内核**：底层使用 [CodeBuddy Code Agent](https://www.codebuddy.cn/)。
* **浏览器调试**：镜像默认安装了 `agent browser` 插件，对 Web 项目调试更友好，开箱即可跑通预览/调试链路。

## 自定义模型

如果默认模型不满足需求，可以在云原生开发环境中配置以下三个环境变量，将 Agent 切换到自建或第三方兼容 OpenAI 协议的模型服务：

| 环境变量              | 说明                                                                |
| --------------------- | ------------------------------------------------------------------- |
| `CODEBUDDY_BASE_URL`  | 模型服务的 API Base URL（兼容 OpenAI 协议的端点）                   |
| `CODEBUDDY_API_KEY`   | 调用上述服务所需的 API Key                                          |
| `CODEBUDDY_MODEL`     | 实际使用的模型名（如 `gpt-4o`、`deepseek-chat`、`claude-3-5-sonnet` 等） |

配置入口：在 `个人设置` → `云原生开发` → `环境变量` 中配置密钥仓库文件；或在仓库根目录的 `.cnb.yml` 里自定义远程开发流水线，通过 `import` 密钥仓库文件注入到工作区。变量在工作区启动时生效，Agent 会自动读取并替换默认模型路由。

::: tip
三个变量需同时配置才会生效；任一缺失，Agent 都会回退到默认模型。
:::

## 漫游配置

云端智能体推荐开启以下两项漫游，让 Agent 跨工作区保留记忆与历史对话：

在 `个人设置` → `云原生开发` 中添加以下条目：

* **CodeBuddy Code 记忆文件**：漫游文件 `/root/.codebuddy/**/*.md`
* **对话历史**：漫游目录 `/root/.happy-cnb`

## 不回收策略

云端智能体底层复用 [云原生开发工作区回收机制](./workspace-recycling.md)，并针对移动端 Vibe Coding 的实际使用习惯做了增强：

::: tip
当 Agent 还在执行任务、或正在等待用户确认时，会持续向平台上报使用心跳，工作区不会被回收。空闲超过阈值才会进入正常回收流程。
:::

## 反馈与共建

Happy CNB 已开源，欢迎提 Issue / PR 一起共建：

* 仓库主页：[cnb/cool/happy-cnb](https://cnb.cool/cnb/cool/happy-cnb)
* 问题反馈：[Issues · cnb/cool/happy-cnb](https://cnb.cool/cnb/cool/happy-cnb/-/issues)