DeepSeek Harness Plugin Guide: Install Community Plugins & Build Custom Ones

DeepSeek Harness Plugin Mechanism

DeepSeek Harness is built on the Cordis meta-framework. Every capability — model adapters, tool registry, session logs, agent loops, and the Web UI itself — is a pluggable plugin. This design lets users swap models, tools, or interaction modes by installing or replacing plugins. Within a week of launch, thousands of community plugins tagged dsh-plugin appeared on GitHub.

Finding and Installing Community Plugins

2.1 Discovering Plugins

Search GitHub for the dsh-plugin topic (https://github.com/topics/dsh-plugin). Quality varies because anyone can tag a repo. The author recommends Awesome DeepSeek Harness Plugin (https://awesome-dsh-plugin.com/zh/), a community-maintained directory with categorized, higher-quality plugins.

2.2 Global Installation of DeepSeek Harness

Install globally to use the dsh command directly:

npm install --global pnpm
npm install --global @deepseek-ai/[email protected]

Verify with dsh --version; launch the Web UI with dsh web.

2.3 Installing a Plugin via Command Line

Example: install dsh-deep-whale (from https://github.com/NanmiCoder/dsh-agent-teams/tree/main) by following its README. Alternatively, from Awesome DeepSeek Harness, open the plugin page (e.g., dsh-agent-teams) and run the listed command.

If unfamiliar with CLI, paste the plugin's GitHub URL into DeepSeek Harness; the model reads the README, determines the install command, and executes it. Then restart with dsh web.

Three Recommended Plugins

3.1 dsh-web-ui

Enhances the native Web UI with a task board, Git management, workbench, status info, themes, and a desktop pet. Install:

dsh plugin --profile web add @linxin666/dsh-web-all@latest

If pnpm v10+ blocks build scripts (error shows cloudflared, cpu-features, node-pty, ssh2), run: dsh plugin --profile web approve-builds Select a (approve all) then y to confirm, then re-run the install command. After dsh web, the enhanced UI appears with a task board that tracks task progress visually.

3.2 dsh-agent-teams

Adds multi-agent collaboration: a Captain agent splits tasks, delegates to member agents, and aggregates results. Install:

dsh plugin --profile web add --save-exact @nanmicoder/[email protected]

Example: build a 3D web chess game with three members: - Code Agent: writes game logic, interaction, animations - Code Quality Agent: checks structure, dependencies, maintainability - Security Agent: scans for secrets, dependency risks, vulnerabilities

The activity panel shows three sub-agents working in parallel; results merge back to Captain for a final report. The team persists across sessions unless explicitly deleted. Best for complex, planning-heavy tasks; small tasks incur unnecessary wait time and token cost.

3.3 dsh-market

A plugin to discover other plugins. Install:

npx @deepseek-ai/dsh plugin --profile web add @dsh-market/plugin

Features: personalized recommendations based on installed plugins, and keyword search (e.g., ui finds UI plugins) with one-click install.

Creating a Custom Plugin with Natural Language

Switch to Creation Mode , set reasoning to maximum, enable full permissions. Example prompt:

请为deepseek harness web创造一个新的cordis插件：该插件可以将deepseek harness web 左侧边栏上方的deepseek harness名称修改为智能工作台，请帮我实现该插件

DeepSeek Harness generates a dynamic plugin that modifies the sidebar title. Click the checkmark to apply; the change appears immediately but lasts only for the current session.

To persist, continue the conversation:

我想将该插件创建为一个本地的deepseek harness web的插件包，以后每次加载deepseek harness web会默认加载该插件，请帮我实现

The system creates a local plugin package named dsh-plugin-smart-workbench with a README documenting purpose, install, and uninstall steps. The modification now loads automatically on every dsh web launch.

Summary

This article covered the Cordis plugin foundation, plugin discovery (GitHub topic search and Awesome DSH Plugin), installation methods (CLI and natural-language), three practical plugins (dsh-web-ui for UI enhancements, dsh-agent-teams for multi-agent workflows, dsh-market for plugin discovery), and a step-by-step demonstration of creating and persisting a custom plugin via natural language. The next installment will explore Cordis registration, dependency, and lifecycle internals.