Preface¶

The plugin philosophy of DSH is “everything is a plugin”: common capabilities can be split into independent plugins and installed according to a profile. The community directory is an independent site, with no official affiliation to DeepSeek or High-Flyer, and is not equivalent to an official app store.

For developers who have long used DSH to let agents work, data such as turns, tool calls, new sessions, and daily activities are often scattered across different sessions. dsh-achievements provides an achievements and gamification layer for DeepSeek Harness (DSH), organizing these usage traces into queryable badges, share cards, and Agent Wrapped. It does not modify the core; it only listens to the official session/event events.

What This Is¶

dsh-achievements is a DSH achievements and gamification plugin. According to verified sources, the maintainer/repo owner is Blaczz, the license is MIT, and the repository address is:

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

The problem it solves is: without modifying the DSH core, it transforms cross-session usage records into queryable, shareable, and extensible achievement states, and provides an open SDK for third-party plugins to register achievements.

Core Features¶

68 Achievements¶

The plugin provides 68 achievements across three product lines:

• 7 five-tier lifetime growth lines
• 10 session behavior badges
• 20 session trajectory achievements

Achievement cards display icons, rarity, descriptions, progress, XP, and unlock time.

Real-Time Unlocks and Settings Page Dashboard¶

When new achievements are unlocked, the plugin pushes them to the browser via SSE, with a 30-second polling fallback; updates also occur on page refresh or visibility changes.

The achievements panel on the settings page includes:

• Profile card
• Rarity statistics
• Lifetime counters
• Badge wall

The badge wall is grouped by seven growth lines and special/trajectory chains, with support for all / locked / unlocked filters.

Share Cards and Agent Wrapped¶

The plugin provides share cards and Agent Wrapped.

Regarding privacy, share text, share cards, Agent Wrapped, and achievement chains only read aggregated counts, achievement metadata, persona, and levels; file paths and command strings never leave the engine.

Open SDK¶

Third-party Host plugins can register achievements via ctx.achievements.register / ctx.achievements.registerPack; client plugins can read state via ctx.achievementsState.

The verified sources do not provide complete registration code examples, so this article does not fill in the call parameters.

Zero Core Modifications and State Persistence¶

The plugin achieves zero core modifications: it only listens to official session/event events, all of which are read-only events, with no core patches.

State persistence is stored as JSON files in the DSH home directory; v1 state can be migrated losslessly.

Testing¶

The plugin core is a three-layer pure function pipeline, accompanied by 19 test files and 251 tests.

Installation and Enablement¶

Prerequisites:

• DSH’s dsh web must be available
• Node >= 22.19

When installing from GitHub, the command provided in verified sources is:

dsh plugin --profile web add "github:luumod/dsh-achievements#main"

After installation, the running dsh web process must be restarted.

When installing locally, follow these steps:

cd dsh-achievements && npm install --legacy-peer-deps && npm run build
npm pack --ignore-scripts

Then add it using the absolute path of the generated dsh-achievements-0.1.0.tgz:

dsh plugin --profile web add "/absolute/path/dsh-achievements-0.1.0.tgz"

Note: The installation command in the verified sources uses luumod, while the repository page owner is Blaczz. This article only transcribes the commands provided in the sources and does not judge whether they belong to the same publisher.

Typical Usage¶

1. After installation, restart dsh web, then use it normally; completing the first turn will unlock the first achievement.

2. Chat and let agents work: turns, tool calls, new sessions, and daily activities accumulate silently, with notifications appearing when new achievements unlock.

3. View the profile card, lifetime counters, badge wall, session reports, Agent Wrapped, and Share in Settings → Achievements.

4. View achievements on the badge wall by seven growth lines and special/trajectory chains, using the all / locked / unlocked filters.

5. Developers register achievements in Host plugins using ctx.achievements.register / ctx.achievements.registerPack; read state in client plugins using ctx.achievementsState.

Applicable Scenarios and Notes¶

Suitable for:

• Developers who have long used agents in DSH and want to view cross-session aggregates
• Users who want to turn tool calls, session behaviors, and trajectory data into queryable achievements
• Plugin developers preparing to extend third-party achievement packs based on the open SDK

Notes:

• The plugin runs with the same permissions as the current dsh process. Before installation, you should inspect the source code, dependencies, and license.
• The license is MIT.
• In the package.json peerDependencies from the sources, the version constraint for @deepseek-ai/cordis is truncated, making the full constraint unverifiable; before upgrading DSH or related dependencies, verify against the repository documentation.
• The sources do not provide complete developer SDK code; this article only lists the verified interface names and does not fill in call examples.
• The directory page URL did not appear in the verified sources, so this article does not provide a specific directory page link.

Conclusion¶

The value of dsh-achievements lies in transforming DSH usage traces into queryable achievement states: cross-session aggregation, real-time unlocks, settings page dashboard, share cards, and an open SDK, all while maintaining zero core modifications.

GitHub repository:

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

The directory page URL is not provided.