crynta/terax-ai —— 轻量级(7MB)终端优先的AI原生开发工作空间

这是什么

Terax 是一个轻量级开源高级桌面终端（ADE，Advanced Desktop Environment），底层基于 Tauri 2 + Rust 与 React 19，前端使用 xterm.js + WebGL 渲染器 和 CodeMirror 6 作为代码编辑器。它集成了原生 PTY 后端（通过 portable-pty 支持 zsh、bash、pwsh、fish、cmd），并内置一个 Agentic AI 侧面板，可对接用户自己的 API Key（BYOK）或完全本地的推理端点（如 LM Studio、Ollama、MLX）。整个应用打包后磁盘占用约 7–8 MB，无遥测、无账号、无强制注册。

除了终端模拟，Terax 还嵌入了文件浏览器、源码管理（含 Git 提交图）、Web 预览窗、多标签页、分屏、Vim 模式、自定义主题等功能，几乎覆盖开发者日常的 “终端 + 编辑器 + Git + AI 辅助” 需求，且全部可离线使用。

解决的问题

传统终端模拟器（如 iTerm2、Windows Terminal、Alacritty）强于执行 Shell 命令，但缺少代码编辑、AI 辅助、项目管理等能力；而 IDE（如 VS Code、JetBrains）虽然功能全面，但资源占用大、启动慢，且对纯终端工作流支持不够自然。Terax 试图在这两个极端之间找到一个平衡点：

• 终端与编辑器一体化：不再需要在终端和编辑器之间反复切换。CodeMirror 6 内嵌在终端标签页中，支持所有主流编程语言，且与 AI 补全、Git 操作无缝联动。
• AI 辅助既灵活又私密：用户可以选择任意主流云 AI 提供商（OpenAI、Anthropic、Google Gemini、Groq、xAI Grok、DeepSeek、Mistral 等）或完全本地模型，API Key 仅写入操作系统密钥链（keyring），不落盘、不接触 localStorage。AI 侧面板可直接引用终端输出、文件资源、代码选择，并执行文件读写、grep、bash 命令等 agentic 操作。
• 轻量、便携、跨平台：7–8 MB 的单体安装包，无需运行时依赖（Tauri 2 打包自带 WebView 核心），支持 Windows、macOS、Linux（AppImage / deb / rpm / AUR / Nix），自动更新。
• 原生 Git 图形化：内置支持暂存/取消暂存、提交、推送、分支切换（包括 detached HEAD）、查看完整提交图（车道渲染），省去额外开启 GitGUI 或 IDE 的麻烦。

核心功能

终端层

• 基于 xterm.js + WebGL 渲染器，多标签页且支持后台流式输出。
• GPU 加速的块式终端（block-based），命令输入区具备类编辑器样式（支持光标移动、选择等）。
• 原生 PTY 后端：自动检测系统默认 Shell（Windows 下优先 pwsh → powershell → cmd），对 WSL 是作为一等公民工作区环境而非子进程。
• 分屏（水平/垂直）、内联搜索、链接检测、真彩色支持。

代码编辑

• 基于 CodeMirror 6，支持 TypeScript/JavaScript、Rust、Python、Go、C/C++、Java、HTML/CSS、JSON、Markdown 等所有流行语言。
• 内联 AI 自动补全（支持本地模型）、AI 编辑差异（逐块接受/拒绝）。
• Vim 模式。
• 10 个内置编辑器主题（Atom One、Aura、Copilot、GitHub Dark/Light、Gruvbox Dark、Nord、Tokyo Night、Xcode Dark/Light），编辑器主题与应用主题相互独立。
• 自定义主题（内置创建器，可分享或导入社区主题），背景图片支持透明度与模糊调节。

源码管理

• 暂存/取消暂存代码块、提交（Cmd+Enter / Ctrl+Enter）、推送时检测上游。
• 分支显示（包括 detached HEAD 状态）。
• Git 历史面板，完整提交图（车道渲染合并与分支），提交搜索与过滤，点击可直接跳转到远程提交页面。

文件系统与项目管理

• 文件浏览器（Catppuccin 图标主题），支持模糊搜索、键盘导航、内联重命名、右键上下文操作。
• 可直接将文件和选择附加到 AI 侧面板。
• 自动检测本地开发服务器，在预览标签页打开；外部 URL 通过原生子 Webview 预览。

AI Agentic 工作流

• 提供商：OpenAI、Anthropic、Google Gemini、Groq、xAI Grok、Cerebras、OpenRouter、DeepSeek、Mistral，以及任何兼容 OpenAI 的端点。本地：LM Studio、MLX、Ollama。
• Agentic 能力：生成计划、子代理、通过 TERAX.md 实现项目记忆、文件读写/编辑/多编辑/grep/glob、bash 命令（需批准）、后台进程。
• Composer：通过 #handle 引用片段，@path 引用文件，斜杠命令，语音输入。
• 自定义 Agent：可设置自己的 system prompt 和工具子集。
• Plan 模式：多步操作在生成计划后与用户确认再执行。

开发与安装

• 开发依赖：Rust (stable)、Node 20+、pnpm、Tauri 平台依赖。
• 构建命令：pnpm install && pnpm tauri dev（开发）、pnpm tauri build（打包）。
• 代码检查：前端 tsc --noEmit，后端 cargo clippy --all-targets --locked -D warnings、cargo test --locked。
• Linux 发行：AppImage（需 FUSE，或 --appimage-extract-and-run，Wayland 下可能需 WEBKIT_DISABLE_DMABUF_RENDERER=1）、deb / rpm（依赖系统 GTK，更流畅）、Arch AUR (yay -S terax-bin)、Nix (nix profile install github:crynta/terax-ai)。
• Windows 首次启动会弹出“Windows 已保护你的电脑”提醒（因尚未代码签名），点击“更多信息”后“仍要运行”即可。
• 自动更新：从 GitHub Releases 自动获取更新。

亮点 / 与同类相比

| 对比维度 | Terax | 传统终端（iTerm2 / Windows Terminal） | VS Code + 终端插件 | Warp (终端) | |---------|-------|---------------------------------------|-------------------|------------| | 体积 | 7–8 MB | 几十到几百 MB | ~200 MB + 额外插件 | ~200 MB | | 离线能力 | 完全离线（AI 可本地跑） | 不支持 AI | 需扩展 + 在线 | 必须登录账号 | | AI 提供商 | BYOK（20+ 云+本地） | 无 | 依赖扩展（如 Copilot 需付费） | 绑死自有后端 | | Agentic 能力 | 计划、子代理、文件/命令控制 | 无 | 需自行构建 | 有限（只做补全） | | Git 可视化 | 原生提交图、分块操作 | 无 | 扩展 | 无 | | 代码编辑 | CodeMirror 6 + VIM + 多主题 | 无 | 完整编辑器 | 无 | | telemetry | 无 | 部分有 | 有（可关） | 有 | | 一键内嵌 Web 预览 | 自动检测 dev server + 外部 URL | 无 | 需插件 | 无 |

核心差异点：

• All-in-one 但轻量：Terax 把终端、代码编辑器、Git 图形化、AI 辅助、文件浏览器、Web 预览全部打包，却只有 7–8 MB。相比 VS Code，它更像一个“增强版终端”而非“简化版 IDE”，启动速度快、资源占用低。
• AI 隐私与灵活性：不是锁在一个生态里，用户可自由选择任何云模型或本地模型，API Key 存储