dsh-chief 1.0.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 CHANGED
@@ -5,6 +5,78 @@ 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
+
59
+ ## [1.1.0] - 2026-11-15
60
+
61
+ ### Added
62
+ - **Tactical Cockpit & Per-Workspace Intervention Gate**:
63
+ - 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).
64
+ - **Pre-Compaction Harvest-Verify-Compact**:
65
+ - Automatic fact harvesting and disk verification prior to session context compaction without touching sealed cold precipitation vaults.
66
+ - **`/goal` Human Approval Gate**:
67
+ - Pending approval cards before agents mutate long-running `/goal` objectives.
68
+ - **Dual-Vault Archive Architecture**:
69
+ - 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 (`翻牌启用/封存`).
70
+ - **One-Click Chief Deployment & Media Persistence**:
71
+ - 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.
72
+
73
+ ### Fixed
74
+ - **DSH Host Compatibility & Subagent API Guardrails (Fixes [#1](https://github.com/gluztm/dsh-chief/issues/1), thanks `@edz017`)**:
75
+ - 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.
76
+ - 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.
77
+ - Fixed `sidebarRight.openResource` option key from `preferSeparatePane: true` to `preferNewPane: true` in `client.js`.
78
+ - Added a DSH Host Version Compatibility Matrix to both `README.md` and `README.en.md`.
79
+
8
80
  ## [1.0.0] - 2026-11-14
9
81
 
10
82
  ### 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 Command & Cold Archive Vault" width="100%" />
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 Command Cockpit · SuperAgent Cross-Session Synergy · 4-Tier Cold Archive Vault for DeepSeek Harness
8
+ ### DeepSeek Harness Multi-Agent Cockpit · Wishing Box Executor · 3-Tier 0-Token Cold Vaults · `✦ 智选压缩`
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
+ [![npm version](https://img.shields.io/npm/v/dsh-chief?color=cb3837&style=flat-square)](https://www.npmjs.com/package/dsh-chief)
12
+ [![DSH Market](https://img.shields.io/badge/DSH%20Market-Listed-f59e0b?style=flat-square)](https://awesome-dsh-plugin.com/p/gluztm/dsh-chief/)
13
+ [![Bilibili Demo](https://img.shields.io/badge/Bilibili-Video%20Demo-fb7299?style=flat-square)](https://www.bilibili.com/video/BV1DqsV6QEGi)
11
14
  [![SuperAgent Ready](https://img.shields.io/badge/SuperAgent-Router--Worker%20Synergy-a855f7?style=flat-square)](https://github.com/deepseek-ai/dsh-superagent-prototype)
12
15
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022.13-30d158?style=flat-square)](https://nodejs.org)
13
16
  [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20External-ffe033?style=flat-square)](#)
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
17
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
16
18
 
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.
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
- ## 🔗 Deep Synergy with Official DeepSeek SuperAgent & Native DSH Runtime
28
+ ## 🔗 Core Highlights Wired Into DSH Runtime
26
29
 
27
- DeepSeek's official **[`dsh-superagent-prototype`](https://github.com/deepseek-ai/dsh-superagent-prototype)** highlights two core bottlenecks in multi-agent engineering: the **Human Attention Bottleneck** across concurrent sessions and **Context Pollution** from accumulated history—solving them via a persistent **Router** coordinating isolated **Worker** sessions.
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
- **`dsh-chief` brings that exact Router–Worker command paradigm into an interactive right-sidebar cockpit natively wired into DSH:**
39
+ ---
30
40
 
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
- 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.
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
- ## 💡 Why `dsh-chief` Is Fundamentally Different
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
- Ordinary Todo lists and always-injected memory plugins break down on complex, multi-subagent engineering sessions:
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.
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.
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
- **`dsh-chief` («DSH 参谋长») replaces ad-hoc scratchpads with a full right-docked Chief of Staff cockpit:**
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
- | Capability | Typical Todo / Always-On Memory Plugins | ✦ DSH Chief (`dsh-chief`) |
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 |
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` |
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 · Right-Docked Executive Chief Cockpit (`参谋` Tab)
63
- Docked alongside your live conversation: displays exact `Provider · Model` channel alignment, the `⏸ On-Demand` human-paced toggle, structured status briefings, pending boundary approvals, and natural-language `@target` dispatch chips.
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
- ![01 - Executive Chief Cockpit Overview](assets/screenshots/01-chief-cockpit-overview.png)
81
+ ![01 - Wish-Driven Chief Cockpit Overview](assets/screenshots/01-chief-cockpit-overview.png)
66
82
 
67
83
  ---
68
84
 
69
85
  ### 02 · Full-Spread Pyramid Subagent DAG (`任务` Tab)
70
- No cramped mini-viewports: the Root Coordinator sits at the top while subagent squads spread out across structured columns with direct inline controls for status transitions, plain-language explanation, task dispatch, and split-screen subagent chat inspection.
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,65 +92,96 @@ No cramped mini-viewports: the Root Coordinator sits at the top while subagent s
75
92
 
76
93
  ---
77
94
 
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`.
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 - 4-Tier Cold Engineering Archive Cabinet" width="68%" />
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 · 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.
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 - Dual-Tier Goal and Step Q&A" width="68%" />
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 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.
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-Session Collaboration Bus" width="68%" />
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 & 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.
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 - Pinned Global Redlines and Governance" width="68%" />
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 · 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.
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 - Self-Contained Session Handoff and Idle Guard" width="68%" />
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
 
148
+ ## ⚠️ Usage Notes & Two Critical Disclaimers
149
+
150
+ > [!IMPORTANT]
151
+ > Keep these two engineering realities in mind before enabling Wishing Box tools, **`⚡ Strong Intervention`**, or **`✦ 智选压缩`**:
152
+ >
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.
161
+
162
+ ---
163
+
126
164
  ## ⚡ Quick Installation (Zero External Dependencies)
127
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
+
128
168
  ```bash
129
- # 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
169
+ # Option 1: Install from npm registry (recommended — fastest mirrors + auto-update notices)
170
+ dsh plugin --profile desktop add dsh-chief
171
+
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
131
174
 
132
- # Or install directly via GitHub shorthand (replace `desktop` with `web` if using web profile)
175
+ # Option 3: Install directly from GitHub repository
133
176
  dsh plugin --profile desktop add github:gluztm/dsh-chief
134
177
  ```
135
178
 
136
- Refresh the DSH Web UI and click the **✦ `DSH 参谋长`** icon in the right-hand sidebar header.
179
+ ### Host Version Compatibility Matrix
180
+
181
+ | DeepSeek Harness (DSH) Version | Panel / Board / 3-Tier Vaults / Wishing Box | Named Subagent Tree (`task.dispatch` / `team.*`) | Notes |
182
+ | :--- | :---: | :---: | :--- |
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 |
137
185
 
138
186
  ---
139
187
 
@@ -141,21 +189,22 @@ Refresh the DSH Web UI and click the **✦ `DSH 参谋长`** icon in the right-h
141
189
 
142
190
  | Tool Name | Purpose | Key Actions |
143
191
  | :--- | :--- | :--- |
144
- | **`chief_board`** | Task DAG orchestration, step checklists, cold archive queries, and inter-agent mail | `graph.plan`, `task.add`, `task.update`, `plan.set`, `cursor.set`, `mail.send`, `archive.save`, `archive.search`, `bounds.propose` |
145
- | **`chief_memory`** | Session-scoped hot digest entries (progress, decisions, verification, risks) | `list`, `get`, `add`, `update`, `remove` |
146
- | **`chief_boundaries`** | Global pinned redlines (`📌`) and task-scoped working boundaries | `get`, `set`, `add`, `pin`, `remove` |
147
- | **`chief_handoff`** | Self-contained Markdown handoff packet generation across sessions | `preview` / structured session relay |
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 |
148
196
 
149
197
  ---
150
198
 
151
199
  ## 🛡️ Security & Local-Only Privacy
152
200
 
153
- - **Loopback + Same-Origin Guard**: Every `/api/dsh-chief/*` endpoint enforces loopback client verification and same-origin `Origin`/`Host` validation.
154
- - **Automatic Secret Blocking**: Rejects accidental persistence of `sk-*`, `ghp_*`, Bearer tokens, and OpenSSH private keys across boards, facts, and archives.
155
- - **100% Local Storage**: All state lives exclusively on disk under `~/.dsh/chief/` (`board.json`, `boards/`, `archives.json`, `chief-state.json`) with zero external runtime dependencies and zero telemetry.
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.
156
205
 
157
206
  ---
158
207
 
159
208
  ## 📄 License
160
209
 
161
- Licensed under the **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)**.
210
+ Licensed under **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)**.