前言¶
在 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。
