- 深度聚焦本地项目:直接阅读、分析与修改本地代码库,内置 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-CodeWindows 在仓库根目录的 PowerShell 中运行:
.\scripts\build-desktop.ps1 -Version v1.0.0-dev
.\build\desktop\TraverseBoard.exemacOS 需要 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 说明。
首次打开客户端或新建对话时,点击输入区上方的模型选择器进行配置:
- 云端 API(OpenAI / Claude / DeepSeek / Kimi 等):
- 选择对应提供商,填入你的 API Key、模型标识符及服务 Base URL(如适用)。
- 点击 保存并检查,系统将发起一次轻量调用以验证额度与连通性。
- ChatGPT 账户浏览器授权(无需 API Key):
- 在模型配置中选择 ChatGPT,点击 Continue with ChatGPT。
- 系统将唤起系统浏览器完成授权,随后可直接选择账户可用模型。
- 本地 Ollama(零门槛离线运行):
- 本地启动 Ollama 服务(默认
http://127.0.0.1:11434)。 - 在提供商列表选择 Ollama,输入模型名称(如
qwen2.5-coder:7b、deepseek-r1:8b)即可直接调用。
- 本地启动 Ollama 服务(默认
| 浅色与深色对比 | 雾透磨砂玻璃 (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)。
- 本项目基于 Apache License 2.0 协议开源。
- 第三方字体声明:中文界面包含华为技术有限公司授权的 HarmonyOS Sans Fonts,完整 字体许可文本 随软件一并分发;字体源文件与校验哈希详见 字体出处说明。


