---
# System prepended metadata

title: Discord bot - shiro9ae

---

# Discord bot - shiro9ae
## 程式檔案架構
* `.env`: 各項指令help及API所需資料保存 
* `guess.py`: 猜數字遊戲
    * `rankings.json`: 紀錄排行
* `todo.py`: TODOlist
    * `todo.json`: 紀錄TODOlist
* `anime.py`: 動畫瘋週期表&隨機動畫
* `osu.py`: Osu!圖譜評論
    * `OsuComments.json`: 紀錄圖譜評論和資訊

## 指令及功能介紹
### `todo.py`
#### 功能: 超簡易代辦清單
#### 使用方法(_todo):
* 新增事項: `add <date> <events>`，`<date>`表示日期(yyyymmdd)，`<events>`表示要做的事項
* 列出所有事項: `list`，依照時間列出所有事項及id和排此事項的人
* 刪除事項: `delete <id>`，`<id>`表示列出時排第幾個
* 清空所有事項:`clear`，清空目前列表中所有事項
#### 實際使用
##### `add`
![](https://i.imgur.com/8Nr1mcO.png)
##### `list`
![](https://i.imgur.com/kE5NLON.png)
##### `delete`
![](https://i.imgur.com/y8Pxk6E.png)
##### `clear`
![](https://i.imgur.com/FIy18vd.png)

### `guess.py`
#### 功能: 簡單的幾A幾B猜數字遊戲
#### 使用方法(_guess):
* 開始遊戲: `start`，產生4位1~9且不重複的數字並開始遊戲
* 猜數字: `<4digits number>`，`<4digits number>`表示要猜的4位數字，只能由開始的玩家猜，猜對即結束
* 結束遊戲: `end`，結束這次遊戲，可在中途結束(可能會被嘲笑)
* 伺服器排行: `leaderboard`，列出伺服器猜到次數最少的前十名
#### 實際使用
##### `start`
![](https://i.imgur.com/m1UaLG2.png)
##### `<4digits number>`
![](https://i.imgur.com/blHNLP8.png)
##### `end`
![](https://i.imgur.com/cVy3EHP.png)
##### `leaderboard`
![](https://i.imgur.com/BURFd9r.png)

### `anime.py`
#### 功能: 查看動畫瘋週期表和隨機動畫推薦
#### 使用方法(_anime):
* 列出本週動畫瘋週期表:`week`，列出週期表的動畫播出時間和集數
* 列出今日動畫瘋週期表:`today`，列出今日動畫的播出時間和集數 
* 推薦隨機動畫瘋動畫:`random`，隨機推薦動畫瘋上有的動畫
#### 實際使用
##### `week`
![](https://i.imgur.com/CV09aRS.png)
##### `today`
![](https://i.imgur.com/V42yh8G.png)
##### `random`
![](https://i.imgur.com/gkmXW5w.png)

### `osu.py`
#### 功能: 對指定Osu圖譜評論
#### 使用方法(_osu):
* 評論指定圖譜:`comment <map_id> <content>`，`<map_id>`表示要評論圖譜的id，`<content>`表示要評論的內容，評論指定圖譜
* 搜尋伺服器中對指定圖譜的評論:`search <map_id>`，`<map_id>`表示要評論圖譜的id，顯示所有此伺服器對指定圖譜的評論
* 列出所有被留言過的評論:`list`，列出每張被評論圖譜的評論數和圖譜資訊
#### 實際使用
##### `comment`
![](https://i.imgur.com/Ou9P6p7.png)
##### `search`
![](https://i.imgur.com/BB1z6s6.png)
##### `list`
![](https://i.imgur.com/lLkKAtI.png)
