@xingchen89/pi-discord

基于Discord Bot实现树莓派远程控制的Pi扩展

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@xingchen89/pi-discord。
它的用途是:基于Discord Bot实现树莓派远程控制的Pi扩展
完整的 Skill 内容见:https://321skill.com/skills/xingchen89-pi-discord/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“通过Discord查看我绑定的树莓派当前CPU占用率”,它会调用pi-discord能力,经Discord Bot桥接下发指令到树莓派,执行后返回查询结果。

对AI说:“帮我远程重启树莓派上运行的测试服务”,它会校验权限后下发对应终端指令,完成后反馈执行状态。

介绍

不少树莓派用户在异地时,难以便捷操控本地部署的树莓派设备。传统远程操控方案多需要公网IP、端口映射或复杂的内网穿透配置,操作门槛较高,网络适配性差,还缺少轻量化的即时消息交互通道,临时运维或调试设备时十分不便。 该工具基于discord.js搭建网关聊天桥,作为Pi的扩展组件安装完成后,只需将提前创建的Discord Bot与树莓派完成绑定,用户在Discord对应频道发送操作指令,即可通过桥接通道传递到树莓派端执行,实现远程命令下发、运行状态查询等各类操作。 它适合树莓派个人爱好者、小型物联网设备运维人员、需要远程调试嵌入式设备的开发者,以及日常习惯使用Discord作为通讯工具的技术类用户。 使用前需提前在Discord开发者平台创建Bot账号并获取对应权限令牌,配置过程中请妥善保管令牌避免泄露,建议给Bot设置严格的指令权限白名单,限制可执行的命令范围,防止未授权访问带来的设备安全风险。

核心特点

它区别于传统SSH、VNC等树莓派远程方案,无需公网IP或内网穿透配置,直接依托Discord生态搭建指令桥接通道,通过日常使用的Discord客户端即可完成远程交互,配置门槛极低。

注意事项

仅支持通过Discord平台进行操控,无法在未接入互联网或无法正常访问Discord服务的网络环境下使用。

常见问题

使用这个工具需要树莓派有公网IP吗?

不需要,只要树莓派能正常联网访问Discord服务即可使用。

可以通过它执行任意树莓派终端命令吗?

支持执行授权范围内的命令,建议配置白名单保障设备安全。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/xingchen89-pi-discord/raw/index.md 读取 @xingchen89/pi-discord 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。