Verify before executionMatch the scoped package, DeepSeek AI repository, expected release, and dsh binary. Similar names are not provenance.

Choose by what you need to prove.

First lookExact npx

Smallest setup. Pin the version in the command.

npx @deepseek-ai/dsh@0.1.0-rc.7 web
Repeatable artifactProject-local

Record the package in a disposable manifest and lockfile.

npm install --save-exact @deepseek-ai/dsh@0.1.0-rc.7
Upstream workSource checkout

Test a named Git revision and freshly built artifacts.

pnpm install && pnpm run build && pnpm dsh web
Shell convenienceGlobal

Convenient, but always prove which binary the shell selected.

command -v dsh && dsh --version

First read, then run.

npm view @deepseek-ai/dsh \
  name version dist-tags repository.url homepage bin --json

npx @deepseek-ai/dsh@0.1.0-rc.7 web

Do not collapse three coordinates.

ExecutableWhat code ran?

Path, version, package identity, or source commit.

+
StateWhat graph composed?

DSH_HOME, profile manifest, bundles, and patches.

+
WorkspaceWhat could it reach?

Launch directory and selected workspace realpath.

Capture the resolved graph.

npx @deepseek-ai/dsh@0.1.0-rc.7 --version
npx @deepseek-ai/dsh@0.1.0-rc.7 \
  --profile web --dump-config > resolved-web.yml

Route the first failure.

Wrong version

Compare the requested package, shell-selected path, and reported version.

Source will not boot

Check the Git revision, pinned pnpm, and a fresh pnpm run build.

Global native failure

Run an exact project-local A/B before changing the global store.

Old settings survive

Inspect DSH_HOME and profile patches; executable installation is separate.

A clean executable is not clean state.

The CLI, profile composition, and workspace are independent. Record all three before filing an installation or startup report.

Primary evidence.

Keep the full installation record.

The canonical guide includes exact commands, state isolation, first-run acceptance, global-install comparison, a failure router, and a reusable reproduction template.

Read the complete guide on GitHub