アラームスケジューリングをホストプロセスへ引き上げるネイティブ dsh プラグイン。`$DSH_HOME/proactive/` の永続アラーム、冷えたセッションの再開、墓標折り畳みによる静かな起床、静粛時間、1 日の配信上限、SSE で同期する 2 つのパネルを提供します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-10
ライセンス
作者は未記載
01どんなタスクに使えるのか？
モデル自身にフォローアップを予約させ、セッションが冷えていてもブラウザを閉じていても時間どおりにタスクを再開させる
ホスト層のアラーム（once / every / cron / ファイルスケジュール）が対象セッションを起こし、1 ターン実行してハンドルを解放する
長時間・無人で動くエージェントを DeepSeek Harness で運用し、自分から状況確認してほしい人
自律的な起床がユーザーへ通知を撒き散らすのを防ぐ
`proactive_reclaim` で静かに終了し、1 ターン分を約 70B の墓標に折り畳む。加えて静粛時間帯と 1 日あたりの配信上限
プロアクティブなエージェントを使いたいが、不意の通知や長期コンテキストの汚染は避けたいチーム
02DeepSeek Harness への導入方法
前提条件
- dsh 0.2.0-rc.1 以上——それ以前の 0.1.x では dsh の peer チェックでスキップされ、プラグインは読み込まれません
- `web` profile があること（README は `--profile web` で導入）
インストール手順
- 01
$ npm から導入：`dsh plugin --profile web add dsh-proactive`
- 02
または monorepo のサブディレクトリから：`dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive`。commit を固定するなら `#<sha>&path:/packages/dsh-proactive` を使い、初回 add で pnpm に止められたら表示されたパッケージ名を `~/.dsh/profiles/web/pnpm-workspace.yaml` の `allowBuilds` に追加して再実行します
$ dsh plugin --profile web add github:john-walks-slow/dsh-proactive#path:/packages/dsh-proactive
導入成功の確認
- セッションの「主動唤醒」タブ、または設定のコントロールセンターを開く。どちらも `/api/dsh-proactive/events` の SSE でリアルタイム同期されます
- 新しいアラームで「立即触发」ボタンを押し、実際の起床動作を試す
03DSH 統合と能力の範囲
ネイティブなホスト層 dsh プラグイン。`dsh.bundle.patch` を同梱しているため、`dsh plugin add` の後に dsh loader が `cordis.patch.yml` を自動でマウントします（profile の手編集は不要）。すべての root agent に対しホスト層のツール（`proactive_set` / `proactive_list` / `proactive_update` / `proactive_cancel` / `proactive_update_settings` / `proactive_reclaim`）を登録します。
ホスト層のアラームスケジューリング
`proactive_set` に `at` / `after_seconds` / `every_seconds` / `cron` / `schedule_file` のいずれか、さらにジッタ・静粛時間・ターゲットモードを指定→`$DSH_HOME/proactive/` に永続化されるアラーム。サービス再起動後も自動復元
`every` は 300 秒以上、`cron` は隣接する発火が 300 秒以上必要`jitter_seconds` は発火時刻に `uniform(0, jitter)` を加え、同時多発を避ける静かな起床と墓標への折り畳み
報告すべきことが無いとモデルが判断した起床ターン→`proactive_reclaim` を唯一のアクションとして実行——可視テキストを出さず、1 ターンを約 70B の 1 行墓標に折り畳む。人間向けログには全トレースが残る
そのターンは 1 日の可視メッセージ上限を消費しないファイルスケジュールのハンドル
単一の絶対 JSON パスを指す `schedule_file`→ファイル内のエントリから派生する子アラーム。ファイルを書けば追加・更新・削除が反映され、冪等で再起動後も自己修復
1 ファイルにつきハンドルは 1 つ。ファイルが唯一の真実源で、削除は計画の撤回になる原子的書き込みが必須。一時ファイルへ書いて rename し、delete してから create しないSSE によるライブパネル
`/api/dsh-proactive/events` のサーバー送信イベント→セッションの「主動唤醒」タブ（一覧・履歴監査・作成／一時停止／再開／編集／即時発火）と、設定のホスト全体コントロールセンター
全体ガードレールはここに集約：マスタースイッチ、1 日の配信上限、静粛時間帯、新規アラームの既定プロンプト
04誰に向いているのか？使うべきでない場面は？
向いている用途
- 長時間・無人で動くエージェントを DeepSeek Harness で運用し、自分から状況確認してほしい人
- プロアクティブなエージェントを使いたいが、不意の通知や長期コンテキストの汚染は避けたいチーム
不向きな用途
- dsh 0.1.x では peer チェックにより本バージョンはスキップされ、プラグインは読み込まれません。その環境では `dsh-proactive@0.2.3` を使い続けてください。
- 0.2.x からの更新では、旧 `config.scheduleFiles` のグローバル glob が削除されています。各ファイルに個別のハンドルが必要で、dsh を停止して `scripts/migrate-schedule-files.mjs` を実行するか、`proactive_set` / パネルで 1 つずつ作成します。そうしないとそれらのファイルはアラームを生まず、旧機構の `decl_*` アラームは孤児として片付けられます。
- `target_*` を一切指定しないファイルハンドルは、「ファイルの祖父ディレクトリが登録済み workspace である」という規約のみ受け付けます。それ以外はエラーで停止し、`target_workspace_path` か `target_session_id` の明示を要求します。
05互換性・メンテナンス・セキュリティ上の注意
- dsh 0.1.x では peer チェックにより本バージョンはスキップされ、プラグインは読み込まれません。その環境では `dsh-proactive@0.2.3` を使い続けてください。
- 0.2.x からの更新では、旧 `config.scheduleFiles` のグローバル glob が削除されています。各ファイルに個別のハンドルが必要で、dsh を停止して `scripts/migrate-schedule-files.mjs` を実行するか、`proactive_set` / パネルで 1 つずつ作成します。そうしないとそれらのファイルはアラームを生まず、旧機構の `decl_*` アラームは孤児として片付けられます。
- `target_*` を一切指定しないファイルハンドルは、「ファイルの祖父ディレクトリが登録済み workspace である」という規約のみ受け付けます。それ以外はエラーで停止し、`target_workspace_path` か `target_session_id` の明示を要求します。
- プラグイン自身は外部ネットワーク要求を行いません。パネルは `/api/dsh-proactive/*` のローカル dsh サービスを使い、書き込みはファイルハンドルが宣言した単一 JSON パスを除いて `$DSH_HOME/proactive/` 内に限定されます。
README は MIT と明記（facts pack の license は null）· GitHub リリース未発行（latest_release は null）
06よくある質問
セッション内で開始するタイマーと何が違いますか？
セッション内タイマーはフロントエンドやセッションハンドルと寿命を共にするため、セッションが冷えたりページを閉じたりプロセスが回収されると静かに失効します。dsh-proactive はスケジューリングをホストプロセスへ移し、データを `$DSH_HOME/proactive/` に永続化、発火時に `resume` で冷えたセッションを起こし、ターン終了後にハンドルを解放、再起動後も自己修復します。
対応する dsh のバージョンは？
現行版は dsh 0.2.0-rc.1 以上を対象とします。それ以前の 0.1.x では peer チェックでスキップされプラグインは読み込まれないため、その環境では `dsh-proactive@0.2.3` を使用してください。
プロアクティブ起床で通知が大量に来ませんか？
報告すべきことが無い場合、モデルは `proactive_reclaim` を唯一のアクションとして実行できます。可視テキストは出さず、1 ターンはモデル可視コンテキスト内で約 70B の 1 行墓標に折り畳まれます。静粛時間帯は発火自体をスキップでき、1 日の配信上限が可視メッセージ数を制限します。
導入後に profile を手で設定する必要はありますか？
ありません。パッケージが `dsh.bundle.patch` を同梱しているため、`dsh plugin add` の後は dsh loader が `cordis.patch.yml` を自動でマウントします。
ファイルスケジュール型アラームとは？
単一の絶対パス JSON スケジュールファイルに対するハンドル（`type: "file"`）です。自身は決して発火せず、ファイル内のエントリを子アラームとして同期します。子アラームは通常のアラームで、同じスケジューリング・予算・再試行の経路を通ります。
07関連する DSH ワークフロー
archify
by tt-a1i
Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
openviking
by volcengine
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
aitoearn
by yikart
Let's use AI to Earn!
learn-harness-engineering
by walkinglabs
Harness engineering beginner tutorial, from 0 to 1
08データと出典
安装即生效：包内自带 `dsh.bundle.patch`，dsh loader 自动挂载 `cordis.patch.yml`，无需手工改 profile 配置。
插件为每个 root agent 注册以下 host 级工具（冷唤醒会话与普通日常会话均完全可用）：
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-11-10。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。