Signal-CLI中获取非联系人组员信息的解决方案

在使用Signal-CLI的JSON-RPC接口时，开发者可能会遇到一个常见问题：当群组中添加了新成员且该成员并非当前账户的联系人时，通过listGroups命令获取的成员信息不完整（特别是成员号码显示为null）。这种情况会影响需要完整群组成员信息的应用场景，比如消息提及功能中的用户名替换。

问题背景

Signal群组机制允许显示非联系人的基本成员信息，这与直接消息对话的可见性规则不同。官方Signal客户端能够显示这些非联系人成员的部分资料，但通过Signal-CLI的listGroups接口默认只能获取到UUID信息，缺少电话号码和姓名等关键字段。

技术原理

Signal-CLI实际上存储了所有已知接收者（recipients）的信息，包括：

1. 已保存的联系人
2. 有过交互的非联系人
3. 群组中的成员

默认情况下，listContacts命令只返回第一类联系人。要获取完整的接收者信息，需要使用扩展参数。

解决方案

通过JSON-RPC接口，可以使用以下两种方式获取完整信息：

方法一：查询所有已知接收者

{
  "jsonrpc": "2.0",
  "method": "listContacts",
  "params": {
    "all-recipients": true
  },
  "id": "1"
}

方法二：精确查询特定UUID的接收者

{
  "jsonrpc": "2.0",
  "method": "listContacts",
  "params": {
    "recipient": "d59...",
    "all-recipients": true
  },
  "id": "1"
}

实现建议

对于需要实时跟踪群组成员变动的应用，建议：

1. 监听群组更新事件
2. 当检测到新成员加入时，立即通过上述方法查询完整信息
3. 建立本地缓存以减少重复查询
4. 定期更新缓存中的成员信息

注意事项

1. 隐私考虑：获取非联系人信息应遵守Signal的使用条款
2. 性能优化：批量查询比单个查询更高效
3. 错误处理：某些情况下可能仍然无法获取完整信息（如用户设置了严格的隐私权限）

通过这种方案，开发者可以构建出与官方客户端功能相当的群组成员管理功能，确保在消息处理等场景中获得完整的上下文信息。