ノードコンソール
ノードコンソールは zqagent のグラフィカルインターフェースです。ノードの管理、プロジェクトの作成、AI との対話、操作の承認、 使用量とコストの確認まで、すべてここで完結し、コマンドを入力する必要はありません。
開き方
| シーン | 入口 | 説明 |
|---|---|---|
| デスクトップ | デスクトップアプリ | ローカルノード内蔵、すぐ使える |
| ブラウザ | ユーザーセンター → ノード管理 → ノードを選択 | 接続済みノードをリモート管理 |
| スマートフォン | スマホのブラウザでユーザーセンターを開く | レスポンシブ + PWA。「ホーム画面に追加」可能 |
リモート管理の前提は、ノードがユーザーセンターに接続されていることです。ノードの起動をご覧ください。
ノードとプロジェクト
- ノード管理：ユーザーセンターで作成し、1 つのノード管理で複数デバイスを扱えます。ノード一覧にはオンライン状態が表示され、 クリックするとノードコンソールに入ります。
- プロジェクト管理：1 つのプロジェクトはノード上の作業ディレクトリに対応し、AI が読み書きする範囲です。 新規作成時にノードのディレクトリを参照して選べるため、パスの手入力ミスを防げます。
- モデル選択：ノード単位で既定モデルを設定でき、セッション単位で個別に指定することもできます。
トップバーでノードとプロジェクトを素早く切り替えられ、プロジェクト管理ダイアログを開いてまとめて管理できます。
セッションワークベンチ
- セッション一覧：ピン留めと検索に対応し、過去のセッションをすぐ見つけられます。
- タブ：複数セッションを同時に開け、タブの状態は永続化（更新後も維持）されます。右クリックメニューと折りたたみにも対応。
- タイムライン：会話とツール呼び出しを時系列で表示し、長いセッションでも全体を振り返れます。
- 入力下書き：未送信の内容は自動保存され、セッション切り替えやページ更新後に自動で復元されます。
- ファイル編集：内蔵エディターは元に戻す/やり直し、Markdown ハイライト、スクロール同期に対応します。
承認と質問
AI が副作用のある操作（ファイル書き込み、コマンド実行など）を要求したときや、補足情報が必要なときに、セッション内にカードが表示されます：
- 承認は 4 種類から選べます：今回だけ許可 / このツールを常に許可 / このコマンドを常に許可 / 拒否。 「このコマンドを常に許可」は
run_shellのときだけ表示され、コマンド単位で許可するため、ツール全体を許可するより安全です。 - 質問は組み込みの選択肢と自由入力に対応します。
未処理のカードは残り続け、後で処理できます。CLI の承認セマンティクスと同じです。詳しくは CLI の使い方 をご覧ください。
使用量とコスト
zqagent はモデル呼び出しごとに記録し、ノードとアカウントの 2 層で集計します：
- 使用量を見る：プロジェクトのトップページの token カード、またはノード詳細の「モニタリング → 使用量を見る」でパネルを開きます。 期間フィルター、日別棒グラフ、モデル別統計、明細一覧に対応し、CSV エクスポートも可能です。
- 価格表：一般的なモデル（OpenAI / DeepSeek / Qwen / Zhipu / Moonshot など）の既定単価を内蔵し、 「価格表」で必要に応じて変更できます。コストはあなたの価格で換算されます。
- アカウント単位の使用量：ユーザーセンターにログインすると、アカウントページでノード横断の使用量を確認できます。
リアルタイム性と安定性
- セッションはリアルタイムイベントストリームで配信され、切断時は自動再接続してカーソルで差分を補います。バックグラウンドから戻ったときや ネットワークが復旧したときも、内容が欠落したり重複したりしません。
- サーバーは定期的にハートビートを送るため、長時間操作がなくてもアイドルと誤判定されて頻繁に再接続することはありません。
- ノードのオンライン/オフライン、タスク通知（承認/質問/エラー）はリアルタイムで通知されます。
モバイル
- 狭い画面（≤ 720px）では自動で 1 カラムになり、「概要 / コンソール」を切り替え、セッション一覧と会話を行き来します。
- 「ホーム画面に追加」に対応し、独立したウィンドウで動作します。
次のステップ
- ノードの起動：インストールしてユーザーセンターに接続
- リモート操作の概要：スマートフォンと QQ から遠隔でタスクを依頼
- REST インターフェース：連携開発のリファレンス