Preface

In the plugin ecosystem of DSH (DeepSeek Harness), Agents work with a fixed persona by default. If you wish to switch to the tone and behavior of a specific role while retaining capabilities such as writing code, researching, and reading files, you need a role layer that can be toggled on and off globally.

dsh-cosplay is designed for this need: it is a DSH plugin that uses a global switch to enable roleplay for the Agent and provides character card import/export capabilities aligned with SillyTavern (Tavern) v2 specifications.

Here is the background: DSH’s philosophy is “Everything is a plugin”; the community directory is an independent site with no official affiliation to DeepSeek / Hypothesis, and should not be regarded as an official app store.

What is it

  • Plugin Name: dsh-cosplay
  • Maintainer: ZelinW1
  • License: MIT
  • GitHub: https://github.com/ZelinW1/dsh-cosplay

One-sentence positioning: Let the DeepSeek Harness Agent play any role.

Once enabled, the Agent will converse with the selected character’s persona, tone, and behavioral guidelines, while retaining Agent capabilities: writing code, researching, and reading files will remain normal.

Core Features

  1. Global Switch
    The settings page allows one-click on/off. When on, all sessions enter roleplay; when off, the default persona is restored immediately, taking effect in the next round of dialogue. Default is off.

  2. Thinking Style
    Default is neutral thinking: the model maintains professional analysis while thinking, only roleplaying in the reply.
    You can also switch to role-playing thinking. Role-playing thinking is probabilistically triggered and may affect Agent task capabilities; only applicable to DeepSeek v4.

  3. Character Card
    Aligned with SillyTavern (Tavern) v2 specifications, supports importing/exporting standard v2 JSON.

  4. Natural Language Card Creation
    Can let the Agent search for settings, organize them into a card, and write to the character library.

  5. Built-in Default Character
    Includes a default character: Blue Big Fat Fish (Kujira), which can be used directly after installation.

  6. Plugin-specific Fields
    style, rules, behavior are stored with the character card. When exporting, these fields are put into v2’s extensions.

Installation and Enablement

Installation command:

dsh plugin --profile web add dsh-cosplay

Restart dsh after installation.

This requires pnpm to be in PATH; on Windows, ensure pnpm.cmd is available.

Runtime dependencies need to be installed additionally:

@deepseek-ai/schemastery

The following dependencies are parsed by dsh itself and do not need to be installed separately:

cordis
dsh-settings
dsh-tools
dsh-system-prompt
dsh-typert-protocol

Typical Usage

  1. Open settings, go to “Roleplay”, and turn on the switch.
    The switch is off by default.

  2. Select a character.
    The default character is Blue Big Fat Fish (Kujira). You can also create new ones, import them, or ask the Agent to generate a character card for you.

  3. Start a normal chat in a new session.
    Starting from the next round of dialogue, the Agent will be that character.

  4. To switch characters:
    - Click “Set as Current” on the settings page; or
    - Ask the Agent to use cosplay_switch in the chat.

  5. To restore the default persona:
    Turn off the “Roleplay” switch.
    After turning it off, the default persona is restored in the next round of dialogue.

Development Check

If you only want to run a syntax check, you can run:

npm run check

dsh-cosplay is a pure JS ESM project with no build steps. After modifying src/, restart dsh for changes to take effect.

Applicable Scenarios and Notes

Suitable for:

  • You are already using DSH and want to add a globally toggleable role layer to the Agent;
  • You want the Agent to retain capabilities like writing code, researching, and reading files while roleplaying;
  • You need interoperability with SillyTavern (Tavern) v2 character card import/export;
  • You want to use natural language to let the Agent search for settings, organize character cards, and write to the character library.

Notes:

  • The license is MIT;
  • Role-playing thinking is probabilistically triggered and may affect Agent task capabilities; only applicable to DeepSeek v4;
  • The roleplay switch is off by default; after turning it off, the default persona is restored in the next round of dialogue;
  • Installing dependencies requires pnpm to be in PATH; on Windows, ensure pnpm.cmd is available;
  • The plugin runs with the permissions of the current dsh process; check the source code and license before installing.

Links

GitHub: https://github.com/ZelinW1/dsh-cosplay

Directory Page: DSH Community Directory (independent site, not an official app store). Verified data does not contain a verifiable directory page URL, so this article does not provide a specific link.