内容
# 智能代理狐 🦊
一款强大的C#多智能体AI框架，支持子智能体、记忆、MCP、技能和通道集成。
## 功能特点
- 🤖 **多智能体系统** — 主智能体、具有继承能力的子智能体、分层管理
- 🧠 **记忆** — 短期记忆、持久长期记忆和具有自动合并的混合记忆
- 🔧 **工具调用** — 可扩展的注册表，内置文件、shell、web和实用工具
- 🔌 **MCP** — 连接外部模型上下文协议服务器；其工具自动注册
- 🎯 **技能** — Git、Docker、代码审查、调试、API、数据库、测试、部署（Composio）
- 📱 **通道** — WhatsApp、Telegram、Microsoft Teams、Discord、Slack
- 📈 **交易插件（可选）** — 交易信号解析，自动执行经纪人
## 安装
安装程序检查依赖项（.NET SDK 10.0，Git），从GitHub Releases下载预编译的二进制文件（或从源代码构建），将`agentfox`启动器放入`~/.agentfox`，并**将该目录添加到PATH**，以便您可以从任何地方运行`agentfox`（安装后打开新终端以使PATH更改生效）。在终端中运行时，它会完成交互式设置向导的启动，配置LLM提供程序、插件凭证（例如交易插件的AHK登录、PIN和允许的符号），并可选地安装系统服务 - 然后启动智能体或，如果服务已经运行，则指向Web UI。传递`-SkipOnboarding` / `--skip-onboarding`以跳过向导；随时可以重新运行`agentfox --onboarding`。
### Windows（PowerShell）
在**提升**的PowerShell中运行：
```powershell
# 含交易插件（默认）
irm https://raw.githubusercontent.com/UsmanSabir/AgentFox/main/install.ps1 | iex
# 不含交易插件
$env:AGENTFOX_NO_TRADING = '1'; irm https://raw.githubusercontent.com/UsmanSabir/AgentFox/main/install.ps1 | iex
```
或先下载然后使用参数：
```powershell
irm https://raw.githubusercontent.com/UsmanSabir/AgentFox/main/install.ps1 -OutFile install.ps1
.\install.ps1 -NoTrading # 核心功能，无交易插件
.\install.ps1 -InstallDir "C:\Tools\AgentFox" # 自定义安装目录
```
运行它（首先打开新终端以获取PATH）：
```powershell
agentfox # 启动智能体（默认端口8080的Web UI）
agentfox --onboarding # 重新运行交互式设置向导
agentfox --install-service # 可选：作为Windows服务运行
```
### Linux / macOS（bash）
```bash
# 含交易插件（默认）
curl -fsSL https://raw.githubusercontent.com/UsmanSabir/AgentFox/main/install.sh | bash
# 不含交易插件
curl -fsSL https://raw.githubusercontent.com/UsmanSabir/AgentFox/main/install.sh | bash -s -- --no-trading
```
运行它（打开新终端，或`source ~/.bashrc` / `~/.zshrc`，以获取PATH）：
```bash
agentfox # 启动智能体（默认端口8080的Web UI）
agentfox --onboarding # 重新运行交互式设置向导
agentfox --install-service # 可选：作为系统服务运行
```
### 从本地克隆
```bash
git clone https://github.com/UsmanSabir/AgentFox.git
cd AgentFox
# Windows
powershell -ExecutionPolicy Bypass -File .\install.ps1 # 含交易功能
powershell -ExecutionPolicy Bypass -File .\install.ps1 -NoTrading # 无交易功能
# Linux / macOS
bash ./install.sh # 含交易功能
bash ./install.sh --no-trading # 无交易功能
```
### 安装程序选项
| 选项（PowerShell） | 标志/环境变量（bash） | 默认值 | 描述 |
|---|---|---|---|
| `-NoTrading` | `--no-trading` / `AGENTFOX_NO_TRADING=1` | 安装交易插件 | 无交易插件安装。 |
| `-WithTrading` | `--with-trading` / `AGENTFOX_WITH_TRADING=1` | 保留更新时 | 显式添加/保留交易插件。 |
| `-InstallDir <path>` | `AGENTFOX_INSTALL_DIR` | `~/.agentfox` | AgentFox安装位置。 |
| `-BinaryUrl <url>` | `AGENTFOX_BINARY_URL` | GitHub Releases最新版本 | 预编译存档的直接URL。 |
| `-BuildFromSource` | `AGENTFOX_BUILD_FROM_SOURCE=1` | 关闭 | 跳过预编译下载，从源代码构建。 |
| `-RepoUrl <url>` | `AGENTFOX_REPO_URL` | 此仓库 | 构建源代码时克隆的源代码仓库。 |
| `-Branch <name>` | `AGENTFOX_BRANCH` | 默认分支 | 浅克隆的分支。 |
| `-SkipService` | — | 关闭 | 禁止Windows服务提示（仅限Windows）。 |
| `-SkipOnboarding` | `--skip-onboarding` / `AGENTFOX_SKIP_ONBOARDING=1` | 运行向导 | 安装后不启动交互式设置向导。 |
### 更新
安装程序将`update`脚本写入安装目录，该脚本重新下载最新版本并在更新实时安装前进行暂存（无需向导）。发布版本默认位于`appsettings.defaults.json`；您的模型、帐户、凭证、通道和其他覆盖项位于`appsettings.user.json`中，该文件永远不会被版本拥有或覆盖。来自旧AgentFox安装的第一个更新会将现有的`appsettings.json`复制到用户文件中。
在部署之前，新的AgentFox二进制文件会迁移并验证用户配置的临时副本。预更新配置的时间戳副本在`backups/`下保留。更新程序还会保留是否安装了交易插件。
```powershell
# Windows
powershell -File "$HOME\.agentfox\update.ps1"
```
```bash
# Linux / macOS
~/.agentfox/update.sh
```
重新运行原始安装一行命令（`irm … | iex` / `curl … | bash`）即可完成相同操作。
也可以手动检查或迁移配置：
```text
agentfox config validate
agentfox config migrate
```
### 卸载
安装程序编写了一个`uninstall`脚本到安装目录中。它删除系统服务（如果已安装），删除PATH条目，并删除安装目录。
```powershell
# Windows
powershell -File "$HOME\.agentfox\uninstall.ps1"
```
```bash
# Linux / macOS
~/.agentfox/uninstall.sh
```
> 在此之后打开新终端以使PATH更改生效。如果使用了自定义`-InstallDir` / `AGENTFOX_INSTALL_DIR`，`update`和`uninstall`脚本位于该目录中。
### ⚠️ 交易插件安全性
安装交易插件时，配置为**实时自动执行**（`AutoExecute: true`，`ExecutionMode: "BoundedAuto"`）。在发送任何信号之前，您**必须**审查并设置`AllowedSymbols`，`Ahk`经纪人凭证和`appsettings.json`中的订单价值上限 - 请参阅[src/Plugins/TradingAgent/README.md](src/Plugins/TradingAgent/README.md)。实时订单放置还需要Google Chrome / Chromium。要保留已安装但不活跃的插件，请设置`ExecutionMode: "Disabled"`（或`"Paper"`用于模拟）和`AutoExecute: false`。
## 快速入门（开发模式）
```bash
git clone https://github.com/UsmanSabir/AgentFox.git
cd AgentFox
dotnet build src/AgentFox.sln
dotnet run --project src/Agent # 交互模式
dotnet run --project src/Agent -- "your task here"
```
## 需求
- .NET SDK 10.0或更高版本（安装程序在缺少时自动获取）
- Windows / macOS / Linux
- Git — 仅在从源代码构建时需要（安装程序自动安装）
- Google Chrome或Chromium — 仅在实时交易执行时需要
## 文档
- [开发者指南](docs/DEVELOPMENT.md) — 项目结构、程序化使用、配置、调试
- [交易插件](src/Plugins/TradingAgent/README.md) — 交易代理设置和安全配置
- [发布](RELEASING.md) — 构建和发布发布二进制文件
## 许可证
MIT许可证 - 有关详细信息，请参见LICENSE文件
## 贡献
欢迎贡献！请随时提交拉取请求。参阅[开发者指南](docs/DEVELOPMENT.md)以开始。
