dsh-doctor-windows

Getting DeepSeek Harness to boot on Windows can fail for a dozen reasons: a missing command, an unsupported Node.js runtime, an unreadable DSH_HOME, a broken profile manifest, or a stale package link. dsh-doctor bundles all of those common blockers into a single read-only diagnostic pass and returns a structured report so you can pinpoint the exact failure without guessing.

The tool ships as a standalone CLI and can also run as a Cordis in-session plugin. It covers command resolution, supported Node.js versions, DSH_HOME reachability, profile manifest integrity, empty Cordis patches, and broken junction or link paths. Reports come in terminal, Markdown, or JSON format with stable check IDs and well-defined exit codes (0 clean, 1 blocker found, 2 invalid arguments), making it straightforward to wire into automation. The entire run is strictly read-only: no network calls, no telemetry, no credential file access, and all sensitive paths and values are redacted in the output.

It is built for developers on Windows 10 or 11 running DSH under PowerShell 5.1 or 7 who hit a startup failure and need a clear next step, and for teams that want to bake DSH diagnostics into CI pipelines or runbook scripts.