AI Coach 使用文档

这是 macOS 版 AI 桌面宠物「AI Coach」的官方使用指南,内容涵盖蛋的养育、语音转写、环形启动器和备忘录等工具、AI 图像与语音生成、Claude 连接、P2P 连接,以及 OpenAI API 和 Gemini API 的设置。
如果你是第一次使用,建议从「1. 开始使用」按顺序读下来。

本文档适用于 AI Coach v1.0.3,规格可能会在后续更新中调整。

1. 开始使用

AI Coach 是什么

AI Coach 是一位常驻在你桌面上的 AI 角色。
它具备语音输入、AI,以及一整套帮你干活的小工具,但最大的特点是 从蛋开始养。你怎么陪它,它就会长成什么样子。

即使角色离开了,语音转文字、AI、实用工具这些主要功能依然照常可用。只是桌面会稍微冷清一点。

安装

macOS

  1. 打开下载好的 .dmg,把 AI Coach.app 拖到「应用程序」文件夹里。
  2. 首次启动时,请右键点击 →「打开」来启动。
  3. 桌面右下角会出现你的小伙伴,菜单栏里也会多一个图标。Dock 里不会显示图标(它以菜单栏应用的形式运行)。

Windows

Windows 版正在开发中,即将推出。目前尚未提供安装程序,以下步骤适用于发布之后。
  1. 运行安装程序(AICoach-Setup-x.x.x.exe)。
  2. 安装完成后,从开始菜单启动。
  3. 任务栏托盘中会出现一个图标。

试用模式(30 天试用)

只有第一次安装时,可以选择是否以 30 天的「试用模式」开始。第一次启动时,黑色画面上的说明播放完后,从「开始试用」「从蛋开始」「再听一次说明」中选择。

试用期间能做什么?

和机器人伙伴「Robo」一起,在养育之前就能使用几乎所有功能。唯一不能用的,是「游戏」中学会之后才下载来玩的游戏。试用期间,购买蛋、孵化和养育都会暂停。

Robo 会怎样?

  • 不会成长,不会变老,也不会因为生病或寿命而离开
  • Robo 的状态既不保存也不同步。每次重新启动应用,都会回到最初的样子
  • 试用期间做的备忘和文件不会被删除

开始需要什么?

  • 需要用 Apple 或 Google 登录
  • 每个账户只能使用一次
  • 只能在开始试用的那台 Mac 上使用

在哪里看剩余天数?

菜单最上方会显示「试用模式(剩余 N 天)」。从这里可以确认结束的日期和时间、查看说明,或选择「结束试用模式,从蛋开始…」。剩余 7 天、3 天、1 天时会通知你。

结束后会怎样?

  • 30 天过后或自己结束时,应用会重新启动,从第一颗蛋(平常的免费蛋)开始
  • 功能会在养育的过程中重新学会
  • 结束之后,就再也无法回到试用。选择「从蛋开始」时,之后也无法再开始试用

不小心关掉了介绍怎么办?

可以从菜单的「试用模式说明…」回到介绍。

需要的权限

权限用途设置位置
麦克风语音输入(转文字)macOS: 系统设置 → 隐私与安全性 → 麦克风
辅助功能获取选中的文本、向其他应用自动输入、环形启动器的按键操作macOS: 系统设置 → 隐私与安全性 → 辅助功能
本地网络连接同一网络中的 Draw Things、llama.cpp 等 AI 时macOS: 首次连接时会弹出确认(系统设置 → 隐私与安全性 → 本地网络)

不授予权限,应用也能正常运行,只是对应的功能会无法使用(未授权时,获取文本只会返回空内容,不会崩溃)。

登录时自动启动

  • macOS: 菜单栏 → 设置 →「登录时启动」
  • Windows: 任务栏托盘 →「🔄 登录时启动」

退出

  • macOS: 菜单栏 →「退出 AI Coach」,或按 Cmd + Q
  • Windows: 从任务栏托盘菜单退出

想让它安静一会儿的时候,可以用右键菜单里的「回家」把角色先收起来。


2. 蛋,和第一个孩子

领取你的蛋

下载应用时,里面已经附带了第一颗蛋。你不需要做任何领取操作。

更多的蛋可以在网站上购买(→「10. 购买蛋」)。买到的蛋会送进 孵化托盘。

孵化托盘

孵化托盘里会显示还没有孵化的蛋的数量。

  • macOS: 菜单栏 →「孵化托盘」
  • Windows: 任务栏托盘 → 库存显示

按下「养育」会消耗一颗蛋,并把这颗蛋放到桌面上。

孵化之前

蛋会随着时间流逝自己慢慢长大。你没法喂它。

  • 过一段时间蛋壳会出现裂纹,然后它就出生了。
  • 关闭应用的这段时间也照样在计时。
  • 还是蛋的时候,它不会说话,也不会走动。肚子饿了会轻轻颤动一下身体。
  • 蛋不会生病,也不会死掉。放心等着就好。
蛋阶段的限制(设计如此):语音输入、剪贴板历史、书签、RSS 阅读器、占卜这些功能,在蛋的阶段还不能使用。从孵化成婴儿开始,会随着成长依次解锁。备忘和成长卡片从蛋的阶段起就能使用。孵化大约需要 1 个小时,关闭应用的这段时间也照样计时。

出生之后会弹出取名字的对话框。名字之后也能改(右键 →「修改名字」)。

只有第一次启动才有的演出

在没有存档数据的情况下首次启动,会有一段简短的演出:昏暗的留白中光影摇曳,蛋浮现出来,伴着一段旁白。这段演出只会出现一次。


3. 养育

可以做的事

右键点击角色,会列出此刻能做的事情。

做什么内容
喂食恢复饱腹度。只有肚子饿的时候它才会接受
让它睡觉恢复体力,消除疲劳。饿着肚子是恢复不了的
去散步身体会变轻快,寂寞也会得到缓解
照顾只在生病时可用。恢复更快,它也最开心
状态确认它现在的情况
查看关系确认它和其他孩子的关系
制作成长卡片…把它现在的样子做成图片卡片分享出去(→「6. 实用功能」)
便捷功能 / 游戏打开已经学会的工具和游戏
收起 / 回家暂时从画面上收起

你也可以用鼠标把它拎起来挪动,或者把文件拖到它身上喂给它吃。常用的项目,也可以从长按 fn 键打开的环形启动器里调出来(→「6. 实用功能」)。

三种需求

角色有「肚子饿了」「困了」「好寂寞」这三种需求。需求变强时,它会向你诉说。

其中只有寂寞有点特别,吃饭和睡觉都消解不了。

  • 带它去散步、把它拎起来 —— 寂寞会减少(散步的效果更好)
  • 照顾生病的它 —— 寂寞会一扫而空
  • 把它扔出去 —— 寂寞会增加
  • 同时放出 2 只以上的时候,寂寞不会累积。它们友好地互发表情符号,也能让寂寞减轻

它诉说需求之后,如果你在 30 秒之内 回应,它会格外开心。

身体状况

  • HP:变成 0 就会结束生命。玩耍能提升上限
  • 饱腹度:一直停在 0,HP 就会持续减少
  • 疲劳度:行动会累积,睡觉可以恢复
  • 免疫力:保持吃饱、不疲劳的状态就会上升。免疫力低时病情会加重
  • 生病:病情加重时它会讨厌散步,食欲也会下降。严重时会不再主动说话

间隔 8 小时以上再启动,会获得免疫力恢复的奖励。

你怎么养,它就长成什么样

「爱玩的孩子」「爱学的孩子」「常被宠着的孩子」——怎么度过这段时间,成长的参数就不一样,而这些决定了它长大成人后的样子。

会变成哪种样子,要到成年才知道。
如果把所有可能的结果都告诉你,那乐趣就没了,所以这里先按下不说。

性格和说话方式

角色会看着你的反应,慢慢改变自己的说话方式。

靠撒娇成功过的孩子会越来越会撒娇;用道理跟你商量而说得通的孩子,会像平等的伙伴一样跟你说话。博取同情、提出交换条件、夸你、或者只是单纯地卖乖——这些都是它自己想出来的办法,只为了让你再看它一眼。

成长阶段不同,说话方式也不同。婴儿只会咿呀几个字,幼儿说短句,少年少女能说成句的话,成年后则会字斟句酌地说话。


4. 成长,以及之后

成长阶段

蛋 → 婴儿 → 幼儿 → 少年·少女 → 成年

阶段推进,能做的事也越来越多。到了少年·少女期会开始萌生爱意,成年后可以结婚和产卵。同时,实用功能会以「学会了!」的形式一点点解锁。

孵化之后的成长,只在应用运行、并且它待在画面上的时候才会推进。现实中的 1 分钟相当于游戏里的 1 小时;从蛋到成年,按应用运行的时间算大约需要 17 小时(游戏里是 42 天)。

收起来的这段时间(dormant),以及关闭应用的这段时间,时间都是不流动的。可以把它想成冬眠。

最多能养多少只?

  • 同时能放在画面上的最多 6 只(连蛋一起算最多 8 只)
  • 收起来的数量没有上限
  • 管理入口在 macOS 菜单栏 →「🐣 角色管理」,Windows 则在任务栏托盘

一起生活

同时放出 2 只以上,它们会互相靠近或走开、聊天,用表情符号传达心情。关系会变好,也会吵架。

成年的男孩和女孩待在一起时,有时会自然而然萌生爱意。你没办法让它们「结婚」。那是它们自己的选择。

成为恋人的两只,在条件齐备时可能会产卵。产卵是削减自己剩余的时间(最大 HP),把它托付给下一个生命的行为。生下来的蛋上,会刻着三代的血脉。

家谱可以从 macOS 菜单栏 →「👪 查看家谱」确认。

生命的终点

HP 变成 0 时,那个孩子就会变成 幽灵。

在变成幽灵之前,它会回顾和你一起度过的日子,为你们之间最常发生的那种相处道一声谢,然后睡去。

幽灵会以半透明的样子留下来。不会饿,不会生病,也没有寿命。不能恋爱,也不能产卵。你可以把它收起来,之后再把它叫回来。

当你做好放手的准备,也可以选择「送它离开」。确认之后,它会回到那片留白里去。留住它,或是放它走,两者都是爱的方式。

送别之后,它的记录依然留在图鉴里。

图鉴

你遇见过的样子、养过的孩子们的记录、它们活过的天数,都会在这里汇集起来。
还没遇见过的样子,连格子本身都是遮住的。里面藏着什么,就请你自己去找找看吧。


5. 声音与 AI

用右 Shift 说话

按住右 Shift 达 0.3 秒以上的期间,语音会变成文字。松手就停止。
快速按两下右 Shift(0.4 秒之内),就能在不一直按着的情况下切换开始与停止。

  • 录音过程中,气泡里会显示波形和正在识别的文本
  • 结果可以直接输入到当前激活的应用里(自动输入的开关可以在设置中切换)
  • 也可以把音频文件拖到角色身上来转成文字(macOS)
  • 登记自定义词汇后,专有名词的识别精度会提高
  • 在 macOS 上,语音转文字完全在本地处理

选择 AI 引擎

你可以根据用途分别使用。

选项特点
Apple 端侧 LLM(macOS Foundation Models)完全本地,超低延迟。看重隐私就选它
llama.cpp / LM Studio(GGUF·本地运行)让你喜欢的开源模型离线跑起来。除了内置的服务器,也能连接 llama-server 或 LM Studio 的外部服务器
OpenAI 兼容 API(任意端点)OpenAI、Groq、OpenRouter 可以直接从预设中选择。Gemini API 等其他兼容端点,也可以连同 API 密钥和模型名一起设置

设置位置

  • macOS: 菜单栏 →「AI 设置…」
  • Windows: 任务栏托盘 →「⚙️ AI 设置」

AI 设置分为「文本生成」「语音转录」「图像生成」「语音生成」「连接」「P2P 连接」几个标签页。本章介绍的是「文本生成」。图像生成和语音生成在「6. 实用功能」中说明,「连接」在「8. 进阶:连接 Claude」中说明,「P2P 连接」在「9. 账户与同步」中说明。

可设置的项目有 端点 / API 密钥 / 模型名 / 最大 token 数 / temperature / 启用·停用。

连接 LM Studio:在「llama.cpp / LM Studio」中选择外部服务器,并在连接地址中填入 LM Studio 的地址(默认是 http://127.0.0.1:1234)。点「获取列表」就能从服务器上的模型中选择,尚未加载的模型也会在第一次请求时自动加载。如果在 LM Studio 中启用了身份验证,请同时填入 API 密钥(密钥只保存在这台设备上)。

连接 Claude、ChatGPT 与 Gemini

与 Claude Desktop / Claude Code 的连接是 MCP 连接,详见下文「8. 进阶:连接 Claude」。你可以在 Claude 里查看宠物的状态,也能通过角色的动作了解 Claude 工作的进展。

想使用 ChatGPT 的模型时,请在「AI 设置…」中填写 OpenAI API 的端点、API 密钥和模型名。这并不是直接连接 ChatGPT 的网页版或你的 ChatGPT 账户。API 的使用条款和费用,请与 ChatGPT 的订阅分开确认。

关于 Gemini 的模型,Google 提供了 Gemini API 的 OpenAI 兼容端点。使用时,请在「AI 设置…」中填写对应的端点、Gemini API 密钥和模型名。这并不是与 Gemini 应用的账户直接关联。能用哪些功能,取决于所选的模型和兼容 API 的规格。

语音转写与这些云端 AI 的设置是相互独立的功能。macOS 版会在本机处理,除了用右 Shift 进行语音输入,也可以把音频文件拖到角色身上进行转写。

在本地使用 llama.cpp 时,上下文长度请指定为 8192 以上。不够的话,部分功能(比如倾诉)将无法使用。

AI 没有响应时,会自动切换成事先准备好的台词,不会陷入沉默。


6. 实用功能

大多数工具,它会随着成长一点一点学会。哪个孩子会学会什么,要养了才知道。工具一旦学会,即使那个孩子不在了,也能继续使用。登录之后,在同一账户的其他设备上也能使用。

一开始就能用的功能

  • 备忘 —— 按 Shift + Cmd + M 打开快速备忘。一条备忘就是一个 Markdown 文件(→ 下文「备忘」)
  • 环形启动器 —— 长按 fn 键打开,是调出已学会的工具和各种照顾的入口(→ 下文「环形启动器」)
  • 成长卡片 —— 把孵化、进化这些重要时刻做成图片卡片分享出去(→ 下文「成长卡片」)
  • 加密 ZIP —— 把文件拖到角色身上时,可以在弹出的确认中把它打包成带密码的 ZIP。密码由那孩子告诉你
  • 图鉴 —— 记录你遇见过的各种样子(→「4. 成长,以及之后」)
  • 作为 Git 文件夹打开 —— 从环形启动器,用一个列表打开你指定的文件夹下面的 Git 项目(→ 下文「Git 项目列表」)

成长后学会的功能

  • 语音转文字 —— 孵化之后就能使用(→「5. 声音与 AI」)
  • 剪贴板历史 —— 可以回看复制过的东西。除了对图片做文字识别(OCR)、写摘要、生成二维码之外,还能找出并去除混在复制文本里的不可见字符(零宽字符、双向控制字符等)
  • 书签 —— AI 会自动打标签、写摘要。支持从 Chrome / Edge 导入,以及失效链接检查
  • RSS 阅读器 —— 双栏界面,Vim 风格的按键操作,支持 OPML 导入导出。它还会跟你聊读过的文章的感想
  • 文本查看器 —— 自动识别 Markdown、Mermaid、PlantUML,并清晰美观地显示出来。代码块带有复制按钮;Python 代码块可以点 ▶ 运行,结果会显示在另一个窗口里。也可以从其他应用的「打开方式」中打开
  • Git 图 —— 把含有 .git 的文件夹拖到角色身上,就会把提交历史画成图。显示时不调用 git 命令,而是直接读取 .git。也可以签出分支,以及获取、拉取和推送(→ 下文「Git 项目列表」)
  • 简易画图 —— 拖入图片时,在弹出的确认中选择「用画图编辑」。支持矩形选区的复制 / 粘贴、马赛克、填充、添加文字、铅笔·画笔·形状以及撤销,可以保存为 PNG / JPEG
  • 问问这是什么(macOS 27 及以上)—— 拖入图片时,在弹出的确认中选择。Apple Intelligence 的内置模型会用那孩子的口吻告诉你图里拍的是什么。图片不会发送到 Mac 之外
  • 动态片段 —— 输入登记好的关键词后按 Space / Tab / Enter,就会展开成固定文本
  • 今日日程 —— 在日程开始前 10 分钟提醒你,并用那孩子的口吻念出当天的日程
  • 占卜 —— 基于出生年月日的 100 种类型分类、当月运势、朋友占卜
  • 倾诉 —— 它会听你说话
  • AI 图像生成 —— 说一句「画个〜」它就会作画(→ 下文「用 AI 生成图像」)
  • 游戏 —— 有的孩子会学会在工作间隙玩的游戏。能玩什么,要等遇见了才知道

除此之外,还有一些功能会在你用得深入之后学会。

设置之后就能用的功能

  • AI 语音生成 —— 在 AI 设置的「语音生成」中保存好生成方式后,菜单和环形启动器里就会出现「生成 AI 语音…」(→ 下文「用 AI 生成语音」)
  • AI 广播 —— 角色学会 RSS 阅读器,且文本生成的 AI 与语音生成都能用时,就能把未读文章变成两人搭档的广播节目来听(→ 下文「AI 广播」)

环形启动器

按住 fn(🌐)键 0.3 秒以上,角色周围就会出现一个圆环。它不会抢走你正在使用的应用的焦点。

操作动作
长按 fn打开圆环(Windows 版为右 Ctrl)
方向键选择项目
松开 fn / Return执行所选项目并关闭。如果选中的是分组,则进入分组
Esc返回上一层。在最上层时,什么也不做,直接关闭
鼠标把指针移到项目上即可选中,点击即可执行
  • 焦点在分组上停留 1.5 秒,不用确认也会自动进入
  • 圆环上放哪些项目、按什么顺序排列,可以在菜单栏设置里的「环形启动器…」中修改。可以从学会的工具、照顾、设置界面和常用应用中挑选,还能归入分组,最多 3 层。在设置界面里把项目拖到圆环外面,就能把它移除
  • 和其他键一起按下时,会当作普通的快捷键(如 fn + F1)处理
  • 短按 fn 时的系统功能(输入表情符号、切换输入法等)照常可用

备忘

按 Shift + Cmd + M,随时都能打开快速备忘。从菜单栏的「备忘录列表」,可以打开带有编辑器、预览和大纲的列表窗口。

  • 一条备忘就是一个 Markdown 文件。不是私有格式,用其他编辑器也能打开
  • 保存位置可以在设置里改成任意文件夹,直接指向 Obsidian 的仓库也可以
  • 可以按分组(文件夹)整理
  • 支持与 Sublime Text 相同的多重选择(Cmd + D 选中下一个相同的词,Shift + Cmd + L 把选区按行拆分,以及矩形选择)
  • Cmd + N 新建备忘,Cmd + E 在预览和编辑之间切换
  • 可以从剪贴板历史等其他工具,把内容存进备忘
  • 删除的备忘会移到系统的回收站,所以还能恢复

也可以让 Claude 帮你读写备忘(→「8. 进阶:连接 Claude」)。还可以通过 P2P 连接,和你自己的另一台 Mac 同步(→「9. 账户与同步」)。

把文件拖到角色身上时

孵化之后,可以把各种东西拖到角色身上。

拖入的东西会发生什么
文件当作一顿饭吃掉,并弹出确认。可以选择加密 ZIP、预览、「用画图编辑」或「问问这是什么」
只有音频文件转成文字
含有 .git 的文件夹显示 Git 图
浏览器中的 URL当作一顿饭吃掉;如果是 RSS / Atom 就订阅,否则登记为书签
来自其他应用的文字用文本查看器显示

预览、「用画图编辑」、「问问这是什么」和 Git 图,要等它学会文本查看器之后才能使用(「问问这是什么」需要 macOS 27 及以上)。在那之前,只能在吃掉和加密 ZIP 之间选择。

Git 项目列表(作为 Git 文件夹打开)

把散落在各个文件夹里的 Git 项目排进一个列表,从这里打开。一开始就能使用(从列表打开 Git 图,要等它学会文本查看器之后)。

使用方法

  1. 在菜单栏设置里的「环形启动器…」中,把「作为 Git 文件夹打开…」放到圆环上,并指定起点文件夹
  2. 在圆环上选择这个项目,列表就会打开
  • 从起点文件夹往下最多搜索 4 层,由浅到深,把含有 .git 的文件夹作为 Git 项目,拆开嵌套平铺在一个列表里。不会进入 node_modules、build、dist、vendor 等文件夹。最多列出 300 个
  • 按最后一次动过的时间排序。输入文字可以按名称筛选
  • 每一行显示图标、名称、上级文件夹、最后一次动过的时间、未提交的更改数、比上游领先 / 落后的提交数、分支、托管服务(GitHub 等)和账户、开放的拉取请求数,以及复制完整路径的按钮
  • 状态直接读取 .git,不调用 git 命令。只有统计拉取请求数时才会用到网络

按键操作(macOS)

按键动作
Return在 Finder 中打开
Option + Return在终端中打开
Cmd + Return / 双击某一行打开 Git 图(列表不会关闭)
Cmd + 1〜9在该文件夹的终端里执行登记的命令
Cmd + C复制完整路径
Cmd + P打开拉取请求
Cmd + R重新搜索
Cmd + ,编辑命令
Esc关闭列表
  • 默认的命令有 git status、git pull --ff-only、claude 三个。最多可以登记 20 个,还可以给每个命令分配在列表里生效的按键

从徽章操作 Git(macOS)

  • 把指针在更改数、领先、落后或分支的徽章上停留 1 秒,或点击它,就能当场提交、提交并推送、推送、拉取、获取
  • 提交信息由本机的 AI 根据差异起草。文本生成的 AI 是云端服务时,会改用 Apple 的设备端模型或内置的 llama.cpp;都没有时就不起草。差异绝不会发送到云端
  • 默认不会把未跟踪的文件放进提交
  • 推送只做快进,不会强制推送。拉取使用 --ff-only

拉取请求(macOS)

  • 列出 GitHub 和 Bitbucket 上开放的拉取请求,并查看详情(作者、分支、能否合并、检查、审查状态)
  • 「对话」标签页像聊天一样按从旧到新显示说明、评论和审查;「文件变更」标签页显示更改内容
  • 可以发送评论、使用常用回复(默认有 LGTM、致谢等 5 条,可以编辑),以及批准、合并、拒绝。每项操作都会先确认,并显示执行操作的账户
  • GitHub 使用 gh 命令的登录(gh auth)。收到的令牌在关闭窗口后就会忘掉
  • Bitbucket 使用 Atlassian 的电子邮件地址和 API 令牌,保存在与 AI 设置中的 API 密钥相同的地方

快捷键(macOS)

在列表的右键菜单「分配快捷键…」中,可以给某个项目的 Finder、Git 图、终端、拉取请求或命令,分配在整个应用里都有效的快捷键。

Git 图

  • 用不同颜色的线道,画出分支的分叉与合流
  • 双击分支名即可签出,右键菜单可以获取、拉取、推送。这时会执行本机的 git(显示时仍然直接读取 .git)
  • 哈希和提交信息,可以用悬停时出现的按钮复制
  • 日期显示为「3 小时前」这样的形式,悬停时显示准确的日期和时间

用 AI 生成图像

学会 AI 图像生成之后,角色的菜单和环形启动器里会出现「生成 AI 图像…」。输入描述,那孩子就会画出来,显示在气泡里。完成的图像点一下就能用简易画图打开,并以 PNG 格式保存在 ~/Pictures/AI Coach/。

生成方式在 AI 设置的「图像生成」标签页中选择。

生成方式特点描述的去向
设备端(Image Playground)在支持 Apple Intelligence 的 Mac 上,只在本机内生成不发送
Draw Things通过 Draw Things 的 HTTP API(默认是 http://127.0.0.1:7860)使用你手边的模型。可以选择模型、步数、采样器、CFG 和尺寸,还能固定种子。点「从 Draw Things 读取」,可以直接套用 Draw Things 中当前选择的设置你设置的 URL(默认是这台 Mac)
OpenAI API(GPT Image 2.5)可以选择尺寸、质量和背景(支持透明)。API 密钥与「文本生成」中的 OpenAI 共用OpenAI
Gemini API(Nano Banana)使用 Google AI Studio 的 API 密钥。可以选择宽高比(10 种)和分辨率(1K / 2K / 4K)Google
通过 MCP(Codex CLI)用你自己账户的 Codex CLI 生成OpenAI
Cursor CLI用你自己账户的 Cursor CLI 生成Cursor
  • 描述最多可以输入 2,000 字。发送时会按各生成方式能接受的长度截断
  • 在「描述的语言」中,可以为每种生成方式分别选择是否 先将描述翻译成英文再发送(Draw Things 默认开启)。macOS 上使用 Apple 的翻译功能,翻译时描述不会离开本机。台词和成品图的气泡里显示的仍是原来的描述
  • 使用外部的生成方式时,可能需要几分钟才能完成(久的时候大约 10 分钟)
  • 失败时,会在气泡里附上原因(密钥错误、用量额度、安全过滤等)
  • 连接测试不会生成图像,只确认能否连上
  • 费用以所选服务的条款为准。AI Coach 不会额外收费

用 AI 生成语音

在 AI 设置的「语音生成」标签页中选好生成方式,并在可用的状态下保存后,角色的菜单和环形启动器里就会出现「生成 AI 语音…」。输入文本,就会转成语音,保存到 ~/Music/AI Coach/。打开「生成后立即播放」,生成后马上就能听到。

生成方式特点文本的去向
ElevenLabs用 Eleven v4 / v4 Turbo 生成富有表现力的朗读,格式为 MP3。可以从账户的声音列表中挑选并试听,也可以直接输入声音 IDElevenLabs(使用你的 API 密钥,会消耗额度)
Irodori-TTS + speech.cpp(本地)用 speech.cpp 运行 Irodori-TTS 等模型,在这台 Mac 内生成 WAVE 格式的语音不发送(只有首次使用某个模型时,才会从 Hugging Face 下载)
  • 要使用 Irodori-TTS + speech.cpp,需要先准备好 speech 命令(用 speech.cpp 的安装程序,或从源码构建)。它的位置在 AI 设置的「语音生成」中指定
  • 模型会在首次使用时下载(1~2 GB)。也可以先在 AI 设置中下载好;连接测试时还能确认模型的许可证和来源。Irodori-TTS 每个模型约占用 2 GB 内存
  • speech.cpp 和模型不包含在 AI Coach 中,须按照各自作者的条款使用。请勿在未经本人同意的情况下复制他人的声音或冒充他人

AI 广播

AI 广播会把未读的 RSS 文章每 3 篇做成一档广播节目,由画面上的两只角色搭档主持。主持人介绍新闻,搭档回以感想和朴素的提问。台本由文本生成的 AI 撰写,声音由语音生成的方式制作。

收听方式

从角色菜单的「RSS 阅读器」→「收听 AI 广播」,或环形启动器里的「广播」开始。播放期间,菜单会变成「停止 AI 广播」。

  • 画面上只有一只角色时,会有一只你在图鉴中遇到过的角色作为嘉宾来访,节目结束后回家
  • 开始时,角色会用气泡告诉你选了几篇文章,以及正用哪个 AI 在准备(文本 AI 与模型、朗读方式)
  • 只要还有未读文章,就会每 3 篇一组一直播下去,直到你停止。播完的文章会标为已读
  • 话题切换时,如果文章有图片,会显示在主持人的气泡里。点击气泡就能在阅读器里打开那篇文章
  • 两人的声音会按照各自角色的性格、说话方式和年龄来挑选
  • 语音转文字和倾诉期间会暂停,结束后从中断处继续
  • 播放期间把鼠标移到主持的角色上,会出现暂停按钮和音量滑块
  • 如果台本由云端 AI 撰写,或用 ElevenLabs 朗读,开始前会显示 token 数和字数的估算,请你确认

在 RSS 阅读器的菜单中可以打开下面 3 项(默认都关闭)。

项目内容
保存 AI 广播节目把每次播放存成一个 WAVE 文件,保存在 ~/Music/AI Coach/
AI 广播也读取文章网页正文只对摘要较短的文章读取文章网页,把正文用作台本的素材
将 AI 广播的台本存入备忘录把播过的台本按文章整理,存成「AI 广播」分组的备忘

完全在本地收听 AI 广播(推荐)

台本 AI 和声音都在自己的 Mac 上运行时,制作节目不会把文章或台本发到云端。我们推荐下面的配置。

角色推荐运行位置
台本(文本生成)LM Studio + Qwen3.8 27B(qwen/qwen3.8-27b)运行模型的 Mac(通过 P2P 连接共享)
声音(语音生成)Irodori-TTS + speech.cpp(模型 irodori-tts-mf)收听广播的 Mac
文章素材打开「AI 广播也读取文章网页正文」收听广播的 Mac

27B 的模型很大,推荐在内存充裕的 Mac 上运行 LM Studio,再从平时使用的 Mac 通过 P2P 连接借用。也可以在一台 Mac 上同时运行两者。

1. 准备声音(收听广播的 Mac)

  1. 菜单栏 →「AI 设置…」→「语音生成」,把生成方式选为「Irodori-TTS + speech.cpp(本地)」
  2. 如果找不到 speech 命令,就点「安装 speech.cpp」。接着会下载模型(默认的 irodori-tts-mf,约 1.9 GB)
  3. 保存。准备好后,角色会用气泡告诉你

用 Irodori-TTS 朗读时,台本里会加入改变读法的表情符号(附和、惊讶、偷笑等),搭档的附和与笑声会体现在声音里。表情符号不会显示在气泡里。

2. 准备台本 AI(运行模型的 Mac)

  1. 安装 LM Studio,下载并加载模型(例如 qwen/qwen3.8-27b)
  2. 在 LM Studio 的开发者界面启动本地服务器(默认是 http://127.0.0.1:1234)

3. 通过 P2P 连接借用 AI

  1. 在两台 Mac 上登录同一个账户,并分别在菜单栏的「AI 设置」→「P2P 连接…」中开启(→「9. 账户与同步」中的「让自己的 Mac 互相连接(P2P 连接)」)
  2. 在运行模型的 Mac 上,于「共享此 Mac 的 AI」中选择 OpenAI 兼容(LM Studio、Ollama 等)。端口留空,就会自动找到正在运行的服务器
  3. 在收听广播的 Mac 上,保持「自动使用借来的 AI」打开(默认打开)。只要有借来的文本 AI,AI 广播就会优先于 AI 设置使用它

如果要在一台 Mac 上完成,就不用 P2P 连接:在 AI 设置 →「文本生成」中选择「llama.cpp / LM Studio」→ 外部服务器,连接地址填 http://127.0.0.1:1234,再从「获取列表」中选择模型。

4. 收听

  1. 在 RSS 阅读器的菜单中打开「AI 广播也读取文章网页正文」(只有标题的文章也能聊得更丰富)
  2. 选择「收听 AI 广播」。如果开头的气泡显示「台本:通过 P2P 连接借用的 AI(qwen/qwen3.8-27b)」和「朗读:Irodori-TTS + speech.cpp(本地)」,就说明完全在本地运行

在这个配置下,会发到外部的只有:抓取 RSS 订阅源和文章网页(访问那些网站)、第一次使用模型时的下载(Hugging Face),以及 P2P 连接为寻找另一台 Mac 而进行的通信。台本和声音都在自己的 Mac 上生成,也不会出现确认窗口。

成长卡片

孵化、进化、学会新工具等重要时刻,都可以做成 1200×675 的图片卡片。到了这些时刻,它会问你要不要做一张卡片;也可以随时从角色右键菜单的「制作成长卡片…」来制作。

  • 可以复制图片、复制配文、导出 PNG,或者分享
  • 可以打开 X、Bluesky、Discord 的发帖界面。发不发由你决定,AI Coach 不会自动发帖
  • 卡片只在本机内制作,也不会保存社交平台的认证信息

关于倾诉

可以从右键菜单开始。它不评判,也不硬塞建议,只是听着,最后递给你小小的下一步。

对话内容不会被保存。 关闭窗口的那一刻就从内存中消失。
当你的情绪显得非常痛苦时,画面上会显示专业的求助渠道。

每个角色的对话都是分开处理的。


7. 快捷键

macOS

按键动作
长按 右Shift语音输入(按住 0.3 秒以上开始,松手停止)
右Shift ×2语音输入的开·关(0.4 秒之内按两下)
长按 fn(🌐)环形启动器(按住 0.3 秒以上打开)
Shift + Cmd + M快速备忘
Shift + Cmd + C剪贴板历史
Shift + Cmd + B书签
Shift + Cmd + RRSS 阅读器
Shift + Cmd + P选择片段模板
Shift + Cmd + S今日日程
Cmd + Q退出
Cmd + V(书签界面内)批量添加 URL(换行分隔)

语音输入、剪贴板历史、书签、RSS 阅读器、片段和今日日程的快捷键,要等它学会相应的工具之后才能使用。快速备忘和环形启动器一开始就能用。

Windows

按键动作
长按 右Shift / ×2语音输入
长按 右Ctrl环形启动器
Ctrl + V(书签界面内)批量添加 URL

倾诉功能没有分配快捷键,请从右键菜单打开。


8. 进阶:连接 Claude

此功能率先在 macOS 版推出,Windows 版将在后续更新中支持相同内容。

能做什么

AI Coach 可以 被 Claude 搭话 了。

问一句「我家孩子还好吗?」,Claude 就会告诉你它现在的身体状况和心情。
说一句「喂它吃饭」,在你确认之后,桌面上的孩子就真的会吃起来。
而当 Claude 在做一件长活儿的时候,桌上的小家伙会跳一跳、停一停,把进展告诉你。

就算你没盯着屏幕,也能从桌上那个小生命的动作里知道「还在跑」「跑完了」。这是这个联动最想做到的事。

除此之外,还可以请它生成图像和语音、读写备忘,或者打开仓库的 Git 图。

我们不是想再加一个 AI,而是想让与 Claude 的对话,连到桌面上的那个小生命。

连接需要什么

需要满足
AI Coach正在运行,并且至少有 1 只孩子在画面上
Claude 一侧已注册 AI Coach 的联动(MCP 服务器)
设置AI Coach 一侧已启用联动

所有交互都 只在这台设备内 完成,不经过互联网。

连接方法

  1. 打开 AI Coach 的菜单栏 →「AI 设置…」→「连接」标签页
  2. 在「连接 Claude」中,点你要用的应用对应的「添加」(如果联动还没开启,会自动开启)
  3. 第一次连上时,AI Coach 会向你确认是否允许这次连接

Claude Desktop 会打开一个确认界面,点「安装」就完成了,不需要 Node.js。

Claude Code 会注册为在任何项目中都能使用。需要 PATH 中有 Node.js 22 或更高版本。已经打开的 Claude Code,请用 /mcp 重新连接,或者开始一段新的对话。

Cursor 等其他应用,请复制「手动连接」中的配置并粘贴。是否已经添加、有没有新版本,都会显示在同一个界面上。

可以拜托的事

拜托的事会发生什么
问问状态读取当前的健康·饥饿·疲劳·心情,汇总成一张小小的状态卡
刷新重新获取当前显示的状态
准备照顾弹出「要做什么」的确认卡。在你同意之前不会执行
执行照顾只有你同意过的照顾,才会反映到桌面上的孩子身上
让它说一句把 Claude 想的一句短话,显示在那孩子的气泡里
汇报工作情况用那孩子的动作,传达 Claude 的思考中·工作中·等待回复·成功·失败
显示文件用 AI Coach 的查看器打开允许格式的文件
显示 Git 图用 AI Coach 的 Git 图打开仓库的提交历史
生成图像用 AI 设置「图像生成」中选择的方式作画,显示在气泡里并保存到「图片」。保存位置会返回给 Claude。使用 OpenAI API、Gemini API、Draw Things 时,还能指定宽度和高度(128~4096 px)。要等那孩子学会 AI 图像生成之后才能使用
生成语音把文本转成语音保存到「音乐」,还可以选择是否当场播放。也可以让它从 ElevenLabs 的声音列表中挑选要用的声音
读写备忘列出、读取、搜索、写入、移动、丢掉备忘(→ 下文「让它读写备忘」)

有多只孩子时,会把名字和状态并排列出。不会在「对谁做什么」还含糊的情况下执行。

在 Claude 中显示的 AI Coach 仪表盘,有 HP、饱食度、疲劳、疾病、免疫的条,以及喂饭、睡觉、叫醒、散步、照顾病人的按钮
画在 Claude 里的 AI Coach 仪表盘。当场读出体调和心情,按钮也能直接拜托照顾。截图为英文界面。

让它替你盯着工作

这是这个联动最有特色的地方。Claude 工作的时候,那副样子会体现在吉祥物的动作上。

左边是 Claude 里的仪表盘,右边桌面上的机器人角色正冒出工作中的对话气泡
左边是 Claude 里的仪表盘,右边是桌面。工作的时候会冒出 🛠,原地跳一下告诉你。
Claude 的状态那孩子的样子
思考中停下走动,站住不动,冒出 🤔
工作中原地跳 1 次,冒出 🛠
等待回复站着不动并连续跳,一直举着 🙋
顺利完成大大地跳 1 次,冒出 ✅ 并高兴起来
没能完成低而急促地连跳,冒出 ⚠️
结束回到平时的样子

跳法是 影子留在地上,只有角色弹起来 的原地跳。和 macOS Dock 图标弹跳是同一种动作,所以一定能和平时的溜达区分开。

  • 长时间的工作不会一直冒气泡,只是偶尔跳一下、冒个小表情
  • 思考的时候反而会停下溜达,站在原地
  • 这类提示不会扣 HP。 完全不碰养成参数,也不会有音效
  • 最长 15 分钟会自动消失。就算 Claude 那边悄悄停了,也不会一直留着「工作中」
  • 睡着的孩子·蛋·幽灵·收起来的孩子不会显示。倾诉中·对话中·转文字中同理
  • 即使在工作中,被你捏起来的反应和需求的表达都照旧。它不会变成摆设

拜托照顾

能拜托 Claude 的只有 喂饭 / 睡觉 / 叫醒 / 散步 / 照顾病人 这 5 件。

一定会出现确认。 不存在仅凭 Claude 的判断就改变养成参数的路径。

从仪表盘按钮操作时可以用「下次不再显示」跳过确认,但 由 Claude 拜托的照顾,无论该设置如何,每次都会确认。

写着要执行这个操作吗的确认卡片,上面有喂饭的执行按钮、取消按钮和确认的剩余时间
照顾一定会经过这张确认卡片。在你批准之前,养成参数不会动。

购买·孵化·取名·更换角色·恋爱与产卵·告别都不在联动范围内。这些是要由你亲手决定的事。

让它显示文件

可以用 AI Coach 的查看器打开 Claude 正在处理的本地文件。

类别扩展名上限
文本 / Markdown / Mermaidtxt md markdown mmd mermaid2 MiB(UTF-8)
图片jpg jpeg png heic webp svg25 MiB
  • 读取文件的只有 AI Coach。 内容、图片数据、完整路径都不会返回给 Claude
  • Mermaid 用应用内置的渲染引擎显示,不会去外部获取
  • 含有脚本或外部引用的 SVG 不会打开
  • 不只看扩展名,会确认内容之后再显示

说一句「把这个文件用 AI Coach 显示出来」,就能在不让 Claude 读取内容的前提下,只在手边的屏幕上查看。

让它读写备忘

可以让 Claude 替你记下想到的事,或者把以前写的备忘翻出来。不需要插件,也不需要另外一个服务器,AI Coach
自己就能完成。

拜托的事会发生什么
列出备忘把保存的备忘按时间从新到旧排开。不读正文,只看标题和开头几行
读一条备忘只读你指定的那一条的正文
搜索备忘在标题和正文中一起找
写备忘新建、改写,或者在末尾追加
移动备忘移到别的分组(文件夹)
丢掉备忘把一条移进回收站。还能找回来

备忘的读写,要等那孩子学会相应的工具之后才能使用。关闭 AI 设置「连接」中的「允许读写备忘录」,就能在保留其他联动的同时,只拒绝备忘的读写。

Claude 的回答里列出了三条备忘,只显示标题和分类
拜托它「列一下备忘」的样子。过去的只有标题和分类,不会去读正文。
保存位置默认路径
macOS~/Library/Application Support/AICoach/Memos/
Windows%APPDATA%\AICoach\Memos\
  • 保存位置可以在设置里改成任意文件夹,直接指向 Obsidian 的仓库也可以
  • 存的就是普通的 Markdown 文件,不是私有格式,任何编辑器都能打开
  • Claude 不会自己去翻。 列表只返回标题和开头几行,正文只在你开口让它读、让它找的时候才会送出去
  • 一次最多写入 32 KiB,一次最多读取 32 KiB(长备忘会分几次读完)。单条上限为 1 MiB
  • 列表最多 200 条,搜索结果最多 50 条
  • 改写之前会确认自读取以来内容有没有变过。如果期间被别处改动,它会重新读取,而不是覆盖
  • 删除是移动到操作系统的回收站,所以弄错了也能撤回

建议交给 Claude 的指示

把下面的内容贴到 Claude 的「指示(Instructions)」里,它就会不用你每次开口,主动汇报工作情况。可以直接复制使用。

你与 AI Coach 联动。请按以下规则使用可用的 AI Coach MCP 工具。

【基本方针】
- 通知只是辅助显示。重要的结果、问题、错误必须同时写在回答正文里。
- 除了打招呼和一句话的问题之外,在调查、编辑、生成、构建、测试等多步骤工作中,请报告进度。
- 通知中不要包含机密信息、认证信息、个人信息、文件正文或冗长日志。

【工作情况】
- 思考方案时,用 `report_ai_coach_activity` 的 `thinking`;实际作业中用 `working`。
- 等待用户回答或确认之前发送 `waiting`;完成时发送一次 `succeeded`;确定无法完成时发送一次 `failed`。
- `label` 请写成能看出当前状况、不超过 60 个字符的短句。不要反复发送相同的状态和措辞。

【状态确认与照顾】
- 被问到近况时,使用 `open_ai_coach_dashboard` 或 `refresh_ai_coach_status`。
- 照顾请先用 `prepare_ai_coach_care` 出示内容,只有在用户明确确认之后才使用 `commit_ai_coach_care`。不要自行执行。

【消息与文件】
- `show_ai_coach_message` 只用于简短鼓励,或用户希望吉祥物说的内容。
- `show_ai_coach_file` 仅限用户要求显示的本地文件,不要把内容或完整路径转载到回答或通知中。

【备忘】
- 只有在用户提出要查找、阅读或记录的时候才读写备忘,不要自己翻看。
- 改写已有备忘前必须先读取并传入 `expectedModifiedAt`,发生冲突时重新读取,不要覆盖。
- 正文超过 32 KiB 时,先创建再追加。只有在被要求时才删除。
- 不要把备忘的内容转抄到所托付的用途之外。

【图像、语音与 Git 图】
- 只有在用户提出要求时,才使用 `generate_ai_coach_image` / `generate_ai_coach_audio` 生成图像或语音。可能需要几分钟才能完成。
- 选择声音时,先用 `list_ai_coach_voices` 获取列表,再传入要用的声音的 `voiceId`。
- `show_ai_coach_git_graph` 只用于用户说想看的仓库。

【失败时】
- 即使 AI Coach 未启动或未连接,只要还能继续原本的请求,就继续做。不要反复重试同一次连接失败。
- 最终回答要写成即使没看到吉祥物的显示,也能理解结果和下一步操作。

目的只有一个:开始了的事,也要告知它结束了。 别只在开头跳一下,然后让人不知道到底做完没有。

安全与隐私

  • 交给 Claude 的只有身体状况、心情这类 最低限度 的信息
  • 个人信息、认证信息、API 密钥、整份存档都不会交出去
  • 不会自动发送剪贴板、日程、RSS、转文字的内容
  • 不会把角色的图像和素材交到外部
  • 指代那孩子的 ID 是化名,无法与其他设备或其他安装比对。也可以在设置里选择「每次启动都更换」
  • 改变状态的操作,一定会经过你的确认
  • 请它生成图像或语音时,描述和文本会发送到 AI 设置中所选的去向(设备端和 Irodori-TTS + speech.cpp 除外。→「11. 隐私与数据」)
  • 联动随时可以在设置里关闭

不过,给 Claude 看过的信息会成为 Claude 一侧的处理对象。 即使是在设备内完成的联动,这一点也不会改变。请以「不想给的就不给」为前提使用。


9. 账户与同步

登录

不注册账户也能马上开始使用。之后可以再关联 Google 或 Apple 账户。

只有以下情况需要登录。

  • 购买蛋的时候
  • 把数据迁移到其他设备的时候
  • 使用 P2P 连接的时候
  • 开始试用模式的时候

会同步的内容

登录之后,以下数据会保存到云端。

  • 角色的状态(身体状况·成长·血脉·关系·回忆)
  • 主人的资料(昵称·出生年月日·出生时间)
  • 蛋的购买记录
  • RSS 订阅的源、动态片段、自定义提示词
  • 学会的工具和图鉴(在一台设备上学会的工具,在其他设备上也能用)

不会同步的内容:语音转文字的历史、窗口位置、缓存。

云端同步只在购买过至少一颗蛋的账号上启用。如果你只使用随应用附带的那颗蛋,数据只会保存在本机。

同步的时机

同步由应用自动完成,不需要任何设置或操作。

  • 保存:执行「回家」时 / 变成幽灵时 / 应用退出时 / 睡眠时
  • 读取:启动时 / 从睡眠唤醒时 / 登录时 / 购买生效时

离线也照样能养。 就算没连网,它也一直陪着你。

在其他设备上继续

在新设备上登录同一个账户,就能继承数据。如果这台设备上还什么都没养,云端的数据会直接载入。

如果在多台设备上养过,系统会自动合并。购买记录和成长记录不会被回退。不过身体状况(HP·饱腹度·疲劳)以较新的记录为准,所以可能会有前后变化。

只有在最后一次更新相差 7 天以上时,才会弹出对话框询问你要用哪一边。无论选哪一边,购买记录都一定会被继承。

让自己的 Mac 互相连接(P2P 连接)

把登录了同一账户的你自己的几台 Mac,通过 P2P 直接连接起来。这是与云同步不同的另一套机制,可以:

  • 同步 RSS 订阅源、备忘录和快捷键分配
  • 在一台 Mac 上使用另一台 Mac 上运行的 AI(Draw Things、llama.cpp、LM Studio 等)
  • 借用一台 Mac 的 SSH,从另一台 Mac 或 iPhone、iPad 登录它
这是一项实验性功能。它的行为和界面可能会在今后的更新中改变。

如何开始

  1. 在每台 Mac 上登录同一个 Apple 或 Google 账户
  2. 打开菜单栏的「AI 设置」→「P2P 连接…」,开启「与我其他设备上的角色连接」
  3. 在另一台上也同样开启后,它就会出现在「设备」列表里;连上之后会显示「已连接」

同一账户的另一台设备出现在列表里时,启动一段时间后,角色身边会询问一次,问你要「连接」还是「暂不」。选择「连接」就会开启。不需要输入任何密钥或号码。

同步

在设置界面的「同步」中,从「RSS 订阅源」「备忘录」「快捷键分配」里选择要同步的种类(默认全都不同步)。只会与开启了同一种类的设备同步。

  • 不论在哪一台上新增或改写的内容,两边都会保留。第一次同步时,会把两边的内容合并到一起
  • 在一台上删除的内容,另一台上也会删除(备忘会移到回收站)
  • 如果两边都改写了同一条备忘,较新的一份保留原来的名字,另一份则在名字后加上「(设备名 的冲突副本)」保留下来
  • 一次删掉大量内容的变化(对方的列表变空,或者 10 项以上且超过一半消失)会被当作意外,不会删除。更改了备忘的保存位置时,也不会删除,而是合并
  • RSS 只同步订阅源的登记以及是否定期抓取,不同步文章、已读和星标
  • 设备那一行会显示「已同步 <时间>」。点「立即同步」可以重新发送

借用另一台 Mac 的 AI

在出借的 Mac 上,于设置界面的「共享此 Mac 的 AI」中,从 Draw Things、llama.cpp(llama-server)、LM Studio 或 Ollama 等(OpenAI 兼容)中选择要共享的 AI(默认全都不共享)。

  • 端口一栏留空时,会自动找到这台 Mac 上正在运行的服务并共享。那一行下面会显示「正在端口 7860 上运行」之类的提示
  • 在借用的一方,「自动使用借来的 AI」(默认打开)会把收到的 AI 填入 AI 设置。连接断开 90 秒后,或关闭 P2P 连接时,会恢复原来的设置
  • 想手动填入时,点设备那一行下面本机 URL(http://127.0.0.1:<端口号>)旁的「使用」。会把它填入 AI 设置,并切换到对应的生成方式或提供方
  • 能访问到的,只有出借方 Mac 上 127.0.0.1 的那个端口

出借与借用 SSH

在出借的 Mac 上,开启设置界面的「共享此 Mac 的 SSH」(默认关闭。端口一栏留空时为 22)。

  • 需要在 Mac 上打开「远程登录」(「系统设置」→「通用」→「共享」)。那一行下面会显示 SSH 是否在运行以及登录名
  • 建议把远程登录设置成只允许密钥登录、不允许密码登录
  • 在借用的一方,设备那一行下面会显示 ssh -p <本机端口> <登录名>@127.0.0.1 和「拷贝」按钮。拷贝后粘贴到终端,就能登录出借方的 Mac
  • 借来的 SSH 不会填入 AI 设置
  • 也可以从 iPhone、iPad 使用(→ 下文「在 iPhone 和 iPad 上使用 Mac 的终端(Terminal AI Coach)」)

不让此 Mac 睡眠

在设置界面开启「不让此 Mac 睡眠」(默认关闭)后,只要 P2P 连接已开启并且正在共享 AI 或 SSH,即使没有操作,Mac 也不会睡眠。因为 Mac 睡眠后,借用的一方就连不上了。

  • 显示器仍会照常关闭
  • 合上盖子后仍会睡眠

AI 设置中的「P2P 连接」页面

在 AI 设置左侧列表里的「P2P 连接」中,可以查看当前状态(关闭、等待中、与几台设备相连、正在借用的 AI),以及工作原理、用途和入门说明。点「打开 P2P 连接设置…」会打开设置界面。AI 设置中 llama.cpp 外部服务器一栏和 Draw Things 的 URL 一栏下面,也会显示提示。

停止与移除

  • 关闭「P2P 连接…」里的开关,随时都能停止
  • 不再使用的设备,可以用设置界面列表里的「移除…」移除。被移除的设备会自己关闭 P2P 连接;想再次使用时,在那台设备上重新开启即可

安全机制

  • 每台设备的密钥会自动生成。既不会给你看密钥或号码,也不需要你输入
  • 只有同一账户设备列表里的设备,才能在连接握手时通过
  • 通信经过加密,连上之后的数据直接在两台设备之间传输,不经过服务器
  • 为了找到要连接的对方,会使用公共的分布式网络(HyperDHT)。会发往外部的信息,汇总在「11. 隐私与数据」中

在 iPhone 和 iPad 上使用 Mac 的终端(Terminal AI Coach)

正在准备于 App Store 上架。

iPhone、iPad 应用「Terminal AI Coach」会通过 P2P 直接连接 Mac 用 P2P 连接出借的 SSH,让你在 iPhone、iPad 上操作 Mac 的终端。不需要开放端口、VPN 或固定 IP。

使用前的准备

  1. 在 Mac 上打开「远程登录」(「系统设置」→「通用」→「共享」)
  2. 在 Mac 的 AI Coach 中,开启 P2P 连接和「共享此 Mac 的 SSH」(→ 上文「让自己的 Mac 互相连接(P2P 连接)」)
  3. 在 iPhone、iPad 的 Terminal AI Coach 中,用与 Mac 相同的 Apple ID 或 Google 账户登录。开启了 P2P 连接的你自己的 PC 会出现在列表里
  4. 拷贝应用的公钥,添加到 Mac 的 ~/.ssh/authorized_keys 中
  5. 点「Open Terminal」登录 Mac

终端的特点

  • 用只属于那台设备的 Ed25519 密钥登录。私钥不会离开设备
  • 第一次连接某台主机时会核对主机密钥的指纹,指纹变化时会发出警告并停止
  • 提供 Esc、Tab、Ctrl、方向键等辅助键,也支持外接键盘
  • 用两根手指捏合可以改变文字大小
  • 可以缩成小窗口(迷你),一边看 PC 列表一边留意状况
  • vim、top 这样的全屏应用也能运行
  • 不登录也可以用「Try the Demo」试用
  • 可以在应用内删除账户
  • 需要 iOS 17 或更高版本

10. 购买蛋

方案

价格蛋每个单价
应用附带免费1 个—
STARTER$5 USD1 个$5
BUNDLE$20 USD5 个$4(优惠 20%)

一次性买断。 不是订阅制。买过一次就不会再收取额外费用。

购买方式

  1. 应用菜单 →「购买蛋…」会打开浏览器(也可以直接访问 aic0t.com)
  2. 用 Google 或邮箱登录
  3. 选好数量,进入 Stripe Checkout
  4. 完成付款后,蛋就会送进孵化托盘

支持银行卡 / Apple Pay / Google Pay / Link。付款由 Stripe 处理,我们不会保存你的卡片信息。收据会自动发送到邮箱。

到账时机

付款完成后,如果应用正在运行,蛋会直接送达。如果没有运行,下次启动应用时它就会出现在孵化托盘里。

关于高级蛋

从购买的蛋里出生的孩子,第 1 代的基础能力(最大 HP、免疫力初始值等)会稍高一些。极少数情况下,还会以限定颜色出生。

这不是 Pay to Win。 会长成什么样子是没法指定的。那是由你怎么养决定的。

退款

在购买后 7 天之内,且需要退款的蛋还没有孵化(尚未开始养育)时,可以提出申请。如果 5 个装里只有一部分未使用,我们也会考虑按相应比例部分退款。请通过咨询表单联系我们。

本政策不会限制你在适用法律下享有的权利。


11. 隐私与数据

在本地运行的部分

  • 语音转文字(在 macOS 上完全离线处理)
  • 选择 Apple 端侧 LLM / llama.cpp 时的 AI 处理
  • 图像生成选择「设备端」(macOS)、语音生成选择 Irodori-TTS + speech.cpp(本地)时的生成
  • AI 广播的台本选择 Apple 端侧 LLM / llama.cpp(含 LM Studio)、朗读选择 Irodori-TTS + speech.cpp(本地)时的节目制作
  • 存档数据的读写

存档数据会以 AES-256-GCM 加密 后保存在本地。角色的图片和数据也收在加密容器中,解密只在内存里进行。

会发往外部的内容

  • 配置了 OpenAI 兼容 API 时:交给 AI 的内容会发送到你指定的端点
  • 启用「工作上下文」时:当前激活的应用名、窗口标题、选中的文本会作为提示信息提供给 AI。关掉它就完全不会获取
  • 书签的 AI 打标签·摘要:页面内容会交给 AI
  • RSS 阅读器:获取订阅源需要联网
  • 检查新版本(自动更新):为了确认是否有新版本,应用会在启动 1 分钟后以及之后每 6 小时,从分发服务器(dl.aic0t.com)获取最新版本的信息。只会表明应用的版本、构建号和操作系统,不会发送账户、设备 ID 或角色的信息。如有新版本,会从同一服务器下载安装文件(这些下载不计入网站的下载次数)。默认开启;在菜单中关闭「自动更新」后不会自动检查,只在你选择「检查更新…」时联网
  • 已学会的游戏的数据:有些游戏不包含在安装文件中,孩子学会之后,应用会从分发服务器(dl.aic0t.com)下载游戏数据(已加密)。学会游戏时会询问能否下载,在你同意后或想玩的时候下载。安装之后,会在启动时以及每 6 小时检查是否有新版本,有新版本时重新下载(这项检查只表明应用的版本、构建号和操作系统)。每次下载前,应用会把你的账户 ID(未登录时为自动创建的匿名 ID)、设备 ID、游戏的种类与版本、应用的版本、构建号和操作系统发送到我们的服务器(Firebase)进行记录,并获得 1 小时内有效的下载 URL。下载之后,还会把是否下载成功(失败时的类型)发送到同一条记录。这些记录用于处理咨询、发现未经授权的下载以及统计使用情况。不会发送角色的信息、游玩记录或电子邮件地址。下载之后可以离线游玩
  • 云同步:上文「会同步的内容」中列出的内容
  • 领取第一颗蛋与试用模式:为了让同一台 Mac、同一个账户不能反复领取第一颗蛋(试用蛋),首次启动时,应用会把由这台 Mac 的硬件标识符生成的哈希值(不会发送标识符本身)发送到我们的服务器(Firebase),并与账户 ID(未登录时为自动创建的匿名 ID)一起记录。开始试用模式时,会把开始时间(服务器时间)和同一哈希值,结束时会把结束时间和原因(自己结束或到期),记录到你账户的云端(与同步相同的位置)。这些只用于保证「每个账户 1 次、只在开始的那台 Mac 上」,不会发送试用期间 Robo 的状态或你用过的功能
  • 开启 P2P 连接时:这是把你自己各台设备上的同一角色连接起来的功能(需要登录,默认关闭;只有在询问时选择「连接」,或从菜单「P2P 连接…」开启后才会运行)。为了找到你的其他设备,应用会加入任何人都能参与的公共分布式网络 HyperDHT。网络中的节点(hyperdht.org 的引导节点,以及世界各地参与者运行的节点)能看到本机的 IP 地址和端口,以及 P2P 用的公钥(为每台设备随机生成、在该设备上一直使用的密钥,不含账户、邮箱或角色的信息);在连接时居中牵线的节点还能看到两台设备的 IP 地址。设备之间交换的内容经过加密,节点无法读取。由于任何人都能运行节点,节点如何处理看到的信息取决于各自的运行者
  • P2P 连接的设备列表:为了确认哪些设备可以连接,P2P 用的公钥、设备名(计算机名)和操作系统会保存到你账户的云端(Firebase)。关闭 P2P 连接或退出登录时,会把本机从列表中删除,并撤回在 HyperDHT 上的公告(与节点之间的路由确认会持续到你退出应用为止)
  • 通过 P2P 连接相连的你的其他设备:发给对方设备的内容都会加密,其中有:连接所需的 IP 地址(含局域网内的地址)、设备与角色的介绍(设备的 ID 与名称、操作系统、应用版本;角色的 ID、名字与种类)、在「同步」中开启的内容(RSS 订阅源的 URL 及各订阅源是否定期抓取,备忘的正文、名称、分组与更新时间,快捷键分配及其打开的应用与文件夹的路径),以及一台设备把 AI 共享给另一台时,发给该 AI 的内容(描述、文本等)及其结果。共享 SSH 时,还会发送其端口号和这台 Mac 的登录名,以及经由 SSH 往来的内容(例如你输入的命令及其输出)。从 iPhone・iPad 的 Terminal AI Coach 连接时也一样,对方始终是同一账户下你自己的设备。连接之后的通信直接在两台设备之间传输,不经过服务器或 HyperDHT 的节点
  • 语音生成选择 ElevenLabs 时:要朗读的文本会用你输入的 API 密钥发送到 ElevenLabs,并消耗你的 ElevenLabs 额度
  • 语音生成选择 Irodori-TTS + speech.cpp(本地)时:文本不会发送到你的设备之外。只有首次使用某个模型时,才会连接 Hugging Face 下载该模型
  • AI 广播:为了撰写台本,会把选中文章的标题和摘要(打开「AI 广播也读取文章网页正文」时还有文章网页的正文),以及主持角色的名字、性格和说话方式的设定、对听众的称呼,交给撰写台本的 AI(有通过 P2P 连接借来的文本 AI 时用它,否则用 AI 设置「文本生成」中选择的 AI)。要交给云端 AI(OpenAI 兼容 API)时,以及用 ElevenLabs 朗读时(台本的文字会发送到 ElevenLabs),开始前会弹出确认窗口;播放途中如果目的地切换到你没有确认过的云端,就不发送并停止节目。打开「AI 广播也读取文章网页正文」(默认关闭)后,会从网站读取一次摘要较短的文章的网页(不发送 Cookie,读取的正文不保存)。文章有图片时,会从文章中的图片 URL 获取该图片
  • 图像生成选择「设备端」以外的方式时:你写的描述(想要的图像内容)会交给所选的方式。「通过 MCP(Codex CLI)」和 Cursor CLI 会以你自己的账户分别发送到 OpenAI 和 Cursor,OpenAI API 和 Gemini API 会用你输入的 API 密钥发送到 OpenAI 和 Google,Draw Things 会发送到你设置的 URL(默认是本机)。在 Windows 上,若开启了「先将描述翻译成英文再发送」(Draw Things 默认开启),为了翻译,描述也会发送到「AI 设置 → 文本生成」中选择的 AI(macOS 在本机翻译)
  • 启用 Claude 联动(MCP)时:健康、心情等状态,以及你让它读写的备忘正文会传给 Claude。用预览打开的文件内容、图像数据和完整路径不会传出去。由 Claude 请求生成图像或语音时,描述和文本的去向与上面的图像生成、语音生成相同

AI 基本上在本地运行。 云端联动采用选择加入的方式,只有在设置中明确启用后才会生效。

倾诉的对话不会被保存。 会话结束后就从内存中消失。

数据的保存位置

  • macOS: ~/Library/Application Support/AICoach/
  • Windows: %LOCALAPPDATA%\AICoach\

云端的数据保存在东京区域(asia-northeast1),除了你自己的账户以外无法读写。

删除记录

你也可以删除全部记录。养过的生命与血脉、图鉴里的一切都会消失,回到最初的那片留白。此操作无法撤销。

向第三方提供

不卖,也不给。 养育记录、备忘、语音转写的内容,都不会向第三方出售、出借或提供。不做广告目的的收集,
也不嵌入任何第三方追踪器。

离开你设备的,只有上面「会发往外部的内容」中列出的那些路径。除检查新版本(默认开启,可在菜单的「自动更新」中停止)、下载已学会的游戏的数据、首次启动时领取第一颗蛋的记录外,每一条都只在你自己打开时才会运行。发送出去的内容,按各接收方的使用条款和隐私政策处理。

对方用途你的选择
你配置的 OpenAI 兼容端点AI 处理(含 AI 广播的台本)仅在你明确启用时
ElevenLabs语音生成、AI 广播的朗读(要朗读的文本)仅在语音生成选择 ElevenLabs 时
Hugging Face仅下载 speech.cpp 的模型(不发送文本)仅在 Irodori-TTS + speech.cpp 首次使用某个模型时
文章所在的网站(你订阅的订阅源的文章网页)AI 广播台本的素材(每个文章网页读取一次,不发送 Cookie)仅在打开「AI 广播也读取文章网页正文」时
OpenAI图像生成(描述)仅在图像生成选择「通过 MCP(Codex CLI)」或 OpenAI API 时
Google(Gemini API)图像生成(描述)仅在图像生成选择 Gemini API 时
Cursor图像生成(描述)仅在图像生成选择 Cursor CLI 时
你设置的 URL 上的 Draw Things(默认是本机)图像生成(描述)仅在图像生成选择 Draw Things 时
Google Firebase(东京区域)云同步、P2P 连接的设备列表仅在你登录时(设备列表仅在开启 P2P 连接期间)
Google Firebase(东京区域)领取第一颗蛋与试用模式的记录(由这台 Mac 的硬件标识符生成的哈希值、账户 ID、试用的开始与结束时间、结束原因)首次启动时(未登录时以匿名 ID 记录);试用的记录仅在开始试用模式时
Google Firebase(东京区域)已学会的游戏的数据的下载记录(账户 ID、设备 ID、游戏的种类与版本、应用的版本、操作系统、是否下载成功)下载已学会的游戏的数据时(未登录时以匿名 ID 记录)
公共 HyperDHT 网络(hyperdht.org 的引导节点,以及世界各地参与者的节点)为 P2P 连接寻找并连上你的其他设备(IP 地址、端口与 P2P 用的公钥;设备之间交换的内容经过加密)仅在你开启 P2P 连接时
分发服务器 dl.aic0t.com(运行在 Amazon Web Services 的 CloudFront 与 S3 上)检查并下载新版本(表明应用的版本、构建号和操作系统)仅在「自动更新」开启时(默认开启)以及你选择「检查更新…」时
分发服务器 dl.aic0t.com(运行在 Amazon Web Services 的 CloudFront 与 S3 上)下载已学会的游戏的数据(表明应用的版本、构建号和操作系统;下载 URL 中不包含账户或设备的信息)学会该游戏并同意下载之后(游戏有新版本时也会重新下载)
Stripe购买蛋的支付仅在你购买时
Claude(MCP 联动)你拜托的操作仅在你启用联动时

依法必须披露的情形除外。

保存期限

对象保留多久
存档数据(养育、血统、图鉴)在你删除之前一直留在设备上
备忘在你删除之前一直保留。删除是移动到系统回收站
生成的图像和音频在你删除之前一直保留。保存在「图片」和「音乐」中的「AI Coach」文件夹
AI 广播的台本与读取的文章网页正文不保存。 只在播放期间保存在内存中。仅在打开「将 AI 广播的台本存入备忘录」时,播过的台本会写入备忘,并在你删除之前一直保留
AI 广播节目的音频仅在打开「保存 AI 广播节目」时,以 WAVE 格式保存在「音乐」中的「AI Coach」文件夹,在你删除之前一直保留
烦恼咨询的对话不保存。 会话结束即从内存中消失
语音输入的音频不保存。 转成文字后即丢弃
Claude 联动的工作提示最长 15 分钟后自动消失
云同步的数据账户存在期间。注销后删除
领取第一颗蛋与试用模式的记录账户的记录(试用的开始与结束时间、原因等)在账户存在期间保留,注销后删除。为防止重来,之后不能修改或删除。设备的记录(哈希值)为防止在同一台 Mac 上再次领取第一颗蛋,注销后仍会保留,但会去掉账户 ID。这台 Mac 也会在钥匙串中保存自己的试用记录(开始时间、到期日等)
P2P 连接的设备列表(云端)开启 P2P 连接期间。在本机关闭或退出登录后即删除。在别的设备上用「移除…」移除时,会删除其公钥并留下移除标记(设备名、操作系统与时间),该标记在那台设备重新开启或注销账户后消失
在 HyperDHT 上的公告关闭 P2P 连接或退出应用时撤回。撤回没有送达时,标准节点也会在约 20 分钟后丢弃该公告
通过 P2P 连接同步的备忘、RSS 订阅源与快捷键分配在你删除之前,一直留在同步的每台设备上。在一台上删除,另一台上也会删除(备忘移到回收站)
通过 P2P 连接的 SSH 往来的内容AI Coach 不保存,只在两台设备之间传输(所登录的 Mac 上的 shell 历史等,按那台 Mac 的设置处理)
检查与下载更新的通信分发服务器不保留访问记录。下载的新版本在安装后会从你的设备上删除(若为手动安装而把磁盘映像放在「下载」文件夹中,则会保留到你删除为止)
已学会的游戏的数据分发服务器不保留访问记录。下载记录(账户 ID、设备 ID、游戏的种类与版本等)会在我们的服务器(Firebase)上保留 1 年,之后自动删除。下载的数据以加密状态保存在你设备上的应用文件夹中,换成新版本后会删除旧版本

卸载应用不会自动删除上述文件夹。想彻底清空时,请执行「删除记录」,或者自己删除这些文件夹。

联系方式

关于隐私与数据处理的咨询,请通过网站的联系表单,或发送邮件至 contact.aicoach@gmail.com。


12. 支持的语言

支持 日本語 / English / 简体中文 / 繁體中文 / Español 共 5 种语言。

显示语言会根据 操作系统的系统语言 自动选择。

  • macOS: 系统设置 → 语言与地区
  • Windows: 设置 → 时间和语言 → 语言

在不支持的语言环境下会显示英语。


13. 运行环境

macOSWindows
OSmacOS 26 及以上Windows 10 / 11
推荐最新版 macOSWindows 11
CPUApple Siliconx64
FrameworkSwift 6.4 / AppKitC++ / WinUI 3

部分功能需要连接互联网。同步使用 Firebase 实现。macOS 版仅支持 Apple Silicon。Windows 版正在开发中,即将推出,目前尚未提供下载。

macOS 版与 Windows 版的差异

Windows 版目前还无法使用以下功能,我们会陆续支持。

  • 倾诉
  • 账户关联与云同步
  • 剪贴板历史·书签·RSS 的快捷键(可以从菜单使用)
  • AI 图像生成
  • 部分演出

14. 遇到问题时

角色不出现
请从菜单栏(macOS)或任务栏托盘(Windows)打开「角色管理」,确认它是不是被收起来了。变成幽灵的孩子,也可以从收起来的列表里叫回来。

蛋孵不出来
蛋只靠时间流逝就会孵化,不需要喂东西。收起来的时候时间不会流动,所以请把它放在画面上等着。

语音输入没反应

  1. 如果还是蛋,孵化之前语音输入不会解锁(设计如此)
  2. 请确认麦克风权限是否已授予
  3. 请确认右 Shift 是否按住了 0.3 秒以上(时间太短不会反应)
  4. 请确认是否有其他应用占用了右 Shift

转出来的文字进不到其他应用里
自动输入需要辅助功能权限,请在设置里授予。另外也请确认自动输入的开关是否已打开。

AI 没有响应
请在 AI 设置里确认端点和模型名。使用 llama.cpp 时上下文长度需要 8192 以上。没有响应时会自动切换成平常的台词。

买的蛋没送到
请重启应用后再确认孵化托盘。如果还是没有,请附上购买时使用的邮箱地址联系我们。

数据没有迁移到其他设备
请确认两台设备是否登录了同一个 Google / 邮箱账户。同步会在购买过 1 个以上蛋的账户上启用。

病治不好
「照顾」每小时只生效 1 次。免疫力高的话会自然康复。请让它吃饱,好好睡一觉。

Claude 找不到 AI Coach
请确认 AI Coach 是否正在运行、联动是否已启用。连接信息会在每次启动应用时重新生成,重启一次 AI Coach 往往就能解决。也可以在「AI 设置 → 连接」的「连接 Claude」中确认是否已经添加。

无法添加到 Claude Code
要把 AI Coach 注册到 Claude Code,需要 PATH 中有 Node.js 22 或更高版本。Claude Desktop 即使没有 Node.js 也能连接。

拜托了 Claude,却什么也没发生
睡着的孩子·蛋·幽灵·收起来的孩子不会显示,倾诉中·对话中·转文字中同理。请把别的孩子放到画面上再试一次。

工作中的显示一直不消失
最长 15 分钟会自动消失。想立刻清掉的话,可以告诉 Claude 工作已结束,或者把那孩子先收起来一次。

长按 fn 也不出现圆环
请确认是否按住了 0.3 秒以上。和其他键一起按下时,会被当作普通的快捷键处理。如果圆环上还没有放任何项目,请在菜单栏设置里的「环形启动器…」中选择项目。另外也请确认是否已授予辅助功能权限。

菜单里没有「生成 AI 图像…」
可能是那孩子还没有学会 AI 图像生成,或者 AI 设置「图像生成」中选择的方式在这台 Mac 上无法使用。「设备端」只能在支持 Apple Intelligence 的 Mac 上使用。

菜单里没有「生成 AI 语音…」
请在 AI 设置「语音生成」中,把生成方式设置为可用的状态并保存(ElevenLabs 需要 API 密钥,Irodori-TTS + speech.cpp 需要 speech 命令)。

使用 P2P 连接时,另一台 Mac 没有出现在列表里
请确认两台 Mac 是否登录了同一个账户,并且都在「P2P 连接…」中开启了。


联系我们

如果问题没有解决,请通过网站上的咨询表单联系我们。
也欢迎一并查看 FAQ。

Languages

AI Coach