dsh-achievements
DeepSeek Harness 成就与游戏化插件：为回合、工具调用、会话和每日连续使用提供跨会话徽章，并配备徽章面板、解锁提示和 ctx.achievements 服务。无需修改核心代码。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Blaczz/dsh-achievements#cd4aa25e0bc7bf2f497ac1a3fd11e798e21eb4b5Achievements 以 dsh-achievements 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A gamification layer for DeepSeek Harness (DSH): 68 achievements across seven five-tier growth lines, session behavior badges and trajectory chains — with real-time unlock toasts, a badge wall in the settings page, shareable cards, Agent Wrapped and a public SDK for third-party packs. Zero core changes.
| Achievements panel: profile card, rarity stats, lifetime counters and the grouped badge wall | Expanded cards: icon, rarity, description, progress, XP and unlock timestamp |
|---|---|
| Achievements panel | Achievement cards |
common → uncommon → rare → epic → legendary), 10 session behavior badges, and 20 session trajectory achievements across four extra chains (one of them fully hidden). Every unlock earns XP, raises your level and persona, and is timestamped on the badge wall.session/event seam: turn/end, step/start, assistant/message, step/end, tool/call, tool/result, and Code Mode's tool/code-dispatch. All read-only events; no core patches, no forks of the runtime.profile + per-session buckets) persists as a JSON file in the DSH home directory; v1 states migrate losslessly. Lifetime counters live on the profile and never depend on the 64-session retention window, with a conservative lower-bound backfill on upgrade; already-satisfied milestones are silently reconciled at startup (no reducer, no session attribution, no broadcast).step/start, assistant/message, step/end, settled tool calls); per-token chunks are never consumed or persisted.ctx.achievements.register / registerPack and share the exact same evaluation path as the built-ins; duplicate ids throw immediately. Other client plugins read state through ctx.achievementsState.Achievements fall into two tracks. Each of the seven lifetime growth lines has five tiers, always common → uncommon → rare → epic → legendary (new-milestone XP: 10 / 30 / 75 / 175 / 400):
| Line | Common | Uncommon | Rare | Epic | Legendary | |---|---|---:|---:|---:|---:|---:| | 🎬 Turns | 1 | 25 | 50 | 100 | 500 | | 🔧 Tool calls | 1 | 25 | 100 | 500 | 2000 | | 💬 Sessions | 1 | 10 | 50 | 200 | 500 | | 🌅 Active days | 1 | 7 | 30 | 100 | 365 | | 📖 File reads | 10 | 100 | 500 | 2500 | 10000 | | ✏️ File edits | 1 | 10 | 50 | 250 | 1000 | | 🧪 Test runs | 1 | 10 | 50 | 250 | 1000 |
Special achievements — daily streaks (streak-3 / streak-7), the early ten-turns bonus, and ten per-session behavior badges:
| Achievement | Condition |
|---|---|
| 🔁 Déjà Vu | edit the same file 5 times in one session |
| 🕳 Rabbit Hole | read 20 files before your first edit |
| 💣 YOLO | edit 8 files before your first test |
| 🔥 It Works Eventually | pass after 5 failed tests |
| 🎰 Surely This Time | same test command fails 5 times in a row |
| 🎯 One Shot | pass the first test after a single edit |
| 📚 Librarian | read 30 distinct files in one session |
| 🌱 Touch Grass | 100 tool calls in one session |
| 🦴 Dependency Archaeologist | read a file inside a dependency directory |
| 🗿 Gigachad | read, edit and pass a test within 5 tool calls |
P7 trajectory chains (20 achievements, rarity strictly common → uncommon → rare → epic → legendary, XP 10 / 20 / 40 / 70 / 120). They read only low-frequency boundaries and never persist per-token chunks:
| Chain | Metric | Five thresholds |
|---|---|---|
| 💬 Session Marathon | distinct closed-step turns in one session | 5 / 20 / 50 / 100 / 200 |
| 🪜 Turn Depth | closed steps within a single turn | 5 / 20 / 50 / 100 / 500 |
| 🔧 Tool Barrage | settled tool calls within a single step (incl. Code Mode sub-calls) | 5 / 10 / 25 / 50 / 100 |
| ⏳ Time Anomaly | single model-request think duration (step/start → assistant/message, hidden) | 30s / 100s / 300s / 500s / 1000s |
DSH session/event (turn/end, step/start, assistant/message, step/end, tool/call, tool/result, tool/code-dispatch)
→ src/events.ts classifier — raw payload → standardized AchievementEvent + ToolSummary
→ src/reducer.ts reducer — pure reduceState: profile counters + per-session behavior + P7 facts
→ src/achievements.ts evaluate — applyEvent: buildContext + evaluate every still-locked def
→ src/index.ts Host — persist JSON → SSE push (unlock) + read-only HTTP API; startup reconcile
→ src/client/ Browser — EventSource + 30s polling → badge panel + unlock toasts
The three layers are fully decoupled and independently unit-tested; the rules layer never reads raw Harness tool payloads. The browser bundle can only import modules that are safe for it (a purity gate in tsdown.config.ts blocks any node:* import from leaking in).
Prereqs: DSH (dsh web works), Node ≥ 22.19.
# From GitHub (prebuilt lib/ is committed, no allowBuilds needed)
dsh plugin --profile web add "github:Blaczz/dsh-achievements#main"
# From a local checkout (npm pack is the reliable path on Windows; avoid `link:`)
cd dsh-achievements && npm install --legacy-peer-deps && npm run build
npm pack --ignore-scripts
dsh plugin --profile web add "<absolute path to>\dsh-achievements-0.2.0.tgz"
Restart dsh web after installing, then just use it — the first completed turn unlocks the first achievement (all counting rides the official event seam, so simply chatting works).
??? until unlocked;ctx.achievements SDKRegister your own achievements from a Host plugin — built-ins and third-party packs share one evaluation path and one registry (duplicate ids throw):
export const inject = ['achievements']
export function apply(ctx: Context): void {
ctx.achievements.register({
id: 'python-first-run',
icon: '🐍',
title: { zh: '蟒蛇出洞', en: 'First Python Run' },
description: { zh: '首次运行 Python', en: 'Run Python for the first time' },
rarity: 'uncommon',
xp: 20,
scope: 'session',
evaluate: ctx => ({ unlocked: ctx.session.toolCalls >= 1 }),
})
}
Or register a whole pack: ctx.achievements.registerPack({ id, version, name, achievements }). Registrations reconcile immediately, so an already-satisfied lifetime pack unlocks without waiting for the next live event. See docs/SDK.md for the full guide and examples/python-pack.ts for a runnable pack.
On the browser side, other client plugins read state via ctx.achievementsState.refresh() / ctx.achievementsState.unlockedIds().
npm install --legacy-peer-deps
$env:DSH_NODE_MODULES = "$env:USERPROFILE\.dsh\profiles\node_modules" # PowerShell; local runtime symlinks
npm run setup:dsh-workspace
npm run verify # ★ one-shot gate: clean + typecheck + test + build (incl. the browser purity gate)
npm test # vitest — 19 files / 251 tests (engine rules, streaks, idempotency, SDK, manifest…)
Note: if
npm run buildfails withFailed to import module "unrun", runnpm install --no-save unrunonce (tsdown optional peer, Node ≥ 22.19 recommended).
dsh-achievements/
├── package.json # dual contract: dsh.bundle.patch + dsh.client
├── cordis.patch.yml # bundle patch layer
├── tsdown.config.ts # client bundle + browser purity gate
├── scripts/ # build / clean / setup-dsh-workspace / verify
├── docs/SDK.md # third-party authoring guide
├── examples/python-pack.ts # runnable sample pack
├── src/
│ ├── index.ts # Host half: event wiring, registry, persistence, HTTP + SSE, SDK
│ ├── events.ts # ★ event classifier (standard AchievementEvent + ToolSummary)
│ ├── reducer.ts # ★ pure reducer (reduceState / buildContext)
│ ├── achievements.ts # ★ pure engine (applyEvent) + domain model + 68 built-ins
│ ├── state.ts # State v2 (profile + sessions), migration, JSON persistence
│ ├── sdk.ts # createAchievementRegistry + AchievementPack
│ ├── gamification.ts # levelOf / xpForLevel / RARITY_META (browser-safe)
│ ├── profile.ts # Profile ViewModel + persona + rarity summary (browser-safe)
│ ├── share.ts # share cards / Agent Wrapped / chains (browser-safe, privacy-safe)
│ ├── api.ts # API path constants + SSE frame format (browser-safe)
│ └── client/ # Browser half
│ ├── index.ts # apply: ctx.achievementsState + polling + SSE + slot injection
│ ├── achievements-client.ts # state HTTP client
│ ├── badge-panel.tsx # badge wall (settings.section), grouped from the chain model
│ ├── toast.ts # unlock toast (zero-dependency DOM)
│ └── unlock-tracker.ts # toast baseline dedup (pure)
└── tests/ # 19 spec files: classifier / reducer / evaluate / state / SDK / chains…
dsh-soundscape — Host drives a pure engine off the official event seams; the browser half is a client plugin (settings.section + state polling).ctx.effect registrations. A fork of Blaczz/dsh-achievements, extended with behavior + trajectory achievements, the SDK and the sharing layer.repository points at the canonical Blaczz/dsh-achievements; the bundle entry id (cordis.patch.yml) is the plugin-owned dsh-achievements, kept distinct from the approved-catalog ids (achievements / ui-achievements are used by the older @wjnct55555/dsh-achievements-bundle), so this package registers additively without impersonating another entry.dsh.compatibility declares the DSH range, the Node range, and exact per-release records under dshReleases. A record is only set to compatible after a real disposable-profile run against that exact release; other releases stay unknown.scripts/store-evidence.mjs <dshVersion> boots an isolated profile (fresh temp $DSH_HOME, pinned official @deepseek-ai/dsh@<dshVersion> + @deepseek-ai/dsh-web-app@<dshVersion>), installs the packed tarball, verifies the composed config, boots the web app headless until it listens, then uninstalls and removes the profile. Captured runs:
docs/store-evidence-0.1.5-alpha.1.md — install / start / uninstall passed on @deepseek-ai/dsh@0.1.5-alpha.1.MIT © 2026 Blaczz (upstream). An independent community plugin, not affiliated with DeepSeek Harness.