dsh-doctor-windows
DeepSeek Harness 的只读 Windows 启动诊断
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xianfanwindy/dsh-doctor-windows#a892bbdc1d9281964fa0187ed93241501bb7a2adDoctor Windows 以 dsh-doctor-windows 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-doctor-windows is an unofficial, Windows-first startup diagnostic for DeepSeek Harness (DSH). It is read-only with respect to DSH and system configuration, and it sends no telemetry.
The standalone dsh-doctor CLI inspects command resolution, supported Node.js versions, DSH_HOME reachability, selected profile manifests, Cordis patches, and direct package links without loading target plugins. Its Cordis plugin provides the same sanitized findings in a recovered DSH session.
The report is diagnostic evidence, not an exhaustive diagnosis. Representative accepted failure examples are:
| Check ID | Meaning |
|---|---|
command.dsh.missing | No usable DSH command. |
runtime.node.unsupported | Unsupported Node.js version. |
runtime.dsh.shim-target | Stale npm shim target. |
windows.dsh-home.readable | Unreadable Harness home. |
profile.manifest.parse | Invalid profile manifest. |
windows.link.broken | Broken direct package link or junction. |
profile.patch.empty | Empty or comments-only Cordis patch. |
Install from npm:
npm install -g dsh-doctor-windows
Or install a packed tarball:
npm install -g .\dsh-doctor-windows-0.1.0.tgz
Direct installation from a GitHub source checkout is unsupported. The package intentionally has no prepare script; use npm or a packed tarball.
dsh-doctor
dsh-doctor --profile web
dsh-doctor --profile web --format markdown --output .\dsh-doctor-report.md
dsh-doctor --profile web --format json --no-color
Supported options are --profile, --dsh-home, --format terminal|markdown|json, --output, --no-color, --verbose, --version, and --help. Without --output, the CLI writes only to the terminal.
After DSH can boot, add the installed package to a profile:
dsh plugin --profile web add dsh-doctor-windows
The bundle adds the dsh_doctor tool. It returns a sanitized report to the active session and cannot write report files.
Terminal and Markdown reports summarize findings and manual remediation. JSON reports include schemaVersion and stable checkId values for automation. Exit code 0 means no blocker, 1 means at least one blocker, and 2 means invalid arguments or doctor initialization failed.
The doctor performs no network request, telemetry, or report upload, and does not execute a discovered DSH shim. It does not read .credentials.yaml or .env contents. Reports redact known homes, DSH_HOME, temporary paths, URL credentials, credential-like values, authorization forms, and high-entropy captured values. Redaction reduces, but cannot eliminate, disclosure risk; review a local report before sharing it.
Version 1 supports Windows 10 and Windows 11 with PowerShell 5.1 or PowerShell 7, Node.js ^22.19.0 || >=24.0.0, and a DSH command on PATH. The Cordis bundle smoke is verified against @deepseek-ai/dsh@0.1.0-rc.8.
Alias and shim selection can differ between shells. Symbolic links and junctions can depend on Windows permissions and filesystem behavior. Profile and bundle formats are pre-release DSH inputs that may change. Version 1 does not support macOS or Linux, automatic repair, plugin-installation automation, telemetry or upload, or a GUI.
corepack enable
pnpm install --frozen-lockfile
pnpm run check
pnpm run build
pnpm pack
The packed artifact is the supported test and release input; do not rely on a source checkout behaving like an installed package.
Remove the Cordis bundle from each profile that uses it, then remove the npm package:
dsh plugin --profile web remove dsh-doctor-windows
npm uninstall -g dsh-doctor-windows