In agent development workflows, explaining current code issues or recent changes is a common need. Such explanations usually rely on plain-text descriptions and lack intuitive, evidence-backed support. This article introduces the DeepSeek Harness plugin dsh-codegraph, which allows agents to generate verifiable architecture diagrams and present them in a sidebar.

What Is It

This is a DeepSeek Harness plugin maintained by hrhgit. Its core positioning is a “problem-driven code explanation plugin.” It delegates read-only investigation to subprocesses and ultimately presents focused, evidence-backed architecture scenarios in a structured way within the sidebar.

Core Features

  • Problem-driven explanation: The agent answers questions by delegating investigation to read-only subprocesses.
  • JSON output: The model only needs to submit JSON in the dsh-codegraph.scene.v1 format.
  • Sidebar display: The sidebar displays focused architecture scenarios, including node names, relationships, and a one-sentence conclusion.
  • Deterministic layout: The plugin uses fixed React components and a deterministic layout to ensure consistent presentation.
  • Viewer mode: The sidebar is a viewer, not a second chat window or free-form editor.
  • Validation and persistence: The plugin handles data validation and persistence on its own.

Installation and Enablement

The current resources do not provide a specific installation command. Obtain installation guidance through the following methods:

  1. Visit the skill library directory.
  2. Visit the GitHub repository to review development commands.

Typical Usage

When answering code-related questions, the agent submits structured JSON data directly to the plugin. After parsing, the plugin renders the corresponding architecture diagram in the sidebar.

Applicable Scenarios and Notes

  • Compatibility: Target compatibility with DeepSeek Harness 0.1.2-alpha.1 and better-sidebar 0.17.1.
  • Permissions: The plugin runs with the permissions of the current DSH process.
  • Source review: It is recommended to review the source code and license (MIT) before installation.

Summary

dsh-codegraph provides a standardized approach to converting code analysis into visual architecture diagrams. It uses fixed React components and a deterministic layout to ensure reproducible presentation results. For more details and source code, refer to the links below.