From 49c6a011963c7c03c431bd8ea804fe7ef2814191 Mon Sep 17 00:00:00 2001
From: icefair <nsz000@126.com>
Date: Sun, 5 Apr 2026 00:53:10 +0800
Subject: [PATCH] feat(docs): setup and use manual (#1559)

---------

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
---
 .../docs/manual/tamagotchi/setup-and-use.md   | 473 ++++++++++++++++
 .../docs/manual/tamagotchi/setup-and-use.md   | 510 ++++++++++++++++++
 2 files changed, 983 insertions(+)
 create mode 100644 docs/content/en/docs/manual/tamagotchi/setup-and-use.md
 create mode 100644 docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use.md

diff --git a/docs/content/en/docs/manual/tamagotchi/setup-and-use.md b/docs/content/en/docs/manual/tamagotchi/setup-and-use.md
new file mode 100644
index 000000000..b288452a8
--- /dev/null
+++ b/docs/content/en/docs/manual/tamagotchi/setup-and-use.md
@@ -0,0 +1,473 @@
+# Project Airi Manual
+
+Writing time: (UTC+8) April 2, 2026 – evening
+
+Corresponding version: AIRI-0.9.0-beta.4-windows-x64
+
+<details>
+
+<summary>Expand to see the authors</summary>
+
+Lead writing team: MuGewRayce
+
+Contributing editor: JhIcefair (primary)
+
+</details>
+
+<details>
+
+<summary>Disclaimer: (click to expand)</summary>
+
+- Some technical functions and operations of Airi will not be explained in detail in this manual.
+- The primary editor is only responsible for the Chinese version of this manual. Other language versions are AI‑translated and then lightly manually corrected, so they may not match the actual software. Please refer to the actual content.
+- Most of the content has been explored by the lead writing team and may differ from reality. Please rely on your own experience.
+- This manual may not be updated in a timely manner.
+- Due to limited time and ability, this manual currently only covers some detailed tutorials for Airi installed via the installer on Windows.
+- Some parts of the software use English without translation. This manual attempts to translate those parts, but the final interpretation should follow the actual software.
+- Version updates may change content. This manual only describes the latest version before the writing time. If you encounter differences with other versions, please handle them yourself.
+- If you have additions or questions about this manual, please @jhicefair on the official Project Airi Discord channel and leave a message.
+- For any other questions, please leave a message on the official Project Airi Discord channel.
+- Have fun! AwA
+
+</details>
+
+## Chapter 1 – Installation
+
+Go to the Project Airi GitHub homepage: [moeru-ai/airi](https://github.com/moeru-ai/airi)
+
+Find the “**Releases**” option on the right side of the page.
+
+Click “+ 68 releases”
+(Note: the number indicates other releases; yours may not be 68)
+
+Pick a version, find “**Assets**” below it, and expand.
+
+Choose the version suitable for your computer and download it.
+(Note: You may need to click “Show all 19 assets” at the bottom – the number may vary.)
+
+[ *The following uses the Windows installer version as an example.* ]
+
+Locate the downloaded installer and double‑click to install.
+*(Due to time constraints, this part is skipped; I believe you can handle it.)*
+
+## Chapter 2 – Initial Configuration
+
+### Section 1 – Preparation
+
+Before you begin, you need to prepare at least one API from an LLM service provider.
+
+<details>
+
+<summary>Terminology explanation: (click to expand)</summary>
+
+* LLM
+
+LLM stands for Large Language Model.
+Simply put, an AI.
+
+* API
+
+API stands for Application Programming Interface.
+It is a set of predefined rules that allow different software applications to communicate, exchange data, and share functions.
+You don’t need to understand it deeply, just know how to obtain one.
+
+</details>
+
+[There are many LLM providers, and the methods to obtain an API vary. Due to time constraints, no tutorial or example is provided here. Please search online or ask an AI.]
+
+Once you have your API, keep it safe and do not share it with others.
+
+### Section 2 – Launch Airi!
+
+Open Airi (normally it opens automatically after installation).
+
+Select your language in the main window.
+
+Click “**setup with your provider**”.
+
+Select your service source and click “**Next**”.
+
+[ *Using Deepseek as an example* ]
+
+Enter your API Key and click “**Next**”.
+
+Click “**Next**” again.
+
+Select the model you wish to use, then click “**Save and continue**”.
+
+Congratulations! You have completed the initial configuration of Airi.
+
+## Chapter 3 – Airi Interface Overview
+
+### Main Window
+
+This window displays the virtual character. There are four buttons:
+- “websocket status” – top right, click to open connection settings (detailed explanation omitted).
+- “Expand” – bottom right, click to reveal more options (see below).
+- “Open hearing control” – bottom right, allows you to speak to Airi (requires STT service; seems you also need to open the chat window first. Since this function hasn’t worked for me yet, tutorial omitted).
+- “Move” – bottom right, long‑press and drag to reposition the main window.
+
+<details>
+
+<summary>Terminology explanation: (click to expand)</summary>
+
+* websocket
+
+WebSocket is a network communication protocol that provides full‑duplex, persistent connections between a browser and a server.
+In simple terms, traditional HTTP is a “request‑response” model (client requests, server responds, then disconnects), while WebSocket allows both parties to send messages at any time after the connection is established, without repeated requests.
+
+* STT
+
+STT stands for Speech‑to‑Text, also known as automatic speech recognition (ASR).
+Its goal is to enable computers to understand human speech and convert it into text.
+
+</details>
+
+Click “Expand” to reveal eight options:
+- “Open settings” – opens the settings window.
+- “Switch character” – switch character cards (details omitted due to time).
+- “Open chat” – opens the chat window.
+- “Refresh” – refreshes the main window.
+- “Switch to dark mode” – toggles light/dark theme.
+- “Unpin” – makes the main window not always on top.
+- “Always show” / “Hide on hover” – allows clicking through the window.
+- “Close” – closes Airi.
+
+### System Tray Other Options
+
+First, locate the Airi icon in the system tray (on Windows you may need to click “Show hidden icons”).
+
+Right‑click the Airi icon to see ten options:
+- “Show” – brings up the main window, usually not needed.
+- “Adjust size” – adjusts the main window size and centers it.
+  Includes four options: “Recommended (450x600)”, “Full height”, “Half height”, “Full screen”.
+- “Align to” – aligns the main window to a specific screen position.
+  Includes five options: “Center”, “Top left”, “Top right”, “Bottom left”, “Bottom right”.
+- “Settings” – opens the settings window.
+- “About” – details omitted.
+- “Open quick actions” – details omitted.
+- “Open widgets” – details omitted.
+- “Open caption” – opens subtitles (requires TTS service to display text when Airi speaks; default hides on hover).
+- “Caption overlay” – includes two options: “Follow window” (default, caption moves with main window) and “Reset position”.
+- “Quit” – closes Airi.
+
+<details>
+
+<summary>Terminology explanation: (click to expand)</summary>
+
+* TTS
+
+TTS stands for Text‑to‑Speech, which converts written text into natural‑sounding spoken output.
+
+</details>
+
+### Settings Window
+
+[ *This section only describes what the window contains; detailed functions are in Chapter 4.* ]
+
+You can open settings by clicking “Expand” on the main window and selecting “Open settings”, or by right‑clicking the Airi tray icon.
+
+There are nine sections:
+
+- “AIRI Character Card” – configure character personality.
+- “Body Modules” – configure various functions: Consciousness, Vocalization, Hearing, Vision, Short‑term Memory, Long‑term Memory, Discord, X/Twitter, Minecraft, Factorio, MCP Server, Rhythm Game.
+- “Scene” – not yet released.
+- “Character Model” – choose and configure the character’s model.
+- “Memory Bank” – not yet released.
+- “Service Sources” – configure LLM, TTS, STT services.
+- “Data” – manage Airi’s data.
+- “Connection” – configure WebSocket server address.
+- “System” – includes four sub‑sections: “General” (theme, language, etc.), “Color Scheme”, “Window Shortcuts” (empty – see warning), “Developer” (advanced features, see Chapter 4).
+
+### Chat Window
+
+You can open the chat window by clicking “Expand” on the main window and selecting “Open chat”.
+
+Here you can chat with Airi.
+Detailed introduction omitted.
+
+## Chapter 4 – Settings
+
+You can open settings by clicking “Expand” on the main window and selecting “Open settings”, or by right‑clicking the Airi tray icon.
+
+### AIRI Character Card
+
+Here you can upload, create, or modify the default character card.
+
+About uploading: the popup suggests any file type is supported, but I haven’t used it, and there is no export function, so details omitted.
+
+About creating a new character card:
+You can set the character’s identity, behavior, modules, etc.
+
+**Identity** includes name, nickname, description, creator’s notes.
+Name is the official name; if a nickname is set, it will be used first.
+Description is the detailed personality. You can be creative or refer to the default character card.
+(Note: if you refer to the default card, you may omit the part about ACT tags.)
+Creator’s notes – I haven’t used them, details omitted.
+
+**Behavior** includes personality, scenario (environment/background/context), and greeting. I haven’t adjusted these, details omitted.
+
+**Modules** – you can configure character‑specific body modules; usually leave as is, details omitted.
+
+**Settings** includes system prompt, history prompt instructions, and version (character card version). I haven’t used the first two, details omitted.
+
+The most important parts are name and description in Identity. After filling them in, click “**Create**” to complete the character card.
+
+Finally, click the circle in the bottom‑right corner of the card, or select the card and click Activate, to enable your character card.
+[ ***Note: Newly created cards are not enabled by default. You must activate them.*** ]
+
+### Body Modules
+
+Here you can configure various Airi functions, as follows:
+
+#### Consciousness
+
+First select a service source (or add a new one) and select it.
+[ *If there are too many sources and you cannot click the ones at the back, move the mouse over a tab, press the middle button, and drag left/right.* ]
+Then select a model – configuration is complete.
+
+#### Vocalization
+
+First select a service source (or add a new one) and select it.
+Then select a model, then select a voice.
+You can also choose “None” to disable Airi’s voice.
+
+At the bottom of this page, you can enter text to test the voice by clicking “**Test voice**”.
+
+[ Note: The configuration process may vary slightly for different service sources. This uses Alibaba Bailian as an example; follow the actual interface. ]
+[ For some services, the Pitch control may not work. ]
+
+Other details omitted.
+
+#### Hearing
+
+First select your audio input device.
+Then select a service source (or add a new one) and select it.
+Then select a model – configuration is complete.
+
+Additionally, you can enable “Auto‑send transcribed text” to send automatically, or disable it to adjust the transcription result (I think – I haven’t successfully used Hearing).
+You can also set “Auto‑send delay”.
+
+In the middle of this page, you can test the microphone.
+Click “**start monitoring**” to start listening.
+You can adjust Sensitivity (I haven’t tried it, details omitted).
+
+At the bottom of this page, you can test STT.
+Click “**start speech‑to‑text**” to begin testing.
+The result will appear under “Transcription Result”.
+
+Other details omitted.
+
+#### Vision
+
+First select a service source (or add a new one) and select it.
+Then select a model – configuration is complete.
+
+You can also set “Capture interval”.
+
+[ ***This function requires enabling vision capture in System → Developer → vision capture. See that section for details.*** ]
+
+Other details omitted.
+
+#### Short‑term Memory
+
+Not yet released.
+
+#### Long‑term Memory
+
+Not yet released.
+
+#### Discord
+
+Here you can configure a Discord bot so that Airi can join your Discord server and interact.
+You need to obtain your Discord bot token and enter it in the appropriate field.
+
+**Note:**
+This function requires a Discord bot, which is not included in the installer version. You need to extract the relevant files from the GitHub page. Since I have a low priority for this, tutorial omitted.
+
+#### X/Twitter
+
+Similar to Discord; requires a bot. Tutorial omitted.
+
+#### Minecraft
+
+Requires a bot. Tutorial omitted.
+
+#### Factorio
+
+Requires a bot. Tutorial omitted.
+
+#### MCP Server
+
+I haven’t used this. Tutorial omitted.
+
+#### Rhythm Game
+
+I am still exploring this. Tutorial omitted.
+
+### Scene
+
+Not yet released.
+
+### Character Model
+
+Here you can choose and set the character’s model.
+
+Airi supports Live2D models and VRM 3D models.
+
+Click “**select model**” to choose a model. In this version, there are two Live2D and two VRM models by default.
+Select one and click “**confirm**” to switch models.
+You can also click “**add**” to import your own Live2D or VRM model.
+
+[ **Note: Old Live2D models are not supported! You must use files including “*.moc3”.** ]
+[ **Before importing a Live2D model, you must compress the model folder into a “*.zip” file.** ]
+
+- **If you choose a Live2D model**
+
+Expand “Zoom & Position” to adjust the model’s size and position in the main window.
+x is horizontal (left/right), y is vertical (up/down).
+
+Expand “parameters” to set mouse tracking, Idle Animation, frame rate, Auto Blink, Force Auto Blink (fallback timer), Shadow, reset to default parameters, clear model cache, and all model‑specific parameters.
+If you want to set an idle animation, ensure the model zip includes animation files.
+Other details omitted.
+
+Expand “Expressions” to enable the Expression System.
+I haven’t tested this yet, details omitted.
+
+- **If you choose a VRM 3D model**
+
+Expand “Scene” to set Model Position, camera angle (degrees), camera distance (zoom), model orientation (Y‑axis rotation), model gaze direction, etc.
+This section, including “Change model”, is omitted due to time constraints.
+
+### Memory Bank
+
+Not yet released.
+
+### Service Sources
+
+Here you can configure LLM, TTS, and STT service sources.
+
+Details omitted.
+
+### Data
+
+Here you can manage Airi’s various data.
+
+[ ***Note: This section allows deletion and clearing of data, which cannot be undone. Please operate with caution!*** ]
+
+The first box contains “Open app data folder”.
+Click “**Open folder**” to open it.
+[ *Note: There is a bug – it opens the folder multiple times at once.* ]
+
+The second box allows you to import/export chat history or delete all chat sessions.
+(Details omitted.)
+
+The third box allows you to delete all imported models or reset module preferences and credentials.
+(Details omitted.)
+
+The fourth box allows you to reset desktop settings and state.
+(Details omitted.)
+
+The fifth box allows you to reset all provider settings and credentials, or clear every local setting, provider configuration, and model.
+(Details omitted.)
+
+### Connection
+
+Here you can configure your WebSocket server address.
+
+(Details omitted.)
+
+### System
+
+#### General
+
+Here you can set the program theme, language, etc.
+
+Theme defaults to light; click the button to switch to dark mode.
+
+Language sets the interface language.
+
+Control island icon size changes the size of the three buttons at the bottom‑right of the main window.
+
+Finally, you can choose whether to allow collection of usage data and crash reports, or read the privacy policy (click “Privacy Policy” to open).
+
+#### Color Scheme
+
+Here you can change the theme color.
+
+You can enable the RGB option to make the theme color cycle like an RGB strip.
+You can also drag the black line or click on the color bar to change the theme color.
+Below that is a color preview.
+
+You can also select a preset below to change the theme color.
+[ ***Note: You should click on a circle, not the square box.*** ]
+
+#### Window Shortcuts
+
+[ ***Warning: This option has no content and no back button. Once you enter, you must close and reopen the settings window. Do not click it!*** ]
+
+#### Developer
+
+Here you can use some advanced features.
+
+[ **Since most of this content is in English and consists of advanced features that are rarely needed, this part is for reference only!** ]
+
+- In the first box, you can click “**Open**” to open the developer tools window (like F12 in a browser).
+
+- The second “Markdown stress test” – details omitted.
+
+- The third “Lag visualization” – details omitted.
+
+- The fourth “Enable stage transition animation” – details omitted.
+
+- The fifth “Use page‑specific cutscenes” – details omitted.
+
+##### useMagicKeys tool
+
+Blank – details omitted.
+
+##### useElectronWindowMouse
+
+Here you can detect the mouse cursor position on the screen.
+
+##### Displays
+
+Here you can visualize the mouse cursor position on the screen.
+
+##### widgets calling
+
+Details omitted.
+
+##### Context Flow
+
+Real‑time inspection of incoming context updates (server + broadcast) and outgoing chat hooks. Use this to verify how plugin context (e.g., VSCode coding context) flows into the chat pipeline and out to server events.
+Details omitted.
+
+##### relative mouse
+
+Here you can visualize the mouse cursor position within this window.
+
+##### beat sync visualizer
+
+Details omitted.
+
+##### WebSocket Inspector
+
+Details omitted.
+
+##### Plugin Host Debug
+
+Details omitted.
+
+##### Screen Capture
+
+Here you can capture any application window or the entire screen.
+There are four options at the top:
+“applications” – select any open application window, click “**share window**” to view it at the top; move the mouse over the capture and click “stop” to stop.
+“displays” – capture the whole screen, click “**share screen**” to view; move the mouse over the capture and click “stop” to stop.
+“devices” – omitted.
+“refetch” – omitted.
+
+##### vision capture
+
+Details omitted.
diff --git a/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use.md b/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use.md
new file mode 100644
index 000000000..b94b61a68
--- /dev/null
+++ b/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use.md
@@ -0,0 +1,510 @@
+# Project Airi 说明书
+
+编写时间：（北京时间）2026年4月2日-晚上
+
+对应版本：AIRI-0.9.0-beta.4-windows-x64
+
+<details>
+
+<summary>展开了解编写者</summary>
+
+主编团队：沐玖芸萱（MuGewRayce）
+
+参与编辑者：JhIcefair（主要）
+
+</details>
+
+<details>
+
+<summary>声明：（点击展开）</summary>
+
+- 目前关于Airi的部分技术性功能和操作在该说明书中不会具体讲解。
+- 主要编辑者仅对说明书的中文版本负责，其他语言版本目前采用ai翻译，而后人工简单修正的方式处理，可能与实际显示的内容不符，请以实际为准。
+- 说明书的大部分内容为主编团队成员自己探索研究出来的，可能与事实不符或者存在偏差，具体请以自己实际体验到的为准。
+- 该说明书可能不会及时更新。
+- 因能力和时间有限，该说明书暂仅包含windows平台通过安装包安装的Airi的部分详细教程。
+- 软件部分位置使用的是英文而且并没有提供翻译，该说明书会尝试翻译涉及到的部分内容，最终译文请以实际为准。
+- airi的版本更新可能会改变部分内容，该说明书仅介绍编写时间前最新的一个版本的特性，对于前后其他版本的程序，如果遇到不同的地方，请自行解决。
+- 如果您有想要添加的说明或者对该说明书有什么疑问，请在Project_Airi官方Discord频道上@jhicefair并留言。
+- 如果您还有别的什么问题，请在Project_Airi官方Discord频道上留言。
+- 祝您玩的开心！AwA
+
+</details>
+
+## 第一章·安装
+
+找到 Project Airi GitHub 主页：[moeru-ai/airi](https://github.com/moeru-ai/airi)
+
+找到位于页面右侧的“**Releases**”选项
+
+点击“+ 68 releases”
+（请注意：中间的数字代表的是发布的其他版本的数量，你看到的可能不是68）
+
+挑一个版本找到下面的“**Assets**”选项并点开
+
+选择适合自己电脑的版本点击下载
+（请注意：由于可选的内容比较多，你可能需要再点击列表最下面的“Show all 19 assets”选项，该选项中间的数字表示包含的可下载文件数量，同样可能不是19）
+
+[ *接下来以windows安装包版本为例* ]
+
+找到你下载下来的安装包双击左键安装
+*（时间原因该部分教程暂跳过，相信你自己可以解决）*
+
+## 第二章·初步配置
+
+### 第一项·先前准备
+
+在一切正式开始前你需要首先至少准备一个LLM服务提供商的API
+
+<details>
+
+<summary>名词解释：（点击展开）</summary>
+
+* LLM
+
+LLM 是“大型语言模型”（Large Language Model）的缩写。
+通俗点讲，一个AI。
+
+* API
+
+API 全称是应用程序编程接口。
+它本质上是一套预先定义好的规则，让不同的软件应用之间可以相互通信、交换数据和功能。
+你可以不用去理解他到底是什么，只要会获取就行。
+
+</details>
+
+[ LLM提供商有很多而且他们的获取方式各不相同，加上时间原因，这里不提供教程或者举例，具体如何获取你可以去网络上搜索或者询问AI ]
+
+获取好API后请注意保存好而且不要告诉其他人！
+
+### 第二项·Airi 启动！
+
+打开Airi（正常情况下安装后会默认自动打开）
+
+在弹出的主界面选择你的语言
+
+点击“**setup with your provider**”
+（不知道为什么这里在新版本中都不提供翻译了，这个的意思是：设置您的提供商）
+
+选中你准备的服务来源并点击“**下一步**”
+
+[ *接下来以Deepseek为例* ]
+
+填入你的 API Key 然后点击“**下一步**”
+
+再点击“**下一步**”
+
+选择你打算使用的模型，然后点击“**保存并继续**”
+
+恭喜你，不出意外的话你已经完成了Airi的初步配置！
+
+## 第三章·Airi界面介绍
+
+### 主窗口
+
+该窗口是展示虚拟角色形象的窗口，有四个选项：
+- “websocket 状态”——位于右上角，点击可打开连接设置，在这里你可以配置您的WebSocket 服务器地址（该功能暂不做具体讲解）
+- “展开”——位于右下角，点击可展开更多选项（具体见下面）
+- “打开听力控制”——位于右下角，点击可以与Airi说话，需要提前配置STT服务（好像也得先打开聊天窗口）（由于该功能我这里暂未成功运行，相关教程暂略）
+- “移动”——位于右下角，鼠标左键长按并拖动可以改变主窗口在桌面上的位置
+
+<details>
+
+<summary>名词解释：（点击展开）</summary>
+
+* websocket
+
+WebSocket 是一种网络通信协议，提供了浏览器与服务器之间的全双工、持久连接。
+简单理解就是传统的 HTTP 是“一问一答”模式（客户端请求，服务器响应，然后断开），
+而 WebSocket 建立连接后，双方可以随时互相发送消息，无需重复发起请求。
+
+* STT
+
+STT 是“语音转文本”（Speech-to-Text）的缩写，也称自动语音识别（ASR）。
+它的目标是让计算机听懂人类的语音，并将其转换成对应的文字。
+
+</details>
+
+点击“展开”选项展开后有八个选项：
+- “打开设置”——可以打开Airi的设置界面
+- “切换角色”——可以切换角色卡（点击后的具体内容因为时间原因暂略）
+- “打开聊天”——可以打开聊天窗口
+- “刷新”——可以刷新主窗口
+- “切换到暗色模式”——可以切换Airi的界面背景为“亮/暗”
+- “取消置顶”——可以使Airi主窗口不再保持置顶显示
+- “总是显示”“悬停时隐藏”——该选项可以使Airi主窗口不影响鼠标光标对窗口下的内容的点击，从而不影响您的工作
+- “关闭”——可以一键关闭Airi
+
+### 系统托盘其他选项
+
+首先，你需要找到Airi在任务栏的小图标
+（在windows平台可能需要你找到任务栏“显示隐藏的图标”点击展开才可以找到）
+
+右键Airi的小图标，你可以看到十个选项：
+- “显示”——可以召唤主窗口，一般用不上
+- “调整大小”——可以调整主窗口的窗口大小，同时也会使主窗口居中。
+其中包括四个选项：“推荐（450x600）”——可以设置为推荐大小450x600；
+“全高”——可以设置使主窗口的高占满桌面的高；
+“半高”——可以设置使主窗口的高为桌面的高的一半；
+“全屏”——可以设置使主窗口填满整个桌面。
+- “对齐到”——可以使主窗口对齐到桌面的特定位置。
+其中包含五个选项：“居中”——可以使主窗口对齐到桌面正中间；
+“左上”——可以使主窗口对齐到桌面左上角；
+“右上”——可以使主窗口对齐到桌面右上角；
+“左下”——可以使主窗口对齐到桌面左下角；
+“右下”——可以使主窗口对齐到桌面右下角。
+- “设置”——可以打开设置界面
+- “关于”——相关说明略
+- “打开快速操作”——相关说明暂略
+- “打开小部件”——相关说明暂略
+- “打开字幕”——可以打开字幕，只有启用TTS服务才能在Airi说话时显示出文字，默认鼠标光标悬停时隐藏
+- “字幕浮窗”，包含两个选项：“跟随窗口”，默认选中该模式，此时字幕窗口位置会跟随主窗口一起移动，取消选中则字幕位置独立；
+“重置位置”，可以使字幕位置重置。
+- “退出”，可以一键关闭Airi
+
+<details>
+
+<summary>名词解释：（点击展开）</summary>
+
+* TTS
+
+TTS 是“文本转语音”（Text-to-Speech）的缩写，旨在让计算机将文字自动转换为自然流畅的语音输出。
+
+</details>
+
+### 设置界面
+
+[ *该部分仅介绍界面有什么，具体功能介绍见第四章* ]
+
+你可以通过主窗口点击“展开”找到打开设置的选项
+也可以通过右键系统托盘中的airi小图标找到打开设置的选项
+
+在这里包括九大内容：
+
+- “AIRI角色卡”——可以选择和配置角色的人设
+- “机体模块”——可以配置Airi的各种功能，
+包括意识、发声、听觉、视觉、短期记忆、长期记忆、Discord、X/twitter、我的世界、异星工厂、MCP服务器、同步音律
+- “场景”——功能暂未发布
+- “角色模型”——可以选择和设置角色的模型
+- “记忆体”——功能暂未发布
+- “服务来源”——可以配置LLM、TTS、STT服务的来源
+- “Data”——译为“数据”，可以管理Airi的各种数据
+- “连接”——可以配置您的WebSocket服务器地址
+- “系统”——里面包括四个选项：“通用”——可以设置程序主题、语言等内容；
+“配色方案”——可以设置主题颜色；
+“窗口快捷方式”——空 [ ***警告：由于该选项内没有任何内容也没有返回键，一旦点进去就需要“关掉并重新打开设置窗口”，所以请不要点击该选项！*** ]；
+“开发者”——包含很多高级功能，详见第四章
+
+### 聊天窗口
+
+你可以通过主窗口点击“展开”找到打开聊天窗口的选项
+
+在这里，你可以和Airi聊天
+详细介绍暂略
+
+## 第四章·设置
+
+你可以通过主窗口点击“展开”找到打开设置的选项
+也可以通过右键系统托盘中的airi小图标找到打开设置的选项
+
+### AIRI角色卡
+
+在这里，你可以上传、创建或者直接修改默认的角色卡。
+
+关于上传，从弹出的窗口来看疑似支持任意文件，但是我没有用过，角色卡也没有导出功能，所以相关介绍略
+
+关于创建新角色卡：
+在这里，你可以设定角色的身份、行为、模块等内容
+
+其中身份部分可以设定角色的名字、昵称、描述、创建者笔记。
+名字即角色正式的名称，如果设定了昵称，那么它会被优先使用。
+描述即关于人设具体的细节，你可以自由发挥，也可以参考默认角色卡
+（请注意：如果你选择参考默认角色卡编写自己角色的设定，其中后半部分关于ACT标签的内容可以不添加）
+关于创建者笔记，我没用过，介绍暂略
+
+行为部分可以设置角色性格、场景（或者理解为周围环境、背景、情境）、问候语，这个部分我没有调整过，介绍暂略
+
+模块部分可以配置角色特定的机体模块，一般不用管，具体介绍略
+
+设置部分可以配置系统提示词、历史提示指令、版本，其中版本是角色卡的版本，这部分前两项内容我没用过，具体介绍暂略
+
+其中最主要的是身份部分的名字和描述，填完后点击“**创建**”即可完成角色卡的创建
+
+最后，点击角色卡右下角的圈或者点击角色卡再点击激活即可启用你创建的角色卡
+[ ***请注意：创建角色卡后默认不启用，必须进行激活才可以启用*** ]
+
+### 机体模块
+
+在这里可以配置Airi的各种功能，具体如下：
+
+#### 意识
+
+首先选中一个服务来源或者添加一个新的服务来源并选中
+[ *如果可选的服务来源太多可能点不到位于后面的服务来源，这时候可以把鼠标光标移动到一个选项卡上按鼠标中键然后左右拖动即可解决问题* ]
+接着选择一个模型并选中即完成配置
+
+#### 发声
+
+首先选中一个服务来源或者添加一个新的服务来源并选中
+[ *如果可选的服务来源太多可能点不到位于后面的服务来源，这时候可以把鼠标光标移动到一个选项卡上按鼠标中键然后左右拖动即可解决问题* ]
+然后选择一个模型并选中
+接着选择一个声线并选中即可完成配置
+或者你也可以选择“无”不使Airi发声
+
+在该页面的最下方可以输入文字测试声音，通过点击“**测试声音**”选项即可生成一段测试音频
+
+[ 请注意：不同服务来源在该页面的配置流程可能略有不同，该处以阿里百炼为例，其他以实际为准 ]
+[ 其中部分服务关于Pitch（即音调）的功能可能无效 ]
+
+其他内容说明暂略
+
+#### 听觉
+
+首先选择你的收音设备（Audio Input Device部分，该英文翻译为“音频输入设备”）
+然后选中一个服务来源或者添加一个新的服务来源并选中
+[ *如果可选的服务来源太多可能点不到位于后面的服务来源，这时候可以把鼠标光标移动到一个选项卡上按鼠标中键然后左右拖动即可解决问题* ]
+接着选择一个模型并选中即可完成配置
+
+除此之外，你还可以启用Auto-send transcribed text（即“自动发送转录文本”）功能以实现自动发送，
+或者默认关闭该功能则可以对转录结果进行调整（应该是这样，我没有成功调用过听觉）
+同时还可以设置Auto-send delay（即“自动发送延迟”）来调整发送延迟。
+
+在该界面的中间部分可以测试麦克风
+点击“**start monitoring**”选项即可开启监听
+你可以调整Sensitivity即灵敏度（我没试过，详细介绍略）
+
+在该界面的最下方可以测试STT功能
+点击“**start speech-to-text**”选项即可开始测试
+在Transcription Result下会显示结果
+
+其他内容说明暂略
+
+#### 视觉
+
+首先选中一个服务来源或者添加一个新的服务来源并选中
+[ *如果可选的服务来源太多可能点不到位于后面的服务来源，这时候可以把鼠标光标移动到一个选项卡上按鼠标中键然后左右拖动即可解决问题* ]
+接着选择一个模型并选中即完成配置
+
+另外，你还可以设置Capture interval即“捕获间隔”来调整捕获的时间间隔
+
+[ ***该功能需要到系统-开发者-vision capture处启动，具体介绍见对应部分*** ]
+
+其他内容说明暂略
+
+#### 短期记忆
+
+功能暂未发布
+
+#### 长期记忆
+
+功能暂未发布
+
+#### Discord
+
+在这里你可以配置Discord机器人使airi进入你的discord服务器与人互动
+你需要获取你的Discord机器人令牌并输入对应位置然后完成配置。
+
+**请注意：**
+该功能需要使用Discord-bot，目前安装包版本暂未内置，需要您去github页面提取相关文件才可以使用，
+由于目前我关于这个内容的日程还很靠后，所以具体教程暂略
+
+#### X/twitter
+
+该功能需要使用bot才可以使用，具体教程暂略
+
+#### 我的世界 minecraft
+
+该功能需要使用bot才可以使用，具体教程暂略
+
+#### 异星工厂 factorio
+
+该功能需要使用bot才可以使用，具体教程暂略
+
+#### MCP服务器
+
+该功能我没用过，具体教程暂略
+
+#### 同步音律
+
+该功能我还在探索当中，具体教程暂略
+
+### 场景
+
+该功能暂未发布
+
+### 角色模型
+
+在这里你可以选择和设置角色的模型
+
+airi支持的模型包括live2D模型和VRM 3D模型
+
+点击“**select model**”选项可以选择模型，在该版本，默认包括两个live2D模型和两个VRM 3D模型可供选择
+选中一个并点击“**confirm**”选项即可切换模型
+另外，你还可以点击“**add**”选项导入自己的live2D模型或者VRM 3D模型
+
+[ **请注意：旧版live2D模型不被支持！请选择包括“*.moc3”的文件！！！** ]
+[ **导入live2D模型前，你需要先将“模型文件夹”压缩为“*.zip”文件才可以导入** ]
+
+- **如果你选择的是live2D模型**
+
+展开“缩放与位置”，你可以调整模型在主窗口中的大小和位置
+其中x为横轴（左右）位置，y为纵轴（上下）位置
+
+展开“parameters（译为“参数”）”，你可以设置live2D模型鼠标追踪、Idle Animation（即“待机动画”）、帧率、Auto Blink（即“自动眨眼”）、
+Force Auto Blink (fallback timer)（即“强制自动闪烁（备用计时器）”）、Shadow（即“影子”）、
+reset to default parameters（译为：“重置为默认参数”）、clear model cache（译为“清除模型缓存”）、
+以及模型涉及的所有参数
+如果想要设置待机动画，请确保模型压缩包中包含动画文件
+其他相关内容介绍暂略
+
+展开“Expressions（译为“表达”）”，你可以启用Expression System（译为“表达系统”）
+该功能我还没有测试，介绍暂略
+
+- **如果你选择的是VRM 3D模型**
+
+展开“场景”，你可以设置Model Position（译为“模型位置”）、视角调整（度）、相机距离（画面缩放）、模型朝向（Y轴旋转）、模型注视方向等内容
+
+该部分内容包括下面的“更换模型”的相关介绍因为时间原因暂略
+
+### 记忆体
+
+功能暂未发布
+
+### 服务来源
+
+在这里，你可以配置LLM、TTS、STT的服务来源
+
+该部分暂略
+
+### Data
+
+在这里，你可以管理Airi的各种数据
+
+［ ***请注意：该部分可以删除清理相关数据且无法恢复，请谨慎操作！！！*** ］
+
+其中第一个方框中可以Open app data folder（译为“打开APP数据文件夹”）
+点击“**Open folder**”选项即可打开
+[ *请注意：该功能目前有bug，会一次性把数据文件夹打开好几次* ]
+
+第二个方框中你可以导入导出聊天记录或者删除所有聊天会话
+（具体介绍略）
+
+第三个方框中你可以删除导入的所有模型或者重置模块偏好设置和凭据
+（具体介绍略）
+
+第四个方框中你可以重置桌面设置和状态
+（具体介绍略）
+
+第五个方框中你可以重置所有提供商设置和凭据或者清除每个本地设置、提供商配置和模型
+（具体介绍略）
+
+### 连接
+
+在这里你可以配置您的WebSocket服务器地址
+
+（具体介绍暂略）
+
+### 系统
+
+#### 通用
+
+在这里，你可以设置程序主题、语言等内容
+
+主题选项默认亮色，点击后面的按钮可以切换到暗色模式
+
+语言选项这里可以设置界面的语言
+
+控制岛图标大小选项这里你可以更改主窗口右下角三个按键的大小
+
+最后，你还可以设置是否允许收集使用数据及崩溃分析或者阅读隐私政策（点击“隐私政策”打开）
+
+#### 配色方案
+
+在这里，你可以更改主题颜色
+
+你可以启动RGB选项来使主题颜色像RGB灯带那样自动变化
+你也可以拖动下方的黑线或者在彩色条中点击来更改主题颜色
+在其下方是颜色效果预览
+
+另外，你还可以直接选择下方的预设来改变主题颜色
+[ ***请注意：你应该点击任意一个圆而不是点击方框*** ]
+
+#### 窗口快捷方式
+
+[ ***警告：由于该选项内没有任何内容也没有返回键，一旦点进去就需要“关掉并重新打开设置窗口”，所以请不要点击该选项！*** ]
+
+#### 开发者
+
+在这里，你可以使用一些高级功能
+
+[ **由于该部分内容大多为英文而且属于一般用不到的高级功能，所以该部分的介绍仅供参考！** ]
+
+- 在第一个方框中你可以点击“**打开**”以打开像浏览器F12那样的开发者工具窗口
+
+- 第二个“Markdown 压力测试”功能介绍暂略
+
+- 第三个“Lag 可视化”功能介绍暂略
+
+- 第四个“是否开启舞台切换动画”功能介绍暂略
+
+- 第五个“是否使用页面特定过场动画”功能介绍暂略
+
+##### useMagicKeys 工具
+
+空白
+暂略
+
+##### useElectronWindowMouse
+
+这里可以检测鼠标光标在电脑屏幕上的位置
+
+##### Displays
+
+这里可以可视化鼠标光标在电脑屏幕上的位置
+
+##### widgets calling
+
+译为“小组件调用”
+暂略
+
+##### Context Flow
+
+译为“上下文流程”
+实时检查传入的上下文更新（服务器 + 广播）和传出的聊天钩子。
+使用此方法验证插件上下文（例如 VSCode 编码上下文）如何传入聊天管道并传出到服务器事件。
+暂略
+
+##### relative mouse
+
+这里可以可视化鼠标光标在该窗口上的位置
+
+##### beat sync visualizer
+
+译为“节拍同步可视化器”即同步音律
+暂略
+
+##### WebSocket Inspector
+
+即“WebSocket 检查器”
+暂略
+
+##### Plugin Host Debug
+
+译为“插件主机调试”
+暂略
+
+##### Screen Capture
+
+译为“屏幕截图”
+在这里你可以捕获任意应用程序窗口或者整个屏幕
+在最上方有四个选项：
+“applications”——译为“应用程序”，可以选择捕获任意一个打开的应用程序的任意一个窗口，点击“**share window**”选项即可在页面最上方查看，
+在页面最上方将鼠标指针移动到捕获界面上点击“stop”即可停止捕获
+“displays”——可以捕获整个屏幕，点击“**share screen**”选项即可在页面最上方查看，在页面最上方将鼠标指针移动到捕获界面上点击“stop”即可停止捕获
+“devices”——译为“设备”，略
+“refetch”——译为“重新获取”，略
+
+##### vision capture
+
+译为“视觉捕捉”
+具体介绍暂略