為什麼是 discli?
discli 並非每個 Discord 專案都適合。這一頁幫你快速判斷:你的使用情境是否需要它,或是否有更合適的替代方案。
決策指引
選擇與你的目標最接近的敘述:
我想在 Discord 上使用 AI 代理
選 discli。 這正是 discli 的設計目標。discli serve 的雙向 JSONL 協定原生對應 LLM 工具呼叫:代理讀取 stdout 事件、寫入 stdin 動作,discli 會處理 Discord API 通訊、驗證、速率限制與安全控管。
discli serve --events messages --profile safe-agent支援 OpenAI、Claude、Llama、Mistral 以及任何可讀寫 JSON 的模型。
我想在 CI/Bash 做 Discord 腳本
選 discli。 每個指令都可用 --json 輸出結構化結果,能直接 pipe 到 jq、傳給其他工具,或在 CI pipeline 解析。
# 發送部署通知discli message send "#deploys" "v2.3.1 deployed to production"
# 讀取最近錯誤後輸出到檔案discli --json message search "#errors" "critical" --limit 100 > errors.json我想要免寫程式的仲裁機器人
用 MEE6 或 Dyno。 這類工具有網頁儀表板,提供預建自動仲裁、等級與歡迎訊息;不需終端機操作。詳細差異可看 discli vs Hosted Bots。
我想在 Python 做完整 API 控制
若要做需要 embeds、按鈕、語音、modal 與精細事件處理的複雜機器人,用 discord.py。如果你只想用較簡單的 Python 腳本把 Discord 當作 I/O 通道,則可用 discli。可參考 discli vs Discord Libraries。
我想做高複雜度有狀態機器人
用 discord.py 或 discord.js。 對話狀態機、多步驟精靈、持久使用者 session、客製快取策略這類需求,完整函式庫較適合。discli 預設是無狀態,每個指令獨立執行。
我需要大量爬取/匯出訊息
大量只讀匯出 CSV/JSON/SQLite 輸出可用 discrawl。若你還要傳訊息、即時監聽事件,或將資料提供給 AI 代理,則改用 discli。比較可見 discli vs CLI Tools。
我需要語音/影片功能
用 discord.py 或 discord.js。 discli 不支援語音頻道、音訊播放與視訊。這是刻意限制,因為這類需求牽涉長時間二進位串流,不符合 CLI/JSONL 的通道模型。
discli 的獨特性
目前沒有其他工具同時具備以下組合:
雙模式運作
可直接做一次性命令(discli message send)的 CLI,也可用於長時間運作代理的 持續式伺服器(discli serve)。同一工具、同一套設定、同一個安全模型。
代理優先設計
JSONL 協定不是加上的次要功能。每個事件與每個動作都用單行 JSON 表述,不需解析 HTML、不需爬 DOM,也不需逆向 WebSocket frame。代理直接處理結構化資料並輸出結構化指令。
內建安全機制
權限設定檔會限制可執行行為,稽核紀錄會記錄每個操作,速率限制則可防止失控代理刷 API。這些不是選配,而是 discli 預設提供。
# 建立限制較嚴的設定檔discli permission create safe-agent \ --allow message_send,message_list \ --deny channel_delete,member_ban
# 使用該設定檔啟動 servediscli serve --profile safe-agent語言無關
discli 不綁定代理語言。Python、Node.js、Go、Rust、Ruby、Bash,只要能啟動程序並讀寫文字行,都可接軌。你不需要 SDK,只要 stdin 與 stdout。
低樣板負擔
沒有 client class、沒有 intent 物件、沒有 async 事件迴圈建置,也不需 decorator 註冊。只要一個安裝指令、一個設定指令,就能開始傳送訊息。
pip install discord-cli-agentdiscli config set token YOUR_TOKENdiscli message send "#general" "Hello, world."快速參考
| 使用情境 | 最適工具 | 次佳工具 |
|---|---|---|
| Discord 的 AI 代理 | discli | 自行開發 discord.py bot |
| Bash/CI 腳本 | discli | curl + Discord webhook |
| 免程式仲裁 | MEE6 / Dyno | Carl-bot |
| Python 全面 API 控制 | discord.py | 簡化用途可用 discli |
| JS 全面 API 控制 | discord.js | 簡化用途可用 discli |
| 大量訊息匯出 | discrawl | discli |
| 語音/音訊 | discord.py | discord.js |
| 按鈕、embeds、modals | discord.py / discord.js | discli(目前以文字為主) |
| 隱私優先機器人 | discli(自行託管) | 自行託管的 discord.py bot |