Introduction

DeepSeek Harness (DSH) can be extended through plugins. For scenarios where users wish to record their local usage process as achievements that are replayable, presentable, and clearable, WJNCT55555/dsh-achievements provides a process-level global achievement system plugin.

Below is an introduction to its positioning, core features, installation methods, typical usage, and the permissions and licensing matters that need to be confirmed before installation.

What is this

dsh-achievements is a DeepSeek Harness plugin maintained by WJNCT55555, designed to provide a process-level global achievement system within DSH.

Its GitHub repository address is:

https://github.com/WJNCT55555/dsh-achievements

The license is MIT. The installation command uses the npm package name:

dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle

Core Features

Achievement Categories

The plugin provides 52 achievements, divided into ten categories:

  • Departure
  • Tool Master
  • File Craftsman
  • Orchestration
  • Objective
  • Skill
  • Model
  • Behavior
  • Linkage
  • Hidden

Achievement rarity covers:

  • Common
  • Rare
  • Epic
  • Legendary

The achievement gallery supports two viewing modes:

  • View by category
  • View by difficulty or rarity

The data dashboard includes:

  • Category progress donut chart
  • Monthly activity calendar heatmap
  • Rarity distribution segmented slider

Local Persistence

Achievement counts and unlock status are saved to:

~/.agent-achievements/state.json

Status is retained after restart.

Multi-Interface Display

The plugin supports multiple UI surfaces:

  • Unlock toast
  • Sidebar trophy
  • Input dock progress bar
  • Settings page gallery
  • Fullscreen gallery

Clearing Achievement Records

The plugin provides a button to clear achievement records, complete with a secondary confirmation dialog, allowing one-click clearing of all progress.

After clearing, all achievement progress will be wiped, but the anonymous statistics toggle and anonymous identifier will be preserved.

Hidden Achievements

Before a hidden achievement is unlocked, its name and description are displayed as ???.

Linkage Achievements

The linkage achievement “My Skin” (吾栖之肤) will automatically unlock when the dsh-deep-whale whale girl skin plugin is detected.

This linkage detection relies on whether dsh-deep-whale is installed.

Host-Side Interfaces

The host side provides read-only Remote and list_achievements tools.

Installation and Enablement

Installation via npm

Execute the following command:

dsh plugin --profile web add @wjnct55555/dsh-achievements-bundle

This command installs the DSH plugin bundle package.

Installation via git

First, clone the repository:

git clone https://github.com/WJNCT55555/dsh-achievements

Then execute the local installation command:

dsh plugin --profile web add ../dsh-achievements

Building from Source

To build from source, execute the following sequentially:

pnpm install --offline
pnpm exec tsc -b
pnpm exec tsdown
pnpm --filter @wjnct55555/dsh-client-ui-achievements bundle

Running Tests

Run achievement-related tests:

pnpm exec vitest run packages/extensions/achievements/tests/achievements.spec.ts

Typical Usage

Viewing Achievements

After installation, you can view achievements from the achievement gallery. The gallery supports viewing by category, as well as by difficulty or rarity.

Clearing Progress

Use the “Clear Achievement Records” button in the achievement management entry. The system will prompt for secondary confirmation; after confirmation, all achievement progress will be cleared.

Note: The anonymous statistics toggle and anonymous identifier will not be cleared.

Enabling Anonymous Statistics

Anonymous statistics is disabled by default. To enable it, first configure telemetryEndpoint for @wjnct55555/dsh-achievements in cordis.yml.

Example configuration is as follows:

# cordis.yml
- plugin: @wjnct55555/dsh-achievements
  config:
    telemetryEndpoint: https://your-endpoint.example

Replace https://your-endpoint.example with your actual endpoint address.

After configuration, open the anonymous statistics toggle in the achievement gallery settings. The toggle state will persist and be retained after a restart.

Once enabled, only the following are reported:

  • Achievement ID
  • Rarity
  • Random anonymous installation identifier

No network requests will occur if telemetryEndpoint is not configured, or if anonymous statistics are not enabled.

Deep Insight Layer

The Deep Insight Layer is opt-in and disabled by default.

Once enabled, it allows for regex matching and history session scanning of message bodies. Message body matching occurs only at runtime and is not persisted to disk.

Linkage Achievements

If you have installed the dsh-deep-whale plugin, dsh-achievements will automatically unlock the linkage achievement “My Skin” (吾栖之肤) after detecting it.

Applicable Scenarios and Notes

Suitable for users who wish to use plugin capabilities within DSH and want to locally retain achievement progress, gallery display, and clearable records.

Matters to note before installation:

  • The plugin runs with the permissions of the current dsh process.
  • You should check the source code and license before installation.
  • The license for this repository is MIT.
  • Zero upload by default.
  • The basic layer only reads leaf scalars such as tool name, success flag, agent id, event type, file path, and token count; it does not read message bodies, file contents, error details, or search results.
  • The Deep Insight Layer is disabled by default; regex matching and history session scanning of message bodies are only allowed after it is enabled.
  • Anonymous statistics is disabled by default; only achievement ID, rarity, and random anonymous installation identifiers are reported after it is enabled.
  • Clearing achievement records will wipe all progress, but the anonymous statistics toggle and anonymous identifier will be preserved.

Conclusion

dsh-achievements provides a set of locally persistent, presentable, clearable, and interactive achievement records for DSH. It defaults to zero upload and maintains an opt-in design for both the Deep Insight Layer and anonymous statistics.

GitHub repository:

https://github.com/WJNCT55555/dsh-achievements

Verified sources do not provide a directory page URL. It is recommended to check the source code and license before installation.