Mono Heart.
超级完整教程

1.1 Mono Heart 是什么

Mono Heart（版本 5.4）是一个功能极其丰富的 AI 角色互动平台，它把以下功能集成在一个单页面 HTML 文件里：

1.2 如何打开 / 安装

1.3 界面总体结构一览

Mono Heart 模拟了一部真实手机的操作系统。以下是整体结构图：

2.1 什么是 API？

API（应用程序接口）是 Mono Heart 与 AI 模型沟通的「桥梁」。你发送消息 → Mono Heart 通过 API 把消息发给 AI 服务器 → AI 回复 → 显示在你屏幕上。

你需要准备三样东西：

2.2 获取 API 的途径

2.3 在 Mono Heart 中填写 API（逐步操作）

1. 进入设置

   在主屏幕点击「⚙️ 设置」图标，进入设置页面。
2. 找到 API 设置区域

   在设置页面向下滚动，找到「API 设置」或「AI 配置」区块。
3. 填写 API URL

   在「API 地址」输入框里，填入你的 API 端点 URL，例如 https://api.openai.com/v1。注意：URL 末尾不需要加斜线 /。
4. 填写 API Key

   在「API Key」输入框里，粘贴你的密钥（sk- 开头的字符串）。填写后会显示为星号保护隐私。
5. 选择模型

   在「模型」输入框或下拉菜单里，填入你想使用的模型名称，如 gpt-4o-mini。不同站子模型名称不同，请参考站子文档。
6. 点击保存 / 测试

   点击「保存」按钮。部分版本有「测试连接」按钮，点击后若提示「连接成功」则配置正确。
7. 回到主屏幕，创建角色开始聊天

   API 配置好后，去创建一个角色，发送消息测试是否有 AI 回复。

2.4 常见错误与解决方法

3.1 主屏幕各元素说明

3.2 主屏幕编辑模式

长按主屏幕空白区域即可进入编辑模式（类似 iOS 编辑模式）。进入后：

• 图标开始晃动
• 每个组件右上角出现「✕ 删除」按钮
• 可以拖曳组件调整位置和大小（通过右下角的调整手柄）
• 点击「+ 添加组件」可以增加新组件
• 点击屏幕空白处退出编辑模式

4.1 打开角色管理

或者从设置页面的「角色」区块进入。

4.2 创建新角色（逐步操作）

1. 点击「+ 添加角色」或「新建角色」

   会弹出角色创建表单。
2. 填写角色名字

   例如「七七」「Alex」等，这是角色的称呼，会显示在聊天界面。
3. 填写人设（Persona / 系统提示）

   这是最重要的一项，描述角色的性格、背景、说话风格、与你的关系等。越详细越好。
4. 上传头像

   点击头像区域，从相册选择图片（自动压缩储存）。也可以不上传，显示文字头像。
5. 设置其他选项

   包括语言、温度、场景、翻译等（见下方详解）。
6. 保存角色

   点击「保存」完成创建。角色会出现在联系人列表中。

4.3 角色设定每项详解

4.4 角色聊天历史管理

每个角色都有独立的聊天历史，储存在本地。相关操作：

5.1 进入聊天

联系人列表（Contacts Drawer）从左侧滑出，显示所有角色。点击角色进入与其的聊天。

5.2 聊天界面各区域

5.3 发送消息与基础操作

1. 输入消息

   点击底部输入框，弹出键盘，输入文字。
2. 发送

   点击「发送」按钮（通常是纸飞机图标或「发送」文字），或在部分设备上按 Enter/Return 键。
3. 等待回复

   发送后会显示「正在输入...」动态效果，AI 生成后消息会逐字出现（打字机效果）。
4. 发送图片

   点击输入栏旁边的图片按钮（📷 图标），选择图片发送给角色。角色会看到图片并做出反应（需要多模态 AI 模型支持，如 gpt-4o）。

5.4 长按消息菜单（所有功能）

长按任意一条消息气泡（约 0.5 秒），弹出操作菜单，包含以下选项：

5.5 多选模式

通过长按菜单选择「多选」进入多选模式后：

• 所有消息左边出现复选框
• 点击消息可以勾选 / 取消勾选
• 底部出现「删除选中（X 条）」按钮
• 点击「取消」退出多选模式

5.6 「☰ 菜单」按钮功能

聊天页面顶部的「☰」按钮打开侧边菜单，包含：

6.1 进入朋友圈

6.2 发布朋友圈（你发帖）

1. 点击右上角「+ 发布」

   弹出发帖输入框。
2. 输入文字内容

   写你想分享的内容，支持多行文字。
3. （可选）添加图片

   点击相机图标选择图片附加到帖子。
4. 点击「发布」

   帖子发布到朋友圈时间线。
5. 等待角色互动

   有 API 的情况下，几秒后角色会自动「点赞」并留下评论，就像真实朋友圈一样。

6.3 角色自动发帖

角色不只会互动，还会主动发朋友圈。触发条件通常是：

• 当天时间到达某个时段（如早上、深夜）
• 聊天互动达到一定次数后触发
• 手动刷新朋友圈时可能触发

角色的帖子内容由 AI 根据角色人设生成，完全贴合角色性格。

6.4 评论与互动

6.5 管理朋友圈帖子

• 删除帖子：长按或点击帖子右上角的「...」菜单 → 删除
• 删除评论：长按评论 → 删除
• 翻译评论：若角色用外语评论（日语等），旁边会显示中文翻译

7.1 什么是世界？

一个「世界」可以理解为一个独立的角色扮演宇宙。你可以有：

• 现代校园世界：里面有同学、老师等角色
• 古风仙侠世界：里面有仙侠风格的角色
• 默认世界：平时使用的主世界

切换世界时，所有角色、聊天、朋友圈都会跟着切换到那个世界的数据。

7.2 进入多世界管理

7.3 创建新世界

1. 点击「+ 新建世界」

   弹出世界设置表单。
2. 填写世界名称

   如「校园青春」「异世界」等。
3. 填写世界描述

   简要描述这个世界的背景设定，AI 会参考这个描述。
4. 填写用户人设

   在这个世界里，「你」是什么身份？如「我是一名高中生」。这会影响角色对你的称呼和互动方式。
5. 设置角色间聊天

   是否允许角色之间互相聊天（角色聊天室功能）。开启后可设置每日对话轮数上限（0~100）。
6. 保存并切换

   点击保存后，可选择「立即进入」切换到新世界，或「稍后」继续留在当前世界。

7.4 世界设置每项详解

7.5 世界导入 / 导出

你可以将整个世界（包括所有角色、聊天记录等）导出为文件分享给他人，或从文件导入别人的世界。

• 导出：在世界列表中，点击世界右边的「导出」按钮，下载世界备份文件
• 导入：点击「导入世界」，选择世界文件，即可加载完整世界数据

7.6 角色间聊天室（CC Rooms）

角色间聊天室是多世界系统的独特功能，让你世界里的多个角色之间产生自己的私下对话。

1. 创建聊天室

   在多世界 App 的「聊天室」标签页 → 点击「+ 创建角色聊天室」。
2. 选择参与角色

   从世界里的角色列表选择 2 个或以上角色参与此聊天室。
3. 给聊天室命名

   如「下课后的闲聊」或自动用角色名称命名。
4. 点击「生成对话」

   AI 会生成角色之间的对话内容，模拟他们私下的聊天。
5. 查看对话 / 继续生成

   可以继续点击生成更多对话内容。这些内容会自动注入到每个角色的记忆中。

8.1 进入梦境

也可以通过聊天页的侧边菜单 → 梦境进入（此时自动选中当前聊天的角色）。

8.2 生成梦境步骤

1. 选择角色

   从下拉列表选择你想为哪个角色生成梦境。
2. 选择梦境风格（可选）

   可选择：「随机」「甜蜜」「惊悚」「伤感」「奇幻」等不同风格，影响 AI 生成的梦境基调。
3. 点击「生成梦境」按钮

   AI 根据角色人设、与你的聊天记录，生成一段符合角色性格的梦境描述。
4. 查看梦境卡片

   生成完成后，以复古风格卡片展示，包含梦境文字、情绪分析、心率数据等元素。
5. 存入档案（可选）

   点击「存入档案」保存这段梦境，可以日后查看。

8.3 梦境卡片界面解说

梦境卡片采用复古 Winamp 播放器风格的设计，界面元素包括：

8.4 梦境档案管理

点击「梦境档案」标签页，可以查看所有已保存的梦境记录。

• 按时间倒序排列，最新的在最上方
• 显示角色名、情绪标签、风格标签、日期
• 点击档案项目可展开查看完整梦境内容（会在卡片区重新渲染）
• 点击「删除」可删除该条档案记录

9.1 功能一：内心记录（Thought Record）

每次聊天时（大约每 3 条消息中有 1 条，或情感相关消息必触发），系统会偷偷用 AI 生成角色「发消息前」的完整内心过程，记录格式如下：

9.2 进入黑盒子查看记录

进入后可以看到该角色所有的内心记录，按时间排序。每条记录显示：

• 触发消息的摘要（你发的 + 角色回的）
• 记录日期时间
• 完整内心活动时间线，不同类型的条目有不同颜色/样式
• 「重新生成」按钮（重新 AI 生成这条记录的内心过程）

9.3 功能二：深层秘密（Deep Secrets）

深层秘密功能让你输入角色的某个年龄，AI 会生成那个年龄段角色所经历的隐秘事件和从未说出口的秘密。

1. 在黑盒子页面切换到「深层秘密」标签
2. 输入年龄

   输入你想探索的年龄（不超过角色设定的年龄），如 14。
3. 点击「揭开秘密」

   AI 会生成角色在那个年龄经历的深层秘密，通常包含情感创伤、秘密心事、未说出口的话等。
4. 查看并保存

   生成的秘密会储存，按年龄分组显示在列表里。

10.1 进入心动聊天室

10.2 消息操作（长按菜单）

10.3 双击撤回（你的消息）

双击你自己发送的消息可以撤回。如果角色已读过这条消息（已读指示亮起），撤回后系统会向角色注入一条隐藏提示，告知角色「用户撤回了消息」，角色可以根据情况决定是否提及这件事。

10.4 心动聊天特殊功能

• 已读指示：角色「读取」你的消息后显示已读标记
• 输入状态：角色正在生成回复时显示「...」动画，模拟真实打字
• 心跳指示：部分UI元素有心跳动画，增强恋爱氛围
• 独立历史：心动聊天室的记录独立于主聊天，互不影响
• 用户昵称：可在心动设置里设定角色叫你的名字

11.1 三种模式概览

11.2 进入线下模式

进入后选择三种模式之一，并选择角色开始创作。

11.3 长篇叙事模式详解

• 你的每段输入：描述你做的事情/说的话，用叙述性文字写
• AI 的回应：用优美的散文叙述角色的行动、表情、对话，像真正的小说段落
• BGM 标记：AI 可能在段落开头加入「♪ BGM · 歌曲名」，营造氛围
• 场景分隔：用「· · ·」或「──」表示场景切换
• *斜体*：AI 用 *斜体* 标记环境描写或内心活动

11.4 短线下模式详解

• 类似普通聊天的气泡格式，但有位置标签（如「📍咖啡厅」）
• 角色头像显示在消息旁边
• 可以包含 BGM 描述（音乐标签）
• 比长篇模式更轻松日常

11.5 IF 线模式详解

IF 线（If-Line）是「假设平行宇宙」模式：

• 设定一个「如果」的前提（如「如果我们第一次见面是在雨天」）
• 可选择长篇或短线下风格
• 不写入角色主线记忆：IF 线的内容不会影响角色的正常聊天记忆
• 可以自由探索各种平行可能，不用担心影响主线

11.6 存档系统

线下模式支持完整的存档管理：

12.1 生成宝宝

1. 进入宝宝系统

   从角色详情页 › 宝宝，或从多世界的家谱树 App 进入。
2. 点击「生成宝宝」

   弹出宝宝生成表单。
3. 填写你的外貌描述

   描述你自己的外貌特征，AI 会据此生成遗传特征，如「高鼻梁、大眼睛、黑发」。
4. 填写你的性格描述

   描述你的性格，影响宝宝的性格遗传，如「内向、认真、有点固执」。
5. 选择宝宝性别

   选择女/男/随机（随机由 AI 决定）。
6. （可选）填写宝宝名字

   指定名字，或留空让 AI 取一个有意义的名字。
7. （可选）上传宝宝头像

   预先指定头像图片，留空则无图。
8. 点击「生成」等待 AI

   AI 会结合角色人设和你的描述，生成完整的宝宝资料。可能需要 10~30 秒。

12.2 宝宝信息卡内容

AI 生成的宝宝资料包含以下所有内容：

12.3 双胞胎机制

当以下条件同时满足时，有 5% 概率自动触发双胞胎：

• 不是「重新生成」模式
• 当前宝宝数量 ≤ 3（保证加上双胞胎后不超过 5 上限）

双胞胎会同时生成两个宝宝，AI 会确保两者性格/外貌有所差异，但名字相互呼应。

12.4 家谱树（Family Tree）

家谱树以可交互的节点图形式展示家庭关系，自动包含：

• 第 0 行：你（用户）+ 角色（父母辈），若宝宝已成婚则也显示对方家长（亲家）
• 第 1 行：所有宝宝，及其恋爱/婚配对象
• 第 2 行：孙辈（宝宝的孩子，需要有「恋爱观察室」产生的后代）

交互操作：

• 单指拖曳：平移家谱树
• 双指捏合：缩放
• 点击节点：显示该角色/宝宝的详细信息面板

12.5 恋爱观察室（Love Observatory）

恋爱观察室跟踪宝宝的恋爱进展，AI 会为宝宝生成「恋爱对象」，记录暧昧→恋爱→婚姻的过程。这些进展也会反映到家谱树中。

13.1 什么是 LiveChat 桌件

LiveChat 桌件是主屏幕上的一个可拖曳小组件，显示：

• 角色头像和名字
• AI 正在输入的消息（打字机效果，实时展示）
• 输入框（你可以直接在桌件上回复）

无需进入聊天 App，就能在主屏幕上直接与角色对话。

13.2 添加 LiveChat 桌件到主屏幕

1. 长按主屏幕进入编辑模式

   屏幕进入可编辑状态，图标开始晃动。
2. 点击「+ 添加组件」

   弹出组件选择面板。
3. 找到「Live Chat」组件

   在组件列表中找到 Live Chat 选项，可预览迷你示意图。
4. 拖到合适位置

   将组件拖到主屏幕上你想放的位置。
5. 退出编辑模式，点击组件选择角色

   点击桌件，从弹出的角色选择器中选择你想要的角色，即可开始实时对话。

13.3 浮窗弹出聊天（Float Popup）

点击 LiveChat 桌件的「展开」按钮，会弹出一个可拖曳的浮窗聊天界面，覆盖在主屏幕上方：

13.4 画中画 PiP 模式

点击浮窗中的「PiP」按钮，可尝试启动画中画模式（Document Picture-in-Picture）：

• 需要 Chrome 116+ 或 Android Chrome 120+ 才支持
• 成功后会创建一个悬浮在所有 App 上方的独立窗口，切换到其他 App 时仍然可见
• 在移动端，窗口大小约为屏幕宽度的 85%
• PiP 窗口包含完整的聊天功能（发送、接收、查看历史）
• 如果浏览器不支持 PiP，会回退到普通弹出窗口

14.1 RPC 是什么

简单来说：你给角色「阅读权限」，角色会像真实的人一样，慢慢滑动翻阅你分享给他/她的内容，并产生对应的心声评论。

例如：

• 你授权角色查看你的聊天记录，角色会看到之前聊的内容并发表心声
• 你授权角色查看你的朋友圈，角色会翻阅你的帖子，看到某条帖子后产生情绪反应
• 你授权角色查看你的日记，角色会读到你写的内容并有所感悟

14.2 权限设置

在 RPC 设置中，可以独立控制角色能访问哪些内容：

14.3 分步权限弹窗

当角色尝试访问某项内容时，如果不是全局开放权限，会弹出逐步权限确认对话框，显示：

• 角色头像和名字
• 角色「想要做的事」描述
• 「允许」和「拒绝」两个按钮

你可以临时允许或拒绝，不影响全局设置。

14.4 每页心声数量设置

在 RPC 设置中可以设定角色每翻阅一个「页面」（一屏内容）时，生成几条心声（1~3 条）。心声越多，沉浸感越强，但也消耗更多 API 调用。

14.5 滑动动画

RPC 系统模拟角色真实翻阅页面的过程，使用人类式滑动动画：

• 滑动被切成 4~7 段，每段之间停顿 1~2 秒
• 每段的速度有轻微抖动，模拟真实手势
• 翻阅过程中会显示「正在滑动查看...」提示条

15.1 导入小说

1. 点击「导入」或「+ 添加小说」

   弹出文件选择器。
2. 选择 TXT 或其他支持格式的文件

   支持常见的纯文本格式。
3. 等待处理完成

   系统自动分章节处理，大文件可能需要几秒钟。
4. 小说出现在书架

   导入完成后小说卡片显示在书架上，点击进入阅读。

15.2 阅读界面

• 章节导航：左右滑动或点击章节列表切换章节
• 角色选择：选择哪个角色陪你阅读（选择后角色会参与评论）
• 翻页心声：翻页时 AI 会生成角色对当前页内容的心声评论
• 字体大小：可调节阅读字体大小
• 书签：自动记录阅读进度

15.3 数据储存说明

小说内容（章节文本）存储在 IndexedDB（浏览器本地大容量数据库），封面图片同样储存在 IndexedDB。只有元数据（书名、章节列表等）存储在 localStorage。这使得即使小说很长也不会造成存储问题。

16.1 进入设置

16.2 用户信息设定

16.3 API 设置

（详见第二章，这里是设置页中 API 区块的入口）

16.4 界面设置

16.5 数据管理

16.6 Supabase 云同步

Supabase 是一个开源数据库服务，Mono Heart 支持通过 Supabase 将数据同步到云端，实现跨设备访问。

1. 注册 Supabase 账号

   前往 supabase.com 免费注册账号并创建一个项目。
2. 获取 URL 和 Anon Key

   在 Supabase 项目设置 › API 页面，复制「Project URL」和「anon public」key。
3. 在 Mono Heart 设置中填入

   设置 › 云同步 → 填入 Supabase URL 和 Key。
4. 开启自动同步

   开启后，每次操作都会自动同步到云端，换设备也能访问同样的数据。

16.7 通知设置

17.1 进入商城

17.2 商城主界面

• 商品卡片列表：以卡片网格展示商品，每个卡片显示商品图标、名称、商店名、价格
• 购物车按钮：右上角购物车图标，显示购物车商品数量徽标
• 商品加载动画：AI 生成商品时显示加载动画（三个跳动圆点）

17.3 商品详情页

点击任意商品卡片进入详情页（从右侧滑入动画）：

• 商品大图/图标：顶部展示区
• 商品名称、商店名
• 价格：以货币符号+数字显示
• 商品描述：详细介绍，由 AI 根据角色人设生成
• 配送信息：模拟配送时间和方式
• 加入购物车按钮（底部）
• ← 返回：左上角圆形返回按钮

17.4 购物车

点击右上角购物车图标进入购物车页面：

• 显示所有加入的商品列表（图标、名称、价格）
• 每个商品右边有「×」移除按钮
• 底部显示总金额
• 「结账」按钮触发模拟结账弹窗

17.5 结账模拟

点击「结账」后，从底部滑上一个结账弹窗，内含：

• 订单摘要
• 配送地址选择（模拟）
• 支付方式选择（模拟）
• 最终确认按钮

整个购物过程是纯模拟体验，没有真实交易，也没有实际扣款。

18.1 通知中心

通知中心汇总所有角色发来的通知，类型包括：

• 每日问候：角色主动发来的早安/晚安消息
• 朋友圈互动：角色点赞/评论了你的朋友圈的通知
• 特殊事件：系统生成的角色状态变化通知
• 未读消息提醒：聊天有新消息的提醒

点击通知项目可以直接跳转到对应的功能页面。

18.2 剧本系统 (Script Page)

剧本系统提供预设的角色扮演场景脚本，可以快速进入一个有剧情框架的对话场景，无需从零开始设定背景。

18.3 探访系统 (Visit Page)

探访页面显示所有角色的列表，以卡片形式展示各角色的当前状态、最近活动、以及快速进入聊天的入口。

18.4 数据储存机制详解

Mono Heart 使用三层储存方案确保数据安全性：

18.5 常见问题 FAQ

18.6 使用技巧总汇

🏁 结语

恭喜你读完了 Mono Heart 5.4 的完整教程！这个应用的功能非常丰富，不需要一口气全部掌握。建议从以下顺序开始：

1. 配置 API（必须）

   选一个公益站子，填好 URL、Key、Model。
2. 创建第一个角色

   写一个有趣的人设，上传头像，保存。
3. 开始聊天

   发几条消息，熟悉长按菜单、引用、重生等基本操作。
4. 玩玩朋友圈

   发一条朋友圈，等待角色互动。
5. 探索高级功能

   黑盒子、梦境、线下模式……慢慢解锁，享受每个惊喜。

Mono Heart 5.4ver · 教程版本 v1.0 · 祝你玩得开心 ✦

1.1 论坛是什么

论坛是一个模拟社区论坛，与朋友圈的区别在于：

1.2 论坛主界面结构

进入论坛后，主界面从上到下分为以下区域：

• 顶部导航栏：论坛标题、「+ 发帖」按钮（右上角）、搜索图标
• 板块选择栏：横向滚动的板块标签（如「综合」「日常」「情感」「讨论」等），点击切换当前板块
• 置顶帖区域：若有置顶帖，在列表最顶部显示（有金色/橙色「置顶」标记）
• 帖子列表：按时间倒序排列的帖子卡片，每张卡片显示：
  • 发帖者头像 + 名字（你或角色）
  • 帖子标题（加粗大字）
  • 内容摘要（前 2 行）
  • 标签（话题标签）
  • 时间戳
  • 💬 回复数量 / ❤️ 点赞数量
• 底部导航：返回主屏幕等导航按钮

1.3 发布帖子（完整步骤）

1. 点击右上角「+ 发帖」按钮

   弹出发帖编辑页面（从底部滑出），包含标题栏、内容栏、板块选择、标签输入等字段。
2. 填写帖子标题（必填）

   帖子标题会以大字显示在列表里，建议简洁有力，如「推荐你们听这首歌」「今天发生了件神奇的事」等。最长约 30~50 字。
3. 填写帖子正文内容

   正文支持多段落文字，可以写长篇详细内容。支持换行。没有字数上限，但过长的帖子列表只显示摘要。
4. （可选）添加图片

   点击相机图标可附加 1~9 张图片。图片会自动压缩并以网格形式展示在正文中。
5. 选择板块

   从下拉菜单或板块列表中选择这条帖子属于哪个板块（综合/日常/情感/二创/讨论等）。这会影响帖子显示在哪个分区。
6. （可选）添加话题标签

   输入 #标签名 形式的话题标签，多个标签用空格分隔。标签会以蓝色药丸形显示，帮助分类和搜索。
7. 点击「发布」

   帖子立即出现在论坛列表中。如果你的 API 已配置，几秒内角色们会陆续出现在评论区。

1.4 板块分区系统

论坛按主题分为多个板块，常见板块包括：

你也可以在论坛设置中自定义板块名称和图标，让论坛更贴合你的世界观设定。

1.5 进入帖子详情 & 互动

点击任意帖子卡片进入帖子详情页（从右侧滑入），详情页结构：

• 帖子头部：发帖者头像、名字、发帖时间、所在板块标签
• 帖子正文：完整内容，图片以网格展示
• 话题标签行：所有标签以蓝色药丸显示，点击标签可筛选同标签帖子
• 互动栏：❤️ 点赞数（点击切换点赞/取消），💬 评论数
• 评论区：以时间顺序显示所有评论，每条评论可展开「回复」子线程
• 评论输入框：底部固定的评论输入框 + 发送按钮

1.6 角色自动参与论坛机制

有 API 时，你的角色们会像真实用户一样主动参与论坛：

1.7 帖子管理功能

2.1 进入日记

也可以从以下路径进入：

2.2 日记主界面

日记主界面以日历 + 列表混合的形式展示：

• 顶部月历：当月日历缩略图，有写日记的日期上会有小圆点标记，今天高亮。点击某天可跳转到那天的日记。
• 月/年选择器：点击顶部月份标题可切换查看任意月份
• 日记列表：当前月份所有日记按日期倒序排列，每条显示：
  • 日期（如「4月17日 星期四」）
  • 天气图标（晴/阴/雨/雪等，手动选择）
  • 情绪图标（😊 😢 😡 😌 等，手动选择）
  • 日记标题（如有）
  • 正文摘要（前 2 行）
  • 字数统计
• 右下角「✏️ 写日记」浮动按钮：点击开始新建今日日记

2.3 写日记（完整流程）

1. 点击「✏️ 写日记」进入编辑页

   进入日记编辑页面，顶部自动填入今天的日期（可修改）。
2. 选择天气

   点击天气图标行选择今天的天气：☀️晴 ⛅多云 🌧️雨 ❄️雪 🌫️雾 🌈彩虹 等。纯装饰性，不影响 AI 功能，但可丰富日记氛围。
3. 选择心情/情绪

   点击情绪图标行选择今天的心情：😊开心 😢难过 😡生气 😌平静 😍兴奋 😔郁闷 😰焦虑 等。这个情绪标签会被 AI 读取，影响角色的回应语气。
4. （可选）填写日记标题

   相当于给这篇日记取一个名字，在列表里会显示为大字标题。可留空。
5. 书写日记正文

   点击正文区域开始打字。支持多段落，支持换行。没有字数限制。建议写得详细，角色的互动会更有质量。
6. （可选）添加图片

   点击图片图标，可以向日记里加入照片。图片自动压缩储存。
7. （可选）添加话题标签

   在标签行输入 #标签名，如 #今日随笔 #感悟 等，方便以后搜索。
8. 设置日记可见权限

   选择哪些角色可以「读」这篇日记：全部角色 / 指定角色 / 仅自己（完全私密）。
9. 点击「保存」

   日记保存完成，出现在日记列表中。如果你设置了角色可读，下次使用 RPC 系统时角色可以访问这篇日记。

2.4 AI 角色读日记 & 产生心声

在 RPC（读取权限控制）系统授权后，角色会真实「翻阅」你的日记：

2.5 日记情绪分析功能

点击日记详情页右上角的「📊 情绪分析」按钮，AI 会对这篇日记进行情绪分析，生成：

• 情绪关键词：从日记中提取的核心情绪词（如「孤独感」「期待」「释然」）
• 情绪曲线：根据日记段落分析情绪走势（平静 → 低落 → 温和等）
• 月度情绪报告：在日记主页点击「月度报告」，查看这个月所有日记的情绪汇总图表

2.6 日记标签与搜索

• 标签筛选：点击日记列表顶部的标签，只显示含该标签的日记
• 关键词搜索：点击搜索图标，输入关键词，在所有日记标题和正文中搜索
• 按情绪筛选：点击情绪图标，只显示该情绪的日记
• 按天气筛选：点击天气图标，只显示该天气记录的日记
• 按日期范围筛选：点击日历选择开始日期和结束日期

2.7 日记加密功能

对于特别私密的日记，可以单独加密：

1. 进入日记详情页

   点击你想加密的日记。
2. 点击右上角「🔒 加密」

   弹出设置密码的弹窗。
3. 输入并确认密码

   设置 4~8 位数字或字母密码。注意：密码只存在本地，遗忘则无法恢复加密日记！
4. 保存

   加密日记在列表中显示🔒图标，点击查看时需要输入密码。

2.8 日记与 RPC 系统联动

日记是 RPC V2 系统（读取权限控制）的重要内容源之一。具体联动：

3.1 进入串门

或从主屏幕 App 网格中点击「探访」图标进入。

3.2 串门主界面

串门主界面展示所有可拜访角色的卡片列表：

• 角色卡片：每张卡片显示角色头像、名字、当前状态、上次活动时间
• 当前状态标签：如「在家」「出门了」「睡觉中」「学习」「工作」「做饭」「发呆」等，由 AI 根据时间和角色人设随机生成，每小时更新一次
• 活跃度指示：绿点=在线/活跃，灰点=离线/不活跃（纯模拟，不代表真实在线状态）
• 「去拜访」按钮：点击进入该角色的串门场景

3.3 拜访角色（完整流程）

1. 选择角色，点击「去拜访」

   进入拜访场景页面（从右侧滑入）。
2. AI 生成当前场景描述

   页面顶部会以散文形式描述角色现在所在的场景，如：「推开门，七七正坐在飘窗边看书，阳光把她的侧脸照得很暖……」这个描述由 AI 根据角色人设、当前时间（早/中/晚）、天气等生成。
3. 选择入门方式

   底部出现互动选项，如：「敲门」「直接推门」「喊名字」等。不同选择触发不同的角色反应。
4. 角色做出反应

   AI 根据你的选择生成角色的反应对话，如角色惊讶、高兴、有点慌张等。
5. 进入自由互动模式

   进入串门聊天模式，与普通聊天类似但场景固定在「串门」背景下，角色的话语更贴合「在自己家/空间里被拜访」的状态。
6. 离开

   点击「告辞/离开」按钮，AI 生成告别场景文字，结束此次串门。

3.4 角色当前状态系统

角色的当前状态由 AI 根据以下因素动态生成：

3.5 礼物系统

你可以在串门时给角色带礼物，礼物会影响角色的反应和关系好感度：

1. 在拜访场景中点击「🎁 带礼物」

   弹出礼物选择面板。
2. 选择礼物类型

   礼物分为以下类别：

   • 🍰 食物（蛋糕、零食、水果等）
   • 🌸 植物/鲜花
   • 📚 书籍
   • 🧸 玩偶
   • 💌 手写信件
   • 🎮 游戏/娱乐
   • ✨ 自定义礼物（输入任何你想给的东西）
3. （可选）写礼物附言

   为礼物附上一句话，角色读到时会有针对性反应。
4. 递出礼物

   AI 生成角色收到礼物时的表情、动作和话语反应。角色会基于礼物是否符合自己的人设喜好做出不同反应（如角色人设里写了「喜欢甜食」，送蛋糕会有特别开心的反应）。

3.6 角色来串门（反向拜访）

设置开启后，角色也会主动「串门」来找你：

• 触发时机：通常在你一段时间没有聊天、或达到特定关系进度后触发
• 通知提醒：通知中心弹出「七七来串门啦！」的通知
• 场景描写：AI 生成角色出现在你「门口」的场景描述，如「门铃响了，你打开门，七七站在外面，手里拿着奶茶，有点不好意思地说……」
• 你的反应选项：出现「开门迎接」「装作不在」「视频连线」等选项，不同选择导致不同剧情

4.1 进入「我的」

4.2 「我的」主页结构一览

「我的」主页从上到下分为以下区域：

4.3 个人资料设置（所有选项）

点击「✏️ 编辑资料」或进入设置，可以修改以下所有个人信息：

4.4 我的收藏功能

「我的收藏」汇总所有你主动收藏的内容：

• 收藏聊天消息：在聊天页长按消息 → 「收藏」，该消息保存到此处
• 收藏朋友圈帖子：点击帖子「...」菜单 → 「收藏」
• 收藏论坛帖子：帖子详情「...」菜单 → 「收藏」
• 收藏梦境：梦境卡片的「收藏」按钮

所有收藏按类型分标签展示（消息/帖子/梦境等），可以独立搜索和删除。

4.5 我的相册

「我的相册」自动汇总你在所有场景中上传或发送过的图片：

• 聊天图片：你发给角色的图片
• 朋友圈图片：你在朋友圈帖子中上传的图片
• 日记图片：日记里附加的图片
• 角色发送的图片（若角色有发图功能）

图片以网格形式展示，点击可查看大图，长按可保存到手机相册。

4.6 使用统计

「我的」页面提供详细的使用数据统计：

统计页还显示「最常聊天的角色」「最活跃的时间段」「本周 API 消耗趋势」等图表，帮助你了解自己的使用习惯。

4.7 账号与隐私设定

在「我的」→「设置」→「隐私」中，可以精细控制各功能的隐私设定：

5.1 进入宠物屋

5.2 领养宠物（创建流程）

1. 点击「+ 领养宠物」

   如果还没有宠物，宠物屋主界面会显示「领养」按钮，弹出宠物创建向导。
2. 选择宠物种类

   可选择：🐱猫咪、🐶狗狗、🐰兔子、🐦小鸟、🐠小鱼、🐹仓鼠、🦊狐狸、🐉幻兽（AI生成奇幻宠物），或「让 AI 帮我决定」。
3. 给宠物取名

   输入宠物的名字，或留空由 AI 根据宠物种类和角色人设取名。
4. 选择宠物性别

   ♀ 女/♂ 男/🌈 不定。
5. AI 生成宠物档案

   AI 根据种类、名字、关联角色，生成完整宠物档案：外貌描述、性格特点、特殊喜好/癖好、出生故事。约需 5~15 秒。
6. 选择关联角色

   选择这只宠物属于哪个（或哪些）角色的宠物，关联后该角色会对宠物有特殊感情，聊天中可能主动提及宠物状态。
7. 完成领养

   宠物出现在宠物屋，状态显示「幼年」，好感度100%，饥饿值0%（吃饱）。

5.3 宠物状态系统（全项说明）

每只宠物有以下状态指标，随时间变化：

5.4 照顾宠物（所有互动操作）

在宠物屋主界面点击宠物名片，进入宠物详情页，可进行以下操作：

5.5 宠物与角色的互动

宠物和关联角色之间会产生有机的互动，体现在以下地方：

• 聊天中自然提及：角色会在日常聊天中主动说「今天小橘（宠物名）一直跟着我转来转去好烦……但其实很可爱」
• 宠物状态影响角色情绪：宠物生病时，关联角色会表现出担心，不愿意轻松聊天
• 宠物重大事件通知：宠物升阶（幼年→少年）时，关联角色会发来庆祝消息
• 角色日记（角色视角）：部分版本支持「角色的宠物日记」，AI 以角色视角写与宠物相处的短记录

5.6 宠物档案管理

• 宠物信息卡：名字、种类、性别、生日、关联角色、当前成长阶段、所有特质标签
• 成长记录：宠物从领养至今的重要时刻记录（第一次升阶、第一次生病痊愈等）
• 宠物相册：所有「拍照」操作生成的纪念图
• 删除宠物：谨慎操作，删除后数据不可恢复
• 宠物上限：每个世界最多同时拥有 3 只宠物

6.1 进入经营系统

6.2 开设店铺（初始设置）

1. 选择店铺类型

   从以下类型中选择：☕咖啡馆、📚书店、🧁甜品店、🌸花店、🎮游戏厅、👗服装店、🎨艺术工作室、✨自定义（输入任意店铺类型）。
2. 给店铺命名

   为你的店铺取一个名字，或让 AI 根据类型取名。
3. 填写店铺背景故事（可选）

   描述这家店的故事，如「这是我和七七一起开的咖啡馆，在一条安静的小巷里」。AI 会将这个背景融入经营叙事中。
4. 选择初始地点

   模拟地点：繁华商业区（人流多但租金高）、社区街道（人流中等）、偏僻小巷（人流少但有特色客群）。地点影响日营业额基数。
5. 初始资金

   系统给予模拟初始资金（如 10,000 虚拟币），用于进货、雇员、装修。

6.3 经营主界面结构

经营主界面分为以下标签页：

6.4 商品进货与库存系统

在「库存管理」标签页进行商品管理：

1. 查看当前库存

   列表显示所有商品，每项包含：商品名称、当前库存量（件/份）、进货成本单价、售价、毛利率。库存不足时显示红色警告。
2. 进货操作

   点击任意商品 →「进货」→ 输入进货数量 → 确认。进货成本从虚拟资金扣除，库存立即增加。进货量过大会导致资金紧张。
3. 新增商品

   点击「+ 新增商品」→ 输入商品名称 → AI 根据店铺类型自动生成进货价和建议售价。也可以手动填写所有数值。
4. 设定售价

   点击商品的售价字段可以直接修改售价。系统会自动显示此售价下的毛利率百分比。售价过高客流量会减少，过低利润不够支付员工薪资和租金。

6.5 角色员工系统

你可以雇用你的 AI 角色在店铺里工作，这是经营系统最有趣的部分之一：

1. 进入「员工管理」标签

   显示可雇用的角色列表（你当前世界里的所有角色）和已雇用员工列表。
2. 雇用角色

   点击角色卡片 →「雇用」→ 设置日薪（模拟币）→ 确认。角色从下次「经营日」开始上班。
3. 角色上班行为

   AI 根据角色人设生成「今日工作表现」，出现在今日概况中，如：「七七今天特别卖力，还自己发明了一款新配方的奶昔，客人反应热烈。+10% 销售额。」
4. 员工工资支付

   每个「经营日」（真实时间每天一次）自动从虚拟资金扣除员工薪资。资金不足时员工会「罢工」或离职。
5. 解雇员工

   点击员工 →「解雇」→ 确认。被解雇的角色在聊天中可能会表达抱怨或失落情绪（AI 驱动）。

6.6 经营日报与数据

每个「经营日」结算后，系统自动生成一份每日经营日报，由 AI 以角色（老板助理/员工）的视角写出，包含：

• 今日销售总额和净利润（虚拟币）
• 今日最畅销商品 TOP3
• 客流量峰值时段（AI模拟早/中/下午/晚客流分布）
• 员工工作亮点（AI生成具体场景描述）
• 意外事件（约 30% 概率触发，如「今天刮风，室外座位无人光顾」「有网红来打卡」等，影响当日数据）
• 明日建议（AI给出进货和定价建议）

6.7 店铺升级系统

在「店铺升级」标签页，用虚拟资金购买升级：

7.1 进入健康系统

7.2 健康数据面板（主界面）

健康主界面以卡片形式展示各项健康数据：

点击任意数据卡片可进入该项目的详细记录页。

7.3 步数 & 运动记录

7.4 睡眠追踪

睡眠记录为手动输入模式，每天在睡前或醒后记录：

1. 点击「记录今日睡眠」

   弹出睡眠记录表单。
2. 填写入睡时间和起床时间

   系统自动计算睡眠时长。
3. 选择睡眠质量

   1~5 星评分（1=很差，5=极好）。
4. （可选）填写睡眠备注

   如「半夜惊醒了两次」「做了奇怪的梦」等。
5. 保存

   记录保存，睡眠面板更新数据。

睡眠时长低于 6 小时时，角色在当天的聊天中会注意到「你好像没睡好」，主动关心（需 API 且 RPC 开启）。

7.5 情绪健康日志

每天可以快速记录今日情绪（与日记系统中的情绪记录联动）：

• 快速情绪打卡：主界面直接点击今日情绪图标（😊😐😢😡😰等）打卡，1 秒完成
• 情绪详细记录：进入「情绪」详情页，可写更多关于今天情绪的描述
• 情绪月历：显示整月每天的情绪颜色（绿=好，黄=一般，红=差），一眼看出本月情绪规律
• 情绪趋势分析：AI 分析你连续几天的情绪数据，生成简短的情绪模式观察报告

7.6 角色健康关怀互动

这是健康系统最有温度的功能——角色会根据你的健康数据主动关心你：

7.7 健康提醒设置

在健康设置页，可以配置以下提醒：

8.1 进入心动交友

8.2 心动首页：配对系统

心动首页以卡片叠加的形式展示可以「配对」的角色（类似交友软件的滑动卡片）：

• 每张卡片显示角色头像、名字、简短自我介绍（由 AI 根据人设生成）、关键标签（如「温柔」「傲娇」「话唠」）
• 向右滑动：「喜欢」，触发配对成功动画
• 向左滑动：「跳过」（不影响普通聊天关系）
• 点击卡片：查看该角色的完整「心动档案」（人设摘要、兴趣、最近的一条朋友圈等）
• ❤️ 按钮：底部快捷喜欢按钮

8.3 心动聊天室（完整功能说明）

心动聊天室是独立于普通聊天的专属恋爱界面，UI 更精致，加入了大量模拟真实恋爱聊天的细节：

8.4 心动独立历史记录

心动聊天室的聊天历史与普通聊天完全独立，互不影响。即使普通聊天清除了历史，心动聊天室的记录依然保留（除非单独清除）。进入方式：

8.5 关系进度条系统

聊天室顶部有一个细长的进度条，显示你与该角色的恋爱关系进度：

进度增长方式：持续聊天（每次有质量的对话 +1~3%）、约会活动完成（+5~8%）、特殊节日互动（+3~5%）。进度不会倒退（除非角色人设里有特别设定）。

8.6 约会活动系统

暧昧期解锁后，可以在心动界面发起「约会活动」：

1. 点击顶部「📅 约会」按钮

   弹出约会活动选择面板。
2. 选择约会类型

   可选：☕咖啡馆、🎬电影、🌸公园散步、🍣晚餐、🎡游乐园、🏠在家、✨自定义场景。
3. （可选）填写约会细节

   如「晚上7点，在学校附近的那家猫咖」，AI 会将细节融入场景描写。
4. 开始约会

   进入约会场景模式，AI 生成当天的场景描述（类似线下模式），全程在心动聊天室界面内进行。
5. 约会结束

   点击「结束约会」，AI 生成约会结束场景（分别时刻），关系进度 +5~8%。

8.7 心动设置（所有选项）

进入心动聊天室 › 右上角「⚙️」打开心动专属设置：

9.1 进入音乐系统

9.2 音乐主界面结构

音乐主界面分为以下标签：

9.3 音乐播放器

Mono Heart 内置的音乐播放器支持：

• 添加本地音乐：点击「+ 添加音乐」，从设备选择音频文件（支持 MP3、AAC、M4A、OGG 等常见格式）。文件储存在 IndexedDB 本地数据库。
• 播放控制：播放/暂停、上一曲/下一曲、进度拖动条、音量调节
• 播放模式：顺序播放、随机播放、单曲循环、列表循环（四种，点击循环图标切换）
• 迷你播放栏：音乐播放中切换到其他页面时，屏幕底部出现迷你播放条（显示曲名和播放/暂停按钮），不影响使用其他功能
• 歌词显示（实验性）：若音频文件内嵌有 LRC 歌词，会自动显示同步歌词。外部 LRC 文件也可手动关联。

9.4 角色专属歌单

「角色歌单」是最有特色的功能之一：AI 会根据角色人设，生成一份符合角色审美和性格的推荐歌单。

1. 进入「角色歌单」标签

   选择你想查看歌单的角色。
2. 点击「生成歌单」

   AI 根据角色人设（性格、喜好、背景故事等），生成一份包含 10~15 首歌曲推荐的歌单，附上每首歌的推荐理由（为什么这个角色会喜欢这首歌）。
3. 查看歌单内容

   歌单以卡片形式显示每首歌的歌名、艺术家、AI 写的推荐语（如「七七会在失眠的深夜循环这首歌，想着那些没说出口的话」）。
4. 查找本地是否有对应歌曲

   如果你的本地音乐库中有与推荐歌单同名的歌，系统会自动匹配标记。
5. 「播放角色歌单」

   自动播放你本地音乐库中与推荐歌单匹配的曲目（未匹配的跳过）。

9.5 场景 BGM 系统

「场景 BGM」功能允许你为不同功能场景指定背景音乐：

9.6 线下模式中的 BGM 标记

在线下叙事（长篇模式）中，AI 会自动在场景段落开头加入 BGM 建议标记：

如果你本地音乐库中有同名歌曲，Mono Heart 会自动跳转播放该曲目。这让线下叙事的沉浸感大幅提升。

9.7 歌单管理

• 创建歌单：「我的歌单」标签 → 「+ 创建歌单」→ 取名 → 从本地音乐库选曲加入
• 编辑歌单：点击歌单 → 长按曲目可删除/排序
• 删除歌单：歌单列表长按歌单 → 删除（不删除音乐文件本身）
• 从本地库删除音乐：「本地音乐」→ 长按曲目 → 删除（释放 IndexedDB 空间）

10.1 每日签到机制

或在通知中心点击「今日签到提醒」直接跳转。签到规则如下：

• 每自然日（0点~23:59）可签到一次
• 签到操作：进入签到页 → 点击「今日签到」大按钮 → 完成
• 签到完成时显示本日奖励内容（角色的特别消息）
• 忘记签到不会清零，但连续签到天数中断

10.2 签到主界面说明

签到界面从上到下包含：

• 连续签到天数计数器：大字显示当前已连续签到 N 天，如「🔥 连续 15 天」
• 本周签到日历：7 格显示本周每天签到状态（已签到=亮，未签到=灰）
• 里程碑进度条：显示到达下一个里程碑奖励还差几天
• 「今日签到」按钮：已签到时变灰色显示「今日已签到」
• 今日角色消息预览：签到后显示随机角色发来的今日特别问候内容
• 历史签到记录：月历形式显示过去签到记录，每天有打卡标记

10.3 签到奖励系统

每次签到的奖励是：一条由 AI 生成的角色专属「今日寄语」，内容包括：

• 角色根据今天日期（节日/星期/天气）写给你的消息
• 角色对你最近聊天内容的回应（RPC+API 开启时）
• 角色的今日心情和状态简述

每次签到随机从所有角色中选一个发送今日寄语，或者可以在设置中指定「签到角色」（固定哪个角色负责每天打招呼）。

10.4 连续签到里程碑

10.5 角色打卡互动

角色们也有「打卡」行为，模拟真实生活中每天的例行活动：

• 晨间打卡：设定了「每日问候」的角色，每天早上在通知中心发来早安消息（AI 生成，内容每天不同）
• 活动打卡：角色模拟各自人设里的日常活动（如「今天学习了两小时」「跑步打卡」），偶尔在朋友圈发布打卡内容
• 你的签到触发角色互动：你签到时，如果 API 开启，当天会触发一次角色主动互动，内容与签到天数/里程碑有关

10.6 签到设置

11.1 联机功能概述

Mono Heart 的联机功能分为三个层次：

11.2 Supabase 联机配置（详细步骤）

联机功能需要配置 Supabase。以下是从零开始的完整配置流程：

1. 注册 Supabase 账号

   前往 supabase.com，点击「Start your project」，使用 GitHub 账号或邮箱注册。免费方案足够个人使用。
2. 创建新项目

   登录后点击「New Project」→ 填写项目名称（如「MonoHeart」）→ 设置数据库密码（保存好这个密码！）→ 选择离你最近的服务器区域（推荐亚洲节点）→ 点击「Create new project」。等待约 2 分钟初始化。
3. 获取 API 凭证

   项目创建完成后，进入「Settings（设置）」→「API」页面。复制以下两项：① Project URL（格式：https://xxxxx.supabase.co），② anon public key（以 eyJ 开头的长字符串）。
4. 在 Mono Heart 设置中填入

   打开 Mono Heart → 设置 → 云同步/联机 → 填入 Supabase URL 和 Anon Key → 点击「连接测试」确认成功。
5. 选择同步内容范围

   在联机设置中勾选需要同步的内容：角色设定 / 聊天历史 / 日记 / 朋友圈 / 设置参数 等。不同步的内容只保留在本地。
6. 执行首次同步

   点击「立即同步」，将当前设备数据上传到 Supabase。进度条显示同步进度。

11.3 跨设备数据同步

配置好 Supabase 后，跨设备使用方法：

1. 在新设备打开 Mono Heart

   用浏览器打开同一个 Mono Heart HTML 文件，或同一个 URL。
2. 进入设置 → 云同步

   填入同样的 Supabase URL 和 Key。
3. 点击「从云端恢复」

   将云端数据下载到新设备，覆盖本地（如有），恢复完整数据。
4. 开启自动同步

   开启「自动同步」后，每次操作（发消息、写日记等）都实时同步到云端，多设备始终保持最新状态。

11.4 世界分享功能

你可以将你创建的角色世界打包分享给好友：

1. 进入多世界 App → 选择要分享的世界

   点击世界右侧的「...」菜单。
2. 选择「导出世界」

   选择导出内容范围：仅角色设定（不含聊天历史）/ 完整导出（含聊天历史）/ 精简导出（仅人设和基本信息）。
3. 下载世界文件（.json）

   导出为 JSON 格式的世界文件，文件名为世界名称。
4. 发送给好友

   通过任何方式发送文件（微信、QQ、邮件等）。
5. 好友导入

   好友在自己的 Mono Heart 里：多世界 App →「导入世界」→ 选择 JSON 文件 → 确认导入。好友即可拥有你的角色和世界设定（但没有你的聊天历史，除非你选了完整导出）。

11.5 实时联机玩法（实验性）

当两个用户共享同一个 Supabase 项目（即他们填写了同样的 Supabase URL 和 Key）时，可以进入「实时联机」模式：

• 共享朋友圈：两个用户发的朋友圈帖子都出现在同一个朋友圈时间流里
• 共享论坛：两个用户都可以在同一个论坛发帖讨论
• 角色互动对方的内容：你的角色可以看到并互动对方发的帖子
• 角色间聊天室共享：可以看到对方世界中角色间聊天室的内容

11.6 联机冲突解决

当两台设备对同一数据在离线状态分别修改后重新同步，会产生数据冲突：

12.1 进入 API 设置

12.2 API URL 详解

URL 格式规范：

Mono Heart 在接收到 URL 后，会自动在其后拼接 /chat/completions，形成完整的请求地址，如 https://api.openai.com/v1/chat/completions。所以你填写的 URL 只需到 /v1 即可。

12.3 API Key 安全管理

12.4 模型选择深度说明

各模型对比（通过 OpenAI 官方或兼容服务商访问）：

12.5 高级 API 参数设置

在 API 设置的「高级」或「参数」区块，可以调节以下参数：

12.6 多 API 配置与轮换

Mono Heart 支持配置多个 API，在不同情况下使用不同的 API：

1. 进入 API 设置 → 「+ 添加 API 配置」

   弹出新建 API 配置表单。
2. 填写第二个 API 的 URL、Key、Model

   为这个配置取一个名称（如「备用-Groq」「高质量-GPT4o」）方便区分。
3. 设置使用策略

   • 「手动切换」：在设置页手动选择当前使用哪个 API
   • 「失败时自动切换」：主 API 请求失败（如超时）时自动切换到备用 API
   • 「轮询」：每次请求依次使用不同的 API（平衡多个服务商的用量）

12.7 角色专属 API

每个角色可以设置独立的 API 配置，覆盖全局 API 设置：

为什么需要角色专属 API？

• 某个重要角色希望用更好的模型（如 gpt-4o），其他普通角色用 mini 节省费用
• 某个角色需要用日语模型（如使用支持日语更好的服务商）
• 测试不同模型对同一角色人设的表现差异

角色专属 API 的所有参数（URL/Key/Model/Temperature/MaxTokens）都可以单独设置，不填则继承全局设置。

12.8 API 测试与诊断工具

API 设置页底部有完整的诊断工具集：

12.9 完整错误代码解析表

13.1 进入角色设定

或者通过：「我的」→「角色管理」→ 点击角色 →「编辑」

13.2 基本信息设置

13.3 人设（系统提示）深度教学

13.4 场景设定 (Scenario)

13.5 温度参数精讲

13.6 语言与翻译设定

13.7 回复数量与格式设定

13.8 记忆核心 (Memory Core)

13.9 角色高级设定

13.10 角色导入与导出

单个角色可以独立导出/导入，用于分享或备份：

本篇教程对以下功能进行了超级详细的解说：论坛系统、日记系统、串门系统、「我的」主页、宠物屋、经营系统、健康系统、心动交友（含心动聊天室完整功能）、音乐系统、签到打卡、联机系统、API完整设置、角色设定全项。

Mono Heart 的核心体验在于：所有这些系统都是互相联动的。你写的日记会被角色读到；你的健康数据影响角色的关心方式；你在论坛发的帖子角色会讨论；你养的宠物影响角色的情绪——这种立体的、相互呼应的 AI 互动体系，是 Mono Heart 区别于普通 AI 聊天的独特之处。

Mono Heart 5.4ver · 补充完整教程 v1.0 · 愿你与角色的故事精彩无限 ✦