ドキュメント

1. デスクトップアプリをインストール

ダウンロードページ から Windows / macOS / Linux のクライアントを入手してインストールします。起動後、上部に常設の入口が2つあります。Home（資産とセッション）と Deck（運用アシスタント）です。日常の資産は Home のサイドバーにあります：ホスト、キー、転送、ジョブ、設定。

• 設定では、既定のローカルターミナル（アシスタントとローカルシェルがそこで動きます）とシステム言語を変えられます。
• デスクトップアプリにはウェブサイトのアカウントが必要です。Free アカウントはローカルの接続と管理機能をすべて使えます。クラウド同期、監視、AI実行には Pro が必要です。

2. ログインする——クラウドモデルはすぐ使える

アシスタント、コマンド提案、監視の探索は、既定でクラウドモデルを使います。ログインすれば始まり、モデルキーの設定は不要です。

1. ログインページ でメールまたは Google / GitHub でログインし、「このマシンを認可」を選びます。デスクトップアプリが現在のアカウントを受け取ります。
2. クラウドモデルの一覧はアカウントに付いて配信され、Deck 入力欄のモデル選択から直接選べます。
3. クラウドモデルの利用はサブスクリプションのクォータに計上されます。先に月次クォータ、その後に残高です。Free にも毎月、限られたクラウドクォータと提案回数があります（基本モデルのみ）。
4. 現状、月次クォータの使用量、残高は アカウント → サブスクリプション で確認します。

Pro を契約すると、クラウド同期、監視、AI実行、クラウドモデルの全カタログが解放されます。購入はデスクトップアプリ内。更新はアプリストアが管理します。料金 を参照してください。

3. デバイスとキーを登録する

セッション、アシスタント、ファイル転送、転送は、同じ資産を共有します。先に「誰に、何でつなぐか」をインベントリへ入れれば、接続情報を何度も組み立てなくて済みます。

キーを作成する（先に推奨）

1. Home → キー → 新しいキー。
2. 公開鍵と秘密鍵を貼り付けます。パスフレーズがあれば追加し、証明書が必要なら貼り付けます。
3. 対応するのは OpenSSH 形式のみです。PuTTY の PPK は先に OpenSSH へ変換してください。

デバイスを追加する

1. Home → ホスト → デバイスを追加（空の状態でも「まだデバイスがありません。クリックして追加」と出ます）。
2. 基本情報：名前、ホスト、種類、グループ。種類はコマンド提案と一部のデバイス側の対話に影響するので、慎重に選んでください。
3. 必要に応じて SSH（既定ポート 22、ユーザー名、パスワードまたはキー）、Telnet（既定ポート 23）、RDP（ドメイン、解像度、セキュリティ層など）を記入します。
4. SSH にはセッション再利用、SSH agent、認証方式の追加オプションがあります。Telnet にはプロンプト検出とコマンドエコー検証、RDP には色深度、キーボード配列、ドライブのリダイレクトがあります。
5. 保存するか、そのまま 保存して接続 します。

パスワード、キーなどの機密資産はローカルデータに留まります。ウェブサイトへのログインで、クラウドのインベントリとしてアップロードされることはありません。

4. セッションを開く

アシスタントに渡す前に、対象へ届くことを確認します。ホストカードをクリックし、プロトコルを選んで開きます。

• SSH / Telnet：ターミナルペインが開きます。初回接続ではホストフィンガープリントの確認を求められます。変化したフィンガープリントはアラートになり、拒否、今回だけ信頼、永続信頼を選べます。
• SFTP：SSH と同じ認証を使い、二ペインのファイルビューが開きます。
• RDP：Windows デスクトップに入り、クリップボードとローカルドライブを共有します。
• ローカルシェル：ホストツールバーからターミナルを選びます（Command Prompt / PowerShell / WSL など。マシンで見つかったものに依ります）。
• 切断後は 再接続 を使います。上部の + で新しいタブを開き、最近の接続に戻れます。
• ペイン内の ターミナル設定（フォント、テーマ）と 検索 は、セッションを中断せずに調整できます。

タブはドラッグで並べ替えたり、分割ビューに結合できます。2台を並べて見るときは結合し、集中したいときはタブバーへ戻します。

5. ファイル転送とトンネル

二ペインのファイル

セッション内で SFTP を開くと、ローカルとリモートが並びます。よく使う操作：開く、対象ディレクトリへコピー、新しいフォルダ/ファイル、名前の変更、削除、権限変更、隠しファイルの表示、パスのコピー。競合時は案内に従いスキップか上書きを選びます。進捗はペイン下部に残ります。

トンネルと転送

1. Home → 転送 → 新しい転送。
2. 種類を選びます。ローカル（ローカルポートを対象環境へ）、リモート（リモートポートをこちらへ戻す）、ダイナミック（SOCKS5 プロキシ）。
3. 名前、ポート、バインドアドレス、対象ホストとアドレスを記入し、転送を開始 で切り替えます。状態はアイドル、実行中、エラーです。

ファイルと転送はアシスタントに依存せず、単独でも使えます。

6. 運用アシスタントを使う（Deck）

上部で Deck に切り替えます。左側は新しいチャット、スキル、MCPサーバー、最近のチャット、デバイス参照。中央は会話とツール実行の領域です。

最初の会話

1. ツールバーでモデルが選ばれていることを確認します。クラウドモデルはログイン直後から使えます。
2. 承認モードは その都度確認する（既定）のままにします。操作ごとに許可またはスキップをクリックします。
3. 入力欄左の + でデバイス、グループ、スキル、画像を追加するか、デバイス参照からドラッグします。参照は文脈チップになり、アシスタントが範囲を把握します。
4. 目標を自然言語で述べます。まずは読み取り専用の点検から。CPU、ディスク、主要なインタフェースの状態などです。
5. 操作の確認待ちでは 許可 または スキップ を選びます。繰り返す同種のコマンドは「常に許可」で、同じ型の中断を避けられます。

承認モード

• その都度確認する：操作ごとに許可またはスキップをクリックします。
• 私のために承認する：リスクありと判定された操作だけ、承認を求めます。
• すべて許可：手順ごとの確認はありませんが、危険コマンドは遮断されます。危険語の一覧はカスタムできます。流れを知るまで、この段階は使わないでください。

7. 内蔵ツール

アシスタントには39の内蔵ツールがあり、デバイス実行、ファイルとドキュメント、資産検索、コード検索、ウェブアクセス、監視をカバーします。変更を伴う操作は先に承認モードを通り、照会は直接実行されます。

デバイス実行

• ローカルコマンド：このマシンでコマンドを実行します。長いタスクはバックグラウンドへ移り、プロセス一覧、出力の読み取り、終了はいつでもできます。
• SSH / バッチ SSH：登録済みの1台または複数台でコマンドを実行します。バッチでは並行します。
• Telnet：ネットワーク機器などの Telnet 対象でコマンドを実行します。

ファイルとドキュメント

• SFTP転送：このマシンとデバイスの間でアップロードとダウンロード。
• ファイルの読み取り / 編集：ローカルとリモートのテキストを読み、正確な置換を適用します。
• ドキュメント処理：PDF の読み取り、Excel と Word の読み書き、点検レポートの直接作成。

資産と文脈

• デバイス / グループ / スキルを探す：インベントリ資産を、いつでも文脈として検索できます。
• チャット履歴とタスクリスト：過去の会話を辿り、多段階の作業をチェックリストとして保てます。

コードと参照

• コードツール：リポジトリの構造マップ、内容検索、シンボル定義と参照。
• 探索サブエージェント：大きなディレクトリや長いドキュメントを読み取り専用で並行探索し、要約を本チャットへ戻します。
• ウェブ検索 / ページ取得：外部参照を検索し、ページ内容を取得します。ウェブ検索はアカウントに付きます。

監視とスキル

• 指標の読み書き：デバイスの監視指標を読み、確認後に指標の追加や変更ができます。
• スキルの蒸留：いまの手順を新しいスキルとして書くか、既存を更新します（確認が必要です）。

典型的な場面

• 点検：複数デバイスの CPU、ディスク、主要なインタフェース状態を確認し、読める結論にする。
• 変更：設定ファイルを編集してサービスを再起動し、一歩ずつ確認する。
• 転送：リモートログをまとめ、手元へ取り、分析してレポートを出す。
• 障害対応：ウェブ検索とドキュメント読み取りを組み合わせ、エラーの出所を特定する。

8. スキル

スキルは再利用できる Markdown のプロンプト（名前 + 一行の説明 + 本文）です。ローカルのスキルライブラリに保存され、クラウドバックアップに含まれます。

• 作成：Deck → スキル で書く。過去の会話からAIで蒸留する。またはアシスタントが、確認後に新しいスキルを保存する。
• 使用：入力欄の「+ → スキル」、または直接参照。参照すればそのターンは有効なままなので、続きで再度参照する必要はありません。
• 進化：アシスタントは使用中にスキル内容を洗練できます。変更にも確認が必要です。

9. MCPサーバー

アシスタントは MCP（Model Context Protocol）サーバーに接続し、外部ツールを同じ会話へ入れられます。

• トランスポート：stdio（ローカルコマンドで起動）と Streamable HTTP（リモート URL）。
• 設定：Deck → MCPサーバー → 追加。コマンド、引数、環境変数を記入するか、JSON 設定を貼り付けてインポートします。
• 有効化：有効にすると、そのツールがアシスタントのツールセットに入ります。名前が衝突した場合は内蔵ツールが勝ちます。一覧には各サーバーの状態とツール数が表示されます。
• 安全：MCP ツールの呼び出しは、内蔵ツールと同じ承認モードを通ります。

サーバーの準備ができていない間（プロセス未起動、または URL に届かない）、呼び出しは何もしません。先に一覧で状態を確認してください。

10. ターミナルのコマンド提案

設定 → AI能力 でコマンド提案をオンにすると、ローカルまたはリモートのターミナル入力中、カーソルの横に候補が現れます。提案モデルはクラウドで設定され、手元では候補数だけ選びます。

• プレビューと一覧が並びます。Tab で採用、矢印キーで切替。パネルを閉じれば手入力を続けられます。
• パネルには自然言語の意図を入れられます。Enter で候補を生成します。
• 候補は今のセッションとデバイスタイプに従い、その瞬間の方言に合います。
• 提案が出ないとき：スイッチがオンか、ログイン済みか、今のペインが提案に対応するセッション種類かを確認してください。

11. 監視と発見

経路：Home → ジョブ。タブは2つ、監視と探索です。

監視

1. 新しいタスク をクリックし、観測するホストにチェックを入れて確認します。
2. デバイスカードで指標を見ます。詳細を開き、名前、プロトコル、間隔、解析、アラート、AIエスカレーションを設定できます。
3. AIエスカレーションの選択肢：オフ、分析のみ（L1）、確認付き修復（L2）。L2 もアシスタントの確認を通り、設定を静かに変えることはありません。
4. 「今すぐ収集」で、単一指標が期待どおりの値になるかを検証できます。

探索

1. 設定 → AI能力 で探索モデルを選びます（クラウドモデルはログイン後に使えます）。
2. 監視に戻り、デバイスで 指標を自動探索 を開始します。過程は探索中と表示されます。
3. 探索タブで探索の要約と候補を確認します。それぞれ保留または採用済みです。チェックして 採用 をクリックするまで、定例収集には入りません。

探索は候補を出すだけです。収集を自ら始めることはありません。日常に入れるかは、あなたが決めます。

12. プロトコル仕様

SSH、Telnet、RDP、SFTP、ローカルシェルの実装詳細——認証マトリクス、オプション交渉、チャネル能力、信頼モデル、システム要件——は 技術仕様 ページにまとめられ、デスクトップアプリと同期しています。

13. カスタムモデル（上級、任意）

既定では不要です。クラウドモデルはログインすれば使えます。自分のモデルサービスを使うときだけ設定してください。

1. Home → 設定 → モデル → モデルを追加 を開きます。
2. ベンダーテンプレート（OpenAI、Anthropic、DeepSeek、Ollama、OpenRouter、Moonshot、Qwen、Zhipu）またはカスタムのベース URL を選びます。
3. APIキーとモデル名を入力して保存すると、Deck 入力欄で選べます。

カスタムモデルのキーは、このマシンにだけ保存されます。

14. 安全と既定

• アシスタントの既定は「その都度確認する」です。境界を広げる前に、読み取り専用の作業でツール呼び出しのリズムに慣れてください。
• 「常に許可」は同種のコマンドにだけ効きます。全体のミュートではありません。
• 「すべて許可」でも、危険語リストのコマンドは遮断されます。リストはカスタムできます。
• ホストフィンガープリントは初回接続で確認が必要です。変化したときは、想定どおりかを確かめてから、どう信頼するかを選んでください。
• デバイスのパスワード、キー材料、カスタムモデルのキーはローカルの信頼境界にあります。Termini を動かすコンピュータを守ってください。
• アラートの自動修復（L2）は、アシスタントの書き込み操作と同じく、あなたの確認方針に従います。

より詳しい説明は 機能ページ を参照してください。インストール後は、上の 2 → 3 → 4 → 6 の順で最初の一周を完了できます。