用户手册¶

月璃是一台要装在你电脑或服务器上的程序，不是网页服务：装好之后她跑在你的机器里， 数据也在你自己的硬盘上。这份手册带你从零装到能用，全程大概二十分钟。

先选一条路¶

三条路线装的是同一套后端，区别只在要不要桌宠、跑在哪台机器。

不知道自己该选哪条¶

这台电脑平时开着，你想要桌宠陪你。 走 Windows 桌面版。要求 Windows 10 或 11， 装完她会出现在屏幕角落，托盘里能开关。

你想让她 24 小时在线，手机随时能找到。 走服务器部署。可以是一台云服务器、 一台旧笔记本或家里的 NAS，Linux 和 Windows Server 都行；管理面板用浏览器打开。

你只有一台 Windows，也不想让她一直占着屏幕。 还是走 Windows 桌面版， 装完后在设置里关掉桌宠外壳，她就退成后台服务，不影响你干别的。

你完全不想碰命令行。 走「让 AI 帮你装」，把那段指令交给 Claude、GPT 或任意能执行命令的 AI，让它照着做。

Windows 桌面版¶

1. 确认环境要求——五分钟，看你的机器够不够
2. 下载与安装——拿到代码、装依赖
3. 第一次启动与配置——同意协议、填一个 API Key
4. 桌面桌宠——让她出现在屏幕上
5. 接入 QQ——想让她在群里说话，再做这一步

服务器部署¶

1. 确认环境要求——服务器不需要图形环境
2. 下载与安装——只装后端，前端产物可以不构建
3. 无头部署——systemd 常驻、开机自启、面板怎么访问
4. 接入 QQ——协议端与月璃在同一台机器上跑

用 AI 安装¶

打开给 AI 的安装指令，把里面的内容整段复制给你的 AI。 那段指令写明了每一步该做什么、该问用户什么、失败了先查哪里， AI 照着执行即可；你也可以自己在旁边对着看，它每一步都会告诉你结果。

装完之后¶

• 配置——名字、人格、模型、功能开关分别在哪份文件里
• 功能——记忆、表情包、主动搭话、日程与睡眠
• 管理面板——浏览器里的观察与配置入口
• 常见问题——按症状查：启动、面板、模型、QQ、桌宠、数据