From 59f8d1bc16ec38d942a8841ae72f378d8500e824 Mon Sep 17 00:00:00 2001 From: icefair Date: Tue, 1 Sep 2026 18:58:26 +0800 Subject: [PATCH] chore(docs): updated setup and use (#2434) --- .../manual/tamagotchi/setup-and-use/index.md | 105 ++++++++++-------- 1 file changed, 60 insertions(+), 45 deletions(-) diff --git a/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use/index.md b/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use/index.md index e5e2d10a6..0a567d1a3 100644 --- a/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use/index.md +++ b/docs/content/zh-Hans/docs/manual/tamagotchi/setup-and-use/index.md @@ -6,8 +6,12 @@ authors: - 沐玖芸萱 - MuGewRayce role: Lead writing team - kind: person - - name: JhIcefair + kind: organization + - name: 凌柃 + aliases: + - 凌柃 + - Icefair + githubUsername: JhIcefair role: Contributing editor (primary) kind: person - name: 0xSelenicDove @@ -16,16 +20,17 @@ authors: kind: person --- -本文对应版本：AIRI-0.11.3 +本文对应版本：AIRI-0.12.0-beta.5 -::: warning 阅读前说明 -- 目前关于 AIRI 的部分技术性功能和操作在该说明书中不会具体讲解。 -- 主要编辑者仅对说明书的中文版本负责，其他语言版本目前采用 AI 翻译 + 人工简单修正的方式处理，可能与实际显示的内容不符，请以实际为准。 +::: info 阅读前说明 +- 关于 AIRI 的部分技术性功能和部分操作在该说明书中不会具体讲解。 +- 主要编辑者仅对说明书的中文版本负责。 +- 主要编辑者仅会对windows桌面端以及部分网页端的特性做讲解。 - 说明书的大部分内容为说明书的主编团队成员自己包括其他参与者经过探索研究出来的，可能与事实不符或者存在偏差，具体请以自己实际体验到的为准。 - 该说明书可能不会及时更新。 -- 因篇幅问题，该说明书暂仅包含桌面端及网页版的部分详细教程。（说明书以桌面端特性为主，网页端大部分特性可以参考直接桌面端，不过请注意两者在部分地方存在差异，具体以实际为准） +- 该说明书涉及到的截图可能不同步。 - 软件部分位置使用的是英文而且并没有提供翻译，该说明书会尝试翻译涉及到的部分内容，最终译文请以实际为准。 -- AIRI 的版本更新可能会改变部分内容，该说明书仅介绍编写时间前最新的一个版本的特性。对于前后其他版本，该说明书可能会保留部分特性的说明，如果遇到不同的地方，请自行解决。 +- 版本更新可能会改变部分内容，该说明书仅介绍编写时间前最新的一个版本的特性。对于前后其他版本，该说明书可能会保留部分特性的说明，如果遇到不同的地方，请自行解决。 - 如果您对本说明书有疑问，欢迎在 [Project AIRI 官方 Discord](https://discord.gg/TgQ3Cu2F7A) 频道中 @jhicefair 或 @0x_selenic_dove 留言。 - 加入微信群：打开仓库的[微信群说明](https://github.com/moeru-ai/airi/blob/main/docs/wechat.md)，扫描其中的二维码添加微信，并备注 `AIRI`；管理员会邀请您入群。您也可在群中 @爱吃吃的哥伦比娅，或通过微信号 `0xColumbina` 联系。 - 加入 QQ 群：打开仓库 README 提供的 [QQ 群邀请链接](https://qun.qq.com/universal-share/share?ac=1&authKey=9g00d%2BZS7nORzcJugNNddJ7rCghZTIR7fhXabGwch2S%2BG%2BKGIKwlN1N2nIqkh2jg&busi_data=eyJncm91cENvZGUiOiIxMDU4MTU2Njk3IiwidG9rZW4iOiJmcnkra1hWNFIxNytEcG0zcHRUdVJIaldlRDFxN0dzK080QWtvTEdOQjJkNEY2eUFta1g1clNpbkxSMS9FQWFYIiwidWluIjoiMTI2MDkwNzMzNSJ9&data=b1eJrwn3GVOUh7YIxZ7l9vHQo99HPmRxKPpMKlDCmfzx8Y57IXb2EZCMaOC9rVTd2U558qpNjwUYUWlPHxVHvg&svctype=4&tempid=h5_group_info)，使用 QQ 确认加入；若链接失效，请以仓库 README 的最新链接为准。 @@ -101,30 +106,30 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在您的设备中 本部分主要展示的是桌面端。网页版/移动端可参考此部分，其它网页版/移动端独有功能在[此处](#chapter-3-main-web)介绍。 -该窗口是展示虚拟角色形象的窗口，共有三个选项： +该窗口是展示虚拟角色形象的窗口，共有五个选项： -- 「展开 ⌃」——位于右下角，点击可展开更多选项（见下文）。 -- 「听觉控制 🎤︎」——位于右下角，点击后可以与 AIRI 说话。 +- 「展开 ⌃」——点击可展开更多选项（见下文）。 +- 「打开聊天」——点击可打开聊天窗口。 +- 「听觉控制 🎤︎」——点击后可以与 AIRI 说话。 ::: info 听力控制说明 点击后会打开“听力输入”面板。先启用麦克风输入并选择麦克风；若系统提示权限请求，请允许 AIRI 使用麦克风。配置语音识别服务后，所说内容会被转写并发送到当前聊天会话。AIRI 正在说话时会暂停收音，以避免把自己的语音再次识别进去。 ::: - -- 「移动 ✥」——位于右下角，鼠标左键长按并拖动即可改变主窗口在桌面上的位置。 +- 「扬声器」——暂略（具体功能暂未测试）。 +- 「移动 ✥」——鼠标左键长按并拖动即可改变主窗口在桌面上的位置。 点击「展开 ⌃」，展开后有九个子选项，从上到下、从左到右依次分别为： - 「登录」——可以登录您自己的AIRI账号。 - 「打开设置」——打开 AIRI 的设置界面。 - 「切换角色」——切换角色卡。 -- 「打开聊天」——打开聊天窗口。 - 「刷新」——刷新主窗口。 -- 「Move to screen center」——将窗口移到屏幕中央。 +- 「移至屏幕中央」——将窗口移到屏幕中央。 - 「切换到暗色模式」——切换 AIRI 的界面背景为「亮 / 暗」。 - 「取消置顶」——使 AIRI 人物模型不再保持置顶显示。 - 「总是显示」/「悬停时隐藏」——使 AIRI 主窗口不影响鼠标光标对窗口下内容的点击，从而不影响您的工作。 - 「关闭」——一键关闭 AIRI。 -![AIRI 主窗口展开后的控制菜单](image-17.png) +![AIRI 主窗口展开后的控制菜单·旧](image-17.png) ### > 系统托盘其他选项 @@ -196,9 +201,9 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在您的设备中 ### > 聊天窗口 -您可以在主窗口点击「展开」，然后选择「打开聊天」来打开聊天窗口。 +您可以在主窗口点击「打开聊天」来打开聊天窗口。 -![AIRI 聊天窗口界面](./assets/manual-chat-window.avif) +![AIRI 聊天窗口界面·旧](./assets/manual-chat-window.avif) 在这里，您可以和 AIRI 聊天。启用语音合成后，AIRI 正在朗读回复时，输入区会出现「停止朗读」按钮；点击它只会停止当前语音播放，不会取消已经生成的文字回复。 @@ -230,7 +235,7 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在您的设备中 3. 根据需要调整模块部分，为角色配置特定的机体模块。 4. 根据需要配置Artistry部分，为角色配置生成图片的功能。 5. 最后检查设置部分，包括系统提示词、历史提示指令和版本。 -6. 确认内容无误后，点击「**创建**」完成角色卡创建。 +6. 确认内容无误后，点击「**保存更改**」或者「**保存并激活**」完成角色卡创建（推荐直接点击后者，可省略第七步直接生效）。 7. 创建完成后，点击角色卡右下角的圈，或者点击角色卡后再点击激活，正式启用这个角色卡。 其中身份部分最重要的是名字和描述： @@ -244,10 +249,6 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在您的设备中 - 行为部分用于补充性格、场景与问候语；模块部分可为该角色指定聊天、视觉、语音和显示模型；Artistry 部分设置该角色的图片生成偏好；设置部分包含系统提示词、历史提示指令和版本信息。 ::: -::: warning 需要手动激活 -创建角色卡后默认不会启用，必须手动激活才可以使用。点击下方的播放按钮即可启用。 -::: - ### > 机体模块 @@ -319,9 +320,12 @@ STT 是「语音转文本」（Speech-to-Text）的缩写，也称自动语音 Vision Capture 是当前的桌面端调试／开发工作流；离开该页面会停止捕获循环。完整说明见[桌面端开发者工具](../../../contributing/desktop-developer-tools#vision-capture)。 ::: +#### > 网络搜索 + +请阅读[网络搜索配置指南](../../config/web-search.md)，配置 Tavily API Key，并了解使用方式、隐私提示和常见问题。 -#### > Artistry (艺术创作) +#### > 绘图 在这里，您可以为 AIRI 配置艺术创作的能力。 @@ -359,10 +363,6 @@ Discord Bot Token、模型 API Key 和语音服务凭据只应保存在本地配 请阅读 [X / Twitter 集成指南](../../../integrations/x.md)，创建并填写 X Developer Platform 应用凭据。不要公开 API Key、API Secret 或访问令牌。 -#### > 网络搜索 - -请阅读[网络搜索配置指南](../../config/web-search.md)，配置 Tavily API Key，并了解使用方式、隐私提示和常见问题。 - #### > 我的世界 Minecraft Minecraft 集成需要从源码运行本地智能体服务。请按照 [Minecraft 智能体集成指南](../../../integrations/minecraft.md) 配置受信任的服务器、AIRI 和模型服务，然后启动智能体。 @@ -403,24 +403,24 @@ MCP（Model Context Protocol）让 AIRI 通过本地进程使用外部工具。 在这里您可以选择和设置角色的模型。 -![AIRI 角色模型设置界面](image-11.png) +![AIRI 角色模型设置界面·旧](image-11.png) -AIRI 支持 Live2D、Spine 2D 和 VRM 3D 模型。 +AIRI 支持 Live2D、VRM 3D、Spine 2D、MMD 和 Tachie 五种模型。 如果您只是想切换现有模型，建议按下面的步骤操作： -1. 点击「**select model**」打开模型选择界面。 +1. 点击「**选择模型**」打开模型选择界面。 2. 在当前版本中，默认可以看到两个 Live2D 模型和两个 VRM 3D 模型。 -3. 选中一个模型后，点击「**confirm**」完成切换。 +3. 选中一个模型后，点击「**确认**」完成切换。 -如果您想导入自己的模型，可以点击「**add**」选择 Live2D、Spine 或 VRM 格式。 +如果您想导入自己的模型，可以点击「**导入**」选择 Live2D、VRM、Spine、MMD 或 Tachie 格式。 ::: info Godot Stage（实验性） 「Switch to Godot Stage (Experimental)」会启动独立的 Godot 舞台渲染器；再次点击「Back to Built-in Stage」可切回内置舞台。Godot Stage 目前只支持 VRM 模型。启动并选定 VRM 后，可以在 Godot View 中调整相机 X/Y/Z、偏航、俯仰和视野角；状态或模型加载错误会显示在该区域。 ::: ::: warning 导入模型前请注意 -- 旧版 Live2D 模型不被支持，请选择包括「\*.moc3」的文件。 +- 旧版 Live2D 模型可能不被支持，请尽量选择包括「\*.moc3」的文件。 - 导入 Live2D 模型前，您需要先将「模型文件夹」压缩为「\*.zip」文件才可以导入。 - Spine 模型也需要以「\*.zip」导入；VRM 使用单个「\*.vrm」文件。 ::: @@ -430,14 +430,15 @@ AIRI 支持 Live2D、Spine 2D 和 VRM 3D 模型。 您可以继续按下面的顺序调整： 1. 展开「缩放与位置」，调整模型在主窗口中的大小和位置。其中 x 为横轴（左右）位置，y 为纵轴（上下）位置。 -2. 展开「parameters」（译为「参数」），继续设置鼠标追踪、Idle Animation（即「待机动画」）、帧率、Auto Blink（即「自动眨眼」）、Force Auto Blink (fallback timer)（即「强制自动闪烁（备用计时器）」）、Shadow（即「影子」）、reset to default parameters（译为「重置为默认参数」）、clear model cache（译为「清除模型缓存」）以及模型涉及的所有参数。 -3. 如果想要设置待机动画，请确保模型压缩包中包含动画文件。 -4. 如果还需要表情功能，可以再展开「Expressions」（译为「表达」）启用 Expression System（译为「表达系统」）。 +2. 展开「动画」，你可以设置动作驱动器（包含通用和MAGIC两种）、鼠标跟踪、空闲眼部动作、眨眼及模式还有空闲动画，如果选择MAGIC驱动器，您还可以选择配置（包括**空闲/平静**和**说话/兴奋**两种内置配置）、是否忽略生成的嘴部开合、强制视线朝前，请注意，MAGIC驱动在展示模型全身时表现会比较差，会出现整个模型上下晃动的情况，这是开发者参考neuro以及vts的工作逻辑经过考虑后设定的**正常情况**，推荐启用MAGIC驱动时仅展示模型的半身。 +3. 展开「模型参数」，可以设置渲染缩放、帧率（FPS）、投影、重置为默认参数、清除模型缓存以及模型涉及的各种参数。 +4. 请注意，如果想要设置待机动画，请确保模型压缩包中包含动画文件。 +5. 如果还需要表情功能，可以再展开「表情」启用「表情系统」。 启用语音合成时，AIRI 会在朗读结束后自动恢复 Live2D 的嘴部状态。 ::: info 参数与表情 -模型可用的参数、待机动画和表情由模型文件本身决定。启用 Expression System 后，只会显示该模型实际提供的表情；若没有表情或动画文件，对应选项不会产生效果。 +模型可用的参数、待机动画和表情由模型文件本身决定。启用表情系统后，只会显示该模型实际提供的表情；若没有表情或动画文件，对应选项不会产生效果。 ::: #### > 如果您选择的是 Spine 2D 模型 @@ -465,6 +466,7 @@ Spine 模型提供独立的设置面板。您可以调整缩放、X/Y 位置、 您可以按用途选择分类： - **聊天**：配置让 AIRI 回复消息的 LLM；这是开始使用 AIRI 的必要配置。 +- **视觉**：让AIRI能看见图片。 - **语音合成（TTS）**：让 AIRI 朗读回复；随后在“机体模块 → 发声”中选择模型和音色。 - **语音识别（ASR/STT）**：把麦克风语音转换为文字；随后在“机体模块 → 听觉”中选择模型。 - **艺术创作**：配置图片生成服务；随后在“机体模块 → Artistry”中使用。 @@ -501,8 +503,6 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在当前设备的 ![AIRI 数据设置界面](image-14.png) -"Move desktop window to center" 译为“将桌面窗口移到中心”。 - ::: tip 网页版特性说明 打开应用数据文件夹和重置桌面设置和状态仅在桌面版可用，网页/移动版 App 不可用。 ::: @@ -571,7 +571,7 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在当前设备的 ### > 网页版主界面 -![AIRI 网页端界面](./assets/manual-main-web.avif) +![AIRI 网页端界面·旧](./assets/manual-main-web.avif) 在这里，您可以看到您的角色模型，您还可以直接与之对话。 @@ -590,9 +590,8 @@ API Key、AccessKey Secret 和其他服务凭据只应保存在当前设备的 - 上半部分是显示和记录聊天记录的区域 - 下半部分是输入框，在这里，您可以通过打字的方式与角色对话 -在下半部分的下方有三个按钮：（文本内容仅供参考） +在下半部分的下方有两个按钮：（文本内容仅供参考） -- 对话（可以管理对话，不同对话之间相互独立） - 发送方式（可以选择通过什么方式确认发送消息） - 开启语音输入 @@ -628,18 +627,30 @@ Flux 是 AIRI 官方服务使用的余额单位。登录后可查看当前余额 ##### > 下方区域 -包括四个选项：（文本内容仅供参考） +包括六个选项：（文本内容仅供参考） +- 对话 +- 静音语音 - 位置及大小 - 删除聊天记录 - 切换亮暗 - 背景 +###### > 对话 + +在这里，你可以管理对话。 + +请注意：**不同对话之间相互独立**。 + +###### > 静音语音 + +暂略 + ###### > 位置及大小 点击后，您会在选项左边看见新出现的三个选项 x、y、scale 以及网页界面左边竖着的条，其中 x 即模型x轴位置，y 即模型y轴位置，scale即模型缩放（大小），您可以通过**点击并拖动**网页界面左边竖着的条来调整这三个参数。 -![主界面调整位置和大小](./assets/web-position-size.avif) +![主界面调整位置和大小·旧](./assets/web-position-size.avif) ###### > 删除聊天记录 @@ -671,6 +682,10 @@ Flux 是 AIRI 官方服务使用的余额单位。登录后可查看当前余额 - 「websocket 状态」——位于右上角，点击可打开连接设置，在这里您可以配置您的 WebSocket 服务器地址 + +### > 特性H4-1-1 + +在之前的版本中，创建完角色卡后必须手动激活。 ## > 写在最后——致·所有想参与说明书编写工作的朋友