Terax 中文教程：7MB Tauri 工作台、BYOK 配置与源码构建
Terax 是一个轻量的 terminal-first AI-native development workspace，把终端、代码编辑器、文件树、Git、Web 预览和 AI side-panel 放在同一个 Tauri 应用里。它适合想保留本地开发环境、又需要桌面 Agent 工作区的人。
1. 下载与平台
官方 README 建议从 Releases 获取最新安装包。Windows 支持 PowerShell / WSL，Linux 提供 Arch / AUR、Nix、AppImage、deb / rpm 等路径；AppImage 在没有 FUSE 时可以使用 --appimage-extract-and-run。
2. 配置 AI
打开 Settings → AI，选择 OpenAI、Anthropic、Gemini、Groq、xAI、OpenRouter、DeepSeek、Mistral 或其他 OpenAI 兼容 endpoint，填写自己的 key。也可以连接 LM Studio、MLX 或 Ollama。README 说明 key 通过 keyring 写入系统 keychain，不放进 localStorage；仍应按本机权限策略管理。
3. 从源码构建
git clone https://github.com/crynta/terax-ai.git cd terax-ai pnpm install pnpm tauri dev
官方前置条件是 Rust stable、Node 20+、pnpm 和目标平台的 Tauri 依赖。构建检查包括：
pnpm lint pnpm check-types pnpm test cd src-tauri && cargo clippy --all-targets --locked -- -D warnings
4. 和普通终端或 IDE 的区别
普通终端更轻、脚本化更直接；完整 IDE 的语言服务和插件生态更成熟。Terax 的价值在于把 PTY、编辑器、文件、Git、Web 预览和 Agent 面板放在一个本地工作区，代价是要接受 Tauri 原生依赖和更大的应用面。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
想保留本地终端和文件工作流，同时需要桌面 Agent 面板和 BYOK 的开发者。
原教程未展开的系统信息
核心功能
BYOK provider 与 OpenAI-compatible endpoint
Settings → AI 支持自带 key 的多个 provider，也可填写 OpenAI-compatible endpoint。
架构与数据流
Tauri 桌面壳承载 React 工作区和 Rust 原生能力，PTY、编辑器、文件、Git、Web 预览与 AI side-panel 在一个应用内协作。
常见问题
Terax 是什么？
Terax 是 Tauri 2 + Rust + React 19 的 terminal-first AI-native development workspace，包含终端、编辑器、文件树、Git、Web 预览和 AI 面板。
能用本地模型吗？
README 列出 LM Studio、MLX 和 Ollama，本地 endpoint 的具体兼容程度取决于模型服务。
源码构建需要什么？
Rust stable、Node 20+、pnpm 和目标平台的 Tauri 依赖；官方命令是 pnpm install 和 pnpm tauri dev。
API key 会保存在哪里？
README 说明通过 keyring 写入系统 keychain，不保存到 localStorage。仍需按系统权限保护 keychain。
Terax 适合替代完整 IDE 吗？
它更像把终端、编辑器和 Agent 工作区合并在一起；是否替代 IDE 取决于你对语言服务、插件和调试器的需求。