ccch1mneyyy/dsh-TUI

dsh‑TUI – DeepSeek Harness 用の Claude 風ターミナル UI

何であるか

• 公式 dsh CLI（DeepSeek Harness）の上に、豊かなグラフィカルなテキストユーザーインターフェース（TUI）を追加するプラグインです。コアエンジンを変更するものではなく、既存の DSH サービスと通信する UI レイヤーをマウントするだけです。
• UI は Claude Code の見た目を模倣しています：ピクセルアートのクジラバナー、発光するタイトル、ライブステータスバー、プログレスバー、TPS（1秒あたりトークン数）ゲージ、およびストリーミング Markdown、ツールカード、画像添付のサポートを備えています。

なぜ重要か

• 長時間実行される AI エージェントセッションをターミナルから使いやすくします。モデルのトークン数、キャッシュヒット率、現在の「エージェント」状態をリアルタイムで確認できます。
• DeepSeek Harness の機能を反映した完全なコマンドセット（/new, /resume, /model, /audit, …）を提供。ツール実行、サブエージェント、承認フローなども、同じウィンドウ内で可能。
• 低リソース環境向けに設計：仮想スクロールにより、非常に長いチャットでもレンダリングコストが可視ウィンドウサイズに比例（O(visible-window)）に保たれます。

主な機能（README に記載）

機能	得られるもの
ネイティブターミナル操作	ストリーミング Markdown、構造化ツールカード、コマンド/ファイル補完（@-ファイル参照含む）、画像添付処理、履歴検索、インライン/代替スクリーンレンダリング、言語切り替え（/lang）。
エージェント状態の可視化	リアルタイムの作業ステータス行、コンテキストセグメントプログレスバー、TPSゲージ、キャッシュヒット率、推論レベル、トークン数、Git/セッション情報。
完全なセッションワークフロー	新規/再開/コンパクト/エクスポートセッション用コマンド、サイドクエスチョン（/btw）、モデル切り替え、二重 Esc による時系列巻き戻し/フォーク。
DeepSeek Harness 統合	エージェントプリセット、スキル、MCP（リモートツールサーバ）、目標、タスク、サブエージェント、ask_user_question フローアクセス。
長時間セッション設計	イベント駆動型プロジェクション、差分ベースのターミナル出力、メッセージ仮想化、バウンデッドキャッシュ、メモリ爆発防止。
テーマシステム	ターミナル背景の自動検出、組み込みのライト/ダーク/ANSI テーマ、~/.dsh‑tui/themes/ に配置したカスタム JSON テーマ。
キーボード・マウスショートカット	ホットキー一覧（Enter、Ctrl‑C、Esc、Ctrl‑O、Ctrl‑R など）に加え、マウスドラッグによるコピー、スクロール、クリックによる選択。
プラグインエコシステム	拡張開発のドキュメント、コミュニティリポジトリ（dsh‑tui‑ecosystem）、テンプレートスターター。

インストールとクイックスタート

# コア DSH CLI と TUI プラグインをグローバルにインストール
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 起動 – 最初の実行でプロファイルが自動作成される
dsh-tui

• TTY ターミナル、pnpm 10+、およびモデル呼び出し用の DEEPSEEK_API_KEY を必要とします。
• Windows ではバンドルされた dsh-tui.cmd を実行できます。
• dsh-tui --resume コマンドで最後のセッションを復元できます。/update でプラグインをインプレース更新可能です。

内部の動作仕組み

1. dsh は プロファイル を読み込み、ベースの DSH 実装 → dsh‑TUI Cordis パッチ → 選択されたエージェントプリセット のチェーンを構築します。
2. セッションイベントは、プロセス内イベントストリームを介して DSH バックエンドから TUI へ流れます。
3. UI は移植された Ink/Yoga レンダラーを使用し、インクリメンタルな差分更新とレイアウト仮想化により、パフォーマンスを一定に保ちます。
4. すべての永続化（チャットログ、ツール結果など）は DSH サービスの責任です。TUI は状態の表示のみを担当します。

通常のワークフロー

• dsh-tui を起動 → クジラバナーとステータスラインを確認。
• プロンプトを入力（Enter で送信、Shift‑Enter で改行）。モデルから Markdown がストリーミングされ、ツールカードがインラインで表示されます。
• /model で異なるモデルを選択、/preset でエージェントモードを変更、/new で新しい会話開始。
• 空行で二重 Esc を押すと、セッションを 巻き戻し（以前のポイントから新しいブランチをフォーク）。
• /export で会話全体をエクスポート（Markdown）または / で履歴を検索。

コミュニティとサポート

• DeepSeek Harness パブリックベータ WeChat チャンネルで公式紹介。
• すぐに助けが必要な場合は専用の QQ グループ（572549239）と WeChat グループをご利用ください。
• ドキュメントにはインストール、設定、テーマカスタマイズ、操作詳細、アーキテクチャ、VS Code 統合、プラグイン開発、貢献ガイドラインが含まれます。

ライセンス

• MIT – 使用・変更・再配布を自由にできます。

---

上記のすべての情報はリポジトリの README から直接取得したものであり、追加機能は推測されていません。