pi-qq-integration
通过QQ远程控制树莓派硬件设备
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-qq-integration。 它的用途是：通过QQ远程控制树莓派硬件设备 完整的 Skill 内容见：https://321skill.com/skills/pi-qq-integration/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在树莓派上安装并配置pi-qq-integration，实现用QQ开关LED灯。’，它会指导你安装npm包、配置QQ机器人连接，并提供一个将消息‘/light on’映射到执行Python脚本点亮LED的示例代码。或者
对AI说：‘我的QQ指令没有反应，如何排查？’，它会帮你检查树莓派服务状态、QQ机器人连接以及指令映射配置是否正确。
介绍
pi-qq-integration 解决了开发者无法随时随地通过常用社交工具便捷控制树莓派硬件的问题。它通过在树莓派上运行一个服务，将QQ消息作为指令来源，实现对树莓派GPIO引脚、系统命令或自定义脚本的远程调用，让用户无需SSH登录或编写复杂的网络服务即可完成控制。
该技能的使用方式简单直接：在树莓派上安装此npm包并配置好QQ机器人（如使用go-cqhttp等框架），将特定的QQ消息格式（如“/led on”）映射到对应的树莓派操作指令上。当授权QQ账号发送指令时，服务端会解析并执行相应操作，并将结果反馈回QQ。
它非常适合物联网开发者、硬件爱好者、高校学生以及任何希望通过低成本、高普及率的社交软件来快速搭建硬件原型或实现简单自动化控制场景的用户。对于不熟悉复杂网络编程但想实现远程硬件交互的初学者尤为友好。
使用建议包括：确保QQ机器人账号稳定在线，注意指令解析的安全性以避免误操作，并在内网穿透或公网环境下使用时做好访问权限控制。由于依赖第三方QQ客户端，需关注其服务稳定性与合规性。
核心特点
与同类需要通过独立APP或Web界面控制树莓派的技能不同，它直接复用用户最熟悉的QQ作为控制终端，极大降低了用户的使用门槛和开发成本，实现了“社交即控制”的轻量化集成。
注意事项
不适合对控制实时性、安全性要求极高的工业级应用场景，且功能深度受限于所集成的QQ机器人框架的能力。
常见问题
需要自己部署QQ机器人吗？
是的，需要自行搭建并配置一个QQ机器人服务端（如go-cqhttp）来接收和转发消息。
能控制树莓派上的所有功能吗？
理论上可以，但需要您根据该技能提供的接口，自行编写或配置将QQ指令映射到具体树莓派操作（如Python脚本、Shell命令）的逻辑。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-qq-integration/raw/index.md 读取 pi-qq-integration 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-qq-integration/raw/index.md（查看排版版本）