本書の案内

十三節は「導入 → 使う → トラブル」の順に並んでいる。特定のトラブルだけを解決したい場合は、第十二節へ直接ジャンプしてよい。

• 一 · これは何か——三層構造。日常で触るのは最上層だけ。
• 二 · インストール——3 つのプラットフォームでどれを取るか、どう入れるか。
• 三 · 初回の起動——七つの手順のウィザード、そして「閉じる＝終了ではない」。
• 四 · メイン画面の概要——4 つの領域がそれぞれ何を担当するか。
• 五 · 最初の会話——要望を明確に伝える方法。
• 六 · トレイメニュー——システムレベルの入口はここに集まる。
• 七 · 設定ページ——各セクションで何を変えられるか。
• 八 · プロファイル——複数設定の切り替えと、失敗時の戻し方。
• 九 · プラグイン——出荷時に何が入っているか、3 つのインストール経路、アンインストールの仕方。
• 十 · セーフモードと復旧モード——プラグインで壊れた、起動しないときの救い方。
• 十一 · 更新——5 つの段階と 4 つの再利用できる操作。
• 十二 · トラブル時——よくある症状の対照表と診断エクスポート。
• 十三 · データとヘルプ——ファイルの場所と追加ドキュメントの入口。

一、これは何か

一言で言えば：DeepSeek Harness のエージェント機能をデスクトップアプリに収めたものだ。アイコンをダブルクリックすれば会話を始められ、ファイルの読み書き、コマンド実行、ツール呼び出しを任せられる。

製品全体は三層で構成される。ユーザーが付き合うのは第三層だけで、前の二層はバックグラウンドで自動的に動く。

二、インストール

製品のダウンロードページから該当プラットフォームのインストールパッケージを取得し、ダブルクリックするだけでよい。Electron、Node.js、pnpm と固定バージョンの DSH ランタイムは同梱済みで、別途環境を用意する必要はない。本版に同梱されるのは Electron 44.0.0、Node.js 24.21.0、pnpm 11.8.0、Python 3.12.14、そして DSH ランタイム 0.2.2-rc.1 である。

アップグレードインストールで旧版を手動で終了する必要はない。インストーラーはまず実行中の旧版に終了を要求し、応答がなければ強制終了してからファイルを上書きする。どうしても終了できない場合は、インストールが明確にエラーを出して停止する——インストールは終わったのに起動しない、という事態にはならない。とはいえ、アップグレードの前に作業中の内容を保存しておくことを勧める。

注：Windows ARM64 は現在実験的ビルドである。本体は ARM64 ネイティブだが、パッケージ内の一部のペイロード（同梱の Python / Node / Office ランタイム、一部のネイティブモジュール）は依然として x64 で、ARM デバイスでの完全な検証は済んでいない。通常のユーザーには x64 版を推奨する。

三、初回の起動

初回起動時は既定の設定一式（desktop という名前のプロファイル）が自動的に用意され、ローカルで UI サービスが起動する。まず七つの手順からなるウィザードが表示される。「セットアップをスキップ」はいつでも選べ、あとから設定ページで補える。

ウィザードが終わるとメイン画面に入る。ウィンドウを閉じてもアプリは終了しない：既定ではウィンドウがトレイに収まるだけで、バックグラウンドサービスと実行中のタスクは動き続ける。本当に終了するには、トレイメニューの「終了」を使う。

四、メイン画面の概要

五、最初の会話を始める

1. 新しいセッションを作り、作業ディレクトリを選ぶ。
2. 「何をするか + どこでするか + どんな結果が欲しいか」を一文で伝える。例えば「このディレクトリの README を読み、期限切れのダウンロードリンクを探して表にまとめて」。
3. 作業が始まったら、ツール呼び出しと変更されたファイルに目を配る。方向を変えたいときは、そのまま中断して新しい指示を出す。
4. 結果に満足できなければ、どこが違うかを伝える。文脈を保ったまま直してくれるので、セッションを作り直す必要はない。

要望を明確に伝える三つの要点：

• 範囲：どのディレクトリ、どのファイルだけを変えるのか。自由にやらせない。
• 受け入れ条件：どうなったら完了か（起動できる、テストが通る、表に空欄がない）。
• 制約：触ってはいけないもの、守るべき書式、ネットワークを使ってよいかどうか。

六、トレイメニュー

ウィンドウを閉じたあとは、トレイアイコンがアプリ全体の入口になる。トレイアイコンを右クリックすると、次の項目が見える：

七、設定ページ

設定の入口はサイドバー下部（設定 → デスクトップ設定）。各セクションは次のとおり：

八、プロファイル：複数の設定

プロファイルは独立した設定環境である：セッション、プラグイン、設定がそれぞれに属し、互いに干渉しない。典型的な使い方は「仕事」と「個人」を分ける、あるいは「日常」と「新しいプラグインの試用」を分けることだ。

実用的な三つのルール：

• 一つのプロファイルを壊しても、別のプロファイルに切り替えれば作業を続けられる。まずそれを救う必要はない。
• 新しいプロファイルは空である（公式の基本コンポーネントのみ）。プラグインは入れ直す必要がある——それこそが「きれい」である理由だ。
• プロファイルを削除すると、ローカルの設定とプラグインファイルも一緒に削除され、元に戻せない。

九、プラグイン：出荷状態とインストール方法

9.1 出荷時に何が入っているか

インストールパッケージにサードパーティのプラグインは一切入っていない。初回起動時に作成される既定のプロファイルが読み込むのは、公式の基本コンポーネント二つだけである：

• @deepseek-ai/dsh-base——Host カーネル：セッション、ツール、ファイルアクセス、モデル接続。
• @deepseek-ai/dsh-web-app——画面に表示される Web UI。

つまり、インストール直後に手に入るのは、きれいで、会話ができ、ファイルを読み書きでき、コマンドを走らせられるデスクトップアプリである。プラグインマーケット、専門家チーム、音声入力、タスクボード、コードグラフなどはすべて自分で入れる。これは意図された設計だ：何を入れるかを自分で決められ、問題が起きたときも「直前に導入したもの」に絞り込める。

9.2 三つのインストール経路

プラグインページ（左側の「プラグイン」、サブタイトルは「プラグインのインストール、有効化、設定」）は二つの役割を持つ：

• 新しいプラグインを入れる：「プラグインを追加」をクリックし、「サードパーティのプラグインをインストール」を選び、npm パッケージ名（例：dsh-xxx や @作者/プラグイン名）、GitHub リポジトリのアドレス、または本機のディレクトリを入力する。インストール時にレジストリを選べる：デフォルトレジストリ、公式npmレジストリ、中国本土ミラー、または自社内のカスタム npm レジストリ。
• 入れたものを管理する：「インストール済みプラグイン」で有効化、無効化、アンインストール、更新の確認ができ、各プラグインのバージョン、入手元、稼働状態も見える。

一部のプラグインはDSH に同梱されている：「このプラグインは DSH に同梱されています · 追加のダウンロードなしで有効にできます」と表示され、有効化すればそのまま効く。現在の DSH より古い場合は「更新」が現れる。これに該当するのは、専門家チーム、音声入力、プラグインマーケット、自動レビュー、端末、セッション検索、セッションタイトル、バッジスキル、Ralph、思考連鎖の翻訳、Inspector、LiveShare、Forge、ワークツリーツール、パーソナライズ推薦などである。サイズや依存が重く、既定では入らないもの（Claude Code サブエージェント、Codex サブエージェント、Computer Use デスクトップ操作）も、同じくプラグインページから必要に応じて有効化する。

DSH に組み込まれた基本コンポーネント（dsh-base、dsh-web-app など）はプラグインページの管理一覧には現れない。それらの稼働状態は設定 →「組み込みプラグイン」で確認する。

プラグインマーケットは現在二つから選べる：dsh-community-market（同梱のオープンマーケット。独自のデータソースに対応）と dsh-market（コミュニティの人気マーケット。データは awesome-dsh-plugin 由来）。同時に有効化できるのは一つだけである。

端末の三つのコマンド（--profile を付けない場合は現在有効なプロファイルに作用する）：

9.3 入れたら再起動、入れたら確認

プラグインを入れたあとはアプリを再起動して初めて読み込まれる——インストール完了時に「インストール済みです。読み込むには DSH を再起動してください。」と表示される。入ったかどうかの確認は：

1. プラグインページを開き、「インストール済みプラグイン」に現れているか、有効になっているかを見る。
2. サイドバーにその入口（マーケット、ボード、専門家チームなど）が増えているかを見る。
3. それでも分からなければ「設定 → ログ」を開き、ログレベルを上げて一度再起動する。読み込みに失敗していれば、通常ははっきりしたエラーが出る。

9.4 無効化とアンインストール

• まず無効化、次にアンインストール：無効化は次回起動時に読み込まないだけで、インストールされたファイルも設定も残り、いつでも戻せる。アンインストールは dsh plugin remove を通じてパッケージを削除し、画面には「アンインストールすると、提供している機能は利用できなくなります。」という確認が出る。復旧アシスタントの「プラグイン管理」でも、同じ操作を「無効化」として扱う。
• プラグイン管理自体に必要なコンポーネント（Host、Web サービス、ファイルアクセスなど）には「プラグイン管理に必要です。無効化もアンインストールもできません。」と表示される——アプリを動かない塊にしてしまわないための仕組みだ。dsh-base、dsh-web-app などの組み込み基本コンポーネントは管理一覧にすら出ず、「設定 → 組み込みプラグイン」で状態を見るしかない。
• 旧版からアップグレードしたプロファイルでは、プラグインマーケットは設定で一度明示的に選ぶまでオフのままである。これは故障ではない。

9.5 プラグインでアプリが起動しなくなったら

OS の再インストールも、データディレクトリの削除も要らない。第十節の復旧アシスタントを使う：まず「プラグイン管理」で直前に導入したものを無効化して起動し、それでもだめなら「ロールバック」で最後に起動できたチェックポイントまで戻す。

十、セーフモードと復旧モード

この二つは同じ種類の問題を解く：何かを入れたら起動しなくなった。違いは、セーフモードが「きれいに入って作業する」、復旧モードが「戸口で止まって直す」ことにある。

10.1 セーフモード

セーフモードは独立した一時データディレクトリで起動する：既存のプラグイン、設定、セッション、ワークスペースの記録は読まないので、それらに引きずられることもない。元のデータは一バイトも動かない。

入り方：トレイ →「セーフモードに入る…」。または復旧アシスタントのホームで「セーフモード」をクリック。

セーフモードでできること：

• 「本当にプラグインの問題か」の切り分け。セーフモードで何もかも正常なら、原因はほぼプラグインか設定にある。
• Web UI で普通に会話し、ファイルを読み書きできる。急ぎの用事は先に片付けられる。
• ログを見る、診断情報をエクスポートする（診断パッケージは復旧アシスタントからも出せる）。

制限（設計どおり）：

• デスクトップ設定ページは読み取り専用で、変更できない。
• ブラウザアクセス、LAN アクセス、Agents-Anywhere、デスクトップ通知など、永続設定に依存する項目は使えない。
• 画面上部に「セーフモード」の帯が常に出て、一時環境で動いていることを知らせる。

終了：トレイ →「セーフモードを終了して再起動…」。終了後、一時環境は次回の通常起動時に自動で片付けられ、ディスクに残らない。

10.2 復旧アシスタント（復旧モード）

いつ入るか：

• トレイの「復旧モードで再起動」、または設定ページ → バージョンと更新 →「復旧モードで再起動」を自分で選んだとき。
• 起動に続けて失敗し、アプリ自身が復旧アシスタントへ退避したとき。
• 画面がどうしても立ち上がらないときは、「DSH Desktop を復旧」ダイアログが別に開き、バックグラウンドサービスを再起動せずにもう一度復旧を試せる。

復旧アシスタントは三つのことを教えてくれる：なぜ入ったのか（手動なら「手動で復旧モードに入りました」と明記される）、いまどのプロファイルとどのディレクトリを使っているのか、起動がどの段階で止まったのか（Electron 初期化 → Shell 環境の準備 → デスクトップランタイムの準備 → プロファイルの選択 → プラグイン設定の組み立て → プラグインサービスの起動 → デスクトップ UI の起動 → 起動結果の確認）。どこで止まったかが分かれば、問題の範囲もそこまで絞れる。

ロールバックの仕組み：起動に成功するたびに、アプリは「起動チェックポイント」を保存する——その瞬間に動いていた設定の記録である。ロールバックは、プロファイル、settings.yaml、プラグインの有効状態をその時点までまとめて戻す。チェックポイントには「復元可能 / 読み取れない / チェックポイントなし」の三つの状態が表示される。「読み取れない」はそのチェックポイント自体が壊れているという意味なので、より古いものを選ぶ。

工場出荷状態への復元：現在のデータディレクトリを丸ごとゴミ箱へ移し（Windows ではごみ箱）、再起動後に既定のプロファイルを新規作成する。データディレクトリの外にあるプロジェクトのファイルは削除されない——消えるのは自分の設定とセッションだけである。実行前に、古いセッションが本当に不要かを確認してほしい。

10.3 出口

直したあとに手動で片付ける必要はない：復旧アシスタントを普通に終了してアプリを起動すればよい。復旧モードから「再起動」を押した場合は、通常の起動フローをもう一度通る。それでも失敗すれば復旧アシスタントに戻るが、無限に繰り返すことはない。

十一、更新

五つの段階：確認 → ダウンロード → インストール → 再起動 → バージョン確認。再利用できる四つの操作：

• 手動で確認：トレイ →「更新を確認…」、または 設定 → バージョンと更新 →「更新を確認」。
• 再起動：設定 → バージョンと更新 →「再起動」。タイトルバーに更新の通知が出ているときは、そこから直接押してもよい。
• インストールの残骸を片付ける：更新の失敗は、たいてい旧インスタンスがファイルを掴んでいるせいだ。トレイからアプリを終了してインストーラーを再実行すればよい。ディレクトリを手で消す必要はない。
• 戻す：テストチャネルから安定版に戻すにはトレイの「安定版をインストール…」。直前の起動できる状態に戻したいだけなら、復旧アシスタントの「ロールバック」を使う。

十二、トラブル時の対処

診断情報のエクスポート

トレイ →「診断情報をエクスポート…」、または設定ページ下部の同じ項目。パッケージにはローカルパス、ログ、システム情報、クラッシュ時のメモリ断片が入る。共有する前に自分で一度目を通してほしい：パスやセッションの断片にプライベートな内容が含まれていることがある。

十三、データの場所とヘルプ

追加ドキュメント

• README.md / README.zh.md：インストール、ビルド、開発環境。
• docs/：アーキテクチャの説明、リリース手順、プラグイン開発ガイド。
• 同ディレクトリの Nonead-DSH-Desktop-User-Manual.en.md と八言語の HTML 版：内容は対応しており、突き合わせに便利である。

謝辞

本製品は上流の DeepSeek Harness とオープンソースコミュニティの上に成り立っている：Electron、Node.js、pnpm、Python、そして Cordis のプラグイン体系と公式バンドル群。上流のメンテナとすべての貢献者に感謝する。

サードパーティプラグインの作者情報は各プラグインに伴って配布され、プラグインページやプラグインマーケットの詳細で確認できる。本マニュアルでは個々のバージョンと作者を並べない——それは製品の出荷状態ではなく、あなたのインストールの選択に属するものだからだ。

マニュアルはバージョンに合わせて更新される。現在のバージョンと合わない箇所を見つけたら、GitHub / GitCode で issue を立ててほしい。