Skip to content

Commit

Permalink
docs(QQ): 更新napcat配置文件,修改内置bug解决方法 (sealdice#195)
Browse files Browse the repository at this point in the history
  • Loading branch information
MX-fox authored May 31, 2024
1 parent c6369b6 commit 58f85a8
Showing 1 changed file with 52 additions and 35 deletions.
87 changes: 52 additions & 35 deletions docs/deploy/platform-qq.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,8 +92,8 @@ Windows Server 2012 可能会缺少部分运行库,需要自行下载安装。

但如果你仍然决定使用「QQ(内置客户端)」,当遇到无法使用时可以尝试以下解决方案:

- PC 端:在 WebUI 删除账号,删掉 `data/default/extra/lagrange-QQ号` 目录,重新添加。
- 安卓端:停止海豹核心,在右上角设置中将「文件同步模式」打开,返回主界面,点击「导出文件」,到显示的目录删掉 `data/default/extra/lagrange-QQ号` 目录,然后点击「导入文件」,删除账号重新添加。
- PC 端:删除 `data/default/extra/lagrange-QQ号` 文件夹,重启海豹,删除账号重新添加。
- 安卓端:停止海豹核心,在右上角设置中将「文件同步模式」打开,返回主界面,点击「导出数据」,到显示的目录删除 `data/default/extra/lagrange-QQ号` 目录,然后点击「导入数据」,删除账号重新添加。

:::

Expand Down Expand Up @@ -346,7 +346,7 @@ Lagrange 项目对其配置文件的格式进行过更改。如果你是在 2024

:::

NapCat 是基于官方 NTQQ 实现的 Bot 框架,因此在开始前,你需要根据 [NapCatQQ](https://github.com/NapNeko/NapCatQQ?tab=readme-ov-file#%E5%AE%89%E8%A3%85) 的 README 安装官方 QQ,若 QQ 版本过低会导致程序无法正常启动。
NapCat 是基于官方 NTQQ 实现的 Bot 框架,因此在开始前,你需要根据 [NapCatQQ](https://napneko.github.io/zh-CN/guide/getting-started#%E5%AE%89%E8%A3%85-qq) 的手册安装官方 QQ,若 QQ 版本过低会导致程序无法正常启动。

### 下载 NapCatQQ

Expand All @@ -358,50 +358,67 @@ NapCat 是基于官方 NTQQ 实现的 Bot 框架,因此在开始前,你需

json 配置内容参数解释:

```json{6-9}
```json{18-25}
{
// 是否启用 http 服务,true 为启动,false 为禁用,如果启用,可以通过 http 接口发送消息
"enableHttp": false,
// http 服务端口
"httpPort": 3000,
// 是否启用正向 websocket 服务
"enableWs": true,
// 正向 websocket 服务端口
"wsPort": 3001,
// 是否启用反向 websocket 服务
"enableWsReverse": false,
// 反向 websocket 对接的地址,如 ["ws://127.0.0.1:8080/onebot/v11/ws"]
"wsReverseUrls": [],
// 是否启用 http 上报服务
"enableHttpPost": false,
// http 上报地址,如 ["http://127.0.0.1:8080/onebot/v11/http"]
"httpPostUrls": [],
// 是否启用 http 心跳
"enableHttpHeart": false,
// http 上报密钥,可为空
"httpSecret": "",
// 消息上报格式,array 为消息组,string 为 cq 码字符串
"http": {
// 是否启用http服务, true为启动,false为禁用
"enable": false,
// HTTP服务监听的 ip 地址,为空则监听所有地址
"host": "",
// http服务端口
"port": 3000,
// http上报密钥,可为空
"secret": "",
// 是否启用http心跳
"enableHeart": false,
// 是否启用http上报服务
"enablePost": false,
// http上报地址, 如["http://127.0.0.1:8080/onebot/v11/http"]
"postUrls": []
},
"ws": {
// 是否启用正向websocket服务
"enable": true,
// 正向websocket服务监听的 ip 地址,为空则监听所有地址
"host": "",
// 正向websocket服务端口
"port": 3001
},
"reverseWs": {
// 是否启用反向websocket服务
"enable": false,
// 反向websocket对接的地址, 如["ws://127.0.0.1:8080/onebot/v11/ws"]
"urls": []
},
"GroupLocalTime": {
"Record": false,//是否开启本地群聊时间记录
"RecordList": []//开启全部群 ["-1"] 单个群配置 ["11111"] 多个群 ["1","2","3"]
},
// 是否开启调试模式,开启后上报消息会携带一个raw字段,为原始消息内容
"debug": false,
// ws心跳间隔,单位毫秒
"heartInterval": 30000,
// 消息上报格式,array为消息组,string为cq码字符串
"messagePostFormat": "array",
// 是否将本地文件转换为URL,如果获取不到url则使用base64字段返回文件内容
"enableLocalFile2Url": true,
// 音乐签名URL,用于处理音乐相关请求
"musicSignUrl": "",
// 是否上报自己发送的消息
"reportSelfMessage": false,
// 是否开启调试模式,开启后上报消息会携带一个 raw 字段,为原始消息内容
"debug": false,
// 调用 get_file 接口时如果获取不到 url 则使用 base64 字段返回文件内容
"enableLocalFile2Url": true,
// ws 心跳间隔,单位毫秒
"heartInterval": 30000,
// access_token,可以为空
"token": ""
}
```

其中有几个重要的设置项需要填写和注意:

- `enableWs`:这是 NapCat 的 ws 正向连接配置,你需要将其修改为 `true`,即启用正向 WebSocket 方式连接 NapCatQQ。
- `wsPort`:这是正向连接端口,请记下以便后续使用。
- `ws:enable`:这是 NapCat 的 ws 正向连接配置,你需要将其修改为 `true`,即启用正向 WebSocket 方式连接 NapCatQQ。
- `ws:port`:这是正向连接端口,请记下以便后续使用。

也可以使用 WebUI 进行配置,具体请看 [NapCat 手册](https://napneko.github.io/zh-CN/guide/config)

修改完文件后请根据 [NapCatQQ](https://github.com/NapNeko/NapCatQQ?tab=readme-ov-file#windows-%E5%90%AF%E5%8A%A8) 的教程启动程序,扫码登录即可。
修改完文件后请根据 [NapCatQQ](https://napneko.github.io/zh-CN/guide/getting-started#%E5%90%AF%E5%8A%A8) 的教程启动程序,扫码登录即可。

### 海豹连接

Expand Down

0 comments on commit 58f85a8

Please sign in to comment.