1. 项目定位与用途
Amon 是一个本地运行的 AI 同事桌面应用程序，旨在成为用户的工作伙伴。它不仅能进行自然语言对话，还能主动协助完成实际工作任务，包括代码编写、命令执行、信息搜索和文件管理。应用采用 Electron 框架构建，支持 macOS、Windows 和 Linux 平台，提供一致的用户体验。其核心价值在于将 AI 能力深度集成到桌面环境，通过工作空间和技能系统实现上下文感知与功能扩展。
项目档案应用项目
liruifengv/amon-agent 是什么？用途、安装与使用指南
Amon 是一个本地运行的 AI 同事桌面应用，支持 Anthropic Claude、OpenAI、Google Gemini 等多 LLM 提供商。它能协助编写代码、执行命令、管理文件，通过工作空间和技能系统扩展能力。本页提供安装配置指南、使用方法和开发文档。
AI 总结
Amon 是一个本地运行的 AI 同事桌面应用，支持多模型提供商，能协助编写代码、执行命令、管理文件，提升工作效率。
中文项目介绍
Amon 是一个智能 AI 同事，在本地桌面上运行，帮助用户完成工作任务。它不仅能聊天，还能实际协助工作：编写代码、执行命令、搜索信息、管理文件。
项目解决了用户在本地需要可靠、可定制、多模型的 AI 助手来辅助开发和工作任务的问题，避免依赖单一云服务，提供隐私和灵活性。
适用场景包括：本地 AI 代码助手、自动化命令执行、文件操作与差异对比、多 LLM 模型切换、项目工作空间管理、技能扩展功能。
技术特征：基于 Electron 构建桌面应用，使用 React 和 TypeScript 开发；采用主进程-渲染进程架构，预加载脚本作为安全桥梁；三层代理架构，提供与提供商无关的 AI 流式层；支持 Anthropic Claude、OpenAI、Google Gemini 及 API 兼容提供商；使用 Bun 包管理器，Vite 构建渲染进程，Electron Forge 打包；AGPL-3.0 许可证。
详细信息与使用说明
2. 解决的问题
传统 AI 助手通常依赖单一云服务，存在隐私泄露风险、网络依赖和定制化困难等问题。Amon 通过在本地运行，解决了这些痛点：数据保留在用户设备上，保护隐私；不依赖特定云服务商，避免服务中断影响；提供多模型支持，用户可灵活选择最适合的 LLM；通过工作空间和技能系统，允许深度定制和扩展功能，适应不同开发和工作流需求。
3. 适用场景
Amon 适用于多种生产力场景：软件开发中作为 AI 代码助手，辅助编写、审查和调试代码；系统管理中自动化执行命令行任务；文档处理时进行信息检索和内容生成；文件操作中对比修改差异；项目管理中通过工作空间组织上下文；以及通过安装技能扩展专业领域能力，如设计评审、头脑风暴等。其多提供商支持也适合需要切换不同模型进行对比测试的场景。
4. 安装方式
用户可从 GitHub Releases 页面下载对应平台的安装程序。macOS 用户因应用未 Apple 签名，需在终端执行 `xattr -cr /Applications/Amon.app` 命令移除隔离属性才能运行。开发者可使用 Bun 包管理器通过 `bun install` 安装依赖，使用 `bun start` 启动开发服务器。项目使用 Electron Forge 进行打包，支持生成 dmg、deb、rpm 等格式安装包，也可通过 `bun run make` 构建。
5. 使用方式
首次启动后，需完成基本配置：进入 Settings → Provider 创建并启用 AI 提供商（如 Anthropic、OpenAI 等），并配置对应 API 密钥；进入 Settings → Workspace 创建新工作空间并选择本地文件夹作为项目根目录（默认 `~/.amon/workspace`）；返回主屏幕点击 New Session，选择工作空间即可开始与 AI 同事聊天协作。应用支持多会话管理、文件操作、工具调用和技能启用等交互。
6. 补充说明或实现特点
Amon 采用三层代理架构：底层是提供商无关的 AI 流式层，统一多 LLM 接口；中间是框架无关的代理核心，实现思考、工具调用循环；上层是 Electron 特定集成，处理桌面环境交互。从 0.3.0 版本起移除 Claude Agent SDK 依赖，所有运行时逻辑均在仓库内实现。应用使用 Zod 进行数据验证，支持深色/浅色主题，通过 IPC 机制在主进程与渲染进程间安全通信，并使用 Bun 作为运行时和包管理器。
思维导图
Amon Agent
核心架构
Agent Core
代理循环
工具调用
AI 集成层
提供商抽象
流式响应
多模型支持
桌面框架
Electron 主进程
渲染进程
预加载脚本
功能模块
工作空间管理
技能系统
会话管理
开发构建
Bun 包管理
Vite 构建
Electron Forge 打包
用户界面
React 组件
消息展示
设置面板
常见问题
Amon 是什么？
Amon 是一个本地运行的 AI 同事桌面应用，能协助完成编码、命令执行、文件管理等任务，支持多模型提供商，数据保留在本地保护隐私。
如何安装 Amon？
访问 GitHub Releases 下载对应平台的安装包；macOS 用户需在终端执行 `xattr -cr /Applications/Amon.app` 移除隔离属性；开发者可用 `bun install` 安装依赖，`bun start` 启动开发服务器。
如何配置 AI 提供商？
首次启动后，进入 Settings → Provider，创建并启用所需的 AI 提供商（如 Anthropic、OpenAI 等），并填入对应的 API 密钥即可使用。
工作空间是什么？
工作空间是 Amon 基于文件夹的项目上下文，可创建多个工作空间来隔离不同项目的文件与配置，默认位于 `~/.mon/workspace`，在会话中选择以提供相关文件背景。
如何扩展 Amon 功能？
通过安装 Skills（技能）来添加专业能力，如设计评审、头脑风暴等；也可通过工作空间配置和自定义提示词进一步定制代理行为，满足特定领域需求。