Introduction

The design philosophy of DeepSeek Harness (DSH) is “Everything is a plugin,” aiming to seamlessly integrate external service capabilities into AI workflows. In CI/CD scenarios, Jenkins is a commonly used build engine, but traditional integration methods often require writing additional scripts or manually triggering builds through APIs, lacking direct interactive capabilities with AI conversations.

The dsh-jenkins-panel plugin resolves this disconnect. It exposes 22 jenkins_* tools in DSH, enabling AI to directly trigger, query, and track Jenkins builds, and provides a visual interactive panel in the official DSH sidebar to close the loop between build status and log analysis.

Plugin Positioning

dsh-jenkins-panel is a DeepSeek Harness plugin for Jenkins, maintained by the developer developerdh. It primarily addresses two problems: first, it enables AI models to call Jenkins APIs; second, it provides developers with a visual sidebar panel for monitoring and managing build tasks.

Core Features

1. AI Tools (Host Side)

The plugin exposes 22 tools prefixed with jenkins_ on the Host side for direct invocation by AI models. These tools cover the entire build lifecycle:

  • Build Control: Trigger builds, query status, retrieve logs, view history, and download artifacts.
  • Task Management: Task search and intelligent resolution (pause and ask when multiple candidates are found).
  • Operational Actions: View queue status, clean workspaces, and test connections.
  • Persistent Records: After a successful trigger, it automatically writes trigger records to a registry, and the data is preserved across restarts.

2. Sidebar Panel (Client Side)

On the Client side, the plugin integrates with the official DSH sidebar to provide visual build management views:

  • Overview: Displays build records triggered from conversations, with real-time filtering by status and refresh support.
  • Task Tree: Switching between multiple Jenkins connections, multi-level collapsible tree structure, and task search.
  • Build Details: Real-time log scrolling (tail/segmented/auto-follow), artifact download, and workspace cleanup.

3. Automatic Failure Analysis

When the status of a conversation-triggered build becomes FAILURE, the plugin automatically pushes an analysis task brief to the triggering conversation. After examining the logs in AI read-only mode, it outputs a structured failure summary containing the conclusion, key errors, likely causes, and remediation suggestions. This feature can be disabled in the configuration.

4. Plugin Page Configuration (dsh 0.2.0+)

On the dsh plugin management page (versions 0.2.0+), the plugin can be configured directly through the plugins.bundle.config / plugins.row.config slots. It supports connection management, setting a default connection, and toggling the automatic failure analysis feature. Configuration is persisted to the profile patch.

Installation and Activation

Prerequisites: The dsh version must be 0.2.0-rc.2 or later (web profile), and it is no longer compatible with 0.1.x.

Installation Steps:

  1. Ensure that a compatible version of dsh is installed locally.
  2. Run the following command to install the plugin (explicitly specify a version, for example @0.2.0-rc.2 or @next):
dsh plugin --profile <name> add dsh-jenkins-panel@<version>

Activation and Configuration:

After installation, go to the “Jenkins Connections” section in the dsh settings page and configure the connection details (including URL, username, and timeout) as well as the Token for each connection. After reloading the page, you can find the plugin panel in the sidebar and the top bar entry point.

Typical Usage

  • Configure the connection: Configure and bind the Jenkins connection and Token on the settings page.
  • Trigger a build: In a DSH conversation, use tools such as jenkins_trigger to directly trigger a build.
  • Troubleshoot failures: After a build fails, view the build details in the sidebar, or wait for the AI-pushed analysis task brief.
  • Switch connections: In the task view of the sidebar panel, switch between different Jenkins connections to manage them.

Applicable Scenarios and Notes

This plugin is suitable for developers who need to manage Jenkins tasks directly within a DSH environment and want AI-assisted troubleshooting for build issues.

  • Version Compatibility: Be sure to use dsh version 0.2.0-rc.2 or later, and explicitly specify a version tag when installing (such as @0.2.0-rc.2). Avoid using the latest tag (it is currently broken and remains at 0.0.1-rc.1).
  • Permissions and Source: The plugin runs with the permissions of the current DSH process. Please verify the source code and license before installation.
  • Trademark Statement: Jenkins® is a registered trademark of LF Charities, Inc. This plugin is an independent third-party tool and is not affiliated with or endorsed by the official Jenkins project or LF Charities. The Jenkins icons used in the plugin are distributed under the CC BY-SA 3.0 license.

Conclusion

dsh-jenkins-panel deeply integrates Jenkins build capabilities into DeepSeek Harness through standardized tool interfaces and a visual panel, enabling AI to participate more directly in CI/CD processes. For more details, refer to the plugin directory or the GitHub repository.