diff --git a/docs/content/zh-Hans/docs/overview/guide/tamagotchi/index.md b/docs/content/zh-Hans/docs/overview/guide/tamagotchi/index.md index dee5c49a5..1c248cfc3 100644 --- a/docs/content/zh-Hans/docs/overview/guide/tamagotchi/index.md +++ b/docs/content/zh-Hans/docs/overview/guide/tamagotchi/index.md @@ -2,3 +2,207 @@ title: 桌面版上手指南 description: 如何使用桌面版的 Project AIRI --- + +## 我现在就想聊天! + +没问题,跟着我来: + +- 完成入门引导教程 + +1. 选择您想要的 LLM / AI 提供商(在演示视频中,我选择了 OpenRouter) +2. 输入与 LLM / AI 进行交互需要的 API 密钥(会作为角色的「大脑」或「灵魂」) +3. 挑选一个合适的聊天(Chat)模型(在演示视频中,我选择了 `DeepSeek V3 0324`) +4. 从系统托盘中禁用 **悬停时淡化** 模式 +5. 将鼠标悬停在「角色模型」的界面上,点击聊天气泡图标,这将调出聊天窗口 +6. 现在输入点什么就可以开聊了! + +::: tip 在本地使用 Ollama? +您需要设置系统环境变量 `OLLAMA_ORIGINS=*`, +并在设置完成后重启 Ollama 应用程序。 +::: + + + +
+ +嗯,确实,这节奏太快了。我想... 你应该还没搞明白「**悬停时淡化**」到底是什么功能, +以及如何自定义所有设置,对吧? + +::: tip 我们仍处于开发的早期阶段,许多功能尚未完全可用。 +其中一些功能尚未真正就绪,但我们正努力让它们尽快实现: + +- 文本转语音(语音控制)功能 +- 本地语音合成(例如 GPT-SoVITS、IndexTTS 等) +- AI 唱歌 +- 从用户界面配置 Discord(但已经可以用了!只是需要掌握一些写代码的能力才能配置) +- 从用户界面配置 Minecraft Agent 智能体(但已经可以用了!只是需要掌握一些写代码的能力才能配置) +::: + +但首先。。。 + +::: tip 谢谢你! + +感谢你下载并试用它! +::: + +下载完成后,你可以从任何位置启动 AIRI。你将看到用户界面由两部分组成: + +- 新手引导 / 设置向导 +- 模型(可显示 Live2D 和 VRM 模型) + +![](./assets/screenshot-ui.png) + +我们还在系统托盘中提供了其他选项/命令,包括: + +- 显示 / 隐藏 +- 打开设置 +- 自动定位窗口 +- 等等。 + +让我们从逐一讲解基本概念和功能开始吧。 + +## 窗口控制 + +我们将介绍以下几个内容: + +- 如何与模型窗口互动? +- 如何移动模型窗口? +- 如何调整其大小? + +### 悬停时淡化 + +::: info 快捷键速记 +要切换此功能(即可与模型进行交互),请使用快捷键Shift + Alt + I 。 + +你可以在以下位置自定义按键映射:[设置]-> [外观] -> [通用] -> [快捷键] +::: + +你会发现,当鼠标悬停在模型上时,Live2D/VRM 模型会逐渐淡出或消失, +此时你无法通过光标与它进行交互。 + +
+ +
+ +这是因为默认情况下,**悬停时淡化** 功能是启用的:也就是说, +每当光标悬停在模型窗口的上方时,模型会淡出,并且你的点击会直接穿透该窗口。 + +这是一个非常强大的功能,在不断让「伙伴」一直陪伴在身边的过程中,你也可能会越来越发现它的有用之处。比如下面这两种我们想到的两个使用场景: + +#### 浏览 CrunchyRoll + + + +#### 浏览 Steam + + + +当然,想要禁用这一功能其实很简单。 + +有两种方式可以禁用它: + +- 系统托盘 +- 快捷键 + +你可以通过以下步骤来切换该功能: + +1. 右键单击系统托盘图标; +2. 点击 **窗口模式** +3. 点击 **悬停时淡化** + +
+ +
+ +### 移动窗口 + +::: info 快捷键速记 +要切换此功能(即可与模型进行交互),请使用快捷键 Shift + Alt + N。 + +你可以在 [设置]-> [外观] -> [通用] -> [快捷键] 中自定义按键映射。 +::: + +
+ +
+ +
+ +### 调整窗口大小 + +::: info 快捷键速记 +要切换此功能(即可与模型进行交互),请使用快捷键 Shift + Alt + A。 + +你可以在 [设置]-> [外观] -> [通用] -> [快捷键] 中自定义按键映射。 +::: + +
+ +
+ +
+ +## 聊天 + +目前系统托盘中没有直接打开聊天窗口的选项或命令,但我们未来可能会添加这一功能。 +目前,要打开聊天窗口,你需要先关闭 **悬停时淡化** 模式。 + +::: info 快捷键速记 +悬停时淡化(Fade on Hover)的快捷键是: Shift + Alt + I. +::: + +
+ + + +## 设置 + +你可以在系统托盘中打开设置以进行更多自定义,例如: +更改 AIRI 的主题颜色,或切换到其他模型,比如 Live2D(2D 模型)或 VRM(3D 模型,就像是 Grok Companion 那样)。 + + + +设置中有很多选项,不妨多尝试一下,看看有哪些功能是你感兴趣的。 + +### 更换模型 + +你可以将默认模型替换为其他 Live2D(2D)模型或 VRM(3D 模型,与 Grok Companion 类似,前提是你拥有这些模型)。 + +模型设置位于 [设置] -> [模型] 中。 + +::: tip 正在从 VTuber Studio 导入模型? +我们用于渲染 Live2D 模型的库,在读取由 VTuber Studio 打包的 ZIP 文件时可能会遇到问题,这是因为 VTuber Studio 使用了一些 Live2D 引擎无法识别的文件。 +因此,在导入之前,将 VTuber Studio 模型压缩为 ZIP 文件时,请确保排除以下文件: + +-`items_pinned_to_model.json` +::: + +
+ +::: tip 现在还有一些 Bug +目前模型场景重载功能尚未按预期工作。 +加载模型后,你需要重启 AIRI 才能生效。 +::: +
+ + \ No newline at end of file