discord-guess-img-bot/README.md

# 🖼️ Discord 猜圖片機器人

一個用 Python 和 discord.py 開發的 Discord 猜圖片互動機器人！

## ✨ 功能特色

- 🖼️ 發送圖片讓人猜是什麼
- 🎯 投票互動系統
- 🎉 恭喜猜對者
- 🎲 隨機答案提示
- 📖 基礎功能指令：`!info`, `!help`, `!ping`, `!echo`
- ⚡ 支援 Slash Commands (`/info`, `/help`, `/ping`, `/echo`)

## 🚀 安裝與設定

### 1. 克隆專案
```bash
cd /home/tangsong/.openclaw/workspace/projects/discord-guess-img-bot
```

### 2. 安裝依賴
```bash
pip install -r requirements.txt
```

### 3. 設定 Discord Bot Token
1. 前往 [Discord Developer Portal](https://discord.com/developers/applications)
2. 創建一個新應用程式
3. 在 Bot 分頁創建機器人
4. 複製你的 **Token**
5. 建立 `.env` 檔案：
```bash
cp .env.example .env
```
6. 編輯 `.env` 檔案，填入你的 token：
```env
DISCORD_BOT_TOKEN=your_actual_token_here
```

### 4. 執行機器人
```bash
python discord-bot.py
```

## 📖 指令說明

### 基礎指令
- `!info` - 顯示機器人資訊
- `!help` - 顯示幫助訊息
- `!ping` - 測試機器人連線
- `!echo <訊息>` - 回覆你的訊息

### Slash Commands
- `/info` - 顯示機器人資訊
- `/help` - 顯示幫助訊息
- `/ping` - 測試機器人連線
- `/echo <訊息>` - 回覆你的訊息

## 🔧 專案結構

```
discord-guess-img-bot/
├── discord-bot.py      # 主程式
├── cogs/
│   └── base.py         # 基礎功能 Cog
├── .env.example        # 環境變數範例
├── requirements.txt    # Python 依賴
└── README.md          # 專案說明
```

## 🚧 待開發功能

- [ ] 猜圖片互動功能
- [ ] 投票系統
- [ ] 答案統計
- [ ] 資料庫支援
- [ ] 自訂機器人回應

## 🤝 貢獻

歡迎提交 Issue 和 Pull Request！

## 📄 授權

MIT License

---

**開發者：** 唐宋
**語言：** Python
**套件：** discord.py