在開發或調試 DeepSeek Harness 等智能體工具時,Discord 的狀態通常僅顯示爲“在線”或一張靜態圖片,無法反映當前正在進行的具體工作。agent-discord-presence 通過一個本地服務解決這個問題,將你當前活躍的 Agent 工作流同步到 Discord 的 Rich Presence,讓狀態可視化。
這是什麼¶
agent-discord-presence 是一個本地服務工具,由開發者 LitoMore 維護。它支持 Codex、Claude Code、OpenCode、Pi 和 DeepSeek Harness 等多個 Agent 平臺。通過這個插件,你的 Discord 客戶端會實時更新爲當前正在進行的任務摘要、模型信息以及會話時長。
核心功能¶
- 狀態摘要生成:自動生成摘要標題、副標題、活動狀態和已用會話時間。
- 會話管理:在多個支持的 Agent 之間選擇活躍會話,自動斷開 Discord 連接並清除過期會話。
- 自定義配置:默認使用當前 Agent 的模型進行摘要,支持自定義模型、服務、語言和提示詞樣式。
- 元數據包含:將助手回覆的最多 4,000 字符發送給摘要模型,並包含模型使用元數據。
- 靈活控制:允許關閉自動摘要,同時保留生命週期更新(如會話切換)。
- 多代理支持:可以同時運行多個 Agent,併爲每個 Agent 配置獨立的模型、提示詞和顯示設置。
安裝與啓用¶
在安裝前,請確保已安裝 Node.js 22+ 版本,並且本地已安裝並登錄了 Discord 桌面應用。
運行以下全局安裝命令:
npm install --global agent-discord-presence
安裝完成後,使用 adp start -b 命令在後臺啓動服務。首次啓動時,項目包含默認的 Discord Application ID,無需配置 Bot Token。
典型用法¶
服務啓動後,你可以通過以下命令進行管理:
# 檢查服務狀態和 Discord 連接
adp status
# 停止服務(會清除 Discord 活動狀態)
adp stop
# 後臺運行服務
adp start -b
# 前臺運行服務(用於調試)
adp start
適用場景與注意¶
適用場景:適合需要在 Discord 狀態欄展示當前工作狀態的開發者,或者希望向團隊展示當前正在處理任務的開發者。
注意事項:
1. 早期開發:該項目處於早期開發階段,代碼變更可能比較頻繁。
2. 權限與自啓:該插件以當前 DSH 進程的權限運行。安裝前建議檢查源碼與許可證(MIT)。默認配置不包含開機自啓,重啓電腦後需再次運行 adp start -b 以啓動服務。
agent-discord-presence 是 DeepSeek Harness 生態中“一切皆插件”理念的體現,通過極簡的配置即可增強工具的可見性。