@aalzubidy/pi-signal

将 pi 与 Signal 双向消息集成

开发流程 调试Pi扩展程序兼容运行环境管理Pi扩展 通用 ★ 8 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 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_ACCOUNTPI_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 格式),按其中说明在我的环境里完成安装和配置。