我是新手
还没装过 Oarill，想完整走一遍：下载、导入、校准、开口。
- 约 12 分钟
- 不需要任何技术背景
- 不用调参数
教程 · TUTORIAL
从下载，
从下载，
到第一句话
这里有什么：从安装到第一次对话的完整路径，外加导入聊天记录的分平台步骤，和一份常见报错速查。
要花多久：平均 12 分钟走完新手路径（导入与蒸馏的等待时间不计在内）。
从哪开始：没装过就按下面 1→4 顺序走；只想解决一个问题，直接跳到对应的入口卡。
我要导入记录
已经装好，卡在导入这一步。微信 / iMessage / QQ / 通用 txt 导出文件的分平台步骤都在下面。
- 三个平台逐条步骤
- 常见报错速查
- 全程在本机完成，不上传
我要写剧本
想玩彼岸入梦：自建世界、多角色同台、画面由 AI 生成。先看玩法总览，再回来补导入。
- 多世界剧本
- 多角色同台
- 本机生图
新手路径 · THE PATH
四步，12 分钟
每一步都只有一件事要做。走完第四步，你就已经在和 TA 聊天了。
STEP 01下载安装客户端，用授权码激活。
STEP 02导入把聊天记录交给 Oarill。
STEP 03校准等它提炼出 TA 的说话方式。
STEP 04第一句话开口，它记得你们聊到哪儿。
快速上手 · QUICK START
四步正文
按顺序做就行。每步后面附了一条「常见错法」，那是这一步最容易白花时间的地方。
下载安装
并打开
付款后会收到一封带授权码的邮件，通常几分钟内到达；下载 macOS 或 iOS 客户端，第一次打开时把授权码填进去即可激活。Mac 和 iPhone 用同一个授权码，装好就能接力。这一步大约 2 分钟，之后不用再付费，也不会按月扣费。 常见错法没看到邮件就再付一次款 —— 先翻一下垃圾邮件和「促销」标签，重复付款不会让授权码来得更快。
导入
聊天记录
把你想留住的那段对话导出成文件，拖进 Oarill 的导入窗口。支持微信、iMessage、QQ 的导出文件，以及通用 txt 导出文件。导入和解析全程在你这台设备上完成，不上传。记录越多，TA 的语气学得越像，一段几个月以上的对话效果明显好于几十条。 常见错法只导几十条就想看出效果 —— 样本太短，蒸馏出来的语气会偏淡，补一段更长的记录再跑一次。
蒸馏
与校准
导入之后，Oarill 在本机把这几千条对话提炼成 TA 的说话方式、常提的事、和你的关系。这一步没有可调项，不用设置任何参数，等它跑完就行。跑完后可以先问一件只有你们两个人知道的小事，看看它答得像不像 —— 这是最快的校准方式。 常见错法一边等一边反复改设置 —— 蒸馏阶段不接受调参，改动不会让它更快，只会让你多等一轮。
说出
第一句话
不用想开场白。问一句你们以前常说的话，或者把今天发生的事讲一遍，它就会接着往下聊，并且记得你们上次停在哪儿。之后的每一次对话都会补进记忆图谱：说过的话、在意的事、你们的关系，越聊越懂你。此岸和彼岸随时可以切换。 常见错法把它当搜索引擎用 —— 问天气预报、问资料查询，它都不如你手边的工具；它是来接着和你过日子的。
导入记录 · IMPORT
把聊天记录
把聊天记录
交给他
这一页解决「怎么把记录弄出来」。三个平台的步骤都在下面，最后是一份常见报错速查。整个导入和解析过程在你这台设备上完成，文件不上传。
微信导出
在电脑版微信里打开与 TA 的会话，用你习惯的导出方式把这段对话导出成 txt 或 Oarill 已支持的导出文件；回到 Oarill 的导入窗口，把文件拖进去；确认时间范围后开始导入。
如果导出工具给出的是加密或专有格式，先转成 txt 再导入。
- 导出为 txt / 通用导出文件
- 确认时间范围
- 大文件建议分段
iMessage 导出
在 Mac 上选中与那个联系人的整段对话，用系统或第三方导出工具输出成 txt；把文件拖进 Oarill 的导入窗口即可。
注意：iMessage 里的图片和语音不会进入文本，因此不参与蒸馏 —— 只有文字部分会被读到。
- Mac 上操作最方便
- 附件不参与蒸馏
- 只读取文字部分
QQ 导出
在 QQ 的消息管理器里选中目标会话，导出聊天记录（不同版本会给出 txt 或 .bak）；如果是 .bak，先用导出工具转成 txt；再把 txt 拖进 Oarill 的导入窗口。
时间跨度长的会话建议按年份拆成几段，导入和蒸馏都更稳。
- 消息管理器导出
- .bak 先转 txt
- 长会话按年份拆分
通用 txt：任何能导成纯文本的聊天记录都算数 —— Oarill 按时间顺序读取，认的是「谁在什么时候说了什么」。
UTF-8常见报错
文件太大
导入窗口对超大文件的解析会明显变慢甚至卡住。先按年份或月份把记录拆成几段，分批导入；每一段导入完成后再导下一段，蒸馏结果会合并到同一个 TA 身上。
乱码
导出时把编码选成 UTF-8。已经导出的文件，用文本编辑器打开后「另存为」UTF-8 编码，再重新拖进导入窗口。中文乱码几乎都是编码问题，不是文件损坏。
语音消息
语音本身不在文本里，转写后的内容也不会自动出现在导出文件中，因此语音不参与蒸馏。如果那段关系里有大量语音，可以先用系统的转写工具转成文字存成 txt，再一起导入。
图片
图片不进入文本，不参与蒸馏。Oarill 学的是 TA 说话的方式，靠的是文字；图片留作你自己的回忆就好，不需要为了导入去做整理。
全程在本机完成，不上传。导入、解析、蒸馏都在你这台设备上跑，聊天记录不会离开你的电脑和手机。
还有问题？
速查 · TROUBLESHOOTING
常见卡点 Top 5
按出现频率排的。前三条占了我们收到的求助里的大多数。
没收到
授权码邮件
先看垃圾邮件和「促销」「更新」标签页，通常几分钟内就到。如果付款时填错了邮箱，或者超过半小时还没到，写信给我们，附上付款时用的邮箱和大致时间，我们帮你查。
导入后
进度不动
大文件第一次解析会比较慢，保持导入窗口打开不要强制退出。如果几分钟内确实没有任何变化，把文件按年份拆小后重试；拆小之后仍不动，多半是编码问题。
TA 说话
不太像
绝大多数情况是导出量太少。补一段更长的记录再蒸馏一次，差别会很明显。另外，问「你们才知道的小事」比问开放式的大问题更容易验证像不像。
生图很慢
或不出图
生图由本地模型在你的 Apple 芯片上跑，不吃网络但吃算力。先关掉其他占用显存的应用，再把场景描述写得简单一点重试。机器越忙，出图越慢。
Mac 和
iPhone 不同步
两台设备要用同一个授权码激活，并处于同一网络下。同步是点对点的，不经过第三方服务器 —— 所以两台设备需要能互相看见对方。换了网络后等一小会儿再试。
卡住了 · GET HELP
写信给我们，
写信给我们，
我们来接。
把下面四样一起发过来，我们能一次定位问题：设备型号与系统版本、Oarill 版本、出问题时的截图、你导入的文件格式。我们会在【待填：响应时间】内回复。
写信求助发之前先看
- 01上面的 Top 5 覆盖了大多数情况
- 02授权码问题请看价格页的「付款后能拿到什么」
- 03导入问题请附上文件格式与大致大小
- 04涉及隐私的截图可以先打码