NapCatQQ项目中的推荐群聊/联系人接口问题解析

在NapCatQQ项目的2.5.0版本中，开发者发现了一个关于推荐群聊和联系人功能的接口调用问题。这个问题涉及到三个相似的API接口：ArkShareGroupEx、ArkShareGroup和ArkSharePeer。

问题现象

当开发者尝试使用ArkShareGroupEx接口时，系统会返回"不支持的api"错误。而文档中提到的ArkShareGroup接口虽然能够正常返回推荐群聊信息，但当尝试传入联系人QQ号时，却会导致QQ客户端卡死。另一个接口ArkSharePeer则要求必须传入group_id参数，其他参数实际上不起作用，这使得推荐好友的功能无法正常实现。

技术分析

经过项目维护者的深入调查，发现这是一个接口命名错误导致的问题。实际上，ArkShareGroup和ArkSharePeer这两个接口的功能被错误地互换了。正确的对应关系应该是：

• ArkSharePeer接口应该用于处理群聊推荐
• ArkShareGroup接口应该用于处理联系人推荐

解决方案

项目维护者已经在代码提交中修复了这个问题。具体修改是交换了这两个接口的命名，使得：

• 当需要推荐群聊时，应该使用ArkSharePeer接口并传入group_id参数
• 当需要推荐联系人时，应该使用ArkShareGroup接口并传入user_id参数

使用建议

对于开发者来说，在使用这些接口时需要注意：

1. 确保使用最新版本的NapCatQQ
2. 推荐群聊时使用ArkSharePeer接口
3. 推荐联系人时使用ArkShareGroup接口
4. 传入正确的参数类型和格式

这个问题的修复将确保推荐功能的正常运作，避免客户端卡死或返回错误信息的情况发生。对于仍然遇到问题的开发者，建议检查接口调用方式和参数设置是否正确。