数据与维护

备份与恢复

备份会把你的角色卡、聊天记录、记忆、故事书完整打包成一个文件：

• 手动备份——启动器里一键完成，重要节点（换电脑、重装系统前）记得来一发。
• 自动备份——KOA 会在自动整理记忆的时候自动备份，给你多一层保险。

恢复：重装启动器后导入备份文件，角色、记忆、聊天记录原样回来——ta 不会忘记你。

日志页怎么用

启动器的「日志」页实时显示服务器输出，支持分类筛选。遇到任何异常（ta 不回话、报错弹窗），先来这里看一眼——大多数问题的原因会直接写在日志里，比如 API Key 失效、额度用完、网络超时。

配合《API 配置全指南》的报错对照表，八成问题可以自己搞定。

诊断包反馈

自己解决不了的问题，用诊断包找开发者：日志页一键导出，会自动收集环境信息、日志和配置，并自动脱敏——你的 API Key 等敏感信息会被打码，不会泄露。

导出后可以直接一键发送给开发者或者发给AI，或到帮助中心指引的渠道发给我——附上诊断包的反馈。

自动更新

KOA 的更新不用你操心：

• 启动器——检测到新版本会自动提示，一键安装完成升级，不需要手动下载替换。
• 游戏 mod——启动时自动检测已装 mod 的版本，有更新自动装好。

也可以在「说明」页底部手动检查更新。每次更新的内容都写在说明页的版本更新记录里。

你的数据在哪

所有数据都存在你自己的电脑本地：角色卡、聊天记录、记忆、API Key——KOA 不会把它们上传到任何服务器。对话内容只经过你自己配置的 API 通道。

想直接看看这些文件？「说明」页里有「打开数据文件夹」按钮，一键直达。

更换存储位置

C 盘快满了想把数据挪到别的盘？可以——但千万不要直接剪切或移动文件夹。

正确做法是用 Windows 自带的目录链接（junction）——把文件夹搬到新位置后，在原位创建一个"快捷入口"，KOA 完全感知不到变化：

1. 关闭 KOA，确保启动器完全退出（检查系统托盘）。
2. 找到数据文件夹，按 Win + R 输入以下路径打开：
   • 启动器设置：%LOCALAPPDATA%\com.koa.launcher
   • 安装目录（含聊天记录和记忆）：%LOCALAPPDATA%\KOA
3. 把整个文件夹剪切到目标位置，例如把 KOA 文件夹剪切到 D:\KOA。
4. 创建目录链接，右键开始菜单选「终端（管理员）」，输入：

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

   看到「为 ... 创建的联接」就成功了。如果两个文件夹都要搬，对 com.koa.launcher 重复同样操作。

5. 打开 KOA，确认一切正常——角色、记忆、聊天记录应该原样还在。