数据与维护

你的数据在哪

角色卡、聊天记录、记忆、API Key 都存在你自己的电脑上。对话内容只经过你自己配的 API。

开了多端同步以后，数据会先用你的激活码加密，再上传到云端，给手机用。开发者看到的只是一堆乱码。

想看看这些文件，点主页的「设置」→「存储位置」，两个文件夹一起打开。标题栏的「数据」菜单里也有「存储位置」这一行。

在电脑上备份和恢复

「设置」→「备份」，或者标题栏「数据」菜单里的「备份与恢复」。

• 手动备份：点「创建备份」。备份存在哪，点「打开备份文件夹」。换电脑、重装系统之前记得做一次。
• 自动备份：每次整理完记忆会自动存一份，页面底下写着上次是什么时候。电脑上留最近 10 份。
• 恢复：列表里每一份后面有「恢复」。拿到的是一个文件，就在「从文件恢复」里点「选择备份文件」。手机上导出的备份也能在这里恢复。

恢复之前会先把现在的数据存一份，标着「安全备份」，恢复错了还能回来。恢复完会重启服务。

游戏面板里原来那个「导出备份」，和短信 App 里导入、导出聊天记录的按钮，1.3.18 起都去掉了。短信里的聊天记录也在这一份备份里，备份统一在这一页做。

换新电脑

1. 旧电脑上做一份备份

   「设置」→「备份」→「创建备份」，再点「打开备份文件夹」，把那个 .zip 拷到 U 盘或网盘。

2. 新电脑上装好 KOA，激活

   激活码绑定设备，不跟着备份走。一个码最多 3 台设备。

3. 恢复

   「设置」→「备份」→「选择备份文件」，选那个 .zip。

4. 重新填 API Key

   见《API 配置全指南》。

5. 看一眼，再开同步

   角色、记忆、聊天记录都在了，再去重新开多端同步。

在手机上备份

手机端「更多设置」→「登录 / 同步 / 备份」，找到「本地备份」那一块。

• 整理完记忆会自动打一份包，也可以点「立即打包」。
• 包先存在浏览器里，只留最近 3 份，系统清缓存时可能会被清掉。所以每一份都点一下「保存到手机」，存进手机的文件里。
• 有没存进手机的备份时，首页和设置里会亮一个小红点，写着「备份待存进手机」。
• 恢复：点某一份的「从这份恢复」，或者「从文件恢复」选一个文件。电脑上的备份也能在这里恢复。

手机上恢复完不用重新登录。恢复的结果会同步到云端，电脑下次同步也会变成这个样子。

想知道手机上占了多少地方：「更多设置」→「关于 / 版本」，「清除缓存」下面写着缓存的页面文件有多大、本机数据有多大、可用空间还有多少。清除缓存只清页面文件，聊天记录、备份和语音都不动。

回收站

删掉的会话、记忆、卡片、皮肤，先进回收站。电脑上「设置」→「回收站」，手机上「更多设置」→「回收站」。

• 每一条写着「N 天后清除」，点「恢复」拿回来，点「彻底删除」就真没了。
• 电脑上留 30 天，手机上留 7 天。
• 回收站只在这一台设备上，不同步，也不进备份。
• 恢复一个会话时，原来的位置已经有同名的，会恢复成一份副本。

有的删除确认框上还写着「无法恢复」，其实也进了回收站。

多端同步

想在手机上用 KOA，要先在电脑上开多端同步：「设置」→「激活」→「多端同步」，点「开启多端同步」。建议绑定邮箱，手机上可以用邮箱登录，也可以用「手机端登录码」。

同一块里「同步权限」写着到期时间。手机端和云同步要云订阅，8.6 元一个月，86 元一年。1.3.20 起，老用户新用户都已经自动有一个月。续费码在爱发电买，买到以后点「兑换续费码」贴进去，天数接在原来的到期日后面。

「我的邀请码」那一串可以发给朋友。她买了 KOA、开了多端同步以后，30 天内点「填邀请码」填上，你多 30 天，她多 15 天。

激活码本身的功能是买断的，不订阅也能一直用，订阅只管手机和云端。手机端怎么用见教程中心的「手机端网页版」。

隐私打码

截图发出去之前，把你和 ta 的名字遮住。标题栏那只眼睛「隐私打码」一点就开，再点就关；标题栏「设置」菜单里也有这一行，开着时行尾写「已开启」。

「设置」→「隐私打码」里能设置：

• 「遮什么，换成什么」：「我的名字」和「恋人的名字」各配一个图案。点「换一个图案」，可以输一个表情（Win + . 打开表情面板），也可以「选一张图片」。
• 「我补充的称呼」：小名、昵称，每个配一个图案，「再加一个」。
• 「它遮不住什么」写着它管不到的：恋人临时起的称呼、头像，以及学校、生日、住址这类能认出你的内容。发之前自己再看一眼。

只改屏幕上显示的，聊天记录里还是原来的名字。手机上在「更多设置」里也有。

字词替换

ta 的回复里有哪个词你不想看，比如想把「老子」换成「我」：「设置」→「字词替换」，手机上在「更多设置」→「字词替换」。

1. 写一条

   「换哪个，换成什么」下面，左边写不想看的词，右边写换成什么。右边留空就是直接去掉。「再加一条」加下一行。

2. 试一段

   在「试一段」里贴一段回复，马上能看到换完的样子。

聊天、剧场、跑团里的回复都按这张表显示，电脑和手机共用一张。它只改你看到的：ta 不会因此改口，聊天记录和 ta 的记忆里还是原词。点朗读，念的还是原来那一句，手机上也一样。被加粗或者被引号隔开的词认不出来。最多 200 条。

前进和后退

电脑上标题栏右边有两个箭头：「后退 (Ctrl+Z)」和「前进 (Ctrl+Shift+Z)」。写剧本、写档案时改错了，点后退就回去。不在能编辑的页面时，这两个箭头是灰的。

光标在输入框里时，Ctrl + Z 撤的是输入框自己的字。

聊天记录很长的时候

从老版本升上来的，第一次进线下场景会弹「升级聊天记录存储」，点「现在升级」。升级前会自动完整备份一次，完了告诉你备份在哪。

之后打开一个会话，只先读最近的几十条，上万层的记录也不卡。往上翻，点「显示更早的对话」再读更早的。

记录里有一条分界线，写着「以上 N 条不在 AI 上下文中」。线上面的不再直接发给模型，多半是已经整理进了记忆，也可能是你在「消息可见性」里藏起来的。

日志和诊断包

ta 不回话、弹了报错，先去启动器的「日志」页看一眼（主页的「日志」，或者标题栏「数据」菜单里的「日志和诊断包」）。大多数问题的原因会直接写在上面：API Key 失效、额度用完、网络超时。对照《API 配置全指南》的报错表，多半能自己解决。

自己解决不了：

• 「自动诊断」：自动查一遍，结果可以「复制给 AI」问，也可以「导出文件」。
• 「提交反馈」：连同诊断包一起发给开发者。诊断包里的 API Key 这类敏感信息会先打码。

更新

• 打开 KOA 以后会自己检查更新，之后每隔几个小时查一次。也可以点标题栏的「检查更新」。
• 更新窗口分「应用更新」和「内容更新」。内容更新只下改过的文件，窗口上写着要下几个、多大。
• 点「立即更新」，或者「稍后提醒」。下载中可以「暂停」「继续下载」，窗口关了也会在后台接着下。
• 装更新时屏幕上会盖一层「正在应用更新...」，装完自己恢复。
• 游戏 mod 每次启动时会检查版本，有新的自动装好。

每次更新了什么，写在「说明」页的版本更新记录里。

关窗口和界面语言

点窗口的叉，会问你「你想要完全退出还是最小化到托盘？」，选「最小化到托盘」或「退出 KOA」。选过一次就记住了。想让它重新问，在托盘图标上点右键，选「关闭时询问」。托盘右键菜单里也有「退出 KOA」。

界面语言在「设置」页最上面的「语言」里切「中文」或「English」，标题栏「设置」菜单里的「语言」也能切。装 KOA 时选的语言只管安装那几步。

更换存储位置

C 盘快满了，想把数据挪到别的盘，可以。但不要直接剪切文件夹。

正确的办法是 Windows 自带的目录链接（junction）：文件夹搬走以后，在原来的位置留一个入口，KOA 感觉不到变化。

1. 完全退出 KOA

   在托盘图标上点右键，选「退出 KOA」。

2. 找到数据文件夹

   按 Win + R，输入下面的路径：

   • 聊天记录和记忆：%LOCALAPPDATA%\KOA
   • 启动器的设置：%APPDATA%\com.koa.launcher
3. 把整个文件夹剪切过去

   比如把 KOA 剪切到 D:\KOA。

4. 建目录链接

   右键开始菜单，选「终端（管理员）」，输入：

   mklink /J "%LOCALAPPDATA%\KOA" "D:\KOA"

   看到「为 ... 创建的联接」就成了。启动器的设置文件夹也要搬的话，照样来一遍：

   mklink /J "%APPDATA%\com.koa.launcher" "D:\com.koa.launcher"

5. 打开 KOA 看一眼

   角色、记忆、聊天记录都在，就成了。