入门指南

1. 运行指南

1.1 使用可执行文件直接运行

无需配置任何环境，下载即可用。
目前该方式只支持官方API的使用，若使用三方API需要参照1.2源码运行。

详细步骤

1. 前往 Release 下载对应平台的可执行程序。

如果是无梯服务器，可以考虑手动上传，或者使用一些镜像站，例如ghproxy。

2. 如果是Linux类的系统，需要赋予脚本执行权限。

sudo chmod +x chat_gpt_oicq-linux 

3. 运行可执行文件。

如果希望在只有命令行的Linux服务器上后台持续运行，推荐联合使用screen。

4. 根据提示，输入QQ信息，OpenAI的API验证等。

• OpenAI的key，需要有OpenAI账号之后在 这里申请 API的密钥。这个密钥和你的账号收费直接绑定，请妥善保存。
• 输入机器人密码即使用密码登陆，如果机器人的密码留空，则开启扫码登陆。
• 扫码登陆只能基于同一wifi。如果远程服务器登陆使用扫码，则先在本地扫码登陆，然后将本地项目data文件夹对应机器人QQ号的内容，以及生成的配置config.json转移到云端。
• 密码登陆需要通过QQ的滑动验证码并获取ticket。对应方法可以搜索“QQ 滑动验证码 取得 ticket”等方式搜索。

5. 等待机器人发送的“已上线~”，说明服务已经成功部署，可以和机器人开始聊天了。

1.2 从源码运行

步骤

1. 下载 nodejs https://nodejs.org/ 并且安装 (版本需要 > 18)
2. 拉取项目 https://github.com/easydu2002/chat_gpt_oicq，并切换到文件夹追踪

git clone https://github.com/easydu2002/chat_gpt_oicq
cd chat_gpt_oicq/

如果是无梯服务器，可以考虑手动上传，或者使用一些镜像站，例如ghproxy。(gitee镜像正在准备中……)

3. npm安装依赖。（提示安装tsx确认即可）

npm install

如果是无梯服务器，需要更改npm镜像源，例如淘宝镜像。

4. npm运行程序。

npm run dev 

第三方API和官方API有什么区别？

三方API使用的chatgpt公开的网页聊天接口，而官方API是OpenAI维护运行的API。

三方API免费，官方API收费（有18美元试用金）。

三方API速度慢且有字符限制，官方API响应快易定制。

在该项目中官方API更易部署。

附录A 手机运行指南

Q: 如果没有服务器，也没有一台能时常在线的电脑，有没有办法拥有一个“猫娘”呢？

答案是有的！！ 注意环境要求，必须的实际就是 nodejs>18，所以说，只要你的设备能够运行nodejs18，就算在你的智能电饭煲上也能部署一个（

A.1 步骤

1. 安装 termux。
2. 在安卓系统中为termux配置后台启动，避免被杀后台导致程序中断。
3. 运行 termux，并且下载可执行文件。
   无图形界面可以用 wget 下载对应 linux 可执行文件。对应地址可以在 Release 查询到。例如：

wget https://github.com/easydu2002/chat_gpt_oicq/releases/download/1.0.0/chat_gpt_oicq-linux

4. 按照 1.1 的指导运行脚本。

如果你使用的是扫码登陆，二维码显示可能略有问题。若无法扫码，可以考虑横屏，双指缩放等等方式多尝试几次。