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/README.md CHANGED
@@ -1,20 +1,23 @@
1
1
  <div align="center">
2
2
 
3
- <img src="assets/hero-banner.png" alt="DSH 参谋长 (dsh-chief) — 多智能体指挥与四层冷存储记忆中枢" width="100%" />
3
+ <img src="assets/hero-banner.png" alt="DSH 参谋长 (dsh-chief) v1.2.0 — 许愿式一站式多代理指挥与三层冷库中枢" width="100%" />
4
4
 
5
5
  <br />
6
6
 
7
7
  # ✦ DSH 参谋长 (`dsh-chief`)
8
- ### DeepSeek Harness 多智能体参谋指挥舱 · SuperAgent 跨窗统筹 · 四层冷存储工程档案柜
8
+ ### DeepSeek Harness 多智能体指挥舱 · ✦ 许愿框一站式办理 · 三层 0-Token 档案金库 · `✦ 智选压缩`
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-%E5%AE%9E%E6%9C%BA%E6%BC%94%E7%A4%BA-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--四层冷存储工程档案柜档案页签)
15
17
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
16
18
 
17
- > **把散装聊天窗升级为智能体总司令部**:深度呼应 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」注意力减负范式,并与 **DeepSeek Harness (DSH)** 原生子代理分屏、`/goal` 长程目标、实时 `steer` 切入及跨会话导航无缝联动。
19
+ > **告别给 AI 当“全职保姆、传话筒与记事员”——向右侧「✦ 许愿框」许下意图,一站式跑通全流程(`v1.2.0`)**
20
+ > 深度呼应 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)**「Router 统筹 + Workers 隔离执行」范式,将散装聊天窗升级为常驻总指挥台。
18
21
 
19
22
  **简体中文** · [English (`README.en.md`)](README.en.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md)
20
23
 
@@ -22,52 +25,67 @@
22
25
 
23
26
  ---
24
27
 
25
- ## 🔗 与 DeepSeek 官方 SuperAgent 范式及 DSH 原生能力深度联动
28
+ ## 🔗 与 SuperAgent 及 DSH 原生能力深度联动
26
29
 
27
- DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deepseek-ai/dsh-superagent-prototype)** 指出了多智能体研发中最核心的两大难题:**人类注意力瓶颈(Human Attention Bottleneck)**与**长上下文污染(Context Pollution)**,并提出了「常驻统筹层(Router)+ 隔离执行层(Workers)」的双层解耦架构。
30
+ - **常驻指挥中枢**:把主对话、子代理和跨窗独立会话收拢到同一张**全铺开金字塔拓扑图**,不再在十几个黑盒标签页间来回切换。
31
+ - **原生分屏盯流 (`subagentchat`)**:任意子代理卡片点击「`分屏`」,直连 `sidebarRight.openResource` 拉开实时推理流。
32
+ - **✦ 许愿框 4 档实权执行器 (`chief-executor`)**:右侧许愿框不再只嘴上聊天,按 4 档权限门禁直接读写查代码、跑安全命令、改看板与压上下文。
33
+ - **空白新对话即开即用**:主对话尚未发送第一条消息时,自动定位当前工作区开工,或预埋待领包给即将开启的 `@lead`。
34
+ - **目标锁死 + 人类拍板结项**:强介入锁定核心目标(支持 `0 = ♾️` 无限轮),达标后核验 `allowed` 必做清单并等待人类点击「`✅ 批准结项`」。
35
+ - **✦ 智选压缩 + 灵活安全阈值**:支持 `✦ 智选压缩` 在阶段收口等主代理空闲后触发,也支持 `10%–95%` / `>= 8k` Token 阈值或直说「压缩吧」。
36
+ - **跨隔离真 `/compact`**:自动跨过 Cordis 服务隔离调用官方 `/compact` 通道,先抢救工程细节入柜并复核落盘,再静默压缩留回执。
37
+ - **三层 0-Token 档案金库**:💬 本会话柜(1:1 隔离)、🌐 系统全局冷库(双向差分)、🏛️ 沉淀冷库(默认双盲 0 字节),支持一键「`📌 摆上桌面`」与「`组合递话`」。
38
+ - **跨窗协同与定住防改交接单**:入网前提示污染风险、断联立即净化防串味,支持手改与一键「`📌 定住防改`」冻结交接快照。
28
39
 
29
- **`dsh-chief`(DSH 参谋长)正是将这一理念直接搬进 DSH 右侧边栏的可视化指挥中枢,并与 DSH 宿主底层能力全链路打通:**
40
+ ---
30
41
 
31
- 1. **SuperAgent「统筹 + 工人」可视化落地**:无需在十几个并发会话与子代理黑盒间来回切换——参谋长常驻右侧栏充当你的全局统筹台(Router Cockpit),将当前主代理、下辖各路子代理(Subagents)以及跨窗口独立 Worker 会话收拢进同一张**全铺开金字塔拓扑图**与**协同通讯录**中。
32
- 2. **原生联动 DSH 子代理分屏实时流(`subagentchat`)**:在金字塔节点或协同列表上点击「`分屏对话`」,直接调用 DSH 原生 `sidebarRight.openResource('dsh-resource://subagentchat/...')`,在右侧分屏即时拉开对应子代理的实时推理流。
33
- 3. **原生联动 DSH `/goal` 长程持续督导**:规划页独立承载 `/goal` 总纲并与底部步骤板双层联动,配合 `idle-guard` 空转完结守护,防止模型在多步长任务中途「口头交差」提前停机。
34
- 4. **原生联动 DSH Agent 运行时三态注入与多渠道对齐**:跨会话信使总线直连宿主 `agents` 服务,支持 `插话 (steer,下一步立即切入)` / `递话 (followup,排队唤醒)` / `备忘 (silent,静默投递信箱)`,并精确读取当前会话的完整 `provider/model` 标识(如区分 `CommandCode` 与官方按量渠道),杜绝同名模型串渠道误扣费。
35
- 5. **原生联动 DSH 工作区导航与冷热上下文隔离**:一键交接通过宿主 `uiWorkspace.openSession` 创建干净的隔离接力会话并自动切走前端画面;四层「工程档案柜」平时对提示词保持 **0 字节注入**,彻底守住干净上下文边界。
42
+ ## 💡 为什么需要「DSH 参谋长」?(6 大日常痛点 × 独家破局机制)
36
43
 
37
- ---
44
+ 普通待办只是多了一块手写备忘录,常驻记忆只是每轮往提示词里硬塞几千字旧账;**`dsh-chief` 把「人盯 AI 干活」反转为「许愿式一站式跑通」**。
38
45
 
39
- ## 💡 为什么需要「DSH 参谋长」?(它与普通看板/记忆插件有何本质不同)
46
+ ### 1. AI 半途偷懒交差(“改好了你自己测吧”)
47
+ - **普通插件**:只有静态文字清单,模型自说自话就能宣布完成。
48
+ - **`dsh-chief` 解法**:用「🎯 目标督导」+「⚡ 强介入(`0 = ♾️` 无限轮)」锁死终点,未核验 `allowed` 必做清单且未获你点击「`✅ 批准结项`」绝不放行。
49
+ - **可控急停**:触发高危动作前先弹窗确认,随时点击红色 **「⏹ 急停」** 秒切人工接管。
40
50
 
41
- 在真实的大型工程与多子代理(Subagents)协作中,普通「待办小本本」或「全量注入式记忆插件」往往会撞上四大痛点:
42
- 1. **后台偷跑 Token、跨渠道乱选模型**:每轮对话结束都在后台偷偷调用大模型做全量总结,甚至把免费/订阅渠道的同名模型误匹配到高价按量渠道。
43
- 2. **记忆越存越慢、污染上下文**:把几十篇排障笔记一股脑塞进 System Prompt,每轮白烧数千 Token,还会严重干扰模型对当前任务的注意力。
44
- 3. **小画布拖拽迷宫**:子代理一多,任务图缩在巴掌大的滚动视口里来回拖拉,根本看不清谁卡住了、谁做完了。
45
- 4. **口头立规矩转头就忘、换窗口就失忆**:聊天里交代的安全红线一压缩就丢;不同窗口的主对话各自为战,切新会话还得手写长篇背景。
51
+ ### 2. 上下文一压缩就“脑叶切除”式失忆
52
+ - **普通插件**:压缩一触发,刚查出来的路径、命令和结论全被抹光。
53
+ - **`dsh-chief` 解法**:支持「`✦ 智选压缩`」、`10%–95%` / `>= 8k` Token 阈值,以及一句「压缩吧」确定性办理。
54
+ - **原子保底**:强制先抢救细节入本会话档案柜并核验落盘,再跨隔离静默 `/compact`;失败或免压绝不虚增计数。
46
55
 
47
- **`dsh-chief`(DSH 参谋长)不是一个简单的“记事本”,而是一套完整的右侧栏多智能体指挥部:**
56
+ ### 3. 传统记忆插件把对话模型“脑子”搅浑、Token 越用越多
57
+ - **普通插件**:每轮把几十篇过时笔记硬灌进 System Prompt,烧 Token 还干扰当下推理。
58
+ - **`dsh-chief` 解法**:三层冷库平时 **0 字节 / 0 Token 物理隔离**,沉淀库默认双盲不可见。
59
+ - **精准按需**:只有你点击「`📌 摆上桌面`」或「`📤 取出`」时才临时注入,点回封存即刻归零。
48
60
 
49
- | 核心维度 | 普通 Todo / 常驻记忆插件 | ✦ DSH 参谋长 (`dsh-chief`) |
50
- | :--- | :--- | :--- |
51
- | **参谋节奏与渠道对齐** | 后台每轮盲目触发总结,同名模型易串渠道扣费 | **人类三档控速**(默认 `⏸ 按需` **0 自动调用**,可选 `⚡ 巡检` / `🤖 托管`),严格对齐完整 `provider/model` 渠道 |
52
- | **多代理拓扑可视性** | 扁平列表或狭窄视口,频繁横向/纵向拖动 | **全铺开金字塔 DAG 指挥图**:主代理居中统帅、子代理分列纵队,状态切换/解释/派发/分屏看流全部原地铺开 |
53
- | **长期工程记忆架构** | 常驻塞入提示词(费 Token)或纯扁平长文难翻阅 | **四层冷存储「工程档案柜」**:`抽屉 → 金/银/暗铜曲别针卷宗 → 记忆点 → 可展开小点记忆`;平时 **0 字节注入提示词**,仅在「取出备查」时挂载 |
54
- | **规划可读性与互动** | 冰冷的技术步骤列表,非底层开发者难看懂意图 | **上 `/goal` 总纲 + 下步骤板**:点击任意步骤即可一键追问「**这条是什么意思 / 为什么有这步**」或请参谋长当场白话解读 |
55
- | **跨会话与子代理协同** | 仅限单会话内部,窗口之间完全割裂 | **跨窗口独立会话串联 + 三态信使总线**:支持 `插话 (steer)` / `递话 (followup)` / `备忘 (silent)` 直达任意子代理或联动窗口 |
56
- | **红线治理与长程接力** | 规则混在聊天记录里,换会话靠人工复制粘贴 | **`📌` 图钉全局红线盖章**(跨任务永久生效 vs 仅本任务生效)+ **一键生成自包含交接单并自动切入新会话** + **空转完结守护** |
61
+ ### 4. 只敢嘴上聊天的“吉祥物副驾”
62
+ - **普通插件**:想查个配置文件或跑个检查命令,只能打断主对话重新排队。
63
+ - **`dsh-chief` 解法**:内置 4 档权限门禁(`仅可查看` / `工作区内修改` / `自动审查 EXP` / `完全权限`),右侧许愿框一句话直接办妥。
64
+
65
+ ### 5. 多子代理黑盒迷宫 & 口头红线聊十轮就忘
66
+ - **普通插件**:窄视口列表反复拖拽,聊天里交代的红线随上下文滚出窗口。
67
+ - **`dsh-chief` 解法**:全铺开金字塔 DAG + 原生分屏看流 + **「`📌` 图钉全局红线」**跨任务永久生效,子代理撞墙主动呈批。
68
+
69
+ ### 6. 换窗口就断档 & 后台偷偷按量计费
70
+ - **普通插件**:切窗口前情全丢;后台每轮乱跑总结,还常把订阅模型错配到高价按量渠道。
71
+ - **`dsh-chief` 解法**:默认 **`⏸ 按需`(0 后台自动调用)**,严格对齐主会话 `Provider · 模型`;支持跨窗互联、断联净化与一键携参谋部署接力。
57
72
 
58
73
  ---
59
74
 
60
- ## 📸 全景实机导览(7 大核心视窗)
75
+ ## 📸 全景实机导览(`v1.2.0` 7 大核心视窗)
61
76
 
62
- ### 01 · 常驻右侧栏参谋指挥舱(`参谋` 页签)
63
- 与宿主对话区并排常驻:顶部实时呈现当前跟随的 `Provider · 模型` 渠道、人类三档控速开关(默认 `⏸ 按需` 零后台损耗)与子代理/联动窗口徽标;中部展示结构化战场简报与待盖章的边界请示;底部一句话即可向 `@主对话`、`@子代理` 或 `@跨窗会话` 拆话调度。
77
+ ### 01 · 许愿式参谋指挥舱(`参谋` 页签)
78
+ - **实权许愿框**:输入栏居左收拢 `+` 战术驾驶舱,上方直显 `⚡ 强介入 0/♾️`、`✦ 智选压缩`、`🛡 红线哨兵`、`🔵 完全权限` 与红色 `⏹ 急停`。
79
+ - **可见工作回执**:结构化战场摘要、边界请示卡、以及 `✦ 智选压缩` 真实压完后写回的可见回执一目了然。
80
+ - **同步交接单开关**:右上角可直接切换「提炼摘要后同步更新交接单」。
64
81
 
65
- ![01 - 参谋长全景指挥舱](assets/screenshots/01-chief-cockpit-overview.png)
82
+ ![01 - 许愿式参谋长全景指挥舱](assets/screenshots/01-chief-cockpit-overview.png)
66
83
 
67
84
  ---
68
85
 
69
86
  ### 02 · 全铺开金字塔子代理拓扑(`任务` 页签)
70
- 彻底告别局促的小窗拖拽:`👑 主代理·总指挥` 坐镇顶端,下辖各路子代理横向铺开为清晰纵队;每张任务卡原地集成 **状态一键流转、白话解释、指派执行、子代理分屏实时盯流**,谁在推进、谁被卡住一眼洞穿。
87
+ - **纵队全铺开**:`👑 主代理 · 总指挥` 居中统帅,下辖子代理横向分列纵队,不再在小视口里来回拖拽。
88
+ - **原地闭环操作**:每张节点卡直接集成「状态切换、白话解释、派发执行、对话拆解、`分屏` 实时盯流」。
71
89
 
72
90
  <div align="center">
73
91
  <img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - 全铺开金字塔任务拓扑" width="76%" />
@@ -75,29 +93,31 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
75
93
 
76
94
  ---
77
95
 
78
- ### 03 · 四层冷存储「工程档案柜」(`档案` 页签)
79
- 像真正的工程档案室一样分层保管长期技术资产,彻底根治「长记忆烧光上下文」顽疾:
80
- - **四层收纳结构**:**分类抽屉**(拉开抽屉)→ **三色曲别针卷宗**(高对比度 **璀璨金针 `#ffe033` 核心必读** / **标准银针 `#cbd5e1` 常规实录** / **暗古铜针 `#7c4329` 历史归档**)→ **分条记忆点** → **点击逐条展开小点记忆**。
81
- - **三级懒加载 · 默认 0 Token 空耗**:`Stage-0` 快照仅传输 `< 80B` 计数元信息,封存状态下对系统提示词保持 **100% 零注入**;只有当你主动点击「**取出备查**」或模型点名调用 `archive.search` 时才精准调取,用完点「**放回封存**」立即归零。
82
- - **参谋长无损整理**:支持一键「请参谋长整理收纳 / 重拆此卷」,自动提炼结构化记忆点并 **100% 无损保留原始 Markdown 正文**。
96
+ ### 03 · 三层 0-Token 档案金库与双向差分(`档案` 页签)
97
+ - **三库严格隔离**:顶部一键切换 **💬 本会话档案柜**(1:1 隔离)、**🌐 全局档案柜**(系统冷库不跟会话)与 **🏛️ 沉淀档案柜**(跨会话双盲冷封存)。
98
+ - **四层曲别针收纳**:**多档案柜 → 抽屉 → 金/银/暗铜曲别针卷宗 → 分条记忆点 → 小点记忆**。
99
+ - **摆上桌面与双向差分**:全局与本地实时标记「已同步全局 / 本地已改 / 仅本地」;点击「`📌 摆上桌面`」才向主对话与参谋强调,并支持复选多卷「组合递话」。
83
100
 
84
101
  <div align="center">
85
- <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 四层冷存储工程档案柜与金银暗铜曲别针" width="68%" />
102
+ <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层 0-Token 档案金库与双向差分" width="68%" />
86
103
  </div>
87
104
 
88
105
  ---
89
106
 
90
- ### 04 · 双层 `/goal` 长期目标与可追问小任务板(`规划` 页签)
91
- 上方独立承载 `/goal` 长期督导总纲,下方实时同步细粒度执行步骤。对模型写下的某一步技术操作有疑问?**直接左键/右键点击该步骤**,即可呼出交互菜单:一键询问主代理「**这条是什么意思 / 为什么有这步**」,或让 **DSH 参谋长当场白话解读(不打断主对话当前推理流)**。
107
+ ### 04 · 目标督导、步骤白话追问与结项门禁(`规划` 页签上方)
108
+ - **核心目标锁定**:点击「`🎯 设为目标`」开启持久目标督导;开启强介入时自动锁定核心目标为唯一终局。
109
+ - **点击任意步骤追问**:小任务板每一行都支持菜单弹窗——当场让参谋长白话解读「为什么有这步」,绝不打断主对话。
92
110
 
93
111
  <div align="center">
94
- <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 双层 Goal 目标与步骤点击追问解读" width="68%" />
112
+ <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 核心目标督导与步骤追问解读" width="68%" />
95
113
  </div>
96
114
 
97
115
  ---
98
116
 
99
- ### 05 · 跨窗口独立会话串联与三态信使网络(`协同` 页签)
100
- 打破单窗口孤岛:一键拨动开关即可将多个独立 DSH 主窗口(例如「前端交互窗口」与「后端压测窗口」)接入同一协同集群,共享统一通讯录与协同信箱,随时发起 `插话`、`递话`、`备忘` 或一键打开子代理右侧分屏。
117
+ ### 05 · 跨窗口独立会话串联与彩色抽屉信箱(`协同` 页签)
118
+ - **跨窗协同集群**:一键串联多个独立 DSH 主窗口互享实时进度;断开链接立即净化外部记忆与缓存防串味。
119
+ - **彩色抽屉信箱**:按全网广播(`@all` 自动去重)、多方协作与各窗口会话内部信箱分色归档。
120
+ - **原图防幻觉机制**:输入栏粘贴/上传的截图原图落盘至 `<cwd>/.dsh-chief/uploads/`,纯文本参谋自动携带绝对路径降级交由主对话查看。
101
121
 
102
122
  <div align="center">
103
123
  <img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口独立会话串联与协同网络" width="68%" />
@@ -105,54 +125,72 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
105
125
 
106
126
  ---
107
127
 
108
- ### 06 · `📌` 图钉全局红线盖章与智能浓缩(`边界` 页签 · 红线边界)
109
- - **双层作用域精准隔离**:点击规则左侧的 **`📌` 小图钉** 即可将其升格为跨所有任务生效的「**全局共享铁律**」;未钉住的规则仅在当前会话树生效,绝不污染其他无关项目。
110
- - **撞墙请示与一键浓缩**:子代理实战踩坑后可通过 `bounds.propose` 提交新边界草案,由你在面板上一键选择「`📌 定住全局` / `仅本任务` / `微调` / `驳回`」;零散规则过多时还可勾选并点击「**✨ 零散总结成一条**」交由参谋长精炼合并。
128
+ ### 06 · `📌` 图钉全局红线盖章与浓缩(`边界` 页签)
129
+ - **双作用域严格区分**:点亮左侧 **`📌` 小图钉** 升格为跨所有任务生效的「全局共享铁律」;未钉住规则仅限当前会话有效。
130
+ - **必做清单与撞墙呈批**:支持「必做事项 (`allowed`)」「禁止红线 (`forbidden`)」「注意事项 (`notes`)」,支持子代理撞墙呈批与一键浓缩合并多条旧规则。
111
131
 
112
132
  <div align="center">
113
- <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 图钉全局红线与参谋长边界请示盖章" width="68%" />
133
+ <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 图钉全局红线与参谋长边界请示" width="68%" />
114
134
  </div>
115
135
 
116
136
  ---
117
137
 
118
- ### 07 · 一键自包含会话交接与空转守护(`边界` 页签 · 会话交接 & 守护)
119
- 长对话上下文逼近上限时,点击「**新建会话并交接**」即可将当前目标、父子任务树、当前游标、阻塞卡点与有效红线打包为一份**自包含 Markdown 交接单**,自动创建新对话并将前端视口无缝切换过去继续接力;内置 `idle-guard` 空转完结守护,防止模型在任务未闭环时提前停机交差。
138
+ ### 07 · 跨会话接力、📌 定住防改与一键部署参谋(`规划` 页签底部)
139
+ - **可手改与 `📌 定住防改`**:交接单支持手工微调;点亮 **`📌 定住防改`** 自动冻结 `[自动渲染]` 快照并锁死「同步交接单」,防止参谋后续摘要误覆盖。
140
+ - **4 档档案跟随策略**:新建或接力至已有会话时,自由选择「不带工作档案 / 仅挂桌面备查 / 带整个抽屉 / 全柜工作档案」,沉淀冷库保持绝对隔离。
141
+ - **一键携参谋上任**:无缝继承参谋长专职模型与纪律配置(强介入默认安全置关),搭配 `idle-guard` 防任务半途空转停机。
120
142
 
121
143
  <div align="center">
122
- <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 自包含一键会话交接与空转守护" width="68%" />
144
+ <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话接力与定住防改交接单" width="68%" />
123
145
  </div>
124
146
 
125
147
  ---
126
148
 
149
+ ## ⚠️ 使用须知与两条硬核免责声明
150
+
151
+ > [!IMPORTANT]
152
+ > 启用「✦ 许愿框实权执行」「⚡ 主动强介入」「✦ 智选压缩」前,请务必牢记以下两条客观规律:
153
+ >
154
+ > 1. **能力下限靠本插件工程护栏兜底,能力上限完全取决于底层大模型**
155
+ > - 本插件通过 0-Token 冷隔离、四档权限门禁、先落盘复核再压缩、轮数熔断与 `⏹ 急停` 守住安全下限。
156
+ > - 但多步工具规划、复杂代码洞察、强介入纠偏与重点提炼的上限,**完全看你为参谋长搭配的模型智商**。
157
+ > - 重度工程强烈建议给参谋长选配推理过硬的主力旗舰模型,勿对超轻量小模型抱有超出其推理上限的期待。
158
+ > 2. **切忌同时挂载过多“破坏对话模型脑子”的外部注入**
159
+ > - 请勿在主对话或项目里叠加上百行互殴的全局 System Prompt / Rules,或会每轮硬塞几千字旧账的传统常驻记忆插件。
160
+ > - **过多冗余注入会把模型的“脑子”搅浑、稀释当下注意力**,还极易与参谋长强介入指令冲突,引发死循环或提前熔断。
161
+ > - 保持外部提示词干净克制,低频资料交由本插件 **0-Token 冷库** 按需取出,才能发挥最大战力。
162
+
163
+ ---
164
+
127
165
  ## 🏗️ 冷热记忆分舱与多代理协同架构
128
166
 
129
167
  ```mermaid
130
168
  flowchart TB
131
169
  subgraph UI["DSH 右侧常驻参谋舱 (client.js)"]
132
- T1["参谋台 (三档人类控速)"]
170
+ T1["参谋台 (许愿框 + 驾驶舱 + 急停)"]
133
171
  T2["全铺开金字塔任务图"]
134
172
  T3["跨窗与子代理协同网"]
135
- T4["/goal + 可追问步骤板"]
136
- T5["四层冷存储工程档案柜"]
137
- T6["📌 全局红线 & 一键交接"]
173
+ T4["目标督导 + 交接单定住 + 部署参谋"]
174
+ T5["三层 0-Token 档案金库 + 双向差分"]
175
+ T6["📌 全局红线 & 守护偏好"]
138
176
  end
139
177
 
140
178
  subgraph Core["宿主协调与存储内核 (Zero External Deps)"]
141
- Hot["热工作板 & 精炼热摘要 (< 1.5KB)\nboard.json / boards/session-*.json"]
142
- Cold["四层懒加载冷档案库 (平时 0B 注入)\narchives.json (金/银/暗铜曲别针)"]
143
- Bus["三态跨会话信使 & 参谋状态机\nchief-state.json + idle-guard.js"]
179
+ Hot["热工作板 & 精炼热摘要\nboard.json / boards/session-*.json"]
180
+ Cold["本会话档案柜 + 系统全局冷库 + 沉淀冷库\ncabinets/ + global-vault/ + precipitated/vault-global.json"]
181
+ Bus["4 档实权执行器、信使与原图落盘\nchief-executor.js + auto-continue.js + idle-guard.js"]
144
182
  end
145
183
 
146
184
  subgraph Agents["多智能体执行集群"]
147
185
  Lead["当前主代理 (Root Coordinator)"]
148
186
  Subs["子代理纵队 (@arch / @dev / @bench)"]
149
- Peers["已串联的跨窗口主会话"]
187
+ Peers["已串联与一键部署的跨窗口会话"]
150
188
  end
151
189
 
152
- UI <-->|"同源环回守卫 API (/api/dsh-chief/*)"| Core
190
+ UI <-->|"25 条同源环回守卫 API (/api/dsh-chief/*)"| Core
153
191
  Hot -->|"紧凑态势注入"| Lead
154
192
  Hot -->|"紧凑态势注入"| Subs
155
- Cold -.->|"仅「取出备查」或点名检索时按需调取"| Lead
193
+ Cold -.->|"三层冷库 0 Token 隔离\n仅「📌 摆上桌面」或取出时注入"| Lead
156
194
  Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
157
195
  ```
158
196
 
@@ -160,55 +198,52 @@ flowchart TB
160
198
 
161
199
  ## ⚡ 快速安装(零外部依赖)
162
200
 
163
- ### 方式一:通过 DSH 插件市场或 CLI 一键安装(推荐)
164
-
165
- 在已安装 [dshmarket](https://github.com/dsh-market/dsh-market) 或官方「发现」页中搜索 **`dsh-chief`**(或 **DSH 参谋长**)一键安装;或直接使用命令行安装:
201
+ 在 DSH 已安装 [dshmarket](https://github.com/dsh-market/dsh-market) 后可直接搜索 **`dsh-chief`**(或 **`DSH 参谋长`**)点击安装,也可使用 CLI 一键装入(`web` 环境把 `desktop` 改为 `web`):
166
202
 
167
203
  ```bash
168
- # 直接从 GitHub Release 预构建包极速安装(约 240 KB,零编译步骤)
169
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.0.0/dsh-chief-1.0.0.tgz
204
+ # 方式 1:通过 npm 官方源安装(国内自动走镜像加速,支持后续检测升级)
205
+ dsh plugin --profile desktop add dsh-chief
206
+
207
+ # 方式 2:直接安装 v1.2.0 GitHub Release 预构建包
208
+ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.2.0/dsh-chief-1.2.0.tgz
170
209
 
171
- # 或通过 GitHub 仓库标识安装(若使用 web profile,将 desktop 替换为 web)
210
+ # 方式 3:通过 GitHub 仓库源码直接安装
172
211
  dsh plugin --profile desktop add github:gluztm/dsh-chief
173
212
  ```
174
213
 
175
- 安装完成后刷新 DSH Web 页面,点击工作区右侧边栏顶部的 **✦ `DSH 参谋长`** 图标即可展开面板。
214
+ 安装后刷新 DSH 界面(或重启客户端),点击工作区右上侧栏 **✦ `DSH 参谋长`** 图标即可展开指挥舱。
176
215
 
177
- ### 方式二:源码克隆与本地联接调试(适合二次开发)
178
-
179
- ```bash
180
- git clone https://github.com/gluztm/dsh-chief.git
181
- ```
216
+ ### 宿主版本兼容性矩阵
182
217
 
183
- 本插件采用**零外部运行时依赖(Zero Runtime Dependencies)**纯原生 ES Module 架构,无需 `npm build` 即可直接挂载调试。
218
+ | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层冷库 / 许愿框 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
219
+ | :--- | :---: | :---: | :--- |
220
+ | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 原生提供 `subagents.resolveName` / `rootOf` / `namesOf` |
221
+ | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 提示升级 | 旧版子代理 API;面板自动给出升级引导并拦截风险调用 |
184
222
 
185
223
  ---
186
224
 
187
225
  ## 🛠️ 模型工具矩阵(4 Tools)
188
226
 
189
- 装入后自动向模型暴露 4 个结构化协同工具(动作层均做类型宽容解析,兼容原生 JSON 数组与扁平文本传参):
227
+ 装入后向模型注册 4 个结构化工具(动作层兼容原生 JSON 数组与宽容文本传参):
190
228
 
191
229
  | 工具名 | 核心职责 | 典型高频动作 (`action`) |
192
230
  | :--- | :--- | :--- |
193
- | **`chief_board`** | 驱动任务拓扑、规划步骤、冷档案检索与跨代理信箱 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`archive.save`、`archive.search`、`bounds.propose` |
194
- | **`chief_memory`** | 读写会话级高密度热记忆条目(决策/进展/验证/风险) | `list`、`get`、`add`、`update`、`remove` |
195
- | **`chief_boundaries`** | 读取与维护全局图钉红线(`📌`)及当前任务工作边界 | `get`、`set`、`add`、`pin`、`remove` |
196
- | **`chief_handoff`** | 导出当前多代理全局态势与自包含 Markdown 交接单 | `preview` / 直接生成新会话接力包 |
231
+ | **`chief_board`** | 驱动任务图、小任务板、冷档案检索、跨代理信箱与协同压缩 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`archive.save`、`archive.search`、`bounds.propose`、`context.compact` |
232
+ | **`chief_memory`** | 读写会话级高密度热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
233
+ | **`chief_boundaries`** | 维护图钉全局红线(`📌`)、必做事项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
234
+ | **`chief_handoff`** | 预览与生成自包含跨会话 Markdown 交接单 | `preview` / 新会话接力包 |
197
235
 
198
236
  ---
199
237
 
200
- ## 📊 实测工程指标与纯本地安全承诺
238
+ ## 🛡️ 工程指标与纯本地安全
201
239
 
202
- - **高并发写锁防撕裂**:`board.json` 与 `archives.json` 均受基于 `wx` 原子排他文件锁 + 陈旧锁自动剥离机制保护;实测 **80 路并发混合写锁争用 + 60 轮高频 UI 页签切页压测** **0 丢单、0 JSON 损坏、0 残留锁**。
203
- - **冷库零泄漏与亚毫秒响应**:实测挂载 **500 卷(4.0 MB)** 工程档案压测下,`Stage-0` 快照元信息仅 **`75 Bytes`(耗时 `0.10ms`)**,全文检索 **`< 4ms`**,未取出卷宗对模型提示词 **0 字符泄漏**。
204
- - **严格同源环回与防泄密门禁**:
205
- - 所有 `/api/dsh-chief/*` 接口均强制执行 **Loopback 环回地址 + 同源 `Origin/Host` 双重校验**,拒绝任何跨站诱导调用。
206
- - 内置敏感凭据正则硬拦截器,自动拒绝将 `sk-*`、`ghp_*`、Bearer Token 或 OpenSSH 私钥写入工作板、参谋记忆或冷档案库。
207
- - **100% 纯本地存储**:所有数据仅保存在本机 `~/.dsh/chief/` 目录下,零遥测、零第三方云上报。
240
+ - **原子写锁零丢失**:`board.json` 与三库档案文件均受基于 `wx` 排他文件锁 + 陈旧锁自动回收保护,并发写锁零损坏。
241
+ - **三层冷库零泄漏**:冷封存卷宗平时 **0 字节**注入主对话,仅在显式「摆上桌面」或「取出」时按需加载。
242
+ - **25 条同源环回守卫**:全部 `/api/dsh-chief/*` 接口强制验证 Loopback 地址与同源 `Origin/Host`,防跨站诱导。
243
+ - **敏感凭据正则硬拦截**:自动拒存 `sk-*`、`ghp_*`、Bearer Token 与 OpenSSH 私钥,所有数据 100% 存放在本机 `~/.dsh/chief/`,零遥测、零云端上报。
208
244
 
209
245
  ---
210
246
 
211
247
  ## 📄 开源许可 (License)
212
248
 
213
- 本项目基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。
214
- 在遵循相同开源协议并保留版权与修改声明的前提下,欢迎自由使用、审计、分支改进与提交社区 PR!
249
+ 基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。欢迎使用、审计与提交 PR!