Introduction

DeepSeek Harness (DSH) extends the Web client as a plugin. dsh-client-ui-girlfriend is a DSH plugin maintained by dalintian, licensed under MIT. It transforms the DSH Web interface into a WeChat-style friend list and chat window while keeping the native interface available.

What is this

This is a chat plugin capable of managing multiple roles, generating portraits, and replying with context. The plugin’s npm package name is dsh-client-ui-girlfriend, and the repository address is https://github.com/dalintian/Digital-Sweet-Heart.

It primarily provides the following capabilities:

  • WeChat-style friend list and chat window
  • Add, edit, and delete multiple roles
  • Generate, regenerate, and save AI portraits based on text descriptions
  • Inject complete role settings into conversation prompts
  • Generate photos or short videos based on chat context
  • Upload photos for visual model analysis and contextual response
  • Configure four sets of OpenAI-compatible APIs (Conversation, Vision, Text-to-Image, Text-to-Video)
  • Automatically generate two sets of DSH configurations (web and girlfriend) and switch between them

Installation and Enabling

Runtime environment requirements:

Node.js >= 22
pnpm
Self-provided OpenAI compatible model interface

If DSH is not yet installed, obtain and build DSH first by following these steps:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build

After building, install this plugin:

pnpm dsh plugin --profile web add github:dalintian/Digital-Sweet-Heart

After installation, two sets of DSH configurations, web and girlfriend, will be generated. The plugin is added to the web configuration in a disabled state by default, so pnpm dsh web still launches the native interface. The girlfriend interface is launched using a separate configuration:

pnpm dsh web
pnpm dsh --profile girlfriend

The girlfriend interface defaults to port 3081.

If the postinstall script did not execute during installation, you can run it manually once:

node node_modules/dsh-client-ui-girlfriend/scripts/postinstall.cjs

If you are not using the dsh plugin command, you can also install manually:

cd ~/.dsh/profiles/web
pnpm add github:dalintian/Digital-Sweet-Heart
node node_modules/dsh-client-ui-girlfriend/scripts/postinstall.cjs

Upgrade and uninstall commands are as follows:

pnpm dsh plugin --profile web update github:dalintian/Digital-Sweet-Heart
pnpm dsh plugin --profile web remove dsh-client-ui-girlfriend

Initial Configuration

After entering the girlfriend interface, configure the four sets of model APIs in the configuration entry in the bottom left of the friend list:

  • Conversation Model
  • Vision Model
  • Text-to-Image Model
  • Text-to-Video Model

These four sets of interfaces require OpenAI compatibility. API keys are only stored in the browser’s localStorage and are sent only to the interface addresses configured by the user.

Typical Usage

  1. Add a role.

Add a new role in the friend list and fill in details such as name, appearance, personality, hobbies, tone of voice, and role background.

  1. Generate a portrait.

Generate a portrait based on the text description. You can regenerate it if you are not satisfied, and save it once you are satisfied. The role settings and portrait image are saved locally:

<DSH Main Directory>/storages/girlfriend/

Role settings are Markdown files and are readable in plain text.

  1. Conduct a conversation.

Every time you chat, the plugin injects the complete role settings into the model prompt to keep the response style consistent with the settings.

  1. Generate a photo or short video.

Based on the current chat context, you can generate a photo or a short video.

  1. Upload a photo.

After uploading a photo, the visual model analyzes the image content first, and then gives a response combined with the chat context.

  1. Manage roles.

You can edit existing role settings or delete roles.

Applicable Scenarios and Notes

This plugin is suitable for single-user scenarios on a local machine, especially for users already using DSH who want to extend the Web interface into a role-based chat interface.

Please note the following points:

  • The plugin runs within the local DSH process environment; you should check the source code and MIT license before installing.
  • The /girlfriend/* routes do not have authentication and are intended for single-user local use.
  • Currently verified on Windows only; macOS and Linux have not been tested on real devices.
  • Effectiveness depends on the self-provided OpenAI compatible model interface.
  • Role settings and portrait images are saved locally; files can be viewed and modified directly.

GitHub Repository:

https://github.com/dalintian/Digital-Sweet-Heart

If installing from the DSH plugin directory, please refer to the repository, version, and license information displayed on the directory page. This introduction uses the repository address above as the installation source.