DSH Wiki DSH Wiki
DEPLOY

導入ガイド

ゼロから動かすまで 4 ステップ。コマンドはすべて公式 README と逐一照合済み。
01

CLI をインストール

npx のワンコマンドでそのまま動く。macOS / Linux / Windows いずれも OK、Node 22.19+ があればいい。
02

モデルを接続

DeepSeek API key を入力するか、Ollama をつないでローカルで動かしているモデルをそのまま使う。
03

起動

ターミナルでそのまま作業開始。コマンドラインが苦手なら、dsh web でブラウザ画面を立ち上げられる。
04

最初のプラグインを入れる

厳選リストからひとつ選んで入れよう——ここから先は、すべてがプラグインだ。
REQUIREMENTS
runtime · readme_wording
Install `Node.js`, then run: npx @deepseek-ai/dsh web
runtime · package_json_engines_node
^22.19.0 || >=24.0.0
runtime · package_json_packageManager
pnpm@11.7.0
runtime · root_package
@deepseek-ai/dsh-root 0.1.0-rc.7
runtime · engines_source_url
linux_build_tools_note
公式には記載がないが、コミュニティのディスカッション(#1772/#49/#897)で、Linux では node-pty のネイティブモジュールをローカルでビルドする必要があると確認済み:Debian は build-essential、Arch は base-devel が必要で、g++ は gnu++20 対応(GCC 10+)であること
status_warning
DeepSeek Harness is currently in _developer preview_ and is iterating rapidly. THERE WILL BE COMPATIBILITY-BREAKING CHANGES.(README の原文)

npx で直接実行(公式 README の第一候補)

npx @deepseek-ai/dsh web
原文

ソースから実行(pnpm)

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
原文

Ollama 連携(ローカル/プライベート環境)

ollama launch dsh
原文

npm でグローバルインストール(コミュニティの手法、公式 README には未記載)

npm install -g @deepseek-ai/dsh
dsh web
原文

MODEL

api · deepseek_key
Web UI の Settings → Models で、DeepSeek のカードに API key(https://platform.deepseek.com/ で取得)を入力して保存する;公式原文:"The model route becomes usable immediately without restarting the server"(保存した時点で有効になり、再起動は不要)
api · key_storage
providers.md の原文:"Keys are write-only. The page receives a redacted descriptor after saving, never the literal secret. The key is stored in `$DSH_HOME/.credentials.yaml`";モデル定義は $DSH_HOME/settings.yaml に保存される
api · catalog_providers
Anthropic
api · catalog_providers
OpenAI
api · catalog_providers
Bedrock
api · catalog_providers
Vertex
api · catalog_providers
Azure
api · catalog_providers
Codex
api · catalog_config
Add provider → ベンダーを選ぶ → API key を入力 → 保存;Bedrock/Vertex/Azure/Codex はそれぞれ AWS 認証情報+region、ADC project、api-version、OAuth を使う
api · env_var
認証情報は環境変数で注入できる(設定例の apiKeyEnv フィールド、例:GATEWAY_API_KEY)
api · source_url
local · custom_openai_compatible
Add a custom provider:Provider ID(小文字、変更不可)、表示名、base URL、API プロトコル、認証情報、モデルを最低 1 つ入力する;Fetch available models は OpenAI 互換の GET /models を呼んでモデル一覧を自動取得する。非対応のエンドポイントではモデル名を手入力する
local · ollama
ollama launch dsh の 1 コマンドで完全にローカル実行でき、Ollama web search プラグインがプリインストールされる(Ollama 公式の説明)
local · source_url

LAUNCH

web_ui · command
npx @deepseek-ai/dsh web
web_ui · alias
dsh web は dsh --profile web のエイリアス
web_ui · default_address
web_ui · first_run_flow
① Settings → Models で DeepSeek API key を入力 → ② Choose workspace で作業ディレクトリを選ぶ(公式原文:"The session composer remains unavailable until a workspace is selected") → ③ セッションを開いてタスクを投げる
web_ui · source_url
terminal · headless
dsh --profile headless "job" — 公式の説明:"Run one fresh persisted session, print the final answer, and exit"
terminal · profile
dsh --profile <name> — "Boot the named profile under $DSH_HOME/profiles/<name>";web/headless の 2 つの profile は初回利用時にテンプレートから自動初期化される。その他の profile は dsh plugin で作成する必要がある
terminal · plugin_mgmt
dsh plugin --profile <name> <pnpm args> — pnpm の引数を profile ディレクトリに転送してプラグインを管理する
terminal · flags
--port
terminal · flags
--resume
terminal · flags
--patch
terminal · flags
--dump-default-config
terminal · flags
--dump-config
terminal · flags
--help
terminal · source_url
modes · list · name_zh
標準モード
modes · list · name_en
Standard
modes · list · dir
standard
modes · list · official_desc_zh
機能が一通り揃ったコーディング Agent。ファイル編集、Shell、ファイルと Web の検索、Skills、計画、目標、サブエージェント、ワークフローに対応。
modes · list · name_zh
PTC モード
modes · list · name_en
Code
modes · list · dir
code
modes · list · official_desc_zh
標準モードの全機能を備え、さらに Code Mode SDK でツールを提示することで、モデルが 1 つの TypeScript プログラムで複数ステップの操作を組み立てられるようにする。
modes · list · name_zh
ミニマルモード
modes · list · name_en
Minimal
modes · list · dir
minimal
modes · list · official_desc_zh
永続的な bash と str_replace_editor の 2 ツールのみを提供するコーディング Agent。
modes · list · name_zh
クリエイトモード
modes · list · name_en
Creator
modes · list · dir
cordis
modes · list · official_desc_zh
カスタム Agent preset の作成用:標準モードの全機能を備え、加えてランタイムの検査、プラグインの実験、preset 作成のガイドを提供する。
modes · definition_location
apps/cli/config/agent-presets/ 配下の 4 つのディレクトリ(code/cordis/minimal/standard)。preset の定義ファイルは公式が中国語で直接記述している
modes · source_url

UPGRADE / UNINSTALL

note
README、apps/cli/README.md、docs のユーザーガイドのいずれにもアップグレード/アンインストールのコマンドは記載されていない(1 件ずつ確認して ABSENT);コミュニティのディスカッションでは npx キャッシュを消す手法(rm -rf ~/.npm/_npx、#49/#897 参照)が出ているが、これはトラブルシューティングの手段であり公式のアップグレード手順ではない

ISSUES

npx でインストールできない | npm でもインストールできない (#1772,解決済み)
投稿者による自己解決(2026-08-16):Debian に build-essential が入っておらず node-pty のネイティブモジュールのビルドに失敗していた;apt で build-essential を入れたところインストールに成功
ArchLinux でインストールできない (#49,コメント 18 件)
支持の多い解法:① pacman -Syu base-devel でビルドツールを入れる;② Bun に切り替える:bun add --global @deepseek-ai/dsh(node-pty は Bun の許可リストに入っている);③ npm を使い続けるならキャッシュを消してビルドスクリプトを許可する:rm -rf ~/.npm/_npx && npx --allow-scripts=node-pty @deepseek-ai/dsh@0.1.0-rc.6 web;別案:npm config set allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty,@google/genai,protobufjs --location=user
コマンドラインでのインストールが成功しない (#897,コメント 10 件)
コミュニティによる原因特定:システム標準の g++ 9.4.0 が -std=gnu++20 に非対応(GCC 10+ が必要);解法:まず npx キャッシュを消し、CC=gcc-11 CXX=g++-11 npm install -g @deepseek-ai/dsh を実行してから dsh web
npm でグローバルインストール後に dsh web が起動しない:node-pty のネイティブモジュール pty.node が欠落 (#1219)
根本原因:node-pty v1.1.0 には Linux x64 (Node 24/ABI 137) 向けのビルド済み成果物がなく、npm のインストールスクリプトが黙って失敗していた;手動の回避策:node-pty ディレクトリに入って npx node-gyp rebuild を実行し、欠落している pty.node を生成する;スレッド内に公式の返信はなし(返信 0 件)
dsh でプラグインをインストールするとエラー Ignored build scripts が出る (#2230)
解法の詳細は取得できていない(コメント 1 件、深く確認していない);現象は pnpm が既定で依存関係のビルドスクリプトを無視するセキュリティポリシーに関係しており、#49 の allow-scripts の案が参考になる——この項目の解法は追記待ち
DSH Wiki · DSH情報局 · ai798 Lab 制作
DeepSeek Harness 公式サイト GitHub
データは実測取得