Introduction

The plugin ecosystem of DeepSeek Harness (DSH) allows developers to extend host capabilities. When handling complex tasks, a single agent is often insufficient, requiring multi-agent collaboration. The dsh-teams-x plugin provides a way to turn a single session into a coordinated multi-agent team: the leader spawns persistent member subagents, decomposes goals into a dependency-aware task DAG, coordinates through direct mailbox messages, and includes a real-time full-SVG activity panel.

Core Features

The plugin mainly includes the following capabilities:
* Multi-agent teams: Supports creating team structures with a leader and members.
* Dependency-aware task DAG: Decomposes large goals into a task graph with dependencies.
* Persistent mailbox: Supports intra-team communication through direct messages.
* Full-SVG activity panel: Provides a real-time full-SVG rendered activity view.
* Web plan editor: Supports editing plans in the web interface, including member roles/models and task rows.
* Team templates: Supports predefined team configurations for one-click creation.
* Automatic repair loop: Automatically derives repair tasks when a task fails.
* In-session team cards: Collapses team status into a card within the message stream.
* Quality gate contracts: Validates quality through contracts during task execution.
* 173 test cases: Includes a complete set of validation test cases.

Installation and Enablement

After installing the plugin, you must restart the host; the dsh plugin add command does not hot-load a new bundle.

Option A: One-command from the repository tgz (recommended)
The repository root includes a prebuilt dsh-teams-x-<version>.tgz with zero runtime dependencies.

dsh plugin --profile web add <仓库路径>/dsh-teams-x-<version>.tgz

Option B: npm

npm i dsh-teams-x && dsh plugin --profile web add <node_modules 路径>/dsh-teams-x

Option C: Build from source
Requires Node ≥ 24, pnpm ≥ 12, and a deepseek-harness source checkout on the same machine (direct build-time dependency).

# 1) 布局
git clone https://github.com/Mlte0907/dsh-teams-x.git && cd dsh-teams-x
ln -s <harness-checkout 绝对路径> deepseek-harness

# 2) 构建
pnpm install
pnpm build

# 3) 安装
dsh plugin --profile web add "$(pwd)"

Typical Usage

The tool namespace is teamsx_*, and the state directory is .teams-x.

Create a team

// 创建一个名为 smoke-test 的团队，包含一个成员 a1
teamsx_create({"name":"smoke-test","members":[{"name":"a1"}]})

Use a template
In the teamsx_create description, write profile=<template name> to create a team from the predefined configuration with one click.

Open the panel
Use the slash command in the input box:

/teamsx

Use Cases and Notes

  • Host version requirement: Natively targets DeepSeek Harness 0.2.0-rc.1 or later (peerDependencies >=0.2.0-rc.1).
  • Restart requirement: You must restart the host after installation to activate it.
  • API drift handling: Host API drift points are isolated in src/compat.ts.
  • Non-interference: It does not interfere with other team modes inside the host.
  • Permissions: The tools run with the current DSH process permissions.

The plugin maintainer is Mlte0907, and the license is MIT. You can view more details via catalog_url or github_url.