H4D3ZS/vscodium-rust
GitHub: H4D3ZS/vscodium-rust
一款基于 Rust 重写的本地优先智能体 IDE,集成自主 AI 编码、语义搜索、ML 训练与安全研究工具,保障数据完全留在本地。
Stars: 201 | Forks: 37
# VSCodium-Rust
一款使用 Rust/Tauri v2 + React 19/TypeScript/Vite 构建的本地优先智能体 IDE。

## 这是什么
VSCodium-Rust 是一个为想要以下功能的开发者设计的全功能开发环境:
- **本地 AI 智能体** — 配合 Ollama 实现自主编码,无需云端
- **数据主权** — 你的代码永远不会离开你的机器
- **安全研究** — 集成的进攻性工具和浏览器自动化
- **机器学习实验** — IDE 内的 PyTorch 训练和模型管理
基于 VS Code 架构构建,并使用 Rust 重写以提升性能。
## 功能
### AI Agent
| 功能 | 描述 |
|---------|-------------|
| Autonomous agent loop | 具有完成前验证的多轮工具执行 |
| Fable-5 thinking protocol | 模型在每次操作前进行推理 |
| FastContext explorer | 专用的 4B 仓库探索子智能体 |
| Shadow workspace | 提交前的安全代码变更 |
| Background agents | 长时间运行的并行任务 |
| Tool permissions | 批准/拒绝破坏性操作 |
| MCP integration | 用于外部工具的客户端 + 服务器 |
| Cursor rules | `.cursor/rules/*.mdc` 项目配置 |
### 编辑器
| 功能 | 描述 |
|---------|-------------|
| Monaco editor | 支持扩展的完整 VS Code 编辑器 |
| Tab autocomplete | 基于 FIM 的代码补全 |
| Inline diff | 智能体编辑预览及接受/拒绝 |
| Quick edit | 选区范围内的内联修改 |
| Git 集成 | 状态、diff、commit、分支 |
### 代码智能
| 功能 | 描述 |
|---------|-------------|
| 语义搜索 | 通过 Ollama 进行向量嵌入 |
| Codebase index | 具有余弦相似度的符号 + chunk 索引 |
| LSP 支持 | Language Server Protocol 诊断 |
| Knowledge briefs | 提炼的项目上下文 |
### 安全研究
| 功能 | 描述 |
|---------|-------------|
| APEX orchestrator | 7 模型专家路由 |
| 浏览器自动化 | 带有 DOM 交互的无头 Firefox |
| 渗透测试工具 | SQLi、XSS、SSRF、reverse shells |
| 密钥扫描 | 基于熵的凭证检测 |
### ML Studio
| 功能 | 描述 |
|---------|-------------|
| PyTorch 训练 | 数据集、训练、loss 曲线、导出 |
| 模型中心 | torchvision、timm、HuggingFace 画廊 |
| Optuna HPO | 超参数优化 |
| ONNX 导出 | 模型转换与部署 |
## 快速开始
### 前置条件
- Node.js 18+
- Rust 工具链 (rustup)
- Ollama (用于本地 AI)
### 安装
```
git clone https://github.com/your-org/vscodium-rust.git
cd vscodium-rust
npm install
```
### 运行
```
# 前端开发服务器
npm run dev
# 完整 IDE (Tauri app)
npm run dev:tauri
# Rust 后端检查
cd src-tauri && cargo check
```
### 构建
```
# 生产构建
npx tauri build
```
## AI Agent 设置
### 拉取模型
```
# 最佳本地 agent 模型 (Gemma4 12B, Fable-5 trained)
ollama pull hf.co/yuxinlu1/gemma-4-12B-coder-fable5-composer2.5-v1-GGUF:Q4_K_M
# 快速编码模型
ollama pull qwen2.5-coder:14b
# 探索子 agent
ollama pull hf.co/mitkox/FastContext-1.0-4B-SFT-Q4_K_M-GGUF:Q4_K_M
```
### 启动 Ollama
```
ollama serve
```
打开 IDE,在智能体工具栏中选择你的模型,然后开始编码。
## 架构
```
vscodium-rust/
src/ # React 19 + TypeScript frontend
components/ # UI components
store/ # Zustand state management
domain/ # Business logic
application/ # Application services
infrastructure/ # Tauri bridge adapters
src-tauri/ # Rust backend (Tauri v2)
src/domain/ai/ # AI engine + autonomous loop
src/domain/tools/ # Tool registry + dispatch
src/domain/vcs/ # Git, patches, shadow workspace
src/domain/security/ # APEX orchestrator, pentest tools
kortex/ # Supporting Rust workspace
aim-proxy/ # Ollama MITM proxy
libaim/ # .aim binary format
```
### 关键设计决策
- **Patch 纪律**:通过 `patch_engine.rs` 进行精准的 SEARCH/REPLACE,拒绝全文件重写
- **内存预算**:核心内存占用低于 150MB
- **Tauri IPC**:所有前后端调用均通过 `#[tauri::command]` 处理程序进行
- **工具注册表**:基于 JSON Schema 的工具,兼容 OpenAI/Anthropic function calling
## 测试
```
# 前端测试
npm test
# 类型检查
npm run typecheck
# Rust 测试
cd src-tauri && cargo test
```
## 项目结构
| 目录 | 用途 |
|-----------|---------|
| `src/` | React 前端 (Vite + TypeScript) |
| `src-tauri/` | Rust 后端 (Tauri v2) |
| `kortex/` | 辅助 crates (代理、VFS、daemon) |
| `airi/` | 3D VRM 虚拟形象 (可选) |
| `claurst/` | 外部 agent SDK |
## 许可证
MIT 许可证。详情请参阅 [LICENSE](LICENSE)。
## 致谢
基于以下项目的工作构建:
- [VSCodium](https://vscodium.com/) — 没有 Microsoft 遥测的 VS Code
- [Tauri](https://tauri.app/) — 用于桌面应用的 Rust 后端
- [Ollama](https://ollama.com/) — 本地 LLM 运行时
- [Monaco Editor](https://microsoft.github.io/monaco-editor/) — 代码编辑器组件
标签:AI风险缓解, 凭据扫描, 可视化界面, 通知系统