名称: signal-cli
描述: 通过 macOS 本地安装的 signal-cli 发送 Signal 消息和查找 Signal 联系人。当用户要求向某人发送 Signal 消息、发送 Signal 文本/附件、列出 Signal 联系人，或通过姓名/昵称/电话号码解析收件人时使用。

signal-cli (Signal 消息发送)

使用本地 signal-cli 二进制程序。

前提条件

• signal-cli 已安装并完成链接/注册。
• 安全起见：发送前，请与用户确认收件人及最终消息内容。

快速使用模式

查看可用账户

signal-cli listAccounts

列出联系人 (JSON 格式)

signal-cli -o json -u "+386..." listContacts

通过姓名/昵称/号码查找联系人

推荐使用捆绑脚本（支持模糊匹配及处理多个匹配结果）：

python3 scripts/find_contact.py --account "+386..." --query "姓名"

发送消息

推荐使用捆绑脚本（可将联系人姓名解析为号码）：

python3 scripts/send_message.py --account "+386..." --to "姓名" --text "你好 ..."

如果 --to 参数已经是 E.164 格式的电话号码（例如 +386...），则直接发送。

安全清单 (始终遵守)

• 如果通过姓名解析得到多个匹配结果，请提供选项并询问用户选择哪一个。
• 如果消息包含敏感信息，请明确询问用户后再通过 Signal 发送。
• 默认使用 --service-environment live（signal-cli 默认值）及正常的信任行为。