dsh-chief 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,27 @@ All notable changes to **`dsh-chief`** (**DSH 参谋长**) will be documented in
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
+ ## [1.1.0] - 2026-11-15
9
+
10
+ ### Added
11
+ - **Tactical Cockpit & Per-Workspace Intervention Gate**:
12
+ - Workspace-isolated tactical controls (`intervention` strong-intervention gate with risk confirmation modal, consecutive turn cap & stalls circuit breaker, `strictVerify` empirical evidence enforcement, `redlineSentinel` boundary interceptor, and `conciseBrief` bulleted reporting).
13
+ - **Pre-Compaction Harvest-Verify-Compact**:
14
+ - Automatic fact harvesting and disk verification prior to session context compaction without touching sealed cold precipitation vaults.
15
+ - **`/goal` Human Approval Gate**:
16
+ - Pending approval cards before agents mutate long-running `/goal` objectives.
17
+ - **Dual-Vault Archive Architecture**:
18
+ - Multi-cabinet switching (`cabinets`) for active engineering archives alongside a zero-token cold historical precipitation vault (`~/.dsh/chief/precipitated/`) with explicit per-entry unseal/seal (`翻牌启用/封存`).
19
+ - **One-Click Chief Deployment & Media Persistence**:
20
+ - Cross-session Chief deployment cloning safe facts, narrative summary, and workspace preferences (forcing `intervention: false` and `flippedPrecipitatedIds: []`), with 4 archive transfer policies (`none`, `active`, `drawer`, `all`), plus `.dsh-chief-media/` image persistence with path fallback.
21
+
22
+ ### Fixed
23
+ - **DSH Host Compatibility & Subagent API Guardrails (Fixes [#1](https://github.com/gluztm/dsh-chief/issues/1), thanks `@edz017`)**:
24
+ - Tightened `package.json` `engines.dsh` constraint from `">=0.2.0"` to `">=0.2.2-rc.2"` so pre-refactor `subagents` hosts (such as `0.2.2-rc.1`) do not silently fail at runtime.
25
+ - Added `probeSubagentSupport(runtime)` runtime capability detection in `index.js` (exposed via `/api/dsh-chief/snapshot` `hostCompat` + startup warning log) and a dismissible amber banner in `client.js`, while `task.dispatch`, `team.steer`, and `team.interrupt` now return clear Chinese upgrade guidance when `subagents.resolveName` is unavailable.
26
+ - Fixed `sidebarRight.openResource` option key from `preferSeparatePane: true` to `preferNewPane: true` in `client.js`.
27
+ - Added a DSH Host Version Compatibility Matrix to both `README.md` and `README.en.md`.
28
+
8
29
  ## [1.0.0] - 2026-11-14
9
30
 
10
31
  ### Added
package/README.en.md CHANGED
@@ -7,14 +7,14 @@
7
7
  # ✦ DSH Chief (`dsh-chief` · DSH 参谋长)
8
8
  ### Multi-Agent Command Cockpit · SuperAgent Cross-Session Synergy · 4-Tier Cold Archive Vault for DeepSeek Harness
9
9
 
10
- [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.0-38bdf8?style=flat-square)](https://dsh.deepseek.com)
10
+ [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.2--rc.2-38bdf8?style=flat-square)](https://dsh.deepseek.com)
11
11
  [![SuperAgent Ready](https://img.shields.io/badge/SuperAgent-Router--Worker%20Synergy-a855f7?style=flat-square)](https://github.com/deepseek-ai/dsh-superagent-prototype)
12
12
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022.13-30d158?style=flat-square)](https://nodejs.org)
13
13
  [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20External-ffe033?style=flat-square)](#)
14
14
  [![Cold Vault](https://img.shields.io/badge/Cold%20Archive-0%20Token%20Idle-34d399?style=flat-square)](#03--4-tier-cold-engineering-archive-cabinet-档案-tab)
15
15
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
16
16
 
17
- > **Turn scattered chat tabs into a unified Chief of Staff command center**: inspired by DeepSeek's official **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** *Router + Isolated Workers* architecture to eliminate the human attention bottleneck and context pollution—natively integrated with **DeepSeek Harness (DSH)** split-pane subagent streams, `/goal` supervision, live `steer` injection, and workspace session switching.
17
+ > **Turn scattered chat tabs into a unified Chief of Staff command center**: inspired by DeepSeek's official **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** *Router + Isolated Workers* architecture to eliminate the human attention bottleneck and context pollution—natively integrated with **DeepSeek Harness (DSH)** split-pane subagent streams, panel-native **Goal Supervision + Human Approval Gate**, live `steer` injection, pre-compaction detail harvesting, multi-cabinet precipitated cold vaults, and one-click cross-session Chief deployment.
18
18
 
19
19
  [简体中文 (`README.md`)](README.md) · **English** · [Changelog (`CHANGELOG.md`)](CHANGELOG.md)
20
20
 
@@ -30,9 +30,9 @@ DeepSeek's official **[`dsh-superagent-prototype`](https://github.com/deepseek-a
30
30
 
31
31
  1. **Visual Router–Worker Orchestration**: Supervise your Root Coordinator, spawned Subagents, and linked independent DSH Worker windows from one **Full-Spread Pyramid DAG** and unified **Collaboration Directory**.
32
32
  2. **Native DSH Split-Pane Subagent Stream (`subagentchat`)**: Click `分屏对话` on any pyramid node or directory row to invoke DSH's native `sidebarRight.openResource('dsh-resource://subagentchat/...')` split-pane live viewer.
33
- 3. **Native DSH `/goal` Long-Horizon Supervision**: Dedicated dual-tier `/goal` objective + step board paired with `idle-guard` to prevent premature agent stops before tasks are verified.
34
- 4. **Native DSH `steer` / `followup` Injection & Exact Provider Alignment**: Dispatches live `steer`, `followup`, or `silent` mailbox messages straight through DSH's `agents` runtime while matching the exact `provider/model` channel of your active session.
35
- 5. **Native Workspace Navigation & Zero-Leak Context Preservation**: Spawns clean worker/handoff sessions and switches the active viewport via `uiWorkspace.openSession`, while keeping long-term engineering postmortems sealed at **0 prompt bytes** inside the 4-Tier Cold Archive Cabinet until explicitly taken out.
33
+ 3. **Panel-Native Goal Supervision & Human Approval Gate**: Click **`🎯 设为目标`** right inside the `规划` (Plan) tab to enable long-horizon goal supervision without slash-command friction. When objectives change, stale checklists are flagged for clean reset; once the Chief determines the goal is achieved, it remains in `goal` supervision mode until you explicitly click **Approve & Close (`✅ 批准结项`)** or **Reject & Continue (`↩ 驳回继续`)**.
34
+ 4. **Composer `+` Tactical Cockpit & Anti-Loop Circuit Breaker**: Open the **`+`** button inside the Chief composer bar to configure **Active Strong Intervention** (requires pre-flight goal/redline & risk modal acknowledgment, provides a red **`⏹ 急停`** emergency stop button, and auto-trips on turn cap or 3 stagnant turns), **Pre-Compaction Detail Harvest + Auto-Compact %**, **Strict Verification**, **Redline Sentinel**, and **Concise Brief Mode**.
35
+ 5. **1-Click Cross-Session Chief Deployment & Workspace Image Persistence**: Spawn clean handoff windows from `规划` Zone 3 with 4 configurable working-archive transfer policies (project precipitated cold vaults never leak across handoffs), automatically carrying over your Chief model, disciplines, and tactical preferences with `intervention` safely defaulted off. Attached images are persisted directly to `<cwd>/.dsh-chief/uploads/` and gracefully fall back for text-only Chief models.
36
36
 
37
37
  ---
38
38
 
@@ -40,20 +40,20 @@ DeepSeek's official **[`dsh-superagent-prototype`](https://github.com/deepseek-a
40
40
 
41
41
  Ordinary Todo lists and always-injected memory plugins break down on complex, multi-subagent engineering sessions:
42
42
  1. **Silent Background Token Drain & Wrong Provider Routing**: Auto-summarizing after every turn burns quota in the background and often matches bare model names onto expensive metered channels instead of your active subscription provider.
43
- 2. **Context Bloat from Long Notes**: Dumping dozens of debugging notes straight into the system prompt wastes thousands of tokens per turn and degrades model focus.
43
+ 2. **Context Bloat & Sudden Compaction Amnesia**: Stuffing debugging notes into system prompts wastes thousands of tokens; meanwhile, automatic context compaction wipes out recently discovered paths, commands, and decisions.
44
44
  3. **Cramped Drag-Scroll Canvas**: Subagent graphs trapped inside tiny scroll boxes force constant panning just to see what is blocked.
45
- 4. **Forgotten Guardrails & Context Loss Across Windows**: Safety rules buried in chat vanish after compaction, and independent DSH windows cannot coordinate.
45
+ 4. **Forgotten Guardrails & Lost Chief State Across Windows**: Safety rules vanish when switching chats, forcing manual copy-paste and reconfiguration.
46
46
 
47
47
  **`dsh-chief` («DSH 参谋长») replaces ad-hoc scratchpads with a full right-docked Chief of Staff cockpit:**
48
48
 
49
49
  | Capability | Typical Todo / Always-On Memory Plugins | ✦ DSH Chief (`dsh-chief`) |
50
50
  | :--- | :--- | :--- |
51
- | **Briefing Pace & Channel Alignment** | Blind per-turn background LLM calls; bare-name provider mismatches | **3-Gear Human-Paced Control** (`⏸ On-Demand` **0 background calls by default**, `⚡ Smart`, `🤖 Auto`) + exact `provider/model` channel matching |
51
+ | **Pace & `+` Tactical Cockpit** | Blind per-turn background calls; no tactical safety brakes | **3-Gear Human Pace** (`⏸ On-Demand` **0 background calls**, `👁 Smart`, `🤖 Auto`) + composer **`+` Tactical Cockpit** (`Intervention + Emergency Stop + Circuit Breaker`, `Auto-Compact Harvest`, `Strict Verify`, `Redline Sentinel`) |
52
52
  | **Subagent Task Topology** | Flat lists or cramped drag-scroll viewports | **Full-Spread Pyramid DAG**: Root Coordinator at the apex, subagent lanes laid out cleanly with inline status, explain, dispatch & split-stream buttons |
53
- | **Long-Term Engineering Memory** | Stuffed into every system prompt or flat unindexed notes | **4-Tier Cold Archive Cabinet**: `Drawers → Gold/Silver/Dark-Copper Paperclipped Dossiers → Memory Points → Unfoldable Sub-points` (**0 prompt tokens while sealed**) |
54
- | **Plan Readability & Step Q&A** | Static technical checklists | **Dual-Tier `/goal` + Interactive Step Board**: click any step to ask *"What does this step mean / why is it needed?"* or get an instant Chief explanation without interrupting the main agent |
55
- | **Cross-Session & Subagent Relay** | Isolated to a single window | **Cross-Window Peer Linking + 3-Mode Relay Bus** (`steer`, `followup`, `silent`) across root coordinators and subagents |
56
- | **Redline Governance & Handoff** | Verbal rules lost on compaction; manual copy-paste handoffs | **`📌` Global Thumbtack Redlines** (global vs. task-scoped) + human approval banner + **1-click self-contained Session Handoff** + `idle-guard` |
53
+ | **Multi-Cabinet & Cold Vault** | Stuffed into system prompts or lost on compaction | **Per-Project Multi-Cabinets + 4-Tier Dossiers + 0-Token Precipitated Cold Vault**: one-click **Harvest (`📥 抢救细节`)** before compaction and **Precipitate (`⏬ 沉淀`)** into cross-session cold storage (**0 file reads / 0 prompt tokens** unless explicitly **Flipped Out (`📂 翻出`)**) |
54
+ | **Goal Supervision & Step Q&A** | Static checklists; models self-declare completion | **Core Objective + Human Approval Gate + Interactive Step Board**: click any step to ask *"Why is this needed?"*; goal completion requires explicit human sign-off |
55
+ | **Cross-Session Relay & Images** | Isolated single window; image uploads fail on text-only Chiefs | **Cross-Window Peer Linking + 1-Click Chief Deployment (4 archive policies)** + **Workspace `.dsh-chief/uploads/` persistence** with text-only fallback |
56
+ | **Redline Governance & Idle Guard** | Verbal rules lost; no handoff verification | **`📌` Global Thumbtack Redlines** + boundary proposals + **self-contained handoff** + `idle-guard` |
57
57
 
58
58
  ---
59
59
 
@@ -75,29 +75,29 @@ No cramped mini-viewports: the Root Coordinator sits at the top while subagent s
75
75
 
76
76
  ---
77
77
 
78
- ### 03 · 4-Tier Cold Engineering Archive Cabinet (`档案` Tab)
79
- Store hundreds of long-term engineering postmortems and coordinates with **zero idle prompt overhead**:
80
- - **4-Tier Hierarchy**: **Filing Drawers** → **Color-Coded Paperclipped Dossiers** (high-contrast **Luminous Gold `#ffe033`**, **Brushed Silver `#cbd5e1`**, and **Dark Antique Copper `#7c4329`**) → **Structured Memory Points** → **Click-to-Unfold Sub-point Details**.
81
- - **3-Stage Lazy Loading**: `Stage-0` (`/snapshot`) carries `< 80B` of counts; sealed dossiers inject **0 bytes** into system prompts until explicitly taken out (`取出备查`) or queried via `archive.search`.
78
+ ### 03 · Multi-Cabinet Archives, Detail Harvest & 0-Token Precipitated Cold Vault (`档案` Tab)
79
+ Scoped cleanly per workspace directory (`resolveProjectKey`), allowing multiple working cabinets per project plus lossless detail preservation:
80
+ - **4-Tier Hierarchy**: **Multi-Cabinet Switcher → Filing Drawers** → **Color-Coded Paperclipped Dossiers** (**Luminous Gold `#ffe033`**, **Brushed Silver `#cbd5e1`**, **Dark Antique Copper `#7c4329`**) → **Structured Memory Points** → **Unfoldable Sub-point Details**.
81
+ - **Pre-Compaction Harvest (`📥 抢救细节`) & Precipitated Cold Vault (`⏬ 沉淀`)**: Extracts exact file paths, shell commands, and decisions either manually or automatically when hitting the configured context threshold before compacting. Generalizable lessons precipitated into the Cold Vault stay **physically unread (0 disk reads, 0 prompt tokens)** across all sessions until explicitly **Flipped Out (`📂 翻出`)** and return to 0 immediately when **Sealed Back (`🔒 封回`)**.
82
82
  - **Lossless Chief Curation**: One-click curation refines points and summaries while preserving 100% of raw markdown text.
83
83
 
84
84
  <div align="center">
85
- <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 4-Tier Cold Engineering Archive Cabinet" width="68%" />
85
+ <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - Multi-Cabinet Archives and 0-Token Precipitated Cold Vault" width="68%" />
86
86
  </div>
87
87
 
88
88
  ---
89
89
 
90
- ### 04 · Dual-Tier `/goal` Supervisor & Click-to-Ask Step Board (`规划` Tab)
91
- Pairs a dedicated `/goal` long-running objective box with an interactive step checklist. Click any step to open the glass popover menu and ask what a step means or request an immediate inline explanation from DSH Chief without interrupting the lead agent.
90
+ ### 04 · Panel-Native Goal Supervision, Human Approval Gate & 1-Click Chief Deployment (`规划` Tab)
91
+ Combines a core objective box with a **`🎯 设为目标`** supervision toggle, stale-checklist reset warnings on goal edits, and a strict **Human Approval Gate** (completion proposals stay in `goal` mode until you click `✅ 批准结项` or `↩ 驳回继续`). Zone 3 integrates **Cross-Session Handoff & 1-Click Chief Deployment** with 4 archive migration policies (`none`, `mounted`, `drawer`, `all`)—keeping precipitated cold vaults strictly isolated.
92
92
 
93
93
  <div align="center">
94
- <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - Dual-Tier Goal and Step Q&A" width="68%" />
94
+ <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - Goal Supervision, Approval Gate and 1-Click Chief Deployment" width="68%" />
95
95
  </div>
96
96
 
97
97
  ---
98
98
 
99
- ### 05 · Cross-Window Session Linking & Relay Network (`协同` Tab)
100
- Link multiple independent DSH root sessions (e.g., UI workspace + benchmark workspace) with one toggle to share a live agent directory and cross-session collaboration mailbox.
99
+ ### 05 · Cross-Window Linking, Composer `+` Tactical Cockpit & Image Persistence (`协同` & Input Bar)
100
+ Link multiple independent DSH root sessions into one shared bus, upload or paste screenshots persisted directly into `<cwd>/.dsh-chief/uploads/` (with automatic text-only Chief fallback carrying verified raw file paths to your multimodal lead agent), and control **Active Strong Intervention**, **Auto-Compact Thresholds**, **Strict Verification**, **Redline Sentinel**, and the red **`⏹ 急停`** emergency stop inside the **`+`** Tactical Cockpit.
101
101
 
102
102
  <div align="center">
103
103
  <img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - Cross-Session Collaboration Bus" width="68%" />
@@ -105,8 +105,8 @@ Link multiple independent DSH root sessions (e.g., UI workspace + benchmark work
105
105
 
106
106
  ---
107
107
 
108
- ### 06 · `📌` Global Thumbtack Redlines & Rule Consolidation (`边界` Tab)
109
- Pin critical safety rules with `📌` so they enforce globally across all sessions, keep task-specific rules scoped locally, approve or refine subagent boundary proposals in one click, and consolidate scattered rules via DSH Chief.
108
+ ### 06 · `📌` Global Thumbtack Redlines & Guard Preferences (`边界` Tab)
109
+ Pin critical safety rules with `📌` globally or keep them task-scoped, review subagent boundary proposals in one click, consolidate scattered rules via DSH Chief, and tune per-turn injection and `idle-guard` preferences under **守护偏好**.
110
110
 
111
111
  <div align="center">
112
112
  <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - Pinned Global Redlines and Governance" width="68%" />
@@ -114,20 +114,32 @@ Pin critical safety rules with `📌` so they enforce globally across all sessio
114
114
 
115
115
  ---
116
116
 
117
- ### 07 · One-Click Self-Contained Session Handoff & Idle Guard (`边界` → `会话交接 & 守护`)
118
- Generate a self-contained Markdown handoff packet (goal, hierarchical task tree, active cursor, blockers, and pinned boundaries), spawn a fresh session, and switch the frontend view automatically—backed by `idle-guard` to prevent premature turn termination.
117
+ ### 07 · Pre-Compaction Safety & Self-Contained Handoff Previews
118
+ When context usage reaches your configured threshold while idle, `dsh-chief` harvests recent technical details to disk, verifies readability on disk, and only then triggers compaction—or lets you generate and inspect a full self-contained Markdown handoff packet before spawning a fresh session.
119
119
 
120
120
  <div align="center">
121
- <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - Self-Contained Session Handoff and Idle Guard" width="68%" />
121
+ <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - Self-Contained Session Handoff and Guard" width="68%" />
122
122
  </div>
123
123
 
124
124
  ---
125
125
 
126
+ ## ⚠️ Usage Notes & Disclaimers
127
+
128
+ > [!IMPORTANT]
129
+ > Before enabling **`+` Tactical Cockpit** features such as **Active Strong Intervention (`⚡ 主动强介入`)**, **Pre-Compaction Auto-Harvest**, or **Redline Sentinel**, please review the following two disclaimers:
130
+ >
131
+ > 1. **Underlying Model Capability Dependency**: All Chief auto-review, active strong intervention steering, pre-compaction detail harvesting, and redline interception capabilities depend heavily on the reasoning strength and context quality of the underlying LLM configured for DSH Chief; models differ objectively in planning rigor and instruction adherence.
132
+ > 2. **Host System Prompt & Rules Conflict Risk**: Mounting excessive System Prompts, global Rules, or rigid custom instructions in the main session or current project may conflict with this plugin's autonomous intervention logic—potentially causing abnormal intervention loops, premature circuit-breaker trips, or unexpected deviations.
133
+ >
134
+ > Always specify a clear Core Objective and at least one Forbidden Redline before confirming Active Strong Intervention, and use the red **`⏹ 急停`** button above the composer anytime you want immediate manual takeover.
135
+
136
+ ---
137
+
126
138
  ## ⚡ Quick Installation (Zero External Dependencies)
127
139
 
128
140
  ```bash
129
141
  # Fast install from prebuilt GitHub Release tarball (~240 KB, zero build scripts)
130
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.0.0/dsh-chief-1.0.0.tgz
142
+ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.1.0/dsh-chief-1.1.0.tgz
131
143
 
132
144
  # Or install directly via GitHub shorthand (replace `desktop` with `web` if using web profile)
133
145
  dsh plugin --profile desktop add github:gluztm/dsh-chief
@@ -135,6 +147,13 @@ dsh plugin --profile desktop add github:gluztm/dsh-chief
135
147
 
136
148
  Refresh the DSH Web UI and click the **✦ `DSH 参谋长`** icon in the right-hand sidebar header.
137
149
 
150
+ ### Host Compatibility Matrix
151
+
152
+ | DeepSeek Harness (DSH) Version | Sidebar Panel / Board / Vaults / Bounds | Named Subagent Tree (`task.dispatch` / `team.steer` / `team.interrupt`) | Notes |
153
+ | :--- | :---: | :---: | :--- |
154
+ | **`>= 0.2.2-rc.2` (`rc.3+` recommended)** | ✅ Full support | ✅ Full support | Provides `subagents.resolveName` / `rootOf` / `namesOf` and flat `startActivation` |
155
+ | `0.2.0 ~ 0.2.2-rc.1` | ✅ Panel works normally | ⚠️ Unavailable (guided prompt) | Pre-refactor `subagents` API; panel displays a non-blocking warning and guards `team.*` cleanly |
156
+
138
157
  ---
139
158
 
140
159
  ## 🛠️ Model Tool Suite (4 Tools)
package/README.md CHANGED
@@ -7,14 +7,14 @@
7
7
  # ✦ DSH 参谋长 (`dsh-chief`)
8
8
  ### DeepSeek Harness 多智能体参谋指挥舱 · SuperAgent 跨窗统筹 · 四层冷存储工程档案柜
9
9
 
10
- [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.0-38bdf8?style=flat-square)](https://dsh.deepseek.com)
10
+ [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.2--rc.2-38bdf8?style=flat-square)](https://dsh.deepseek.com)
11
11
  [![SuperAgent Ready](https://img.shields.io/badge/SuperAgent-Router--Worker%20Synergy-a855f7?style=flat-square)](https://github.com/deepseek-ai/dsh-superagent-prototype)
12
12
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022.13-30d158?style=flat-square)](https://nodejs.org)
13
13
  [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20External-ffe033?style=flat-square)](#)
14
14
  [![Cold Vault](https://img.shields.io/badge/Cold%20Archive-0%20Token%20Idle-34d399?style=flat-square)](#03--四层冷存储工程档案柜档案页签)
15
15
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
16
16
 
17
- > **把散装聊天窗升级为智能体总司令部**:深度呼应 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」注意力减负范式,并与 **DeepSeek Harness (DSH)** 原生子代理分屏、`/goal` 长程目标、实时 `steer` 切入及跨会话导航无缝联动。
17
+ > **把散装聊天窗升级为智能体总司令部**:深度呼应 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」注意力减负范式,并与 **DeepSeek Harness (DSH)** 原生子代理分屏、面板原生「🎯 目标督导 + 人工拍板结项」、实时 `steer` 切入、压缩前实证抢救、多档案柜沉淀冷库及跨会话一键部署无缝联动。
18
18
 
19
19
  **简体中文** · [English (`README.en.md`)](README.en.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md)
20
20
 
@@ -30,9 +30,9 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
30
30
 
31
31
  1. **SuperAgent「统筹 + 工人」可视化落地**:无需在十几个并发会话与子代理黑盒间来回切换——参谋长常驻右侧栏充当你的全局统筹台(Router Cockpit),将当前主代理、下辖各路子代理(Subagents)以及跨窗口独立 Worker 会话收拢进同一张**全铺开金字塔拓扑图**与**协同通讯录**中。
32
32
  2. **原生联动 DSH 子代理分屏实时流(`subagentchat`)**:在金字塔节点或协同列表上点击「`分屏对话`」,直接调用 DSH 原生 `sidebarRight.openResource('dsh-resource://subagentchat/...')`,在右侧分屏即时拉开对应子代理的实时推理流。
33
- 3. **原生联动 DSH `/goal` 长程持续督导**:规划页独立承载 `/goal` 总纲并与底部步骤板双层联动,配合 `idle-guard` 空转完结守护,防止模型在多步长任务中途「口头交差」提前停机。
34
- 4. **原生联动 DSH Agent 运行时三态注入与多渠道对齐**:跨会话信使总线直连宿主 `agents` 服务,支持 `插话 (steer,下一步立即切入)` / `递话 (followup,排队唤醒)` / `备忘 (silent,静默投递信箱)`,并精确读取当前会话的完整 `provider/model` 标识(如区分 `CommandCode` 与官方按量渠道),杜绝同名模型串渠道误扣费。
35
- 5. **原生联动 DSH 工作区导航与冷热上下文隔离**:一键交接通过宿主 `uiWorkspace.openSession` 创建干净的隔离接力会话并自动切走前端画面;四层「工程档案柜」平时对提示词保持 **0 字节注入**,彻底守住干净上下文边界。
33
+ 3. **原生「🎯 目标督导」与人工拍板结项(Goal Approval Gate)**:在「规划」页点击「`🎯 设为目标`」即可开启持续目标督导(不再依赖聊天 `/goal` 指令),变更目标时智能提示重置陈旧步骤;目标达成后由参谋长提交实证请示,**必须经过人类点击「`✅ 批准结项`」才会退出目标模式**,未获批准前随时支持驳回继续推进。
34
+ 4. **输入栏 `+` 战术驾驶舱与防死循环熔断**:点击输入栏左侧 **`+`** 打开战术驾驶舱,按需组合「`⚡ 主动强介入`(需前置边界与风险弹窗确认 + 红色 `⏹ 急停` + 最大轮数与 3 轮无进展自动熔断)」「`🗜 压缩前抢救 + 自动压缩阈值`」「`✓ 严格实证核验`」「`🛡 红线越界哨兵`」与「`📝 极简战报`」。
35
+ 5. **跨会话一键部署参谋 + 工作区原图落盘防幻觉**:在「规划」页底部可按四档策略同步工作档案(**跨会话沉淀冷库绝不跟随复制**),新建独立窗口后自动部署参谋长(继承专职模型与纪律,`intervention` 默认安全置关);附图上传直接落盘至当前项目 `.dsh-chief/uploads/` 并注入真实文件路径,即便配置纯文本参谋模型也能优雅降级协同。
36
36
 
37
37
  ---
38
38
 
@@ -40,20 +40,20 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
40
40
 
41
41
  在真实的大型工程与多子代理(Subagents)协作中,普通「待办小本本」或「全量注入式记忆插件」往往会撞上四大痛点:
42
42
  1. **后台偷跑 Token、跨渠道乱选模型**:每轮对话结束都在后台偷偷调用大模型做全量总结,甚至把免费/订阅渠道的同名模型误匹配到高价按量渠道。
43
- 2. **记忆越存越慢、污染上下文**:把几十篇排障笔记一股脑塞进 System Prompt,每轮白烧数千 Token,还会严重干扰模型对当前任务的注意力。
43
+ 2. **记忆越存越慢、上下文压缩突然失忆**:把几十篇排障笔记一股脑塞进 System Prompt 烧光 Token;或者对话一旦自动压缩,刚刚敲定的文件路径、命令与边界瞬间丢失。
44
44
  3. **小画布拖拽迷宫**:子代理一多,任务图缩在巴掌大的滚动视口里来回拖拉,根本看不清谁卡住了、谁做完了。
45
- 4. **口头立规矩转头就忘、换窗口就失忆**:聊天里交代的安全红线一压缩就丢;不同窗口的主对话各自为战,切新会话还得手写长篇背景。
45
+ 4. **口头立规矩转头就忘、换窗口就丢参谋**:聊天里交代的安全红线转头就忘;切到新会话还得重新配置参谋长模型、纪律和档案。
46
46
 
47
47
  **`dsh-chief`(DSH 参谋长)不是一个简单的“记事本”,而是一套完整的右侧栏多智能体指挥部:**
48
48
 
49
49
  | 核心维度 | 普通 Todo / 常驻记忆插件 | ✦ DSH 参谋长 (`dsh-chief`) |
50
50
  | :--- | :--- | :--- |
51
- | **参谋节奏与渠道对齐** | 后台每轮盲目触发总结,同名模型易串渠道扣费 | **人类三档控速**(默认 `⏸ 按需` **0 自动调用**,可选 `⚡ 巡检` / `🤖 托管`),严格对齐完整 `provider/model` 渠道 |
51
+ | **参谋节奏与战术驾驶舱** | 后台每轮盲目触发总结,无法精细控速与急停 | **三档节奏**(默认 `⏸ 按需` **0 自动调用**、`👁 巡检`、`🤖 托管`)+ 输入栏 **`+` 战术驾驶舱**(主动强介入 + 轮数熔断 + `⏹ 急停` / 严格核验 / 红线哨兵 / 自动压缩前抢救) |
52
52
  | **多代理拓扑可视性** | 扁平列表或狭窄视口,频繁横向/纵向拖动 | **全铺开金字塔 DAG 指挥图**:主代理居中统帅、子代理分列纵队,状态切换/解释/派发/分屏看流全部原地铺开 |
53
- | **长期工程记忆架构** | 常驻塞入提示词(费 Token)或纯扁平长文难翻阅 | **四层冷存储「工程档案柜」**:`抽屉 → 金/银/暗铜曲别针卷宗 → 记忆点 → 可展开小点记忆`;平时 **0 字节注入提示词**,仅在「取出备查」时挂载 |
54
- | **规划可读性与互动** | 冰冷的技术步骤列表,非底层开发者难看懂意图 | **上 `/goal` 总纲 + 下步骤板**:点击任意步骤即可一键追问「**这条是什么意思 / 为什么有这步**」或请参谋长当场白话解读 |
55
- | **跨会话与子代理协同** | 仅限单会话内部,窗口之间完全割裂 | **跨窗口独立会话串联 + 三态信使总线**:支持 `插话 (steer)` / `递话 (followup)` / `备忘 (silent)` 直达任意子代理或联动窗口 |
56
- | **红线治理与长程接力** | 规则混在聊天记录里,换会话靠人工复制粘贴 | **`📌` 图钉全局红线盖章**(跨任务永久生效 vs 仅本任务生效)+ **一键生成自包含交接单并自动切入新会话** + **空转完结守护** |
53
+ | **长期工程记忆与沉淀冷库** | 常驻塞入提示词(费 Token)或易随对话压缩丢失 | **项目多档案柜 + 四层档案 + 跨会话沉淀冷库**:`抽屉 → 金/银/暗铜曲别针卷宗 → 记忆点 → 小点记忆`;支持「`📥 抢救细节`」防压缩失忆与「`⏬ 沉淀`」封入冷库(**全会话 0 Token 物理隔离**,点「`📂 翻出`」才注入) |
54
+ | **规划可读性与目标拍板** | 冰冷的技术步骤列表,目标完成与否模型自说自话 | **核心目标督导 + 人工拍板结项 + 可追问小任务板**:点击任意步骤即可一键白话解读;目标达标后必须等待人类「`✅ 批准结项`」或「`↩ 驳回继续`」 |
55
+ | **跨会话协同与原图协同** | 仅限单会话,换窗失忆;纯文本参谋遇图片直接报错 | **跨窗口独立会话串联 + 一键接力部署参谋(4 档档案策略)** + **工作区 `.dsh-chief/uploads/` 原图持久化**(纯文本参谋自动降级并带路径铁律转发) |
56
+ | **红线治理与空转守护** | 规则混在聊天记录里,换会话靠人工复制粘贴 | **`📌` 图钉全局红线盖章**(跨任务永久生效 vs 仅本任务生效)+ **子代理边界请示与浓缩** + **`idle-guard` 空转完结守护** |
57
57
 
58
58
  ---
59
59
 
@@ -75,29 +75,29 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
75
75
 
76
76
  ---
77
77
 
78
- ### 03 · 四层冷存储「工程档案柜」(`档案` 页签)
79
- 像真正的工程档案室一样分层保管长期技术资产,彻底根治「长记忆烧光上下文」顽疾:
80
- - **四层收纳结构**:**分类抽屉**(拉开抽屉)→ **三色曲别针卷宗**(高对比度 **璀璨金针 `#ffe033` 核心必读** / **标准银针 `#cbd5e1` 常规实录** / **暗古铜针 `#7c4329` 历史归档**)→ **分条记忆点** → **点击逐条展开小点记忆**。
81
- - **三级懒加载 · 默认 0 Token 空耗**:`Stage-0` 快照仅传输 `< 80B` 计数元信息,封存状态下对系统提示词保持 **100% 零注入**;只有当你主动点击「**取出备查**」或模型点名调用 `archive.search` 时才精准调取,用完点「**放回封存**」立即归零。
82
- - **参谋长无损整理**:支持一键「请参谋长整理收纳 / 重拆此卷」,自动提炼结构化记忆点并 **100% 无损保留原始 Markdown 正文**。
78
+ ### 03 · 多档案柜、抢救细节与 0-Token 沉淀冷库(`档案` 页签)
79
+ 按当前工作区路径自动隔离项目档案室,支持创建与切换多个工程档案柜,彻底解决「长记忆烧光上下文」与「压缩突然失忆」两大顽疾:
80
+ - **四层收纳结构**:**多档案柜 → 分类抽屉**(拉开抽屉)→ **三色曲别针卷宗**(**璀璨金针 `#ffe033` 核心必读** / **标准银针 `#cbd5e1` 常规实录** / **暗古铜针 `#7c4329` 历史归档**)→ **分条记忆点** → **点击逐条展开小点记忆**。
81
+ - **📥 压缩前抢救与 ⏬ 沉淀冷库(0 Token 物理隔离)**:支持手动或达到上下文阈值时自动执行「`📥 抢救细节`」提取文件路径、命令与关键结论落盘核验;通过「`⏬ 沉淀可复用经验`」将通用踩坑提炼进跨会话沉淀冷库。**沉淀冷库全会话默认 0 字节、0 磁盘读取隔离**,仅点击「`📂 翻出注入本会话`」才临时进入参谋视野,点击「`🔒 封回冷库`」即刻归零。
82
+ - **✦ 参谋长无损整理**:一键「请参谋长整理收纳 / 重拆此卷」,自动归纳记忆点并 **100% 无损保留原始 Markdown 正文**。
83
83
 
84
84
  <div align="center">
85
- <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 四层冷存储工程档案柜与金银暗铜曲别针" width="68%" />
85
+ <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 多档案柜、抢救细节与沉淀冷库" width="68%" />
86
86
  </div>
87
87
 
88
88
  ---
89
89
 
90
- ### 04 · 双层 `/goal` 长期目标与可追问小任务板(`规划` 页签)
91
- 上方独立承载 `/goal` 长期督导总纲,下方实时同步细粒度执行步骤。对模型写下的某一步技术操作有疑问?**直接左键/右键点击该步骤**,即可呼出交互菜单:一键询问主代理「**这条是什么意思 / 为什么有这步**」,或让 **DSH 参谋长当场白话解读(不打断主对话当前推理流)**。
90
+ ### 04 · 目标督导、人工拍板结项与跨会话一键部署参谋(`规划` 页签)
91
+ 上方承载**核心目标与 `🎯 目标督导` 开关**,目标变更时智能提示是否清空陈旧步骤;目标达成后保持督导态等待您亲自拍板「`✅ 批准结项`」或「`↩ 驳回继续`」。中部小任务板点击任意步骤可一键追问白话解读;底部集成**「🚀 跨会话接力 & 一键部署参谋」**,新建窗口或投递给已有会话时可选四档工作档案迁移策略(冷库保持绝对隔离),并无缝部署继承参谋长专职模型与纪律配置。
92
92
 
93
93
  <div align="center">
94
- <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 双层 Goal 目标与步骤点击追问解读" width="68%" />
94
+ <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 核心目标督导、审批结项与跨会话一键部署参谋" width="68%" />
95
95
  </div>
96
96
 
97
97
  ---
98
98
 
99
- ### 05 · 跨窗口独立会话串联与三态信使网络(`协同` 页签)
100
- 打破单窗口孤岛:一键拨动开关即可将多个独立 DSH 主窗口(例如「前端交互窗口」与「后端压测窗口」)接入同一协同集群,共享统一通讯录与协同信箱,随时发起 `插话`、`递话`、`备忘` 或一键打开子代理右侧分屏。
99
+ ### 05 · 跨窗口独立会话串联与原图落盘防幻觉(`协同` & 输入栏 `+` 驾驶舱)
100
+ 打破单窗口孤岛:一键拨动开关即可将多个独立 DSH 主窗口(例如「前端交互窗口」与「后端压测窗口」)接入同一协同集群;输入框支持拖拽或粘贴截图(**原图直接落盘至工作区 `.dsh-chief/uploads/`**,纯文本参谋模型自动降级并附真实路径交由多模态主对话执行);左侧 **`+` 战术驾驶舱**集中管控强介入、自动压缩前抢救、严格实证核验、红线哨兵与红色 **`⏹ 急停`**。
101
101
 
102
102
  <div align="center">
103
103
  <img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口独立会话串联与协同网络" width="68%" />
@@ -105,9 +105,9 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
105
105
 
106
106
  ---
107
107
 
108
- ### 06 · `📌` 图钉全局红线盖章与智能浓缩(`边界` 页签 · 红线边界)
108
+ ### 06 · `📌` 图钉全局红线盖章与守护偏好(`边界` 页签)
109
109
  - **双层作用域精准隔离**:点击规则左侧的 **`📌` 小图钉** 即可将其升格为跨所有任务生效的「**全局共享铁律**」;未钉住的规则仅在当前会话树生效,绝不污染其他无关项目。
110
- - **撞墙请示与一键浓缩**:子代理实战踩坑后可通过 `bounds.propose` 提交新边界草案,由你在面板上一键选择「`📌 定住全局` / `仅本任务` / `微调` / `驳回`」;零散规则过多时还可勾选并点击「**✨ 零散总结成一条**」交由参谋长精炼合并。
110
+ - **撞墙请示、智能浓缩与守护偏好**:「红线边界」支持 `bounds.propose` 一键定住全局、浓缩精简;「守护偏好」专注管理每轮注入开关、`idle-guard` 空转提醒阈值与短回复检测线。
111
111
 
112
112
  <div align="center">
113
113
  <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 图钉全局红线与参谋长边界请示盖章" width="68%" />
@@ -115,8 +115,8 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
115
115
 
116
116
  ---
117
117
 
118
- ### 07 · 一键自包含会话交接与空转守护(`边界` 页签 · 会话交接 & 守护)
119
- 长对话上下文逼近上限时,点击「**新建会话并交接**」即可将当前目标、父子任务树、当前游标、阻塞卡点与有效红线打包为一份**自包含 Markdown 交接单**,自动创建新对话并将前端视口无缝切换过去继续接力;内置 `idle-guard` 空转完结守护,防止模型在任务未闭环时提前停机交差。
118
+ ### 07 · 自包含跨会话接力包预览与空转守护
119
+ 长对话上下文逼近上限或开启自动压缩阈值时,系统先抢救工程细节入柜并核验落盘后再执行压缩;主动切换窗口时,「规划」页底部的跨会话接力可生成**自包含 Markdown 交接单**并自动切换视口,配合 `idle-guard` 防止任务未闭环前意外停机。
120
120
 
121
121
  <div align="center">
122
122
  <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 自包含一键会话交接与空转守护" width="68%" />
@@ -124,35 +124,47 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
124
124
 
125
125
  ---
126
126
 
127
+ ## ⚠️ 使用须知与免责声明
128
+
129
+ > [!IMPORTANT]
130
+ > 请在使用「`+` 战术驾驶舱」「`⚡ 主动强介入`」「自动压缩前抢救」等自主干预特性前务必知悉以下两点:
131
+ >
132
+ > 1. **底层大模型能力与上下文质量依赖**:参谋长的一切自动审查、强介入驱动、压缩前抢救与红线拦截能力均高度依赖您为参谋长配置的底层大模型能力与上下文质量,不同模型在规划严谨度与遵循指令上的表现存在客观差异。
133
+ > 2. **宿主系统提示词与 Rules 指令冲突风险**:若主会话或当前项目中挂载了过多的系统提示词(System Prompt)、Rules 或硬性规则,可能与本插件的自主干预逻辑产生指令冲突,进而导致介入循环异常、提前熔断或执行偏离预期。
134
+ >
135
+ > 建议在启用「主动强介入」前明确填写「核心目标」与至少一条「禁止红线」,必要时随时点击输入栏上方的红色 **「⏹ 急停」** 按钮中断后台自驱。
136
+
137
+ ---
138
+
127
139
  ## 🏗️ 冷热记忆分舱与多代理协同架构
128
140
 
129
141
  ```mermaid
130
142
  flowchart TB
131
143
  subgraph UI["DSH 右侧常驻参谋舱 (client.js)"]
132
- T1["参谋台 (三档人类控速)"]
144
+ T1["参谋台 (+ 战术驾驶舱 & 急停)"]
133
145
  T2["全铺开金字塔任务图"]
134
146
  T3["跨窗与子代理协同网"]
135
- T4["/goal + 可追问步骤板"]
136
- T5["四层冷存储工程档案柜"]
137
- T6["📌 全局红线 & 一键交接"]
147
+ T4["目标督导 + 人工结项 + 一键部署参谋"]
148
+ T5["多档案柜 + 抢救 + 0-Token 沉淀冷库"]
149
+ T6["📌 全局红线 & 守护偏好"]
138
150
  end
139
151
 
140
152
  subgraph Core["宿主协调与存储内核 (Zero External Deps)"]
141
- Hot["热工作板 & 精炼热摘要 (< 1.5KB)\nboard.json / boards/session-*.json"]
142
- Cold["四层懒加载冷档案库 (平时 0B 注入)\narchives.json (金/银/暗铜曲别针)"]
143
- Bus["三态跨会话信使 & 参谋状态机\nchief-state.json + idle-guard.js"]
153
+ Hot["热工作板 & 精炼热摘要\nboard.json / boards/session-*.json"]
154
+ Cold["多档案柜工作档案 + 跨会话沉淀冷库\ncabinets/ + precipitated/<projectKey>.json"]
155
+ Bus["三态跨会话信使、熔断护栏 & 上传原图\nchief-state.json + idle-guard.js + .dsh-chief/uploads/"]
144
156
  end
145
157
 
146
158
  subgraph Agents["多智能体执行集群"]
147
159
  Lead["当前主代理 (Root Coordinator)"]
148
160
  Subs["子代理纵队 (@arch / @dev / @bench)"]
149
- Peers["已串联的跨窗口主会话"]
161
+ Peers["已串联与一键部署的跨窗口会话"]
150
162
  end
151
163
 
152
164
  UI <-->|"同源环回守卫 API (/api/dsh-chief/*)"| Core
153
165
  Hot -->|"紧凑态势注入"| Lead
154
166
  Hot -->|"紧凑态势注入"| Subs
155
- Cold -.->|"仅「取出备查」或点名检索时按需调取"| Lead
167
+ Cold -.->|"沉淀冷库 0 Token 隔离\n仅「翻出」或「取出备查」时注入"| Lead
156
168
  Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
157
169
  ```
158
170
 
@@ -166,7 +178,7 @@ flowchart TB
166
178
 
167
179
  ```bash
168
180
  # 直接从 GitHub Release 预构建包极速安装(约 240 KB,零编译步骤)
169
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.0.0/dsh-chief-1.0.0.tgz
181
+ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.1.0/dsh-chief-1.1.0.tgz
170
182
 
171
183
  # 或通过 GitHub 仓库标识安装(若使用 web profile,将 desktop 替换为 web)
172
184
  dsh plugin --profile desktop add github:gluztm/dsh-chief
@@ -174,6 +186,13 @@ dsh plugin --profile desktop add github:gluztm/dsh-chief
174
186
 
175
187
  安装完成后刷新 DSH Web 页面,点击工作区右侧边栏顶部的 **✦ `DSH 参谋长`** 图标即可展开面板。
176
188
 
189
+ ### 宿主版本兼容性矩阵
190
+
191
+ | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 档案柜 / 边界 | 命名子代理树 (`task.dispatch` / `team.steer` / `team.interrupt`) | 说明 |
192
+ | :--- | :---: | :---: | :--- |
193
+ | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 完整提供 `subagents.resolveName` / `rootOf` / `namesOf` 与扁平 `startActivation` |
194
+ | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 不可用(提示升级) | 旧版重构前子代理接口;插件启动与面板会给出升级提示并安全拦截 `team.*` 调用 |
195
+
177
196
  ### 方式二:源码克隆与本地联接调试(适合二次开发)
178
197
 
179
198
  ```bash