今天这篇要说的是一个叫 AIRI 的二次元桌面 AI 桌宠。它的核心能力很简单把一个有角色性格、能聊天、能陪你玩文字游戏的 AI 角色放到电脑桌面里而不是让你对着网页聊天框打发时间。AIRI 在项目里被对外叫“AI 女友”实际体验下来更准确的描述应该是“桌宠型 AI 角色”。它免费开源、本地可跑适合想低成本体验 AI 陪伴、又不想只是打开网页版聊天窗口的人。这类项目最值得先看的不是功能列表而是能不能在普通电脑上稳定跑起来。AIRI 的优势是门槛不算高Windows 和 macOS 都有对应的下载包不需要自己训练模型也不需要懂深度学习。你只要有基本的电脑操作能力按步骤配置好运行环境和大模型接口就能让角色出现在桌面陪你聊天。这篇保姆级教程我会按“它解决什么问题”“环境怎么准备”“怎么安装”“怎么玩”“参数怎么调”“报错怎么排查”的顺序拆开写。你不需要提前掌握 Git、Python 或模型部署知识但如果你之前跑过任何开源项目理解起来会更快。1. AIRI 到底是什么先把“AI 桌宠”这个词拆清楚1.1 它不是新模型而是一个“角色壳子 对话后端”的组合很多第一次接触这类项目的人会误会以为 AIRI 是一个全新的 AI 大模型。实际不是。AIRI 更接近一个桌面应用你看到的是二次元角色形象、聊天窗口、桌宠动画角色背后接的才是大模型能力。简单说AIRI 负责把“模型输出”变成一个“有人格、有表情、会互动”的桌宠角色。打个比方大模型是演员AIRI 是人设和舞台。同一个模型放在普通聊天界面里就是冷冰冰的问答机器放进 AIRI 这种桌宠壳子里就有了“女朋友”“好朋友”“游戏搭子”之类的角色感。这样设计的最大好处是你不需要从头训练模型只需要配置对话后端。项目本身负责角色形象、交互逻辑、桌宠窗口和游戏玩法。1.2 它真正解决的是“陪伴感”问题网页聊天工具也能和 AI 对话但它缺少陪伴感。AIRI 这类桌宠解决的就是这个问题。它把你的桌面变成了一个微型互动空间。角色可以悬浮在窗口上也可以作为独立聊天窗口打开。你写代码、查资料、刷网页的时候角色就待在一旁。这种“随时在”的感觉比打开一个网页聊天框更容易让人坚持使用。再加上游戏互动AIRI 的陪伴属性会更明显。不是只有你问一句它答一句而是可以一起玩文字类游戏比如猜谜和脑筋急转弯文字冒险角色扮演式的小剧场你出题、它扮演某个角色的互动游戏这些玩法本质上还是大模型生成的文本但被包装成“游戏互动”后体验就完全不同了。1.3 它的边界要提前说清楚AIRI 不是语音助手不是自动化工具也不是一个能帮你完成复杂工作的 Agent。它更适合定义成“桌面娱乐型 AI 对角”。所以别拿它和智能音箱、办公助手比。它偶尔会忘记上下文会答非所问会在游戏里突然搞错规则。这些问题不是 AIRI 独有的而是所有对话模型的通病。理解这个边界你玩起来就不会失落。2. 准备好这些环境条件再下载也不迟2.1 系统、内存和磁盘的基本要求从项目下载链接来看AIRI 提供 macOS 和 Windows 两个版本这点对普通用户很友好。最常见的运行环境是项目最低要求推荐要求说明操作系统Windows 10 / macOS 12Windows 11 / macOS 13版本太老可能缺少运行库内存8 GB16 GB本地加载大模型时内存越高越稳磁盘空间2 GB10 GB以上项目依赖加模型缓存会占空间显卡无要求CPU可跑有独显更好是否必须 GPU 取决于对话后端如果你打算用在线模型接口电脑配置压力会比较小。一般办公电脑都带得动。如果你打算完全本地运行大模型那建议 16 GB 内存起步否则模型加载速度会非常难受。别追求“最低配置跑通”。低配置能启动不代表适合日常使用。尤其当你开了桌宠动画同时又在跑聊天模型后台资源占用会明显上升。先用小配置验证流程再决定要不要升级。2.2 依赖和运行库项目说明没写明也要提前准备AIRI 这样的桌宠项目一般会依赖 Python 或 Node.js 环境也可能直接提供编译好的安装包。如果你拿到的是源码版通常需要Git用于从仓库拉取代码Python 3.10 以上用于运行后端逻辑pip用于安装 Python 依赖Node.js部分桌面应用需要用于前端界面桌面运行环境比如 Electron 或 Tauri 对应的运行库这些听起来复杂但绝大多数都可以一条命令装好。真正容易出问题的不是安装本身而是版本不一致。Python 3.8 和 3.12 对某些库的支持完全不同建议先按项目 README 里的要求来。2.3 免费使用要分清两层含义标题里说“完全免费”我要帮大家把“免费”拆成两层看第一层项目开源代码免费。你从仓库下载源码不用付费这部分是确定的。第二层运行成本。AIRI 要用大模型对话对话后端有两种选择一种是接入在线模型接口按 token 计费另一种是使用本地模型。如果接在线接口不是你打开软件就全程免费而是模型服务商按你的调用量收费。本地模型则主要消耗你的电脑算力不需要额外付费。所以如果你想要“真正零成本”就得盯住本地模型方案。如果只想先体验那就先用默认模型配置跑通之后再考虑换更便宜的方案。这点在下载前就要想清楚免得后续产生费用误会。3. 保姆级安装流程从仓库到桌面启动3.1 获取项目文件Clone 或下载压缩包只要项目在 GitHub 上就有两种常见方式拿到代码。第一种使用 Git 命令克隆仓库。打开终端进入你想存放项目的目录然后执行git clone https://github.com/mewamey/my_ai_town.git第二种直接在仓库页面点击 Code 按钮选择 Download ZIP然后解压到本地目录。两种方式都可以。如果后续要更新项目建议用 Git 方式。如果只是体验一次直接下载 ZIP 更省事。我一般建议不要用带空格或中文字符的目录路径存放项目比如C:\Users\我的文档\新桌面宠物这种路径容易在依赖安装阶段出问题。尽量用纯英文路径比如D:\AIRI或~/ai_town。3.2 创建独立的运行环境避免污染系统环境如果项目是源码版不要直接把依赖装到全局环境。最好是创建一个虚拟环境把项目所需的 Python 包隔离起来。这样即使版本装错了也不会影响系统里其他工具。在项目根目录执行python -m venv .venvWindows 下激活虚拟环境.venv\Scripts\activatemacOS 或 Linux 下激活虚拟环境source .venv/bin/activate然后安装项目依赖。多数 Python 项目会提供requirements.txtpip install -r requirements.txt如果项目前端基于 Node.js可能还需要执行npm install到这里项目代码和主要依赖就已经就位了。别急着启动下一步把模型接口配置好。3.3 配置大模型接口这是最容易被卡住的环节AIRI 要让角色开口说话必须有对话模型接入。常见的配置方式是环境变量或配置文件。项目根目录一般会有一个示例文件比如.env.example或config.example.json复制一份为.env或config.json再修改。典型配置项包括MODEL_BASE_URLhttp://127.0.0.1:11434/v1 MODEL_API_KEY你的密钥 MODEL_NAMEqwen2.5这套格式看起来像 OpenAI 兼容接口但实际上很多本地模型服务也支持类似格式。比如你已经装了 Ollama就可以把本地地址填进去把模型名改成你本地已下载的模型。如果你接入的是云厂商模型就在对应的位置填上服务商提供的地址和密钥。如果你不确定填什么先去仓库 README 里看“配置”或“快速开始”部分。这里最容易踩的坑是配置文件改了但没生效或者填错了模型名导致启动报错。我建议先确认三件事项目到底读哪个配置文件模型接口地址能不能在浏览器里访问模型名是否完全一致这三件事确认完启动过程基本就顺畅了。3.4 启动项目第一次打开能看到窗口就算成功启动命令取决于你的项目类型。常见的启动方式有python main.py或者npm start或者下载打包版后直接双击应用图标。第一次启动不求功能全开只求窗口能正常弹出来。如果打开的只是一个聊天网页那也没关系先看聊天能不能发出第一条消息。角色动画、窗口置顶、游戏模式都是后面逐步测试的事。我自己的习惯是先跑一个“最小测试”发一句“你好”看角色有没有回复。只要这句能正常回复说明项目主体、模型接口、配置连接都没问题。接下来再逐渐加功能。4. 让 AIRI 陪你玩对话、游戏和桌宠窗口的基本用法4.1 对话不是关键关键是给角色设定AIRI 的角色感很大程度上来自系统提示词。所谓系统提示词就是一段告诉模型“你现在是谁、说话风格是什么、喜欢什么背景”的文本。如果你觉得 AIRI 不够可爱、不够有性格不要急着换模型先调整系统提示词。一个简单的角色设定示例你是一个活泼可爱的二次元桌宠名字叫 AIRI。 你喜欢陪用户聊天、玩游戏、分享日常心情。 你说话简短喜欢用语气词偶尔带一点俏皮。 遇到不懂的问题就直说不要假装很懂。把这段设定放到项目配置的角色人设位置AIRI 的话风马上会变化。这个技巧不仅适用于 AIRI也适用于任何角色扮演类 AI 应用。4.2 游戏互动的思路把“命令”说清楚AIRI 能陪你玩哪些游戏取决于底层模型的文本创作能力而不是它真的内置了几个小游戏。它的游戏模式更像“即兴表演”你说要玩猜谜它会进入猜谜状态你说要玩文字冒险它会给你场景选项你说要角色扮演它就会按当前人设配合。想触发游戏最简单的说法是“我们来玩猜谜游戏你先出一个题目。”“陪我玩文字冒险我要扮演一个在废弃车站醒来的侦探。”“你扮演一个会魔法的桌宠我现在遇到一只不听话的代码报错怪兽。”重点是给模型明确指令。不要只说“陪我玩”这会让它不知道玩什么。越具体的游戏指令角色进入状态越快。我实测过几次后发现AIRI 玩角色扮演类比玩规则复杂的桌游更顺手。文字冒险类容易在不同回合之间忘记上下文短小互动类反而稳定。所以不建议上来就跑超长剧情先玩三五轮的小场景效果会好很多。4.3 桌宠功能悬浮窗、置顶和最小化AIRI 既然叫桌宠就不会只是一个聊天窗口。它通常具备这些能力悬浮窗模式角色可以置顶在其他应用之上拖动位置让你把角色放在桌面角落最小化到悬浮小球减少视觉干扰右键菜单切换角色、退出程序、打开设置这些桌宠功能的价值是让你在干别的事情时角色依然在视觉范围内存在。人在写代码、写文档、看网页时会觉得不孤单这是桌宠区别于普通聊天软件的核心体验。但要注意悬浮窗模式如果在直播、录屏或远程会议中使用可能会意外出现在画面上。用之前先确认角色窗口是否置顶避免尴尬。5. 参数、开销和稳定运行的判断标准5.1 对话模型参数别让角色“太聪明”或“太胡说”AIRI 的对话质量受几个参数影响很大。最常见的几个参数作用建议temperature控制回复随机性0.7 左右适合聊天太低会死板太高会胡言乱语top_p控制候选取词范围配合 temperature 使用不建议同时拉满max_tokens控制最大回复长度聊天场景 512 足够游戏场景建议 1024system_prompt角色人设设定越具体越像角色越模糊越像通用 AI新手最容易犯的错误是把 temperature 调到 1.5 以上觉得这样角色更有趣。实际体验是回复变得跳脱经常答非所问角色还可能突然说出不符合人设的话。我建议从 0.7 开始觉得太机械就调到 0.8觉得太疯就降到 0.6一次只动一个参数。5.2 判断“能不能日常用”要注意三个指标很多人在测试 AIRI 时只看“能不能回复”这个判断远远不够。日常使用至少要看三个指标单次回复延迟连续任务成功率资源占用稳定性单次回复延迟指的是你发一句话后角色多久开始回复。在线接口通常一两秒内开始响应本地模型可能十几秒甚至更久。如果每次回复都让你等几十秒那再可爱都会失去耐心。连续任务成功率指的是连续发十句对话有没有出现无响应、报错、卡死。不要只测一句就下结论至少连续测十句。资源占用稳定性指的是运行一段时间后内存和 CPU 占用是否异常爬升。如果开始运行只有 500MB半小时后涨到 2GB那就是有内存泄漏。这时候该做的不是改参数而是升级版本或排查后端进程。5.3 显存、内存和模型体积的关系如果你用本地模型就要关注显存和内存因为这决定了你能跑多大的模型。以常见的 7B 量级模型为例量化版通常在 4GB 到 6GB 之间。运行起来后内存占用会明显上升。如果你的电脑只有 8GB 内存同时还要跑桌宠动画和浏览器翻车概率很高。这种情况下有两个降级方案换更小的模型比如 3B 或 1.5B使用在线模型接口把算力压力转移不要迷信大模型。AIRI 这种场景角色感比模型大小更重要。1.5B 模型只要人设调得好互动体验也完全够用。6. 常见问题排查先看日志再改配置6.1 启动失败或闪退启动失败先不要想太复杂。按这个顺序排查看终端或日志文件有没有报错看依赖是否安装完整看配置文件是否被正确读取看端口是否被占用看系统版本是否满足要求很多闪退问题其实不是项目写坏了而是安装依赖时少装了一个包或者配置文件里填了一个错误的模型名。项目一般会提供日志输出。启动时如果能看到终端窗口先把最后二十行报错信息截图这比盲目重写配置有效得多。6.2 聊天没反应或一直转圈聊天没反应十有八九是模型接口的问题。排查顺序确认模型接口地址能从本机访问确认 API Key 或本地服务认证方式正确确认模型名称填得和接口返回一致确认网络或本地服务没有超时如果你是用在线接口先检查是不是余额不足、密钥过期、并发限制。如果你是用本地模型服务先检查模型有没有加载完成。本地模型加载通常比较慢加载期间发消息会表现为“没反应”。6.3 游戏互动没触发如果你说“陪我玩”AIRI 只是普通回复不进入游戏状态这不是问题而是角色识别不到你的游戏意图。改进方法有两种在系统提示词里加一句“当用户提到猜谜、冒险、角色扮演时你要立刻进入游戏状态”在对话里直接给游戏指令比如“现在开始文字冒险给我三个选项”如果这两种都试了还是不行那就把角色人设里的游戏规则写得更详细把玩法、角色、目标都写进配置里。AIRI 的游戏能力不是固定按钮而是靠人设指令激发出来的这点和传统游戏完全不同。6.4 低配置电脑的降级策略如果你手上的电脑配置不高AIRI 卡得厉害可以按顺序做这些调整关闭桌宠动画只保留静态角色或聊天窗口把窗口透明度和模糊效果关掉切换在线模型接口减少本地计算压力降低回复最大长度减少单次生成时间连续对话时清理聊天记录避免上下文过长这些做法不能提升效果上限但能让使用体验变得顺滑。很多时候不是 AIRI 设计得不好而是当前设备给不了它足够的资源。7. 后续优化从“能跑”到“长时间使用”7.1 本地模型替换开源模型是常见选择如果你想把 AIRI 彻底做成离线桌宠本地模型替换是必走的路。常见的开源模型包括 Qwen、DeepSeek、ChatGLM 等系列中的中低参数版本。AirI 这类项目本身不绑定特定模型你只需要在配置里切换模型名称和接口地址。换模型之后角色人设要重新调一遍。不同模型的理解能力和表达风格不一样同一个角色设定在 A 模型下很可爱在 B 模型下可能变得很啰嗦。我建议每次切换模型后先用同一组测试对话跑一遍比如“介绍一下你自己”“我们今天玩个猜谜游戏”“你现在的心情怎么样”这三句话能快速暴露模型的角色感偏差。7.2 多角色切换和数据备份AIRI 如果体验不错你大概率会想让多个角色轮流出来。这时候项目支持角色配置目录的话就可以提前保存多个角色设定文件。建议把所有角色设定、人设提示词、参数配置复制到备份目录。因为开源项目更新频繁升级版本后配置格式可能变化没有备份就只能重新调。我自己的做法是每个角色单独创建一个配置文件命名方式类似character_airi.json、character_luna.json并在文件顶部注释写清楚创建时间和模型接口。这样以后排查问题一查就知道是配置问题还是角色设定问题。7.3 长期稳定运行的几个经验AIRI 这类桌宠项目长期使用的稳定性不一定来自代码本身更多来自你的使用习惯。第一要给日志留位置。如果项目有日志开关建议打开。日志能记录每次调用模型的时间、状态和报错方便事后复盘。第二定期清理历史会话。长时间对话会不断累加上下文导致模型请求变慢、费用变高。不是所有内容都值得保留。第三不要频繁切换模型接口。每次切换都可能带来配置变动、上下文丢失和角色性格变化。如果你已经习惯了一个模型就固定下来减少变量。第四注意版权和内容安全。AIRI 的对话内容由底层模型生成你在调整人设时不要引导模型输出违反主流价值观的内容。桌宠是陪伴工具保持正常、健康、积极的使用方向才能稳定玩得久。我个人的结论是AIRI 这类二次元 AI 桌宠真正好玩的地方不是“白嫖”了一个 AI 女友而是你通过下载、配置、调人设、试游戏亲手把一个大模型角色变成了桌面伙伴。它也许不会有 3A 游戏的画面也没有复杂到能当秘书的智能但那种“桌面角落有个会用角色口吻陪你聊天、陪你玩游戏”的感觉确实很新鲜。建议你从最小配置开始先用默认模型跑通再逐步换成更合适的角色和模型。一次只改一个参数每次改动后用日志验证效果。踩过几次坑之后你就会发现很多问题不是工具能力不够而是前置环境和输入材料没有处理干净把基础流程理顺AIRI 才能真正稳定地陪在你桌面上。