前言¶
DSH 的插件理念是「一切皆插件」：常用能力可以拆成獨立插件，按 profile 安裝。社區目錄是獨立站點，與 DeepSeek 或幻方沒有官方從屬關係，也不等同於官方應用商店。
對長期在 DSH 中讓 agent 工作的開發者來說，回合、工具調用、新會話、每日活動這些數據往往分散在不同會話裏。dsh-achievements 爲 DeepSeek Harness（DSH）提供一個成就與遊戲化層，把這些使用軌跡整理成可查詢的徽章、分享卡片和 Agent Wrapped。它不改核心，只監聽官方 session/event 事件。
這是什麼¶
dsh-achievements 是一個 DSH 成就與遊戲化插件。已覈實資料給出的維護者/倉庫 owner 爲 Blaczz，許可證爲 MIT，倉庫地址爲：
https://github.com/Blaczz/dsh-achievements
它解決的問題是：在不改 DSH 核心的前提下，把跨會話使用記錄變成可查、可分享、可擴展的成就狀態，併爲第三方插件提供註冊成就的開放 SDK。
核心功能¶
68 個成就¶
插件提供 68 個成就，分三條產品線：
- 7 條五檔終身成長線
- 10 個會話行爲徽章
- 20 個會話軌跡成就
成就卡片展示圖標、稀有度、描述、進度、XP 和解鎖時間。
即時解鎖與設置頁面板¶
新成就解鎖時，插件通過 SSE 推送到瀏覽器，並提供 30 秒輪詢兜底；頁面刷新或可見性變化時也會更新。
設置頁成就面板包含：
- 個人資料卡
- 稀有度統計
- 終身計數器
- 徽章牆
徽章牆按七條成長路線和 special/trajectory chains 分組，支持 all / locked / unlocked 過濾。
分享卡片與 Agent Wrapped¶
插件提供分享卡片與 Agent Wrapped。
隱私方面，分享文本、分享卡片、Agent Wrapped 和成就鏈只讀取聚合計數、成就元數據、persona 和等級；文件路徑和命令字符串不離開引擎。
開放 SDK¶
第三方 Host 插件可通過 ctx.achievements.register / ctx.achievements.registerPack 註冊成就；客戶端插件可通過 ctx.achievementsState 讀取狀態。
已覈實資料未提供完整註冊代碼示例，本文不補全調用參數。
零核心改動與狀態持久化¶
插件以零核心改動實現：只監聽官方 session/event 事件，均爲只讀事件，無核心補丁。
狀態持久化爲 DSH home 目錄中的 JSON 文件；v1 狀態可無損遷移。
測試¶
插件核心爲三層純函數流水線，並附 19 個測試文件、251 個測試。
安裝與啓用¶
前置條件：
- DSH 的
dsh web可用 - Node >= 22.19
從 GitHub 安裝時，已覈實資料給出的命令爲：
dsh plugin --profile web add "github:luumod/dsh-achievements#main"
安裝後需要重啓已運行的 dsh web 進程。
從本地安裝時，可按以下步驟操作：
cd dsh-achievements && npm install --legacy-peer-deps && npm run build
npm pack --ignore-scripts
然後用生成的 dsh-achievements-0.1.0.tgz 絕對路徑添加：
dsh plugin --profile web add "/absolute/path/dsh-achievements-0.1.0.tgz"
注意：已覈實資料中的安裝命令使用 luumod，倉庫頁 owner 爲 Blaczz。本文只轉寫資料中已給命令，不據此判斷兩者爲同一發佈方。
典型用法¶
1、安裝後重啓 dsh web，然後正常使用；首個完成回合會解鎖第一個成就。
2、聊天並讓 agent 工作：回合、工具調用、新會話和每日活動會靜默累積，新成就解鎖時彈出提示。
3、在 Settings → 成就 中查看個人資料卡、終身計數器、徽章牆、會話報告、Agent Wrapped 和 Share。
4、在徽章牆中按七條成長路線和 special/trajectory chains 查看成就，並使用 all / locked / unlocked 過濾。
5、開發者在 Host 插件中使用 ctx.achievements.register / ctx.achievements.registerPack 註冊成就；在客戶端插件中使用 ctx.achievementsState 讀取狀態。
適用場景與注意¶
適合：
- 長期在 DSH 中使用 agent，並希望查看跨會話累計情況的開發者
- 想要把工具調用、會話行爲、軌跡數據變成可查成就的使用者
- 準備基於開放 SDK 擴展第三方成就包的插件開發者
注意：
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼、依賴與許可證。 - 許可證爲 MIT。
- 資料中
package.json的 peerDependencies 裏@deepseek-ai/cordis版本約束被截斷，無法確認完整約束；升級 DSH 或相關依賴前，應按倉庫說明覈對。 - 資料未提供完整開發者 SDK 代碼，本文只列出已覈實的接口名，不補全調用示例。
- 目錄頁 URL 未在已覈實資料中出現，本文不給出具體目錄頁鏈接。
結尾¶
dsh-achievements 的價值在於把 DSH 的使用軌跡整理成可查詢的成就狀態：跨會話累計、即時解鎖、設置頁面板、分享卡片和開放 SDK，同時保持零核心改動。
GitHub 倉庫：
https://github.com/Blaczz/dsh-achievements
目錄頁 URL 未提供。
