这是 macOS 版 AI 桌面宠物「AI Coach」的官方使用指南,内容涵盖蛋的养育、语音转写、环形启动器和备忘录等工具、AI 图像与语音生成、Claude 连接、P2P 连接,以及 OpenAI API 和 Gemini API 的设置。
如果你是第一次使用,建议从「1. 开始使用」按顺序读下来。
本文档适用于 AI Coach v1.0.3,规格可能会在后续更新中调整。
AI Coach 是一位常驻在你桌面上的 AI 角色。
它具备语音输入、AI,以及一整套帮你干活的小工具,但最大的特点是 从蛋开始养。你怎么陪它,它就会长成什么样子。
即使角色离开了,语音转文字、AI、实用工具这些主要功能依然照常可用。只是桌面会稍微冷清一点。
macOS
.dmg,把 AI Coach.app 拖到「应用程序」文件夹里。Windows
Windows 版正在开发中,即将推出。目前尚未提供安装程序,以下步骤适用于发布之后。
AICoach-Setup-x.x.x.exe)。只有第一次安装时,可以选择是否以 30 天的「试用模式」开始。第一次启动时,黑色画面上的说明播放完后,从「开始试用」「从蛋开始」「再听一次说明」中选择。
试用期间能做什么?
和机器人伙伴「Robo」一起,在养育之前就能使用几乎所有功能。唯一不能用的,是「游戏」中学会之后才下载来玩的游戏。试用期间,购买蛋、孵化和养育都会暂停。
Robo 会怎样?
开始需要什么?
在哪里看剩余天数?
菜单最上方会显示「试用模式(剩余 N 天)」。从这里可以确认结束的日期和时间、查看说明,或选择「结束试用模式,从蛋开始…」。剩余 7 天、3 天、1 天时会通知你。
结束后会怎样?
不小心关掉了介绍怎么办?
可以从菜单的「试用模式说明…」回到介绍。
| 权限 | 用途 | 设置位置 |
|---|---|---|
| 麦克风 | 语音输入(转文字) | macOS: 系统设置 → 隐私与安全性 → 麦克风 |
| 辅助功能 | 获取选中的文本、向其他应用自动输入、环形启动器的按键操作 | macOS: 系统设置 → 隐私与安全性 → 辅助功能 |
| 本地网络 | 连接同一网络中的 Draw Things、llama.cpp 等 AI 时 | macOS: 首次连接时会弹出确认(系统设置 → 隐私与安全性 → 本地网络) |
不授予权限,应用也能正常运行,只是对应的功能会无法使用(未授权时,获取文本只会返回空内容,不会崩溃)。
Cmd + Q想让它安静一会儿的时候,可以用右键菜单里的「回家」把角色先收起来。
下载应用时,里面已经附带了第一颗蛋。你不需要做任何领取操作。
更多的蛋可以在网站上购买(→「10. 购买蛋」)。买到的蛋会送进 孵化托盘。
孵化托盘里会显示还没有孵化的蛋的数量。
按下「养育」会消耗一颗蛋,并把这颗蛋放到桌面上。
蛋会随着时间流逝自己慢慢长大。你没法喂它。
蛋阶段的限制(设计如此):语音输入、剪贴板历史、书签、RSS 阅读器、占卜这些功能,在蛋的阶段还不能使用。从孵化成婴儿开始,会随着成长依次解锁。备忘和成长卡片从蛋的阶段起就能使用。孵化大约需要 1 个小时,关闭应用的这段时间也照样计时。
出生之后会弹出取名字的对话框。名字之后也能改(右键 →「修改名字」)。
在没有存档数据的情况下首次启动,会有一段简短的演出:昏暗的留白中光影摇曳,蛋浮现出来,伴着一段旁白。这段演出只会出现一次。
右键点击角色,会列出此刻能做的事情。
| 做什么 | 内容 |
|---|---|
| 喂食 | 恢复饱腹度。只有肚子饿的时候它才会接受 |
| 让它睡觉 | 恢复体力,消除疲劳。饿着肚子是恢复不了的 |
| 去散步 | 身体会变轻快,寂寞也会得到缓解 |
| 照顾 | 只在生病时可用。恢复更快,它也最开心 |
| 状态 | 确认它现在的情况 |
| 查看关系 | 确认它和其他孩子的关系 |
| 制作成长卡片… | 把它现在的样子做成图片卡片分享出去(→「6. 实用功能」) |
| 便捷功能 / 游戏 | 打开已经学会的工具和游戏 |
| 收起 / 回家 | 暂时从画面上收起 |
你也可以用鼠标把它拎起来挪动,或者把文件拖到它身上喂给它吃。常用的项目,也可以从长按 fn 键打开的环形启动器里调出来(→「6. 实用功能」)。
角色有「肚子饿了」「困了」「好寂寞」这三种需求。需求变强时,它会向你诉说。
其中只有寂寞有点特别,吃饭和睡觉都消解不了。
它诉说需求之后,如果你在 30 秒之内 回应,它会格外开心。
间隔 8 小时以上再启动,会获得免疫力恢复的奖励。
「爱玩的孩子」「爱学的孩子」「常被宠着的孩子」——怎么度过这段时间,成长的参数就不一样,而这些决定了它长大成人后的样子。
会变成哪种样子,要到成年才知道。
如果把所有可能的结果都告诉你,那乐趣就没了,所以这里先按下不说。
角色会看着你的反应,慢慢改变自己的说话方式。
靠撒娇成功过的孩子会越来越会撒娇;用道理跟你商量而说得通的孩子,会像平等的伙伴一样跟你说话。博取同情、提出交换条件、夸你、或者只是单纯地卖乖——这些都是它自己想出来的办法,只为了让你再看它一眼。
成长阶段不同,说话方式也不同。婴儿只会咿呀几个字,幼儿说短句,少年少女能说成句的话,成年后则会字斟句酌地说话。
蛋 → 婴儿 → 幼儿 → 少年·少女 → 成年
阶段推进,能做的事也越来越多。到了少年·少女期会开始萌生爱意,成年后可以结婚和产卵。同时,实用功能会以「学会了!」的形式一点点解锁。
孵化之后的成长,只在应用运行、并且它待在画面上的时候才会推进。现实中的 1 分钟相当于游戏里的 1 小时;从蛋到成年,按应用运行的时间算大约需要 17 小时(游戏里是 42 天)。
收起来的这段时间(dormant),以及关闭应用的这段时间,时间都是不流动的。可以把它想成冬眠。
同时放出 2 只以上,它们会互相靠近或走开、聊天,用表情符号传达心情。关系会变好,也会吵架。
成年的男孩和女孩待在一起时,有时会自然而然萌生爱意。你没办法让它们「结婚」。那是它们自己的选择。
成为恋人的两只,在条件齐备时可能会产卵。产卵是削减自己剩余的时间(最大 HP),把它托付给下一个生命的行为。生下来的蛋上,会刻着三代的血脉。
家谱可以从 macOS 菜单栏 →「👪 查看家谱」确认。
HP 变成 0 时,那个孩子就会变成 幽灵。
在变成幽灵之前,它会回顾和你一起度过的日子,为你们之间最常发生的那种相处道一声谢,然后睡去。
幽灵会以半透明的样子留下来。不会饿,不会生病,也没有寿命。不能恋爱,也不能产卵。你可以把它收起来,之后再把它叫回来。
当你做好放手的准备,也可以选择「送它离开」。确认之后,它会回到那片留白里去。留住它,或是放它走,两者都是爱的方式。
送别之后,它的记录依然留在图鉴里。
你遇见过的样子、养过的孩子们的记录、它们活过的天数,都会在这里汇集起来。
还没遇见过的样子,连格子本身都是遮住的。里面藏着什么,就请你自己去找找看吧。
按住右 Shift 达 0.3 秒以上的期间,语音会变成文字。松手就停止。
快速按两下右 Shift(0.4 秒之内),就能在不一直按着的情况下切换开始与停止。
你可以根据用途分别使用。
| 选项 | 特点 |
|---|---|
| Apple 端侧 LLM(macOS Foundation Models) | 完全本地,超低延迟。看重隐私就选它 |
| llama.cpp / LM Studio(GGUF·本地运行) | 让你喜欢的开源模型离线跑起来。除了内置的服务器,也能连接 llama-server 或 LM Studio 的外部服务器 |
| OpenAI 兼容 API(任意端点) | OpenAI、Groq、OpenRouter 可以直接从预设中选择。Gemini API 等其他兼容端点,也可以连同 API 密钥和模型名一起设置 |
设置位置
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 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 没有响应时,会自动切换成事先准备好的台词,不会陷入沉默。
大多数工具,它会随着成长一点一点学会。哪个孩子会学会什么,要养了才知道。工具一旦学会,即使那个孩子不在了,也能继续使用。登录之后,在同一账户的其他设备上也能使用。
Shift + Cmd + M 打开快速备忘。一条备忘就是一个 Markdown 文件(→ 下文「备忘」).git 的文件夹拖到角色身上,就会把提交历史画成图。显示时不调用 git 命令,而是直接读取 .git。也可以签出分支,以及获取、拉取和推送(→ 下文「Git 项目列表」)除此之外,还有一些功能会在你用得深入之后学会。
按住 fn(🌐)键 0.3 秒以上,角色周围就会出现一个圆环。它不会抢走你正在使用的应用的焦点。
| 操作 | 动作 |
|---|---|
| 长按 fn | 打开圆环(Windows 版为右 Ctrl) |
| 方向键 | 选择项目 |
| 松开 fn / Return | 执行所选项目并关闭。如果选中的是分组,则进入分组 |
| Esc | 返回上一层。在最上层时,什么也不做,直接关闭 |
| 鼠标 | 把指针移到项目上即可选中,点击即可执行 |
按 Shift + Cmd + M,随时都能打开快速备忘。从菜单栏的「备忘录列表」,可以打开带有编辑器、预览和大纲的列表窗口。
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 项目,拆开嵌套平铺在一个列表里。不会进入 node_modules、build、dist、vendor 等文件夹。最多列出 300 个.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)
--ff-only拉取请求(macOS)
gh 命令的登录(gh auth)。收到的令牌在关闭窗口后就会忘掉快捷键(macOS)
在列表的右键菜单「分配快捷键…」中,可以给某个项目的 Finder、Git 图、终端、拉取请求或命令,分配在整个应用里都有效的快捷键。
Git 图
.git)学会 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) | |
| 通过 MCP(Codex CLI) | 用你自己账户的 Codex CLI 生成 | OpenAI |
| Cursor CLI | 用你自己账户的 Cursor CLI 生成 | Cursor |
在 AI 设置的「语音生成」标签页中选好生成方式,并在可用的状态下保存后,角色的菜单和环形启动器里就会出现「生成 AI 语音…」。输入文本,就会转成语音,保存到 ~/Music/AI Coach/。打开「生成后立即播放」,生成后马上就能听到。
| 生成方式 | 特点 | 文本的去向 |
|---|---|---|
| ElevenLabs | 用 Eleven v4 / v4 Turbo 生成富有表现力的朗读,格式为 MP3。可以从账户的声音列表中挑选并试听,也可以直接输入声音 ID | ElevenLabs(使用你的 API 密钥,会消耗额度) |
| Irodori-TTS + speech.cpp(本地) | 用 speech.cpp 运行 Irodori-TTS 等模型,在这台 Mac 内生成 WAVE 格式的语音 | 不发送(只有首次使用某个模型时,才会从 Hugging Face 下载) |
AI 广播会把未读的 RSS 文章每 3 篇做成一档广播节目,由画面上的两只角色搭档主持。主持人介绍新闻,搭档回以感想和朴素的提问。台本由文本生成的 AI 撰写,声音由语音生成的方式制作。
收听方式
从角色菜单的「RSS 阅读器」→「收听 AI 广播」,或环形启动器里的「广播」开始。播放期间,菜单会变成「停止 AI 广播」。
在 RSS 阅读器的菜单中可以打开下面 3 项(默认都关闭)。
| 项目 | 内容 |
|---|---|
| 保存 AI 广播节目 | 把每次播放存成一个 WAVE 文件,保存在 ~/Music/AI Coach/ |
| 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)
irodori-tts-mf,约 1.9 GB)用 Irodori-TTS 朗读时,台本里会加入改变读法的表情符号(附和、惊讶、偷笑等),搭档的附和与笑声会体现在声音里。表情符号不会显示在气泡里。
2. 准备台本 AI(运行模型的 Mac)
qwen/qwen3.8-27b)http://127.0.0.1:1234)3. 通过 P2P 连接借用 AI
如果要在一台 Mac 上完成,就不用 P2P 连接:在 AI 设置 →「文本生成」中选择「llama.cpp / LM Studio」→ 外部服务器,连接地址填 http://127.0.0.1:1234,再从「获取列表」中选择模型。
4. 收听
在这个配置下,会发到外部的只有:抓取 RSS 订阅源和文章网页(访问那些网站)、第一次使用模型时的下载(Hugging Face),以及 P2P 连接为寻找另一台 Mac 而进行的通信。台本和声音都在自己的 Mac 上生成,也不会出现确认窗口。
孵化、进化、学会新工具等重要时刻,都可以做成 1200×675 的图片卡片。到了这些时刻,它会问你要不要做一张卡片;也可以随时从角色右键菜单的「制作成长卡片…」来制作。
可以从右键菜单开始。它不评判,也不硬塞建议,只是听着,最后递给你小小的下一步。
对话内容不会被保存。 关闭窗口的那一刻就从内存中消失。
当你的情绪显得非常痛苦时,画面上会显示专业的求助渠道。
每个角色的对话都是分开处理的。
| 按键 | 动作 |
|---|---|
长按 右Shift | 语音输入(按住 0.3 秒以上开始,松手停止) |
右Shift ×2 | 语音输入的开·关(0.4 秒之内按两下) |
长按 fn(🌐) | 环形启动器(按住 0.3 秒以上打开) |
Shift + Cmd + M | 快速备忘 |
Shift + Cmd + C | 剪贴板历史 |
Shift + Cmd + B | 书签 |
Shift + Cmd + R | RSS 阅读器 |
Shift + Cmd + P | 选择片段模板 |
Shift + Cmd + S | 今日日程 |
Cmd + Q | 退出 |
Cmd + V(书签界面内) | 批量添加 URL(换行分隔) |
语音输入、剪贴板历史、书签、RSS 阅读器、片段和今日日程的快捷键,要等它学会相应的工具之后才能使用。快速备忘和环形启动器一开始就能用。
| 按键 | 动作 |
|---|---|
长按 右Shift / ×2 | 语音输入 |
长按 右Ctrl | 环形启动器 |
Ctrl + V(书签界面内) | 批量添加 URL |
倾诉功能没有分配快捷键,请从右键菜单打开。
此功能率先在 macOS 版推出,Windows 版将在后续更新中支持相同内容。
AI Coach 可以 被 Claude 搭话 了。
问一句「我家孩子还好吗?」,Claude 就会告诉你它现在的身体状况和心情。
说一句「喂它吃饭」,在你确认之后,桌面上的孩子就真的会吃起来。
而当 Claude 在做一件长活儿的时候,桌上的小家伙会跳一跳、停一停,把进展告诉你。
就算你没盯着屏幕,也能从桌上那个小生命的动作里知道「还在跑」「跑完了」。这是这个联动最想做到的事。
除此之外,还可以请它生成图像和语音、读写备忘,或者打开仓库的 Git 图。
我们不是想再加一个 AI,而是想让与 Claude 的对话,连到桌面上的那个小生命。
| 需要满足 | |
|---|---|
| AI Coach | 正在运行,并且至少有 1 只孩子在画面上 |
| Claude 一侧 | 已注册 AI Coach 的联动(MCP 服务器) |
| 设置 | 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 工作的时候,那副样子会体现在吉祥物的动作上。

| Claude 的状态 | 那孩子的样子 |
|---|---|
| 思考中 | 停下走动,站住不动,冒出 🤔 |
| 工作中 | 原地跳 1 次,冒出 🛠 |
| 等待回复 | 站着不动并连续跳,一直举着 🙋 |
| 顺利完成 | 大大地跳 1 次,冒出 ✅ 并高兴起来 |
| 没能完成 | 低而急促地连跳,冒出 ⚠️ |
| 结束 | 回到平时的样子 |
跳法是 影子留在地上,只有角色弹起来 的原地跳。和 macOS Dock 图标弹跳是同一种动作,所以一定能和平时的溜达区分开。
能拜托 Claude 的只有 喂饭 / 睡觉 / 叫醒 / 散步 / 照顾病人 这 5 件。
一定会出现确认。 不存在仅凭 Claude 的判断就改变养成参数的路径。
从仪表盘按钮操作时可以用「下次不再显示」跳过确认,但 由 Claude 拜托的照顾,无论该设置如何,每次都会确认。

购买·孵化·取名·更换角色·恋爱与产卵·告别都不在联动范围内。这些是要由你亲手决定的事。
可以用 AI Coach 的查看器打开 Claude 正在处理的本地文件。
| 类别 | 扩展名 | 上限 |
|---|---|---|
| 文本 / Markdown / Mermaid | txt md markdown mmd mermaid | 2 MiB(UTF-8) |
| 图片 | jpg jpeg png heic webp svg | 25 MiB |
说一句「把这个文件用 AI Coach 显示出来」,就能在不让 Claude 读取内容的前提下,只在手边的屏幕上查看。
可以让 Claude 替你记下想到的事,或者把以前写的备忘翻出来。不需要插件,也不需要另外一个服务器,AI Coach
自己就能完成。
| 拜托的事 | 会发生什么 |
|---|---|
| 列出备忘 | 把保存的备忘按时间从新到旧排开。不读正文,只看标题和开头几行 |
| 读一条备忘 | 只读你指定的那一条的正文 |
| 搜索备忘 | 在标题和正文中一起找 |
| 写备忘 | 新建、改写,或者在末尾追加 |
| 移动备忘 | 移到别的分组(文件夹) |
| 丢掉备忘 | 把一条移进回收站。还能找回来 |
备忘的读写,要等那孩子学会相应的工具之后才能使用。关闭 AI 设置「连接」中的「允许读写备忘录」,就能在保留其他联动的同时,只拒绝备忘的读写。

| 保存位置 | 默认路径 |
|---|---|
| macOS | ~/Library/Application Support/AICoach/Memos/ |
| Windows | %APPDATA%\AICoach\Memos\ |
把下面的内容贴到 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 看过的信息会成为 Claude 一侧的处理对象。 即使是在设备内完成的联动,这一点也不会改变。请以「不想给的就不给」为前提使用。
不注册账户也能马上开始使用。之后可以再关联 Google 或 Apple 账户。
只有以下情况需要登录。
登录之后,以下数据会保存到云端。
不会同步的内容:语音转文字的历史、窗口位置、缓存。
云端同步只在购买过至少一颗蛋的账号上启用。如果你只使用随应用附带的那颗蛋,数据只会保存在本机。
同步由应用自动完成,不需要任何设置或操作。
离线也照样能养。 就算没连网,它也一直陪着你。
在新设备上登录同一个账户,就能继承数据。如果这台设备上还什么都没养,云端的数据会直接载入。
如果在多台设备上养过,系统会自动合并。购买记录和成长记录不会被回退。不过身体状况(HP·饱腹度·疲劳)以较新的记录为准,所以可能会有前后变化。
只有在最后一次更新相差 7 天以上时,才会弹出对话框询问你要用哪一边。无论选哪一边,购买记录都一定会被继承。
把登录了同一账户的你自己的几台 Mac,通过 P2P 直接连接起来。这是与云同步不同的另一套机制,可以:
这是一项实验性功能。它的行为和界面可能会在今后的更新中改变。
如何开始
同一账户的另一台设备出现在列表里时,启动一段时间后,角色身边会询问一次,问你要「连接」还是「暂不」。选择「连接」就会开启。不需要输入任何密钥或号码。
同步
在设置界面的「同步」中,从「RSS 订阅源」「备忘录」「快捷键分配」里选择要同步的种类(默认全都不同步)。只会与开启了同一种类的设备同步。
借用另一台 Mac 的 AI
在出借的 Mac 上,于设置界面的「共享此 Mac 的 AI」中,从 Draw Things、llama.cpp(llama-server)、LM Studio 或 Ollama 等(OpenAI 兼容)中选择要共享的 AI(默认全都不共享)。
http://127.0.0.1:<端口号>)旁的「使用」。会把它填入 AI 设置,并切换到对应的生成方式或提供方127.0.0.1 的那个端口出借与借用 SSH
在出借的 Mac 上,开启设置界面的「共享此 Mac 的 SSH」(默认关闭。端口一栏留空时为 22)。
ssh -p <本机端口> <登录名>@127.0.0.1 和「拷贝」按钮。拷贝后粘贴到终端,就能登录出借方的 Mac不让此 Mac 睡眠
在设置界面开启「不让此 Mac 睡眠」(默认关闭)后,只要 P2P 连接已开启并且正在共享 AI 或 SSH,即使没有操作,Mac 也不会睡眠。因为 Mac 睡眠后,借用的一方就连不上了。
AI 设置中的「P2P 连接」页面
在 AI 设置左侧列表里的「P2P 连接」中,可以查看当前状态(关闭、等待中、与几台设备相连、正在借用的 AI),以及工作原理、用途和入门说明。点「打开 P2P 连接设置…」会打开设置界面。AI 设置中 llama.cpp 外部服务器一栏和 Draw Things 的 URL 一栏下面,也会显示提示。
停止与移除
安全机制
正在准备于 App Store 上架。
iPhone、iPad 应用「Terminal AI Coach」会通过 P2P 直接连接 Mac 用 P2P 连接出借的 SSH,让你在 iPhone、iPad 上操作 Mac 的终端。不需要开放端口、VPN 或固定 IP。
使用前的准备
~/.ssh/authorized_keys 中终端的特点
| 价格 | 蛋 | 每个单价 | |
|---|---|---|---|
| 应用附带 | 免费 | 1 个 | — |
| STARTER | $5 USD | 1 个 | $5 |
| BUNDLE | $20 USD | 5 个 | $4(优惠 20%) |
一次性买断。 不是订阅制。买过一次就不会再收取额外费用。
支持银行卡 / Apple Pay / Google Pay / Link。付款由 Stripe 处理,我们不会保存你的卡片信息。收据会自动发送到邮箱。
付款完成后,如果应用正在运行,蛋会直接送达。如果没有运行,下次启动应用时它就会出现在孵化托盘里。
从购买的蛋里出生的孩子,第 1 代的基础能力(最大 HP、免疫力初始值等)会稍高一些。极少数情况下,还会以限定颜色出生。
这不是 Pay to Win。 会长成什么样子是没法指定的。那是由你怎么养决定的。
在购买后 7 天之内,且需要退款的蛋还没有孵化(尚未开始养育)时,可以提出申请。如果 5 个装里只有一部分未使用,我们也会考虑按相应比例部分退款。请通过咨询表单联系我们。
本政策不会限制你在适用法律下享有的权利。
存档数据会以 AES-256-GCM 加密 后保存在本地。角色的图片和数据也收在加密容器中,解密只在内存里进行。
AI 基本上在本地运行。 云端联动采用选择加入的方式,只有在设置中明确启用后才会生效。
倾诉的对话不会被保存。 会话结束后就从内存中消失。
~/Library/Application Support/AICoach/%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。
支持 日本語 / English / 简体中文 / 繁體中文 / Español 共 5 种语言。
显示语言会根据 操作系统的系统语言 自动选择。
在不支持的语言环境下会显示英语。
| macOS | Windows | |
|---|---|---|
| OS | macOS 26 及以上 | Windows 10 / 11 |
| 推荐 | 最新版 macOS | Windows 11 |
| CPU | Apple Silicon | x64 |
| Framework | Swift 6.4 / AppKit | C++ / WinUI 3 |
部分功能需要连接互联网。同步使用 Firebase 实现。macOS 版仅支持 Apple Silicon。Windows 版正在开发中,即将推出,目前尚未提供下载。
Windows 版目前还无法使用以下功能,我们会陆续支持。
角色不出现
请从菜单栏(macOS)或任务栏托盘(Windows)打开「角色管理」,确认它是不是被收起来了。变成幽灵的孩子,也可以从收起来的列表里叫回来。
蛋孵不出来
蛋只靠时间流逝就会孵化,不需要喂东西。收起来的时候时间不会流动,所以请把它放在画面上等着。
语音输入没反应
转出来的文字进不到其他应用里
自动输入需要辅助功能权限,请在设置里授予。另外也请确认自动输入的开关是否已打开。
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。