dsh-chief 1.1.0 → 1.2.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 +51 -0
- package/README.en.md +104 -74
- package/README.md +112 -96
- package/archives.js +1200 -199
- package/auto-continue.js +627 -0
- package/chief-executor.js +861 -0
- package/chief.js +3221 -279
- package/client.js +4668 -1093
- package/digest.js +67 -21
- package/handoff.js +3 -3
- package/index.js +1163 -172
- package/package.json +6 -2
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,57 @@ 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.2.0] - 2026-11-16
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
#### ✦ 许愿框一站式执行器与四档权限门禁 (`chief-executor.js`)
|
|
13
|
+
- **内置多步实权工具循环**:用户可在右侧「✦ 许愿框」一句话直达查改工作区文件、目录搜索、运行安全命令、维护看板、整理档案与主动触发压缩。
|
|
14
|
+
- **四档精细权限控制**:支持 `read-only`(仅可查看)、`workspace-write`(工作区内修改)、`auto-review`(自动审查 EXP)与 `danger-full-access`(完全权限)。
|
|
15
|
+
- **空白新对话开场即战力**:无历史对话时也能主动定位工作区并下场勘察,无需等主对话先发送消息。
|
|
16
|
+
- **空白新对话待领交接暂存**:在空白上下文中拆发指令给尚未创建的 `@lead` 时,自动调用 `stagePendingTransfer` 写入 `pending-transfer.json`,主对话首轮发送即自动衔接。
|
|
17
|
+
|
|
18
|
+
#### 🏛️ 三层 0-Token 档案金库与双向差分
|
|
19
|
+
- **💬 本会话档案柜 (`session`)**:按 `rootSessionId` 实现 1:1 严格会话隔离,仅用户、当前会话代理与参谋长可见。
|
|
20
|
+
- **🌐 系统全局档案柜 (`global`)**:系统级 0-Token 冷库(`global-vault/vault-chief-global.json`),默认不随会话自动挂载,绝不自动迁移旧版遗留档案。
|
|
21
|
+
- **⇄ 本地 ↔ 全局实时双向差分**:自动标记「仅本地 / 已同步 / 本地已改 / 全局独有」差异,支持一键 `⤵️ 引入本会话`、`提炼入全局` 与增量覆盖更新。
|
|
22
|
+
- **🏛️ 沉淀档案柜 (`precipitated`)**:跨对话通用经验冷库(`precipitated/vault-global.json`),默认对主对话与参谋长**双盲 0 字节读取**。
|
|
23
|
+
- **📌 摆上桌面聚光灯与组合递话**:支持将任意三库卷宗点亮为「📌 摆上桌面(主+参谋可见)」并支持跨库复选卷宗、附带用户具体指令一键「组合递话」。
|
|
24
|
+
- **参谋专属按需检索**:支持逐会话切换 `👁️ 供本会话参谋参阅` / `📥 收回冷存`,或在参谋问答中按需检索全局冷库,用后即走。
|
|
25
|
+
|
|
26
|
+
#### 🗜️ `✦ 智选压缩` 与长任务自动续推
|
|
27
|
+
- **✦ 智选压缩 (`smartCompact`)**:可独立生效或协同 `autoCompact` 跳过固定百分比阈值,待阶段收口且主代理收敛空闲后自动抢救并静默压缩。
|
|
28
|
+
- **可见压缩回执卡片**:每次 `✦ 智选压缩` 真实执行后,自动向参谋对话流写入带 `✦ 智选压缩` 徽章的回执卡片(记录档案编号与压前 Token 占比)。
|
|
29
|
+
- **手动指令确定性压缩**:用户直说「压缩吧 / 压缩一下 / `/compact`」时绕过纯状态查询通道,确定性执行「先落盘抢救校验 → 再宿主静默压缩」。
|
|
30
|
+
- **长任务自动续推模块 (`auto-continue.js`)**:接入宿主 `autoContinue` 协同与参谋急停联动清理机制。
|
|
31
|
+
|
|
32
|
+
#### 🎯 强介入目标锁定、无限轮数与双安全门禁
|
|
33
|
+
- **核心目标目的地锁定**:开启 `⚡ 主动强介入` 后直接锁定核心目标作为唯一终局,防止后台督导跑偏。
|
|
34
|
+
- **无限轮次与防卡死熔断**:`maxInterventionTurns` 支持设为 `0 = ∞`(无限轮),同时保留连续无进展兜底熔断与风险弹窗确认。
|
|
35
|
+
- **高危操作急停弹窗**:检测高危干预时先弹窗提示风险,搭配输入栏红色 `⏹ 急停` 随时一键切断后台自驱。
|
|
36
|
+
- **必做事项结项核验门禁 (`allowed`)**:强介入或 `/goal` 收口前强制逐项核查 `allowed` 必做清单,未验证并获人工点击 `✅ 批准结项` 绝不退出督导模式。
|
|
37
|
+
|
|
38
|
+
#### 🌐 跨窗协同网、彩色信箱与可定住交接单
|
|
39
|
+
- **跨窗互连污染提醒与彻底脱离净化**:接入邻居会话前先弹窗提醒互享进展风险;断开协同立即校验 `clusterSig` 并清除摘要缓存、外部团队记忆与离线信箱残留。
|
|
40
|
+
- **彩色可折叠抽屉信箱与广播去重**:按会话固定配色,`@all` 广播自动去重归并,支持按全网广播 / 多方 / 双边 / 内部渠道折叠检索。
|
|
41
|
+
- **可手改与 `📌 定住防改` 交接单**:规划页支持手工编辑、一键定住冻结 `[自动渲染]` 快照(并同步锁定 `同步交接单` 开关防覆写)与发车前过期提醒弹窗。
|
|
42
|
+
|
|
43
|
+
### Changed
|
|
44
|
+
- **压缩触发区间全面放宽**:百分比自动压缩阈值由 `50%–95%` 调整为 `10%–95%`(低于 `25%` 弹出琥珀低阈值提示),并新增 `>= 8,000` 精确 Token 阈值模式。
|
|
45
|
+
- **交互入口与工作区布局重排**:战术驾驶舱 `+` 按钮收拢至输入栏居左,状态胶囊与权限档位直显于输入栏上方,跨会话接力区与 `📌 定住防改` 统一收口至「规划」页底部。
|
|
46
|
+
- **三层冷库晋升梯度规范化**:严格确立 `💬 本会话 → 🌐 系统全局 → 🏛️ 沉淀冷库` 单向逐级晋升规则(禁止本会话越级直接沉淀),并支持无损向下引入。
|
|
47
|
+
- **后端接口与打包边界扩展**:后端 `/api/dsh-chief/*` 同源环回保护接口扩展至 25 条;`package.json` `files` 清单补入 `chief-executor.js` 与 `auto-continue.js`。
|
|
48
|
+
|
|
49
|
+
### Fixed
|
|
50
|
+
- **修复手动与自动压缩报 `dsh-compaction service unavailable`**:绕过 Cordis 子分组对 `compaction` 服务的隔离限制,找不到直连服务时自动通过宿主官方 `commands.execute(ag, '/compact', ...)` 执行真压缩。
|
|
51
|
+
- **修复休眠会话无法触发压缩**:当 `agents.get(sid)` 未唤醒时,通过 `sessionController.resolveAgent(sid)` 自动恢复空闲会话句柄后再压缩;运行中会话继续安全拦截。
|
|
52
|
+
- **修复 `✦ 智选压缩` 静默失效与次数虚增**:重构 `executeHarvestAndCompact` 为严格原子提交——仅在真实压缩成功且非免压时递增 `autoCompactCount`、`lastCompactedSeq` 与 `lastCompactedAt`,报错或无历史免压绝不虚增,并将异常明细写入看板日志。
|
|
53
|
+
- **修复 `✦ 智选压缩` 因主代理未收敛空闲而错过触发**:在 `runTurnReview` 判断需要压缩时先等待最多 8 秒直到代理空闲后再执行,减少无谓滞后队列堆积。
|
|
54
|
+
- **修复空白新对话发送消息吐出 `<||DSML|| calls>` 源码**:扩展 `chief-executor.js` 解析与剥离正则覆盖双全角竖线、混合空格、单双引号及未闭合残缺标签,并在 `getChiefView` 返回历史记录前再次清洗净化。
|
|
55
|
+
- **修复空白新对话工作区路径丢失**:升级 `getSessionCwd` 在无活会话与空板卡时通过 `workspaceRegistry.list()`(优先匹配 `sessionIds`,否则按最新活跃时间兜底)与近期非内部配置文件板卡定位真实项目目录。
|
|
56
|
+
- **修复权限模式切换持久化与旧版宿主内存告警**:持久化保存 4 档 `permissionMode`,同步对齐前后端构建标(`1.2.0-r7`),在宿主仍运行旧内存模块或未挂载新版全局变量时友好提示重启客户端。
|
|
57
|
+
- **修复本地↔全局冷库前后端防串味问题**:前端独立拆分 `globalVaultItems` 存储状态,并拦截旧版后端误将本地档案当作全局冷库返回的非合规响应。
|
|
58
|
+
|
|
8
59
|
## [1.1.0] - 2026-11-15
|
|
9
60
|
|
|
10
61
|
### Added
|
package/README.en.md
CHANGED
|
@@ -1,20 +1,23 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
<img src="assets/hero-banner.png" alt="DSH Chief (dsh-chief) — Multi-Agent
|
|
3
|
+
<img src="assets/hero-banner.png" alt="DSH Chief (dsh-chief) v1.2.0 — Wish-Driven Multi-Agent Cockpit & 3-Tier Cold Vaults" width="100%" />
|
|
4
4
|
|
|
5
5
|
<br />
|
|
6
6
|
|
|
7
7
|
# ✦ DSH Chief (`dsh-chief` · DSH 参谋长)
|
|
8
|
-
### Multi-Agent
|
|
8
|
+
### DeepSeek Harness Multi-Agent Cockpit · Wishing Box Executor · 3-Tier 0-Token Cold Vaults · `✦ 智选压缩`
|
|
9
9
|
|
|
10
10
|
[](https://dsh.deepseek.com)
|
|
11
|
+
[](https://www.npmjs.com/package/dsh-chief)
|
|
12
|
+
[](https://awesome-dsh-plugin.com/p/gluztm/dsh-chief/)
|
|
13
|
+
[](https://www.bilibili.com/video/BV1DqsV6QEGi)
|
|
11
14
|
[](https://github.com/deepseek-ai/dsh-superagent-prototype)
|
|
12
15
|
[](https://nodejs.org)
|
|
13
16
|
[](#)
|
|
14
|
-
[](#03--4-tier-cold-engineering-archive-cabinet-档案-tab)
|
|
15
17
|
[](LICENSE)
|
|
16
18
|
|
|
17
|
-
> **
|
|
19
|
+
> **Stop babysitting your AI agents — state your intent in the Wishing Box for Wish-Driven One-Stop Execution (`v1.2.0`)**
|
|
20
|
+
> Inspired by DeepSeek's official **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** *Router + Isolated Workers* architecture to keep focus sharp and context clean.
|
|
18
21
|
|
|
19
22
|
[简体中文 (`README.md`)](README.md) · **English** · [Changelog (`CHANGELOG.md`)](CHANGELOG.md)
|
|
20
23
|
|
|
@@ -22,52 +25,66 @@
|
|
|
22
25
|
|
|
23
26
|
---
|
|
24
27
|
|
|
25
|
-
## 🔗
|
|
28
|
+
## 🔗 Core Highlights Wired Into DSH Runtime
|
|
26
29
|
|
|
27
|
-
|
|
30
|
+
- **Persistent Router Cockpit**: Unifies the root coordinator, subagents, and linked DSH windows inside one **Full-Spread Pyramid DAG**—zero blind tab switching.
|
|
31
|
+
- **Native Split-Pane Streams (`subagentchat`)**: Click `分屏` on any subagent node to open DSH's native `sidebarRight.openResource` live stream.
|
|
32
|
+
- **4-Tier Permission-Gated Wishing Box (`chief-executor.js`)**: Inspect files, search workspaces, run safe commands, manage vaults/boards, and trigger compaction directly from the sidebar (`read-only` / `workspace-write` / `auto-review` / `danger-full-access`).
|
|
33
|
+
- **Ready on Blank New Sessions**: Resolves workspace root via `workspaceRegistry` even before turn 1 in the main chat, and stages `@lead` relays cleanly in `pending-transfer.json`.
|
|
34
|
+
- **Objective Lock & Human Sign-Off**: Strong Intervention locks your Core Objective (`0 = ∞` turns supported), verifies `allowed` must-do items, and waits for your explicit **`✅ 批准结项`** click.
|
|
35
|
+
- **Cross-Isolation `✦ 智选压缩` & Flexible Thresholds**: Compacts via DSH `/compact` across Cordis service isolation (and wakes dormant agents via `sessionController.resolveAgent`), supporting `10%–95%`, `>= 8,000` tokens, or direct `"压缩吧"` commands.
|
|
36
|
+
- **Three-Tier 0-Token Cold Vaults**: Isolates **Session Cabinet**, **System Global Cold Vault** (with live Local ↔ Global diff), and **Double-Blind Precipitated Vault**, spotlighted only via **`📌 摆上桌面`**.
|
|
37
|
+
- **Clean Cross-Window Linking & Pinnable Handoffs**: Warns before linking sessions, purges external context immediately on detach, and locks snapshots via **`📌 定住防改`**.
|
|
28
38
|
|
|
29
|
-
|
|
39
|
+
---
|
|
30
40
|
|
|
31
|
-
|
|
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. **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.
|
|
41
|
+
## 💡 6 Daily Engineering Pain Points — Solved
|
|
36
42
|
|
|
37
|
-
|
|
43
|
+
Ordinary Todo plugins give you another scratchpad; always-on memory plugins flood every system prompt with stale noise. **`dsh-chief` turns human micromanagement into Wish-Driven One-Stop Execution:**
|
|
38
44
|
|
|
39
|
-
|
|
45
|
+
### 1. Agents Stop Halfway ("I edited the file, please test it yourself")
|
|
46
|
+
- **Typical Plugins**: Static checklists let agents self-declare victory.
|
|
47
|
+
- **`dsh-chief`**: Locks the Core Objective with Strong Intervention (`0 = ∞`), verifies `allowed` must-do checks, and blocks exit until you click **`✅ 批准结项`**.
|
|
48
|
+
- **Instant Override**: High-risk checks prompt first, and the red **`⏹ 急停`** button halts background drives immediately.
|
|
40
49
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
4. **Forgotten Guardrails & Lost Chief State Across Windows**: Safety rules vanish when switching chats, forcing manual copy-paste and reconfiguration.
|
|
50
|
+
### 2. "Lobotomy" Amnesia Right After Context Compaction
|
|
51
|
+
- **Typical Plugins**: Auto-compaction wipes out freshly discovered file paths, commands, and errors.
|
|
52
|
+
- **`dsh-chief`**: Triggers **`✦ 智选压缩`** when idle at phase boundaries, custom **`10%–95%` / `>= 8k`** thresholds, or direct `"压缩吧"` requests.
|
|
53
|
+
- **Atomic Guarantee**: Harvests and disk-verifies notes in the Session Cabinet before `/compact`, never inflating counters on failures or empty no-ops.
|
|
46
54
|
|
|
47
|
-
|
|
55
|
+
### 3. Bloated Memory Injections Mudding the Model's Brain
|
|
56
|
+
- **Typical Plugins**: Re-injects megabytes of old logs every turn, burning quota and confusing current reasoning.
|
|
57
|
+
- **`dsh-chief`**: All three cold vaults remain **0 bytes / 0 tokens while sealed** (Precipitated Vault is double-blind to both Lead and Chief).
|
|
58
|
+
- **On-Demand Precision**: Injects only items explicitly spotlighted via **`📌 摆上桌面`** or flipped out via **`📤 取出`**.
|
|
48
59
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
60
|
+
### 4. Chat-Only "Mascot Copilots" Without Real Execution Tools
|
|
61
|
+
- **Typical Plugins**: Checking one config or running a quick check interrupts your main coding flow.
|
|
62
|
+
- **`dsh-chief`**: The right-sidebar Wishing Box executes real workspace tools across **4 permission modes**—even on unstarted blank tabs.
|
|
63
|
+
|
|
64
|
+
### 5. Cramped Subagent Views & Verbal Rules Forgotten in 10 Turns
|
|
65
|
+
- **Typical Plugins**: Tiny scroll boxes hide blocked workers, and safety instructions scroll out of context.
|
|
66
|
+
- **`dsh-chief`**: Full-spread Pyramid DAG + native split-pane stream viewer + **`📌` Global Thumbtack Redlines** persisted across tasks.
|
|
67
|
+
|
|
68
|
+
### 6. Lost Setup Across Windows & Silent Metered-API Quota Drain
|
|
69
|
+
- **Typical Plugins**: New tabs wipe your coordinator rules, while background loops hit expensive metered APIs.
|
|
70
|
+
- **`dsh-chief`**: Defaults to **`⏸ On-Demand` (0 background LLM calls)**, strictly aligns `Provider / Model` channels, and clones setup via 1-click Chief handoff.
|
|
57
71
|
|
|
58
72
|
---
|
|
59
73
|
|
|
60
|
-
## 📸 Visual Tour (7 High-DPI Views)
|
|
74
|
+
## 📸 Visual Tour (`v1.2.0` 7 High-DPI Views)
|
|
61
75
|
|
|
62
|
-
### 01 ·
|
|
63
|
-
|
|
76
|
+
### 01 · Wish-Driven Chief Cockpit (`参谋` Tab)
|
|
77
|
+
- **4-Tier Permission & Tactical Bar**: Compact `+` trigger on the left with live pills above (`⚡ 强介入 0/♾️`, `✦ 智选压缩`, `🛡 红线哨兵`, `🔵 完全权限`, and `⏹ 急停`).
|
|
78
|
+
- **Clear Execution & Compaction Receipts**: Live status narrative, boundary approval cards, and visible `✦ 智选压缩` chat receipts side-by-side.
|
|
79
|
+
- **Handoff Sync Toggle**: `同步交接单` control right in the cockpit header.
|
|
64
80
|
|
|
65
|
-

|
|
66
82
|
|
|
67
83
|
---
|
|
68
84
|
|
|
69
85
|
### 02 · Full-Spread Pyramid Subagent DAG (`任务` Tab)
|
|
70
|
-
|
|
86
|
+
- **Zero Cramped Panning**: Root Coordinator sits cleanly at the apex while subagent lanes spread vertically below.
|
|
87
|
+
- **Inline Squad Controls**: Transition statuses, ask for plain-language explanations, dispatch tasks, or launch native `分屏` live streams in one click.
|
|
71
88
|
|
|
72
89
|
<div align="center">
|
|
73
90
|
<img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - Full-Spread Pyramid Task Topology" width="76%" />
|
|
@@ -75,84 +92,96 @@ No cramped mini-viewports: the Root Coordinator sits at the top while subagent s
|
|
|
75
92
|
|
|
76
93
|
---
|
|
77
94
|
|
|
78
|
-
### 03 ·
|
|
79
|
-
|
|
80
|
-
- **4-Tier
|
|
81
|
-
- **
|
|
82
|
-
- **Lossless Chief Curation**: One-click curation refines points and summaries while preserving 100% of raw markdown text.
|
|
95
|
+
### 03 · Three-Tier 0-Token Cold Vaults & Bidirectional Diff (`档案` Tab)
|
|
96
|
+
- **Strict Vault Switcher**: Toggle **💬 Session Cabinet**, **🌐 System Global Vault**, and **🏛️ Precipitated Cold Vault** cleanly from the top bar.
|
|
97
|
+
- **4-Tier Paperclip Organization**: Cabinets → Drawers → Gold / Silver / Copper paperclipped dossiers → Unfoldable points & sub-points.
|
|
98
|
+
- **Spotlight & Diff Tracking**: Tracks `Synced` / `Local Modified` / `Local Only` diffs; inject selectively via **`📌 摆上桌面`** or send multi-archive **combinatorial relays**.
|
|
83
99
|
|
|
84
100
|
<div align="center">
|
|
85
|
-
<img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 -
|
|
101
|
+
<img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - Three-Tier Cold Vaults and Bidirectional Diff" width="68%" />
|
|
86
102
|
</div>
|
|
87
103
|
|
|
88
104
|
---
|
|
89
105
|
|
|
90
|
-
### 04 ·
|
|
91
|
-
|
|
106
|
+
### 04 · Goal Supervision, Step Q&A & Closure Gate (`规划` Top)
|
|
107
|
+
- **Core Objective Lock**: Click **`🎯 设为目标`** to supervise long-horizon goals (locked automatically while Strong Intervention is active).
|
|
108
|
+
- **Interactive Step Board**: Click any step to ask Chief *"Why does this step exist?"* without interrupting the main session.
|
|
92
109
|
|
|
93
110
|
<div align="center">
|
|
94
|
-
<img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - Goal Supervision
|
|
111
|
+
<img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - Goal Supervision and Step Q&A" width="68%" />
|
|
95
112
|
</div>
|
|
96
113
|
|
|
97
114
|
---
|
|
98
115
|
|
|
99
|
-
### 05 · Cross-Window Linking
|
|
100
|
-
Link multiple independent DSH
|
|
116
|
+
### 05 · Cross-Window Peer Linking & Drawer Mailbox (`协同` Tab)
|
|
117
|
+
- **Cluster Federation**: Link multiple independent DSH windows to share real-time progress, with instant zero-pollution cleanup on detach.
|
|
118
|
+
- **Color-Coded Drawer Mailbox**: Deduplicates `@all` broadcasts and groups messages by channel scope.
|
|
119
|
+
- **Lossless Image Staging**: Uploaded screenshots persist directly in `<cwd>/.dsh-chief/uploads/` for multimodal lead fallback.
|
|
101
120
|
|
|
102
121
|
<div align="center">
|
|
103
|
-
<img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - Cross-
|
|
122
|
+
<img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - Cross-Window Linking and Mailbox" width="68%" />
|
|
104
123
|
</div>
|
|
105
124
|
|
|
106
125
|
---
|
|
107
126
|
|
|
108
|
-
### 06 · `📌` Global Thumbtack Redlines &
|
|
109
|
-
|
|
127
|
+
### 06 · `📌` Global Thumbtack Redlines & Proposals (`边界` Tab)
|
|
128
|
+
- **Task vs. Global Scope**: Pin critical rules with **`📌`** to enforce globally across projects; leave unpinned rules scoped to the active session.
|
|
129
|
+
- **Must-Do & Boundary Governance**: Manage `allowed`, `forbidden`, and `notes` rules, approve worker proposals, or consolidate scattered entries cleanly.
|
|
110
130
|
|
|
111
131
|
<div align="center">
|
|
112
|
-
<img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 -
|
|
132
|
+
<img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - Global Thumbtack Redlines" width="68%" />
|
|
113
133
|
</div>
|
|
114
134
|
|
|
115
135
|
---
|
|
116
136
|
|
|
117
|
-
### 07 ·
|
|
118
|
-
|
|
137
|
+
### 07 · Cross-Session Relay, `📌 定住防改` & 1-Click Deployment (`规划` Bottom)
|
|
138
|
+
- **Editable & Pinnable Handoff**: Freeze auto-rendered snapshots cleanly via **`📌 定住防改`** (automatically locking auto-sync overwrites).
|
|
139
|
+
- **4 Scoped Archive Policies**: Choose `None`, `Spotlight Only`, `Entire Drawer`, or `Full Session Cabinet`—while Precipitated Vault stays isolated.
|
|
140
|
+
- **1-Click Chief Deployment & `idle-guard`**: Clones Chief config safely (forcing Strong Intervention off) to a fresh or target session.
|
|
119
141
|
|
|
120
142
|
<div align="center">
|
|
121
|
-
<img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 -
|
|
143
|
+
<img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - Cross-Session Relay and Pinnable Handoff" width="68%" />
|
|
122
144
|
</div>
|
|
123
145
|
|
|
124
146
|
---
|
|
125
147
|
|
|
126
|
-
## ⚠️ Usage Notes & Disclaimers
|
|
148
|
+
## ⚠️ Usage Notes & Two Critical Disclaimers
|
|
127
149
|
|
|
128
150
|
> [!IMPORTANT]
|
|
129
|
-
>
|
|
151
|
+
> Keep these two engineering realities in mind before enabling Wishing Box tools, **`⚡ Strong Intervention`**, or **`✦ 智选压缩`**:
|
|
130
152
|
>
|
|
131
|
-
> 1. **
|
|
132
|
-
>
|
|
133
|
-
>
|
|
134
|
-
>
|
|
153
|
+
> 1. **Safety Floor From Plugin Guardrails — Intelligence Ceiling From Your Underlying LLM**
|
|
154
|
+
> - `dsh-chief` guarantees the engineering floor (0-token vault isolation, 4 permission modes, verified pre-compact harvesting, circuit breakers, and `⏹ 急停`).
|
|
155
|
+
> - However, planning rigor, multi-step tool precision, and supervision quality **depend directly on the LLM you assign to DSH Chief**.
|
|
156
|
+
> - Use a strong reasoning flagship model for Chief on complex projects rather than expecting frontier orchestration from tiny models.
|
|
157
|
+
> 2. **Avoid Flooding the Model's Brain With Heavy External Prompt Injections**
|
|
158
|
+
> - Do **not** stack huge System Prompts, hundreds of conflicting project Rules, or always-injected memory plugins alongside `dsh-chief`.
|
|
159
|
+
> - **Bloated injections muddy working memory and fracture attention**, frequently clashing with Chief supervision and causing loops or early trips.
|
|
160
|
+
> - Keep global prompts lean and store low-frequency context inside `dsh-chief`'s **0-Token Cold Vaults** for on-demand retrieval.
|
|
135
161
|
|
|
136
162
|
---
|
|
137
163
|
|
|
138
164
|
## ⚡ Quick Installation (Zero External Dependencies)
|
|
139
165
|
|
|
166
|
+
Search **`dsh-chief`** inside [dshmarket](https://github.com/dsh-market/dsh-market) / DSH Plugin Market, or install via CLI (replace `desktop` with `web` for web profile):
|
|
167
|
+
|
|
140
168
|
```bash
|
|
141
|
-
#
|
|
142
|
-
dsh plugin --profile desktop add
|
|
169
|
+
# Option 1: Install from npm registry (recommended — fastest mirrors + auto-update notices)
|
|
170
|
+
dsh plugin --profile desktop add dsh-chief
|
|
143
171
|
|
|
144
|
-
#
|
|
172
|
+
# Option 2: Install prebuilt v1.2.0 GitHub Release tarball
|
|
173
|
+
dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.2.0/dsh-chief-1.2.0.tgz
|
|
174
|
+
|
|
175
|
+
# Option 3: Install directly from GitHub repository
|
|
145
176
|
dsh plugin --profile desktop add github:gluztm/dsh-chief
|
|
146
177
|
```
|
|
147
178
|
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
### Host Compatibility Matrix
|
|
179
|
+
### Host Version Compatibility Matrix
|
|
151
180
|
|
|
152
|
-
| DeepSeek Harness (DSH) Version |
|
|
181
|
+
| DeepSeek Harness (DSH) Version | Panel / Board / 3-Tier Vaults / Wishing Box | Named Subagent Tree (`task.dispatch` / `team.*`) | Notes |
|
|
153
182
|
| :--- | :---: | :---: | :--- |
|
|
154
|
-
| **`>= 0.2.2-rc.2` (`rc.3+` recommended)** | ✅ Full support | ✅ Full support |
|
|
155
|
-
| `0.2.0 ~ 0.2.2-rc.1` | ✅ Panel works normally | ⚠️
|
|
183
|
+
| **`>= 0.2.2-rc.2` (`rc.3+` recommended)** | ✅ Full support | ✅ Full support | Native `subagents.resolveName` / `rootOf` / `namesOf` |
|
|
184
|
+
| `0.2.0 ~ 0.2.2-rc.1` | ✅ Panel works normally | ⚠️ Upgrade banner | Safely guards `team.*` calls with upgrade guidance |
|
|
156
185
|
|
|
157
186
|
---
|
|
158
187
|
|
|
@@ -160,21 +189,22 @@ Refresh the DSH Web UI and click the **✦ `DSH 参谋长`** icon in the right-h
|
|
|
160
189
|
|
|
161
190
|
| Tool Name | Purpose | Key Actions |
|
|
162
191
|
| :--- | :--- | :--- |
|
|
163
|
-
| **`chief_board`** | Task DAG orchestration, step
|
|
164
|
-
| **`chief_memory`** | Session-scoped hot digest
|
|
165
|
-
| **`chief_boundaries`** | Global
|
|
166
|
-
| **`chief_handoff`** |
|
|
192
|
+
| **`chief_board`** | Task DAG orchestration, step lists, archive search, inter-agent mail, smart compaction | `graph.plan`, `task.add`, `task.update`, `plan.set`, `cursor.set`, `mail.send`, `archive.save`, `archive.search`, `bounds.propose`, `context.compact` |
|
|
193
|
+
| **`chief_memory`** | Session-scoped hot digest items (`decisions`, `progress`, `verify`, `risks`) | `list`, `get`, `add`, `update`, `remove` |
|
|
194
|
+
| **`chief_boundaries`** | Global thumbtack redlines (`📌`), must-do checks (`allowed`), and notes | `get`, `set`, `add`, `pin`, `remove` |
|
|
195
|
+
| **`chief_handoff`** | Generate self-contained cross-session Markdown handoff packets | `preview` / session relay |
|
|
167
196
|
|
|
168
197
|
---
|
|
169
198
|
|
|
170
199
|
## 🛡️ Security & Local-Only Privacy
|
|
171
200
|
|
|
172
|
-
- **
|
|
173
|
-
- **
|
|
174
|
-
- **
|
|
201
|
+
- **Atomic Exclusive File Locks**: Prevents corruption on `board.json` and 3-tier archive files even under concurrent writes.
|
|
202
|
+
- **Zero-Leak 0-Token Vaults**: Sealed dossiers inject **0 bytes** into lead/chief prompts until explicitly pinned to Desk or flipped out.
|
|
203
|
+
- **25 Same-Origin Loopback Routes**: Every `/api/dsh-chief/*` endpoint validates loopback origin and host headers.
|
|
204
|
+
- **Regex Secret Blocker**: Blocks accidental persistence of `sk-*`, `ghp_*`, Bearer tokens, and OpenSSH private keys; 100% local under `~/.dsh/chief/` with zero telemetry.
|
|
175
205
|
|
|
176
206
|
---
|
|
177
207
|
|
|
178
208
|
## 📄 License
|
|
179
209
|
|
|
180
|
-
Licensed under
|
|
210
|
+
Licensed under **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)**.
|