開始前
- 対応する Node.js 環境と、安全に調査できるプロジェクトフォルダーを用意します。
- 秘密情報や、変更されたくないファイルを含むディレクトリでは起動しません。
- Web UI は既定のループバックアドレスに限定し、ローカルネットワークへ公開しません。
- 利用するモデルプロバイダーの API 認証情報を用意します。
公式 Web UI を起動する
mkdir -p "$HOME/.dsh-themes/runtimes" &&
git clone --depth 1 --branch dsh-v0.1.3-alpha.1 https://github.com/deepseek-ai/deepseek-harness.git "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
cd "$HOME/.dsh-themes/runtimes/0.1.3-alpha.1" &&
test "$(git rev-parse HEAD)" = "d347e703908d0406b7a7ef80e3a0e594d86b2215" &&
corepack pnpm install --frozen-lockfile &&
corepack pnpm run build:official &&
corepack pnpm dsh web小さく観測可能なタスクを 1 つ完了する
- 01
表示されたループバックアドレスを開く
既定ではポート 3080 でブラウザー UI が開きます。プロセスが表示したアドレスを使い、ターミナルは実行したままにします。
- 02
モデルを設定する
設定画面を開き、必要なプロバイダーの認証情報を追加します。認証情報を会話やプロジェクトファイルへ貼り付けてはいけません。
- 03
使い捨てワークスペースを選ぶ
別の場所に練習用の一時的なプロジェクトを作るか、作業したい自分のプロジェクトを選び、ディレクトリを追加して選択します。公式 Harness の実行用ソースディレクトリを Agent の編集対象にしないでください。ワークスペースを選ぶとメッセージ入力欄を使えるようになります。
- 04
最初は読み取り専用のタスクを依頼する
まず Agent に、リポジトリの要約と主要パッケージの特定を依頼します。編集を依頼する前に、読み取った内容を確認してください。
- 05
すべての承認プロンプトを確認する
コマンド、パス、想定される影響を確認します。選択したワークスペースの外へ出る操作や、タスクに不要な操作は拒否してください。
最初の実行後
最初の小さなタスクを完了する
固定したソースからビルドした Web UI が開いたら、モデルを構成し、プロジェクトを明示的に選択します。 README の修正を依頼し、差分を調べて、セッションを再度開いても会話が保持されていることを確認します。
Node.js と pnpm のバージョンを確認し、コミット d347e703908d0406b7a7ef80e3a0e594d86b2215 から DeepSeek Harness 0.1.3-alpha.1 をビルドし、Web UI を開始します。設定で自分のモデルの資格情報を入力するように依頼してください。それらを印刷したり創作したりしないでください。一次資料となる公式文書を読む
よくある質問
変更を行う前に
フォーマット、互換性、証拠、ロールバックに関する回答
このガイドでは何を確認しますか?
このガイドの対象:正確な Alpha ソースビルドの起動、公式アーキテクチャおよび Web UI ガイド、ループバックとワークスペース安全境界
最初に何をすべきですか?
指定された公式 Alpha ソースから Harness をビルドし、ローカルアドレスで Web UI を開きます。練習用の一時的なワークスペースを選び、モデルと権限を確認してから、最初の小さなタスクを実行しましょう。
最も重要な境界は何ですか?
Node.js 24(リポジトリの対応範囲は ^22.19.0 または >=24.0.0)と Corepack を使用します。公式ビルドでは Corepack がリポジトリ指定の pnpm 11.7.0 を選びますが、子プロセスは別の pnpm バージョンを使う場合があります。2026 年 9 月 6 日現在、この Alpha の正確な npm パッケージとリリースバイナリは公開されていません。以下の検証済み手順では $HOME/.dsh-themes/runtimes 内の独立したディレクトリを使用します。このサイトの中や、上位に node_modules がある場所を避け、他のプロジェクトの React 依存関係が読み込まれないようにしてください。起動に必要なソースディレクトリとビルド成果物は残します。起動後に作業フォルダーを選び、設定 → モデルで自分のモデルを設定します。
メッセージ入力欄が使えないのはなぜですか?
初回起動時は作業フォルダーが選択されていません。プロジェクトのディレクトリを追加して選択し、設定 → モデルでモデルが設定されていることを確認してください。
学習を続ける
検証済みの証拠から続ける
公開済みのアーティファクトを比較するか、インストール手順に戻ります。