# Adnify

**Repository Path**: adnaan/adnify

## Basic Information

- **Project Name**: Adnify
- **Description**: 一个定制化极高的AI agent编辑器
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://adnify.vercel.app
- **GVP Project**: No

## Statistics

- **Stars**: 19
- **Forks**: 6
- **Created**: 2025-12-15
- **Last Updated**: 2026-01-02

## Categories & Tags

**Categories**: text-editor, ai

**Tags**: None

## README

# Adnify

> **Connect AI to Your Code.**
> 一个拥有极致视觉体验、深度集成 AI Agent 的下一代代码编辑器。

![License](https://img.shields.io/badge/license-MIT-blue.svg) ![Electron](https://img.shields.io/badge/Electron-33.0-blueviolet) ![React](https://img.shields.io/badge/React-18-blue) ![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)

Adnify 不仅仅是一个编辑器，它是你的**智能编程伴侣**。它复刻并超越了传统 IDE 的体验，融合了 Cyberpunk 玻璃拟态设计风格，内置强大的 AI Agent，支持从代码生成到文件操作的全流程自动化。

<!-- 主界面截图 -->
![alt text](images/main.png)

---

## 📋 更新日志

| 日期 | 版本 | 更新内容 |
|:---|:---|:---|
| 2026-01-02 | v1.3.0 | 🎯 **模型选择器重构**: 聊天面板新增模型/模式下拉选择器，支持按厂商分组快速切换模型 |
| 2026-01-02 | - | 🏗️ **Provider 架构统一**: 重构厂商配置存储，内置和自定义厂商统一管理 |
| 2026-01-02 | - | ✨ **自定义 Embedding 提供商**: 支持配置自定义 Embedding API |
| 2026-01-02 | - | 🔍 **混合搜索 (Hybrid Search)**: 实现 RRF 结果融合的语义+关键词混合搜索 |
| 2026-01-02 | - | ⚡ **Embedding 限流**: 添加速率限制和重试机制，避免 API 限流 |
| 2026-01-02 | - | 🛠️ **Result 类型**: 统一 IPC 处理器返回类型，提升错误处理一致性 |
| 2026-01-02 | - | 📦 **Editor 组件拆分**: 提取 SafeDiffEditor、TabContextMenu、EditorWelcome 等子组件 |
| 2026-01-02 | - | 🚀 **流式缓冲优化**: 使用 requestAnimationFrame 优化流式输出刷新时机 |
| 2026-01-01 | v1.2.9 | 🔌 **MCP 协议支持**: 集成 Model Context Protocol，支持外部工具扩展 |
| 2026-01-01 | - | 🎨 **MCP 富文本渲染**: 工具执行结果支持 Markdown/图片/表格等富文本展示 |
| 2026-01-01 | - | 🎯 **UI/UX 设计系统**: 新增设计系统数据库和工具集成 |
| 2025-12-31 | v1.2.8 | 🔒 **安全增强**: 优化文件监听器和终端命令执行安全性 |
| 2025-12-31 | v1.2.7 | 🍞 **Toast 系统重构**: 全新的通知提示系统 |

---

## 目录

- [核心特性](#-核心特性)
- [快速开始](#-快速开始)
- [功能详解](#-功能详解)
- [快捷键](#-快捷键)
- [项目结构](#-项目结构)
- [贡献与反馈](#-贡献与反馈)

---

## ✨ 核心特性

### 🎨 极致视觉体验

- **多主题支持**: 内置 4 套精心设计的主题
  - `Adnify Dark` - 默认深色主题，柔和护眼
  - `Midnight` - 深邃午夜蓝，专注编码
  - `Cyberpunk` - 霓虹赛博朋克风格
  - `Dawn` - 明亮日间主题

- **玻璃拟态设计**: 全局采用毛玻璃风格，配合微妙的流光边框和动态阴影
- **沉浸式布局**: 无框窗口、Chrome 风格标签页、面包屑导航

![alt text](image.png)
![alt text](images/theme2.png)

### 🤖 AI Agent 深度集成

- **三种工作模式**:
  - **Chat Mode** 💬: 纯对话模式，快速问答，无工具调用
  - **Agent Mode** 🤖: 智能代理模式，单次任务执行，拥有完整的文件系统和终端操作权限
  - **Plan Mode** 📋: 项目级开发模式，分步规划，自动追踪任务进度

- **22 个内置工具**: AI 可自主调用的完整工具集
  - 文件读取: `read_file`, `read_multiple_files`, `list_directory`, `get_dir_tree`
  - 文件写入: `write_file`, `edit_file`, `replace_file_content`, `create_file_or_folder`, `delete_file_or_folder`
  - 搜索功能: `search_files`, `search_in_file`, `codebase_search`
  - LSP 分析: `find_references`, `go_to_definition`, `get_hover_info`, `get_document_symbols`, `get_lint_errors`
  - 终端执行: `run_command`
  - 网络功能: `web_search`, `read_url`
  - 任务规划: `create_plan`, `update_plan` (Plan Mode 专用)

- **智能上下文**:
  - `@文件名` 引用文件上下文
  - `@codebase` 语义搜索代码库
  - `@git` 引用 Git 变更
  - `@terminal` 引用终端输出
  - `@symbols` 引用当前文件符号
  - `@web` 网络搜索
  - 拖拽文件/文件夹到对话框
  - 自动上下文压缩，支持超长对话

- **对话分支管理**:
  - 从任意消息创建分支
  - 可视化分支树
  - 分支切换和对比

- **多 LLM 支持**: OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Ollama, 自定义 API
- **快速模型切换**: 聊天面板底部下拉选择器，按厂商分组快速切换模型
- **MCP 协议支持**: 集成 Model Context Protocol，支持外部工具扩展
- **MCP 富文本渲染**: 工具执行结果支持 Markdown、图片、表格等富文本展示

![alt text](images/tool.png)

### 📝 专业代码编辑

- **Monaco Editor**: VS Code 同款编辑器内核
- **LSP 支持**: TypeScript/JavaScript 完整语言服务
  - 智能补全
  - 悬停提示 (Hover Info)
  - 跳转定义 (Go to Definition)
  - 查找引用 (Find References)
  - 签名帮助
  - 代码诊断

- **AI 代码补全**: 基于上下文的智能代码建议（Ghost Text）
- **内联编辑 (Ctrl+K)**: 选中代码后直接让 AI 修改
- **Diff 预览**: AI 修改代码前显示差异对比，支持接受/拒绝
- **编辑器右键菜单**: 快速访问常用操作
- **自动保存**: 可配置的自动保存功能
- **格式化保存**: 保存时自动格式化代码

[text](README.md) ![text](images/editor.png)

### 🔍 强大的搜索功能

- **快速打开 (Ctrl+P)**: 模糊搜索快速定位文件
- **全局搜索 (Ctrl+Shift+F)**: 支持正则、大小写敏感、全字匹配
- **语义搜索**: 基于 AI Embedding 的代码库语义搜索
- **混合搜索 (Hybrid Search)**: 结合语义搜索和关键词搜索，使用 RRF 算法融合结果
- **符号搜索**: 快速定位函数、类、变量
- **文件内搜索 (Ctrl+F)**: 当前文件内快速查找
- **搜索替换 (Ctrl+H)**: 支持批量替换

### 📟 集成终端

- **真·终端**: 基于 `xterm.js` + `node-pty` 的完整终端体验
- **多 Shell 支持**: PowerShell, CMD, Git Bash, WSL, Bash, Zsh
- **分屏终端**: 支持多终端并排显示
- **快捷脚本**: 一键运行 `package.json` 中的 npm scripts
- **AI 修复**: 终端报错后一键让 AI 分析并修复
- **快捷键支持**: Ctrl+C/V 复制粘贴，Ctrl+Shift+C/V 备用
- **WebGL 渲染**: 高性能终端渲染

![alt text](images/terminal.png)

### 📂 文件管理

- **资源管理器**: 完整的文件树视图
- **虚拟化渲染**: 支持超大项目，万级文件流畅浏览
- **文件操作**: 新建、重命名、删除、复制路径
- **大文件支持**: 智能检测大文件，优化加载策略
- **文件预览**: 
  - Markdown 实时预览（编辑/预览/分屏模式）
  - 图片预览
  - Plan 文件可视化
- **拖拽支持**: 拖拽文件到 AI 对话框添加上下文
- **外部链接**: 编辑器中的链接在系统浏览器中打开

### 🔀 Git 版本控制

- **源代码管理面板**: 完整的 Git 操作界面
- **变更管理**: 暂存 (Stage)、取消暂存、丢弃更改
- **提交历史**: 查看完整的提交记录
- **Diff 视图**: 并排对比文件变更
- **分支管理**: 查看和切换分支

### 🗂 代码大纲

- **文档符号**: 显示当前文件的函数、类、变量结构
- **快速导航**: 点击符号跳转到对应位置
- **层级展示**: 清晰的代码结构层次

### ⚠️ 问题面板

- **实时诊断**: 显示当前文件的错误和警告
- **快速定位**: 点击问题跳转到对应行
- **Lint 集成**: 支持 ESLint 等代码检查工具

### 🔐 安全特性

- **工作区隔离**: 严格的工作区边界检查
- **敏感路径保护**: 阻止访问系统敏感目录
- **命令白名单**: 限制可执行的 Shell 命令
- **Git 子命令白名单**: 限制可执行的 Git 操作
- **审计日志**: 记录所有敏感操作（按工作区存储到 `.adnify/audit.log`）
- **权限确认**: 危险操作需要用户确认
- **安全设置面板**: 可自定义安全策略

### 📜 历史记录

- **提交历史**: 查看完整的 Git 提交记录
- **时间线视图**: 按时间顺序浏览项目变更
- **快速导航**: 点击提交查看详情

### 🎯 其他特性

- **命令面板 (Ctrl+Shift+P)**: 快速执行各种命令
- **快速打开 (Ctrl+P)**: 模糊搜索快速定位文件
- **多窗口支持**: 同时打开多个项目
- **多工作区支持**: 单窗口打开多个项目根目录
- **工作区恢复**: 自动记住上次的工作状态
- **会话管理**: 保存和恢复 AI 对话历史
- **检查点系统**: AI 操作前自动创建检查点，支持一键回滚到任意消息
- **对话分支**: 从任意消息创建分支，探索不同方案
- **上下文压缩**: 自动压缩超长对话，保持上下文连贯
- **Token 统计**: 实时显示对话 Token 消耗
- **自动修复**: Agent 执行后自动检测代码错误并尝试修复
- **循环检测**: 智能检测 Agent 陷入循环并自动中断
- **国际化**: 完整的中英文支持
- **自定义快捷键**: 可配置的键盘绑定
- **引导向导**: 首次使用的配置引导
- **MCP 协议**: 支持 Model Context Protocol 扩展外部工具

---

## 🚀 快速开始

### 环境要求

- Node.js >= 18
- Git
- Python (可选，用于某些 npm 包的编译)

### 开发环境运行

```bash
# 1. 克隆项目
git clone https://gitee.com/adnaan/adnify.git
cd adnify

# 2. 安装依赖
npm install

# 3. 启动开发服务器
npm run dev
```

### 打包发布

```bash
# 1. 生成图标资源 (首次运行或图标变更时)
node scripts/generate-icons.js

# 2. 构建安装包
npm run dist

# 生成的文件位于 release/ 目录
```

---

## 📖 功能详解

### 配置 AI 模型

1. 点击左下角 **设置** 图标或按 `Ctrl+,`
2. 在 **Provider** 选项卡选择 AI 服务商
3. 输入 API Key（本地模型如 Ollama 需填写 Base URL）
4. 选择模型并保存

支持的服务商:
- OpenAI (GPT-4, GPT-4o, GPT-4o-mini, GPT-3.5)
- Anthropic (Claude 3.5 Sonnet, Claude 3 Opus/Sonnet/Haiku)
- Google (Gemini 2.0 Flash, Gemini 1.5 Pro/Flash)
- DeepSeek (DeepSeek Chat, DeepSeek Coder)
- Ollama (本地模型)
- 自定义 OpenAI 兼容 API
- 支持自定义模型名称

### 与 AI 协作

**引用文件上下文:**
- 输入 `@` 弹出文件选择列表
- 从侧边栏拖拽文件到输入框
- 使用斜杠命令 `/file` 选择文件

**斜杠命令:**
- `/file` - 添加文件到上下文
- `/clear` - 清空对话
- `/plan` - 切换到 Plan 模式并创建任务计划
- `/chat` - 切换到 Chat 模式
- `/agent` - 切换到 Agent 模式
- 更多命令可在输入框输入 `/` 查看

**@ 上下文引用:**
- `@文件名` - 添加文件到上下文
- `@codebase` - 启用语义搜索
- `@git` - 引用 Git 变更
- `@terminal` - 引用终端输出
- `@symbols` - 引用当前文件符号
- `@web` - 启用网络搜索

**让 AI 修改代码:**
1. 切换到 **Agent Mode**
2. 输入指令（如："重构这个函数，添加错误处理"）
3. AI 生成 Diff 预览
4. 点击 "Accept" 应用更改，或 "Reject" 拒绝

**内联编辑:**
1. 选中代码
2. 按 `Ctrl+K`
3. 输入修改指令
4. 预览并应用

**AI 自定义指令:**
在设置 → Agent 中可以添加自定义指令，AI 会在每次对话中遵循这些指令。

### 代码库索引

启用语义搜索功能:

1. 打开设置 → **Index** 选项卡
2. 选择 Embedding 提供商 (Jina, Voyage, OpenAI 等)
3. 配置 API Key
4. 点击 "Start Indexing" 开始索引

索引完成后，AI 可使用 `codebase_search` 工具进行语义搜索。

支持的 Embedding 提供商:
- Jina AI (推荐，免费额度)
- Voyage AI
- OpenAI
- 自定义 API (支持配置任意兼容 API)

### 使用 Plan Mode

Plan Mode 适合复杂的项目级开发任务：

1. 切换到 **Plan Mode** (点击模式切换按钮或输入 `/plan`)
2. 描述你的任务目标
3. AI 会自动创建分步计划
4. AI 按计划逐步执行，自动更新进度
5. 可随时查看计划状态和进度

Plan Mode 特有功能：
- 自动任务分解
- 进度追踪
- 步骤状态管理
- 计划可视化预览

### 使用 Git

1. 点击侧边栏 **Source Control** 图标
2. 查看文件变更列表
3. 点击 `+` 暂存文件
4. 输入提交信息
5. 按 `Ctrl+Enter` 提交

---

## ⌨️ 快捷键

### 通用

| 快捷键 | 功能 |
|:---|:---|
| `Ctrl + P` | 快速打开文件 |
| `Ctrl + Shift + P` | 命令面板 |
| `Ctrl + ,` | 打开设置 |
| `Ctrl + \`` | 切换终端 |
| `Ctrl + B` | 切换侧边栏 |
| `Ctrl + J` | 切换底部面板 |
| `Ctrl + Shift + ?` | 快捷键帮助 |
| `F12` | 开发者工具 |

### 编辑器

| 快捷键 | 功能 |
|:---|:---|
| `Ctrl + S` | 保存文件 |
| `Ctrl + W` | 关闭当前标签 |
| `Ctrl + Z` | 撤销 |
| `Ctrl + Shift + Z` | 重做 |
| `Ctrl + D` | 选择下一个匹配 |
| `Ctrl + /` | 切换注释 |
| `Ctrl + Shift + K` | 删除行 |
| `Ctrl + K` | 内联 AI 编辑 |
| `F12` | 跳转到定义 |
| `Shift + F12` | 查找引用 |
| `Ctrl + Space` | 触发补全 |

### 搜索

| 快捷键 | 功能 |
|:---|:---|
| `Ctrl + F` | 文件内搜索 |
| `Ctrl + H` | 文件内替换 |
| `Ctrl + Shift + F` | 全局搜索 |

### 终端

| 快捷键 | 功能 |
|:---|:---|
| `Ctrl + C` | 复制选中 / 中断命令 |
| `Ctrl + V` | 粘贴 |
| `Ctrl + Shift + C` | 复制 (备用) |
| `Ctrl + Shift + V` | 粘贴 (备用) |

### AI 对话

| 快捷键 | 功能 |
|:---|:---|
| `Enter` | 发送消息 |
| `Shift + Enter` | 换行 |
| `@` | 引用文件/上下文 |
| `/` | 斜杠命令 |
| `Escape` | 停止生成 |

### 模式切换

| 模式 | 说明 |
|:---|:---|
| Chat 💬 | 纯对话，无工具调用 |
| Agent 🤖 | 单次任务，工具调用 |
| Plan 📋 | 项目级开发，分步规划 |

---

## 📂 项目结构

```
adnify/
├── resources/           # 图标资源
├── scripts/             # 构建脚本
├── src/
│   ├── main/            # Electron 主进程
│   │   ├── ipc/         # IPC 处理器
│   │   │   ├── http.ts      # HTTP 请求
│   │   │   ├── indexing.ts  # 代码索引
│   │   │   ├── llm.ts       # LLM 通信
│   │   │   ├── lsp.ts       # LSP 服务
│   │   │   ├── search.ts    # 搜索功能
│   │   │   └── settings.ts  # 设置管理
│   │   ├── indexing/    # 代码库索引服务
│   │   │   ├── chunker.ts       # 代码分块
│   │   │   ├── embedder.ts      # Embedding 生成
│   │   │   ├── indexService.ts  # 索引服务
│   │   │   └── vectorStore.ts   # 向量存储
│   │   ├── services/llm/# LLM 通信层
│   │   └── security/    # 安全模块
│   │       ├── securityModule.ts    # 安全管理器
│   │       ├── secureTerminal.ts    # 终端安全
│   │       └── workspaceHandlers.ts # 工作区处理
│   ├── renderer/        # 前端渲染进程
│   │   ├── agent/       # AI Agent 核心
│   │   │   ├── llm/     # LLM 客户端适配器
│   │   │   ├── tools/   # 工具定义与执行
│   │   │   ├── services/# Agent 服务
│   │   │   └── prompts/ # 提示词模板
│   │   ├── components/  # UI 组件
│   │   │   ├── agent/   # Agent 相关组件
│   │   │   │   ├── ChatPanel.tsx      # 对话面板
│   │   │   │   ├── ToolCallCard.tsx   # 工具调用卡片
│   │   │   │   ├── InlineDiffPreview.tsx # Diff 预览
│   │   │   │   └── PlanPreview.tsx    # 计划预览
│   │   │   ├── editor/  # 编辑器组件
│   │   │   │   ├── Editor.tsx         # Monaco 编辑器
│   │   │   │   ├── DiffViewer.tsx     # Diff 查看器
│   │   │   │   └── InlineEdit.tsx     # 内联编辑
│   │   │   ├── sidebar/ # 侧边栏组件
│   │   │   │   └── panels/
│   │   │   │       ├── ExplorerView.tsx  # 文件浏览器
│   │   │   │       ├── SearchView.tsx    # 搜索面板
│   │   │   │       ├── GitView.tsx       # Git 面板
│   │   │   │       ├── OutlineView.tsx   # 大纲视图
│   │   │   │       └── ProblemsView.tsx  # 问题面板
│   │   │   ├── panels/  # 底部面板
│   │   │   │   ├── TerminalPanel.tsx  # 终端面板
│   │   │   │   ├── SessionList.tsx    # 会话列表
│   │   │   │   └── CheckpointPanel.tsx# 检查点面板
│   │   │   ├── dialogs/ # 对话框
│   │   │   │   ├── CommandPalette.tsx # 命令面板
│   │   │   │   ├── QuickOpen.tsx      # 快速打开
│   │   │   │   └── OnboardingWizard.tsx # 引导向导
│   │   │   └── settings/# 设置组件
│   │   ├── services/    # 前端服务
│   │   │   └── TerminalManager.ts # 终端管理
│   │   ├── store/       # Zustand 状态管理
│   │   └── i18n/        # 国际化
│   └── shared/          # 共享代码
│       ├── config/      # 配置定义
│       │   ├── providers.ts # LLM 提供商配置
│       │   └── tools.ts     # 工具统一配置
│       ├── constants/   # 常量
│       └── types/       # 类型定义
└── package.json
```

---

## 🛠 技术栈

- **框架**: Electron 33 + React 18 + TypeScript 5
- **构建**: Vite 6 + electron-builder
- **编辑器**: Monaco Editor
- **终端**: xterm.js + node-pty + WebGL Addon
- **状态管理**: Zustand
- **样式**: Tailwind CSS
- **LSP**: typescript-language-server
- **Git**: dugite
- **向量存储**: LanceDB (高性能向量数据库)
- **代码解析**: tree-sitter
- **验证**: Zod

---

## 🤝 贡献与反馈

欢迎提交 Issue 或 Pull Request！

如果你喜欢这个项目，请给一个 ⭐️ Star！

---

## 📄 License

MIT License - 详见 [LICENSE](LICENSE) 文件