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 +21 -0
- package/README.en.md +47 -28
- package/README.md +56 -37
- package/archives.js +958 -125
- package/chief.js +1472 -138
- package/client.js +2304 -475
- package/index.js +712 -61
- package/package.json +2 -2
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
|
-
[](https://dsh.deepseek.com)
|
|
11
11
|
[](https://github.com/deepseek-ai/dsh-superagent-prototype)
|
|
12
12
|
[](https://nodejs.org)
|
|
13
13
|
[](#)
|
|
14
14
|
[](#03--4-tier-cold-engineering-archive-cabinet-档案-tab)
|
|
15
15
|
[](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,
|
|
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
|
|
34
|
-
4. **
|
|
35
|
-
5. **
|
|
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
|
|
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 &
|
|
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
|
-
| **
|
|
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
|
-
| **
|
|
54
|
-
| **
|
|
55
|
-
| **Cross-Session &
|
|
56
|
-
| **Redline Governance &
|
|
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 ·
|
|
79
|
-
|
|
80
|
-
- **4-Tier Hierarchy**: **Filing Drawers** → **Color-Coded Paperclipped Dossiers** (
|
|
81
|
-
- **
|
|
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 -
|
|
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 ·
|
|
91
|
-
|
|
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 -
|
|
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
|
|
100
|
-
Link multiple independent DSH root sessions
|
|
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 &
|
|
109
|
-
Pin critical safety rules with `📌`
|
|
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 ·
|
|
118
|
-
|
|
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
|
|
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.
|
|
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
|
-
[](https://dsh.deepseek.com)
|
|
11
11
|
[](https://github.com/deepseek-ai/dsh-superagent-prototype)
|
|
12
12
|
[](https://nodejs.org)
|
|
13
13
|
[](#)
|
|
14
14
|
[](#03--四层冷存储工程档案柜档案页签)
|
|
15
15
|
[](LICENSE)
|
|
16
16
|
|
|
17
|
-
> **把散装聊天窗升级为智能体总司令部**:深度呼应 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」注意力减负范式,并与 **DeepSeek Harness (DSH)**
|
|
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.
|
|
34
|
-
4.
|
|
35
|
-
5.
|
|
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.
|
|
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
|
-
|
|
|
51
|
+
| **参谋节奏与战术驾驶舱** | 后台每轮盲目触发总结,无法精细控速与急停 | **三档节奏**(默认 `⏸ 按需` **0 自动调用**、`👁 巡检`、`🤖 托管`)+ 输入栏 **`+` 战术驾驶舱**(主动强介入 + 轮数熔断 + `⏹ 急停` / 严格核验 / 红线哨兵 / 自动压缩前抢救) |
|
|
52
52
|
| **多代理拓扑可视性** | 扁平列表或狭窄视口,频繁横向/纵向拖动 | **全铺开金字塔 DAG 指挥图**:主代理居中统帅、子代理分列纵队,状态切换/解释/派发/分屏看流全部原地铺开 |
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
|
56
|
-
|
|
|
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
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
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 -
|
|
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 ·
|
|
91
|
-
|
|
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 -
|
|
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
|
-
-
|
|
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
|
-
|
|
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["
|
|
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["热工作板 &
|
|
142
|
-
Cold["
|
|
143
|
-
Bus["
|
|
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 -.->|"
|
|
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.
|
|
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
|