# nonebot-plugin-marshoai _✨ 使用 Azure OpenAI 推理服务的聊天机器人插件 ✨_

## 📖 介绍通过调用由 Azure OpenAI 驱动，GitHub Models 提供访问的生成式 AI 推理 API 来实现聊天的插件。插件内置了猫娘小棉(Marsho)的人物设定，可以进行可爱的聊天！ *谁不喜欢回复消息快又可爱的猫娘呢？* **※对 Azure AI Studio等的支持待定。对 OneBot 以外的适配器支持未经过完全验证。** ## 🐱 设定 #### 基本信息 - 名字：小棉(Marsho) - 生日：9月6日 #### 喜好 - 🌞 晒太阳晒到融化 - 🤱 撒娇啊～谁不喜欢呢～ - 🍫 吃零食！肉肉好吃！ - 🐾 玩！我喜欢和朋友们一起玩！ ## 💿 安装

使用 nb-cli 安装

在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装 nb plugin install nonebot-plugin-marshoai

使用包管理器安装

在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

pip

pip install nonebot-plugin-marshoai

pdm

pdm add nonebot-plugin-marshoai

poetry

poetry add nonebot-plugin-marshoai

conda

conda install nonebot-plugin-marshoai

打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入 plugins = ["nonebot_plugin_marshoai"]

## 🤖 获取 token - 如果你未获取GitHub Models的早期访问权限，请前往[GitHub Marketplace中的Models分页](https://github.com/marketplace/models)，点击`Get early access`按钮获取早期访问权限。**进入waitlist阶段后，需要等待数日直到通过申请。** ~~也可以试着白嫖其它人的token~~ - [新建一个personal access token](https://github.com/settings/tokens/new)，**不需要给予任何权限**。 - 将新建的 token 复制，添加到`MARSHOAI_TOKEN`配置项中。 ## 🎉 使用发送`marsho`指令可以获取使用说明 ## 👍 夸赞名单夸赞名单存储于插件数据目录下的`praises.json`里（该目录路径会在 Bot 启动时输出到日志），当配置项为`true`时发起一次聊天后自动生成，包含人物名字与人物优点两个基本数据。存储于其中的人物会被 Marsho “认识”和“喜欢”。其结构类似于： ```json { "like": [ { "name": "Asankilp", "advantages": "赋予了Marsho猫娘人格，使用vim与vscode为Marsho写了许多代码，使Marsho更加可爱" }, { "name": "神羽(snowykami)", "advantages": "人脉很广，经常找小伙伴们开银趴，很会写后端代码" }, ... ] } ``` ## ⚙️ 配置在 nonebot2 项目的`.env`文件中添加下表中的配置 | 配置项 | 必填 | 默认值 | 说明 | | :---------------: | :--: | :----: | :----------------------------------------------------------: | | MARSHOAI_TOKEN | 是 | 无 | 调用 API 必需的访问 token | | MARSHOAI_DEFAULT_MODEL | 否 | `gpt-4o-mini` | Marsho 默认调用的模型 | | MARSHOAI_PROMPT | 否 | 猫娘 Marsho 人设提示词 | Marsho 的基本系统提示词 | | MARSHOAI_ADDITIONAL_PROMPT | 否 | 无 | Marsho 的扩展系统提示词 | | MARSHOAI_ENABLE_PRAISES | 否 | `true` | 是否启用夸赞名单功能 | | MARSHOAI_ENABLE_TIME_PROMPT | 否 | `true` | 是否启用实时更新的日期与时间（精确到秒）与农历日期系统提示词 | | MARSHOAI_AZURE_ENDPOINT | 否 | `https://models.inference.ai.azure.com` | 调用 Azure OpenAI 服务的 API 终结点 | | MARSHOAI_TEMPERATURE | 否 | 无 | 进行推理时的温度参数 | | MARSHOAI_TOP_P | 否 | 无 | 进行推理时的核采样参数 | | MARSHOAI_MAX_TOKENS | 否 | 无 | 返回消息的最大 token 数 | ## 🕊️ TODO - [ ] 对聊天发起者的认知（认出是谁在问 Marsho） - [ ] 上下文通过数据库持久化存储 - [ ] [Melobot](https://github.com/Meloland/melobot) 实现