前言¶
在 DeepSeek Harness（DSH）裏跑智能體，Token 會分散在多段會話日誌裏；設置頁裏常見的「技術儀表盤」類插件，多半佔的是設置或側欄裏的統計視圖。若你希望左欄一個入口、中間整頁就是「個人主頁」——頭像暱稱、累計用量、模型分佈、近一年熱力圖放在一起——需要走 main keyed 整頁槽位的客戶端插件。下面介紹社區插件 dsh-achievements（維護者 Abyssun，GitHub Abyssun/dsh-achievements），它把歷史 Token 用量攤成五張卡片，並在同一頁展示模型用量與貢獻熱力圖；與設置頁型統計插件槽位 id 不衝突，可同時安裝。
這是什麼¶
dsh-achievements 是爲 DSH Web UI 做的個人成就插件：左欄獎盃圖標 → 中間一整頁個人主頁。暱稱與頭像默認取自你登錄 DSH 的賬號，可自行編輯；指標來自本地會話投影與跨會話彙總，不是雲端賬號體系。分類上屬於客戶端插件（dsh.client.platform: web），當前 package 版本 0.1.7，許可證 MIT。
核心功能¶
整頁個人主頁包含資料區與統計區，主題走 DSH 設計令牌（--dsw-alias-*），明暗隨宿主切換。
| 能力 | 說明 |
|---|---|
| 資料卡片 | 頭像、暱稱；頁內可「編輯資料」，設置頁 settings.plugins.tab 裏也有同一套編輯器 |
| 五張指標卡片 | 累計 Token 數、Token 使用峯值、最長任務用時、最長連續天數、當前連續天數 |
| 模型用量 | 各模型用量條與佔比；點一行只篩該模型，卡片與圖表隨之變化（「最長任務用時」無模型維度，篩選時仍爲全局值） |
| 貢獻熱力圖 | 最近一年按本地日曆日的用量方格，懸停可看精確值；大數卡片懸停也會顯示逐位精確值 |
| 頭像上傳 | 支持 PNG / JPEG / WebP / GIF，可拖動、縮放後裁成正方形 |
| 側欄入口 | sidebar.panellist，id 與 main 槽位 key 均爲 dsh-achievements |
與「設置頁技術儀表盤」型 Token 統計的區別：本插件佔用 main keyed 整頁槽位，形態是獨立「個人主頁」，不是替換設置裏的儀表盤。
安裝與啓用¶
DSH 社區目錄頁：skillhub.cn/plugins/Abyssun/dsh-achievements（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。安裝來源以 README 爲準。
在應用內插件市場 / 插件管理中填寫：
github:Abyssun/dsh-achievements
或在 profile 目錄下執行：
pnpm add "github:Abyssun/dsh-achievements"
裝完後必須重啓 DSH：已安裝插件沒有熱重載，Host 加載、typert 註冊與 client bundle 注入都在啓動時完成。重啓後左欄出現獎盃圖標，點擊即切到整頁個人主頁。
桌面 Electron 的 desktop profile 由應用獨佔管理，命令行 dsh plugin 會拒絕操作該 profile；此類環境請只用應用內插件市場安裝。
版本兼容：插件聲明 engines.dsh 爲 >=0.1.5-rc.2 <0.3.0，DSH 0.2.0 起安裝時會校驗；不兼容會拒絕安裝並回滾。README 記載已在 0.2.1-rc.2（當時桌面版）驗證可用。
典型用法¶
- 點左欄獎盃圖標，進入整頁個人主頁。
- 首次打開會提示「正在後臺掃描歷史會話…」並逐步累加；需讀完歷史日誌後數字才穩定。
- 編輯資料：改暱稱或上傳頭像；留空則回退爲 DSH 賬號的暱稱/頭像。
- 模型篩選：在「模型用量」中點擊某模型，卡片與圖表僅看該模型；再點一次取消篩選。
指標口徑（便於對照卡片含義）：
- 累計 Token：全部會話的
inputTokens + outputTokens + cacheReadTokens + cacheWriteTokens；inputTokens只含未緩存輸入，reasoningTokens屬輸出的一部分、不重複計入。 - Token 使用峯值：按本地日曆日聚合後的單日最大值。
- 最長任務用時：相鄰事件間隔大於 30 分鐘則切分爲新作業段，取最長一段（避免「恢復會話跨天」被算成一次任務）。
- 最長 / 當前連續天數：按「有 Token 消耗的本地日曆日」計算；當前連續從今天往前數，今天尚未消耗則從昨天起算。
fork / 子會話的繼承前綴通過 readSession() 返回的 inheritedEventCount 跳過，避免重複計數。
適用場景與注意¶
適合：長期在 DSH 本地跑會話、想在一頁裏看累計用量、峯值、連續使用天數和模型分佈的開發者；需要 GitHub 式熱力圖回顧近一年活躍，而不是隻看設置頁儀表盤。
權限與安全：插件在當前 DSH 進程權限下讀取本地會話與日誌；安裝前請自行查看 源碼倉庫 與 MIT 許可證，確認符合你的環境策略。
已知限制（README 原文）：
- 聯網搜索路徑
web/deepseek-search-llm-request事件不帶usage，統計不到對應 Token。 - 有新對話寫日誌時數字會變，頁底有「截至 …」標註。
- 每次啓動都會重掃歷史會話（約十幾秒到幾十秒，視會話數而定）。
- 頭像裁剪固定正方形，非自由比例。
架構要點（可選閱讀）¶
插件在 Host 側通過 AchievementsService、投影單元 dsh-achievements.ledger 與跨會話 rollup 彙總；客戶端經 ctx.remote.achievements 掛載整頁與設置 Tab。main[keyed, key="dsh-achievements"] 與 sidebar.panellist[id="dsh-achievements"] 的 id 必須與 main key 一致——這是 DSH 插件槽位約定，改動的維護者需跑 npm run e2e 驗證。
結尾¶
dsh-achievements 把 Token 活動做成整頁「個人主頁」：五張卡片 + 模型篩選 + 一年熱力圖，側欄一鍵進入。安裝來源 github:Abyssun/dsh-achievements，重啓 DSH 後可用。目錄頁：https://www.skillhub.cn/plugins/Abyssun/dsh-achievements；源碼與說明：https://github.com/Abyssun/dsh-achievements。
