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/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
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)** 原生子代理分屏、面板原生「🎯 目标督导 + 人工拍板结项」、实时 `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. **原生「🎯 目标督导」与人工拍板结项(Goal Approval Gate)**:在「规划」页点击「`🎯 设为目标`」即可开启持续目标督导(不再依赖聊天 `/goal` 指令),变更目标时智能提示重置陈旧步骤;目标达成后由参谋长提交实证请示,**必须经过人类点击「`✅ 批准结项`」才会退出目标模式**,未获批准前随时支持驳回继续推进。
34
- 4. **输入栏 `+` 战术驾驶舱与防死循环熔断**:点击输入栏左侧 **`+`** 打开战术驾驶舱,按需组合「`⚡ 主动强介入`(需前置边界与风险弹窗确认 + 红色 `⏹ 急停` + 最大轮数与 3 轮无进展自动熔断)」「`🗜 压缩前抢救 + 自动压缩阈值`」「`✓ 严格实证核验`」「`🛡 红线越界哨兵`」与「`📝 极简战报`」。
35
- 5. **跨会话一键部署参谋 + 工作区原图落盘防幻觉**:在「规划」页底部可按四档策略同步工作档案(**跨会话沉淀冷库绝不跟随复制**),新建独立窗口后自动部署参谋长(继承专职模型与纪律,`intervention` 默认安全置关);附图上传直接落盘至当前项目 `.dsh-chief/uploads/` 并注入真实文件路径,即便配置纯文本参谋模型也能优雅降级协同。
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 自动调用**、`👁 巡检`、`🤖 托管`)+ 输入栏 **`+` 战术驾驶舱**(主动强介入 + 轮数熔断 + `⏹ 急停` / 严格核验 / 红线哨兵 / 自动压缩前抢救) |
52
- | **多代理拓扑可视性** | 扁平列表或狭窄视口,频繁横向/纵向拖动 | **全铺开金字塔 DAG 指挥图**:主代理居中统帅、子代理分列纵队,状态切换/解释/派发/分屏看流全部原地铺开 |
53
- | **长期工程记忆与沉淀冷库** | 常驻塞入提示词(费 Token)或易随对话压缩丢失 | **项目多档案柜 + 四层档案 + 跨会话沉淀冷库**:`抽屉 → 金/银/暗铜曲别针卷宗 → 记忆点 → 小点记忆`;支持「`📥 抢救细节`」防压缩失忆与「`⏬ 沉淀`」封入冷库(**全会话 0 Token 物理隔离**,点「`📂 翻出`」才注入) |
54
- | **规划可读性与目标拍板** | 冰冷的技术步骤列表,目标完成与否模型自说自话 | **核心目标督导 + 人工拍板结项 + 可追问小任务板**:点击任意步骤即可一键白话解读;目标达标后必须等待人类「`✅ 批准结项`」或「`↩ 驳回继续`」 |
55
- | **跨会话协同与原图协同** | 仅限单会话,换窗失忆;纯文本参谋遇图片直接报错 | **跨窗口独立会话串联 + 一键接力部署参谋(4 档档案策略)** + **工作区 `.dsh-chief/uploads/` 原图持久化**(纯文本参谋自动降级并带路径铁律转发) |
56
- | **红线治理与空转守护** | 规则混在聊天记录里,换会话靠人工复制粘贴 | **`📌` 图钉全局红线盖章**(跨任务永久生效 vs 仅本任务生效)+ **子代理边界请示与浓缩** + **`idle-guard` 空转完结守护** |
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 · 多档案柜、抢救细节与 0-Token 沉淀冷库(`档案` 页签)
79
- 按当前工作区路径自动隔离项目档案室,支持创建与切换多个工程档案柜,彻底解决「长记忆烧光上下文」与「压缩突然失忆」两大顽疾:
80
- - **四层收纳结构**:**多档案柜 → 分类抽屉**(拉开抽屉)→ **三色曲别针卷宗**(**璀璨金针 `#ffe033` 核心必读** / **标准银针 `#cbd5e1` 常规实录** / **暗古铜针 `#7c4329` 历史归档**)→ **分条记忆点** → **点击逐条展开小点记忆**。
81
- - **📥 压缩前抢救与 ⏬ 沉淀冷库(0 Token 物理隔离)**:支持手动或达到上下文阈值时自动执行「`📥 抢救细节`」提取文件路径、命令与关键结论落盘核验;通过「`⏬ 沉淀可复用经验`」将通用踩坑提炼进跨会话沉淀冷库。**沉淀冷库全会话默认 0 字节、0 磁盘读取隔离**,仅点击「`📂 翻出注入本会话`」才临时进入参谋视野,点击「`🔒 封回冷库`」即刻归零。
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 · 目标督导、人工拍板结项与跨会话一键部署参谋(`规划` 页签)
91
- 上方承载**核心目标与 `🎯 目标督导` 开关**,目标变更时智能提示是否清空陈旧步骤;目标达成后保持督导态等待您亲自拍板「`✅ 批准结项`」或「`↩ 驳回继续`」。中部小任务板点击任意步骤可一键追问白话解读;底部集成**「🚀 跨会话接力 & 一键部署参谋」**,新建窗口或投递给已有会话时可选四档工作档案迁移策略(冷库保持绝对隔离),并无缝部署继承参谋长专职模型与纪律配置。
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 - 核心目标督导、审批结项与跨会话一键部署参谋" 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 主窗口(例如「前端交互窗口」与「后端压测窗口」)接入同一协同集群;输入框支持拖拽或粘贴截图(**原图直接落盘至工作区 `.dsh-chief/uploads/`**,纯文本参谋模型自动降级并附真实路径交由多模态主对话执行);左侧 **`+` 战术驾驶舱**集中管控强介入、自动压缩前抢救、严格实证核验、红线哨兵与红色 **`⏹ 急停`**。
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,34 +125,40 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
105
125
 
106
126
  ---
107
127
 
108
- ### 06 · `📌` 图钉全局红线盖章与守护偏好(`边界` 页签)
109
- - **双层作用域精准隔离**:点击规则左侧的 **`📌` 小图钉** 即可将其升格为跨所有任务生效的「**全局共享铁律**」;未钉住的规则仅在当前会话树生效,绝不污染其他无关项目。
110
- - **撞墙请示、智能浓缩与守护偏好**:「红线边界」支持 `bounds.propose` 一键定住全局、浓缩精简;「守护偏好」专注管理每轮注入开关、`idle-guard` 空转提醒阈值与短回复检测线。
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
 
127
- ## ⚠️ 使用须知与免责声明
149
+ ## ⚠️ 使用须知与两条硬核免责声明
128
150
 
129
151
  > [!IMPORTANT]
130
- > 请在使用「`+` 战术驾驶舱」「`⚡ 主动强介入`」「自动压缩前抢救」等自主干预特性前务必知悉以下两点:
131
- >
132
- > 1. **底层大模型能力与上下文质量依赖**:参谋长的一切自动审查、强介入驱动、压缩前抢救与红线拦截能力均高度依赖您为参谋长配置的底层大模型能力与上下文质量,不同模型在规划严谨度与遵循指令上的表现存在客观差异。
133
- > 2. **宿主系统提示词与 Rules 指令冲突风险**:若主会话或当前项目中挂载了过多的系统提示词(System Prompt)、Rules 或硬性规则,可能与本插件的自主干预逻辑产生指令冲突,进而导致介入循环异常、提前熔断或执行偏离预期。
152
+ > 启用「✦ 许愿框实权执行」「⚡ 主动强介入」「✦ 智选压缩」前,请务必牢记以下两条客观规律:
134
153
  >
135
- > 建议在启用「主动强介入」前明确填写「核心目标」与至少一条「禁止红线」,必要时随时点击输入栏上方的红色 **「⏹ 急停」** 按钮中断后台自驱。
154
+ > 1. **能力下限靠本插件工程护栏兜底,能力上限完全取决于底层大模型**
155
+ > - 本插件通过 0-Token 冷隔离、四档权限门禁、先落盘复核再压缩、轮数熔断与 `⏹ 急停` 守住安全下限。
156
+ > - 但多步工具规划、复杂代码洞察、强介入纠偏与重点提炼的上限,**完全看你为参谋长搭配的模型智商**。
157
+ > - 重度工程强烈建议给参谋长选配推理过硬的主力旗舰模型,勿对超轻量小模型抱有超出其推理上限的期待。
158
+ > 2. **切忌同时挂载过多“破坏对话模型脑子”的外部注入**
159
+ > - 请勿在主对话或项目里叠加上百行互殴的全局 System Prompt / Rules,或会每轮硬塞几千字旧账的传统常驻记忆插件。
160
+ > - **过多冗余注入会把模型的“脑子”搅浑、稀释当下注意力**,还极易与参谋长强介入指令冲突,引发死循环或提前熔断。
161
+ > - 保持外部提示词干净克制,低频资料交由本插件 **0-Token 冷库** 按需取出,才能发挥最大战力。
136
162
 
137
163
  ---
138
164
 
@@ -141,18 +167,18 @@ DeepSeek 官方开源的 **[`dsh-superagent-prototype`](https://github.com/deeps
141
167
  ```mermaid
142
168
  flowchart TB
143
169
  subgraph UI["DSH 右侧常驻参谋舱 (client.js)"]
144
- T1["参谋台 (+ 战术驾驶舱 & 急停)"]
170
+ T1["参谋台 (许愿框 + 驾驶舱 + 急停)"]
145
171
  T2["全铺开金字塔任务图"]
146
172
  T3["跨窗与子代理协同网"]
147
- T4["目标督导 + 人工结项 + 一键部署参谋"]
148
- T5["多档案柜 + 抢救 + 0-Token 沉淀冷库"]
173
+ T4["目标督导 + 交接单定住 + 部署参谋"]
174
+ T5["三层 0-Token 档案金库 + 双向差分"]
149
175
  T6["📌 全局红线 & 守护偏好"]
150
176
  end
151
177
 
152
178
  subgraph Core["宿主协调与存储内核 (Zero External Deps)"]
153
179
  Hot["热工作板 & 精炼热摘要\nboard.json / boards/session-*.json"]
154
- Cold["多档案柜工作档案 + 跨会话沉淀冷库\ncabinets/ + precipitated/<projectKey>.json"]
155
- Bus["三态跨会话信使、熔断护栏 & 上传原图\nchief-state.json + idle-guard.js + .dsh-chief/uploads/"]
180
+ Cold["本会话档案柜 + 系统全局冷库 + 沉淀冷库\ncabinets/ + global-vault/ + precipitated/vault-global.json"]
181
+ Bus["4 档实权执行器、信使与原图落盘\nchief-executor.js + auto-continue.js + idle-guard.js"]
156
182
  end
157
183
 
158
184
  subgraph Agents["多智能体执行集群"]
@@ -161,10 +187,10 @@ flowchart TB
161
187
  Peers["已串联与一键部署的跨窗口会话"]
162
188
  end
163
189
 
164
- UI <-->|"同源环回守卫 API (/api/dsh-chief/*)"| Core
190
+ UI <-->|"25 条同源环回守卫 API (/api/dsh-chief/*)"| Core
165
191
  Hot -->|"紧凑态势注入"| Lead
166
192
  Hot -->|"紧凑态势注入"| Subs
167
- Cold -.->|"沉淀冷库 0 Token 隔离\n仅「翻出」或「取出备查」时注入"| Lead
193
+ Cold -.->|"三层冷库 0 Token 隔离\n仅「📌 摆上桌面」或取出时注入"| Lead
168
194
  Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
169
195
  ```
170
196
 
@@ -172,62 +198,52 @@ flowchart TB
172
198
 
173
199
  ## ⚡ 快速安装(零外部依赖)
174
200
 
175
- ### 方式一:通过 DSH 插件市场或 CLI 一键安装(推荐)
176
-
177
- 在已安装 [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`):
178
202
 
179
203
  ```bash
180
- # 直接从 GitHub Release 预构建包极速安装(约 240 KB,零编译步骤)
181
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.1.0/dsh-chief-1.1.0.tgz
204
+ # 方式 1:通过 npm 官方源安装(国内自动走镜像加速,支持后续检测升级)
205
+ dsh plugin --profile desktop add dsh-chief
182
206
 
183
- # 或通过 GitHub 仓库标识安装(若使用 web profile,将 desktop 替换为 web)
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
209
+
210
+ # 方式 3:通过 GitHub 仓库源码直接安装
184
211
  dsh plugin --profile desktop add github:gluztm/dsh-chief
185
212
  ```
186
213
 
187
- 安装完成后刷新 DSH Web 页面,点击工作区右侧边栏顶部的 **✦ `DSH 参谋长`** 图标即可展开面板。
214
+ 安装后刷新 DSH 界面(或重启客户端),点击工作区右上侧栏 **✦ `DSH 参谋长`** 图标即可展开指挥舱。
188
215
 
189
216
  ### 宿主版本兼容性矩阵
190
217
 
191
- | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 档案柜 / 边界 | 命名子代理树 (`task.dispatch` / `team.steer` / `team.interrupt`) | 说明 |
218
+ | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层冷库 / 许愿框 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
192
219
  | :--- | :---: | :---: | :--- |
193
- | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 完整提供 `subagents.resolveName` / `rootOf` / `namesOf` 与扁平 `startActivation` |
194
- | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 不可用(提示升级) | 旧版重构前子代理接口;插件启动与面板会给出升级提示并安全拦截 `team.*` 调用 |
195
-
196
- ### 方式二:源码克隆与本地联接调试(适合二次开发)
197
-
198
- ```bash
199
- git clone https://github.com/gluztm/dsh-chief.git
200
- ```
201
-
202
- 本插件采用**零外部运行时依赖(Zero Runtime Dependencies)**纯原生 ES Module 架构,无需 `npm build` 即可直接挂载调试。
220
+ | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 原生提供 `subagents.resolveName` / `rootOf` / `namesOf` |
221
+ | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 提示升级 | 旧版子代理 API;面板自动给出升级引导并拦截风险调用 |
203
222
 
204
223
  ---
205
224
 
206
225
  ## 🛠️ 模型工具矩阵(4 Tools)
207
226
 
208
- 装入后自动向模型暴露 4 个结构化协同工具(动作层均做类型宽容解析,兼容原生 JSON 数组与扁平文本传参):
227
+ 装入后向模型注册 4 个结构化工具(动作层兼容原生 JSON 数组与宽容文本传参):
209
228
 
210
229
  | 工具名 | 核心职责 | 典型高频动作 (`action`) |
211
230
  | :--- | :--- | :--- |
212
- | **`chief_board`** | 驱动任务拓扑、规划步骤、冷档案检索与跨代理信箱 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`archive.save`、`archive.search`、`bounds.propose` |
213
- | **`chief_memory`** | 读写会话级高密度热记忆条目(决策/进展/验证/风险) | `list`、`get`、`add`、`update`、`remove` |
214
- | **`chief_boundaries`** | 读取与维护全局图钉红线(`📌`)及当前任务工作边界 | `get`、`set`、`add`、`pin`、`remove` |
215
- | **`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` / 新会话接力包 |
216
235
 
217
236
  ---
218
237
 
219
- ## 📊 实测工程指标与纯本地安全承诺
238
+ ## 🛡️ 工程指标与纯本地安全
220
239
 
221
- - **高并发写锁防撕裂**:`board.json` 与 `archives.json` 均受基于 `wx` 原子排他文件锁 + 陈旧锁自动剥离机制保护;实测 **80 路并发混合写锁争用 + 60 轮高频 UI 页签切页压测** **0 丢单、0 JSON 损坏、0 残留锁**。
222
- - **冷库零泄漏与亚毫秒响应**:实测挂载 **500 卷(4.0 MB)** 工程档案压测下,`Stage-0` 快照元信息仅 **`75 Bytes`(耗时 `0.10ms`)**,全文检索 **`< 4ms`**,未取出卷宗对模型提示词 **0 字符泄漏**。
223
- - **严格同源环回与防泄密门禁**:
224
- - 所有 `/api/dsh-chief/*` 接口均强制执行 **Loopback 环回地址 + 同源 `Origin/Host` 双重校验**,拒绝任何跨站诱导调用。
225
- - 内置敏感凭据正则硬拦截器,自动拒绝将 `sk-*`、`ghp_*`、Bearer Token 或 OpenSSH 私钥写入工作板、参谋记忆或冷档案库。
226
- - **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/`,零遥测、零云端上报。
227
244
 
228
245
  ---
229
246
 
230
247
  ## 📄 开源许可 (License)
231
248
 
232
- 本项目基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。
233
- 在遵循相同开源协议并保留版权与修改声明的前提下,欢迎自由使用、审计、分支改进与提交社区 PR!
249
+ 基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。欢迎使用、审计与提交 PR!