為什麼是 discli?

discli 並非每個 Discord 專案都適合。這一頁幫你快速判斷:你的使用情境是否需要它,或是否有更合適的替代方案。

決策指引

選擇與你的目標最接近的敘述:

我想在 Discord 上使用 AI 代理

選 discli。 這正是 discli 的設計目標。discli serve 的雙向 JSONL 協定原生對應 LLM 工具呼叫:代理讀取 stdout 事件、寫入 stdin 動作,discli 會處理 Discord API 通訊、驗證、速率限制與安全控管。

Terminal window
discli serve --events messages --profile safe-agent

支援 OpenAI、Claude、Llama、Mistral 以及任何可讀寫 JSON 的模型。

我想在 CI/Bash 做 Discord 腳本

選 discli。 每個指令都可用 --json 輸出結構化結果,能直接 pipejq、傳給其他工具,或在 CI pipeline 解析。

Terminal window
# 發送部署通知
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 預設提供。

Terminal window
# 建立限制較嚴的設定檔
discli permission create safe-agent \
--allow message_send,message_list \
--deny channel_delete,member_ban
# 使用該設定檔啟動 serve
discli serve --profile safe-agent

語言無關

discli 不綁定代理語言。Python、Node.js、Go、Rust、Ruby、Bash,只要能啟動程序並讀寫文字行,都可接軌。你不需要 SDK,只要 stdin 與 stdout。

低樣板負擔

沒有 client class、沒有 intent 物件、沒有 async 事件迴圈建置,也不需 decorator 註冊。只要一個安裝指令、一個設定指令,就能開始傳送訊息。

Terminal window
pip install discord-cli-agent
discli config set token YOUR_TOKEN
discli message send "#general" "Hello, world."

快速參考

使用情境最適工具次佳工具
Discord 的 AI 代理discli自行開發 discord.py bot
Bash/CI 腳本disclicurl + Discord webhook
免程式仲裁MEE6 / DynoCarl-bot
Python 全面 API 控制discord.py簡化用途可用 discli
JS 全面 API 控制discord.js簡化用途可用 discli
大量訊息匯出discrawldiscli
語音/音訊discord.pydiscord.js
按鈕、embeds、modalsdiscord.py / discord.jsdiscli(目前以文字為主)
隱私優先機器人discli(自行託管)自行託管的 discord.py bot