# ⚡ NSR-AI 1.1
### 适用于 Minecraft 的高级多 API AI 聊天插件
---
**✔ 多 API** • **✔ 插件支持** • **✔ 易于设置** • **✔ 功能强大且高度可定制**
**MC 版本:** 1.16.5 – 1.21.4 • **JAR 大小:** 3.5 MB • **AI 模型:** Gemini, Claude, OpenAI
---
## ⚙️ 核心功能
> **多 API 集成** — Seamlessly 切换 Gemini、Claude 和 OpenAI API，以在速度、智能和成本之间找到理想的平衡，适用于您的服务器。
> **轻量级和优化** — NSR-AI 专为性能而设计，对服务器资源的影响最小，JAR 大小约为 3MB。
> **自定义聊天呈现** — 使用可配置的颜色和前缀自定义 AI 聊天消息的外观和感觉，适用于普通用户和管理用户。
> **API 密钥轮换** — 支持多达 20 个 API 密钥，并自动循环，以防止速率限制并确保高可用性。
> **持久知识库** — 教会 AI 关于您的服务器的自定义事实和信息，这些信息将在重启之间被记住。
> **增强的错误处理** — 清晰且用户友好的错误消息，便于诊断和解决任何问题。
> **AI 自我描述** — AI 可以根据玩家的要求描述自身和其功能。
> **代码拦截器** — 一项安全功能，可防止 AI 在其响应中提供代码片段。
## ✨ 插件支持
> **可扩展架构** — 强大的插件系统允许您使用新的功能和命令来扩展 NSR-AI 的功能。
> **易于安装** — 简单地将插件 `.jar` 文件放入 `addons` 文件夹并重启服务器。
## 🚀 1.1 主要新功能
- **配置拆分:** 配置现在分为 `config.yml` 用于核心设置和 `features.yml` 用于功能相关的设置，使管理更加容易。
- **高级内存和缓存系统:** 一个强大、分层的系统，用于处理对话历史记录，专为最佳性能和用户控制而设计。 使用 `/ai cache` 进行简单的会话缓存，`/ai memory` 进行 AI 驱动的内存摘要。
- **持久聊天日志:** 所有对话和生成的摘要都会自动保存到磁盘，确保不会丢失任何聊天历史记录。
- **自动更新检查器:** 该插件现在包含集成的更新检查器，该检查器将在启动时自动验证您是否运行最新版本。
- **新的游戏内版本命令:** 添加了一个新的命令，`/ai version`（或 `/ai v`），供玩家查看插件的当前版本以及是否有更新可用。
- **粒度命令切换:** 高度粒度的命令切换系统允许服务器管理员直接从 `features.yml` 配置文件中精确控制各个 AI 命令。
- **增强的 `/ai reload` 命令:** 此命令已扩展，以提供对插件重新加载的更多控制，允许您重新加载主要配置、功能、知识库或整个插件。
- **新的 `/ai help` 命令:** 显示带有所有可用命令描述的简洁的帮助消息，动态调整以仅显示已启用且对玩家可访问的命令。
- **插件增强:** 插件系统现在支持向后兼容性、增强的隐私命令 (`/ai privacy`)，并提供 `/ai stats` 中更详细的空闲时间显示。
- **高级知识库搜索:** 知识库搜索已显着改进，采用基于相关性计分的系统、内容和标题搜索、加权标题和模糊搜索，以提供更准确和相关的结果。
## 🔗 可选依赖项
- [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/): 允许您在其他插件中使用 NSR-AI 占位符。
- [**Advanced-Player-Stats (插件):**](https://modrinth.com/project/jeV1BXHY) 此插件是可选的，但它提供了玩家统计数据、隐私和空闲跟踪功能。
## 🎬 视频演示
## 🎬 1.1 新功能和细节视频
### 管理员命令
```
/ai admin or /ai confirm yes - 确认操作。
/ai reload [config|features|knowledge|nsr-ai] - 重新加载插件部分。
/ai cache [player|all] - 管理会话缓存。
/ai memory [player|all] - 管理 AI 驱动的内存。
```
### 通用命令
```
/ai - 与 AI 聊天。
/ai data - 查询知识库。
/ai version or /ai v - 检查插件版本。
/ai help - 显示帮助消息。
```
### 权限
```
nsr-ai.use — 默认: true
nsr-ai.admin — 默认: OP
nsr-ai.reload — 默认: OP
# 插件权限
nsr-ai.stats.view — 默认: true
nsr-ai.stats.view.others — 默认: true
nsr-ai.privacy — 默认: true
nsr-ai.admin.privacy — 默认: OP
nsr-ai.admin.privacy.bypass — 默认: OP
```
示例配置 (`config.yml`)
```yaml
# 主插件: config.yml
admin-activation-code: "3637"
default-gemini-model: "gemini-1.5-flash"
default-claude-model: "claude-3-opus-20240229"
default-openai-model: "gpt-4"
default-api-provider: "all"
api-keys: ["your_key_here"]
```
示例配置 (`features.yml`)
```yaml
# 特征插件: features.yml
chat-colors:
ai: "&b"
user: "&7"
knowledge-base: "&a"
chat-prefixes:
ai: "&b[AI]"
user: "&7[You]"
admin-ai: "&c[AI]"
system-prompt: "You are a helpful AI assistant for a Minecraft server. Your answers should be concise and to the to the point. Prioritize answering questions about Minecraft. Do not provide code snippets or programming advice. If asked for code, respond with the configured message."
conversation-history-length: 10
code-blocker:
enabled: true
message: "&cThis is a game built for fun and answering, not for coding."
simple-knowledge-yml-approve: false
command-toggles:
data: true
admin: true
disable: true
version: true
add: true
add-confirm: true
remove: true
remove-confirm: true
memory-clear: true
memory-refresh: true
cache-clear: true
cache-refresh: true
```
目录树
```
plugins/
└── NSR-AI/
├── addons/
├── playerchathistory
├── adminchathistory
├── summarychat
├── config.yml
├── features.yml
└── knowledge.yml
```
---
### **需要帮助或发现了一个错误？** 在下方留言，我会尽快回复！