Terax：轻量级、以终端为优先的 AI 原生开发工作区
Terax 是一个基于 Tauri 2 + Rust 和 React 19 构建的轻量级开源终端（ADE）。它拥有原生 PTY 后端和 WebGL 渲染器，还有一个智能 AI 侧边栏，可使用你自己的密钥或完全本地的模型运行。此外，它还内置了代码编辑器、文件资源管理器、带 Git 图的源代码控制以及网页预览面板。磁盘占用约 7 - 8 MB，无数据追踪，无需账号。
截图展示
支持 WebGL 渲染的多标签终端；自定义主题、预设和背景图片；本地开发服务器的网页预览；带 Git 历史图的源代码控制面板；代码编辑器中带有编辑差异的智能 AI 工作流。
功能特性
终端
采用 WebGL 渲染器的 xterm.js，支持多标签和后台流式传输；GPU 加速的基于块的终端，具备类似编辑器的命令输入功能；通过 portable-pty 实现原生 PTY 后端（支持 zsh、bash、pwsh、fish、cmd）；支持水平和垂直分割面板；内联搜索、链接检测、真彩色显示；在 Windows 上支持每个标签的工作区环境（本地或任何已安装的 WSL 发行版）。
代码编辑器
CodeMirror 6（支持所有流行语言，如 TS/JS、Rust、Python、Go、C/C++、Java、HTML/CSS、JSON、Markdown 等）；支持本地模型的内联 AI 自动补全；AI 编辑差异，可逐块接受或拒绝修改；Vim 模式；十种内置编辑器主题：Atom One、Aura、Copilot、GitHub Dark / Light、Gruvbox Dark、Nord、Tokyo Night、Xcode Dark / Light。
源代码控制
暂存/取消暂存代码块，提交（Cmd+Enter / Ctrl+Enter），推送时感知上游分支；显示分支信息，包括分离头状态；带有真实提交图的 Git 历史面板（合并和分支的车道渲染）；提交搜索和过滤，可点击跳转到远程提交页面。
文件资源管理器
Catppuccin 图标主题；模糊搜索、键盘导航、内联重命名、上下文操作；可直接将文件和选择内容附加到 AI 侧边栏。
网页预览
自动检测本地开发服务器并在预览标签中打开；通过原生子网页视图进行外部 URL 预览。
主题与定制
应用内内置自定义主题，可在预设和自定义主题间切换；可创建自己的主题，分享或从社区导入；支持背景图片，可调节透明度和模糊度；编辑器主题与应用主题相互独立。
AI 支持
支持的 BYOK 提供商：OpenAI、Anthropic、Google（Gemini）、Groq、xAI（Grok）、Cerebras、OpenRouter、DeepSeek、Mistral 以及任何 OpenAI 兼容的端点；本地/离线支持：LM Studio、MLX、Ollama；智能工作流：计划、子代理、通过 TERAX.md 实现项目记忆、文件读写/编辑/多编辑/搜索/通配符匹配、带审批的 bash 命令、后台进程；编辑器：通过 #handle 插入代码片段，通过 @path 引用文件，支持斜杠命令、语音输入，可从资源管理器或选择内容中附加到代理；自定义代理，可设置自己的系统提示和工具子集；多步骤工作的计划模式，执行前生成并确认。
安装
最新安装程序可在发布页面获取，Terax 会自动从该页面更新。
Windows 注意事项
首次启动时，Windows 会显示“Windows 已保护你的电脑”，因为 Terax 尚未进行代码签名。点击“更多信息”，然后选择“仍要运行”。默认 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 — `nix profile install github:crynta/terax-ai`（非 NixOS），或导入 flake 并将 `inputs.terax.packages.${pkgs.system}.terax` 添加到 `environment.systemPackages`（NixOS）。`nixosModules.terax` 输出也可用于更简单的设置；AppImage：需要 FUSE。若没有，可使用 `./Terax_*.AppImage --appimage-extract-and-run`。在 Wayland 上出现渲染故障时，可尝试设置 `WEBKIT_DISABLE_DMABUF_RENDERER=1`。否则，.deb / .rpm 包会链接系统 GTK 栈，运行通常更流畅。
AI 配置
打开“设置” -> “AI”，选择提供商并粘贴 API 密钥。对于本地推理，将 Terax 指向你的 LM Studio / MLX / Ollama 端点。密钥通过 keyring 写入操作系统密钥链，不会触及磁盘或本地存储。
从源代码构建
先决条件
Rust（稳定版）；Node 20+ 和 pnpm；针对你所在平台的 Tauri 先决条件。
运行命令
`pnpm install`；`pnpm tauri dev`（开发模式）；`pnpm tauri build`（生产打包）。
检查命令
`pnpm exec tsc --noEmit`（前端类型检查）；`cd src-tauri && cargo clippy --all-targets --locked -D warnings`（Rust 代码检查（与 CI 一致））；`cd src-tauri && cargo test --locked`（Rust 测试）。
技术栈
Tauri 2、Rust、portable-pty、React 19、TypeScript、Vite、xterm.js、CodeMirror 6、Vercel AI SDK v6、Tailwind v4、shadcn/ui、Zustand。
贡献
欢迎提出问题和提交拉取请求！你可以自由地提出问题、建议功能或提交 PR。更多详情请参考 CONTRIBUTING.md。
许可证
Terax 采用 Apache 2.0 许可证。有关依赖项的更多信息，请参阅 Apache License 2.0。
