VPetLLM

📋 系统要求

• Windows 10/11
• .NET Framework 4.6.2 或更高版本
• VPet-Simulator 主程序
• MPV 播放器（用于 TTS 音频播放）

💬 使用

1. 在 VPet-Simulator 中打开聊天窗口。
2. 输入你的消息并按 Enter，或者使用你配置的快捷键进行语音输入。
3. 你的虚拟宠物将会使用你配置的 LLM、TTS 和 ASR 服务来与你互动。如果启用了任何工具，它也可能会使用这些工具来提供更丰富、更有用的响应。

使用 Visual Studio 打开 VPetLLM.sln

或使用命令行构建

dotnet build VPetLLM.sln ```

⚙️ 配置

1. 打开 VPet-Simulator 的设置，并进入“MOD Config”选项卡。 2. 点击“VPetLLM”以打开插件设置。 3. 选择 LLM 提供商： 从下拉菜单中选择你想要使用的 LLM 提供商（Ollama、OpenAI、Gemini 或 Free）。 4. 填写提供商设置： - Ollama: 输入你的 Ollama 服务的 URL（默认为 http://localhost:11434）并选择一个模型。 - OpenAI: 输入你的 API 密钥、API 地址和模型名称。 - Gemini: 输入你的 API 密钥、API 地址和模型名称。 - Free: 无需额外配置。 5. 语音服务 (TTS/ASR): - 进入 TTS 选项卡，启用并选择你喜欢的 TTS 提供商，并填写相关配置（如 API Key, URL 等）。 - 进入 ASR 选项卡，启用并选择你的 ASR 提供商，配置快捷键和相关 API 信息。 6. 角色设定： 在可调整大小的文本框中定义你的虚拟宠物的角色和个性。 7. 上下文控制： 根据你的偏好，配置聊天上下文和历史记录的保存选项。 8. 高级设置： 如果需要，可以为每个提供商启用并调整高级设置，如温度和最大 Token。 9. 工具列表： - 点击“工具列表”选项卡。 - 点击“添加”按钮以添加一个新的工具。 - 在表格中填写工具的“名称”、“URL”和“API Key”（如果需要）。 - 勾选“启用”复选框以启用该工具。 - 点击“删除”按钮以删除选定的工具。 10. 保存： 点击“保存”按钮以应用你的设置。如果有未保存的更改，“未保存”的红色提示将会出现。

🚀 LLM 调用接口

插件和外部应用可以通过 LLMEntry 接口直接调用 LLM 服务：

插件调用：

var response = await _vpetLLM.LLMEntry.CallAsync("你的消息");

外部应用调用：

var response = await VPetLLM.VPetLLM.Instance.LLMEntry.CallAsync("你的消息");

日志示例：

插件调用：
[LLM Call] Plugin:AppLauncher calling LLM
[LLM Call] Message: 启动 notepad...
[LLM Call] Plugin:AppLauncher - Response in 2.34s

外部应用调用：
[LLM Call] ExternalProgram:MyApp.Services.AIService calling LLM
[LLM Call] Message: 分析这段文本...
[LLM Call] ExternalProgram:MyApp.Services.AIService - Response in 1.56s

详细文档请参考 插件开发指南

🔌 插件系统

VPetLLM 拥有一个强大的插件系统，允许开发者扩展其功能。通过创建自己的插件，你可以：

• 连接外部 API: 获取天气、新闻、股票等实时数据。
• 执行自定义动作: 控制智能家居、发送邮件、或者任何你能想到的事情。
• 增强 AI 的能力: 为你的桌宠赋予全新的、独一无二的技能。

我们为插件开发者提供了一套完整的接口和文档。

➡️ 点击这里查看详细的插件开发文档