Introduction

A plugin for DeepSeek Harness (DSH), focused on tabletop role-playing (TTRPG) and Dungeon Master (DM) scenarios. It provides neutral random resolution, session-isolated campaign configuration, and image asset management, addressing the challenges DMs face in multi-turn conversations when managing character sheets, world settings, state tracking, and reusing images.

Installation and Activation

Before installing, ensure the dependency plugin @changfenhuang/dsh-genui is installed; otherwise, the interface cannot be rendered.

dsh plugin --profile web add @changfenhuang/dsh-genui
dsh plugin --profile web add github:SiriusWJ/dsh-rp-tools

After installation, dsh web must be restarted for the plugin to take effect.

Core Features

All tools are registered only under the dm preset scope and are not visible to other presets.

Neutral Random Resolution (rp_random)

Supports dice expressions, ranges, weighted selection, and batch dice rolls.

Image Asset Library (rp_assets)

A session-isolated image asset library. Supports importing, reusing, and searching by tag/character. Image sources can be results returned by the host generate_image function or user-provided images.

Campaign Configuration

Session-isolated world settings, character sheets, random tables, macro tables, and prompt prefixes.

World Book and State Tracking (rp_lore, rp_state)

Supports world book entry management and tracking of scene/time/presence states.

PNG Storybook Import

Supports importing SillyTavern character cards into the session workspace and automatically switching to the dm preset.

Typical Usage

  1. Dice Rolling
    rp_random(dice: "2d6+3", count: 5)
  1. Image Import
    Import host-generated images or player-provided images into the asset library.
    rp_assets(action: "import", path: "<generate_image 返回的 savedTo>", label: "角色名", tags: "立绘")
  1. Character Sheet Management
    List or set character sheet information.
    rp_character(action: "list")
    // 或
    rp_character(action: "set", name: "玩家", appearance: "描述")
  1. World Book Processing
    rp_lore(action: "localize")
  1. Import Character Card
    In a DM session before the game starts, use the “📖 Import Storybook” feature.

Notes

  • Dependency: @changfenhuang/dsh-genui must be installed; otherwise, the UI cannot be rendered.
  • Image Generation: This plugin does not generate images and relies on the host’s dsh-image-gen plugin to provide generate_image / edit_image.
  • Permissions: All tools are registered only in the dm preset scope.
  • Restart: dsh web must be restarted after installation for changes to take effect.
  • Deletion: The image asset library cannot be deleted via tools and must be managed in the panel.
  • License: MIT