CH 01 · 読み方と学習パス
この章の目標
この章では何も操作を教えません。代わりに 2 つだけ伝えます:この本の読み方と、何日かのペースで学ぶか。まず自分に合った学習パスを選び、それから 3 日間の学習プランに沿って進めれば、迷うことはありません。
3 つの学習パス
まず下の図でだいたいのイメージをつかんでください:
ルート 1:初心者むけに通し読み(推奨)
対象:dsh は初めて、Agent を一度も動かしたことがない。
読み方:CH 00 から 1 章ずつ読み進めます。PART 01(CH 02–07)を一気に読み、まず「動く」段階を越えます。次に CH 09「コアサブシステムと 1 メッセージの流れ」を読み、それから CH 08 と CH 10 に戻れば、「なるほど」と膝を打つ瞬間が来ます。
なぜこの順番か:前半の章はリアルなタスクに沿って構成され、一歩ずつが次のステップの土台になっています。飛ばすと必ずつまずき、つまずいてから戻ると余計に時間がかかります。
ルート 2:目的直达(シナリオ直結)
対象:自分が何をしたいか決まっていて、最初からは読みたくない。
読み方:下の表で該当する章に直接飛んでください:
| あなたのゴール | 直接飛ぶ章 |
|---|---|
| とにかく動かすところまで行きたい | CH 03 → 04 → 05 |
| アーキテクチャを理解してから触りたい | CH 08 → 10 |
| MCP エコシステムを接入したい | CH 12 |
| 既存のプラグインを探して入れて使いたい | CH 12 → 17 |
| Agent に定时で仕事をさせたい | CH 15 |
| ローカルにデプロイしたい | CH 16 |
| dsh で PPT / 帳票 / 動画を作りたい | CH 25 → 26 |
| 自分のプラグインを開発したい | CH 18 → 20 → 21 |
| 本番に投入したい | CH 27 → 28 → 29 |
シナリオ直达で飛ばした章で詰まったら、戻って読み直せばよいだけです。恥ずかしいことではありません。最初から通し読みできる人なんていません。
ルート 3:必要箇所だけ深く
対象:すでに dsh を動かせる人、これをツール本として使う。
読み方:問題にぶつかったら目次で対応する章を探し、付録と併用します。付録 A 用語集、付録 B コマンド早見表、付録 C 公式ドキュメント索引、この 3 点が日常の三種の神器です。CH 07 のトラブルシューティング早見表は単体でブックマークする価値あり。
特徴:順番に読む必要はありません。詰まった章だけ読めばよいのです。
3 日間の学習プラン
dsh を一気に集中して通したいなら、下の 3 日プランをそのまま実行してください。1 日あたりの分量は「読みながら手を動かす」前提で設計しているので、ドキュメントを読むだけではありません。
Day 1:動かす、直感を築く
目標:dsh をインストールして使い、dsh で何ができるかを把握する。
読む章:CH 00 → CH 07(PART 00 + PART 01)
やること:
- CH 03 で Node.js と dsh をインストールし、Web UI を立ち上げる
- CH 04 で画面に慣れ、作業ディレクトリを選び、モデルを選び、最初のメッセージを送る
- CH 05 で headless を一度走らせ、「誰も見ていなくても動く」を体験する
- CH 06 でサードパーティのモデルを接続する(例:ローカルモデルや別プロバイダーの API)
- CH 07 でエラーにぶつかったら、トラブルシュート手順を一通りなぞる
終了時の到達点:dsh を起動してメッセージを送り、headless を動かし、サードパーティモデルを接続し、基本的なエラーを読み解ける。
Day 2:骨格を理解し、能力を組み上げる
目標:すべてがプラグイン とは何を意味するのかをつかみ、よく使う能力を接続する。
読む章:CH 08 → CH 16(PART 02 + PART 03)
やること:
- CH 08–10 でプラグインツリー、メッセージの流れ、セッションと軌跡を理解する——この 3 章は理論。コードは書かない、わかれば OK
- CH 11 でツール呼び出しパイプラインと権限承認を理解する
- CH 12 で MCP サーバーを 1 つ接続する(例:Firecrawl)、Agent に Web ページを取得させる
- CH 13 でサブエージェントを一度使い、「他人に仕事を振る」を体験する
- CH 14 で Skill を 1 つインストールする(例:AIHOT)、Agent に既存の能力を使わせる
- CH 15 でスケジューリングされたタスクを 1 つ設定し、Agent に毎日自動で走らせる
- CH 16 でローカルモデルを接続し、「お金がかからない」を体験する
終了時の到達点:dsh のプラグインアーキテクチャを説明でき、MCP を接続し、サブエージェントを使い、Skill をインストールし、定时任务を設定し、ローカルモデルを接続できる。
Day 3:プラグインを開発し、本番投入
目標:自前のプラグインを書き、デプロイと運用を知る。
読む章:CH 17 → CH 23(PART 04)+ CH 27 → CH 29(PART 06)
やること:
- CH 17 でプラグインのインストールと管理を学ぶ
- CH 18–21 で 4 つのプラグインを順に書く:最小プラグイン、サービス、ツール、フック——それぞれ動かす
- CH 22 で UI プラグインを書き、設定ページにタブを 1 つ追加する
- CH 23 でモデルアダプタを理解する(選修、プラグイン開発をしないならスキップ可)
- CH 27 で Docker を使って dsh をサーバーにデプロイし、ドメインを紐付け HTTPS を設定する
- CH 28 でセキュリティチェックリストを一巡りし、権限とキーの設定に過不足がないか確認する
- CH 29 で軌跡の読み方、文脈管理、コスト管理を学ぶ
終了時の到達点:動くプラグインを書け、サーバーへデプロイでき、セキュリティとコストを管理できる。
どのルートでも共通する出発点
どのルートを辿るにせよ、最初に 10 分だけ CH 00 を読むことをおすすめします。3 つの直感だけの章で、操作は出てきません。しかし以降のすべての章の土台です:Agent = Model + Harness、すべてがプラグイン、なぜ今か。
この章で学んだこと
下の項目を自力で達成できれば合格です:
- [ ] この本の 3 つの読み方を言え、dsh を初めて触るならどのルートを辿ればよいかわかる
- [ ] 「目的直达(シナリオ直結)」のゴールと章の対応を言える(少なくとも:MCP 接続は CH 12、プラグイン開発は CH 18 を覚える)
- [ ] 3 日間の学習プランで、毎日何を読んで何をするかを知っている
- [ ] どのルートでも、最初に CH 00 を読んで土台を固めることを知っている