前言¶
在 DSH 里长时间跑对话、子智能体和重试时，右下角的小鲸鱼挂件往往只起到装饰作用，很难从用量上直观感受到「这一阵子烧了多少 token」。若再依赖余额或单价去估算，口径容易和真实 usage 不一致。下面介绍的 dsh-fatfish-level（大肥鱼等级）把累计 token 做成 14 级成长线，并在铭牌、今日任务、连击与成就里给出可对照的进度，不碰余额、不猜价格，只认本机会话里的真实用量。
这是什么¶
dsh-fatfish-level 是社区维护者 lg6169219 发布的 DSH 插件，目录分类为「趣味换装」。它监听本机会话的 assistant 消息，按 inputTokens、cacheReadTokens、cacheWriteTokens、outputTokens 累加「烧掉的 token」，驱动右下角大肥鱼（小鲸鱼）升级；点开面板可查看成长、今日任务与成就。插件为个人项目，非 DeepSeek 官方出品；鲸鱼轮廓使用 DSH 自带的 FishLogo 矢量路径，按等级改色与装饰。
核心功能¶
14 级成长与界面¶
从 Lv.1「鱼苗」到 Lv.14「维度吞噬者」，每级对应一个 DeepSeek 鲸鱼图标，配色、体型、皇冠、星芒、轨道环逐级变化。右下角胶囊铭牌显示 🐳 Lv.N 称号 🔥连击；点开为三页：成长 / 今日 / 成就。升级时有铭牌弹跳、撒花、漫画气泡；Lv.4 起身后有等级光环，Lv.6 起头顶皇冠，面板内可关闭装饰。
等级门槛（累计 token）见官方 README 等级表，例如 Lv.2「小鱼花」300 万、Lv.6「大肥鱼」2.2 亿、Lv.14「维度吞噬者」1 万亿；Lv.2–4 每级约 3～4 倍，Lv.5–7 约 2 倍，Lv.8 起每档约 3～4 倍。
真实记账与对账¶
插件监听本机所有会话的 assistant/message，子智能体与重试的用量同样计入。reasoningTokens 已含在 outputTokens 中，不再重复相加。轮次按 (会话 id, turn) 去重，同一轮多条 assistant 消息只算一轮；模型归属取消息的 source.model，缺失时记「未知模型」。
首次启用会读取小鲸鱼账本的逐轮记录补算历史；之后定期对账，停用期间漏掉的量会补回总量。补账记入历史，不污染「今日 / 近七日」统计（后者只统计插件实时记到的量）。
今日任务、连击与成就¶
每日三条独立任务：今日烧掉 500 万 / 2000 万 / 5000 万 token，0 点刷新。另有每日目标进度、连续天数，以及 14 个成就徽章（含深夜摸鱼、早起的鱼、一口千万、七日不断等）与个人纪录。
权限与数据¶
运行时无第三方 npm 依赖。私有账本写在 $DSH_HOME/.dsh-fatfish-level.json（累计数、按天、按模型和轮次键，不含会话内容与密钥）。可选只读小鲸鱼的 $DSH_HOME/.dshw-usage.json 与 /dsh-whale/usage-records.json 用于补算与对账；小鲸鱼缺失时主要影响历史补算与部分成就，等级本身仍可工作。浏览器本地存成就与装饰开关等；插件仅提供只读接口 /dsh-fatfish-level/state.json 与 /dsh-fatfish-level/client.js，不上传数据。完整权限说明见仓库 SECURITY.md。
安装与启用¶
需要 DSH 0.2.x（package.json 中 engines.dsh 已声明，含 0.2.1-rc.* 预发布）与 Node.js ≥ 22。插件只在 Web profile 的聊天页挂载，设置页等路由会自动隐藏。
当前推荐从 GitHub 安装：
dsh plugin --profile web add "github:lg6169219/dsh-fatfish-level"
npm 包发布后也可使用：
dsh plugin --profile web add dsh-fatfish-level
装完后刷新一次页面（F5）。插件服务端会热加载；前端脚本通过 index 注入，必须刷新页面后铭牌与面板才会出现。
本地开发可使用 link: 指向仓库绝对路径：
dsh plugin --profile web add "link:<本仓库绝对路径>"
安装前建议浏览源码与 MIT 许可证；插件以当前 DSH 进程权限运行，权限汇总为 medium（私有状态写入 + 同源只读请求，无任意文件/网络能力）。
典型用法¶
安装并刷新页面后，无需额外配置即可开始计分：正常在 DSH Web 聊天中使用模型，每次 assistant 回复的 usage 会累加到等级与今日任务。
日常可这样用：
- 看右下角铭牌上的 Lv、称号与连击，快速感知当前等级与 streak。
- 点击铭牌打开面板，在「成长」页查看距离下一级的累计 token 与升级演出（可在面板关闭部分装饰）。
- 在「今日」页对照 500 万 / 2000 万 / 5000 万三条任务是否打勾。
- 在「成就」页查看徽章与个人纪录。
若本机已安装小鲸鱼相关服务，首次启用会自动尝试历史补算；之后对账在后台进行，一般无需手动操作。
适用场景与注意¶
适合希望在 DSH 里把 token 用量「游戏化」、又希望计分口径与 API usage 一致的开发者。不适合把插件当作计费或余额工具——它明确不读余额、不估价格。
请注意：社区插件目录（如 SkillHub 目录页）与 GitHub 仓库由维护者发布，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，安装前自行评估权限与数据落盘位置。当前 package 版本为 0.3.3（以仓库 package.json 为准）。
结尾¶
dsh-fatfish-level 把真实 session usage 映射成 14 级鲸鱼成长、今日任务与成就，让右下角大肥鱼从装饰变成可追踪的用量反馈。进一步了解可访问目录页 lg6169219/dsh-fatfish-level 与源码仓库 github.com/lg6169219/dsh-fatfish-level。
