Signal CLI

signal-cli 技能评估

核心用法

该技能封装了开源工具 signal-cli 的命令行接口，允许用户通过本地安装的 signal-cli 实例执行 Signal 消息操作。主要功能包括：

• 账户管理：列出已注册的 Signal 账户
• 联系人查询：以 JSON 格式导出联系人列表，支持通过 Python 脚本进行模糊名称/昵称/号码匹配
• 消息发送：通过封装脚本将联系人名称解析为电话号码后发送文本消息，支持直接指定 E.164 格式号码

显著优点

1. 隐私优先：基于 Signal 的端到端加密协议，不依赖第三方服务器中转
2. 本地执行：完全在本地运行，无需云端 API 密钥
3. 模糊匹配：内置 Python 脚本简化了联系人查找流程，提升用户体验
4. 开源可信：signal-cli 作为成熟开源项目，经过社区广泛审计

潜在缺点与局限性

• 依赖预设环境：要求用户已独立完成 signal-cli 的安装、注册和账户链接
• macOS 限定：当前配置仅支持 macOS 系统
• 无消息同步：仅支持发送，不提供完整的聊天历史同步
• 单账户操作：每次操作需指定账户号码，多账户管理较繁琐

适合人群

• 已在使用 signal-cli 的高级用户
• 需要在自动化工作流中集成 Signal 通知的开发者
• 重视隐私、不愿使用云端消息 API 的技术用户

常规风险

1. 消息误发：名称解析可能匹配多个联系人，技能内置了确认机制
2. 敏感信息泄露：发送前需显式确认含敏感内容的消息
3. 号码格式错误：非 E.164 格式号码可能导致发送失败
4. 本地安全风险：signal-cli 的数据存储于本地，需确保设备安全

核心用法

signal-cli Skill 是一个面向 macOS 用户的 Signal 消息管理工具，通过调用本地安装的 signal-cli 二进制文件实现功能。用户需先完成 signal-cli 的安装与账户注册，随后可通过该 Skill 执行三类核心操作：查询已注册账户、列出联系人信息（JSON 格式输出），以及发送文本消息或附件。Skill 内置模糊匹配脚本，支持通过姓名、昵称或电话号码查找联系人；发送消息时可使用联系人名称自动解析为 E.164 标准电话号码，若直接提供完整号码则跳过解析直接发送。

显著优点

隐私优先设计：所有通信通过本地 signal-cli 代理，无直接网络请求，消息内容不经过 Skill 代码处理，最大限度降低数据泄露风险。依赖纯净：仅使用 Python 标准库（argparse、json、re、subprocess、pathlib），零第三方依赖，供应链攻击面极小，部署安全可控。输入验证完善：实现了 E.164 电话号码格式验证（+\d{6,14}），联系人名称解析采用模糊匹配算法，有效防止注入攻击。用户体验友好：封装了复杂的 signal-cli 命令参数，提供简洁的脚本接口，降低终端用户操作门槛。

潜在缺点与局限性

环境依赖严格：必须预先在本地安装并注册 signal-cli，对非技术用户配置门槛较高。平台受限：当前仅支持 macOS 环境，Windows/Linux 用户无法直接使用。功能边界有限：仅覆盖基础消息收发与联系人查询，不支持 Signal 群组管理、消息历史同步、已读回执等高级功能。来源可追溯性弱：维护者 pseudobun 未关联可公开的 GitHub 仓库，长期维护与更新透明度存疑。

适合的目标群体

该 Skill 主要面向三类用户：已在 macOS 上使用 signal-cli 的隐私敏感型用户，希望简化命令行操作；需要通过自动化脚本批量发送 Signal 通知的开发者或运维人员；以及将 Signal 集成到本地工作流（如配合其他 CLI 工具）的效率工具爱好者。不适合追求图形界面体验、不愿配置本地开发环境，或依赖 Signal 完整功能集（如视频通话、故事发布）的普通消费者。

使用风险

signal-cli 状态依赖：Skill 功能完全依赖本地 signal-cli 的健康状态，若 signal-cli 未运行、账户掉线或版本不兼容，将导致操作失败。recipient 确认风险：虽然 Skill 要求人工确认 recipient 和消息内容，但在高度自动化场景中仍存在误发可能，建议额外建立白名单机制。路径假设风险：当前实现假设 signal-cli 位于系统 PATH 中，非标准安装位置需手动调整或等待后续参数支持更新。T3 来源更新不确定性：作为个人开发者项目，无明确版本发布节奏与长期维护承诺，生产环境使用需自行评估风险并关注 ClawHub 平台动态。