Introduction

DeepSeek Harness (DSH) adopts an “everything is a plugin” extensibility model. dshgirl-starter provides a “Whale Girl” plugin for DSH, unifying the Whale Girl persona, desktop pet, balance widget, notes, scheduled reminders, long-term memory, and right-click questioning into a single plugin for use in DSH sessions and desktop interactions.

What is this

dshgirl-starter is an unofficial fan project with no affiliation or endorsement relationship with DeepSeek. The GitHub repository is:

https://github.com/FlyingFreeOwl/dshgirl-starter

The source code of this plugin is licensed under the MIT License; please refer to ASSET_LICENSE.md for the authorization details of the desktop pet visual assets.

Core Features

The following are verified feature points:

  • Whale Girl Persona Injection: PERSONA_LOAD
  • Desktop Big Fat Fish / Whale Desktop Pet
  • Bottom-right Balance Flying Fish Widget
  • Notes Functionality
  • Scheduled Reminders Functionality
  • Shared Long-term Memory Library
  • Right-click menu “Ask DSH”, creating a new session and displaying the reply
  • Low-token Memory Tools: dshgirl_recall_memory, dshgirl_save_memory

Installation and Setup

Verified runtime environment requirements:

node >=22.19
cpu: x64

Quick Start:

npm install
npx @deepseek-ai/dsh plugin --profile web install
npx @deepseek-ai/dsh web

This plugin optionally uses Python Helper. If you do not wish to use Python Helper, you can build the exe first.

Typical Usage

Right-click Menu

Available operations in the right-click menu include:

  • Ask DSH...: Create a new session and display the reply
  • Notes -> New Note: Create a note
  • Notes -> View Notes: View notes
  • Scheduled Reminders -> New Reminder: Create a scheduled reminder
  • Scheduled Reminders -> View Reminders: View reminders
  • Long-term Memory -> Write Memory: Write memory
  • Long-term Memory -> Search Memory: Search shared memory

Long-term Memory

Shared long-term memory library file:

~/.dsh/storages/dshgirl/memory.json

The DSH model can access this on-demand via tools:

dshgirl_recall_memory(keyword)
dshgirl_save_memory(key, value)

HTTP API

Available endpoints:

GET/POST /plugins/dshgirl/notes
GET/POST /plugins/dshgirl/reminders
GET/POST /plugins/dshgirl/memories
POST /plugins/dshgirl/memories/recall
POST /plugins/dshgirl/ask

Corresponding descriptions:

  • /plugins/dshgirl/notes: View/Create notes
  • /plugins/dshgirl/reminders: View/Create reminders
  • /plugins/dshgirl/memories: View/Write long-term memory
  • /plugins/dshgirl/memories/recall: Search long-term memory
  • /plugins/dshgirl/ask: Create a new DSH session and ask a question

Applicable Scenarios and Notes

  • Suitable for scenarios where the Whale Girl persona, desktop pet, balance widget, notes, scheduled reminders, and shared long-term memory library are used within DSH.
  • The plugin runs with the permissions of the current DSH process; you should check the source code and license before installing.
  • The source code is licensed under the MIT License; please refer to ASSET_LICENSE.md for the authorization details of the desktop pet visual assets.
  • Verified runtime environment requirements: node >=22.19, cpu: x64.
  • This project is an unofficial fan project with no affiliation or endorsement relationship with DeepSeek.

Conclusion

The value of dshgirl-starter lies in placing the Whale Girl persona, desktop interaction, balance widget, note reminders, shared memory library, right-click questioning, and low-token memory tools within a single DSH plugin.

The verified information does not provide a directory page URL; the GitHub repository is:

https://github.com/FlyingFreeOwl/dshgirl-starter