Athena | YesImBot
[](https://www.npmjs.com/package/koishi-plugin-yesimbot) [](http://choosealicense.com/licenses/mit/)   
*✨机器壳，人类心。✨*
## 👋 欢迎使用 Athena
欢迎来到 Athena (YesImBot) 项目！这是一个让 AI 大模型自然融入群聊的 Koishi 插件，让你的机器人拥有更加人性化的交流体验。无论你是开发者还是普通用户，我们都希望这个项目能为你带来价值。
## 🎐 简介
YesImBot / Athena 是一个 [Koishi](https://koishi.chat/zh-CN/) 插件，旨在让人工智能大模型能够自然地参与到群聊讨论中，模拟真实的人类互动体验。插件基于中间件架构设计，具有高度的可扩展性和灵活性。
*新的文档站已上线：[https://docs.yesimbot.chat/](https://docs.yesimbot.chat/)*
## 🎹 特性
- **智能对话管理**：基于意愿值系统控制Bot的主动发言频率，模拟真实人类的交流模式。
- **记忆系统**：通过Memory和Scenario管理上下文，使机器人能够记住和理解对话历史。
- **多适配器支持**：支持多种LLM API（如OpenAI、Cloudflare、Ollama等），实现负载均衡和故障转移。
- **可扩展的工具系统**：基于工具调用框架，允许机器人执行各种操作，如发送消息、管理记忆等。
- **高级上下文感知**：自动感知当前场景信息（群组信息、时间、@消息等），增强对话的沉浸感。
- **自定义人格与行为**：轻松定制Bot的名字、性格、响应模式等，打造独特的交互体验。
- *AND MORE...*
## 🌈 开始使用
> [!IMPORTANT]
> 继续前, 请确保正在使用 Athena 的最新版本。
> [!CAUTION]
> 请仔细阅读此部分, 这很重要。
下面来讲解配置文件的用法:
```yaml
# 记忆槽位设置
MemorySlot:
# 记忆槽位，每一个记忆槽位都可以填入一个或多个会话id（群号或private:私聊账号），在一个槽位中的会话id会共享上下文
SlotContains:
- 114514 # 收到来自114514的消息时，优先使用这个槽位，意味着bot在此群中无其他会话的记忆
- 114514, private:1919810 # 收到来自1919810的私聊消息时，优先使用这个槽位，意味着bot此时拥有两个会话的记忆
- private:1919810, 12085141, 2551991321520
# Bot能接收的上下文数量
SlotSize: 20
# @消息立即回复的概率（取值0-1）
AtReactPossibility: 0.5
# 意愿值增加设置
IncreaseWillingnessOn:
# 收到普通消息时增加的意愿值
Message: 15
# 收到@消息时增加的意愿值
At: 80
# 回复意愿阈值（超过此值触发回复）
Threshold: 80
# 消息等待时间(毫秒)，用于合并连续的消息
MessageWaitTime: 2000
# 判定为同一用户连续消息的时间阈值(毫秒)
SameUserThreshold: 5000
# 记忆文件存储配置
StoreFile:
human: "data/yesimbot/memory/human.txt"
persona: "data/yesimbot/memory/persona.txt"
# LLM API 配置
API:
# API列表，支持多个API进行负载均衡
APIList:
# 支持类型：OpenAI / Cloudflare / Ollama / Custom
- APIType: OpenAI
# API基础URL
BaseURL: https://api.openai.com/
# API密钥
APIKey: sk-XXXXXXXXXXXXXXXXXXXXXXXXXXXX
# 使用的模型
AIModel: gpt-4o-mini
# Cloudflare配置（如果使用Cloudflare）
# UID: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 机器人设定
Bot:
# 每秒发送的字符数，影响机器人回复的打字速度
WordsPerSecond: 20
# 调试设置
Debug:
# 在控制台显示Debug消息
EnableDebug: false
# 测试模式（每条消息都会触发回复）
TestMode: false
```
配置完成后，将机器人拉到对应的群组中。机器人会根据意愿值系统决定何时参与讨论。每收到一条消息，机器人的"回复意愿"会增加（见`IncreaseWillingnessOn.Message`配置），当意愿值超过设定的阈值（`Threshold`）时，机器人就会发送回复。被@时，意愿值会大幅增加（见`IncreaseWillingnessOn.At`配置），并且有一定概率（由`AtReactPossibility`决定）立即回复。
> [!TIP]
> 如果想让机器人更活跃，可以降低`Threshold`值；反之，提高此值会让机器人更"安静"。
> [!NOTE]
> 系统会自动合并短时间内的连续消息以优化上下文处理。`MessageWaitTime`和`SameUserThreshold`参数可以调整这一行为。
## 📃 自定义系统提示词
你可以根据自己的需求自定义系统提示词。`StoreFile` 的内容将被添加到系统提示词的末尾。
- 消息队列呈现给LLM的格式：
```text
[messageId][{date} from_guild:{channelId}] {senderName}<{senderId}> 说: {userContent}
```
- Athena期望LLM返回的格式：
```json
{
"function": "{functionName}",
"params": {
"{paramName}": "{paramValue}"
}
}
```
## 🚧 从 v2 版本迁移
> [!NOTE]
> 由于大量的代码重构，v3 版本的配置文件与 v2 版本的配置文件不兼容。建议先将 v2 版本的插件删除，然后安装 v3 版本。
## 🌼 推荐的 API 提供商
我们强烈推荐使用非Token计费的API服务，因为Athena的系统提示词较长，基于Token计费会增加使用成本。以下是一些按调用次数计费的推荐服务：
- [GPTGOD](https://gptgod.online/#/register?invite_code=envrd6lsla9nydtipzrbvid2r)
## ✨ 效果