DSH 侧栏里的年度回顾,数据全部来自本机会话日志(经 ctx.sessionQuery 读取)。九页依次是相遇日期、会话与轮次、你说了多少字、一天 24 小时分布、工具调用、token 与缓存命中率及按 DeepSeek 官方价估算的错峰节省、按 11 条用法规则选出的人格标签;最后一页生成 1080×1440 的分享图,可保存或复制为 PNG。鲸鱼插画全部用代码画成 SVG,13 种人格各有造型。只读、全程本地,不发外部请求,不写任何文件。界面文案目前只有中文。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-year-report
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ViolaTan55/dsh-year-report
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
给 DeepSeek Harness 的年度回顾:读本机会话日志,讲一段「你和鲸鱼的这一年」,最后生成一张能晒的分享图。
- 9 页故事:相遇 → 陪伴 → 你说了多少字 → 几点找它 → 它替你动手 → 账本(含错峰省下多少钱)→ 人格标签 → 分享图
- 人格标签:深海夜游鲸、谷时精算师、甩手掌柜、惜字如金、马拉松选手、缓存大师……按你的真实用法挑一个主标签、两个副标签
- 鲸鱼插画:每页一幅小插画,13 种人格各有专属造型(睡帽、墨镜、皇冠、船长帽……),全部是代码画的矢量图,页面和分享图共用一套
- 全程本地:不发任何外部请求、不写文件;分享图只有汇总数字,不出现会话标题和项目名
| 封面 | 作息 | 账本 |
|---|---|---|
![]() |
![]() |
![]() |
| 人格标签 | 分享图 |
|---|---|
![]() |
![]() |
截图用的是内置的示例数据(preview/index.html?data=demo),不是任何人的真实用量。
安装
dsh plugin --profile web add dsh-year-report
或者把这句话发给你的 DSH:帮我装 dsh-year-report。装好后左侧栏会出现「年度报告」。
本地开发版:
dsh plugin --profile web add link:/path/to/dsh-year-report
dsh --profile web
结构
| 文件 | 作用 |
|---|---|
report.js |
统计核心(纯函数):会话快照 → 报告;计价、人格规则都在这里 |
index.js |
宿主半区:经 ctx.sessionQuery 读会话,挂 GET /api/dsh-year-report/report |
client.js |
浏览器半区:侧栏入口 + 故事页 + canvas 分享图 |
preview/ |
不启动 DSH 的预览壳;npm run preview:data 用本机日志生成 local.js,?data=demo 看重度用户示例 |
preview/art.html |
美术一览:全部插画、人格造型和背景装饰 |
test/ |
npm test |
market/ |
提交到 awesome-dsh-plugin 的条目文件和 PR 说明 |
口径
- 统计范围是当年(本机时区)的事件;分叉会话继承来的前缀不重复计数;子代理会话只计 token 和工具调用,不计会话数和你说的话。
- 花费按 DeepSeek 官方人民币价估算,只算
deepseek-account/deepseek-official两个直连供应商;高峰为北京时间工作日 9–12、14–18 点,其余(含周末、法定节假日)半价。「错峰省下」= 这些用量全按高峰价算的花费 − 实际估算花费。价格表整理参考了 dsh-profile-stats(MIT)。 - 深夜指 22 点到次日 5 点。
兼容性
在 DSH 0.2.2-rc.1 的 web 配置下验证过。桌面端和更早的版本没有实测。
还没做
- 让其他插件给报告加一页(例如记忆插件「它记住了你什么」、桌宠「陪了你多少小时」)
- 可选的匿名排名(「超过 93% 的 DSH 用户」)——需要上传汇总数字,默认不做
- 英文文案
链接
同类插件
bowenliang123/dsh-context★ 5191
DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。
Han-1413141/dsh-cost-meter★ 705
会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。
wssfk12138/dsh-damage-pulse★ 290
在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。
zh667/TokenLedger★ 205
侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。
Ychris12138/dsh-usage-stats★ 190
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
Mt-Youya/dsh-plugins#sessions-insight★ 166
按工作目录浏览 Claude Code、DSH 和 Codex 会话日志,查看每轮上下文构成、token 用量、压缩点和费用估算。





社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。