English | Español | Deutsch | Français | 日本語 | 한국어 | Português | Polski | Русский | Bahasa Indonesia | हिन्दी

---

Terax 是一个轻量、开源、终端优先的 AI 原生开发环境（ADE），基于 Tauri 2 + Rust 和 React 19 构建。它内置原生 PTY 后端与 WebGL 渲染器、使用你自己的密钥或完全本地模型运行的智能体 AI 侧边栏，以及代码编辑器、文件浏览器、带 Git 图的源代码管理和网页预览面板。磁盘占用约 7-8 MB。无遥测。无需账户。

截图

本地开发服务器网页预览	在代码编辑器中显示编辑差异的智能体 AI 工作流
自定义主题、预设和背景图	带历史 Git 图的源代码管理面板
基于块的 WebGL 终端，配有类似编辑器的输入面板

功能

终端

• 使用 WebGL 渲染器的 xterm.js，支持多标签和后台流式输出
• GPU 加速的块式终端，提供类似编辑器的命令输入
• 通过 portable-pty 提供原生 PTY 后端（zsh、bash、pwsh、fish、cmd）
• 水平和垂直拆分面板
• 内联搜索、链接检测和真彩色
• 将文件从浏览器或桌面拖入终端，自动转换为适合 Shell 的安全引用路径
• Windows 上的逐标签工作区环境（本地或任意已安装的 WSL 发行版）
• Spaces 可跨启动恢复标签、工作目录和拆分布局

代码编辑器

• CodeMirror 6（支持所有常用语言，包括 TS/JS、Rust、Python、Go、C/C++、Java、HTML/CSS、JSON、Markdown 等）
• 支持本地模型的内联 AI 自动补全
• AI 编辑差异，可逐块接受或拒绝
• 可选语言服务器支持，提供诊断、导航、补全、格式化和自定义服务器
• 渲染 Markdown，并可查看图片、视频、音频和 PDF
• Vim 模式
• 内置编辑器主题，包括 Kanagawa、Catppuccin、Rosé Pine、Everforest、Dracula、Solarized、Nord、Tokyo Night、GitHub 和 Xcode

源代码管理

• 暂存或取消暂存代码块、提交（Cmd+Enter / Ctrl+Enter）、支持感知上游分支的推送
• 分支显示，包括分离 HEAD 状态
• 带真实提交图的 Git 历史面板（为合并和分支渲染轨道）
• 提交搜索与筛选，可点击跳转到远程提交页面

文件浏览器

• Catppuccin 图标主题
• 模糊搜索、键盘导航、内联重命名和上下文操作
• 磁盘文件变更时实时更新
• 将文件和选区直接附加到 AI 侧边栏

网页预览

• 自动检测本地开发服务器并在预览标签中打开
• 通过原生子 WebView 预览外部 URL

主题和自定义

• 在应用内创建自定义主题，可在内置预设和自己的主题之间切换
• 创建并分享自己的主题，或从社区导入
• 背景图支持调整不透明度和模糊度
• 编辑器主题独立于应用主题

AI

• 自带密钥提供商： OpenAI、Anthropic、Google（Gemini）、Groq、xAI（Grok）、Cerebras、OpenRouter、DeepSeek、Mistral，以及任意兼容 OpenAI 的端点
• 本地 / 离线： LM Studio、MLX、Ollama
• 智能体工作流： 计划、子智能体、通过 TERAX.md 实现的项目记忆、文件读取 / 写入 / 编辑 / 多处编辑 / grep / glob、需要批准的 bash、后台进程
• 编码智能体编排： 在终端中启动 Claude Code、检查其输出，并通过需要批准的工具发送后续工作
• 输入区： 通过 #handle 使用提示片段、通过 @path 添加文件、语音输入，以及从文件浏览器或选区附加到智能体
• 自定义智能体，拥有各自的系统提示和工具子集
• 计划模式，在执行前生成计划并请求确认

安装

最新安装程序位于 Releases 页面。Terax 会从该页面自动更新。

Windows 说明

• 默认 Shell 检测：pwsh.exe（PowerShell 7+）-> powershell.exe（Windows PowerShell 5.1）-> cmd.exe。
• WSL 是一等工作区环境，而不是封装的子进程。

Linux 说明

• Arch / AUR： yay -S terax-bin（也可使用 paru 等）。它会跟随最新版本。
• NixOS / Nix： 使用官方 flake。非 NixOS 运行 nix profile install github:crynta/terax-ai；NixOS 可导入 flake，并将 inputs.terax.packages.${pkgs.system}.terax 添加到 environment.systemPackages。也可以使用 nixosModules.terax 输出进行更简单的配置。
• AppImage： 需要 FUSE。没有 FUSE 时运行 ./Terax_*.AppImage --appimage-extract-and-run。如果在 Wayland 上出现渲染问题，请尝试 WEBKIT_DISABLE_DMABUF_RENDERER=1。否则，.deb / .rpm 包会链接系统 GTK 栈，通常更流畅。

配置 AI

1. 打开设置 -> AI。
2. 选择提供商并粘贴 API 密钥。对于本地推理，将 Terax 指向你的 LM Studio / MLX / Ollama 端点。
3. 密钥通过 keyring 写入操作系统钥匙串。密钥绝不会写入磁盘或 localStorage。

从源代码构建

前置要求

• Rust（stable），https://rustup.rs
• Node 22+ 和 pnpm
• 适用于你平台的 Tauri 前置要求，https://tauri.app/start/prerequisites/

运行

pnpm install
pnpm tauri dev          # 开发
pnpm tauri build        # 生产构建包

检查

pnpm lint
pnpm check-types
pnpm test
cd src-tauri && cargo clippy --all-targets --locked -- -D warnings   # Rust 检查（与 CI 一致）
cd src-tauri && cargo nextest run --locked                           # 或：cargo test --locked

技术栈

Tauri 2、Rust、portable-pty、React 19、TypeScript、Vite、xterm.js、CodeMirror 6、Vercel AI SDK v6、Tailwind v4、shadcn/ui、Zustand。

贡献

欢迎提交 Issue 和 PR！你可以提出问题、建议功能或提交拉取请求。更多信息请参阅 CONTRIBUTING.md 和架构文档。

代码签名

Windows 构建使用 SignPath.io 提供的免费代码签名证书，证书由 SignPath Foundation 颁发。

许可证

Terax 使用 Apache-2.0 许可证。有关依赖项的更多信息，请参阅 Apache License 2.0。