@aalzubidy/pi-signal
将 pi 与 Signal 双向消息集成
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@aalzubidy/pi-signal。 它的用途是:将 pi 与 Signal 双向消息集成 完整的 Skill 内容见:https://321skill.com/skills/aalzubidy-pi-signal/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请帮我安装 @aalzubidy/pi-signal 扩展,并运行 /signal-setup 命令完成配置。之后我通过 Signal 的 Note-to-Self 发送消息,pi 会自动接收并回复。' 它会执行安装和配置流程,并提示你运行 setup.sh 脚本完成设备链接。
介绍
这个 Skill 解决了在 pi 平台上无法直接通过 Signal Messenger 与 AI 代理通信的问题。在实际开发中,开发者经常需要一种便捷的手机端输入方式,让 LLM 处理消息并自动回复,而 Signal 的 Note-to-Self 功能正好提供了安全、私密的通道。
使用方式很简单,你只需要在 pi 中安装该包,然后运行 /signal-setup 命令获取 setup.sh 脚本路径,在终端中执行该脚本完成设备链接和 systemd 服务配置。之后设置环境变量 PI_SIGNAL_ACCOUNT 和 PI_SIGNAL_PRIMARY,重启 pi 即可。发送 Note-to-Self 消息给 pi,它会自动接收(👀)、处理并回复(✅)。
它非常适合需要将手机作为 AI 代理输入终端的智能体开发者,尤其是那些已经使用 pi 平台并希望扩展消息渠道的团队或个人。也适合需要快速测试 LLM 响应的场景,无需打开电脑即可通过手机发送指令。
建议在配置时确保 signal-cli 已正确安装且 Java 版本 ≥ 25。需要注意的是,它只处理 Note-to-Self 消息,其他发件人的消息会被忽略以保证安全。如果遇到连接问题,可以检查 PI_SIGNAL_DAEMON_URL 环境变量是否指向正确的 daemon 地址。
常见问题
如何安装 signal-cli?
请参考 https://github.com/AsamK/signal-cli/ 官方文档,确保将其添加到 PATH 中。
如何获取 Signal 账号?
在手机上安装 Signal 应用并注册账号,然后通过 setup.sh 脚本中的二维码扫描完成设备链接。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aalzubidy-pi-signal/raw/index.md 读取 @aalzubidy/pi-signal 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aalzubidy-pi-signal/raw/index.md(查看排版版本)