• Qiqi 機器人

    • Qiqi 機器人

    需要新手指南嗎？請點這裡

    其他語言的文件：

    簡介

    Qiqi Bot 是以 Discord.py 開發的 Discord 機器人，提供各式各樣的功能，讓你在 Discord 上玩得更開心、用得更方便。

    關於 Qiqi

    「Qiqi」這個名字來自遊戲《原神》。遊戲中的 Qiqi 有著獨特的經歷，是個可愛又有趣的角色。因此，開發者製作這個機器人時，便選了她的名字。

    目前 Qiqi Bot 尚未開放原始碼，但完全免費使用，不需要支付任何額外費用。

    支援語言

    Qiqi 支援多種語言！預設會依照你的 Discord 用戶端語言顯示訊息。語言設定以個別使用者為準，因此同一個伺服器裡的成員也能收到不同語言的回覆。你也可以透過 settings 指令手動更改語言。目前支援：

    如何邀請 Qiqi 加入我的伺服器？

    你可以在 Top.gg 或 discordbotlist 搜尋「Qiqi」並邀請她，也可以將下方連結複製到瀏覽器，邀請 Qiqi 加入你的伺服器：

        邀請 Qiqi

        Qiqi 支援伺服器

    指令

    這個部分列出 Qiqi Bot 的所有指令，共分成五大類：

    為了方便示範，這份文件的所有指令範例都使用「/」作為前綴。

        前綴 / 代表斜線指令，隨時都能使用。你也可以使用伺服器自訂的指令前綴，預設為 q!。

    使用 /help，就能依分類查看所有指令。

    使用 /help <command> 查看指定指令的說明。

    原神指令

    Qiqi Bot 的原神功能主要用來計算角色與武器的培養需求，也能查詢角色、武器及相關素材的資訊。

    Warning

    Qiqi 的原神資料庫目前已過時。開發者正在處理，但需要完成的工作相當多。

    查看原神相關指令的詳細文件

     

    音樂指令

    Qiqi 很喜歡放音樂給你聽！她能透過網址或關鍵字，播放 Soundcloud、Bilibili、網易雲音樂及企鵝音樂的內容。播放音樂時，建議給予 Qiqi manage_messages 權限。使用關鍵字搜尋後，Qiqi 還會提供 5 個結果供你挑選，很方便吧？

        不只如此，Qiqi 還能從 mystb.in 載入自訂播放清單。你可以把 Soundcloud、Bilibili、網易雲和企鵝音樂的曲目放在同一份清單裡！（詳見自訂音樂播放清單）

        Qiqi 也支援 Discord 上的跨伺服器個人音樂收藏！將喜歡的歌曲加入自己的收藏，就能直接播放。（詳見個人音樂收藏）

    自訂音樂播放清單

        只要 5 個步驟，就能建立自己的播放清單！

    1. 前往 mystb.in，開始製作播放清單。

    2. 貼上歌曲網址，每行一個。可以在網址後加上一個簡短名稱，最多 32 個字元（非常建議！）。網址與名稱之間需要一個空格。 每行除了網址和名稱外，不應包含其他內容。支援 Soundcloud、網易雲、Bilibili、企鵝音樂，也可以把四個平台的歌曲混在同一份清單裡！

      單行範例（建議）：https://soundcloud.com/user-235352228/let-the-wind-blow-to-you let the wind blow to you

      單行範例（可用，但不建議）：https://soundcloud.com/user-235352228/let-the-wind-blow-to-you

      注意：網址和簡短名稱之間必須有一個空格。 不可以使用其他符號分隔，例如 :,#!.-+^/;。

    3. 完成後，點選「Save Paste」按鈕，網址就會自動複製到剪貼簿。

    4. 查看瀏覽器的網址列。快速儲存後，mystb.in 會提供這份播放清單的永久連結。

    5. 使用 /playcp 播放這份清單，或透過 /savecp 讓 Qiqi 幫你儲存。

    （仍不確定怎麼建立播放清單的話，可以查看常見問題第 9 題，或到 Qiqi 的 Discord 支援伺服器詢問。）

        重要事項

    個人音樂收藏

        Qiqi Bot 可以記住你喜歡的曲目，讓你跨伺服器播放。每個人最多可收藏 300 首歌，也能匯出到 mystb.in，轉成自訂播放清單。

        使用斜線前綴 / 時，音樂收藏相關指令的對話只有你看得見，唯獨 playfavorite 播放指令例外。

    娛樂指令

    除了被禁言的使用者，伺服器裡的所有人都能使用娛樂指令，不需要特別的權限。之後還會加入更多好玩的功能，有點子也歡迎找開發者一起討論。玩得開心！

    管理指令

    管理指令讓伺服器管理更方便，不同指令會需要不同的權限。如果使用者擁有管理員權限，就不必另外取得下方列出的各項權限，也能使用這些指令。

    實用指令

        實用指令提供與機器人本身相關的功能，例如查看 Qiqi 的狀態與資訊、邀請 Qiqi 加入其他伺服器等。

    常見問題

    別名

    政策聲明

    服務條款

    版本紀錄

    Note

    版本紀錄會列出 Qiqi Bot 的所有版本，但不包含 Beta 0.3.0.0 之前的小型更新與錯誤修正。

    補充：這裡不會列出開發階段的所有版本，只記錄穩定發行版。

    版本編號更新日期（MM/DD/YYYY）詳細更新資訊
    2.0.0.010/18/2026點擊查看詳細信息
    1.7.1.204/15/2025修復擷取 Bilibili 收藏夾時，第一首歌曲會重複加入佇列兩次的問題
    1.7.1.103/23/2025將幸運排行榜賽季更新為 S5
    1.7.1.003/17/2025支援使用正整數或範圍（以逗號分隔）播放或刪除多首收藏歌曲 | 支援播放 Bilibili 使用者的影片收藏夾 | 改善擷取效能並修復多項擷取錯誤
    1.7.0.102/17/2025修復部分網易雲播放清單無法正常播放的問題
    1.7.0.002/04/2025重寫音樂內部邏輯以改善效能，新增 Soundcloud 音樂支援 | 新增企鵝音樂來源 | 新增 pengu、pengualbum、penguplaylist 音樂指令
    1.6.3.003/30/2024重設 fortune-ranking，開始第 1 賽季
    1.6.2.603/14/2024修復自訂使用者語言無法儲存的問題 | 修復 fortune-ranking 中「首次獲得時間」互動沒有回應的問題
    1.6.2.303/13/2024為 fortune-ranking 新增不同的排行方式（包含個人最佳紀錄），並修復小問題
    1.6.2.002/29/2024新增 skip later 功能
    1.6.1.002/07/2024改善 fortune 指令機制
    1.6.0.512/24/2023調整網易雲音樂網址的檢查方式，讓 #/ 與 /home 成為選用部分
    1.6.0.212/05/2023修正 zh-CN（簡體中文）翻譯檔案中的數個錯字
    1.6.0.111/24/2023將播放佇列紀錄的保留時間由錯誤的 30 秒修正為 2 小時 | 修正 setlang 指令的錯誤訊息 | 修復小問題與錯字
    1.6.0.011/19/2023重寫音樂內部邏輯，尤其是播放佇列機制，大幅改善效能 | 新增多語言翻譯及 setlang，讓使用者手動設定語言 | 新增 blacklist、nekogirl 指令 | 重構 roll，移除 bmi、calcgpa、gpascale | playhistory 支援播放指定範圍的歌曲 | 修復錯誤與錯字
    1.5.4.209/30/2023修復與前綴和音樂相關的 RuntimeError
    1.5.4.108/15/2023修復多個音樂來源的 403 錯誤
    1.5.4.007/31/2023更新原神資料庫，支援遊戲 3.8 下半版本（珊瑚宮心海 | 流浪者）| 修復 Bilibili 頻繁出現 403 Forbidden 的問題 | 新增開發者工具
    1.5.3.007/08/2023新增角色服裝，會以小機率選中顯示 | 更新原神資料庫，支援遊戲 3.8 上半版本（優菈 | 可莉）| 新增開發者工具
    1.5.2.206/22/2023修復 clear 與 bilibili <keyword> 的多項問題 | 加快 bilibili 的關鍵字搜尋速度
    1.5.2.006/21/2023新增 weapon 指令，查詢武器基本資訊 | 更新原神資料庫，支援遊戲 3.7 下半版本（艾爾海森 | 楓原萬葉）| 新增開發者工具 | 修正錯字與錯誤
    1.5.1.005/23/2023更新原神資料庫，支援遊戲 3.7 上半版本（宵宮 | 八重神子）| 修復多項錯誤
    1.5.0.805/22/2023改善 Qiqi 的效能 | 暫時移除 volume 指令
    1.5.0.605/20/2023修復多項錯誤 | 改善 Qiqi 的效能 | 新增開發者工具
    1.5.0.005/18/2023新增 Spotify 音樂來源，支援單曲、播放清單、專輯及藝人相關指令：spotify、spotifyplaylist、spotifyalbum、spotifyartist | 新增 volume，調整所有音樂的音量 | 更新原神資料庫，支援遊戲 3.6 下半版本（白朮 | 甘雨）| 新增開發者工具以監控 Qiqi | 最佳化程式碼，提升效能 | 修復錯誤與錯字
    1.4.10.204/29/2023為 exportfavorite 新增顯示排序選項 | 更新 help 指令
    1.4.10.104/26/2023為 playfavorite、addfavorite 及 deletefavorite 新增顯示排序選項
    1.4.10.004/16/2023為 viewfavorite 新增時間排序選項 | 改善 export 輸出，將播放佇列和播放紀錄分成兩份清單 | 改善 export 與 exportfavorite，匯出時包含網址及名稱 | 大幅提升自訂前綴指令的效能 | 改善機器人統計資料的收集 | 改善部分指令說明並修正錯字 | 更新原神資料庫，支援遊戲 3.6 上半版本（納西妲 | 妮露）
    1.4.9.103/02/2023在播放佇列中新增自訂播放清單曲目的序號資訊
    1.4.9.003/02/2023更新自訂播放清單邏輯，將上限提高至 100 首，並允許為每個網址加入簡短名稱（建議）| 更新原神資料庫，支援遊戲 3.5 上半版本（迪希雅 | 賽諾）| 改善 reset 功能 | 修復多項錯誤
    1.4.8.002/13/2023更新原神資料庫，支援遊戲 3.4 下半版本（胡桃 | 夜蘭）| 更新開發者工具
    1.4.7.001/31/2023調整機器人邏輯，忽略「manage_messages」權限 | 處理 Discord 劇透訊息的字元跳脫 | 更新 on_voice_state_update 邏輯並移除提示訊息 | 更新原神資料庫，支援遊戲 3.4 上半版本（艾爾海森 | 魈）| 修復小問題
    1.4.6.012/29/2022更新原神資料庫，支援遊戲 3.3 下半版本（雷電將軍 | 神里綾人）| 修正錯字，並在原神資料庫加入詞彙資料
    1.4.5.412/22/2022修復「mynetease」、「viewfavorite」及「help」指令的多項問題
    1.4.5.012/21/2022將音樂收藏上限由 30 首增加至 100 首 | 調整音樂收藏的載入邏輯 | 縮短 playfavorite 的冷卻時間 | 修復 voteskip、favorite、auditlog 等功能的錯誤，並移除阻塞處理 | 更新 Genshin_DB 的武器資料 | 改善資料庫安全性
    1.4.4.012/12/2022為 queue／history 指令新增「跳轉到指定頁面？」按鈕
    1.4.3.012/08/2022更新原神資料庫，支援遊戲 3.3 上半版本（流浪者 | 荒瀧一斗）
    1.4.2.011/19/2022更新原神資料庫，支援遊戲 3.2 下半版本（八重神子 | 達達利亞）| 修復自訂前綴錯誤 | 修復原神資料庫的錯字與錯誤 | 更新後台服務
    1.4.1.011/09/2022新增用關鍵字搜尋歌曲在佇列中位置的功能 | 為 sleep 新增取消功能 | 恢復 top.gg 自動發布 | 修復錯誤 | 改善使用體驗
    1.4.0.011/03/2022新增網易雲音樂來源，支援歌曲、播放清單與使用者相關指令：netease、neteaseplaylist、neteaseuser、mynetease、playmynetease、newsongs | 新增 Bilibili 影片關鍵字搜尋 | 新增 sleep 睡眠計時器 | 更新原神資料庫，支援遊戲 3.2 上半版本（納西妲 | 宵宮）| 修復錯誤 | 改善使用體驗
    1.3.10.010/15/2022更新原神資料庫，支援遊戲 3.1 下半版本（妮露 | 阿貝多）| 修正原神武器計算的翻譯方向顛倒問題
    1.3.9.110/11/2022修復直播音樂的連線保持錯誤及重用失效連線的問題
    1.3.9.010/10/2022新增在 top.gg 發布伺服器數量的功能 | 修復音樂指令錯誤 | 修正錯字 | 新增別名
    1.3.8.009/28/2022更新原神資料庫，支援遊戲 3.1 上半版本（賽諾 | 溫迪）
    1.3.7.109/15/2022還原 talent-calc 的例外處理程式
    1.3.7.009/09/2022更新原神資料庫，支援遊戲 3.0 下半版本（甘雨 | 珊瑚宮心海）| 更新武器計算圖片 | 修正錯字
    1.3.6.008/31/2022更新 savecp 指令功能
    1.3.5.008/29/2022更新以下指令功能：export | playcp | exportfavorite
    1.3.2.008/28/2022更新原神資料庫，支援遊戲 3.0 上半版本（提納里 | 鍾離）| 改善資料庫中旅行者的回覆結果 | 修正錯字
    1.3.1.108/13/2022暫時更新 mystb.in 的 Python API 封裝程式（舊版）
    1.3.1.008/03/2022更新原神資料庫，支援遊戲 2.8 下半版本（宵宮）| 更新 GenshinDB 模糊比對詞彙
    1.3.0.007/29/2022新增個人音樂收藏，支援跨伺服器管理及播放收藏歌曲 | 新增 restart、seek、forward、rewind 音樂指令 | 改善 voteskip 的投票通過邏輯 | 修復錯誤 | 改善使用體驗
    1.2.3.107/18/2022修復新加入伺服器的 stop 指令錯誤
    1.2.3.007/13/2022更新原神資料庫，支援遊戲 2.8 上半版本（楓原萬葉 | 可莉）
    1.2.2.007/09/2022新增音樂管理指令 reset | 修復先前由使用者手動斷線後，再次加入頻道失敗的 ClientException | 修正機器人自行斷線時的語音狀態更新訊息
    1.2.1.507/01/2022偵測到 403 錯誤時，改善重新取得過期音樂網址的處理
    1.2.1.406/26/2022修復使用斜線方式呼叫 playcp 時，只載入自訂清單第一首歌的問題
    1.2.1.306/25/2022修復 repeat single 對新增歌曲的處理 | 改善 play 在行動裝置上的使用體驗（應用程式沒有回應）| 改善 Qiqi Bot 的服務
    1.2.1.006/24/2022更新原神資料庫至遊戲 2.7 下半版本（荒瀧一斗）| 改善使用體驗
    1.2.0.006/15/2022所有既有指令支援斜線方式（混合指令）| 將反應式介面改為按鈕 | 自訂說明頁面 | 新增娛樂指令、修復錯誤並改善使用體驗
    1.1.3.106/02/2022新增 Discord 日誌，用來監控機器人的效能及錯誤 | 修復自訂播放清單問題
    1.1.2.005/31/2022更新原神資料庫至遊戲 2.7 上半版本（夜蘭）
    1.1.1.004/20/2022更新原神資料庫至遊戲 2.6 下半版本（神里綾華）
    1.1.0.004/10/2022支援 mystb.in 自訂播放清單，新增相關指令（playcp、savecp、viewcp、deletecp）| 新增 gif 娛樂指令（pat、hug、cry、cuddle）| 修復發現的嚴重錯誤，改善使用體驗
    1.0.0.004/02/2022採用專業資料庫儲存資料 | 新增音樂指令 nowplaying、repeat all、history、playhistory、voteskip、export | 新增娛樂指令 weather、qiqi、time、wolfram、translate | 改善使用體驗
    0.6.11.004/01/2022更新原神資料庫至遊戲 2.6 上半版本（神里綾人 | 溫迪）
    0.6.8.003/08/2022新增 roll、rollrepeat 指令 | 更新原神資料庫至遊戲 2.5 下半版本（雷電將軍）
    0.6.5.102/21/2022更新原神資料庫至遊戲 2.5 上半版本（八重神子）
    0.6.4.1201/26/2022改善 mute、unmute、tempmute 指令的使用體驗 | 修復小問題（禁言指令不再需要管理員權限也能運作）
    0.6.4.901/25/2022新增管理指令 deafen、undeafen、audit | 更新原神資料庫至遊戲 2.4 下半版本（鍾離 | 甘雨）| 修復小問題 | 改善使用體驗
    0.6.0.001/24/2022新增原神指令：char（查看角色基本資訊）、talents（查看角色所有天賦）、cons（查看角色所有命之座）| 新增管理指令：mute（同時限制文字及語音發言）、unmute、tempmute（依指定時間暫時禁言）
    0.5.4.301/06/2022更新原神資料庫至遊戲 2.4 上半版本（申鶴）| 新增 fortune 及 userinfo 指令 | 修復小問題與資料庫缺漏
    0.5.1.012/19/2021邁向 1.0.0.0，遷移至新的雲端服務 | 新增 userinfo 功能
    0.4.1.412/18/2021更新 site-packages 資訊 | 新增 repeat 功能的回覆訊息 | 修復 jump 回覆訊息的計數錯誤
    0.4.1.112/18/2021更新原神資料庫至遊戲 2.3 下半版本（荒瀧一斗）| 修復錯誤處理中的 @ 問題
    0.4.0.012/17/2021新增音樂指令 repeat（僅限單曲）、policy、credits | 改善使用體驗，降低濫用指令的可能性 | 修復小問題
    0.3.3.212/16/2021修正機器人回覆中的錯字
    0.3.3.112/16/2021新增開發者功能
    0.3.3.012/16/2021新增 Bilibili 音樂播放支援
    0.3.2.712/15/2021找不到指令前綴時，改用預設前綴
    0.3.2.512/15/2021找不到指令時，不再回覆錯誤訊息
    0.3.2.412/13/2021新增音樂指令 jump 及 shuffle
    0.3.0.112/12/2021修正逾時時的錯誤回覆訊息
    0.3.0.012/11/2021發布原神／音樂功能
    0.2.0.011/20/2021原神功能完成。尚未發布
    0.1.6.009/27/2021Cog 重構完成。尚未發布
    0.1.0.005/13/2021最初的整合版本。尚未發布

    特別致謝

    Qiqi 永遠不會忘記曾經幫助過她的人。

    聯絡方式