摩诃无量/OpenVibeCoding

代码拉取完成,页面将自动刷新

richgiteeai

Watch

不关注关注所有动态仅关注版本发行动态关注但不提醒动态

1 Star 0 Fork 0

摩诃无量/OpenVibeCoding

代码 Issues 0 Pull Requests 0 Wiki 统计流水线

服务

加入 Gitee

与超过 1400万开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)

免费加入

已有帐号? 立即登录

克隆/下载

HTTPS SSH SVN SVN+SSH 下载ZIP

提示

下载代码请复制以下命令到终端执行

为确保你提交的代码身份被 Gitee 正确识别,请执行以下命令完成配置

git config --global user.name userName 
git config --global user.email userEmail

初次使用 SSH 协议进行代码克隆、推送等操作时,需按下述提示完成 SSH 配置

1 生成 RSA 密钥

2 获取 RSA 公钥内容,并配置到 SSH公钥中

在 Gitee 上使用 SVN,请访问使用指南

使用 HTTPS 协议时,命令行会出现如下账号密码验证步骤。基于安全考虑,Gitee 建议配置并使用私人令牌替代登录密码进行克隆、推送等操作

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # 私人令牌

新建文件新建 Diagram 文件

新建子模块

上传文件

分支 13

标签 0

贡献代码

同步代码

创建 Pull Request

了解更多

对比差异通过 Pull Request 同步

同步更新到分支

通过 Pull Request 同步

将会在向当前分支创建一个 Pull
Request,合入后将完成同步

YANGHANG feat: Coding 模式:自动放行所有写工具(agent 需要自由操作数据库和部署) f5be7cb

249 次提交

.github/workflows

.husky

.opencode

app

docs

packages

patches

scripts

.dockerignore

.env.example

.gitignore

AGENTS.md

CHANGELOG.md

Dockerfile

LICENSE

NOTICE

README-zh.md

README.md

cloud.png

drizzle.config.ts

eslint.config.mjs

init.cmd

init.sh

package.json

pnpm-lock.yaml

pnpm-workspace.yaml

tsconfig.json

README

Apache-2.0

基于腾讯云 CloudBase 构建的开源 AI 全栈应用开发平台 — 对话式生成代码、实时预览、一键部署。

<a href="#快速开始">快速开始</a> ◆だいやまーく
 <a href="./docs/architecture.md">架构</a> ◆だいやまーく
 <a href="./docs/setup.md">部署</a> ◆だいやまーく
 <a href="#加入交流群">交流群</a> ◆だいやまーく
 <a href="./README.md">English</a>

---

## Overview

[Lovable](https://lovable.dev) / [v0](https://v0.dev) / [bolt.new](https://bolt.new) 的开源替代方案 — 基于腾讯云 CloudBase 构建的 AI 全栈应用开发平台。对话式生成代码、实时预览、一键部署,支持双 Agent 运行时(CodeBuddy / OpenCode)与三级环境隔离。

**AI 生成过程**

**应用功能展示**

---

## 为什么选这个

| | Lovable / v0 / bolt.new | 本项目 |
| ---------- | ----------------------- | -------------------------------------------------- |
| 源码 | 闭源 SaaS | 完全开源(Apache 2.0),可私有化部署 |
| 定价 | 按量付费 / 订阅制 | 自带云资源,成本可控 |
| 基础设施 | 绑定特定平台 | 腾讯云 CloudBase(DB / Storage / Functions / CDN) |
| Agent 引擎 | 内置单一模型 | CodeBuddy + OpenCode 双引擎,模型自由切换 |
| 环境隔离 | 用户级隔离 | shared / isolated / task 三级隔离,支持多租户 |
| 沙箱 | 平台托管 | CloudBase SCF + TCR 容器镜像,可自定义运行时 |
| 云资源操作 | 无 / 有限 | MCP 工具直接操作 DB、存储、函数、域名 |
| 部署目标 | 平台内托管 | Web CDN / 微信小程序 / 自定义域名 |
| 人机协作 | 基础对话 | Plan 模式 + ToolConfirm 四值权限 + 内联提问表单 |
| 可扩展性 | 不可扩展 | Monorepo 架构,前后端分离,可二次开发 |

---

## 核心能力一览

| 能力 | 亮点 |
| ----------------- | ---------------------------------------------------------------------------------------------------- |
| **双 Agent 引擎** | CodeBuddy 与 OpenCode 可选,各自独立模型列表,前端一键切换 |
| **三级环境隔离** | shared(共用)/ isolated(用户独立)/ task(独立子账号),Admin 后台热切换,无需重启 |
| **环境池预热** | 预创建 CloudBase 环境 + CAM + Policy,获取延迟从分钟级降至毫秒级;池空时自动回退实时创建 |
| **编码沙箱** | SCF 容器冷启动 → PTY 终端 → Vite Dev Server 端口动态分配;进度细分到镜像拉取、容器就绪、工作区初始化 |
| **实时预览** | 内嵌 Browser 工具栏(地址栏 / 导航 / 刷新);HMR 热更新;预览错误自动修复反馈 |
| **子工作区** | 同一 session 内多个隔离 Scope,独立 dev server,端口 5173–5199 动态分配 |
| **CloudBase MCP** | 50+ 工具覆盖 DB、Storage、Functions、域名、安全规则,Agent 可直接操作云资源 |
| **Human-in-Loop** | 工具执行四值确认(allow / always / deny / exit);内联提问表单,不打断对话上下文 |
| **Plan 模式** | 写操作自动拦截;三按钮决策(执行 / 完善 / 拒绝退出);跨组件状态共享 |
| **工具渲染** | 10 个专属渲染器(Bash / Read / Write / Edit / Grep / Glob 等);Edit 内置 git-diff 视图 |
| **一键部署** | Web 静态托管 → CDN;微信小程序异步部署;产出统一为 artifact,Deployments 标签页聚合展示 |
| **图片生成** | AI 生图自动上传 CloudBase 托管,返回 CDN 链接,聊天内 Markdown 直接展示 |
| **Git 归档** | 任务结束自动 push 远端,按 envId 分支 + conversationId 目录存储;内存 credential,不泄露 token |
| **资源管理面板** | 任务详情页内嵌 DB / Storage / SQL / Functions 可视化管理 |
| **Admin 后台** | 用户管理、环境池监控、provision mode 配置、审计日志 |
| **定时任务** | cron 调度 + 分布式锁防重入 |
| **凭证安全** | AES-256-CBC 加密存储;STS 临时凭证作用域隔离;日志只允许静态字符串 |

---

## Screenshots

**创建任务,选择 Agent 和模型**

![home](docs/assets/home.png)

**编码模式:左侧对话 + 右侧实时预览**

![preview](docs/assets/preview.png)

**Chat 界面:工具调用卡片、Phase 状态指示**

![chat](docs/assets/chat.png)

**Human-in-Loop:工具确认 & 向用户提问**

| ToolConfirm | AskUserQuestion |
| ------------------------------------------------- | ----------------------------------------- |
| ![confirm](docs/assets/human-in-loop-confirm.png) | ![ask](docs/assets/human-in-loop-ask.png) |

**内嵌 CloudBase Dashboard**

![cloud-dashboard](docs/assets/cloud-dashboard.png)

**部署完成,查看 artifact**

| Chat 内 artifact | Deployments 标签页 |
| ------------------------------------- | --------------------------------- |
| ![deploy-0](docs/assets/deploy-0.png) | ![deploy](docs/assets/deploy.png) |

**Admin:环境池管理**

![admin-env-pool](docs/assets/admin-env-pool.png)

---

## 快速开始

**前置条件**

- Node.js >= 18
- Docker
- 腾讯云账号(CloudBase 环境 + API 密钥)
- CodeBuddy API Key 或 OAuth 配置

**一键初始化**

```bash
git clone https://github.com/TencentCloudBase/OpenVibeCoding.git
cd OpenVibeCoding

# macOS / Linux / Git Bash / WSL
./init.sh

# Windows(需先确认已装 Node.js >= 18 和 pnpm)
node scripts/init.mjs
```

初始化脚本依次完成:Node.js 检查 → pnpm 安装 → `.env.local` 生成 → Docker 检查 → CloudBase 配置 → 依赖安装 → CodeBuddy 认证 → TCR 配置 → 数据库初始化。

详细步骤与排障见 [docs/setup.md](docs/setup.md)。

---

## 开发

```bash
pnpm dev # 同时启动 web (localhost:5174) 和 server (localhost:3001)
pnpm dev:web # 仅启动前端
pnpm dev:server # 仅启动后端
```

## 生产

```bash
pnpm build # 构建所有包
pnpm start # 启动生产服务(端口 3001,同时服务 API 和静态文件)
```

## 部署到云托管

本项目支持一键部署到 CloudBase 云托管(容器服务)。无需本地 Docker —— 脚本会将源码和 Dockerfile 提交到云端构建。

**前置条件**

- 已完成 `./init.sh` 初始化(`TCB_ENV_ID`、`TCB_SECRET_ID`、`TCB_SECRET_KEY` 已配置)
- 已安装 CloudBase CLI:`npm i -g @cloudbase/cli`

**一键部署**

```bash
pnpm deploy:cloud
```

脚本会自动执行:
1. 提交源码 + Dockerfile 到云端构建镜像
2. 部署为云托管容器服务(服务名:`vibecoding-platform`,端口:80)
3. 查询并输出服务的访问地址

**部署完成后**

- 访问地址格式:`https://{serviceName}-{id}.{region}.run.tcloudbase.com`
- 构建进度可在 [云开发控制台](https://tcb.cloud.tencent.com) → 云托管 → 服务详情 → 部署记录 中查看
- 环境变量需在控制台的服务配置中手动设置(或后续版本支持自动注入)

## 常用命令

```bash
# 代码质量
pnpm type-check # TypeScript 类型检查
pnpm lint # ESLint
pnpm format # Prettier 格式化

# 数据库
pnpm db:generate # 生成迁移
pnpm db:push # 推送 schema
pnpm db:studio # 打开 Drizzle Studio

# TCR 镜像仓库
pnpm setup:tcr
pnpm setup:tcr --namespace my-app --local-image node:20

# OpenCode
pnpm opencode:setup # 配置 OpenCode provider 和模型
```

---

## 项目结构

```
├── docs/
│ ├── setup.md # setup 详解与排障
│ ├── architecture.md # 系统架构文档
│ └── scf-session-sharing.md # SCF Session 共享设计
├── packages/
│ ├── web/ # React 19 + Vite 前端
│ ├── server/ # Hono 后端:Auth、Agent 编排、Sandbox 管理
│ ├── dashboard/ # CloudBase 资源管理 UI(DB / Storage / Functions)
│ └── shared/ # ACP 协议类型、任务 / 消息 schema
├── scripts/
│ ├── init.mjs # 交互式初始化脚本
│ └── setup-tcr.mjs # TCR 镜像仓库配置
└── init.sh # 快速入口
```

---

## 技术栈

| 层 | 技术 |
| ------- | ------------------------------------------------------ |
| 前端 | React 19, Vite, Tailwind CSS 4, shadcn/ui, Jotai |
| 后端 | Hono, Node.js, Drizzle ORM |
| 数据库 | CloudBase DB(主),SQLite(本地回退) |
| AI | `@tencent-ai/agent-sdk` (CodeBuddy), OpenCode ACP |
| Sandbox | CloudBase SCF, TCR 容器镜像 |
| 认证 | JWE session, bcrypt, Arctic (OAuth) |
| 持久化 | CloudBase DB, 本地 .jsonl, Git archive |
| 协议 | ACP (JSON-RPC 2.0 + SSE), MCP (Model Context Protocol) |

完整模块设计、数据流与 API 路由见 [docs/architecture.md](docs/architecture.md)。

---

## 环境变量

完整变量说明见 [docs/setup.md](docs/setup.md)。核心变量:

```env
# 加密密钥(init 脚本自动生成)
JWE_SECRET=
ENCRYPTION_KEY=

# 认证
NEXT_PUBLIC_AUTH_PROVIDERS=local # local | github | cloudbase

# CloudBase
TCB_SECRET_ID=
TCB_SECRET_KEY=
TENCENTCLOUD_ACCOUNT_ID=
TCB_ENV_ID=
TCB_PROVISION_MODE=shared # shared | isolated | task

# TCR
TCR_NAMESPACE=
TCR_PASSWORD=
TCR_IMAGE=

# 可选
MAX_MESSAGES_PER_DAY=50
MAX_SANDBOX_DURATION=300
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
GEMINI_API_KEY=
GIT_PERSONAL_AUTH=
```

---

## OpenCode 模型配置

项目内置 OpenCode ACP runtime。如果前端需要使用 OpenCode agent,需要先配置至少一个
provider(model 提供商)。

### 前置:安装 opencode CLI

```bash
npm i -g opencode-ai
# 验证
opencode --version
```

### 一键配置

```bash
pnpm opencode:setup
```

该命令会:

1. 调用腾讯云开发 AI+ 接口 [DescribeAIModels](https://cloud.tencent.com/document/product/876/131318) 拉取模型
2. 引导并配置腾讯云开发 API Key
3. 从 catalog 取完整配置写入 `.opencode/opencode.json`(含 npm/baseURL/models 等)
4. 把 API Key 写入 `packages/server/.env`

### 生成结果示例

```jsonc
// .opencode/opencode.json(自动生成,字段从 models.dev 获取)
{
 "$schema": "https://opencode.ai/config.json",
 "model": "cloudbase/deepseek-v4-flash",
 "provider": {
 "cloudbase": {
 "options": {
 "baseURL": "https://envId-xxxxxxx.api.tcloudbasegateway.com/v1/ai/cloudbase",
 "apiKey": "{env:CLOUDBASE_API_KEY}"
 },
 "models": {
 "glm-5": {
 "name": "glm-5"
 }
 }
 }
 }
}
```

```bash
# packages/server/.env 会追加 API Key
CLOUDBASE_API_KEY=eyJhbGciOiJS.xxxxxxxx
```

> **为什么写完整字段而不是空对象?** opencode 子进程启动时也需要这些配置。如果只写 `{}`,
> 子进程要自己从 models.dev 拉 catalog 才知道 npm / baseURL / models 等信息,一旦拉取失败
> (网络/超时)就无法正常工作。写入完整字段让配置自包含,不依赖运行时网络请求。

### 高级:自定义 provider / 覆盖字段

如果需要:

- 非 catalog 内置的 provider(如内网 LLM 网关、本地 Ollama)
- 覆盖 catalog 默认的 `baseURL` / `headers`(如走国内镜像)
- 用 `whitelist` / `blacklist` 限制要展示的模型
- 配置 variants(如 Anthropic 的 thinking 预算)

请参考 `.opencode/opencode.example.json` 和 [OpenCode 官方 providers 文档](https://opencode.ai/docs/zh-cn/providers/)
直接手动编辑 `.opencode/opencode.json`。

> 提示:`opencode.json` 顶部的 `$schema` 字段让 VS Code / Cursor 等编辑器支持字段自动补全
> 和悬停文档,编辑时按 Ctrl+Space 可查看所有可选字段。

### 重新配置 / 新增 provider

`pnpm opencode:setup` 幂等,可多次运行:

- **已存在的 provider** 不会被覆盖(避免丢失手动调整)
- **已设置的 env key** 不会被重复询问
- **缺失 env 的 provider** 会在启动时提示补齐

## CodeBuddy 模型配置

项目默认使用 CodeBuddy(`@tencent-ai/agent-sdk`)官方模型服务。如果需要使用 CloudBase 上的自定义 AI 模型(如 DeepSeek、混元等),可通过以下方式配置。

### 一键配置

```bash
pnpm codebuddy:setup
```

该命令会:

1. 调用腾讯云开发 AI+ 接口 [DescribeAIModels](https://cloud.tencent.com/document/product/876/131318) 拉取当前环境已开通的模型
2. 检查 `CLOUDBASE_API_KEY`,缺失时引导输入并自动写入 `packages/server/.env`
3. 同时设置 `CODEBUDDY_USE_CUSTOM_MODELS=true`
4. 生成 `packages/server/.config/.codebuddy/models.json` 供 SDK 读取

### 生成结果示例

```jsonc
// packages/server/.config/.codebuddy/models.json(自动生成)
{
 "models": [
 {
 "id": "deepseek-v4-flash",
 "name": "deepseek-v4-flash",
 "vendor": "cloudbase",
 "apiKey": "${CLOUDBASE_API_KEY}",
 "url": "https://envId-xxxxxxx.api.tcloudbasegateway.com/v1/ai/cloudbase",
 "supportsToolCall": true,
 "supportsImages": true
 }
 ],
 "availableModels": ["deepseek-v4-flash"]
}
```

```bash
# packages/server/.env 会自动追加
CLOUDBASE_API_KEY=eyJhbGciOiJS.xxxxxxxx
CODEBUDDY_USE_CUSTOM_MODELS=true
```

> **关于 `${CLOUDBASE_API_KEY}` 占位符**:`models.json` 中的 `apiKey` 字段使用 `${VAR_NAME}` 语法,
> 由 `@tencent-ai/agent-sdk` 在运行时解析为对应的环境变量值,避免将敏感密钥硬编码到配置文件中。

### 同步与自定义模型

`pnpm codebuddy:setup` 幂等,可多次运行:

- **CloudBase 模型以 API 返回为准**:如果你在 CloudBase 控制台新增或删除了模型,重新运行脚本会同步更新 `models.json`
- **已设置的 env key** 不会被重复询问

### 手动添加自定义模型

如需接入非 CloudBase 的模型(如本地 Ollama、私有 LLM 网关),可直接编辑:

```bash
packages/server/.config/.codebuddy/models.json
```

在 `models` 数组中添加自定义条目(注意 `vendor` 不要写 `cloudbase`,避免被同步覆盖):

```json
{
 "id": "my-custom-model",
 "name": "My Custom Model",
 "vendor": "custom",
 "apiKey": "${MY_API_KEY}",
 "url": "https://my-llm-gateway.example.com/v1/chat/completions",
 "supportsToolCall": true,
 "supportsImages": false
}
```

同时确保在 `packages/server/.env` 中提供对应的环境变量,并设置:

```bash
CODEBUDDY_USE_CUSTOM_MODELS=true
```

---

## 延伸阅读

- [Setup 指南](docs/setup.md) — 初始化流程、环境变量、验证清单与排障
- [系统架构](docs/architecture.md) — 系统分层、模块设计与关键数据流
- [SCF Session 共享设计](docs/scf-session-sharing.md) — 沙箱 session 复用机制

---

## Contributing

1. Fork 并创建功能分支 (`git checkout -b feature/xxx`)
2. 开发完成后确保通过:`pnpm type-check && pnpm lint && pnpm format`
3. 提交 Pull Request

**日志安全规则**:所有 `logger.*` / `console.*` 调用必须使用静态字符串,不得包含 `${动态值}`。详见 [AGENTS.md](./AGENTS.md)。

## Acknowledgments

- [coding-agent-template](https://github.com/vercel-labs/coding-agent-template) by Vercel
- [CloudBase](https://cloudbase.net/) — 云开发基础设施
- [CodeBuddy](https://copilot.tencent.com/) — AI Agent
- [Hono](https://hono.dev/) — 轻量级 Web 框架

## 交流社区

## License

Copyright 2025 Vercel, Inc. Copyright 2026 TencentCloudBase Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.