AggRoot

AggRoot

AI 智能终端助手框架

基于 Node.js 和 TypeScript 构建的可扩展 AI 助手框架 · DDD 领域驱动设计 + 热插拔插件架构,赋予 AI 无限可能。

🤖 AI Agent🔌 插件化🏗️ DDD 架构⚡ 实时交互🔍 文档解析🛡️ 安全沙箱

Node.js ≥ 20 · TypeScript 5.0+ · MIT License · Windows / Linux / macOS

🚀 一键安装Node.js ≥ 20
$npm install -g @aggroot-team/aggroot
② 启动 CLI 终端
$aggroot
③ 启动 Web 界面
$aggroot --web
📖 使用文档·或免安装运行:npx @aggroot-team/aggroot

💡 首次启动需配置 AI 提供商 API Key(DeepSeek / OpenAI / Claude / 智谱 / Kimi / MiniMax 等), 在项目目录创建 .env 文件即可。

DUAL MODE

CLI + Web 双形态预览

同一套核心引擎,两种使用方式 —— 终端原生体验与浏览器图形界面,按需切换。

Web · 浏览器

浏览器图形界面

aggroot
AggRoot Web 界面截图 1
对话主界面
aggroot
AggRoot Web 界面截图 2
功能演示
CLI · 终端

交互式终端 UI

aggroot
AggRoot CLI 终端截图 1
启动欢迎屏
aggroot
AggRoot CLI 终端截图 2
对话与工具调用
aggroot
AggRoot CLI 终端截图 3
多形态交互

💡 启动方式:aggroot 进入 CLI 终端,aggroot --web 启动 Web 服务(默认 http://localhost:3000)。双击截图可放大查看。

FEATURES

核心能力

🔌

热插拔插件系统

23 个内置插件 + 8 种扩展点类型,即插即用,灵活扩展,支持工具/模型/Agent 全类型插件

🤖

多模型支持

DeepSeek、OpenAI GPT、Claude、智谱、Kimi、MiniMax、Ollama、通义千问、MiMo、SiliconFlow 等 11+ AI 模型

🧠

智能记忆管理

三级记忆系统:感知→短期→长期,BM25+向量嵌入检索,上下文自动压缩,跨会话持久化

📄

全能文档解析

图片/JPG/PNG/SVG + Word/PPT/Excel + PDF,Vision 视觉识别引擎,一站式文档智能处理

🛡️

安全沙箱

风险控制系统,危险命令拦截,安全的代码执行环境,文档处理全程沙箱保护

🔌

MCP 协议集成

支持 Model Context Protocol,stdio/HTTP/WebSocket/SSE 四种传输,预配置 PPT/Word MCP 服务器

📈

股票行情工具

内置 StockQuote 实时行情 + Python 脚本生态(行情/财务/技术/新闻/对比/大盘)

CLI + Web 双形态

交互式终端 UI(分屏布局 + Markdown 渲染)与 Web 浏览器界面,按需选择使用方式

🎯

技能与子代理

8 个内置技能模板(解释/重构/测试/调试等)+ 5 类子代理协作(Explore/Plan/Review 等)

📄 DOCUMENT READING

全能文档解析引擎

📄 一站式文档智能处理

内置 Vision Service 视觉识别引擎,支持图片、Word、PPT、Excel、PDF、TXT 等多种格式的智能读取与解析。 AI 可直接「看懂」你的文档内容。

📝
Word
.docx / .doc
📊
Excel
.xlsx / .xls
📽️
PowerPoint
.pptx / .ppt
🖼️
图片
png / jpg / gif / svg
📕
PDF
.pdf
📃
文本 / 代码
txt / md / json
👁️

Vision 视觉识别

内置智能视觉服务,自动识别图片内容并生成文字描述,支持多模态 AI 模型联动分析

📑

Office 文档解析

内置 Word Reader 引擎,读取 .docx/.xlsx/.pptx 内容;支持 PDF 文本提取与结构化输出

✂️

智能分块与摘要

大文档自动分块处理,AI 批量并行分析,生成结构化摘要,支持超长文档无压力

🔄

格式转换与生成

支持输出 Word/PPT/Excel 文件,AI 根据需求生成或转换文档格式,一键导出

🔗

多模态理解

图文混排内容精准理解,表格数据智能提取,图表趋势分析,让 AI 真正读懂你的文档

🛡️

安全沙箱处理

文档处理全程在安全沙箱中进行,敏感内容自动脱敏,确保数据安全可靠

TOOLS

12 类内置工具插件

📄

Core Tools

8 个工具

文件读写、编辑、搜索、AskUser 交互

💻

Code Tools

6 个工具

代码执行、验证、格式化、分析、重构

🐚

Shell

1 个工具

安全控制的跨平台命令行执行

🌐

Web Tools

3 个工具

网页搜索、内容抓取、HTTP 请求

🔀

Git Tools

12 个工具

完整 Git 操作:提交/分支/远程/贮藏

Todo Tools

5 个工具

任务创建、列表、更新、完成跟踪

🧠

Memory Tools

记忆管理

三级记忆、上下文压缩、跨会话持久

📝

Office Tools

文档处理

Word/PPT/Excel 生成与解析

🎯

Skill Tools

2 个工具

技能模板加载与执行引擎

📈

Stock Tools

股票行情

实时股票报价与市场数据

🛡️

Risk Control

风控安全

危险命令拦截、域名信誉检查

🔌

MCP Tools

1 个工具

Model Context Protocol 外部集成

MODELS

11+ AI 模型适配

🤖
DeepSeek
默认提供商
🧠
OpenAI GPT
GPT-4/3.5
📝
Claude
Anthropic
🏠
Ollama
本地模型
🌐
智谱 GLM
Zhipu AI
🌙
Kimi
Moonshot AI
☁️
MiniMax
MiniMax
☁️
通义千问
Qwen
🎮
NVIDIA NIM
NVIDIA
🚀
MiMo
小米
💎
SiliconFlow
硅基流动
🔗
通用兼容
OpenAI Compatible
AGENTS

8 个内置 Agent + 子 Agent 协作系统

🤖Code Agentcode之神
✍️Writer Agent内容创作
📋Resume Agent简历优化
💬AI Partner情感陪伴
📈Investor投资大师
🔧DevOps运维大师
🛡️Risk Control风控侦探
💼AI Agent雷军同学
🔍
Explore
代码库探索
📐
Plan
架构规划
🔎
Code Reviewer
代码审查
Verification
验证测试
General Purpose
通用任务
🧠 MEMORY SYSTEM

三级记忆系统

输入 →🫧 感知记忆📝 短期记忆💾 长期记忆BM25 + 向量嵌入检索 | 跨会话持久化