Introduction¶

When working on long sessions in the DSH Web client, it is often necessary to simultaneously view the current session’s token usage, context pressure, all historical messages, and files in the current workspace. This information is scattered across sessions, logs, and the workspace, making it inconvenient to check.

The following introduces dsh-workspace-inspector. It is a right-side panel plugin for the DeepSeek Harness (DSH) Web client that concentrates and displays the current session’s token usage, all historical message directory, context pressure, and workspace file tree in a right-side details column. It supports macOS / Windows / Linux across platforms.

What is it¶

First, the positioning: dsh-workspace-inspector is a DSH Web client plugin maintained by GIGHT111 with an MIT license.

The problem it solves is: within the same session, quickly verifying session-level tokens, context state, historical message positions, and workspace file status. From the description above, its value is concentrated on “centralized viewing in the right-side panel” rather than replacing the main conversation flow.

Core Features¶

Token Usage¶

Displays the current session’s token usage in the right-side details column, including input, cache reads, output, and their respective percentages. These data come from the tokenUsage projection.

All Historical Messages Directory¶

Displays the directory of all historical messages. The directory is reconstructed from the host replaying the session’s persistent logs, supports collapsing and expanding, and displays summaries and the number of tool calls.

Clicking an entry jumps to the corresponding message line and highlights it. The message directory summary is derived via heuristic text extraction, not generated by an LLM. If the target message line has not yet been loaded in the conversation view, it will prompt to load earlier history first.

Context Pressure¶

Displays context pressure, including the estimated number of tokens for the next request, the context window capacity, and the percentage occupied. These data come from the contextPressure projection.

Workspace File Tree¶

Displays the workspace file tree: with the current session’s workspace as the root, directory lazy loading, supports expand/collapse, and file sizes are displayed.

Clicking a file opens it with the system default application. The panel supports a toggle for hidden files and a refresh function.

Right Side Column Toggle¶

Supports closing and reopening the right-side column. After closing with ✕, it can be reopened via the “📊 Overview” button in the session header, and native drag-and-drop resizing of the split pane is restored.

This plugin masks the default right DetailsPanel with a lower priority and automatically opens when a session exists; it restores the original state after uninstallation.

Installation and Enablement¶

First, ensure the environment has dsh installed and pnpm is in the PATH. Then execute the following GitHub installation command:

dsh plugin --profile web add github:GIGHT111/dsh-workspace-inspector

After installation, you need to restart the web profile to activate it:

dsh --profile web

Typical Usage¶

Local Path Installation¶

If you already have a local plugin directory, you can install using a local path:

dsh plugin --profile web add /path/to/dsh-workspace-inspector

tgz Package Installation¶

If using a packaged file, you can execute:

dsh plugin --profile web add /path/to/dsh-workspace-inspector-0.1.0.tgz

Building and Testing¶

After modifying the plugin code, you need to rebuild and refresh the page; if the manifest or line structure changes, you need to restart the web profile again.

The build and test commands are as follows:

npm install && npm run typecheck && npm run build && npm run test:host && npm run test:client

Configuring Directory Entry Limit¶

You can configure workspace-inspector.config.maxEntriesPerDir in the profile’s cordis.patch.yml to limit the maximum number of entries returned per directory layer. The example value is 1000:

- id: workspace-inspector
  config:
    maxEntriesPerDir: 1000

Applicable Scenarios and Notes¶

Suitable for developers who need to track DSH Web session context, message history, and workspace files over the long term.

You should check the source code and MIT license before installing. This plugin runs with the permissions of the current dsh process and involves reading workspace files, opening files, and localhost HTTP routing, so it is only recommended to use it in a trusted environment.

Please be aware of the following boundaries:

File tree routes are limited to absolute paths under host cwd or registered workspace roots; case-insensitive on Windows.
The file tree is read via localhost HTTP routing; both list and open routes use Cache-Control: no-store.
Security Note: Do not expose the 3080 port in an untrusted network environment.
Message directory navigation depends on the corresponding message line being loaded in the conversation view; if not loaded, it will prompt to load earlier history first.
After modifying code, you need to rebuild and refresh the page; if the manifest or line structure changes, you need to restart again.

Conclusion¶

dsh-workspace-inspector concentrates the current session’s token usage, context pressure, all historical message directory, and workspace file tree into the DSH Web client’s right-side panel, making it suitable for quickly verifying status during long sessions and workspace operations.

Relevant links from the installation command and repository identifier can be used to find the directory page and repository:

Directory Page: https://www.skillhub.cn/plugins/GIGHT111/dsh-workspace-inspector
GitHub Repository: https://github.com/GIGHT111/dsh-workspace-inspector

dsh-workspace-inspector: Right-side Overview Panel of DSH Web Client