AI原生桌面IDE

guIDE——人工智能原生桌面IDE

Your code. Your models. Your machine. No cloud required.

A source-available, local-first IDE with built-in LLM inference, 52 autonomous MCP tools, browser automation, RAG-powered code intelligence, and 9 cloud AI providers — all in a single Electron desktop app.

为什么guIDE存在

VS Code是一个令人难以置信的编辑器，但它是在人工智能时代之前设计的。每个附加到VS Code上的AI扩展都需要云订阅，将代码发送到外部服务器，并让您对模型、提示和工具进行有限的控制。

guIDE是从头开始构建的AI原生IDE：

为什么地方优先

• 隐私： 你的代码永远不会离开你的机器。没有关于专有代码的培训。
• 速度： GPU加速的本地推理。无网络延迟。
• 离线： 在没有互联网的情况下工作。非常适合机密环境、飞机或不可靠的连接。
• 成本： 没有订阅。下载一次模型，永远使用它。
• 控制： 您可以选择模型、上下文窗口和GPU层。微调系统提示。

功能概览

核心IDE

• 摩纳哥编辑 --与VS Code相同的编辑器引擎：语法高亮显示、智能感知、多光标、小地图、括号匹配、代码折叠
• 集成终端 --全PTY终端（node-PTY+xterm.js），带有多个选项卡，AI支持的智能感知建议
• 文件资源管理器 --树视图和网格视图、多选、拖放（Windows资源管理器中的内部+）、复制/粘贴（Ctrl+C/X/V）、上下文菜单
• 命令面板 — Ctrl+Shift+P 用于快速访问所有命令
• 拆分编辑器 — Ctrl+\ 用于并排文件编辑
• 在线聊天 — Ctrl+I 用于直接在编辑器中进行AI驱动的内联代码编辑
• 下一步编辑建议 --接受重影文本完成的选项卡（AI预测您的下一次编辑）
• Markdown、HTML和SVG预览 --文档、网页和矢量图形的实时预览切换
• JSON预览 --JSON文件的可折叠树视图，语法突出显示
• CSV/TSV表格预览 --数据文件的可排序表视图
• YAML/TOML/XML预览 --语法高亮显示的格式化预览
• 代码运行器 --F5支持50多种语言和文件类型（Python、JavaScript、TypeScript、C/C++、Rust、Go、Java、Ruby、PHP、Haskell、Clojure、Nim、Zig、Fortran等等）
• 跨文件搜索 --使用可选的人工智能语义搜索在整个项目中搜索和替换
• 8主题 --黑暗默认，Monokai，Dracula，Nord，日晒黑暗，GitHub黑暗，光明，Catppuccin摩卡
• 364文件图标 --通过文件图标矢量为每种文件类型提供生动的SVG图标
• 自定义标题栏 --带有集成菜单的本土风格无框窗户
• 支架内容选择 — Ctrl+Shift+[ 在匹配的括号中选择内容
• Git责备装饰 --每行都有内联作者和日期注释
• 粘贴自动导入 --粘贴React/common代码时自动添加缺失的导入
• 自定义指令 — .prompt.md 用于项目特定AI上下文注入的文件
• 将文件拖动到聊天室 --将代码文件直接放入AI聊天中以获取上下文
• 聊天中的美人鱼图 --AI响应中Mermaid.js图的实时SVG渲染
• 上下文窗口指示器 --可视化进度条显示聊天输入中的令牌使用情况

AI助手

• 本地LLM推理 --通过节点Llama cpp加载任何GGUF模型（Qwen、Llama、Mistral、DeepSeek等）
• CUDA和Vulkan GPU加速 --自动检测GPU并卸载模型层
• 自适应上下文窗口 --根据可用系统RAM（最多32K令牌）自动最大化上下文
• 闪存注意力 --更大上下文窗口的内存高效注意力
• 流媒体响应 --具有思维模型支持的实时逐个令牌输出
• 智能上下文预算 --基于优先级的提示汇编（内存→ 工具→ 错误→ RAG → code → 网络搜索）
• 代理模式 --多步自主编码，最多可迭代100次
• 计划模式 --在聊天中在直接执行和计划优先推理之间切换
• 多代理/后台代理 — /agent 生成自主后台任务的命令
• 思维模型 --具有思维链的模型的可折叠推理显示（DeepSeek，Qwen R1）
• MCP服务器管理UI --用于配置、启用/禁用和监视MCP服务器的可视化面板

调试框架

• Node.js调试 --Chrome DevTools协议（CDP）集成，用于断点、步进、变量检查
• Python调试 --debugpy DAP（调试适配器协议）支持
• 调试面板 --带有断点列表、变量、调用堆栈、步进控件的完整UI(Ctrl+Shift+D)

云LLM支持（9家提供商）

所有供应商都来了 使用API密钥预先配置 --立即开始聊天：

自动倒链： 如果一个提供商达到了速率限制，guIDE会自动尝试下一个。

52 MCP工具（自主代理操作）

启用代理模式后，AI可以自主使用以下任何工具：

RAG系统（检索增强生成）

• BM25代码库索引 --为整个项目建立索引，以便进行相关代码检索
• 上下文感知响应 --AI知道你的代码库，而无需将其发送到任何地方
• 自动索引 --打开项目文件夹时重新索引

浏览器选项卡

• 集成浏览器 --在编辑器视口中以选项卡形式浏览网页
• AI控制 --15个浏览器工具让AI导航、点击、键入和阅读页面
• 车展 --当AI使用浏览器工具时，浏览器选项卡会自动打开
• URL栏 --带有后退/前进/重新加载控制的手动导航
• 智能元素列表 --每次页面交互后，guIDE都会自动列出交互元素，以便AI知道下一步要点击什么

Git集成

• 源代码控制面板 --查看已更改的文件、暂存/取消暂存、提交
• 分行管理 --查看、创建、查看前方/后方指标
• 内联差异 --查看分阶段和非分阶段更改的文件差异

演讲

• 语音输入 --Groq Whisper支持语音转文本功能，实现免提提示
• 文本转语音 --使用系统语音合成大声朗读AI响应

系统监控

• CPU和RAM仪表 --状态栏中的实时系统资源使用情况
• LLM性能 --令牌/秒和上下文使用指标

图像和媒体输入

• 拖放 --将图片直接放入聊天室
• 剪贴板粘贴 --使用Ctrl+V粘贴屏幕截图
• 文件附加 --单击回形针按钮以附加图像
• 视觉模型 --自动检测具有视觉功能的模型进行图像分析

快速开始

先决条件

• Node.js 18+ 和 npm 9+
• Visual C++构建工具 （适用于Windows上的本机模块）
• NVIDIA GPU+CUDA驱动程序 （可选，用于GPU加速）

安装并运行

git clone https://github.com/FileShot/guIDE.git
cd guIDE
npm install
npm run dev

或者在Windows上，双击 START_NOW.bat.

GGUF型号

地方 .gguf 模型文件位于以下任一位置：

• 项目根目录
• A. models/ 子目录

IDE会自动检测并加载第一个可用模型。通过AI聊天面板下拉菜单切换型号。

推荐： Qwen 2.5编码器7B Q4_K_M （约4.7 GB）

GPU配置

guIDE会自动检测您的GPU并相应地进行优化：

对于a 4GB VRAM GPU （例如，RTX 3050 Ti）：

• 32个模型层中的约20-28个已卸载到GPU
• KV缓存存储在系统RAM中，用于更大的上下文窗口
• 启用闪存注意力以提高内存效率

键盘快捷键

建筑

electron-main.js              # Main process — IPC hub, AI chat handler, 100-iteration agentic loop
preload.js                     # Context bridge — secure API surface for renderer
scripts/
  launch.js                    # Dev launcher (Vite + Electron, concurrent)
main/
  llmEngine.js                 # node-llama-cpp — CUDA/Vulkan, GPU layer management, flash attention, thinking models
  modelManager.js              # GGUF model scanning & hot-swap
  ragEngine.js                 # BM25 codebase indexing & retrieval (no embedding model needed)
  terminalManager.js           # node-pty terminal management
  webSearch.js                 # DuckDuckGo web search (HTML scraping, no API key)
  mcpToolServer.js             # 52 MCP tools — autonomous LLM actions with fuzzy name matching
  browserManager.js            # Electron BrowserView + Chrome CDP + element listing
  memoryStore.js               # Persistent AI memory store (JSON on disk)
  cloudLLMService.js           # 9 cloud providers with automatic fallback chain
  gitManager.js                # Git operations (simple-git)
src/
  components/
    Layout/                    # Main layout, activity bar, status bar, menu bar, command palette, theme picker, welcome guide
    Editor/                    # Monaco editor, tabs, search/replace, split editor, markdown/HTML preview, code runner
    Chat/                      # AI chat panel — streaming, thinking display, tool terminal output, image input
    Terminal/                  # xterm.js integrated terminal with multiple tabs
    Search/                    # Cross-file search with regex support
    FileExplorer/              # File tree (list + grid), multi-select, drag & drop, copy/paste, 364 file icons
    Browser/                   # Embedded browser panel with URL bar and overlay management
    SourceControl/             # Git source control panel — stage, commit, diff, branches
  services/                    # Frontend service layer (editor, file system, LLM, electron bridge)
  types/                       # TypeScript type definitions
  config/                      # Editor & LLM configuration constants

我建造的东西与我重用的东西

这是一个个人项目。以下是一个诚实的细分：

从头开始构建（原创作品）

• 整个AI集成层 --代理循环、工具执行管道、上下文预算、卡住检测、自动继续、微调系统
• 52个MCP工具实施 --每个工具处理程序、参数验证、结果格式化
• 浏览器自动化系统 --BrowserView管理、元素列表、CSS选择器提取、自动注入页面状态
• RAG发动机 --BM25索引、令牌感知上下文检索
• 云LLM服务 --9提供商抽象，具有自动回退链、流媒体和视觉支持
• 存储器系统 --持久跨会话AI内存
• 所有React组件 --布局、聊天面板、文件资源管理器、源代码管理、浏览器面板、主题系统
• 系统提示工程 --工具定义、浏览器工作流、思维模型检测
• 电子IPC架构 --100多个IPC处理程序将渲染器连接到主进程
• 文件资源管理器功能 --网格/列表视图、多选、拖放、复制/粘贴、上下文菜单
• 主题系统 --8个主题，CSS变量覆盖映射30+顺风任意颜色

使用的库和技术（未重新发明）

• 电子 --桌面shell和本机操作系统集成
• React+TypeScript --UI框架
• 摩纳哥编辑 --代码编辑器组件（与VS code相同的引擎）
• 节点llama cpp --GGUF模型加载与推理
• xterm.js+节点pty --终端仿真器与PTY
• 顺风CSS --实用类样式
• 维特 --构建工具和开发服务器
• 简单git --git操作
• DuckDuckGo -网络搜索（HTML抓取，没有官方API）
• 文件图标矢量 --SVG文件类型图标
• 电子生成器 --Windows NSIS安装程序包

技术栈

配电楼

# Build the renderer (React app)
npx vite build

# Package as Windows installer (.exe)
npx electron-builder --win

安装程序(guIDE Setup 2.0.0.exe)将在 dist-electron/.

作者

布兰登·格雷 --计算机科学专业学生

• github： github/文件快照
• 项目： github/FileShot/guIDE

作为一个单独的项目建造。这是我的作品，请尊重许可证。

支持项目

如果guIDE对您有用，请考虑支持持续开发：

• GitHub赞助商： github/赞助商/FileShot
• 比特币： 32Sr7HbBSuNaTSn2AndAoDFK7cWmRtaxA2

许可证

来源可用 --版权所有（c）2025-2026布兰登·格雷。保留所有权利。

您可以出于个人非商业目的查看、下载和使用此软件。 你可以 不 重新命名、重新分发、出售或声称这件作品是你自己的。

看 许可证 完整条款。

guIDE — Your code, your models, your machine.