cleverer-dsh
适用于 DeepSeek Harness 的执行规范插件套件：防卡死重试拦截、强制反思、待办事项规范、记忆去重以及自我演进技能。零依赖，绝不接触 DSH 源码。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Classicoke/cleverer-dsh#40bd216ea9c7a95da887aa97fb661a0e8c7b1dd2Cleverer Dsh 以 cleverer-dsh 发布，当前版本为 1.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →English | 中文
A plugin suite that makes DeepSeek Harness (DSH) actually smart — execution discipline, practical tools, and a skill library, installed in one shot.
| Icon | Feature |
|---|---|
| ⚡ | Faster & cheaper (measured): same task vs bare DSH — 49% faster, 44% fewer estimated tokens (small sample, not yet broadly tested) |
| 🧠 | Execution discipline: automatic failure interception, forced reflection, task-planning reminders, memory dedup, experience auto-distilled into skills |
| 🛠️ | Ready-made tools: instant multi-directory file lookup + 9-point environment health check — stop guessing |
| 📦 | One-command install/uninstall via DSH's own plugin manager |
| 🧪 | 478 unit tests green, statement & line coverage 100%; pure code, zero dependencies, never touches DSH itself |
| 📚 | 6 built-in skills: 6-step error handling, error lookup table, fast file lookup, root-cause debugging, local-first, plan-before-execute |
We ran the same real task (analyzing a software packaging log) on DSH with this suite vs a bare DSH (nothing installed):
| Metric | With suite | Bare DSH | Diff |
|---|---|---|---|
| Total time | 8.6 min | 12.8 min | 49% faster |
| LLM calls | 51 | 61 | -20% |
| Tool calls | 59 | 67 | -14% |
| Estimated total tokens | ~41,000 | ~73,000 | 44% fewer |
| Reasoning chunks | 401 | 1,163 | -65% |
What you notice in practice: with the suite, the agent stops retrying the same broken approach (it automatically switches), distills working commands into reusable scripts, and asks you before acting at key decision points. Bare DSH retried the same problem 13 times, never distilled anything, and never consulted you.
⚠️ Disclaimer: n=1 per group; tokens are character-estimated (±20%); not broadly tested yet — the direction is evidenced, exact numbers await more samples and real API billing data.
DSH is full-featured but not smart by default: empty system prompt, stubborn retries on failure, skills installed but never used, todo tool ignored. This suite fixes it:
| Layer | What it does |
|---|---|
| Discipline layer (8 plugins) | failure interception, forced reflection, task planning, memory dedup |
| Hub (discipline-hub) | shared failure log + reminder throttling — plugins don't collide, issues are traceable |
| Tools layer (2 plugins) | instant file lookup, env health check |
| Skill layer (6 skills) | on-demand auto-loading — know what to do on errors, find things fast |
cordis.patch.yml
├─ discipline-hub hub (failure log / reminder throttle / turn stats)
├─ anti-stuck stuck-loop guard: no repeat same-arg retries, force new approach
├─ dsh-env-triage problem tracing: stop & report when several schemes fail
├─ dsh-plan-discipline task planning: remind to create a plan for multi-step tasks
├─ dsh-memory cross-session memory: auto-dedup, anti-bloat
├─ skill-evolver experience distillation: failure → solution → saved skill
├─ dsh-discipline 11 execution rules injected every turn
├─ dsh-skill-loader skill usage boost: on-demand catalog + keyword summoning
├─ dsh-skill-provider runtime skill registry: the 6 bundled skills resolve in-package
├─ dsh-cordis-discipline dynamic-plugin guardrail: no run before define, no undefine before stop
├─ dsh-fast-locate file lookup: parallel multi-directory scan
└─ dsh-env-check-tool env health check: 9 checks
cordis.patch.yml (home patch)
├─ discipline-hub hub, loaded first (failure log / reminder throttle / turn stats)
├─ cordis:include → discipline-board.cordis.yml (8 discipline plugins)
│ ├─ anti-stuck stuck-loop guard
│ ├─ dsh-env-triage problem tracing
│ ├─ dsh-plan-discipline task planning
│ ├─ dsh-memory memory dedup
│ ├─ skill-evolver experience distillation
│ ├─ dsh-discipline 11 execution rules
│ ├─ dsh-skill-loader skill usage boost
│ └─ dsh-cordis-discipline dynamic-plugin guardrail
└─ cordis:include → tools-board.cordis.yml (2 tool plugins)
├─ dsh-fast-locate file lookup
└─ dsh-env-check-tool env health check
The board layout makes plugin cooperation structural: the discipline group shares the hub's unified failure log and reminder pipeline, working as one suite instead of in isolation.
Prerequisites: DSH installed and initialized; pnpm available (DSH's plugin manager).
Choose before you install — the two options differ in how plugins are organized:
| Option 1: plugin manager (official) | Option 2: script install | |
|---|---|---|
| Command | dsh plugin add ... | paste one PowerShell line |
| Plugin organization | all plugins in one inline config | grouped into discipline-board (discipline) + tools-board (tools) boards |
| Plugin cooperation | plugins work independently | stronger — discipline plugins share one failure log & reminder pipeline, working as one suite |
💡 Why boards are the better architecture: the plugins are not meant to work in isolation — one traces the root cause, one distills the lesson, one reminds you to plan. Boards make this cooperation a structural guarantee (plugins belong to the same group and share the same facilities by construction) instead of leaving it to chance. Discipline and tools are physically separated with clear boundaries, so adding your own plugin later has an obvious home; groups start/stop as a whole, which makes upgrades and troubleshooting simpler.
dsh plugin --profile web add github:Classicoke/cleverer-dsh
# headless instead: dsh plugin --profile headless add github:Classicoke/cleverer-dsh
No build step — plugins and skills are ready as soon as the command finishes. Uninstall:
dsh plugin --profile web remove cleverer-dsh
Paste this into PowerShell (auto-downloads the release zip → extracts → installs → cleans up):
$u = 'https://github.com/Classicoke/cleverer-dsh/archive/refs/tags/v1.2.zip'
$z = "$env:TEMP\cleverer-dsh.zip"; $d = "$env:TEMP\cleverer-dsh-install"
Invoke-WebRequest $u -OutFile $z
Expand-Archive $z $d -Force
pwsh -File "$d\cleverer-dsh-1.2\install.ps1"
Remove-Item $z, $d -Recurse -Force
⚠️ Pick ONE install method. Installing both applies every plugin twice (duplicated behavior, premature denials). Uninstall one before switching to the other.
# 1. Restore the config backup install auto-created (if you had no
# cordis.patch.yml before, the backup is an empty [] patch = pre-install state)
$dshHome = Join-Path $HOME '.dsh'
if (-not (Test-Path $dshHome)) { Write-Host "Not found: $dshHome — aborting"; exit 1 }
$bak = Get-ChildItem "$dshHome\cordis.patch.yml.bak-cleverer-*" |
Sort-Object LastWriteTime -Descending | Select-Object -First 1
if ($bak) { Copy-Item $bak.FullName "$dshHome\cordis.patch.yml" -Force }
# 2. Remove ONLY the files cleverer-dsh installed (explicit list — your own
# plugins/skills in the same folders are left untouched)
$plugins = @('_shared','anti-stuck','discipline-hub','dsh-cordis-discipline','dsh-discipline',
'dsh-env-check-tool','dsh-env-triage','dsh-fast-locate','dsh-memory',
'dsh-plan-discipline','dsh-skill-loader','dsh-skill-provider','skill-evolver')
foreach ($p in $plugins) { Remove-Item "$dshHome\plugins\$p.mjs" -ErrorAction SilentlyContinue }
$skills = @('debug-by-root-cause','dsh-error-protocol','dsh-error-triage','dsh-fast-lookup','local-first','plan-before-execute')
foreach ($s in $skills) { Remove-Item "$dshHome\skills\$s.md" -ErrorAction SilentlyContinue }
Remove-Item "$dshHome\discipline-board.cordis.yml", "$dshHome\tools-board.cordis.yml" -ErrorAction SilentlyContinue
Remove-Item "$dshHome\scripts\dsh-env-check.mjs" -ErrorAction SilentlyContinue
# 3. Restart DSH
All deletions are scoped to $HOME\.dsh (your own user directory, never a system path), and only the files listed above are touched.
| Plugin | Problem it solves | When it triggers |
|---|---|---|
anti-stuck | stubbornly retrying the same failing command | ≥2 same-arg fails → deny; ≥3 turn fails → remind; ≥5 → force reflection |
dsh-env-triage | param-tweaking loops, going in circles | ≥2 schemes fail → trace card; ≥3 → stop & report |
dsh-plan-discipline | todo tool ignored | multi-step task without plan → remind; ≥3 fails & stale plan → refresh |
dsh-memory | memory bloat, force-write abuse | dedup before write + 60s window dedup |
skill-evolver | junk skills being saved | generalization gate before persisting |
dsh-discipline | empty system prompt | injects 11 execution rules every turn |
dsh-skill-loader | skills installed but never used | available-skills reminder at task start + keyword summoning |
dsh-cordis-discipline | dynamic-plugin misuse | precondition checks (no run before define, no undefine before stop) |
discipline-hub | plugins each doing their own thing, reminder spam | unified failure log + reminder throttle |
dsh-fast-locate | slow file lookup | one call, parallel multi-directory scan |
dsh-env-check-tool | guessing at environment issues | one-shot 9-point env health check |
| Skill | Purpose |
|---|---|
dsh-error-protocol | 6-step error handling (classify → diagnose → decide → verify → distill) |
dsh-error-triage | error lookup table: which error maps to which command |
dsh-fast-lookup | fast file lookup methodology |
debug-by-root-cause | find the root cause first, don't blindly retry |
local-first | verify locally before guessing online |
plan-before-execute | plan before acting, keep the plan updated |
MIT © 2026 cleverer-dsh contributors