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 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 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
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, 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.
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. **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
- ## 💡 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 & 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
- 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 & 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
- **`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
- | **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
- | **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
- | **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` |
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,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 · 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
- - **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 - Multi-Cabinet Archives and 0-Token Precipitated Cold Vault" 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 · 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.
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, Approval Gate and 1-Click Chief Deployment" 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 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.
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 & 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 **守护偏好**.
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 · 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.
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 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
 
126
- ## ⚠️ Usage Notes & Disclaimers
148
+ ## ⚠️ Usage Notes & Two Critical Disclaimers
127
149
 
128
150
  > [!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:
151
+ > Keep these two engineering realities in mind before enabling Wishing Box tools, **`⚡ Strong Intervention`**, or **`✦ 智选压缩`**:
130
152
  >
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.
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
- # Fast install from prebuilt GitHub Release tarball (~240 KB, zero build scripts)
142
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.1.0/dsh-chief-1.1.0.tgz
169
+ # Option 1: Install from npm registry (recommended — fastest mirrors + auto-update notices)
170
+ dsh plugin --profile desktop add dsh-chief
143
171
 
144
- # Or install directly via GitHub shorthand (replace `desktop` with `web` if using web profile)
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
- Refresh the DSH Web UI and click the **✦ `DSH 参谋长`** icon in the right-hand sidebar header.
149
-
150
- ### Host Compatibility Matrix
179
+ ### Host Version Compatibility Matrix
151
180
 
152
- | DeepSeek Harness (DSH) Version | Sidebar Panel / Board / Vaults / Bounds | Named Subagent Tree (`task.dispatch` / `team.steer` / `team.interrupt`) | Notes |
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 | 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 |
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 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` |
164
- | **`chief_memory`** | Session-scoped hot digest entries (progress, decisions, verification, risks) | `list`, `get`, `add`, `update`, `remove` |
165
- | **`chief_boundaries`** | Global pinned redlines (`📌`) and task-scoped working boundaries | `get`, `set`, `add`, `pin`, `remove` |
166
- | **`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 |
167
196
 
168
197
  ---
169
198
 
170
199
  ## 🛡️ Security & Local-Only Privacy
171
200
 
172
- - **Loopback + Same-Origin Guard**: Every `/api/dsh-chief/*` endpoint enforces loopback client verification and same-origin `Origin`/`Host` validation.
173
- - **Automatic Secret Blocking**: Rejects accidental persistence of `sk-*`, `ghp_*`, Bearer tokens, and OpenSSH private keys across boards, facts, and archives.
174
- - **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.
175
205
 
176
206
  ---
177
207
 
178
208
  ## 📄 License
179
209
 
180
- 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)**.