Tutorials for DeepSeek Harness plugins
Practical, copy-pasteable guides covering the whole plugin lifecycle — from your first install to publishing your own plugin. Seven hubs, one search box.
Concepts & Architecture
How Cordis, plugin lifecycles, contexts and the runtime fit together before you touch configuration.
Install & Get Started
Install DSH, run the Web UI, add your first plugin, and verify that it actually loaded.
Configuration & Usage
Profiles, plugin options, environment variables, permissions and per-project configuration.
Update & Upgrade
Pin versions, upgrade safely, read changelogs and roll back when a plugin breaks.
Uninstall & Cleanup
Remove plugins cleanly, reclaim disk space and audit what is still installed.
Troubleshooting
Diagnose load failures, version conflicts, permission errors and a plugin that silently does nothing.
Plugin Development
Scaffold a plugin, export apply(ctx), package for npm and submit it to this hub.
All tutorials
734 community write-ups indexed in total. Filter the featured list below by hub or keyword.
Featured tutorials
Showing 12 tutorials · filtered by hub and keyword
Run npx @deepseek-ai/dsh web, confirm the local URL, and check the version reported by dsh --version before adding plugins.
Use dsh plugin --profile web add <package>, then verify it appears under Settings → Plugin Market and answer any permission prompts.
Why the Web UI, model adapters and tools all share one plugin model, and what that implies for which extension points are available to you.
A tour of index.json format 1: categories, labels, sort keys, plugin versions, npm sources and engines.dsh ranges.
What each profile loads, how to keep experimental plugins out of your daily profile, and when to create a dedicated profile.
Where plugin settings live, how to override defaults per project, and how to check what a plugin actually received at startup.
Pin versions, read the changelog, snapshot your config, then upgrade one plugin at a time so failures stay isolated.
Check every installed plugin's engines.dsh range first, update the core, then reapply plugins that declare a compatible range.
Remove it from the profile, clear leftover config keys, and check that no other plugin still depends on it.
The four usual causes: wrong profile, missing restart, permission not granted, or a version outside the engines.dsh range.
Find the plugin log, separate a resolution failure from a runtime throw, and identify the offending plugin when several fail at once.
Scaffold a package, export apply(ctx), register one tool, then test it locally before wiring up npm publishing.
Tutorial FAQ
Do I need to restart DSH after installing a plugin?
Usually yes. Most plugins are loaded at profile startup, so restart the Web UI or the session before expecting new panels or tools to appear.
What is a profile, in one sentence?
A profile is a named set of plugins and settings that DSH loads together — the web profile is the default for the Web UI.
How do I know a plugin is compatible with my version?
Check the engines.dsh range declared by the plugin version you are installing. If your core version is outside the range, skip that release or upgrade the core first.
Where do tutorials live?
This page lists featured tutorials. The full catalog is grouped into seven hubs — concepts, install, configuration, update, uninstall, troubleshooting and development.