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
Run a minimal restart test
Reproduce with only the affected plugin, record Harness, Node, platform, and plugin versions, then report it to the maintainer.