Introduction

The DSH ecosystem emphasizes “everything is a plugin”. When the DeepSeek Harness Web main window needs to add a “Work Role” tab and a “Pixel Office” floating layer, but you don’t want to modify the dsh source code, you can use dsh-ui-agents-pixe. It is maintained by EternalNight996 and has an MIT license.

Below is an introduction to the core features of this plugin, installation methods, and typical usage patterns.

What is it

dsh-ui-agents-pixe is a persistent client plugin for the DSH Web main window. It adds the “Work Role” tab and the “Pixel Office” floating layer to the main window: it includes 508 complete role cards (combining The Agency en 255 + agency-agents-zh zh 253), allowing agent to retrieve complete role cards by role name, as well as perform team orchestration.

The package.json specifies engines requiring node >=22 and uses the MIT license.

Core Features

Work Role Tab

  • Built-in 508 complete role cards: The Agency en 255 + agency-agents-zh zh 253
  • Supports search, Chinese/English switching, and partial classification selection

Pixel Office Floating Layer

  • Uses Canvas 2D procedurally generated pixel avatars, capable of standing, typing, and pacing
  • The floating layer is draggable, collapsible, and resizable
  • Clicking a character adds them to the lineup
  • Left-clicking any pixel character opens the complete role card

agents_pixe_roles Tool

agents_pixe_roles is registered by the host, allowing agent to retrieve complete role cards by role name.

By default, agents_pixe_roles / agents_pixe_team tools are not registered with prompt segments; they are pure local, zero token consumption when role tools and AI chitchat are turned off.

agents_pixe_team Team Orchestration

agents_pixe_team is used for team orchestration: the leader breaks down tasks, members open independent sub-agents to execute in parallel, and finally the leader aggregates the results.

Default member limit is 4, maximum is 6.

AI Chat

Pixel office dialogue can be connected to AI, supporting built-in AI or external interfaces.

Once enabled, it generates Chinese chitchat within 20 characters; it falls back if it fails or returns empty. After AI is enabled, it is limited by budget: a maximum of 60 real calls per hour and an estimated token limit of 60K; exceeding this triggers a fallback to canned dialogue.

Settings and Token Control

In the “Settings → Pixel Office” section, you can control:

  • Role Tool
  • AI Chat Toggle
  • Dialogue Frequency
  • Thinking Mode
  • Card Retrieval Granularity: Full Card / Rules Only / Artifacts Only

This plugin also includes real-time token display and budget control to display session usage and limit AI calls.

Installation and Enablement

First, run the installation command:

dsh plugin --profile web add dsh-ui-agents-pixe

Then restart dsh web for the initial installation to take effect.

The README explicitly warns: always use the dsh plugin command, do not use npx @deepseek-ai/dsh to install.

After the above steps, the “Work Role” tab appears on the chat page, and a collapsible Pixel Office floating layer appears in the dialogue area. It is declared as a persistent client plugin, using npm dual-package fallback and the cordis combined patch layer (dsh.bundle.patch), self-mounting, taking effect immediately upon installation, and not lost after restart.

If you need to install the visual plugin market, you can run:

dsh plugin --profile web add dshmarket

Typical Usage

Enable Role Tool or AI Chat

In “Settings → Pixel Office”, enable the Role Tool or AI Chat and select the card retrieval granularity:

  • Full Card
  • Rules Only
  • Artifacts Only

View Complete Role Card

Left-click any pixel character to open the complete role card.

Connect External AI Chat

Assign an asynchronous function in the page to take over dialogue:

window.__AGENTS_PIXE_CHAT__ = async (req) => 'Hello, human'

Programmatic Control of AI Chat

window.__AGENTS_PIXE_CHAT_API__.setEnabled(true)
window.__AGENTS_PIXE_CHAT_API__.setProvider(async (req) => '…')
window.__AGENTS_PIXE_CHAT_API__.isOn()

Use Team Orchestration

When using agents_pixe_team, the leader breaks down tasks, members open independent sub-agents to execute in parallel, and finally the leader aggregates. Default member limit is 4, maximum is 6.

Use Cases and Notes

Suitable for the following use cases:

  • Need to browse, search, and select built-in role cards in the DSH Web main window
  • Need to display selected roles in the form of a Pixel Office
  • Need agent to retrieve complete role cards by role name
  • Need zero token by default, with role tools, AI chat, or team orchestration enabled on demand

Notes:

  • The plugin runs with the current dsh process permissions; source code and license should be checked before installation.
  • There is a conflict in the README regarding the “Zhizi Kernel”: one place says v1.0.9 added system prompt injection, another says this plugin does not come with the Zhizi Kernel and does not inject system prompt. This article does not treat kernel injection as a confirmed feature.
  • Manually saved custom teams are stored in local localStorage.
  • AI-generated custom roles are saved in ~/.dsh/agents-pixe/custom-roles.json.

Links

GitHub: https://github.com/EternalNight996/dsh-ui-agents-pixe