没有找到相关问题
试试换个关键词，或者浏览下方的分类
从下载到进入游戏，只需要几步
从官网下载页下载安装包，双击运行即可安装。安装完成后启动器会自动打开。
到 资料 页面，先写好「我自己」的设定，再到「我的恋人」里新建并编辑你的 companion 角色：外貌、性格、背景故事等。写好以后点亮卡片上的星星「设为当前陪玩」。
回到主页点任意游戏图标进入面板，点顶栏的「自动安装mod所需文件」完成安装。服务器会自动启动，配置会自动同步，打开游戏就能见到 ta 了。
关于 API 地址、Key、模型选择的常见疑问
API（Application Programming Interface）是一个「对话通道」：KOA 通过这个通道把你说的话发给大语言模型（比如 DeepSeek、GPT、Gemini），模型思考后把 ta 的回复传回来。
你可以把它理解成：KOA 是 ta 的身体，API 是 ta 的大脑连接线。没有 API，ta 就没有思考能力。
KOA 需要你自己提供 API，是因为每次对话都会消耗模型服务商的算力资源（按 token 计费），这部分费用由你直接付给服务商。这样做的好处是：你可以自由选择喜欢的模型，而且对话内容只经过你自己的 API 通道，不经过 KOA 服务器。
你需要到大模型服务商的官网注册账号，然后在后台创建 API Key。常见的服务商：
注册完成后你会得到两样东西：API 地址（服务商提供的网址）和 API Key（一串密钥字符串），把它们填进 KOA 启动器的 API 页面即可。
API Key 就是你的「通行证」，一串由字母和数字组成的密钥字符串（类似 sk-xxxxxxxx）。服务商通过它来识别是谁在使用 API，并从你的账户余额中扣费。
请妥善保管你的 Key，不要分享给别人，否则别人可以用你的额度。
大部分情况下不需要手动填写 API 地址。在 KOA 的 API 页面点开「API 地址」的下拉，选你的服务商，地址会自动装填。
你只需要填写 API Key 和选择 模型名称 就好。
只有使用非主流服务商或自建代理时，才需要手动修改地址。
推荐优先考虑性价比和中文能力：
注意：想在虚拟手机里给 ta 发照片、在电脑的「一起看看」App 里给 ta 看你的屏幕，或在线下场景发图片，需要选用具备多模态（识图）能力的模型。API 页最上面的「API 预设」能存好几套，随时切换。
不同模型的「人格表现力」会有差异，可以多试试找到你喜欢的。KOA 支持随时切换模型，已有的记忆和设定不会丢失。
费用取决于你选择的模型和聊天频率。以 DeepSeek 为例，日常聊天每天大约几毛到几块钱。
线下场景的对话攒到一定量，KOA 会问你要不要整理成记忆，整理过的旧对话不再整段发给模型，上下文不会无限增长。「我们的故事」里写卡片时，文字框下面有一行「约 N tokens」，写长了心里有个数。
建议先少量充值体验，熟悉消耗速度后再按需充值。
启动器安装、游戏 mod 安装、系统要求，还有主页和设置在哪
KOA 本身很轻量，不会占用太多资源。本地语音识别模型也已内置在启动器里。
进入对应游戏的面板后，点顶栏的「自动安装mod所需文件」即可，启动器会自动定位游戏目录并完成安装。
我的世界会先列出这台电脑上找到的版本，勾上你玩的那几个再装；没列出来的，单子下面写着在哪找它的文件夹。
启动游戏时记得选 NeoForge 安装项，不是原版 1.21.1。
两个都装好，再点启动器里的「自动安装mod所需文件」。少了 Content Patcher 的话 mod 装得上，但进游戏后 ta 不会出现，启动器会在安装完成时提醒你。
装完从 SMAPI 启动游戏，不是从 Steam 直接点开始。
目前不支持多人联机服务器，需要自己开本地联机房间。
通过爱发电赞助获取激活码。一次性买断，永久更新。
收到激活码后在启动器内输入即可激活。
启动器有自动更新功能：检测到新版本时会自动提示并一键安装，不需要手动下载。
游戏内的 mod 也会在启动时自动检测并更新到最新版。
能，电脑和手机端都行。
藏起来的卡片，再进一次编辑就能看到，半透明的，点眼睛放回来。「恢复默认」会让主页按钮回到出厂的顺序，藏起来的都会重新出现。电脑上的「设置」和手机端的「更多设置」那一张藏不掉，也挪不动。
主页上原来的「更多」现在叫「设置」，激活、备份、回收站、外观、隐私打码、字词替换、存储位置都在里面。
电脑上还有更快的办法：点标题栏「帮助」旁边的放大镜，或者按 Ctrl + K，打你想找的词，比如「代理」「备份」「音色」。回车就跳到那一页，那一块还会亮一下。主页上藏起来的卡片也搜得到。
手机端没有搜索，设置都在主页的「更多设置」里。
操作方式、companion 行为、游戏内交互
打字：按 T 打开聊天框输入文字，不以 / 开头的消息 ta 都听得到。
语音：API 页「语音识别 STT」的「触发方式」有两种：「自动检测语音 (VAD)」是开口就听；「按键说话 (PTT)」是按一下 V 开始，说完再按一下 V，不用一直按着。识别语言也在那里选。识别在本地完成，不需要额外的 Key。
按以下顺序排查：
/koa summon 手动召唤我的世界：按 K，或者空手右键点 ta，打开 ta 的面板，召唤、待命等操作都在这里。面板里点「背包」，可以存放物品、装备盔甲、送礼物。手里拿着食物右键点 ta，是喂 ta。
饥荒：按 B 键打开 ta 的背包（可在 mod 配置里改键）；右键点 ta 也能翻背包，手里拿食物右键点 ta 就是喂 ta。
星露谷：按 F7 打开游戏内面板，可以查看背包、暂停 LLM、让 ta 待命。键盘没有 F7 的话，装了 GMCM 就在游戏里的「按键设置」改「伴侣面板」；没装就打开 Mods\KoaMod\config.json，把 "CompanionPanelKey" 改成顺手的键。
泰拉瑞亚：右键点 ta 打开背包，东西放进去就是送给 ta；背包里的「武器」格放一把武器，ta 就用它打怪。按 K 打开游戏内面板，静音、停放、开挂、叫过来都在里面。详见《泰拉瑞亚》。
在启动器里可以直接上传皮肤图片，启动器会自动完成重命名与放置。
也可以手动操作：将一张标准 64x64 的 MC 皮肤重命名为 companion.png，放入 .minecraft\koamc\ 目录，重启游戏即可生效。
大部分操作都可以用自然语言直接跟 ta 说，不需要命令。我的世界还可以按 K 打开游戏内面板来管理 ta。以下是常用命令：
/koa summon：召唤 ta 到你身边/koa stay：把 ta 停放在原地/koa despawn：让 ta 暂时离开/koa quiet：暂停 LLM 调用（省 token）/koa strong：开挂模式，战斗力拉满/koa weak：恢复普通模式/koa undo_build：撤销最近一次建造游戏之外的陪伴功能
虚拟手机是一个独立的手机窗口，设定是你们通过手机保持联系。主页点「虚拟手机」即可弹出。
桌面上有「聊天」（短信）、「电话」、「朋友圈」、「日记本」、「日历」、「歌单」，还有「论坛」「问卦」「塔罗」「小课堂」「商城」「阅读」「网文」「我这儿」这些。原来的「占卜」改名叫「塔罗」，「文学」拆成了「阅读」和「网文」；「一起看看」从电话里拆出来，单独一个 App，只在电脑上有。每个 App 怎么用，见《虚拟手机》。
输入框里有两个按钮。猕猴桃那个是「添加到待发」：把这一句放进上面的「待发送」里，先不发出去，方便你连着写好几句再一起发。按回车也是放进待发送。
旁边带向上箭头的那个才是「发送」，点一下，待发送里的会一起发出去。它的颜色跟着聊天皮肤走，不一定是蓝的。输入框和待发送都空着的时候它是「语音输入」，ta 正在回的时候它变成「停止生成」。
不开游戏也能跟 ta 待在一起的文字叙事。主页点「线下场景」即可进入。
你们会在同一个世界聊天、互动、生活。右上角的「设置」里能调「回复长度」「人称视角」「台词模式」，手机端叫「台词语言」。
是的。游戏内、线下场景和虚拟手机共享同一份记忆和人设。
你们在我的世界里一起冒险的经历、在饥荒中度过的夜晚、手机里聊过的话题，ta 都记得，不管你从哪个入口跟 ta 互动。四个游戏里，ta 每次开口前都会先看一遍「我们的故事」里的故事总结和时间线，线下、短信里发生的事，游戏里也知道。详见《记忆系统与「我们的故事」》。
手机窗关着、或者被游戏挡住的时候，ta 在短信里发来的每一条，都会在屏幕右下角弹一条通知，响一声。点通知，手机窗会出来。Windows 开着勿扰的时候不响。
不想要的话：打开虚拟手机，进桌面上的「设置」App，在「聊天」那一栏关掉「来消息时弹通知」。
同一栏里还有「让你对象主动发消息」。开着它，ta 会在一段沉默之后主动找你，每一条都要花 token。这个开关只管这台设备：手机上开了，电脑不会跟着发。电脑上要每次启动 KOA 后打开过一次手机窗才开始，退出 KOA 就停。
在手机上随时随地使用 KOA
手机端网页版是 KOA 的移动网页应用（PWA），用手机浏览器打开 app.koasystem.com 即可使用，不需要下载安装任何 App。
建议添加到手屏幕，体验更像原生 App（全屏、无地址栏、独立图标）。
手机端不是免费的。它跑在 KOA 的云端服务器上，服务器每个月都要钱。
手机端和云同步要云订阅：8.6 元一个月，86 元一年。1.3.20 起，老用户新用户都已经自动有一个月。
续费码在爱发电买，买到以后在电脑上「设置」→「激活」→「兑换续费码」贴进去，天数接在原来的到期日后面。
拉朋友也行。朋友买了 KOA，开多端同步 30 天内填上你「我的邀请码」那一串，你多 30 天，她多 15 天。
电脑上的 KOA 是买断的，不订阅也一直能用。
不可以。手机端是 KOA 电脑版的附属功能，不是独立产品，不会单独售卖。
首次使用前，你需要先在电脑端完成以下准备：
完成后，在手机浏览器打开 app.koasystem.com，用同一个账号登录，就能拉取到你的数据。
手机端主页上的卡片：
游戏内功能（我的世界、饥荒、星露谷等）需要在电脑上运行，手机端不涉及。大型复杂功能以电脑端为主。
主页点「更多设置」→「关于 / 版本」。「清除缓存」下面写着缓存的页面文件有多大、本机数据有多大、可用空间还有多少。
「清除缓存」只清页面文件，清完会自己刷新。聊天记录、备份和语音都是本机数据，清除缓存不会动它们。
电脑醒来两分钟内，远程中继会自己连回去，不用重启 KOA。电脑关机或者睡着的这段时间，手机上会直接说「电脑不在线」。
等了两分钟还是不行，到电脑的 API 页看「远程中继」下面那一行，写着「已连接」才算连上。怎么设置见《远程中继：手机用上电脑的 API》。
语音识别（STT）与语音合成（TTS）
不需要 Key。默认的识别引擎是「本地离线（SenseVoice，免费）」，在你自己的电脑上跑。第一次用，在游戏面板里点「启动麦克风」，会弹出「语音识别模型下载」，下一个约 239MB 的模型，下完就能离线用。
识别语言和触发方式都在 API 页的「语音识别 STT」里选。触发方式有两种：「自动检测语音 (VAD)」（开口就听）和「按键说话 (PTT)」（按一下 V 开始，再按一下结束）。
如果你在手机端使用语音识别但录了也识别不出来，最常见的原因是：浏览器内置语音识别（Web Speech API）在中国大陆网络环境下不可用。
Chrome 的语音识别底层依赖 Google 服务器，在中国大陆无法连接。日志里会显示引擎注册成功（provider set to: Browser），但实际识别时请求发不出去。
解决方案：
在「资料」→「我的恋人」里点开 ta 的卡片，「语音」那一块勾上「启用语音」，在「TTS 引擎」里选：
GPT-SoVITS 等本地 TTS 和游戏共用显卡资源，同时运行时可能因显存不足导致 TTS 静默失败：不报错，只是没有声音。
解决方案：限制 TTS 显存占用、降低游戏画面配置，或换用不占显卡的云端 TTS。
遇到问题先来这里看看
按顺序试，多数情况第一步就好了。
%LOCALAPPDATA% 回车，找到 com.koa.launcher 文件夹整个删掉，重新打开 KOA，它会自己重建。顺便看一眼 C 盘剩余空间，低于几个 G 也会卡在安装这一步。
常见 API 错误：
到启动器「日志」页查看详细错误信息，通常能直接看到原因。
这几乎都是麦克风没有收到声音：没插好、插错了接口、系统选错了输入设备、或者麦克风被静音了。识别模型收到一段无声的录音时，会输出一串句号之类的标点，看起来像坏了，其实是它「什么都没听到」。
启动器有专门的「日志」页面（主页的「日志」，或者标题栏「数据」菜单里的「日志和诊断包」），可以查看服务器实时输出，支持分类筛选。
遇到无法自行解决的问题，在这一页点「提交反馈」，写清楚出了什么事，诊断包会一起发给开发者。只想自己先查一遍，点「自动诊断」。
电脑上点主页的「设置」→「备份」。「创建备份」是手动打一份；每次整理完记忆，也会自动存一份。角色卡、聊天记录、记忆、故事书都在里面，API Key 不在，恢复以后要重新填。
恢复：列表里每一份后面有「恢复」，拿到的是一个文件就点「选择备份文件」。手机端在「更多设置」→「登录 / 同步 / 备份」里也能打包、恢复。详见《数据与维护》。
可以，用启动器自带的备份恢复功能即可完成迁移：
角色卡、聊天记录、记忆、故事书、短信都会回来。
详细说明见《数据与维护》教程。
1.3.18 删掉了一批过时的功能：游戏面板里的「导出备份」，短信 App 里导入、导出聊天记录的按钮，还有原来文学 App 里 ta 的书架上查三个海外书籍网站的按钮。
备份统一在电脑的「设置」→「备份」里做，短信里的聊天记录也在那一份里面。
不要直接剪切或移动数据文件夹。KOA 的数据分布在多个位置，手动搬会导致程序找不到文件，出现各种不兼容问题。
如果 C 盘空间紧张，推荐用 Windows 自带的目录链接（junction）：把文件夹搬到新位置后，在原位创建一个「快捷入口」指向它，KOA 感觉不到变化。
详细步骤见《数据与维护》教程的「更换存储位置」章节。
打开启动器的「日志」页，点「提交反馈」，写清楚出了什么事，诊断包会一起发出去。开发者会收到完整日志和环境信息，帮你更快定位问题