chore(docs): introduced new 0.10.2 features (#1816)

docs/content/en/docs/manual/tamagotchi/setup-and-use/index.md

@@ -7,28 +7,21 @@ authors:
   - name: JhIcefair
     role: Contributing editor (primary)
     kind: person
-publishedAt: 2026-05-05
-publishedAtOverride: May 5, 2026 – evening (UTC+8)
+publishedAt: 2026-05-11
+publishedAtOverride: May 11, 2026 – afternoon (UTC+8)
 ---
 
-Corresponding version: AIRI-0.10.1-windows-x64-setup
-
-::: info Authors
-Lead writing team: MuGewRayce
-
-Contributing editor: JhIcefair (primary)
-:::
+Corresponding version: AIRI-0.10.2
 
 ::: warning Before You Start
 - 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.
-- Please note that the images included in this manual have been added by non-Mujiu Yunxuan Studio members. Due to technical reasons, these images will not be updated promptly. We appreciate your understanding.
+- The main editor is only responsible for the Chinese version of the manual. Other language versions are currently handled using AI translation with simple manual corrections, and may not match the actual displayed content. Please refer to the actual content.
 - Most of the content in this manual has been explored and researched by the editor-in-chief’s team members themselves, as well as other participants. It may not be consistent with the facts or may contain deviations. Please rely on your own actual experience as the final reference.
 - This manual may not be updated in a timely manner.
-- Due to limitations of capability and time, this manual currently only includes some detailed tutorials for AIRI installed via the installation package on the Windows platform.
+- Due to limitations in capability and time, this manual currently only includes the Windows installation package version and some detailed tutorials for the web version.
 - 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.
+- The version updates of AIRI may change some content. This manual only introduces the features of the latest version at the time of writing. For other versions before or after, this manual may retain some feature descriptions; if there are differences, please handle them yourself.
+- If you have any questions about this manual, please @jhicefair and leave a message on the official Project AIRI Discord channel.
 - For any other questions, please leave a message on the official Project AIRI Discord channel.
 - Have fun! AwA
 :::
@@ -54,6 +47,8 @@ Contributing editor: JhIcefair (primary)
   - [Data](#chapter-4-data)
   - [Connection](#chapter-4-connection)
   - [System](#chapter-4-system)
+- [Web Version Feature Additions](#web-features)
+- [Historical Characteristics & Common Issues](#features-issues)
 - [Written at the End](#chapter-ed-toeveryeditor)
 
 <a id="chapter-1-installation"></a>
@@ -112,23 +107,13 @@ Once you have your API, keep it safe and do not share it with others.
 The steps below use Deepseek as the example provider.
 :::
 
-::: tip Regarding a possible bug during the initial startup and the solution
-The first time you start the application, you may encounter this bug: the main interface border flickers, and when you click to expand the pop-up menu, it quickly retracts…
-
-If you encounter this bug, don't worry—you can resolve it by following the steps below (but you'll need to be quick with your clicks):
-
-First, click to expand at the exact moment when the flickering border goes dark.
-
-Then quickly find the first option in the second row, 'Refresh', and click it. This will solve the problem.
-
-This bug has not been fixed in recent versions. We will continue to report this issue to the development team and believe it will be resolved soon!
-:::
+[Historical Characteristics: Bugs at Startup](#h2-2-1)
 
 Follow these steps to finish the first-time setup:
 
 1. Open Airi (normally it opens automatically after installation).
 2. Select your language in the main window.
-3. Click "**setup with your provider**", alternatively, click on "**Login**" (Due to time constraints, the process for choosing to log in is not explained here. We appreciate your understanding!).
+3. Click "**setup with your provider**", alternatively, click on "**Login**" (A brief note on the process of choosing to log in).
 4. Select your service source and click "**Next**".
 5. Enter your API Key and click "**Next**".
 6. Click "**Next**" again.
@@ -140,11 +125,12 @@ Congratulations! You have completed the initial configuration of Airi.
 ## Chapter 3 – Airi Interface Overview
 
 <a id="chapter-3-main-window"></a>
-### Main Window
+### > Main Window
 
-This window displays the virtual character. There are three buttons:
+[Introduction to the Main Interface of the Web Version](#chapter-3-main-web)
+
+This window displays the virtual character. There are three buttons: [Historical characteristics](#h3-1-1)
 
-- "websocket status" – top right, click to open connection settings where you can configure your WebSocket server address (This option has been removed in the current version.).
 - "Expand" – bottom right, click to reveal more options (see below).
 - "Open hearing control" – bottom right, allows you to speak to Airi. Requires an STT service.
 - "Move" – bottom right, long-press and drag to reposition the main window.
@@ -156,18 +142,13 @@ It seems you also need to open the chat window first. Since this feature has not
 :::
 
 ::: info Terminology
-* 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.
 :::
 
-Click "Expand" to reveal nine options:
+Click "Expand" to reveal nine options: **(Login button & Eight small buttons)**
 
 - "Login" – You can log in to your own Airi account.
 - "Open settings" – opens the settings window.
@@ -182,7 +163,7 @@ Click "Expand" to reveal nine options:
 ![Airi expanded controls menu](./assets/manual-controls-island-expanded.avif)
 
 <a id="chapter-3-system-tray"></a>
-### System Tray Other Options
+### > System Tray Other Options
 
 First, locate the Airi icon in the system tray.
 
@@ -221,7 +202,7 @@ TTS stands for Text-to-Speech, which converts written text into natural-sounding
 :::
 
 <a id="chapter-3-settings-overview"></a>
-### Settings Window
+### > Settings Window
 
 ::: info Scope
 This section only describes what the window contains. Detailed functions are explained in Chapter 4.
@@ -255,7 +236,7 @@ This option currently has no content and no back button. Once you enter it, you
 ![Airi settings window overview](./assets/manual-settings-window.avif)
 
 <a id="chapter-3-chat-window"></a>
-### Chat Window
+### > Chat Window
 
 You can open the chat window by clicking "Expand" on the main window and selecting "Open chat".
 
@@ -272,7 +253,7 @@ You can open settings in either of these ways:
 - Right-click the Airi tray icon and select "Settings".
 
 <a id="chapter-4-airi-card"></a>
-### AIRI Character Card
+### > AIRI Character Card
 
 Here you can upload, create, or modify the default character card.
 
@@ -308,13 +289,13 @@ Newly created cards are not enabled by default. You must activate them manually.
 :::
 
 <a id="chapter-4-modules"></a>
-### Body Modules
+### > Body Modules
 
 Here you can configure various Airi functions, as follows:
 
 ![Airi body modules settings window](./assets/manual-modules.avif)
 
-#### Consciousness
+#### > Consciousness
 
 Recommended order:
 
@@ -327,7 +308,7 @@ If there are too many sources and you cannot click the ones at the back, move th
 
 ![Airi consciousness settings window](./assets/manual-consciousness.avif)
 
-#### Vocalization
+#### > Vocalization
 
 ::: tip Vocalization Notes
 - The configuration process may vary slightly for different service sources. This section uses Alibaba Bailian as an example; follow the actual interface.
@@ -345,7 +326,7 @@ Recommended order:
 
 ![Airi vocalization settings window](./assets/manual-speech.avif)
 
-#### Hearing
+#### > Hearing
 
 ::: tip Too Many Service Sources
 If there are too many sources and you cannot click the ones at the back, move the mouse over a tab, press the middle mouse button, and drag left or right.
@@ -379,7 +360,7 @@ If you want to test STT:
 1. Click "**start speech-to-text**" at the bottom of the page.
 2. Check the result under "Transcription Result".
 
-#### Vision
+#### > Vision
 
 ::: tip Too Many Service Sources
 If there are too many sources and you cannot click the ones at the back, move the mouse over a tab, press the middle mouse button, and drag left or right.
@@ -397,7 +378,7 @@ Recommended order:
 This function requires enabling `vision capture` in `System → Developer → vision capture`. See that section for details.
 :::
 
-#### Artistry
+#### > Artistry
 
 ::: tip Too Many Service Sources
 If there are too many sources and you cannot click the ones at the back, move the mouse over a tab, press the middle mouse button, and drag left or right.
@@ -410,15 +391,15 @@ Please note: This feature is different from **Neuro's drawing logic** — it gen
 Due to time constraints, this section will not be explained in detail for now.
 
 
-#### Short-term Memory
+#### > Short-term Memory
 
 Not yet released.
 
-#### Long-term Memory
+#### > Long-term Memory
 
 Not yet released.
 
-#### Discord
+#### > Discord
 
 Here you can configure a Discord bot so that Airi can join your Discord server and interact.
 
@@ -432,28 +413,28 @@ Recommended order:
 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 the editor's schedule for this is a low priority, the full tutorial is omitted.
 :::
 
-#### X/Twitter
+#### > X/Twitter
 
 Similar to Discord; requires a bot. Tutorial omitted.
 
-#### Minecraft
+#### > Minecraft
 
 Requires a bot. Tutorial omitted.
 
-#### Factorio
+#### > Factorio
 
 Requires a bot. Tutorial omitted.
 
-#### MCP Server
+#### > MCP Server
 
 The editor has not used this. Tutorial omitted.
 
-#### Rhythm Game
+#### > Rhythm Game
 
 The editor is still exploring this. Tutorial omitted.
 
 <a id="chapter-4-stage"></a>
-### Scene
+### > Scene
 
 Here, you can configure Airi's main interface scene—simply put, the background of Airi's main interface.
 
@@ -464,7 +445,7 @@ You can also click "**Upload to Gallery**" to import your own image scene.
 If you need to clear the scene, click "**Clear Default**".
 
 <a id="chapter-4-character-model"></a>
-### Character Model
+### > Character Model
 
 Here you can choose and set the character's model.
 
@@ -489,7 +470,7 @@ Regarding the "Switch to Godot Stage (Experimental)" option—since the manual's
 - Before importing a Live2D model, compress the model folder into a "\*.zip" file.
 :::
 
-#### If you choose a Live2D model
+#### > If you choose a Live2D model
 
 You can continue in this order:
 
@@ -502,7 +483,7 @@ You can continue in this order:
 The editor has not fully tested this part yet, so details are still limited.
 :::
 
-#### If you choose a VRM 3D model
+#### > If you choose a VRM 3D model
 
 Expand "Scene" and then set Model Position, camera angle (degrees), camera distance (zoom), model orientation (Y-axis rotation), model gaze direction, and related values.
 
@@ -511,12 +492,12 @@ This section, including "Change model", is omitted due to time constraints.
 :::
 
 <a id="chapter-4-memory-bank"></a>
-### Memory Bank
+### > Memory Bank
 
 Not yet released.
 
 <a id="chapter-4-providers"></a>
-### Service Sources
+### > Service Sources
 
 Here you can configure Chat(LLM), Speech(TTS), Transcription(STT), Artistry service sources.
 
@@ -542,12 +523,12 @@ In addition, you can filter all services by criteria such as Pricing and Deploym
 The configuration interfaces for some services may not function properly due to a lack of timely maintenance. If you encounter a similar issue, please submit an issue on GitHub, or try configuring via the "OpenAI Compatible API" option (if your chosen service source supports it).
 :::
 
-::: info Editor Note
-Details omitted.
+::: tip Technical advice
+There are currently many AI models on the market. While AIRI cannot provide individual support for all of them, nor can it guarantee real-time maintenance, it is recommended that you consider the **OpenAI compatible API** option. If your model supports OpenAI's compatible API, you can choose to configure it here.
 :::
 
 <a id="chapter-4-data"></a>
-### Data
+### > Data
 
 Here you can manage Airi's various data.
 
@@ -569,8 +550,12 @@ This page is organized into boxes:
 4. The fourth box allows you to reset desktop settings and state.
 5. The fifth box allows you to reset all provider settings and credentials, or clear every local setting, provider configuration, and model.
 
+::: tip Web Version Feature Description
+The above parts 1 and 4 do not exist on the web page.
+:::
+
 <a id="chapter-4-connection"></a>
-### Connection
+### > Connection
 
 Here you can configure your WebSocket server address.
 
@@ -581,9 +566,9 @@ Details omitted.
 :::
 
 <a id="chapter-4-system"></a>
-### System
+### > System
 
-#### General
+#### > General
 
 Here you can set the program theme, language, etc.
 
@@ -594,7 +579,7 @@ Here you can set the program theme, language, etc.
 - 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
+#### > Color Scheme
 
 Here you can change the theme color.
 
@@ -609,13 +594,13 @@ Here you can change the theme color.
 Click on one of the circles, not the square box.
 :::
 
-#### Window Shortcuts
+#### > Window Shortcuts
 
 ::: warning Do Not Open
 This option has no content and no back button. Once you enter it, you must close and reopen the settings window. Do not click it.
 :::
 
-#### Developer
+#### > Developer
 
 Here you can use some advanced features.
 
@@ -634,57 +619,57 @@ First box and its related options:
 - The fifth "Enable stage transition animation" – details omitted.
 - The sixth "Use page-specific cutscenes" – details omitted.
 
-##### useMagicKeys tool
+##### > useMagicKeys tool
 
 ::: info Editor Note
 The page is currently blank; details omitted.
 :::
 
-##### useElectronWindowMouse
+##### > useElectronWindowMouse
 
 Here you can detect the mouse cursor position on the screen.
 
 ![Airi useElectronWindowMouse tool window](./assets/manual-devtools-use-window-mouse.avif)
 
-##### Displays
+##### > Displays
 
 Here you can visualize the mouse cursor position on the screen.
 
 ![Airi Displays tool window](./assets/manual-devtools-displays.avif)
 
-##### widgets calling
+##### > widgets calling
 
 ![Airi widgets calling tool window](./assets/manual-devtools-widgets-calling.avif)
 
-##### Context Flow
+##### > 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.
 
 ![Airi Context Flow tool window](./assets/manual-devtools-context-flow.avif)
 
-##### relative mouse
+##### > relative mouse
 
 Here you can visualize the mouse cursor position within this window.
 
 ![Airi relative mouse tool window](./assets/manual-devtools-relative-mouse.avif)
 
-##### beat sync visualizer
+##### > beat sync visualizer
 
 ![Airi beat sync visualizer tool window](./assets/manual-devtools-beat-sync.avif)
 
-##### WebSocket Inspector
+##### > WebSocket Inspector
 
 ![Airi WebSocket Inspector tool window](./assets/manual-devtools-websocket-inspector.avif)
 
-##### Plugin Host Debug
+##### > Plugin Host Debug
 
 ![Airi Plugin Host Debug tool window](./assets/manual-devtools-plugin-host.avif)
 
-##### Updater
+##### > Updater
 
 Detailed introduction omitted for now.
 
-##### Screen Capture
+##### > Screen Capture
 
 If you have not granted system-level screen capture permission yet, you will first see a permission prompt like the screenshot below. After granting permission, you can capture any application window or the entire screen.
 
@@ -697,14 +682,133 @@ There are four options at the top:
 
 ![Airi Screen Capture tool window](./assets/manual-devtools-screen-capture.avif)
 
-##### vision capture
+##### > vision capture
 
 If screen capture permission has not been granted yet, this page will also show a permission prompt first. After granting permission, the page can start capturing frames and show the vision processing result.
 
 ![Airi vision capture tool window](./assets/manual-devtools-vision-capture.avif)
 
+<a id="web-features"></a>
+## > Web Version Feature Supplement
+
+<a id="chapter-3-main-web"></a>
+### > Web Version Main Interface
+
+![Airi Web Interface](./assets/manual-main-web.avif)
+
+Here, you can see your character model and talk directly to it.
+
+Broadly, it is divided into three parts:
+
+- Character model space
+- Chat box
+- Others
+
+Below, we focus on the chat box and the other parts.
+
+#### > Chat Box
+
+The chat box is divided into two sections:
+
+- The upper section is the area that displays and records the conversation history
+- The lower section is the input box, where you can type to converse with the character
+
+Below the lower section, there are three buttons: (text for reference only)
+
+- Conversations (manage conversations; conversations are independent of each other)
+- Send method (choose how to confirm sending a message)
+- Enable voice input
+
+#### > Other Parts
+
+##### > Top Area
+
+Includes three options:
+
+- About
+- Character Card
+- Account & Settings
+
+The third option contains three main sections:
+
+- Account info
+- Profile, Flux, Settings
+- Log out
+
+###### > Profile
+
+If you are logged into Airi, you can manage your account information here.
+
+Details omitted.
+
+###### > Flux
+
+Relevant instructions omitted for now.
+
+###### > Settings
+
+Same as the desktop version settings; see [Chapter 4](#chapter-4-settings) for details.
+
+##### > Bottom Area
+
+Includes four options: (text for reference only)
+
+- Position & Size
+- Delete Chat History
+- Toggle Light/Dark
+- Background
+
+###### > Position & Size
+
+After clicking, you will see three new options on the left side of the option: x, y, scale, as well as a vertical bar on the left side of the web interface. Here, x refers to the model's x-axis position, y refers to the model's y-axis position, and scale refers to the model's zoom (size). You can adjust these three parameters by **clicking and dragging** the vertical bar on the left side of the web interface.
+
+![Adjust position and size on the main interface](./assets/web-position-size.avif)
+
+###### > Delete Chat History
+
+Click to clear all chat history with one click.
+
+::: warning Proceed with caution
+Deleted chats cannot be recovered, so please operate with care!
+:::
+
+###### > Toggle Light/Dark
+
+Switch the interface between "Light" or "Dark" theme.
+
+###### > Background
+
+Change the background of the main interface.
+
+<a id="features-issues"></a>
+## > Historical Characteristics & Common Issues
+
+### > Common Issues
+
+- When upgrading from an older version to version 0.10.2, if you have previously changed the size and position of the model, your model may 'disappear'. If you encounter this problem, please do not worry. You can solve it by resetting the model's scale and position in the model settings interface.
+
+<a id="h2-2-1"></a>
+### > Characteristics H2-2-1
+
+The first time you start the application, you may encounter this bug: the main interface border flickers, and when you click to expand the pop-up menu, it quickly retracts…
+
+If you encounter this bug, don't worry—you can resolve it by following the steps below (but you'll need to be quick with your clicks):
+
+First, click to expand at the exact moment when the flickering border goes dark.
+
+Then quickly find the first option in the second row, 'Refresh', and click it. This will solve the problem.
+
+* This feature has been fixed!
+
+<a id="h3-1-1"></a>
+### > Characteristics H3-1-1
+
+In some of the past versions, an option could also be seen in the top right corner of the main window:
+
+- "websocket status" – top right, click to open connection settings where you can configure your WebSocket server address.
+
 <a id="chapter-ed-toeveryeditor"></a>
-## Written at the End
+## > Written at the End
 
 This manual is primarily written by non-official personnel but submitted to the official website. Although content maintenance is usually handled by members of the Mujiu Yunxuan Studio, we sincerely hope that all friends who wish to edit this document or have already edited it will leave your name in the author section at the beginning. Whether you make content changes or formatting adjustments, we welcome everyone to join us in enriching and optimizing this manual, contributing your own strength—from anyone—to the Airi project and to this manual!
 

docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use/index.md

@@ -10,22 +10,21 @@ authors:
   - name: JhIcefair
     role: Contributing editor (primary)
     kind: person
-publishedAt: 2026-05-05
-publishedAtOverride: 2026 年 5 月 5 日 - 晚上（北京时间）
+publishedAt: 2026-05-11
+publishedAtOverride: 2026 年 5 月 11 日 - 下午（北京时间）
 ---
 
-对应版本：AIRI-0.10.1-windows-x64-setup
+对应版本：AIRI-0.10.2 (windows)
 
 ::: warning 阅读前说明
 - 目前关于 AIRI 的部分技术性功能和操作在该说明书中不会具体讲解。
-- 主要编辑者仅对说明书的中文版本负责，其他语言版本目前采用 AI 翻译，而后人工简单修正的方式处理，可能与实际显示的内容不符，请以实际为准。
-- 请注意，该说明书中包含的图片为非沐玖芸萱工作室成员添加，由于技术原因，所有图片暂不会得到及时更新，还请见谅！
+- 主要编辑者仅对说明书的中文版本负责，其他语言版本目前采用 AI 翻译 + 人工简单修正的方式处理，可能与实际显示的内容不符，请以实际为准。
 - 说明书的大部分内容为说明书的主编团队成员自己包括其他参与者经过探索研究出来的，可能与事实不符或者存在偏差，具体请以自己实际体验到的为准。
 - 该说明书可能不会及时更新。
-- 因能力和时间问题，该说明书暂仅包含 Windows 平台通过安装包安装的 AIRI 的部分详细教程。
+- 因能力和时间问题，该说明书暂仅包含 Windows 安装包版本以及网页版的部分详细教程。（说明书以桌面端特性为主，网页端大部分特性可以参考直接桌面端，不过请注意两者在部分地方存在差异，具体以实际为准）
 - 软件部分位置使用的是英文而且并没有提供翻译，该说明书会尝试翻译涉及到的部分内容，最终译文请以实际为准。
-- AIRI 的版本更新可能会改变部分内容，该说明书仅介绍编写时间前最新的一个版本的特性，对于前后其他版本的程序，如果遇到不同的地方，请自行解决。
-- 如果您有想要添加的说明或者对该说明书有什么疑问，请在 Project AIRI 官方 Discord 频道上 @jhicefair 并留言。
+- AIRI 的版本更新可能会改变部分内容，该说明书仅介绍编写时间前最新的一个版本的特性。对于前后其他版本，该说明书可能会保留部分特性的说明，如果遇到不同的地方，请自行解决。
+- 如果您对该说明书有什么疑问，请在 Project AIRI 官方 Discord 频道上 @jhicefair 并留言。
 - 如果您还有别的什么问题，请在 Project AIRI 官方 Discord 频道上留言。
 - 祝您玩的开心！AwA
 :::
@@ -51,6 +50,8 @@ publishedAtOverride: 2026 年 5 月 5 日 - 晚上（北京时间）
   - [数据（Data）](#chapter-4-data)
   - [连接](#chapter-4-connection)
   - [系统](#chapter-4-system)
+- [网页版特性补充](#web-features)
+- [历史特性 & 常见问题](#features-issues)
 - [写在最后](#chapter-ed-toeveryeditor)
 
 <a id="chapter-1-installation"></a>
@@ -112,27 +113,13 @@ LLM 提供商有很多，而且它们的获取方式各不相同。由于篇幅
 下面的步骤以 Deepseek 为例进行演示。
 :::
 
-::: tip 关于每次启动的一个可能的bug以及处理办法
-每次启动时，您都有可能遇到这样的bug：主界面边框闪烁，点击展开弹出的菜单会很快收回……
-
-如果遇到这个bug，请不要担心，按照如下流程可以解决：（不过你需要足够的手速）
-
-首先，等闪烁的边框熄灭的瞬间点击展开；
-
-快速找到第二行第一个选项“刷新”然后点击即可解决问题。
-
-该bug在最近的几个版本中均未修复，我们会持续向开发者团队反馈这个问题，相信很快它就能得到解决！
-:::
-
-::: tip 界面翻译说明
-「setup with your provider」的意思是「设置您的提供商」。
-:::
+[历史特性 之 启动时的bug](#h2-2-1)
 
 建议按下面的步骤完成初始配置：
 
 1. 打开 Airi（正常情况下安装后会默认自动打开）。
 2. 在弹出的主界面选择你的语言。
-3. 点击「**配置您自己的AI服务来源**」或者点击「**登录**」（由于时间原因，关于选择登录的流程暂不做讲解，还请见谅！）。
+3. 点击「**配置您自己的AI服务来源**」或者点击「**登录**」（关于选择登录的流程略）。
 4. 选中你准备的服务来源，然后点击「**下一步**」。
 5. 填入你的 API Key，然后点击「**下一步**」。
 6. 再点击一次「**下一步**」。
@@ -144,11 +131,12 @@ LLM 提供商有很多，而且它们的获取方式各不相同。由于篇幅
 ## 第三章·Airi 界面介绍
 
 <a id="chapter-3-main-window"></a>
-### 主窗口
+### > 主窗口
 
-该窗口是展示虚拟角色形象的窗口，共有三个选项：
+[网页版主界面介绍](#chapter-3-main-web)
+
+该窗口是展示虚拟角色形象的窗口，共有三个选项：[历史特性](#h3-1-1)
 
-- 「websocket 状态」——位于右上角，点击可打开连接设置，在这里你可以配置你的 WebSocket 服务器地址（在当前版本该选项已被移除）。
 - 「展开」——位于右下角，点击可展开更多选项（见下文）。
 - 「打开听力控制」——位于右下角，点击后可以与 Airi 说话，需要提前配置 STT 服务。
 - 「移动」——位于右下角，鼠标左键长按并拖动即可改变主窗口在桌面上的位置。
@@ -160,14 +148,6 @@ LLM 提供商有很多，而且它们的获取方式各不相同。由于篇幅
 :::
 
 ::: info 名词解释
-* websocket
-
-WebSocket 是一种网络通信协议，提供了浏览器与服务器之间的全双工、持久连接。
-
-简单理解就是传统的 HTTP 是「一问一答」模式（客户端请求，服务器响应，然后断开），
-
-而 WebSocket 建立连接后，双方可以随时互相发送消息，无需重复发起请求。
-
 * STT
 
 STT 是「语音转文本」（Speech-to-Text）的缩写，也称自动语音识别（ASR）。
@@ -175,7 +155,7 @@ STT 是「语音转文本」（Speech-to-Text）的缩写，也称自动语音
 它的目标是让计算机听懂人类的语音，并将其转换成对应的文字。
 :::
 
-点击「展开」选项展开后有九个子选项：
+点击「展开」选项展开后有九个子选项：**（登陆按钮 + 八个小按钮）**
 
 - 「登录」——可以登录您自己的Airi账号。
 - 「打开设置」——打开 Airi 的设置界面。
@@ -190,7 +170,7 @@ STT 是「语音转文本」（Speech-to-Text）的缩写，也称自动语音
 ![Airi 主窗口展开后的控制菜单](./assets/manual-controls-island-expanded.avif)
 
 <a id="chapter-3-system-tray"></a>
-### 系统托盘其他选项
+### > 系统托盘其他选项
 
 首先，你需要找到 Airi 在任务栏的小图标。
 
@@ -229,7 +209,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 :::
 
 <a id="chapter-3-settings-overview"></a>
-### 设置界面
+### > 设置界面
 
 ::: info 本节范围
 该部分仅介绍界面里有什么，具体功能介绍见第四章。
@@ -244,7 +224,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 
 - 「AIRI 角色卡」——选择和配置角色的人设。
 - 「机体模块」——配置 Airi 的各种功能，包括意识、发声、听觉、视觉、短期记忆、长期记忆、Discord、X / Twitter、我的世界、异星工厂、MCP 服务器、同步音律。
-- 「场景（Scenes）」——配置Airi的场景（背景）。
+- 「场景」——配置Airi的场景（背景）。
 - 「角色模型」——选择和设置角色的模型。
 - 「记忆体」——功能暂未发布。
 - 「服务来源」——配置 LLM、TTS、STT、Artistry 服务的来源。
@@ -263,7 +243,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 ![Airi 设置界面总览](./assets/manual-settings-window.avif)
 
 <a id="chapter-3-chat-window"></a>
-### 聊天窗口
+### > 聊天窗口
 
 你可以在主窗口点击「展开」，然后选择「打开聊天」来打开聊天窗口。
 
@@ -280,7 +260,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 - 右键系统托盘中的 Airi 小图标，选择「设置」。
 
 <a id="chapter-4-airi-card"></a>
-### AIRI 角色卡
+### > AIRI 角色卡
 
 在这里，你可以上传、创建或者直接修改默认的角色卡。
 
@@ -316,13 +296,13 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 :::
 
 <a id="chapter-4-modules"></a>
-### 机体模块
+### > 机体模块
 
 在这里可以配置 Airi 的各种功能，具体如下：
 
 ![Airi 机体模块设置界面](./assets/manual-modules.avif)
 
-#### 意识
+#### > 意识
 
 建议按下面的步骤完成配置：
 
@@ -335,7 +315,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 
 ![Airi 意识设置界面](./assets/manual-consciousness.avif)
 
-#### 发声
+#### > 发声
 
 ::: tip 发声页补充说明
 - 不同服务来源在该页面的配置流程可能略有不同，该处以阿里百炼为例，其他以实际界面为准。
@@ -353,7 +333,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 
 ![Airi 发声设置界面](./assets/manual-speech.avif)
 
-#### 听觉
+#### > 听觉
 
 ::: tip 服务来源过多时
 如果可选的服务来源太多，可能点不到位于后面的服务来源。这时候可以把鼠标光标移动到一个选项卡上，按鼠标中键后左右拖动。
@@ -387,7 +367,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 1. 在界面的最下方点击「**start speech-to-text**」开始测试。
 2. 然后在 Transcription Result 下查看识别结果。
 
-#### 视觉
+#### > 视觉
 
 ::: tip 服务来源过多时
 如果可选的服务来源太多，可能点不到位于后面的服务来源。这时候可以把鼠标光标移动到一个选项卡上，按鼠标中键后左右拖动。
@@ -405,7 +385,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 该功能需要先到「系统 → 开发者 → vision capture」处启动，具体介绍见对应部分。
 :::
 
-#### Artistry
+#### > Artistry
 
 ::: tip 服务来源过多时
 如果可选的服务来源太多，可能点不到位于后面的服务来源。这时候可以把鼠标光标移动到一个选项卡上，按鼠标中键后左右拖动。
@@ -419,15 +399,15 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 
 由于时间原因，该部分内容暂不做具体讲解。
 
-#### 短期记忆
+#### > 短期记忆
 
 功能暂未发布。
 
-#### 长期记忆
+#### > 长期记忆
 
 功能暂未发布。
 
-#### Discord
+#### > Discord
 
 在这里你可以配置 Discord 机器人，使 Airi 进入你的 Discord 服务器与人互动。
 
@@ -441,28 +421,28 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 该功能需要使用 Discord 机器人，目前安装包版本暂未内置，需要你去 GitHub 页面提取相关文件才可以使用。由于编辑者关于这部分内容的日程还很靠后，具体教程暂略。
 :::
 
-#### X / Twitter
+#### > X / Twitter
 
 该功能需要使用机器人才可以使用，具体教程暂略。
 
-#### 我的世界（Minecraft）
+#### > 我的世界（Minecraft）
 
 该功能需要使用机器人才可以使用，具体教程暂略。
 
-#### 异星工厂（Factorio）
+#### > 异星工厂（Factorio）
 
 该功能需要使用机器人才可以使用，具体教程暂略。
 
-#### MCP 服务器
+#### > MCP 服务器
 
 该功能编辑者没用过，具体教程暂略。
 
-#### 同步音律
+#### > 同步音律
 
 该功能编辑者还在探索当中，具体教程暂略。
 
 <a id="chapter-4-stage"></a>
-### 场景（Scenes）
+### > 场景（Scenes）
 
 在这里，你可以配置Airi主界面的场景——你可以简单将其理解为Airi主界面的背景。
 
@@ -473,7 +453,7 @@ TTS 是「文本转语音」（Text-to-Speech）的缩写，旨在让计算机
 如果你需要清除场景，请点击「**Clear Default**」。
 
 <a id="chapter-4-character-model"></a>
-### 角色模型
+### > 角色模型
 
 在这里你可以选择和设置角色的模型。
 
@@ -498,7 +478,7 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 - 导入 Live2D 模型前，你需要先将「模型文件夹」压缩为「\*.zip」文件才可以导入。
 :::
 
-#### 如果你选择的是 Live2D 模型
+#### > 如果你选择的是 Live2D 模型
 
 你可以继续按下面的顺序调整：
 
@@ -511,7 +491,7 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 该功能编辑者也还没有完整测试，其他相关内容介绍暂略。
 :::
 
-#### 如果你选择的是 VRM 3D 模型
+#### > 如果你选择的是 VRM 3D 模型
 
 你可以先展开「场景」，然后设置 Model Position（译为「模型位置」）、视角调整（度）、相机距离（画面缩放）、模型朝向（Y 轴旋转）、模型注视方向等内容。
 
@@ -520,12 +500,12 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 :::
 
 <a id="chapter-4-memory-bank"></a>
-### 记忆体
+### > 记忆体
 
 功能暂未发布。
 
 <a id="chapter-4-providers"></a>
-### 服务来源
+### > 服务来源
 
 在这里，你可以配置 Chat（LLM）、Speech（TTS）、Transcription（STT）、Artistry 的服务来源。
 
@@ -551,12 +531,12 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 部分服务的配置界面可能因为没有得到及时维护而无法正常使用，如果您遇到了类似问题，请在 GitHub 提交 Issue，或者也可以尝试选择「**OpenAI 兼容 API**」选项进行配置（如果您准备的服务来源支持的话）。
 :::
 
-::: info 编辑者补充
-该部分具体介绍暂略。
+::: tip 技术性建议
+目前市面上的AI模型非常多，固然AIRI无法全部做单独支持，另外也无法保证实时维护，所以建议您可以考虑 **OpenAI 兼容 API** 选项，如果您的模型支持 OpenAI 的兼容 API，可以选择在这里配置。
 :::
 
 <a id="chapter-4-data"></a>
-### 数据（Data）
+### > 数据（Data）
 
 在这里，你可以管理 Airi 的各种数据。
 
@@ -578,8 +558,12 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 4. 第四个方框可以重置桌面设置和状态。
 5. 第五个方框可以重置所有提供商设置和凭据，或者清除每个本地设置、提供商配置和模型。
 
+::: tip 网页版特性说明
+上述1、4两部分内容在网页端不存在
+:::
+
 <a id="chapter-4-connection"></a>
-### 连接
+### > 连接
 
 在这里你可以配置你的 WebSocket 服务器地址。
 
@@ -590,9 +574,9 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 :::
 
 <a id="chapter-4-system"></a>
-### 系统
+### > 系统
 
-#### 通用
+#### > 通用
 
 在这里，你可以设置程序主题、语言等内容。
 
@@ -603,7 +587,7 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 - 控制岛图标大小选项可以更改主窗口右下角三个按键的大小。
 - 最后，你还可以设置是否允许收集使用数据及崩溃分析，或者阅读隐私政策（点击「隐私政策」打开）。
 
-#### 配色方案
+#### > 配色方案
 
 在这里，你可以更改主题颜色。
 
@@ -618,13 +602,13 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 这里应该点击任意一个圆，而不是点击方框。
 :::
 
-#### 窗口快捷方式
+#### > 窗口快捷方式
 
 ::: warning 请勿打开
 由于该选项内没有任何内容也没有返回键，一旦点进去就需要「关掉并重新打开设置窗口」，所以请不要点击该选项。
 :::
 
-#### 开发者
+#### > 开发者
 
 在这里，你可以使用一些高级功能。
 
@@ -632,6 +616,8 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 
 ::: info 高级功能说明
 该部分内容大多为英文，而且属于一般用不到的高级功能，因此下面的介绍仅供参考。
+
+另外关于网页版，由于该部分与桌面端相差较大且通常用不到，故暂略
 :::
 
 第一个方框及其相关选项：
@@ -643,67 +629,67 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 - 第五个「是否开启舞台切换动画」功能介绍暂略。
 - 第六个「是否使用页面特定过场动画」功能介绍暂略。
 
-##### useMagicKeys 工具
+##### > useMagicKeys 工具
 
 ::: info 编辑者补充
 页面当前为空白，介绍暂略。
 :::
 
-##### useElectronWindowMouse
+##### > useElectronWindowMouse
 
 这里可以检测鼠标光标在电脑屏幕上的位置。
 
 ![Airi useElectronWindowMouse 工具界面](./assets/manual-devtools-use-window-mouse.avif)
 
-##### Displays
+##### > Displays
 
 这里可以可视化鼠标光标在电脑屏幕上的位置。
 
 ![Airi Displays 工具界面](./assets/manual-devtools-displays.avif)
 
-##### widgets calling
+##### > widgets calling
 
 译为「小组件调用」。
 
 ![Airi widgets calling 工具界面](./assets/manual-devtools-widgets-calling.avif)
 
-##### Context Flow
+##### > Context Flow
 
 译为「上下文流程」。实时检查传入的上下文更新（服务器 + 广播）和传出的聊天钩子。使用此方法验证插件上下文（例如 VSCode 编码上下文）如何传入聊天管道并传出到服务器事件。
 
 ![Airi Context Flow 工具界面](./assets/manual-devtools-context-flow.avif)
 
-##### relative mouse
+##### > relative mouse
 
 这里可以可视化鼠标光标在该窗口上的位置。
 
 ![Airi relative mouse 工具界面](./assets/manual-devtools-relative-mouse.avif)
 
-##### beat sync visualizer
+##### > beat sync visualizer
 
 译为「节拍同步可视化器」，即同步音律。
 
 ![Airi beat sync visualizer 工具界面](./assets/manual-devtools-beat-sync.avif)
 
-##### WebSocket Inspector
+##### > WebSocket Inspector
 
 即「WebSocket 检查器」。
 
 ![Airi WebSocket Inspector 工具界面](./assets/manual-devtools-websocket-inspector.avif)
 
-##### Plugin Host Debug
+##### > Plugin Host Debug
 
 译为「插件主机调试」。
 
 ![Airi Plugin Host Debug 工具界面](./assets/manual-devtools-plugin-host.avif)
 
-##### Updater
+##### > Updater
 
 译为「更新程序」。
 
 具体介绍暂略。
 
-##### Screen Capture
+##### > Screen Capture
 
 译为「屏幕截图」。
 
@@ -718,7 +704,7 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 
 ![Airi Screen Capture 工具界面](./assets/manual-devtools-screen-capture.avif)
 
-##### vision capture
+##### > vision capture
 
 译为「视觉捕捉」。
 
@@ -726,8 +712,128 @@ Airi 支持的模型包括 Live2D 模型和 VRM 3D 模型。
 
 ![Airi vision capture 工具界面](./assets/manual-devtools-vision-capture.avif)
 
+<a id="web-features"></a>
+## > 网页版特性补充
+
+<a id="chapter-3-main-web"></a>
+### > 网页版主界面
+
+![Airi 网页端界面](./assets/manual-main-web.avif)
+
+在这里，你可以看到您的角色模型，您还可以直接与之对话。
+
+大体上，这里分为三个部分：
+
+- 角色模型空间
+- 聊天框
+- 其他
+
+下面重点介绍聊天框和其他部分的界面。
+
+#### > 聊天框
+
+聊天框分为上下两部分：
+
+- 上半部分是显示和记录聊天记录的区域
+- 下半部分是输入框，在这里，你可以通过打字的方式与角色对话
+
+在下半部分的下方有三个按钮：（文本内容仅供参考）
+
+- 对话（可以管理对话，不同对话之间相互独立）
+- 发送方式（可以选择通过什么方式确认发送消息）
+- 开启语音输入
+
+#### > 其他部分
+
+##### > 上方区域
+
+包括三个选项：
+
+- 关于
+- 角色卡
+- 账号及设置
+
+在第三个选项中包含三大块内容：
+
+- 账号信息
+- 档案、Flux、设置
+- 登出
+
+###### > 档案
+
+如果您登陆了Airi，在这里您可以管理您的账号信息。
+
+具体介绍略
+
+###### > Flux
+
+相关说明暂略
+
+###### > 设置
+
+同桌面端设置，详见[第四章](#chapter-4-settings)
+
+##### > 下方区域
+
+包括四个选项：（文本内容仅供参考）
+
+- 位置及大小
+- 删除聊天记录
+- 切换亮暗
+- 背景
+
+###### > 位置及大小
+
+点击后，你会在选项左边看见新出现的三个选项 x、y、scale 以及网页界面左边竖着的条，其中 x 即模型x轴位置，y 即模型y轴位置，scale即模型缩放（大小），你可以通过**点击并拖动**网页界面左边竖着的条来调整这三个参数。
+
+![主界面调整位置和大小](./assets/web-position-size.avif)
+
+###### > 删除聊天记录
+
+点击即可一键清除全部聊天记录
+
+::: warning 谨慎操作
+点击删除无法恢复，请谨慎操作！
+:::
+
+###### > 切换亮暗
+
+可以切换界面“亮色”或者“暗色”
+
+###### > 背景
+
+可以更改主界面的背景
+
+<a id="features-issues"></a>
+## > 历史特性 & 常见问题
+
+### > 常见问题
+
+- 从旧版本升级到0.10.2版本时，如果您曾经改动过模型的大小和位置，你的模型可能会“消失”，当遇到该问题时，请不要着急，在模型设置界面重置模型的缩放和位置即可解决。
+
+<a id="h2-2-1"></a>
+### > 特性H2-2-1
+
+每次启动时，您都有可能遇到这样的bug：主界面边框闪烁，点击展开弹出的菜单会很快收回……
+
+如果遇到这个bug，请不要担心，按照如下流程可以解决：（不过你需要足够的手速）
+
+首先，等闪烁的边框熄灭的瞬间点击展开；
+
+快速找到第二行第一个选项“刷新”然后点击即可解决问题。
+
+* 该特性已被修复！
+
+<a id="h3-1-1"></a>
+### > 特性H3-1-1
+
+在过去的其中几个版本中，主窗口右上角还可以看到一个选项：
+
+- 「websocket 状态」——位于右上角，点击可打开连接设置，在这里你可以配置你的 WebSocket 服务器地址
+
+
 <a id="chapter-ed-toeveryeditor"></a>
-## 写在最后——致·所有想参与说明书编写工作的朋友
+## > 写在最后——致·所有想参与说明书编写工作的朋友
 
 该说明书作为一个主要由非官方人员编写但被提交到官方网站的文档，虽然通常由沐玖芸萱工作室成员负责内容维护，但是我们非常希望所有想编辑该文档或者已经编辑过该文档的朋友能在开头的作者位置留下您的名字，无论您做出的是内容上的改动还是格式上的改动，我们欢迎大家来一同丰富和优化该说明书，为Airi项目、为该说明书贡献一份来自任何人的**自己的力量**！