Preface¶
When using DeepSeek Harness (DSH) for agent development, tracking token consumption is foundational for cost control and performance optimization. Existing local logs often only record raw conversations and lack aggregate statistics. The dsh-token-stats plugin aims to address this issue by focusing on converting local session data into visualized statistics.
What Is This¶
dsh-token-stats is a DeepSeek Harness (DSH) plugin dedicated to token usage statistics. Maintained by Yinxe, it is designed to aggregate local session logs and provide quantitative analysis of token consumption.
Core Features¶
The plugin provides the following verified features:
1. Data Aggregation: Aggregates all local session logs and provides cumulative, peak, and continuous statistics.
2. Trend Analysis: Supports daily and weekly trend views.
3. Time Distribution: Provides hourly distribution data.
4. Visualization: Generates a GitHub-style yearly heatmap.
5. Model Breakdown: Provides a breakdown by model.
6. Views: Includes settings pages and a “Today” card in the sidebar.
Installation and Enablement¶
Because the README fetch failed, official specific installation commands are not provided. Please visit the GitHub repository for the latest installation instructions.
Typical Usage¶
No specific command examples or usage scenario descriptions are currently provided. Based on the feature list, users typically need to view the above statistics through the settings pages or sidebar in the DSH interface.
Applicable Scenarios and Notes¶
Suitable for developers who need to manage token consumption with fine-grained precision. Note: the plugin runs with the permissions of the current DSH process. Be sure to inspect the source code and license before installing.
Summary¶
By aggregating local logs, this plugin provides DSH users with an intuitive token statistics view. For more details, refer to: SkillHub Directory or GitHub Repository.