Skip to content

MicroAgent超轻量级个人 AI 助手框架

基于 TypeScript + Bun 构建的现代化 AI 助手框架

MicroAgent

项目简介

MicroAgent 是一个超轻量级的个人 AI 助手框架,使用 TypeScript 开发,Bun 作为运行时。

架构特点

  • 分层架构:Applications → SDK → Agent Service,职责清晰
  • Agent Service:纯运行时服务,支持 IPC/HTTP 双模式
  • 轻量级 SDK:客户端 API,支持流式响应
  • Kernel 层:Orchestrator、Planner、ExecutionEngine、ContextManager
  • Capability 层:Tool、Skill、Memory、Knowledge、MCP 系统

核心特性

  • 依赖注入容器:轻量级 DI 容器,支持瞬态和单例模式
  • Provider 抽象:统一的 LLM 提供商接口,支持 OpenAI 兼容 API(Ollama、DeepSeek、GLM、Kimi 等)
  • Agent 执行器:Function Calling 模式 + ReAct 循环双模式
  • 工具系统:可扩展的工具注册与执行机制,MCP 兼容
  • 多通道支持:CLI、飞书(更多通道开发中)
  • 本地存储:JSONL 会话存储,LanceDB 向量记忆检索
  • 技能系统:基于 SKILL.md 的渐进式技能加载
  • 热重载:扩展开发时支持文件变更自动重载

技术栈

  • 语言: TypeScript 5.9
  • 运行时: Bun 1.3+ (不支持 Node.js)
  • 依赖注入: 自研轻量容器
  • 配置验证: Zod
  • 日志: @logtape/logtape

注意:本项目专为 Bun 运行时设计,不支持 Node.js。详见 快速开始

基于 MIT 许可证开源