快速开始

运行环境要求

注意：MicroAgent 专为 Bun 运行时设计，不支持 Node.js。

要求	版本
Bun	>= 1.0.0

安装 Bun：

# Windows
powershell -c "irm bun.sh/install.ps1 | iex"

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

安装

# 克隆项目
git clone https://github.com/jesspig/micro-agent.git
cd micro-agent

# 安装依赖
bun install

配置

1. 创建配置文件

mkdir -p ~/.micro-agent
cp workspace/settings.yaml ~/.micro-agent/settings.yaml

2. 配置 LLM

编辑 ~/.micro-agent/settings.yaml：

providers:
  deepseek:
    baseUrl: https://api.deepseek.com/v1
    apiKey: ${DEEPSEEK_API_KEY}
    models:
      - deepseek-chat

或使用本地 Ollama：

providers:
  ollama:
    baseUrl: http://localhost:11434/v1
    models:
      - qwen3

3. 配置飞书通道

3.1 创建飞书应用

1. 访问 飞书开放平台 并登录
2. 进入「开发者后台」→「创建企业自建应用」
3. 填写应用名称和描述

3.2 配置权限

在「权限管理」中添加以下权限：

权限	用途
im:message	接收和发送消息
im:message:send_as_bot	以应用身份发消息
im:resource	处理图片和文件

3.3 配置事件订阅

1. 进入「事件订阅」
2. 选择「使用长连接接收事件」
3. 添加事件：im.message.receive_v1

3.4 获取凭证

在「凭证与基础信息」获取 App ID 和 App Secret。

3.5 更新配置

channels:
  feishu:
    enabled: true
    appId: cli_xxxxxxxxxxxx
    appSecret: xxxxxxxxxxxxxxxxxxxxxxxx
    allowFrom: []  # 空数组允许所有人

3.6 发布应用

在「版本管理与发布」创建版本并发布，通过审核后即可使用。

运行

bun run start

启动后向飞书机器人发送消息测试。

项目结构

micro-agent/
├── packages/
│   ├── types/              # 核心类型定义（MCP 兼容）
│   ├── runtime/            # 运行时引擎（Container、EventBus、HookSystem、Gateway）
│   ├── config/             # 三级配置系统
│   ├── storage/            # 存储层（SessionStore）
│   ├── providers/          # LLM 提供商（Gateway、OpenAI 兼容）
│   ├── extension-system/   # 扩展发现、加载、热重载
│   ├── sdk/                # 聚合 SDK
│   └── server/             # 服务层
├── apps/
│   └── cli/                # CLI 应用
├── extensions/
│   ├── tool/               # 工具扩展（filesystem、shell、web、message）
│   ├── channel/            # 通道扩展（cli、feishu）
│   └── skills/             # 技能扩展（time、sysinfo）
├── tests/                  # 测试文件
├── docs/                   # VitePress 文档
└── templates/              # 模板配置