LiteLoaderQQNT-OneBotApi 私聊消息发送问题解析

在使用 LiteLoaderQQNT-OneBotApi 项目时，开发者可能会遇到无法通过 send_msg 接口发送私聊消息的问题。本文将深入分析该问题的原因，并提供解决方案。

问题现象

当开发者尝试通过 OneBot 协议的 send_msg 接口发送私聊消息时，虽然能够收到消息上报，但实际发送操作会失败。从日志中可以看到，系统会返回错误信息："api处理出错:TypeError: Cannot read properties of undefined (reading 'toString')"。

根本原因

经过分析，这个问题主要由以下两个因素导致：

1. 参数传递错误：开发者错误地在发送私聊消息时同时指定了 user_id 和 group_id 参数。在 OneBot 协议中，私聊消息和群聊消息是两种不同的消息类型，不应该混用参数。

2. 临时会话限制：当前版本的 LiteLoaderQQNT-OneBotApi 暂不支持发送临时会话消息（即通过群聊临时发起的私聊会话）。系统只能处理好友之间的私聊消息。

解决方案

要正确发送私聊消息，开发者需要遵循以下规范：

1. 仅使用 user_id 参数：发送好友私聊消息时，只需指定接收方的 user_id，不应包含 group_id 参数。

2. 明确消息类型：确保 message_type 参数设置为 "private"。

正确格式的请求示例如下：

{
  "action": "send_msg",
  "params": {
    "user_id": "接收方QQ号",
    "message": "要发送的消息内容",
    "message_type": "private"
  }
}

注意事项

1. 确保接收方已经是机器人的好友，否则消息发送会失败。

2. 对于群临时会话，目前版本确实不支持，开发者需要考虑其他交互方式。

3. 消息内容格式应符合 OneBot 协议规范，可以使用字符串或消息段数组形式。

通过遵循上述规范，开发者可以顺利实现私聊消息的发送功能。如果遇到其他问题，建议检查日志中的详细错误信息，并确认 API 调用是否符合协议规范。