Skip to content

About

Open-source AI coding workbench for local projects. Seamlessly connects cloud & local LLMs with terminal execution, live diff review, and MCP support

Topics

Resources

Contributing

Security policy

Stars

196 stars

Watchers

3 watching

Forks

Repository files navigation

Universal-Code Logo

Universal-Code

面向本地项目的开源 AI 编程工作台

连接云端与本地大模型,在同一工作流中读写代码、运行终端命令、查阅资料并实时审阅 Diff 改动。

简体中文 | English

CI Release License Platform Go Node React PRs Welcome

Stars Forks Issues


核心特性

  • 深度聚焦本地项目:直接阅读、分析与修改本地代码库,内置 Diff 逐行审阅与可信撤销(Rewind / Checkpoints)能力。
  • 透明可控的安全策略:采用 Ask / Auto / Full 分级授权;操作按当前权限、实际影响和安全策略自动执行、请求审批或拒绝,Full 须在当前进程显式激活。
  • 主流模型即开即用:原生接入 OpenAI、Anthropic Claude、DeepSeek、Kimi、Ollama 本地模型与任何兼容 OpenAI 的第三方 API,支持单会话内即时热切,并支持通过系统浏览器快速完成 ChatGPT 账户授权登录。
  • 真实来源的网络检索:优先调用供应商原生搜索,支持直接抓取 GitHub PR/Issue、Hacker News 与 RSS/Atom 资讯,自动附带快照存证与引用出处。
  • 可切换的界面主题:提供深色、浅色与雾透主题,使用 CSS 模糊、半透明背景、渐变和边缘阴影呈现玻璃质感。

快速开始

方式一:下载预编译客户端

平台 下载与运行说明
Windows 10/11 当前 Actions 测试包及启动步骤见 Windows 下载说明。实际文件名为 TraverseBoard.exe,双击运行,需 Edge WebView2 Runtime。最新公开 Release 仍是 2026-09-05 的旧预览。
macOS (Apple Silicon / Intel) 从 macOS 下载说明 获取对应架构的 Actions 预览 ZIP,解包后打开 TraverseBoard.app。当前仅有 ad-hoc 签名,未公证;公开 Release 尚无 Mac 包。

持续更新的候选入口为 Desktop release 打包记录。Actions 下载需要登录 GitHub,且有保留期限;对应版本、源码提交和到期时间见平台说明。 测试包沿用历史文件名,窗口中的产品名为 Universal-Code。

方式二:从源码构建运行

安装 Go(版本遵循 go.mod,当前为 1.26.10) 与 Node.js 24(CI 使用 24.22.1),然后克隆仓库:

git clone https://github.com/CWNU-Open-Source-Community/Universal-Code.git
cd Universal-Code

Windows 在仓库根目录的 PowerShell 中运行:

.\scripts\build-desktop.ps1 -Version v1.0.0-dev
.\build\desktop\TraverseBoard.exe

macOS 需要 Xcode Command Line Tools。在仓库根目录运行:

CGO_ENABLED=1 bash scripts/build-desktop-darwin.sh -Version v1.0.0-dev
open build/desktop/TraverseBoard.app

脚本会安装前端锁定依赖、检查并构建内嵌界面,再使用各平台需要的 Go 标签和链接参数生成桌面应用。 应用包含后端服务,无需另外启动后端。完整要求见 Windows / macOS 说明。


模型配置与连接

首次打开客户端或新建对话时,点击输入区上方的模型选择器进行配置:

  1. 云端 API(OpenAI / Claude / DeepSeek / Kimi 等):
    • 选择对应提供商,填入你的 API Key、模型标识符及服务 Base URL(如适用)。
    • 点击 保存并检查,系统将发起一次轻量调用以验证额度与连通性。
  2. ChatGPT 账户浏览器授权(无需 API Key):
    • 在模型配置中选择 ChatGPT,点击 Continue with ChatGPT。
    • 系统将唤起系统浏览器完成授权,随后可直接选择账户可用模型。
  3. 本地 Ollama(零门槛离线运行):
    • 本地启动 Ollama 服务(默认 http://127.0.0.1:11434)。
    • 在提供商列表选择 Ollama,输入模型名称(如 qwen2.5-coder:7b、deepseek-r1:8b)即可直接调用。

界面预览

浅色与深色对比 雾透磨砂玻璃 (Mist)
浅色与深色界面对比 雾透外观

可在客户端 设置 → 外观 中自由切换 系统跟随、浅色、深色、雾透玻璃。


详细文档导航

领域 文档链接 描述
使用指南 用户手册 (Usage Guide) 完整客户端使用、CLI 命令与常见工作流
聊天资源 链接、文件与剪贴板 外链预览、资源右键菜单、文件与图片复制粘贴
搜索与取证 网络检索与快照 (Web Evidence) 检索配置、快照存储、URL 溯源与失败诊断
改动审计 工作区检查点 (Checkpoints) 逐行 Diff 审阅、快照保存与安全恢复 (Rewind)
生态扩展 扩展与 MCP 协议 (Extensions) 接入 Model Context Protocol (MCP) 与外部 Skill
代码智能 LSP 语言服务器 (Code Intelligence) 符号跳转、类型推断与代码索引支持
系统架构 架构设计方案 (Architecture) Go 控制面、执行状态机与安全策略实现
发布日志 版本发布说明 (Release Notes) v1.0.0 验证范围、兼容性与更新记录

参与贡献

欢迎提交 Issue 与 Pull Request!在开始开发前,请先阅读我们的 贡献指南 (CONTRIBUTING.md)。

开源许可证与字体合规

About

Open-source AI coding workbench for local projects. Seamlessly connects cloud & local LLMs with terminal execution, live diff review, and MCP support

Topics

Resources

Contributing

Security policy

Stars

196 stars

Watchers

3 watching

Forks

Releases

Contributors

Languages