From 735edc4c0cd8d1e89f4265f4dc927afbbf8dcafd Mon Sep 17 00:00:00 2001
From: YuanAshes <76946582+YuanAshes@users.noreply.github.com>
Date: Sat, 23 Aug 2025 22:26:21 +0800
Subject: [PATCH] Update installation instructions (#395)
---
.../docs/overview/guide/tamagotchi/index.md | 204 ++++++++++++++++++
1 file changed, 204 insertions(+)
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 模型）
+
+
+
+我们还在系统托盘中提供了其他选项/命令，包括：
+
+- 显示 / 隐藏
+- 打开设置
+- 自动定位窗口
+- 等等。
+
+让我们从逐一讲解基本概念和功能开始吧。
+
+## 窗口控制
+
+我们将介绍以下几个内容：
+
+- 如何与模型窗口互动？
+- 如何移动模型窗口？
+- 如何调整其大小？
+
+### 悬停时淡化
+
+::: 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