认识 ModAgent

ModAgent 是一个基于 .NET 的模块化 AI 桌面宿主,通过 DLL Mod 机制无限扩展能力。 不绑定单一模型、不锁定功能边界,一切皆可 Mod。

核心概念

为什么选择 ModAgent?

传统 AI 桌面应用往往绑定单一模型、固定工具集和有限扩展能力。 ModAgent 重新定义了 AI 桌面的架构方式。

🧩

一切皆 Mod

模型、工具、服务、界面入口、对话流程,全部通过 DLL Mod 加载和扩展。放入 Mods 目录即生效,卸载只需删除文件。

🔄

不绑定模型

内置模型路由服务,可按任务复杂度、上下文预算和成本策略自动选择模型。支持 DeepSeek、OpenAI 及任意兼容 API 的模型。

🖥️

跨平台桌面

基于 Avalonia UI 构建,支持 macOS、Windows、Linux。原生性能,不依赖 Electron,内存和 CPU 占用极低。

📁 Mods 目录结构
Mods/
├── ModAgent.Mods.Browser.dll
├── ModAgent.Mods.Memory.dll
├── ModAgent.Mods.DeepSeek.dll
├── ModAgent.Mods.Git.dll
├── ModAgent.Mods.Network.dll
├── ModAgent.Mods.SelfUpgrade.dll
└── ... 放入新 Mod 即生效 ✨
架构

ModAgent 架构

清晰的分层架构,宿主提供核心能力,Mod 扩展一切。

宿主核心

ModAgent Host

.NET 10 + Avalonia UI · 日志 · 配置 · 数据 · 数据库 · 事件 · 运行目录 · Node.js/Python 运行时 · 共享浏览器 · 审计 · 账单 · 调度

Mod 契约

IMod / IModContext / IModManifest

Mod 通过标准接口声明身份、依赖、平台和能力,宿主通过 AssemblyLoadContext 隔离加载并按依赖顺序初始化。

Mod 能力

可扩展的能力接口

🤖
模型提供者
接入任意 AI 模型
🔧
工具
为 AI 注册可调用工具
🔗
跨 Mod 服务
Mod 间依赖和协作
托管服务 & 定时任务
后台任务和定时触发
🪝
管道钩子
对话流程注入点
⚙️
配置页
内嵌 UI 配置界面
📄
主页面入口
自定义 UI 页面
📝
上下文贡献
为对话注入系统提示
内置 Mod

开箱即用的 13 个官方 Mod

从浏览器自动化到模型路由,从自我升级到项目规划,覆盖 AI 桌面使用全场景。

🌐

浏览器 Mod

ModAgent.Mods.Browser

内置 Chromium 浏览器,支持页面观察、点击、填写、滚动、截图、结构化抽取等多步网页任务

🔧

内置工具 Mod

ModAgent.Mods.BuiltIn

文件读写、Shell 执行、补丁应用等基础操作工具

☁️

云同步 Mod

ModAgent.Mods.CloudSync

配置和数据跨设备同步

🤖

DeepSeek 模型

ModAgent.Mods.DeepSeek

接入 DeepSeek V4 系列模型,支持长上下文和推理

📦

Git 版本控制

ModAgent.Mods.Git

仓库管理、提交、分支、推送、拉取等 Git 操作

🧠

记忆 Mod

ModAgent.Mods.Memory

长期/短期记忆管理,支持搜索和会话感知

🔀

模型路由

ModAgent.Mods.ModelRouter

按任务复杂度、上下文预算和成本自动选择最优模型

🌍

网络请求 Mod

ModAgent.Mods.Network

HTTP/HTTPS 请求、网页抓取、API 调用

🎨

OpenAI 图片生成

ModAgent.Mods.OpenAIImage

DALL·E 图片生成中转

🔌

OpenAI 代理

ModAgent.Mods.OpenAIProxy

OpenAI 兼容 API 代理接入

📋

项目规划器

ModAgent.Mods.ProjectPlanner

项目管理和任务规划,CodeGraph 代码索引

🪞

自我认知 Mod

ModAgent.Mods.SelfAwareness

运行时身份事实注入,确保模型知道自己是谁

🔄

自我升级 Mod

ModAgent.Mods.SelfUpgrade

AI 自我修复和升级能力,工程闭环自动化

对话流程

智能对话如何运作

每次对话都经过精心编排的流程,确保模型获得完整上下文和正确工具。

1

BeforeLoop 钩子

各 Mod 在对话前注入上下文:SelfAwareness 注入模型身份事实,Memory 注入记忆摘要,ProjectPlanner 注入项目相关信息。

2

模型路由

ModelRouter 分析用户意图、任务复杂度、上下文长度和成本预算,自动或手动选择最优模型来响应。

3

模型/工具循环

模型调用工具(来自 Browser、Git、Network 等 Mod),工具执行结果返回模型继续推理,直到任务完成。

4

AfterLoop 钩子

对话结束后,Memory 保存会话记忆,SelfUpgrade 复盘修复经验,审计和账单记录更新。

技术栈

构建技术

💻

.NET 10

最新 .NET 运行时,高性能、跨平台、AOT 就绪

🖼️

Avalonia UI

跨平台 UI 框架,原生渲染,不依赖浏览器引擎

🔌

DLL Mod 系统

AssemblyLoadContext 隔离加载,热插拔式扩展

📊

SQLite

本地嵌入式数据库,零配置,数据完全私有

准备好体验 ModAgent 了吗?

下载安装,放入 Mod,即刻扩展你的 AI 桌面。