本書の案内

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

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

一、これは何か

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

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

このバージョン（Essentials 版）は、ソフトウェアリポジトリにある汎用版とさらに違いがある：「シェルだけを入れて、あとからプラグインを入れてもらう」空のアプリではない。厳選され、互いに連携できる 35 個のプラグインをまとめてインストールパッケージに入れている。インストールして初めて開けば、それらの機能はすでにプラグインページに並んでおり、npm を一つずつ探し回る必要はない。

二、インストール

製品のダウンロードページから該当プラットフォームのインストールパッケージを取得し、ダブルクリックするだけでよい。インストールパッケージには 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 x64、macOS ユニバーサルパッケージ、Linux x64 の 3 種類である。Linux の arm64 版はテストチャネルでビルドされており、安定版のダウンロードリンクにはまだ入っていない。ARM デバイスでネイティブモジュールの問題が起きた場合は、対応するプラットフォームの x64 版かテストチャネルのビルドを使っていただきたい。

三、初回の起動

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

最後のページでは、まず大分類の概観が示される：記憶とコンテキスト、UI とワークスペース、エージェントとスキル、ドキュメントとメディア、コードとエンジニアリング、ロボットとシミュレーション、接続と自動化。各分類には「この分類が何の役に立つか」とプラグイン数が書かれている。「完了して開始」を押すと、ウィザードが一つずつインストールを始め、各プラグインの番が来るたびに、その名前、バージョン、所属する大分類、完全な説明、そして「◯◯さん、このプラグインをありがとうございます」という一文を表示する。インストール中に操作は不要で、進捗が終わるのを待てばよい——35 個のパッケージを一つずつ入れるので、初回起動はいつもより少し時間がかかる。

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

四、メイン画面の概要

プリインストールプラグインを入れると、サイドバーと入力欄にはさらにいくつかの入口が増える：スキルセンター、タスクボード、コストボード、入力履歴、専門家チームなど。いずれも第九節のプラグインが提供するもので、該当するプラグインを無効にすれば消える。

五、最初の会話を始める

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

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

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

六、トレイメニュー

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

旧版のマニュアルにあった「モード：強化 / 互換 / 拡張」は廃止された。2.2.9 からウィンドウモードは固定で、設定には「ウィンドウの外観（素材）」だけが残っている。

七、設定ページ

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

セーフモードではこのページは読み取り専用で、ブラウザアクセス、LAN、リモートコントロール、通知などの項目も無効になる——これは設計どおりで、故障ではない。

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

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

実用的な三つのルール：

• 一つのプロファイルを壊しても、別のプロファイルに切り替えれば作業を続けられる。まずそれを救う必要はない。
• 新しいプロファイルには公式の基本コンポーネントしかない。プリインストールされた 35 個のプラグインは、ウィザードを完了したそのプロファイルにだけ入る。プロファイルを変えて使い続けたい場合は、プラグインページで実際の一覧を確認し、足りないものを補う。
• プロファイルを削除すると、復旧用バックアップディレクトリへ移される（すぐに消えるわけではない）。共有のセッションと設定は残るが、そのプロファイルとしてはもう使えないので、実行前に確認すること。

九、プリインストールプラグイン

この節は本版マニュアルの中心である。2.2.9 のインストールパッケージには35 個のプラグインが同梱され、七つの大分類に分かれている。最初のウィザードを完了した時点で、現在のプロファイルへ自動的にインストールされる。以下ではまず「何が入り、どう入るのか」を説明し、続いて分類ごとに一つずつ紹介し、最後に管理と再インストールの方法を述べる。

9.1 出荷時に何がプリインストールされているか

インストールパッケージは 35 個のプラグインの圧縮ファイルをまとめて配布し（plugins/ ディレクトリ）、最初のウィザードの終了時に一つずつプロファイルへ入れる。これらは「任意ダウンロード」ではなく、インストールすればそこにある：プラグインページを開けば「インストール済みプラグイン」に 35 個すべてが並び、既定で有効になっている。

9.2 プリインストールの仕組み

知っておきたいいくつかの細部：

• インストールは一つずつ進む。入れるたびに、その名前、バージョン、大分類、説明、作者がウィザードに表示される。すべて終わるまでウィンドウを閉じないこと。
• 成功の判定は、プロファイルの package.json の依存にそのパッケージ名が現れることであり、コマンドがエラーを出したかどうかではない。完了後は名前が profile.bundles にも補われる。そうでなければ「入ったのに有効になっていない」状態になる。
• 個々のプラグインの失敗は起動を止めない。完了時に失敗があれば、名前と理由を項目ごとに並べたまとめのダイアログが出て、同時にデスクトップログへ書き込まれる（bundled plugin not installed: <名前>: <理由>）。ウィザードはそのまま終了する。あとからプラグインページで、どれが本当に一覧にあるかを確認できる。
• 入るのはウィザードを完了したそのプロファイルだけ。あとから作ったプロファイルはきれいな状態なので、必要ならウィザードを再実行するか、プラグインページから補う。

9.3 分類別の詳細リスト

以下、七つの大分類ごとに 35 個すべてを挙げる。名前の後の v は同梱バージョン、「向いている用途」の一文は選ぶときの助言であり、機能の制限ではない。

9.4 無効化、アンインストール、再インストール

• まず無効化、それからアンインストール：無効化は次回起動時に読み込まないだけで、インストールされたファイルも設定も残り、いつでも戻せる。アンインストールは dsh plugin remove を通じてパッケージを削除し、画面には「アンインストールすると、提供している機能は利用できなくなります」と確認が出る。
• プリインストールプラグインを外しても容量はほとんど空かない：インストールパッケージ内の元の .tgz はプログラムディレクトリの plugins/ に残っており、消えるのはプロファイル内のインストール副本だけである。本当に軽くしたいなら、これらのパッケージを含まないインストールパッケージに替えるべきで、一つずつアンインストールするのではない。
• 入れ直す：設定 → デスクトップツール →「セットアップウィザード」を第 6 ページまで進めて「完了して開始」を押すと、プロファイルに足りないパッケージを補ってくれる。9.5 の経路から手動で入れることもできる。
• 保護されたコンポーネントは触れない：プラグイン管理自体に必要なコンポーネント（Host、Web サービス、ファイルアクセスなど）には「プラグイン管理に必要です。無効化もアンインストールもできません」と表示される。dsh-base、dsh-web-app のような組み込み基本コンポーネントは管理可能な一覧にすら入らず、「設定 → 組み込みプラグイン」で状態を見るしかない。

9.5 自分でプラグインを入れる：3 つの経路

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

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

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

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

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

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

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

9.7 プラグインでアプリが壊れたときは

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

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

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

10.1 セーフモード

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

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

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

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

制限（設計どおり）：

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

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

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 版：内容は対応しており、突き合わせに便利である。
• CHANGELOG.md：各バージョンの変更点。2.2.9 の項目には本冊と一致する「プリインストールプラグイン一覧（35 個）」がある。

謝辞

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

同梱される 35 個のプラグインは、以下の作者とチームによるものである（名称順。同じ作者が複数を担当する場合がある）：

各プラグインの具体的なバージョン、作者、完全な説明は、同梱の plugins/manifest.json に書かれており、プラグインページの詳細でも確認できる。

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