Preface

Developing agents in DeepSeek Harness (DSH) often involves work sessions bound to directories, tools, and permissions. While suitable for task execution, they are less ideal for long-term “chatting companionship” or organizing personal thoughts. Mixing companionship and work in the same session can blur memory boundaries—the assistant might retain content you didn’t intend to keep long-term, or inadvertently access files, shell, or other capabilities during companionship scenarios.

Below introduces Jingling, a DSH companionship plugin maintained by Yi-111-a (approximately 12 stars on GitHub, categorized under “Fun Cosmetics” in SkillHub). She resides in the local environment, offering reviewable memory, a browser companionship panel, and an optional transparent desktop pet for Windows. Actual work still requires switching back to the DSH standard session, where you select the directory and grant permissions.

What is This

Jingling is a companionship plugin in the DSH ecosystem, with the npm package name dsh-jingling. The current version is 0.1.0-alpha.19 (the desktop pet sidecar is jingling-sidecar@0.1.0-alpha.23), targeting DSH 0.1.0-rc.6.

She remembers only what you allow her to remember, accompanies you in organizing thoughts, but never secretly executes any operations on your behalf. The public name, npm package name, and interface are unified as 鲸灵 / Jingling / dsh-jingling; for compatibility with early preview versions, some underlying identifiers (plugin ID, RPC paths, preset directories, etc.) still use souldock, but this is not a second product.

  • SkillHub directory: https://www.skillhub.cn/plugins/Yi-111-a/dsh-jingling
  • Source code: https://github.com/Yi-111-a/dsh-jingling

Core Features

Reviewable Memory

She only remembers content you have confirmed. You can modify or forget at any time. Memory must be proposed first and then confirmed; it won’t quietly become a relationship archive.

Character Card Import

Supports Character Card V2 JSON. Imported content is read only as text and is never executed.

Browser Companion Panel

A gentle companionship panel within the DSH web interface.

Optional Desktop Companion (Windows Sidecar)

The DSH plugin includes a built-in desktop pet sidecar interface (state, long polling, chat). This repository also provides the source code for the Windows transparent desktop pet (sidecar/). After building, it can be launched with one click in the DSH web interface. The build output is sidecar/release/jingling-sidecar-*.exe.

Permission Isolation

Companionship and work are separated: actual work requires switching to the DSH standard session, where you select the directory and grant permissions. She does not have shell, file system, network, or MCP permissions.

Installation and Enabling

The following commands come from the official README and apply to a complete installation requiring the plugin and Windows desktop pet:

git clone https://github.com/Yi-111-a/dsh-jingling.git
cd dsh-jingling
.\install-all.ps1

The script automatically completes: installing plugin dependencies → testing/building the plugin → building the Windows desktop pet sidecar → packaging the plugin → installing to the DSH web profile → installing the agent preset.

After installation, start DSH:

dsh --profile web
# or
npx @deepseek-ai/dsh web

Create a new session, select the 鲸灵 · Jingling preset, send the first message, and she will appear; on the Jingling page, click “Open Desktop Companion” to display the transparent window desktop pet on your desktop.

Install from npm (Without Desktop Pet)

If you only need the browser companionship panel and not the desktop window:

dsh plugin --profile web add dsh-jingling
npm run install:preset

Note: npm run install:preset must be executed in the project directory after cloning the repository.

Manual Installation from Source Code

git clone https://github.com/Yi-111-a/dsh-jingling.git
cd dsh-jingling
npm install --ignore-scripts
npm run check
npm pack --ignore-scripts
dsh plugin --profile web add .\dsh-jingling-0.1.0-alpha.19.tgz
npm run install:preset
dsh --profile web

Create a new session, select the 鲸灵 · Jingling preset, send the first message to enable.

Building the Desktop Pet Sidecar Separately

If skipping the one-click script and wanting to build the Windows desktop pet separately:

cd sidecar
npm ci
npm run dist:win

After building, return to the DSH web Jingling page and click “Open Desktop Companion”. If the sidecar is not in the default location, you can specify sidecarExecutablePath in the DSH configuration.

Typical Usage

After completing the above installation steps, the typical workflow is as follows:

  1. Start DSH with the web profile.
  2. Create a new session and select the 鲸灵 · Jingling preset.
  3. Send the first message to open the companionship panel in the web interface.
  4. If you need a desktop presence, click “Open Desktop Companion” on the Jingling page.
  5. When you need to perform file operations, call tools, or use MCP, switch to the DSH standard session, select the work directory yourself, and grant permissions.

Character cards can be imported via Character Card V2 JSON, and the content is used only as text context.

Applicable Scenarios and Notes

Who is This For

  • Developers who want a quiet, non-invasive desktop companion in the DSH local environment.
  • Those who need to clearly separate “chatting/companionship/thought organization” from “work sessions with permissions.”
  • Users who want to display an optional transparent desktop pet on Windows while retaining the browser companionship panel.

Security Boundaries

The official documentation docs/SAFETY.md outlines the complete boundaries, key points include:

  • Does not access the screen, camera, microphone, clipboard, files, or browsing history.
  • Memory requires proposal first and then confirmation.
  • Does not have shell, file system, network, or MCP permissions.
  • Romantic style is only available after explicitly enabling adult settings locally and is not suitable for public services.

Pre-Installation Notes

The plugin runs with the current DSH process permissions. Before installation, you should read the source code and the MIT License; Jingling’s own code uses MIT, while the public repository and npm package only redistribute a single Jingling idle avatar authorized by the rights holder. Imported character cards, avatars, models, and voices remain subject to their respective licenses.

Node version requirement: ^22.19.0 || >=24.0.0 (see the engines field in package.json).

Currently, this is an alpha preview version (0.1.0-alpha.19), with the desktop pet sidecar primarily targeting Windows; other platforms primarily use the web companionship panel.

Conclusion

Jingling turns “companionship” in DSH into an independent, local-first, reviewable memory pathway: the web panel is always available, and Windows users can optionally add a transparent desktop pet; actual work remains in the standard session, where you control the directory and permissions.

  • SkillHub directory: https://www.skillhub.cn/plugins/Yi-111-a/dsh-jingling
  • GitHub repository: https://github.com/Yi-111-a/dsh-jingling

For more technical details, see docs/ARCHITECTURE.md and docs/PRODUCT.md in the repository.