sync: update from private repo (edc775f2)

ui/src/content/help/14-ssh.md

@@ -3,7 +3,7 @@ id: ssh
 title: SSH リモート操作
 category: advanced
 order: 140
-keywords: [SSH, リモート, exec, アップロード, コンソール, PTY, デプロイ]
+keywords: [SSH, リモート, exec, アップロード, コンソール, PTY, デプロイ, タブ, 複数セッション]
 ---
 
 ## SSH でできること
@@ -56,6 +56,16 @@ MAESTRO は、エージェントが SSH 経由でリモートホストを操作
 
 `ssh-console` piece でタスクを実行すると、エージェントがコンソールセッションを開きます。アクティブなセッションがある間、タスク詳細に「SSH」タブが現れ、ここでターミナル画面をリアルタイムに見て、人間が直接コマンドを打つこともできます。タスク詳細での見方・介入は [実行中のタスクを見る・介入する](./03-running.md) を参照してください。
 
+### 複数のセッションを同時に開く
+
+1 つのタスクで、複数の SSH 接続に同時にセッションを開けます。SSH タブの上部には接続ごとのタブが並び、クリックで切り替えられます。各タブには接続名と、状態を示す丸（接続中 / アイドル / 切断）が付き、**エージェントがそのセッションを操作している間は ⚡ が点灯**します。
+
+- **＋ 接続** ボタンを押すと、別の接続を選んで新しいセッションを追加できます。既存のタブは閉じません
+- 不要になったセッションはタブの **✕** で閉じられます。閉じられるのは、そのセッションを開いた本人か、ワークスペースのオーナー・管理者だけです
+- 画面をリアルタイムに流し続けるのは、いま選んでいるタブだけです。他のタブに切り替えると、それまでの出力（scrollback）を巻き戻して表示します
+- **エージェントが別の接続を開いたり切り替えたりしても、いま見ている画面は変わりません。** 表示が切り替わるのは、ユーザー自身がタブをクリックしたときだけです
+- 同時に開けるセッション数には上限があります（既定 5。admin の設定次第でユーザー単位の上限も加わります）。上限に達すると新しいセッションは開けず、使っていないタブを閉じるよう案内が出ます
+
 ## SSH 接続プロファイルを登録する
 
 接続は、ワークスペースを開いて **設定 → SSH** から登録します（旧「ユーザーフォルダ → SSH 接続」タブは廃止され、ワークスペース設定に集約されました）。個人ワークスペースで登録すれば自分専用、案件ワークスペースで登録すればメンバー共有の接続になります。秘密鍵はワークスペースの鍵で暗号化保存され、メンバーは接続を使えても鍵の中身は見えません。
@@ -76,7 +86,7 @@ MAESTRO は、エージェントが SSH 経由でリモートホストを操作
 4. `ssh-ops` または `ssh-console` を使うタスクを作成して実行する
 5. ssh-console の場合はタスク詳細の SSH タブで画面を確認・操作する
 
-Piece の選び方や `allowed_tools` の考え方は [piece を使う・作る](./05-pieces.md) を参照してください。
+Piece の選び方は [piece を使う・作る](./05-pieces.md) を参照してください。SSH 接続の可否はワークスペースの **設定 → ツール／SSH** で決まります（Piece には書きません）。
 
 ## 他のワークスペースから取り込む