Troubleshoot installation and loading
Use a reproducible sequence to separate source, dependency, build approval, configuration, and compatibility failures.
- 01
Confirm the dependency is installed
Inspect the target profile rather than the global environment. Preserve the full command and first error.
dsh plugin --profile web list - 02
Follow the error category
For package-not-found errors, verify the exact source. For ignored build scripts, use build approval. Fix configuration from the current-version README.
- 03
Handle website navigation and sign-in
Website handoff requires DSH Plugin Hub 0.4.0 or later. If the landing page asks you to sign in, open the startup URL printed by dsh web in another tab in the same browser, then return and continue. Never append the login token to a website link.
- 04
Run a minimal restart test
Reproduce with only the affected plugin, record Harness, Node, platform, and plugin versions, then report it to the maintainer.