dingyi222666/dsh-wakatime

WakaTime 插件,适用于 DeepSeek Harness (dsh) — 追踪 AI 编码活动、代码行数和花费的时间

Project Overview项目介绍

This is a WakaTime plugin built natively for DeepSeek Harness (DSH), designed to track AI coding activity, lines of code modified, and total time spent on coding projects. It can be installed directly from npm via the DSH CLI, or built and installed from source by cloning the GitHub repository and running pnpm install and pnpm run build. It works across all DSH profile types including web, headless, and TUI, and you will need to install it separately to each profile you use regularly, then restart DSH to activate the plugin.

Before first run, you must obtain a WakaTime API key from your WakaTime account settings page and add it to your local ~/.wakatime.cfg configuration file. The plugin will automatically download and update the wakatime-cli binary if you do not already have a global system installation of the tool. If you prefer to manage wakatime-cli yourself, you can install it via Homebrew on macOS or download it directly from the official WakaTime GitHub releases page. The plugin tracks all file operations the DSH agent performs, including reading, editing, writing, and opening image files during agent sessions.

The plugin supports optional custom configuration, including adjusting the heartbeat interval, setting timeout values, and enabling debug logging. It requires DSH version 0.1.3-alpha.2 or newer, and has a few minor known limitations: it does not track file activity associated with bash commands, and older DSH versions do not support live activity heartbeats. It is released under the open source MIT license, and all core logic is properly unit tested for ongoing development and community contributions.

这是一款专为 DeepSeek Harness (DSH) 开发的原生 WakaTime 插件,用于追踪你的 AI 编码活动、代码行数和花费时长。它改编自 opencode-wakatime,适配了 DSH 的插件模型,支持从 npm 或源码安装,可运行在 web、headless、TUI 等所有 DSH 配置档中,需要为每个使用的配置档单独安装,安装后重启 DSH 即可生效,更新也只需重新执行原安装命令。

普通用户使用前需要先从 WakaTime 设置页面获取自己的 API 密钥,配置到 ~/.wakatime.cfg 文件中。插件会自动下载更新 wakatime-cli,也支持用户手动通过 Homebrew 等包管理器安装全局版本。它会自动追踪 DSH 代理执行的各类文件操作,包括读取、编辑、写入文件等行为,生成符合 WakaTime 要求的统计数据。

插件支持自定义配置,可修改心跳间隔、超时时间、开启调试日志等,所有配置项都是可选的。它依赖 DSH 0.1.3-alpha.2 及以上版本,目前已知不追踪 bash 命令关联的文件活动,旧版本 DSH 无法获得实时心跳功能。项目采用 MIT 许可证开源,用户可以自由使用、修改和分发代码。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @dingyi222666/dsh-wakatime

把 dingyi222666/dsh-wakatime 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@dingyi222666/dsh-wakatime

npm version GitHub

English | 中文

WakaTime plugin for DeepSeek Harness (dsh) — track your AI coding activity, lines of code, and time spent. Adapted from opencode-wakatime to dsh's plugin model.

Install

# Install from npm (requires dsh >= 0.1.3-alpha.2)
dsh plugin --profile web add @dingyi222666/dsh-wakatime
# Restart dsh web for it to take effect
dsh web

The plugin works in any profile that runs the agent loop — web, headless, acp, sdk, and the Desktop app's desktop profile — install it into each profile you use:

dsh plugin --profile headless add @dingyi222666/dsh-wakatime

Desktop app

The DeepSeek Harness Desktop application is an Electron shell around the same Web host, but it exclusively owns a separate profile ($DSH_HOME/profiles/desktop) and its own package state. Install the plugin there with the CLI bundled inside the app — an npm-installed dsh cannot mutate the Desktop profile:

# 1. Launch Desktop once so it initializes profiles/desktop, then fully quit it.
# 2. Run the bundled CLI (macOS path shown; Windows uses resources\runtime\cli\bin\dsh.cmd):
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add @dingyi222666/dsh-wakatime
# 3. Reopen Desktop; the bundle patch applies on the next boot.

The same command manages updates (add @dingyi222666/dsh-wakatime@latest), list, and remove <package>, and it keeps the shared Desktop profile lock and compatibility checks intact. Because both the Desktop host and its plugins run in the same Electron Node process, the tracked events and heartbeats are identical to the Web profile.

From source (GitHub)

git clone https://github.com/dingyi222666/dsh-wakatime
cd dsh-wakatime
pnpm install && pnpm run build
dsh plugin --profile web add .
dsh web

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-tts 下一个 Next dsh-cache-miss →