基于 OpenCode 的开源智能体平台：code-agent 让 AI 帮你在 UBML 低代码场景做页面开发

GitHub: https://gitee.com/ubml/code-agent
协议: Apache-2.0（extension/knowledge/ubml-codegen）+ MIT（OpenCode 引擎）
版本: v2.0.0-beta.1
运行时: Bun ≥ 1.3.14

一、项目定位

code-agent 是基于 OpenCode 智能体引擎构建的开源 AI 开发平台，专门为 UBML（Unified Business Modeling Language）低代码 场景做了领域扩展。

核心能力：在 Web UI 里和 Agent 对话，让它在你的本地工作区里帮忙写代码、改配置、生成低代码页面。

二、核心能力

1. Agent 对话

基于 OpenCode，支持多 LLM Provider
Web 端流式交互
在本地工作区直接操作代码

2. UBML 知识包

低代码模型范例，给 Agent 和编译器共用：

让模型理解低代码组件该怎么用、有哪些约束
YAML DSL 描述页面 → 一键编译模型 → 校验通过后预览 → 必要时反编译回来

3. 可扩展 UI

Extension 通过 module override 定制界面，不必 fork 上游。开发写在 packages/extension/ 里，和 upstream 引擎代码分开。

4. 规约驱动开发

较大变更使用 OpenSpec：proposal → design → tasks 工作流。

三、快速开始

环境要求

Bun ≥ 1.3.14

安装运行

git clone https://gitee.com/ubml/code-agent.git
cd code-agent
bun install
bun run dev:with-preview   # 后端 :4096，前端 :3000，页面预览 :3100

Windows 一键启动：

bun run dev:windows
# 或双击 script\start-dev.bat

启动后

浏览器访问 http://localhost:3000
选一个本地工作目录
在 Settings → Providers 里配置 LLM（凭据存在本地，不会进 git）
新建 Session，发一条消息看看 Agent 是否正常回复

四、目录结构

code-agent/
├── packages/
│   ├── extension/            ★ 产品定制主入口
│   │   ├── src/              UI、Workbench、UBML API
│   │   ├── assets/ubml/      Schema、prompt、范例
│   │   └── preview/          Vue 低代码预览
│   ├── ubml-codegen/         DSL 编译、校验、反编译
│   ├── knowledge/            知识服务与 MCP
│   ├── ide-host/             IDE Host 集成
│   ├── desktop/              Electron 桌面壳
│   │
│   ├── opencode/             ┐
│   ├── core/                 │ OpenCode 引擎与 Web UI（MIT）
│   ├── app/                  │ 日常开发改 extension，不要修改这里
│   ├── ui/                   │
│   ├── sdk/js/               │
│   └── plugin/               ┘
│
├── script/                   开发脚本
├── docs/                     文档
├── openspec/                 OpenSpec 变更记录
├── assets/                   静态资源
└── vendor/                   版本基线与 import 清单

五、常用命令

命令	做什么
`bun run dev:with-preview`	推荐 — 主环境 + UBML 页面预览（:3000 / :4096 / :3100）
`bun run dev:stop`	停止上述开发服务
`bun run dev`	仅主环境，不含页面预览
`bun run dev:backend`	只跑 OpenCode API（:4096）
`bun run dev:web`	只跑 extension 前端（:3000）
`bun run dev:preview`	只跑 UBML 页面预览（:3100）
`bun run dev:desktop`	Electron 桌面壳
`bun run dev:ide-host`	IDE Host（OpenVSCode Server）
`bun run dev:windows`	Windows 一键启动
`bun run typecheck`	全仓库类型检查
`bun run smoke`	API 冒烟（需已配置 Provider）

UBML 相关命令

bun run ubml:build-pack                    # 构建 / 同步知识包
bun run ubml:compile -- path/to/page.yaml  # 编译页面
bun run ubml:verify -- path/to/page.yaml   # 校验页面
bun run ubml:decompile -- path/to/page.json  # 反编译
bun run ubml:install-agent                 # 安装 Agent

六、许可与贡献

代码范围	许可	怎么贡献
`extension/`、`knowledge/`、`ubml-codegen/`、`script/`、`docs/`、`openspec/`	Apache-2.0	直接提 PR
`opencode/`、`app/`、`ui/`	MIT	见 `docs/VENDOR-SYNC.md`