v1.0.0 · Windows 10 / 11(64 位)

把 QQ 机器人
装进一个窗口

不用再开黑窗口敲命令、不用翻 .env 文件。 填好你自己的密钥,点一下启动,机器人就上线了。

106 MB · 首次运行会被 Windows 提示「未知发布者」, 点「更多信息 → 仍要运行」即可(程序没有买代码签名证书)

deepsleep 控制台
deepsleep 控制台 · 总览页

该有的都有

一个窗口管到底:启停、配置、看日志、查问题。

一键启停

点「启动」机器人上线,点「停止」干净退出。停止前会自动保存对话记忆。

图形化配置

人设提示词、模型参数、记忆长度、语音音色,都在界面上改,不用碰配置文件。

联网搜索

任何模型都能联网:方舟 / OpenAI / Kimi 用自带搜索,其它模型走工具调用,新闻类问题直接取热榜正文。

看懂图片

群里发图它能看,问「这张图里是什么」也有回答。

会说话

接 MiniMax 语音:/语音 你好 直接发语音条,还能挑音色、调情绪。

记得住

对话记忆存在本地,重启不丢;超长对话自动压缩成摘要,聊多久都记得。

实时日志

机器人干了什么、哪里报错,一目了然。可按等级过滤、搜索、导出。

出错说人话

凭证错、被限流、连不上网——都翻译成中文原因,并告诉你怎么处理。

新增

机器人挂在服务器上,也能在这儿管

把机器人放在云服务器上跑,你电脑关机它也不下线。 以前得开 SSH 窗口敲 pm2 restart,现在这个控制台直接连过去。

远程启停

在不在跑、跑了多久、占多少内存、重启过几次,一屏看完;启动 / 停止 / 重启都是点一下。

配置一键推送

人设、模型、语音在本机改好,点「推送配置」自动上传、按服务器上的路径改写、重启生效,不用手动改服务器文件。

服务器记忆看得见

记忆页读的就是服务器上那一份:几个会话、占多大、最后什么时候聊的。点「清空服务器记忆」会先自动备份再清空。

密钥不用自己敲命令

界面上生成 SSH 密钥、一键装到服务器,装完当场验证通不通。私钥只留在你电脑上。

远程服务器页:开关远程模式、填服务器地址与远程目录
远程服务器:开关一开,总览页的「启动 / 停止」就变成操作服务器上那一个
远程服务器页下半部分:密钥、启停操作与配置推送
同一页往下:密钥、启停、看日志、推送配置
记忆页在远程模式下显示服务器上的记忆概况
记忆页也跟着切过去,显示的是服务器上那份
用系统自带的 SSH,密钥不出本机

连接用的是 Windows 10 / 11 自带的 OpenSSH,程序不带也不装任何第三方库。 SSH 私钥生成在 %APPDATA%\deepsleep\ssh\ 下,只在你电脑上, 只在连你自己的服务器时使用。

长这样

左侧导航 + 卡片式配置,跟普通 Windows 程序一样。

模型与对话设置,含联网搜索配置
模型与对话:连人设带联网搜索,都在这一页
语音设置页
语音:选音色、调情绪,点「试听」当场听效果
实时日志页
日志:实时滚动,出问题自己就能看出来

三步用上

从下载到机器人上线,大概 3 分钟。

  1. 01

    准备两样东西

    在 q.qq.com 创建机器人,到「开发设置」复制 AppID 与 AppSecret;再准备一个模型 API Key(例如火山方舟)。

  2. 02

    安装并跟着向导填

    运行安装包,首次打开会弹出配置向导:填 QQ 凭证 → 填模型 →(语音可跳过)。 每一步都能点「测试」当场验证通不通。

  3. 03

    点启动,去群里 @ 它

    状态变绿「已上线」就成功了。群里 @ 你的机器人说句话,它会回你。 之后想改人设或换模型,界面上改完点保存即可。

    (机器人是跑在服务器上的话,再去「远程服务器」页连一次, 之后就能在这个窗口里远程启停、看日志、推配置。)

关于「未知发布者」提示

Windows 会对没有代码签名的程序弹警告。点「更多信息」→「仍要运行」即可。 如果杀毒软件误报,把安装目录加入信任。

常见问题

需要先装 Node.js 吗?

不需要。程序自带运行环境,双击就能用。

我的密钥会上传到哪儿吗?

不会。密钥只写在你电脑的 %APPDATA%\deepsleep\config.json 里, 程序只跟「QQ 开放平台」和「你自己填的模型服务」通信,不经过任何中间服务器。

对话记录存在哪?卸载会删吗?

存在 %APPDATA%\deepsleep\ 下(配置、记忆、日志)。 卸载程序不会删除这些数据,重装后记忆还在;要彻底清掉就手动删这个文件夹。

机器人不说话 / 群里 @ 它没反应

按顺序看三处:① 总览页是否「已上线」;② 日志页有没有红色报错; ③ 在 q.qq.com 确认机器人是「已上线」状态。多数情况是凭证填错或模型 Key 无效, 界面上会直接告诉你原因。

可以同时开两个吗?

不行,同一个机器人同一时间只能有一个连接。程序做了单实例保护,重复双击只会聚焦已有窗口。

「远程服务器」要额外装什么东西吗?

不用。用的是 Windows 10 / 11 自带的 OpenSSH,程序本身不带也不装任何第三方库。 你只要有一台能 SSH 登录的服务器(阿里云、腾讯云之类的都行), 在「远程服务器」页填上地址、端口、登录用户和机器人所在目录就能用。

SSH 私钥会不会被传走?

不会。密钥生成在你自己电脑的 %APPDATA%\deepsleep\ssh\ 下, 只在连你自己的服务器时使用;界面上显示密钥时也会打码,不会整串亮出来。

点「清空服务器记忆」会把数据弄丢吗?

不会。清空前会先把原文件复制一份成 sessions.json.bak-日期-时间, 再清空正文。真要找回,把备份文件改回原来的名字就行。

支持 macOS / Linux 吗?

目前只提供 Windows 64 位版本。

准备好让你的机器人上线了吗

106 MB · Windows 10 / 11(64 位)