前言¶
DeepSeek Harness（DSH）可以通過插件擴展能力。對於希望把本地使用過程記錄爲可回看、可展示、可清除的成就記錄的場景，WJNCT55555/dsh-achievements 提供了一個進程級全局成就係統插件。
下面介紹它的定位、核心功能、安裝方式、典型用法，以及安裝前需要確認的權限與許可證事項。
這是什麼¶
dsh-achievements 是 WJNCT55555 維護的 DeepSeek Harness 插件，用於在 DSH 中提供進程級全局成就係統。
它的 GitHub 倉庫地址是：
https://github.com/WJNCT55555/dsh-achievements
許可證爲 MIT。安裝命令使用 npm 包名：
dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle
核心功能¶
成就目錄¶
插件提供 52 個成就，分爲十類：
- 啓程
- 工具大師
- 文件工匠
- 編排
- 目標
- 技能
- 模型
- 行爲
- 聯動
- 隱藏
成就稀有度覆蓋：
- 普通
- 稀有
- 史詩
- 傳說
成就畫廊與儀表盤¶
成就畫廊支持兩種查看方式：
- 按分類查看
- 按難度或稀有度查看
數據儀表盤包括：
- 分類進度中空環形圖
- 當月活動日曆熱力圖
- 稀有度分佈分段滑條
本地持久化¶
成就計數與解鎖狀態會保存到：
~/.agent-achievements/state.json
重啓後狀態保留。
多界面展示¶
插件支持多個 UI 表面：
- 解鎖 toast
- 側欄獎盃
- 輸入塢進度讀條
- 設置頁畫廊
- 全屏畫廊
清除成就記錄¶
插件提供清除成就記錄按鈕，並帶有二次確認彈窗，可一鍵清空全部進度。
清除後會清空全部成就進度，但保留匿名統計開關與匿名標識。
隱藏成就¶
隱藏成就在達成前，名稱和描述以 ？？？ 顯示。
聯動成就¶
聯動成就「吾棲之膚」會在檢測到 dsh-deep-whale 鯨魚娘皮膚插件已安裝時自動解鎖。
該聯動檢測依賴 dsh-deep-whale 是否安裝。
宿主側接口¶
宿主側提供只讀 Remote 和 list_achievements 工具。
安裝與啓用¶
使用 npm 安裝¶
執行下面命令：
dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle
該命令安裝的是 DSH 插件 bundle 包。
使用 git 安裝¶
先克隆倉庫：
git clone https://github.com/WJNCT55555/dsh-achievements
再執行本地安裝命令：
dsh plugin --profile web add ../dsh-achievements
從源碼構建¶
如果要從源碼構建，依次執行：
pnpm install --offline
pnpm exec tsc -b
pnpm exec tsdown
pnpm --filter @wjnct55555/dsh-client-ui-achievements bundle
運行測試¶
運行成就相關測試：
pnpm exec vitest run packages/extensions/achievements/tests/achievements.spec.ts
典型用法¶
查看成就¶
安裝後，可以從成就畫廊查看成就。畫廊支持按分類查看，也支持按難度或稀有度查看。
清除進度¶
在成就管理入口使用「清除成就記錄」按鈕。系統會給出二次確認彈窗，確認後清空全部成就進度。
注意：匿名統計開關與匿名標識不會被清除。
啓用匿名統計¶
匿名統計默認關閉。啓用時，先在 cordis.yml 中給 @wjnct55555/dsh-achievements 配置 telemetryEndpoint。
示例配置如下：
# cordis.yml
- plugin: @wjnct55555/dsh-achievements
config:
telemetryEndpoint: https://your-endpoint.example
把 https://your-endpoint.example 替換爲你實際使用的端點地址。
配置完成後，在成就畫廊設置裏打開匿名統計開關。開關狀態會持久化，重啓後保留。
開啓後，僅上報：
- 成就 id
- 稀有度
- 隨機匿名安裝標識
未配置 telemetryEndpoint，或未開啓匿名統計時，不發生任何網絡請求。
深度洞察層¶
深度洞察層爲 opt-in，默認關閉。
啓用後，允許對消息正文進行正則匹配與歷史會話掃描。消息正文只在運行時匹配，不落盤。
聯動成就¶
如果你已經安裝 dsh-deep-whale 插件，dsh-achievements 檢測到該插件後，會自動解鎖聯動成就「吾棲之膚」。
適用場景與注意¶
適合在 DSH 中使用插件能力，並希望本地保留成就進度、畫廊展示與可清除記錄的用戶。
安裝前需要注意：
- 插件隨當前
dsh進程權限運行。 - 安裝前應檢查源碼與許可證。
- 本倉庫許可證爲
MIT。 - 默認零上傳。
- 基礎層只讀取工具名、成功標誌、
agent id、事件類型、文件路徑、token計數等葉子標量，不讀取消息正文、文件內容、錯誤詳情或搜索結果。 - 深度洞察層默認關閉，啓用後才允許消息正文正則匹配與歷史會話掃描。
- 匿名統計默認關閉，開啓後僅上報成就 id、稀有度與隨機匿名安裝標識。
- 清除成就記錄會清空全部進度，但保留匿名統計開關與匿名標識。
結尾¶
dsh-achievements 爲 DSH 提供了一組本地持久化、可展示、可清除、可聯動的成就記錄。它默認零上傳，並對深度洞察和匿名統計都保持 opt-in 設計。
GitHub 倉庫：
https://github.com/WJNCT55555/dsh-achievements
已覈實資料未給出目錄頁 URL。安裝前建議先檢查源碼與許可證。
