ディレクトリに戻る

dsh-agents-notch

キュレーションリスト掲載メンテナンス: 活発

iarxic/dsh-agents-notch

WindowsのDeepSeek Harnessに常時表示のノッチ型モニターを追加。各セッションの作業中・要対応・完了の状態を確認できます。

GitHub で見る
$ dsh plugin --profile web add dsh-agents-notch

19

スター

0

フォーク

JavaScript

言語

MIT

ライセンス

2026-10-21

作成日

2026-11-10

最終プッシュ

MIT ライセンスの DSH プラグイン。Windows 10/11 の画面の上端に常時最前面のノッチを置き、どの DeepSeek Harness セッションが作業中・自分を待っている・完了・失敗なのかを表示し、Open でそのセッションへ直接切り替えられます。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-15

ライセンス

MIT

01どんなタスクに使えるのか?

  • 別のウィンドウで作業していても、どの DeepSeek Harness セッションが自分を待っているかを一目で知る

    画面上端の常時最前面タブ。セッションが自分を求める・失敗する・完了すると理由付きのアラートに数秒広がり、Open ボタンでアプリをそのセッションへ切り替える

    複数の DSH セッションを同時に走らせ、確認のたびに alt-tab でサイドバーを読み直すコストを払っている人

  • 折りたたみ式のボードで各セッションの状態・コンテキスト使用量・現在のステップをまとめて確認する

    直近に変化したセッション(タイトル・プロジェクト・経過・コンテキスト使用量・実行中のツールや質問)を上に、ほかのセッションを下のスクロール一覧に表示

    harness を最小化するかトレイに置いたまま、アプリを前面に出さずに全体を把握したい人

  • アプリを見張らなくても、セッションの完了や失敗に気づく

    新しいイベントだけの数秒アラート(自分を待つ・失敗・完了)と、ホストが応答しなくなったときに灰色になり最後のハートビートを記すタブ

    長時間のエージェント実行を任せ、変化があったときだけ通知してほしい開発者

02DeepSeek Harness への導入方法

前提条件

  • Windows 10/11 x64 —— ウィンドウは WPF と Win32 の実装で、macOS / Linux 向けビルドはありません
  • DeepSeek Harness —— プラグインは 0.2.1-rc.2 でビルド・検証されています
  • プラグインに Node 22 以上(.NET ランタイムは不要で、配布されるウィンドウは自己完結です)
  • 任意:`session-finished` プラグイン。完了した行はこれが片づけます

インストール手順

  1. 01

    `dsh plugin --profile web add dsh-agents-notch` を実行します。harness を別の profile で動かしている場合は `web` をその profile 名に置き換えます

    $ dsh plugin --profile web add dsh-agents-notch

  2. 02

    初回実行にウィンドウを取得させます。本リポジトリの GitHub リリースから 65 MB のファイルを 1 つダウンロードし、公開された SHA-256 と照合します

導入成功の確認

  • ノッチが出ない場合は `$DSH_HOME\state\agents-notch\host-report.jsonl` の最終行を確認します。ホストがウィンドウを探した場所、ダウンロードの成否、修正用のコマンドが書かれています

ロールバック

  • `dsh plugin --profile web remove dsh-agents-notch` でプラグインを削除します
  • `Remove-Item -Recurse "$env:DSH_HOME\state\agents-notch"` で状態ファイル・ログ・ウィンドウバイナリ・展開キャッシュを削除します

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

`dsh plugin` CLI で追加するネイティブ DSH プラグイン。ホスト側が DSH のセッションイベントを読み、アプリ内側が独立した常時最前面の WPF ウィンドウを動かします

  • 常時最前面のセッションノッチ

    プラグインのホスト側が報告する DSH セッション(作業中・自分を待つ・完了・失敗)→上部のタブに 1 セッション 1 体のボット —— 作業中はゆっくり回る青い弧、自分を待つときは琥珀色、完了は緑、失敗は赤

    フォーカスを一切取らず、ポインタが通り過ぎるだけならタブは薄くなり、クリックは下のウィンドウに抜けます全画面アプリの下では自動的に隠れます
  • 展開できるボード

    ポインタをタブの上で 1.6 秒止める、または画面の上端へ押し当てる→大きいボットに直近に変化したセッション(タイトル・プロジェクト・経過・コンテキスト使用量・実行中のツールや質問全体)、その下にほかのセッションのスクロール一覧

    行をクリックするとそのセッションが大きいボットに載り、行をダブルクリックするか Open ↗ を押すと DeepSeek Harness がそのセッションに切り替わります
  • Open ボタン付きのアラート

    新しい「自分を待つ」「失敗」「完了」イベント→タブが数秒だけ広がるアラートで、理由(または最後に実行したツールとセッションのタイトル)と Open ボタンを表示

    新しいイベントだけを通知します。1 時間待っている質問はボードに載るだけで、目の前には出てきません
  • 専用の設定ペインと YAML の設定行

    設定 → Agents Notch、または `$DSH_HOME/profiles/web/cordis.patch.yml` の同じ id の行→サイズ・アンカー・画面・行数・不透明度・モーション・ポインタの挙動・アラート種別・`contextBudget`。変更は次の tick で反映され、再起動は不要

    ペインが `$DSH_HOME/state/agents-notch/settings.json` に書いた値は、profile の `config:` 行より優先されます
  • 初回実行時のウィンドウ自動取得とハッシュ照合

    `autoDownload` が `true` の状態での初回実行→状態ディレクトリに置かれる自己完結の WPF ウィンドウバイナリ(公開された SHA-256 と照合済み)

    本リポジトリの GitHub リリースから 65 MB のファイルをダウンロードするため、初回実行にはネットワークが必要です`autoDownload: false` でダウンロードを止め、`downloadUrl` でミラーや自前ビルドのウィンドウを指定できます

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • 複数の DSH セッションを同時に走らせ、確認のたびに alt-tab でサイドバーを読み直すコストを払っている人
  • harness を最小化するかトレイに置いたまま、アプリを前面に出さずに全体を把握したい人
  • 長時間のエージェント実行を任せ、変化があったときだけ通知してほしい開発者

不向きな用途

  • Windows のみです。ウィンドウは WPF と Win32 の実装(最前面・フォーカスを取らない・全画面検知)で、package.json は "os": ["win32"] を宣言しています。macOS / Linux 向けビルドはなく、部分対応もありません。
  • manifest に DSH バージョンの宣言がないため、誤った環境へのインストールは止められません。プラグインは 0.2.1-rc.2 でビルド・検証され、ホスト側は session/event、ctx.webServer、ctx.agents、sessionQuery を読み、マウント前のチェックは行いません。
  • ダウンロードされるウィンドウバイナリは署名されていないため、初回実行時に Windows SmartScreen が警告を出します。配布元は本リポジトリの GitHub リリースで、公開された SHA-256 と照合されます。`autoDownload: false` と `tools/install-window.ps1` を使えば手動でウィンドウを置けます。

05互換性・メンテナンス・セキュリティ上の注意

  • Windows のみです。ウィンドウは WPF と Win32 の実装(最前面・フォーカスを取らない・全画面検知)で、package.json は "os": ["win32"] を宣言しています。macOS / Linux 向けビルドはなく、部分対応もありません。
  • manifest に DSH バージョンの宣言がないため、誤った環境へのインストールは止められません。プラグインは 0.2.1-rc.2 でビルド・検証され、ホスト側は session/event、ctx.webServer、ctx.agents、sessionQuery を読み、マウント前のチェックは行いません。
  • ダウンロードされるウィンドウバイナリは署名されていないため、初回実行時に Windows SmartScreen が警告を出します。配布元は本リポジトリの GitHub リリースで、公開された SHA-256 と照合されます。`autoDownload: false` と `tools/install-window.ps1` を使えば手動でウィンドウを置けます。
2026-10-212026-11-10v0.2.1

MIT · latest release v0.2.1 (2026-11-10)

06よくある質問

Agents Notch は DSH にどうやって入れますか?

`dsh plugin --profile web add dsh-agents-notch` を実行します。harness を別の profile で動かしている場合は `web` をその profile 名に置き換えます。プラグイン本体は約 30 KB で、初回実行時に本リポジトリの GitHub リリースからウィンドウ(65 MB のファイル 1 つ)をダウンロードし、公開された SHA-256 と照合します。

macOS や Linux でも動きますか?

動きません。ウィンドウは WPF と Win32 の実装(最前面・フォーカスを取らない・全画面検知)で、`package.json` は `"os": ["win32"]` を宣言しています。README にも macOS / Linux 向けビルドはなく、部分対応もないと明記されています。

必要な DeepSeek Harness のバージョンはありますか?

manifest に DSH バージョンの宣言がないため、誤ったバージョンへのインストールは止められません。プラグインは 0.2.1-rc.2 でビルド・検証されており、ホスト側は session/event、ctx.webServer、ctx.agents、sessionQuery を読み、アプリ内側は uiWorkspace を使います。古いビルドではその一部が欠けていることがあり、マウント前のチェックはないので、欠けた項目はホストを止めずにログへ出ます。

コンテキストのパーセントが表示されないのはなぜですか?

コンテキストウィンドウはモデルルート側の情報で、セッションのフィードには含まれないため、`contextBudget` の既定値は `null` です。その場合トークン数だけが出て、パーセントもバーも琥珀色も付きません。ルートの実際のウィンドウ(このビルドの DeepSeek V4 ルートなら `1000000`)を設定すると、パーセントとバーが表示されます。

状態ファイルはどこに置かれ、Open にはアプリの起動が必要ですか?

状態ファイル・ログ・ウィンドウバイナリはすべて `$DSH_HOME/state/agents-notch` の下にあります。README が説明するネットワーク処理は初回実行時の GitHub リリースからのウィンドウ取得と SHA-256 照合だけで、`autoDownload: false` で止められます。ノッチはフォーカスを取らず全画面アプリの下では隠れ、Open はプラグインのアプリ内側を通すため DeepSeek Harness が起動している必要があります。ノッチはタスクバーやトレイからウィンドウを戻せますが、アプリ自体を起動することはできません。

08データと出典

  • 作者による申告github.com80b0f274ad54…

    **An always-on-top notch for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) that answers one quest…

  • 作者による申告github.com80b0f274ad54…

    dsh plugin --profile web add dsh-agents-notch

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-15。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。