前言¶
在 DeepSeek Harness（DSH）裏開多個聊天、等智能體跑任務時，Discord 側往往仍顯示「沒在幹什麼」。若你希望好友或自己一眼看到「正在哪個會話、是否在幹活、今天用了多少 Token」，通常要靠手動改狀態或另開面板，信息和真實工作狀態容易脫節。dsh-discord-rich 是社區維護的 DSH 客戶端插件，通過 Discord Rich Presence 把當前聊天標題、工作狀態、當日 Token 與本輪計時同步到 Discord 資料卡，全程本地 IPC，無需額外命令行操作。
這是什麼¶
dsh-discord-rich（GitHub：MakotoNikki/dsh-discord-rich）由 MakotoNikki 維護，分類爲客戶端插件。定位是：在 DSH Desktop 運行時，把「當前打開的聊天」「智能體 Working / Idle」「今日 Token 合計」「當前輪次歷時」推到 Discord Rich Presence。設置與卡片文案支持英文、俄文、中文（默認英文）。許可證爲 MIT；package.json 標註版本 0.3.1，依賴 Node >= 22.19.0，DSH >= 0.2.1-rc.1 且 < 0.3.0。
核心功能¶
下面介紹插件在資料中明確列出的能力。
會話與狀態跟隨¶
插件 Web 端掛在會話頭域，向宿主報告當前打開的聊天；切換標籤頁後，Discord 卡片會跟隨當前活動標籤，而不是最後一條消息所在的會話。智能體運行中顯示 Working（中文爲「工作中」），等待你輸入時顯示 Idle（「空閒」）。
Token 與計時¶
Total tok/d（及對應語言的「今日 Token」等文案）表示當天累計 Token，不是生涯總量。Token 優先來自 DSH 內置 token meter；不可用時從 session log 讀取。大圖上方的計時從本輪工作開始起算，用於觀察當前 turn 已持續多久。鼠標懸停大圖時，可在 tooltip 中顯示當前聊天的 Token（需在 Developer Portal 配置 Art Asset，見下文）。
零配置試用與自定義應用¶
默認已填入共享 Application ID，安裝並重啓 DSH Desktop 後即可使用，無需自建 Discord 應用。共享應用名稱顯示爲 DeepSeekHarness；若需自定義名稱、頭像或素材，可在 Discord Developer Portal 創建應用，將 Application ID 填入 Settings → Discord Rich Presence 並保存，必要時完全退出 Discord 再開以清緩存。
語言¶
設置頁提供 RU / EN / CN 切換，同時影響設置界面與 Discord 卡片；未選擇時默認 EN。配置會寫入插件 config。
隱私與架構（本地）¶
插件從 DSH 內置 session projection cache（或 native session log）讀 Token，經本地 IPC 與 Discord 通信；不讀取、存儲或發送 Discord 賬戶 token，不做網絡請求；向 Discord 發送的僅爲活動文案與可選大圖 key。宿主側負責拼 activity 並寫入 Discord IPC；無中間服務器。
安裝與啓用¶
先做插件包就緒，再在 DSH Desktop 裏安裝並驗證 Discord 連接。
- 取得插件目錄（含
dsh-discord-rich包內容，來源可爲社區目錄頁或 GitHub 倉庫發佈物）。 - 在 DSH Desktop 打開 Plugins，將
dsh-discord-rich文件夾以 bundle 形式安裝；若更傾向包安裝，在該文件夾內執行打包後安裝生成的.tgz：
npm pack
- 重啓 DSH Desktop。
-
保持 Discord 客戶端運行。支持本地 Rich Presence IPC 的客戶端均可（如 Stable、PTB、Canary、Vesktop、Equicord 等）。
-
打開 Settings → Discord Rich Presence。狀態點應變綠，預覽應顯示當前聊天。共享 Application ID 下無需自建應用即可試用。
典型用法與可選配置¶
默認使用¶
安裝並重啓後，保持 Discord 與 DSH 同時運行即可；無需複製命令或打開額外看板。
自定義 Application ID¶
- 在 Discord Developer Portal 創建應用。
- 從 General Information 複製 Application ID（公開 ID，不是 bot token）。
- 粘貼到 Settings → Discord Rich Presence，點 Save。
- 若仍顯示舊名稱，完全退出 Discord 後重新啓動。
懸停顯示當前聊天 Token¶
- Developer Portal 中打開 Rich Presence → Art Assets。
- 上傳倉庫中的
assets/icon-1024.png，key 設爲dsh。 - 在插件設置 Icon & tooltip 中將 asset key 設爲
dsh。 - 自定義 tooltip 留空，由插件按所選語言填入當前聊天 Token。
使用共享應用時 dsh 資源可能已存在；懸停無效果時，改用自建應用並上傳資源更可靠。
語言切換¶
在設置頁使用 RU / EN / CN 開關，保存後即作用於設置頁與 Discord 卡片。
適用場景與注意¶
適合誰： 常在 DSH 里長時間跑智能體、又習慣開着 Discord 的開發者；需要在資料卡上展示「真實在做的會話」和當日 Token，而不想手改狀態。
運行與信任： 插件隨當前 DSH 進程權限運行，會讀會話與 Token 統計並通過本地 IPC 寫 Discord Presence。安裝前請瀏覽 GitHub 倉庫 源碼與 MIT 許可證，自行判斷是否適用。
環境： 滿足 package.json 中的 Node 與 DSH 版本範圍；Discord 需在 Activity Privacy 中允許共享檢測到的活動，否則可能一直 Connecting。
排錯摘要：
| 現象 | 可嘗試 |
|---|---|
| Discord 無顯示 | 確認 Discord 已運行並重啓 DSH；設置裏狀態點是否爲綠 |
| 顯示 DeepSeekHarness | 共享應用默認名；需自定義則建自有 Application |
| 卡在 Connecting | 設置中 Reconnect；檢查 Activity Privacy |
| 懸停無 tooltip | 上傳 key dsh 的資產並在插件中填同一 key |
| 聊天標題不對 | 切換一次標籤或等待約 15 秒刷新 |
結尾¶
dsh-discord-rich 把 DSH 的當前聊天、工作狀態與 Token 指標接到 Discord Rich Presence，默認即可試用，並可按需換應用 ID、語言與大圖 tooltip。插件列表與說明見 SkillHub 目錄頁；源碼與完整排錯表見 GitHub。
