从安装到第一次对话。

1安装

• 系统Windows 10 或 Windows 11（64 位）。Windows 7 / 8 无法安装，安装程序一打开就会提示。
• 磁盘安装包约 1 GB，安装后约 3 GB。
• 网络使用云端模型时需要联网；用 Ollama 本地模型可以离线。

1. 下载 Aivy OS Setup 2.5.0.exe，双击运行，按提示安装。安装时有进度条，一般一两分钟。如果 Windows 提示「已保护你的电脑」，点「更多信息」→「仍要运行」——这是 Windows 对没有购买微软签名证书的软件的统一提示。
2. 第一次打开会慢一些：系统正在检查新程序的文件（杀毒软件扫描）。等待页上会显示「已等」多久，好了会自动进入，不要重复打开。

如果 Windows 防火墙弹出「已经阻止此应用的部分功能（aivyos.exe）」，点「取消」即可。在本机使用不受影响。

2第一次打开

1. 软件许可协议　如果出现，阅读后勾选同意，按页面提示继续。
2. 创建你的 AI 伴侣　填三样：AI 的名字（随你取；Aivy OS 是软件的名字）、她怎么称呼你、认证密码（输两次）。认证密码以后用来确认「是你」，请记住它。
3. 语义搜索配置　语义模型已经随安装包内置，通常不用改，直接点「完成设置」。
4. 基因组（灵魂）　会弹出一个编辑器，里面是 AI 的性格和说话方式，已经有默认内容。不想改就直接保存；确认后程序会自动重启一次。
5. 选模型、填 Key　重启后出现启动配置：
   • 在 Provider 里选一家模型服务（还没有 Key？见下一节）；
   • 把 API Key 粘进去——输入框下面写着去哪里获取，点「去获取 ↗」直接打开那个页面；
   • 点模型框右边的「获取模型」，能用的模型都列出来，点一个就填好，也可以手动输入；
   • 接口地址已按厂商填好，一般不用改；用中转服务时才换成它给的地址；
   • 保持「记住选择」勾选，点「启动系统」。
6. 认出你　进入主界面后，在输入框里输入认证密码并发送（输入框里提示的「唤醒密码」就是它）。她认出你，就可以开始了。每次重新打开软件，都要再发一次——没认证时她只把你当访客。

3申请模型 Key

任选一家即可，之后随时可以再加。国内用户推荐 DeepSeek 或通义千问：直连、注册简单、价格低。

三件事：Key 创建后往往只完整显示一次，当场复制存好；Key 等于你的账户余额，别发给任何人；提示余额不足（quota）就是该去对应平台充值了。

4开启语音

以阿里云百炼的 Qwen Audio 为例，地址、模型和默认音色都已预填，只需要一个 Key。

1. 先完成第 2 节最后一步的认证——没认证时，语音设置读不出来也存不进去。
2. 在 阿里云百炼控制台 的「密钥管理」创建 API Key（北京地域）。模型也用通义千问的话，可以用同一个 Key。
3. 点主界面右上角的「设置」，切到「语音」页。「Qwen Audio 3.0 实时预设」（北京公共线路）已经填好地址、模型和默认音色。
4. 把 Key 粘进「密钥（API Key）」，然后打开「启用这条语音线路」——拨动就会保存，连同密钥框里的内容。
5. 确认「本机单人模式」是开着的（第一次使用已默认打开）。它表示你确认电脑周围只有你在用；关着的话，持续听会被安全拦截，看起来像语音没反应。
6. 点「试听」：能出声，说明整条线路都对；不出声就点「测试当前连接」，它会逐项告诉你哪一步没通。想换音色，点「获取音色」，再点一张喜欢的卡片。
7. 点「进入连续语音」，或者发送键旁边的声波按钮，开口说话。她说话时你随时可以插话。

想让她的提醒、后台任务汇报也念出来，打开「允许主动开口」（默认关闭，戴耳机时她可能会突然开口）。用其他语音服务时，按 OpenAI 兼容的识别（/audio/transcriptions）与合成（/audio/speech）格式，填地址、Key、识别模型和合成模型即可。

5日常使用

换模型

输入框旁的模型按钮（鼠标停上去显示「切换模型」）随时切换，不用重启。正在回答的这一轮用原来的模型做完，下一句就用新的。要加新模型，在菜单最下面点「配新模型 → 设置」。

打断她

回答或执行时，发送键会变成停止键，点一下就停；语音里直接开口就行。

预览台

她做好的表格、文档、PDF、网页、代码会在右侧打开，不用切窗口。

撤回改动

右上角「改动」里按时间列着她改过的代码和配置文件，不满意可以撤回。

代码工作区

右上角「IDE Workspace」进入：文件树、编辑器、对话在同一个窗口。

交代长期的事

直接说「每天早上八点提醒我……」「这件事帮我盯着」，她会到点自己醒来去做。

6装技能、接 MCP

技能是她学会的一套做法，MCP 是接给她的一整套外部工具。都在对话里说一声就行，不用自己改配置。

贴链接装技能

把技能的 Git 仓库地址发给她，说「装上」。她会下载、装好依赖、加载，装好就能用。来路不熟的仓库，她会先问你一声。电脑里已有的技能文件夹，把路径发给她也一样。

把做法存成技能

把你的一套做法讲清楚，最后说「存成技能」。她会写成一份技能收进技能库，以后遇到同样的事就照着做。

插件市场

把插件市场的 Git 地址发给她，说「添加这个插件市场」。她会列出里面能装的插件，你看中哪个说一声，就装上了。

接上 MCP 服务

把 MCP 服务的名字或说明页链接发给她，说「接上」。在本机运行的服务多数用 Node.js 启动；远程服务要支持 Streamable HTTP，把地址和钥匙给她。

重启之后

对话里接上的 MCP，重启软件后不会自动接回。说一声「把某某接回来」，她记得上次是怎么连的。

• 要先装用链接装技能、添加插件市场，电脑上要有 Git；本机的 MCP 服务多数要用 Node.js。还没装的话，跟她说一声，她可以替你装上。
• 设置里「设置」→「能力」→「MCP 服务管理」列出写在配置里的本机服务，可以逐个开关，也能决定启动时是否自动连接。对话里临时接上的不会出现在这里。
• 压缩包只认 Aivy OS 导出的技能包（里面带 skill.json）。别处下载的压缩包，先解压，再把文件夹路径发给她。

7数据与卸载

• 数据在哪对话、记忆、设置都在本机的 %LOCALAPPDATA%\AivyOS；语音密钥单独加密保存在 %USERPROFILE%\.aivyos。
• 谁能访问默认只信任本机：来自局域网和其他设备的连接一律拒绝。要远程使用，得你亲自在配置里打开并设置访问口令。
• 卸载卸载时会问你：「保留我的数据」——重装后接着用；或「完全删除」——连同记忆、设置、语音密钥一起删干净。

8常见问题