前言¶
在 DeepSeek Harness（DSH）里跑智能体或长会话时，你往往关心两件事：这段时间实际用了多少、流量或调用是否集中在某个 Provider 上。Harness 本身不一定会把这些信息做成一块常驻面板；若只靠日志或外部记账，切换 profile、换机器后也不方便对照。
dsh-app-usage 是社区插件，在本地汇总当前会话的统计数据，并按 Provider 拆分，同时提供活动热力图面板（activity heatmap panel）。下面介绍它是什么、如何安装启用，以及使用时需要注意的点。
这是什么¶
- 名称：
dsh-app-usage（npm 包名与仓库名一致） - 维护者：bosenok
- 分类：记忆（社区目录 SkillHub 上的归类）
- 定位：面向 DeepSeek Harness 的 DSH bundle 插件；在本地记录会话统计，并按 Provider 展示 breakdown，客户端以 Web 形式挂载。
插件通过 package.json 声明 dsh.bundle.patch，由 cordis.patch.yml 把 app-usage 行插入当前激活的 profile；客户端入口为 lib/client.js（dsh.client.platform: web）。
核心功能¶
依据仓库 README 与 package.json 描述，已核实的能力包括：
- 本地会话统计：统计范围限于本机 DSH 会话，不依赖远程上报（具体指标以插件实现为准）。
- 按 Provider 拆分：统计结果可按 Provider 维度分组，便于对比不同后端或路由的使用情况。
- 活动热力图面板：UI 侧提供 activity heatmap panel，用于可视化一段时间内的活跃分布（实现基于 Vue 与 ECharts，见仓库
devDependencies）。
安装与启用¶
安装方式以 README 原文为准。插件要求 DSH 版本：>=0.2.1-rc.2 且 <0.3.0（见 package.json 的 engines.dsh）。
桌面应用¶
在 DSH 桌面端打开 Plugins，安装 github:bosenok/dsh-app-usage。若仓库为私有，需先让本机具备 git 访问权限，再在界面中启用对应 bundle。
CLI¶
指定 profile 添加插件：
dsh plugin --profile <profile> add github:bosenok/dsh-app-usage
从本地目录安装（开发或自改源码时）：
dsh plugin --profile <profile> add file:/path/to/dsh-app-usage
启用 bundle 后插件会挂载到 Harness；对正在运行的应用可经 HMR 生效，重启可确保客户端半部重新构建。
desktop profile 的特别说明¶
对应用管理的 desktop profile：dsh plugin --profile desktop add 只会安装依赖并复制包，不会自动启用 bundle。需要把包名加入 ~/.dsh/profiles/desktop/package.json 中的 dsh.profile.bundles，或在 Plugins 页面手动启用。其他 profile 在安装后通常会自动启用已安装的 bundle。
典型用法¶
README 未给出单独的「业务 API」示例；日常使用流程是：安装并启用 bundle → 在 Harness 中照常使用会话 → 在插件提供的面板中查看本地统计与按 Provider 的拆分及热力图。
开发侧若需改客户端，源码在 src/，构建产物提交在 lib/。可按仓库说明重建客户端：
npx vite build
构建输出在 dist/，再由 build/wrapper.js 生成 lib/client.js。
适用场景与注意¶
适合谁
- 需要在 DSH 内快速查看「本会话用了多少、各 Provider 占比」的开发者。
- 希望用热力图扫一眼活跃时段、而不是翻日志的人。
注意
- 插件在当前 dsh 进程的权限下运行，统计与面板数据留在本地会话语境中；安装前请自行阅读 GitHub 源码 与 MIT 许可证；
lib/内第三方依赖见 THIRD_PARTY_NOTICES.md。 - 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，仅作发现与索引，版本与安装命令仍以仓库 README 为准。
结尾¶
dsh-app-usage 把本地会话统计、Provider 维度拆分和活动热力图收进 Harness 插件形态，适合作为 DSH「一切皆插件」生态里的一块「记忆 / 用量」向面板。需要安装命令与 bundle 行为时，以仓库 README 为准。
