前言¶
DeepSeek Harness（DSH）桌面版在「设置 → 账号与余额 → 查询用量」里默认打开内嵌的 platform.deepseek.com/usage 页面。若你更希望在应用内直接看到余额、累计消费与 Token、以及按日汇总的可视化，而不依赖该网页，社区插件 Neko_02（npm 包名 dsh-usage-overview）会把同一入口换成可读的面板，数据仍走 DSH 已有登录会话，由 Host 侧聚合 Platform API 后只把数字交给界面。
下面介绍它是什么、能做什么、如何安装与使用时需要注意的点。
这是什么¶
Neko_02 由维护者 nTillMeetu 发布，归类为 客户端 类 DSH 插件；在 SkillHub 目录 与 GitHub 仓库 均可找到。当前仓库版本 1.0.1，许可证 MIT。README 明确说明：这不是 DeepSeek 官方产品，而是运行在 DSH 桌面 profile 内的社区插件，依赖 DSH 的扩展点（Host 注册路由、Client 注入设置面板）。
核心功能¶
面板替换「查询用量」内嵌页，提供整账号视角的用量概览（README 与 package 描述已核实）：
- 账号汇总：余额、累计消费、累计 Token 与请求次数。
- 单月日历热力图：每一天显示当日消费与 Token，颜色深浅表示当日花费高低；点击某天弹出明细（消费、Token、API 请求数）。
- 月份导航：月份选择器与月份方块网格，点击可跳转到对应月份。
- 筛选与导出：按 API Key 过滤；将所选月份导出为 CSV。
界面支持 DSH 的深色与浅色主题；README 截图注明使用合成数据演示。
安装与启用¶
环境要求（来自 README）：
| 项 | 说明 |
|---|---|
| 应用 | DeepSeek Harness 桌面版（文档写明在 0.2.1-rc.5、Windows x64 上测试） |
| Node.js | 20+（安装脚本用；DSH 自带 runtime 可作后备） |
| 账号 | 已在 DSH 中登录（面板读取现有会话） |
| 系统 | 目前主要在 Windows 上测试；安装脚本仅用 Node API，其他平台未充分验证 |
这不是独立 Web 应用，而是写入 DSH profile 的 bundle：Host 增加一条路由，Client 在设置对话框中增加一块面板。
官方安装步骤如下。脚本会定位 DSH profile（默认 ~/.dsh/profiles/desktop，可用 --profile 覆盖），备份 package.json 与 pnpm-lock.yaml，添加 link: 依赖与 dsh.profile.bundles 条目，再用 DSH 内置 pnpm 安装，并提示重启。
git clone https://github.com/nTillMeetu/Neko_02.git
cd Neko_02
node install.mjs
装完后 重启 DeepSeek Harness，打开 设置 → 账号与余额 → 查询用量。
常用参数：
node install.mjs --dry-run # 仅预览将要修改的内容
node install.mjs --profile "C:/Users/you/.dsh/profiles/desktop"
node install.mjs --uninstall # 卸载
若手动改 profile，在 ~/.dsh/profiles/desktop/package.json 中加入 dsh-usage-overview 的 link: 依赖，并在 dsh.profile.bundles 中注册 dsh-usage-overview，在该目录执行 pnpm install 后重启 DSH。示例结构见仓库 README 的 Manual install 小节。
卸载：
node install.mjs --uninstall
然后重启 DSH；手动安装时需删除依赖与 bundle 项并重新 pnpm install。
典型用法¶
安装并重启后，从设置进入「查询用量」即可使用面板，无需额外配置项（资料中未列出独立配置文件字段）。
可按 API Key 过滤查看；在月份选择器或月份方块中切换月份，在热力图上点选某一天查看当天明细；需要留存记录时，导出当前所选月份 CSV。
若余额或用量报错，README 建议：确认 DSH 内已重新登录，再打开面板并点击 刷新。若仅 Client 热重载而未重启 DSH，Host 路由可能未注册，会出现月度数据不全、月份选择器被禁用等情况——完整安装流程已包含重启 Host。
工作原理与安全（简要）¶
- Host（
lib/index.js）注册/usage-overview/summary，使用 DSH 已有的账号授权，调用 Platform/api/v0/usage/by_api_key/*（31 天对齐窗口，带缓存），只返回数字。 - Client（
lib/client.js）在 DSH overlay 槽位渲染面板，向上述路由拉数据，不直接访问platform.deepseek.com。
账号 token 不离开 Host 进程、不下发到客户端；插件 README 称运行时无遥测、无第三方依赖（React 与 DSH UI 原语由 DSH 提供）。插件以当前 DSH 进程权限运行，安装前建议自行查看源码与 MIT 许可证。
适用场景与注意¶
适合：长期在 DSH 桌面版开发、调试 API，希望在同一应用内快速对照余额、日消费与 Token，并按 Key 或月份导出 CSV 的用户。
注意（均来自 README Caveats / Troubleshooting）：
- DSH 插件 API（如
shell.overlay、profile Web 路由、UI 原语）并非稳定公开契约，DSH 升级可能导致插件失效，大版本升级前可查看仓库 Issue。 - Platform 单次查询上限为 31 个日历对齐日，全时段与月度合计由连续窗口累加；月度合计可能与平台 lifetime 合计有少量分位差异。
- 月份表从账号首个 API Key 所在月份开始，更早月份在选择器中不可用。
- 仓库路径变更后需重新运行
node install.mjs以刷新link:路径。 - 面板不出现：检查 profile 的
dsh.profile.bundles是否含dsh-usage-overview，并在 profile 目录重新pnpm install；需 DSH 构建提供shell.overlay槽位。
SkillHub 与 GitHub 上的社区目录独立于 DeepSeek / 幻方，不等同于官方应用商店。
结尾¶
Neko_02 把 DSH 桌面版「查询用量」从内嵌平台页换成应用内面板：余额、累计指标、按月日历热力图、按 Key 过滤与 CSV 导出，Host 聚合、Client 展示，适合需要在本机 DSH 里一眼看清用量结构的开发者。
- 目录页：https://www.skillhub.cn/plugins/nTillMeetu/Neko_02
- 源码与文档：https://github.com/nTillMeetu/Neko_02
