T-Auto/dsh-ops

A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件,旨在减少 Token 消耗与任务耗时

dsh-ops – AI 駆動の DSH シェルをより効率化する Windows 向けプラグイン

概要 – dsh-ops は、DeepSeek Harness (DSH) プラットフォーム用のプラグインで、自己完結型の bash 5.3.15、PowerShell 7.6.6、およびいくつかの小さな Rust ユーティリティをバンドルしています。その目的は、AI エージェント(LLM 駆動のコード生成やデータ分析ボットなど)が Windows x64 上でシェルコマンドをより速く、低トークンコストで実行できるようにし、Windows に付属する遅くてエラーが発生しやすい PowerShell 5 を回避することです。

AI にとって重要な理由 – LLM を使用してタスク(ファイル検索、ログ解析、モデルトレーニングスクリプトなど)をオーケストレーションする場合、モデルとの往復ごとに トークン が消費されます。より短く、より決定的なコマンド出力は、トークンが少なくなり、モデルが大きな JSON ペイロードを解析するのを待つ時間も短縮されます。軽量な bash インタープリタと Rust ベースのファイル検索/置換ツールを提供することで、dsh-ops はモデルが読む必要のあるテキスト量を減らし、ワークフロー全体を高速化します。

主な機能(README に記載)

機能 説明 AI 関連の利点
バンドルされた bash 5.3.15 DSH コマンドのプライマリシェルとして実行。必要な場合のみ PowerShell 7 にフォールバック。 一貫性のある高速なコマンド実行。PowerShell 関連のトークン浪費を回避。
バンドルされた PowerShell 7.6.6 bash が処理できない場合にネイティブな Windows 操作を提供。 追加インストールなしでモデルが Windows API にフルアクセスできる。
Rust ファイルツール(ops_inspect_local_file、ops_grep、ops_glob、ops_replace) 高性能なテキスト検索、正規表現 grep、グロブ、一括置換。 簡潔な出力(トークンが少ない)を生成し、LLM が要求する可能性のある大規模ファイル操作を高速化。
バックグラウンドタスクマネージャー(ops_run_background、ops_job_*) 長時間実行ジョブ(モデルトレーニング、シミュレーションなど)を開始、一覧表示、終了。 AI が重いワークロードを fire-and-forget で実行し、チャットの応答性を維持。
細かいコンポーネントのトグル 3 つのコンポーネント(シェル、ファイルツール、バックグラウンド)は、DSH UI または設定ファイルから有効/無効にできます。 開発者は LLM が必要とする正確な機能に合わせてプラグインを調整でき、攻撃面とトークンのノイズを削減。
厳格な JSON スキーマとトークン節約ガイドライン ops_bash は未知のキーを拒否し、短い command と長い script_path を分離。 モデルのターン全体を無駄にする不正なツール呼び出しを防止。

インストールとライフサイクル

  • npm パッケージ dsh-ops として配布。DSH プラグインマーケットまたは npx dsh-ops@latest install --profile <desktop|web|tui> でインストール。
  • 3 つの DSH プロファイルをサポート:desktop、web、TUI 製品(dsh-tui)。
  • 更新は同じインストールコマンドを再実行して行います。アンインストールは npx dsh-ops@latest uninstall --profile …。
  • すべてのバイナリはバンドルされており、インストーラーはシステムの PATH を変更したり、グローバルに何もインストールしたりしません。

設定(YAML スニペット)

config:
  enableShellTools: true          # バックグラウンドコンポーネントを有効にする(フルアクセスセッションが必要)
  publishBashTool: true           # ops_bash をモデルに公開
  promptPolicy: true              # ランタイムガイダンスをモデルプロンプトに注入
  toolCallTimeoutMs: 300000       # FastCtx 呼び出しの RPC タイムアウト
  shellPolicy: advise             # deny-host-shell に設定してホストシェルをブロック可能
  allowSystemShellFallback: false # バンドルされた bash を強制し、PATH へのサイレントフォールバックなし

これらのフラグで、モデルがバンドルされたシェルを呼び出せるか、バックグラウンドジョブを許可するか、ホストシステムへのフォールバックに対するプラグインの厳格さを制御できます。

制限事項

  • 現在はWindows のみ(x64)。Linux/macOS のサポートは計画されていますが、バンドルされた bash コンポーネントは含まれません。
  • DSH 0.2.0-rc.2 ランタイムが必要。古い DSH バージョンでは動作しません。
  • Rust ファイルツールは DSH のサンドボックス化されたファイルシステムの外で動作するため、セキュリティサンドボックスの解決策ではありません。

ライセンス – コアプラグインコードはデュアルライセンス MIT + Apache-2.0(プラグイン自体は MIT、ベンダリングされた FastCtx ライブラリは Apache-2.0)。外部バイナリ(Git for Windows、PowerShell)は元のライセンスを保持します。

結論 – dsh-ops は、AI 駆動のエージェントが Windows 上でシェルコマンドをより効率的に実行し、トークン使用量と実行時間を削減するための、本格的で焦点を絞ったユーティリティです。これは AI 運用分野の実際のソフトウェアプロジェクトであり、一般的なチュートリアルやリストではありません。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト