Preface¶
In DSH, agents work continuously across multiple threads. Active duration, model tokens, user inputs, and tool calls are usually scattered within session logs; while you can see them within a single thread, they are not intuitive when aggregating across threads and days. dsh-worktime-board is a DSH plugin designed to record these runtime metrics and display them by day, week, month, and academic year. It also converts accumulated workload into cultivation values and realms, providing a local dashboard for those running DSH for the long term.
What is this¶
dsh-worktime-board is maintained by spacexun2 and is licensed under MIT. It declares dependencies dsh.bundle.patch and dsh.client, with the client platform being web. The core purpose of the plugin is to aggregate the active duration, model tokens, user inputs, and tool calls of agents across threads, presenting the accumulated workload through cultivation values and twelve realms (Qi Refining → Primordial Chaos).
Core Features¶
Work Time Statistics & Cultivation Progress¶
The plugin records the active duration, model tokens, user inputs, and tool calls of agents in various threads and aggregates them into cultivation values. Night work, continuous activity, and breakthrough rewards are all counted towards the progress.
Daily / Weekly / Monthly / Academic Year Views¶
The daily view shows the 24-hour distribution. The weekly view summarizes total cultivation, active days, daily average cultivation, tokens, and time composition. The monthly view aggregates by natural weeks, supporting the viewing of duration, tokens, and cultivation values. The academic year calendar covers August 1st to July 31st of the following year, allowing users to view daily details.
Thread Attendance & Rankings¶
Thread attendance displays active periods by session and supports jumping to the corresponding thread. The Activity Leaderboard lists the top three most active contributors within the selected period.
Agent Query & Interfaces¶
The plugin registers the worktime_summary(range?, ranch?) tool, allowing threads and sub-agents to query daily, weekly, and monthly summaries. It also provides an interface:
GET /plugins/dsh-worktime/state?range=day|week|month
Installation & Enablement¶
Below are the verified GitHub source installation commands:
dsh plugin --profile web add github:spacexun2/dsh-worktime-board
After installation, restart DSH:
dsh web
If a plugin badge appears in the bottom right corner, the installation is successful. It also supports runtime injection via dsh-super-injector without requiring a restart:
dev_inject_plugin <plugin-directory>
Typical Usage¶
After installation, you can use it in the DSH web client as follows:
- View today’s or this period’s accumulated cultivation value, realm, duration, and tokens.
- Click the “Input Count” card to switch between “Input Count” and “User Input” metrics.
- Open the academic year calendar, click on any date to view that day’s realm, cultivation value, duration, calls, and tokens.
- View session active periods in Thread Attendance and jump to the corresponding thread.
- Ask threads or sub-agents to query summaries, for example:
Summarize this month's work hours and tell me the most active thread.
Data, Configuration & Notes¶
Data is stored locally:
$DSH_HOME/worktime-board/data.json
Data uses 5-minute slot activity bitmaps + call/token counters, with batch flushing every 60s. Configuration is located at:
$DSH_HOME/worktime-board/config.json
Configuration changes take effect with hot reload. The token metric explanation provided in the README is for v0.1.3: Input follows the billing input standard, 10,000 tokens = 1 point, and the final cultivation value is multiplied by 15 for display scaling.
Plugin data is entirely local, sends zero external data, and does not inject messages to disturb. Since it runs within DSH’s plugin mechanism and reads local $DSH_HOME data, you should check the source code and MIT license before installing.
Links¶
The directory page does not provide a verified URL. GitHub repository:
https://github.com/spacexun2/dsh-worktime-board