前言¶
在 DeepSeek Harness（DSH）里做智能体或日常对话时，很少有人能准确说出「这周实际挂了多久客户端」。系统活动统计往往粒度粗，也不按「一次打开到关闭」来记账。社区插件 dsh-usage-timer（维护者 CQin04，目录分类为「记忆」）在 DSH 启动时自动开始计时、关闭时结束，并在左侧栏页面汇总每次使用与累计时长；退出后 3 分钟内重新打开会续接同一次记录，避免频繁重启把一次使用拆成多条。下面介绍它的能力、安装方式与使用时的限制。
这是什么¶
dsh-usage-timer 是一个面向 DSH Web / Desktop 的客户端插件（platform: web）。打开 DSH 即开始本次计时，关闭窗口即结束；所有数据只存在本机，不上传。界面文案随 DSH 语言在中英文之间切换，未翻译语言回退英文。
- 仓库：CQin04/dsh-usage-timer
- 目录页：skillhub.cn/plugins/CQin04/dsh-usage-timer
- 许可证：MIT（见仓库
LICENSE） - 包版本（资料中的
package.json）：1.1.0
核心功能¶
资料中列出的能力如下，安装启用后即可使用，无需额外配置项。
- 打开即计时：页面启动时自动开始记录；关闭窗口时结束。
- 连续计时：关闭后 3 分钟内再次打开，视为同一次使用，间断时间仍计入该次时长；超过 3 分钟则记为新的使用。
- 每次使用记录：保存每次的开始时间、结束时间与时长。
- 汇总：累计使用时长、打开次数、平均每次时长。
- 历史列表：按天分组并显示每日合计；当前会话实时显示「进行中」。
- 实时秒表：「本次使用」卡片每秒刷新。
- 本地存储：记录保存在 DSH 本地存储，键名为
dsh-usage-timer.v1。
界面入口¶
安装并启用后，在左侧栏「全局面板图标」区域（Plugins、定时任务图标之后）会出现时钟图标，名称为「使用计时」。点开中央页面包含三块：
- 本次使用：已用时长、开始时间、计时状态。
- 累计使用：总时长、打开次数、平均每次。
- 使用记录：按天分组的历史，每条为「开始 → 结束」与该次时长。
安装与启用¶
要求：DSH Web / Desktop；本机可用 pnpm；从 Git 地址安装时还需要 git。README 中记载的测试版本为 DSH 0.2.2-rc.1。
方式一：Git 仓库地址（推荐）¶
- 打开 DSH 左侧栏 Plugins。
- 点 Add plugin（或箭头菜单里的 Install a third-party plugin）。
- 在包名字段填入仓库地址：
https://github.com/CQin04/dsh-usage-timer
- 确认后等待安装完成，插件会自动启用。
方式二：本地目录¶
- 将仓库放到本机目录，例如
C:\plugins\dsh-usage-timer。 - 在 Add plugin 中填入该目录的绝对路径，或以
file:/link:开头的形式。 - 安装并启用。
以 link: 方式安装时，DSH 引用该目录而非复制文件，安装后请勿移动或删除该目录。
验证¶
Plugins 列表中出现 Usage timer / 使用计时，详情页显示 README；左侧栏出现时钟图标即表示插件已运行。
典型用法¶
日常无需命令行操作：保持 DSH 窗口打开即持续计入本次时长；需要查看统计时点左侧栏「使用计时」即可。
若短时间内因升级或崩溃重启 DSH，在 3 分钟内重新打开，同一条会话会续接，汇总中的「打开次数」不会因此多算一次。需要从零开始记新的一使用时，关闭后间隔超过 3 分钟再打开即可。
卸载：在 Plugins 中关闭 Usage timer / 使用计时 开关即可停用；卸载会移除代码，但 localStorage 中的历史仍在，必要时可在浏览器或应用中清除该站点数据。
数据存储与计时行为¶
- 桌面版内嵌页面使用稳定源
_dsh-app://app，重启应用一般不会丢记录；通过浏览器访问 Web GUI 时，数据按该页面地址的源保存。 - 结构为
{ version: 1, sessions: [{ id, start, end, lastSeen }] }，时间为毫秒时间戳；end为null表示仍在计时。 - 每 5 秒写入一次心跳；正常关闭时立即写入结束时间。崩溃或强退时，下次启动会按最后一次心跳时间补上结束点。
适用场景与注意¶
适合谁：想量化自己在 DSH 上花费时间、区分「打开次数」与「总时长」的开发者或重度用户；数据留在本机，适合作为个人使用习惯的对照，而非团队报表。
安装前：插件在 DSH 客户端环境中运行，与页面脚本同级访问本地存储。安装第三方插件前建议浏览仓库源码并确认 MIT 等许可证条款。
已知限制（来自 README）：
- 同时打开多个 DSH 窗口时，各窗口分别计时，累计时长可能重复。
- 窗口未关闭时（如系统休眠、锁屏），时长仍会继续累计。
- 最多保留最近 2000 条记录。
- 清除该站点本地数据会清空全部记录。
结尾¶
dsh-usage-timer 用低开销的方式回答「DSH 开了多久、开了多少次」：自动计时、3 分钟内重启续接、侧栏汇总与按天历史，且数据不上传。需要安装或源码细节时，可看目录页 skillhub.cn/plugins/CQin04/dsh-usage-timer 与 GitHub 仓库 github.com/CQin04/dsh-usage-timer。
