notatestuser/ds4-control

DS4 Control – DeepSeek V4 モデル用のmacOSメニュー・バーUI（`ds4`サーバー経由）

何であるか – DeepSeek V4（Pro および Flash バージョン）を提供するローカルの ds4‑server プロセスを実行、監視、操作できるネイティブSwiftメニュー・バーアプリ。このアプリは推論を自ら行わない。外部サーバーの管理、モデルファイルのダウンロード、チャットまたはコーディングエージェントへのワンクリック起動を提供するのみ。

なぜ重要か – Macで100GB以上のLLMを実行するには、RAM、GPUワイヤードメモリ制限、プロセス監視を慎重に扱う必要がある。DS4 Controlはこれらの作業を自動化し、リアルタイムのリソース使用状況を表示し、マシンのMetalワイヤードメモリ予算を超えるモデルの起動を防ぐ。

コア機能

機能	得られるもの
サーバーのライフサイクル	`ds4‑server`バイナリの起動/停止、stderrから`listening on http://…`の行を監視、`/v1/models`のヘルスチェックをポーリング、適切な終了処理。
モデルセレクター	V4 Pro (0813) または V4 Flash (0731) を選択。UIはRAMとMetalワイヤード制限をチェックし、収まらないオプションを無効化。
内蔵ダウンローダー	並列・再開可能なGGUFモデルファイルのダウンロード、リアルタイムプログレスバー。外部ツール不要。
リソースウィジェット	メニュー・バーのポップアップに統合メモリ、GPU、CPU、電力/ANE使用率のミニゲージを2秒ごとに更新。
ワンクリックエージェント	チャットウィンドウ、Claude Code、Pi（ローカル「エージェント型コーディング」ツール）を起動するボタン。実行中のモデルと通信。
1 Mトークンのコンテキスト	最大100万トークンまで設定可能（Proのデフォルト；小容量RAMではFlash用に低いデフォルト）。
起動時統合	macOS起動時にサーバーを自動起動するオプション。
セーフティゲート	必要なMetalワイヤードメモリが超過する場合、正確な`sysctl iogpu.wired_limit_mb=…`コマンドとヘルパー・ダイアログを表示。

使用すべき人

Mac‑siliconのパワーユーザー：96 GiB以上のRAMを持ち、DeepSeek V4をローカルで実行したい人。
開発者：コマンドラインスクリプトを弄らずに、コーディング支援用のローカルLLM（Claude Code、Pi）を素早く起動したい人。
研究者：異なる推論効率レベル（Standard、Instant、Max Think）を実験し、リアルタイムのシステム影響を確認したい人。

インストール（クイック）

brew install --cask ds4-control   # Homebrew Caskが署名済み.dmgを提供

またはGitHubリリースページから最新の署名済み.dmgをダウンロード、またはHomebrew Cask URL経由でインストール。

ソースからのビルド（貢献者向け）

上流のds4サーバーを含むサブモジュールを取得：
```
git submodule update --init --recursive
```
サーバーをパッチ適用・コンパイル（THINK_MAX機能のため必須）：
```
bash scripts/apply-ds4-patches.sh
make -C external/ds4 -j ds4-server
```
ビルド済みサーバーでアプリを実行：
```
DS4_DIR="$PWD/external/ds4" swift run
```

配布可能なバンドルを作成するには：

bash build.sh   # Apple開発証明書で署名、またはアドホックにフォールバック

動作の裏側

SupervisorService – Swift Processラッパー。ds4‑serverを起動、準備完了ラインを解析、ヘルスエンドポイントをポーリング、適切な終了処理を実行。
MetricsManager – Mach、IOKit、およびプライベートIOReportAPIを介して2秒ごとにCPU、メモリ、GPU、電力のサンプリングを行い、UIウィジェットにフィード。
Feasibility – 選択されたモデルがRAMおよびMetalワイヤードメモリ制限に収まるかを計算し、安全なデフォルトコンテキストサイズを導出し、必要に応じてユーザーに必要なsysctlコマンドを提示。
すべての重いロジック（適合性計算、再開可能なチャンクダウンローダー、ステートマシン）は純粋なSwiftで実装され、ユニットテストでカバーされている。

ライセンス

MIT – リポジトリのLICENSEファイルを参照。

結論 – DS4 Controlは、DeepSeek V4をローカルで実行するために必要な手動設定を排除し、モデルの起動、システム健全性の監視、チャットまたはコーディングエージェントの起動をワンクリックで可能にする、洗練された署名済みmacOSユーティリティです。