$ cat ~/map/pi-discord.md

pi-discord

Discord 只读集成：读取服务器、频道与消息，发送前需人工确认。

extensions✓ 10月16日

## 速览

pi 的 Discord 只读集成——经 bot REST API 通信，无网关、无守护进程——提供列出服务器、频道、消息与成员的工具，外加发送前需确认的可选发送。

## 要点

• $默认只读（外加可选发送），走 Discord bot REST API——不连 gateway，也没有守护进程。
• $工具：discord_get_guilds（列出服务器）、discord_get_channels（列出频道）、discord_get_messages（读最近 1–100 条消息，默认 25）、discord_get_members（列出 1–1000 名成员，默认 100），以及发送前弹确认的 discord_send_message。
• $配置：在 Discord 开发者门户创建 bot、开启 Message Content Intent、按 View Channels、Read Message History、Send Messages 权限邀请入服，然后在 pi 里运行 /discord-setup 粘贴 token——配置保存到 ~/.pi/agent/extensions/pi-discord.json。也可以改设 DISCORD_BOT_TOKEN 环境变量。
• $命令：/discord 显示连接状态，/discord-setup 交互式配置 bot token。
• $安装方式是把包路径加入 ~/.pi/agent/settings.json 的 packages 数组，然后在 pi 里执行 /reload。

## 常见问题

## 参考链接

• README（配置、工具、命令） ↗

最后更新: 2026年8月31日