中文 | English | 繁體中文 | 한국어

📖 文档 • 🚀 快速开始 • 📦 构建与运行

---

📖 概述

erii 是一个能像真人一样参与群聊的 AI 机器人。它有情绪、有记忆、有性格——心情会随对话起伏，说话风格也跟着变化。erii 不是被动等召唤，而是主动感知群里的氛围：该插话时插话，该安静时安静，冷场了还会自己找话题暖场。随着聊天深入，erii 会记住每个群友的喜好，学会群里的梗和黑话，越聊越有群里的味道。

核心特性：

• 🎭 情绪系统 — PAD 三维情绪模型，动态调节回复语气和风格
• 🧠 记忆系统 — 多维度向量记忆，语义检索，越聊越了解群友
• 🌊 心流系统 — 0-100 投入度状态机，话题匹配与过热保护
• ⚡ 主动行为 — 冲动值驱动的插话/破冰/暖场，防刷屏疲劳机制
• 📜 规则管理 — Markdown 规则文件约束言行，多级作用域热重载
• ⏰ 定时任务 — Cron 提醒和触发任务，自然语言推送
• 🔌 插件扩展 — PF4J 插件框架，4 种扩展点，MCP 工具接入
• 🌐 多 LLM — 支持 Gemini / DeepSeek / MiniMax / OpenAI / Anthropic / OpenRouter

🏁 快速开始

前置要求

• Node.js 18+（npm 安装）或 JDK 17+（源码构建）
• NapCat — QQ 接入服务
• LLM API Key — 至少一个 LLM 提供商的 API Key

npm 安装（推荐）

npm create @spcookie/erii
cd erii
erii setup     # 交互式配置向导
erii server    # 启动服务

或一键安装：

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/spcookie/erii-distribution/master/scripts/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/spcookie/erii-distribution/master/scripts/install.ps1 | iex

Docker 部署

docker-compose up -d                           # erii 主服务
cd docker/napcat-docker && docker-compose up -d  # NapCat QQ 接入
cd docker/playwright-docker && docker-compose up -d  # Playwright 浏览器

CLI 工具

go install ./erii-cli

命令	说明
erii config	交互式 TUI 配置编辑器
erii setup	设置向导
erii manage	数据管理 TUI
erii stats	状态统计 TUI

🛠️ 技术栈

• 语言: Kotlin 2.2+ / Go 1.21+ / Node.js 18+
• 框架: Ktor 3.3+ / Koog Agents 0.7+ / Mirai 2.16+ / Bubble Tea
• 存储: H2 + Exposed ORM
• 基础设施: Koin DI / JobRunr 调度 / PF4J 插件 / Gradle 构建

详细文档请访问 erii-docs。

📄 许可证

本项目基于 MIT 许可证开源。

Repobeats

Star History