✨ AiderDesk：AI 驱动的开发平台

AiderDesk 改变了你的软件开发方式，通过将自主 AI 代理 (Agent)、强大的代码生成能力和综合工具集整合到一个单一的桌面应用程序中。无论你是构建复杂功能、重构大型代码库，还是自动化重复任务，AiderDesk 都能为你提供一位智能的编程伴侣，以符合你工作方式的方式协同工作。

🎬 概述

✨ 主要功能

AiderDesk 专为现代软件开发而打造，功能丰富：

• 🤖 自主代理模式：一个由 Vercel AI SDK 驱动的智能化 AI 代理 (Agent)，能够自主规划并执行复杂任务——从实现功能到重构整个模块。只需描述你的需求，代理就会将其分解，探索你的代码库，使用合适的工具，并交付结果。
• 🧩 可扩展的工具生态系统：
  • 强力工具：直接文件操作、语义搜索、grep、Shell 命令、网页获取
  • Aider 工具：与 Aider 的智能代码生成和修改深度集成
  • 记忆工具：基于向量的持久化知识存储，学习项目模式和偏好
  • 技能：渐进式披露系统，用于添加领域专业知识和自定义工作流
  • 任务工具：完整任务管理，包含成本跟踪和待办事项列表
  • 待办工具：内置清单管理，代理可用于跟踪进度
• 👥 专用子代理：为特定任务（代码审查、测试、文档）创建成本优化的 AI 专家。支持自动或按需调用，具有可配置的权限和上下文记忆。
• 🎛️ 可定制的代理配置文件：使用系统提示词、自定义指令、工具审批和规则文件配置不同的代理行为。包含常见工作流的预构建配置文件。
• 🧠 持久化记忆：代理使用本地向量搜索 (LanceDB) 跨任务记住项目模式、架构决策和你的偏好。
• 📂 高级任务管理：组织工作，任务包含聊天历史、上下文文件、成本跟踪、待办事项，以及可选的 Git 工作树隔离以确保安全实验。
• 🌿 Git 工作树：创建隔离的开发环境，用于安全、并行的功能开发。支持多种合并策略及内置的回滚支持。
• 🔌 无缝集成开发环境 (IDE) 集成：自动将上下文文件与你的活动编辑器同步，支持：
  • IntelliJ IDEA (插件 | GitHub)
  • VSCode (扩展 | GitHub)
• 🧩 MCP 服务器支持：连接到任何模型上下文协议 (MCP) 服务器，以添加外部功能（网页浏览、数据库访问、自定义工具）。
• ⚙️ 钩子与自动化：用于工作流自动化的 JavaScript 钩子——响应事件、修改行为并与外部工具集成。
• 📊 使用仪表盘：通过交互式图表和表格可视化 Token 使用情况、成本和模型分布。
• 💰 成本跟踪：监控 Aider 和代理每个任务的 Token 使用量及相关成本。
• 🌐 REST API：将 AiderDesk 与外部工具和流程集成。
• 🌐 AiderDesk 作为 MCP 服务器：向其他兼容 MCP 的客户端（Claude Desktop、Cursor 等）暴露 AiderDesk 的核心功能。

了解更多关于 AiderDesk →

---

🤖 代理模式：自主 AI 助手

AiderDesk 的代理模式将应用程序转变为强大的自主编程伴侣。不仅仅是生成代码片段，代理还可以：

• 规划多步工作：将复杂的请求（如“实现 OAuth 认证”）分解为可操作的步骤
• 智能探索：使用语义搜索和 grep 理解你的代码库结构
• 安全执行：在获得你批准的情况下操作文件、运行命令和获取文档
• 从上下文中学习：检索有关项目模式和你偏好的相关记忆
• 委托给专家：自动调用专用子代理进行代码审查、测试或文档编写

关键能力：

• 自主规划：代理将高层请求分解为可执行的步骤
• 工具驱动：功能由连接的工具定义（强力工具、Aider、MCP、技能、记忆等）
• 无缝集成：使用 Aider 处理核心编码任务，如生成和修改
• 多提供商支持：适用于各种大语言模型 (LLM) 提供商（OpenAI、Anthropic、Gemini、Bedrock、Deepseek、OpenAI 兼容）
• 透明操作：在聊天中查看代理的推理、计划和工具使用情况
• 成本优化：针对不同任务使用不同模型——复杂工作使用高端模型，常规操作使用高性价比模型

预构建代理配置文件：

• 强力工具：直接文件操作和代码库分析
• Aider：AI 驱动的代码生成和重构
• 带强力搜索的 Aider：结合代码生成与高级搜索的混合方法

了解更多关于代理模式 →

🌿 Git Worktrees：隔离的开发环境

AiderDesk 的 Git Worktrees（工作树）功能为您的开发工作提供专业级的隔离，使您能够在不影响主项目分支的情况下进行安全的实验和并行开发。

主要优势：

• 🔒 完全隔离：在独立环境中开发功能，无需担心影响主代码库
• 🔄 灵活集成：可选择标准合并、压缩并合并 (Squash & Merge)，或仅传输未提交的更改
• ⚡ 并行开发：在隔离的工作树中同时处理多个功能
• 🛡️ 安全功能：内置冲突检测、合并回退 (merge revert) 和状态保存
• 🤖 AI 集成：AI 辅助功能可在隔离的工作树环境中无缝工作

工作流程概览：

1. 创建工作树任务：以工作树模式启动新任务，进行隔离开发
2. 安全工作：所有文件编辑、提交 (commit) 和 AI 交互均在隔离环境中进行
3. 准备就绪后集成：工作完成后选择您首选的合并策略
4. 必要时回退：内置回退功能，若出现问题可撤销合并

合并选项：

• 标准合并：通过快进合并 (fast-forward merge) 保留提交历史
• 压缩并合并：生成单个干净的提交，附带 AI 生成的消息
• 仅未提交更改：传输进行中的更改，不合并提交记录

了解更多关于 Git Worktrees →

---

🧠 Memory：学习您项目的 AI

AiderDesk 的 Memory（记忆）系统使智能体 (Agent) 能够跨任务存储和检索持久的、项目范围的知识。这有助于智能体记住：

• 您的偏好：格式化规则、偏好的框架、命名约定
• 架构决策：“我们使用 Zod 进行验证”，"REST 客户端位于 src/renderer/src/api/"
• 可复用模式：错误处理约定、日志标准、常见抽象

工作原理：

• 本地向量搜索 (Local Vector Search)：使用 LanceDB 和本地嵌入模型 (embedding models)——数据不会离开您的机器
• 项目范围：记忆按项目存储，保持知识有序
• 智能体集成：在任务开始时自动检索相关记忆，并在完成后存储结果
• 手动管理：从设置中浏览、过滤和删除记忆

了解更多关于 Memory →

---

📋 Skills：用专业知识扩展智能体

Skills（技能）允许您打包可复用的、按需的专业知识，以便智能体在相关时加载。与其将大型指南粘贴到聊天中，不如使用具有渐进式披露功能的技能：

• 启动时：仅加载技能元数据（名称 + 描述）——节省 Token
• 相关时：智能体加载技能的 SKILL.md 并遵循其指令
• 配合助手：技能可以包含可执行脚本和参考资料

使用技能进行：

• 可重复工作流：“我们如何发布”，“我们如何编写 PR 描述”
• 特定领域手册：内部流程、项目规范、品牌指南
• 项目特定知识：将 .aider-desk/skills/ 保存在仓库中以供团队共享
• 全局技能：个人技能存储在 ~/.aider-desk/skills/ 以供所有项目使用

了解更多关于 Skills →

---

🎛️ Hooks：自动化工作流

Hooks（钩子）允许您通过在响应系统事件时执行自定义 JavaScript 代码来扩展 AiderDesk 的行为。自动化工作流、强制执行规则或与外部工具集成。

钩子事件：

• 任务事件：onTaskCreated, onTaskClosed, onPromptSubmitted
• 智能体事件：onAgentStarted, onAgentFinished, onAgentStepFinished
• 工具事件：onToolCalled, onToolFinished
• 文件事件：onFileAdded, onFileDropped
• 审批事件：onQuestionAsked, onHandleApproval（自动回答问题）
• 修改事件：标记为 (M)——返回修改后的数据以更改行为

位置：

• 全局钩子：~/.aider-desk/hooks/（所有项目）
• 项目钩子：.aider-desk/hooks/（特定于项目）

了解更多关于 Hooks →

---

📂 Task System：组织您的工作

AiderDesk 的任务管理系统提供了一种全面的方式来组织工作，包括：

• 完整状态：聊天记录、上下文文件、待办事项、成本和元数据
• 工作模式：本地开发或隔离的 Git Worktree
• 成本追踪：分别追踪 Aider 和智能体使用的每任务成本
• 待办系统：内置检查清单，智能体可自动管理
• 任务操作：创建、重命名、复制、删除、导出（Markdown/图片）

任务按项目存储在 .aider-desk/tasks/ 中，具有完整的状态持久化功能。

了解更多关于 Task System →

---

📄 全面的上下文文件管理

通过灵活的上下文管理选项，让 AI 专注于相关代码。

1. 自动 IDE 同步：使用 IntelliJ IDEA 或 VSCode 插件，自动将编辑器中当前活动的文件添加到/从 AiderDesk 上下文中移除。
2. 手动控制：利用 AiderDesk 中的“上下文文件”侧边栏，显示您的项目文件树。点击文件可从上下文中手动添加或删除它们，为您提供精确的控制权。

了解更多关于 Context Files →

---

💰 成本优化

AiderDesk 提供了多种优化 AI 支出的方式：

• 按任务成本追踪：分别追踪 Aider 和智能体操作的成本
• 使用仪表盘：可视化 Token 使用情况、成本和模型分布
• 子智能体成本管理：针对不同任务类型使用不同模型：
  • Claude Opus：高层规划和架构
  • Claude 3.5 Sonnet / GPT-4：复杂开发和调试
  • Gemini Flash / Claude Haiku：常规代码审查和测试
• 上下文优化：智能体仅加载所需内容（技能、记忆）
• 工具审批控制：将工具设置为“始终”、“询问”或“从不”，以防止不必要的操作

了解更多关于 Cost Optimization →

---

📥 安装

快速开始

1. 从 Releases 下载适用于您操作系统的最新版本。
2. 运行可执行文件。

推荐的第一步

1. 尝试代理模式 (Agent Mode)：切换到代理模式（/agent）并让代理探索你的代码库或实现功能
2. 创建技能 (Skill)：将技能添加到 .aider-desk/skills/ 以编码团队的约定
3. 设置记忆 (Memory)：在代理设置中启用记忆工具 (Memory tools)，让代理学习你的项目模式

故障排除

禁用自动更新

为防止自动更新，请设置 AIDER_DESK_NO_AUTO_UPDATE 环境变量 (environment variable)：

• macOS/Linux： export AIDER_DESK_NO_AUTO_UPDATE=true
• Windows： $env:AIDER_DESK_NO_AUTO_UPDATE = "true"

自定义 Aider 版本

默认情况下，AiderDesk 会安装 aider-chat Python 包 (Python package) 的最新版本。如果您需要使用特定版本的 Aider，可以设置 AIDER_DESK_AIDER_VERSION 环境变量。

例如，要使用 Aider 版本 0.83.1：

# macOS/Linux
export AIDER_DESK_AIDER_VERSION=0.83.1

# Windows (PowerShell)
$env:AIDER_DESK_AIDER_VERSION = "0.83.1"

您也可以指定一个 Git URL (git URL) 来安装 Aider 的开发版本：

# macOS/Linux
export AIDER_DESK_AIDER_VERSION=git+https://github.com/user/aider.git@branch-name

此变量将在初始设置期间以及 AiderDesk 检查更新时使用。有关更详细的信息，请参阅 我们的文档。

👨‍💻 开发环境设置

如果您想从源代码运行，可以按照以下步骤操作：

# Clone the repository
$ git clone https://github.com/hotovo/aider-desk.git
$ cd aider-desk

# Install dependencies
$ npm install

# Run in development mode
$ npm run dev

# Build executables
# For Windows
$ npm run build:win

# For macOS
$ npm run build:mac

# For Linux
$ npm run build:linux

🤝 贡献

我们欢迎社区的贡献！以下是您帮助改进 aider-desk 的方法：

1. 在 GitHub 上 Fork 仓库 (repository)
2. 为您的功能或错误修复创建一个新分支 (branch)：

   git checkout -b my-feature-branch
   

3. 提交您的更改，使用清晰、描述性的消息
4. 将您的分支推送到您的 Fork
5. 针对原始仓库的主分支 (main branch) 创建拉取请求 (Pull Request)

请遵循以下指南：

• 保持 PR 专注于单个功能或错误修复
• 添加新功能时更新文档
• 遵循现有的代码风格和约定
• 编写清晰的提交消息和 PR 描述

对于重大更改，请先开启一个 Issue (Issue) 以讨论您想要更改的内容。

⭐ 星标历史

谢谢 ❤️

AiderDesk 快速上手指南

AiderDesk 是一款集成了自主 AI 代理、强大代码生成能力和综合工具集的桌面开发平台。它旨在成为你的智能编程伴侣，帮助你构建复杂功能、重构大型代码库或自动化重复任务。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 Windows、macOS 或 Linux（具体版本请查阅官方文档）。
• 网络环境：需要稳定的互联网连接以访问 LLM 服务和同步上下文。
• 代码编辑器：推荐使用 VSCode 或 IntelliJ IDEA，以便利用深度集成功能。
• 模型支持：支持多种 LLM 提供商（OpenAI, Anthropic, Gemini, Bedrock, Deepseek 等）。

2. 安装步骤

AiderDesk 提供独立的桌面应用程序及 IDE 插件两种入口。

方式一：安装桌面客户端（推荐）

1. 访问官方文档页面获取最新安装包：https://aiderdesk.hotovo.com/docs
2. 根据您的操作系统下载对应的桌面应用（Desktop Application）。
3. 运行安装程序并按照提示完成初始化。

方式二：安装 IDE 连接器

如果您希望在现有编辑器中直接使用 AiderDesk 功能，可安装对应插件：

• VSCode: 安装扩展 [hotovo-sk.aider-desk-connector](https://marketplace.visualstudio.com/items?itemName=hotovo-sk.aider-desk-connector)
• IntelliJ IDEA: 安装插件 [AiderDesk Connector](https://plugins.jetbrains.com/plugin/26313-aiderdesk-connector)

3. 基本使用

启动与配置

1. 打开 AiderDesk 应用。
2. 进入设置界面，配置您首选的大模型提供商（LLM Provider）。
3. 输入 API Key 完成身份验证。

创建任务

1. 点击 “新建任务”（New Task）。
2. 选择工作模式：
   • 本地开发：直接在当前项目目录操作。
   • Git Worktree：创建隔离的开发环境，安全并行开发新功能。
3. 在对话框中输入需求，例如：“实现 OAuth 认证”或“重构用户模块”。

启用智能助手 (Agent Mode)

1. 切换到 Agent Mode（代理模式）。
2. 描述复杂任务，AI 代理将自动拆解步骤、探索代码库并使用相应工具。
3. 在聊天窗口中查看代理的思考过程、计划及工具使用情况。
4. 确认关键操作（如文件修改、Shell 命令执行）以获得安全保障。

上下文管理

• 自动同步：安装 IDE 插件后，当前编辑器中活跃的文件会自动添加到 AiderDesk 上下文中。
• 手动控制：在 AiderDesk 侧边栏的“Context Files”中，您可以手动添加或删除文件树中的文件，精确控制 AI 关注的范围。

成本与监控

• 在仪表盘（Dashboard）中可视化查看 Token 使用情况、成本分布及模型分布。
• 每个任务均包含独立的费用追踪，方便管理预算。

---

更多高级功能（如记忆系统、技能扩展、Hooks 自动化）请查阅 完整文档。