dsh-chief 1.3.0 → 1.5.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,264 +1,273 @@
1
1
  <div align="center">
2
2
 
3
- **AI 管 AI,你当甩手掌柜 —— 你不在的时候,它也替你盯着。**
4
- <sub>它自己派活、自己盯子代理、自己收口;跑偏了先熔断,不用你守着屏幕。</sub>
3
+ **给 DeepSeek Harness(DSH)用的右侧栏任务看护、认知桌面、事前物理驻墙与多代理管控面板**
4
+ <sub>长对话 `/compact` 前先存参数再压缩,子代理金字塔一屏看完,改文件跑命令前先过物理墙与逐项审批。</sub>
5
5
 
6
- <img src="assets/chief-10s-compare.gif" alt="10 秒看懂 dsh-chief:左边是原生长会话——循环重读、压缩丢参数、跨窗失忆;右边是参谋长——一键熔断、参数先入柜、归档随取。默认只读起手" width="800" />
6
+ <img src="assets/chief-10s-compare.gif" alt="对比原生长会话与挂载 dsh-chief 后的效果:左边循环重读、压缩丢参数、跨窗失忆;右边先入柜再压缩、可随时熔断、带交接单换窗继续" width="800" />
7
7
 
8
- <sub>默认只读起手 · 越权改工作区会先问你 · `dsh plugin --profile web add dsh-chief`</sub>
8
+ <sub>默认只读起手 · 越权操作前先确认 · `dsh plugin --profile desktop add dsh-chief`</sub>
9
9
 
10
10
  <br />
11
11
 
12
- <img src="assets/hero-banner.png" alt="DSH 参谋长 (dsh-chief) v1.2.0 — 许愿式一站式多代理指挥与三层冷库中枢" width="100%" />
12
+ <img src="assets/v150-highlights.png" alt="dsh-chief v1.5.0 核心新特性实机一览:180° 扇形思考强度表盘、托管梦境漫游毛玻璃单击即穿透、认知桌面与俯视角一沓纸档案柜、事前物理驻墙硬拦截" width="100%" />
13
13
 
14
14
  <br />
15
15
 
16
- # ✦ DSH 参谋长 (`dsh-chief`)
17
- ### DeepSeek Harness 多智能体指挥舱 · ✦ 许愿框一站式办理 · 三层 0-Token 档案金库 · `✦ 智选压缩`
16
+ <img src="assets/hero-banner.png" alt="dsh-chief 面板主视图" width="100%" />
17
+
18
+ <br />
19
+
20
+ # DSH 参谋长 (`dsh-chief`)
21
+ ### DeepSeek Harness 右侧常驻多代理看护、0-Token 档案柜与安全审批面板
18
22
 
19
23
  [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.2--rc.2-38bdf8?style=flat-square)](https://dsh.deepseek.com)
24
+ [![GitHub Release](https://img.shields.io/github/v/release/gluztm/dsh-chief?color=2563eb&style=flat-square)](https://github.com/gluztm/dsh-chief/releases)
20
25
  [![npm version](https://img.shields.io/npm/v/dsh-chief?color=cb3837&style=flat-square)](https://www.npmjs.com/package/dsh-chief)
26
+ [![CI](https://github.com/gluztm/dsh-chief/actions/workflows/ci.yml/badge.svg)](https://github.com/gluztm/dsh-chief/actions/workflows/ci.yml)
21
27
  [![DSH Market](https://img.shields.io/badge/DSH%20Market-Listed-f59e0b?style=flat-square)](https://awesome-dsh-plugin.com/p/gluztm/dsh-chief/)
22
- [![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)
28
+ [![Bilibili Demo](https://img.shields.io/badge/Bilibili-%E5%AE%9E%E6%9C%BA%E6%95%99%E7%A8%8B-fb7299?style=flat-square)](https://www.bilibili.com/video/BV1DqsV6QEGi)
23
29
  [![SuperAgent Ready](https://img.shields.io/badge/SuperAgent-Router--Worker%20Synergy-a855f7?style=flat-square)](https://github.com/deepseek-ai/dsh-superagent-prototype)
24
30
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D%2022.13-30d158?style=flat-square)](https://nodejs.org)
25
31
  [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20External-ffe033?style=flat-square)](#)
26
32
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
27
33
 
28
- > **不盯着也不出事:向右侧「✦ 许愿框」许下意图,它自己把流程跑完,跑歪了先拦住(`v1.3.0`)**
29
- > 做法对齐 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」:把散装聊天窗收成一张常驻指挥台。
34
+ > **当前版本 `v1.5.0`**:新增**认知桌面(`2,400 Tokens / 6 份` 唯一全文注入)与三层织钩隔离 + 俯视角一沓纸档案柜**、**正交三态运行总控(`⏸ 关停 | 🛡 巡检 | 🤖 托管`)**与托管后台「🌙 **梦境漫游**」(支持**鼠标单击毛玻璃立即恢复操作,同时保留流光外框提示后台仍在运作**)、5 条件自动休眠与 `L3` 一站式战报、**`180°` 扇形思考强度表盘**与「团队思考强度:自动 / 手动」一键切换,以及「💡 咨询」、强介入先锁目标、请示拆墙审批与 DSH 浅色主题完整适配,已适配 DSH `0.2.2-rc.5`。
35
+ > 协同结构参考官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的 Router + Workers 分工模型,保持侧边栏状态与主对话上下文相互隔离。
30
36
 
31
- **简体中文** · [English (`README.en.md`)](README.en.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md)
37
+ **简体中文** · [English (`README.en.md`)](README.en.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md) · [架构设计 (`ARCHITECTURE.md`)](ARCHITECTURE.md)
38
+
39
+ [v1.5.0 亮点](#v150-重点升级一览) · [核心痛点](#主要解决哪些日常麻烦) · [界面实机](#界面与功能说明) · [模块架构](#模块结构与数据流-v150) · [安装与兼容](#安装与宿主版本兼容) · [安全边界](#本地存储与安全边界) · [贡献者](#贡献者)
32
40
 
33
41
  </div>
34
42
 
35
43
  ---
36
44
 
37
- ## 🔗 与 SuperAgent 及 DSH 原生能力深度联动
38
-
39
- - **模块化低耦合架构(`v1.3.0`)**:29 个后端与 16 个前端单一职责模块协同(无环依赖、零可变导出),搭配跨进程/多线程 `O_EXCL` 自旋锁与 `chief-audit.jsonl` 只追加审计账本,兼顾长期可维护性与高并发鲁棒性。
45
+ ## `v1.5.0` 重点升级一览
40
46
 
41
- - **常驻指挥中枢**:把主对话、子代理和跨窗独立会话收拢到同一张**全铺开金字塔拓扑图**,不再在十几个黑盒标签页间来回切换。
42
- - **原生分屏盯流 (`subagentchat`)**:任意子代理卡片点击「`分屏`」,直连 `sidebarRight.openResource` 拉开实时推理流。
43
- - **默认只读,先看后动 (`chief-executor`)**:新开与接力的会话都从只读起手 —— 先观察、先出方案;要改工作区、跑命令、调度子代理,得逐项拿到你的允许,敏感动作弹窗确认并留审计日志。
44
- - **空白新对话即开即用**:主对话尚未发送第一条消息时,自动定位当前工作区开工,或预埋待领包给即将开启的 `@lead`。
45
- - **目标锁死 + 人类拍板结项**:强介入锁定核心目标(支持 `0 = ♾️` 无限轮),达标后核验 `allowed` 必做清单并等待人类点击「`✅ 批准结项`」。
46
- - **✦ 智选压缩 + 灵活安全阈值**:支持 `✦ 智选压缩` 在阶段收口等主代理空闲后触发,也支持 `10%–95%` / `>= 8k` Token 阈值或直说「压缩吧」。
47
- - **跨隔离真 `/compact`**:自动跨过 Cordis 服务隔离调用官方 `/compact` 通道,先抢救工程细节入柜并复核落盘,再静默压缩留回执。
48
- - **三层 0-Token 档案金库**:💬 本会话柜(1:1 隔离)、🌐 系统全局冷库(双向差分)、🏛️ 沉淀冷库(默认双盲 0 字节),支持一键「`📌 摆上桌面`」与「`组合递话`」。
49
- - **跨窗协同与定住防改交接单**:入网前提示污染风险、断联立即净化防串味,支持手改与一键「`📌 定住防改`」冻结交接快照。
47
+ - **🗂️ 认知桌面(唯一全文注入源)与俯视角「一沓纸」档案柜**:彻底肃清非桌面卷宗全文泄露,唯有置顶在 **📌 认知桌面(上限 `2,400 Tokens / 6 份`)** 的规范才会随轮注入主对话;本局 / 全局 / 冷藏三层抽屉采用折叠纸页 + 关键词钩子(`🪝`),平时折叠省空间、按需织钩拉阅,未翻牌冷藏资料对 AI 保持 `0-byte` 双盲隔离。
48
+ - **🤖 顶栏正交三态与托管「🌙 梦境漫游」**:`⏸ 关停`(完全 0 消耗)/ `🛡 巡检`(平时 0 耗电,仅在撞墙/报错/断流唤醒续跑)/ `🤖 托管`(持续看护并在空闲时悄悄整理档案抽屉);点亮毛玻璃舞台后**鼠标单击遮罩任意处即可立即收起模糊恢复界面操作,同时保留四边流动彩色光线提示参谋长仍在后台运转**;忙完待办且满足 5 项清零条件后自动退回关停休眠。
49
+ - **🧠 `180°` 扇形思考强度表盘与团队调挡**:模型选择器与战术驾驶舱内置拖拽式 180° 彩虹扇形表盘(关 / 低 / 中 / 高 / 极高 + 点中心一键回「🪄 自动」),摘要与漫游自动降轻、排障与筑墙自动拉高;下方支持一键切换「团队思考强度(主/子代理):自动 / 手动」,并在回复卡右上角显示实调挡位。
50
+ - **🛡️ 严守边界与工程细节打磨**:开启「⚡ 主动强介入」必须先填并锁定核心总目标;新增「💡 咨询」模式有建议直说、管不了坦诚告知;物理墙真撞死仅在独立复核无绕过方案后才允许提交人类审批拆墙单;补齐 DSH 浅色主题实底弹层、窄栏自适应隐藏版本号及子代理窗口自动隐藏参谋入口。
50
51
 
51
52
  ---
52
53
 
53
- ## 💡 为什么需要「DSH 参谋长」?(6 大日常痛点 × 独家破局机制)
54
+ ## 主要解决哪些日常麻烦
54
55
 
55
- 普通待办只是多了一块手写备忘录,常驻记忆只是每轮往提示词里硬塞几千字旧账;**`dsh-chief` 把「人盯 AI 干活」反转为「许愿式一站式跑通」**。
56
+ 写代码和跑长会话时最常踩的几个坑,这个面板逐个给了工程上的硬兜底。
56
57
 
57
- ### 1. AI 半途偷懒交差(“改好了你自己测吧”)
58
- - **普通插件**:只有静态文字清单,模型自说自话就能宣布完成。
59
- - **`dsh-chief` 解法**:用「🎯 目标督导」+「⚡ 强介入(`0 = ♾️` 无限轮)」锁死终点,未核验 `allowed` 必做清单且未获你点击「`✅ 批准结项`」绝不放行。
60
- - **可控急停**:触发高危动作前先弹窗确认,随时点击红色 **「⏹ 急停」** 秒切人工接管。
58
+ ### 1. 上下文一压缩(`/compact`)就忘了前面查出来的路径和命令
59
+ - 常见状况:对话一长触发压缩,刚找到的配置路径、端口、报错行号和回滚命令全被摘要吃掉,模型回头重读文件、重新踩坑。
60
+ - `dsh-chief` 的做法:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也支持直接在右侧输入「压缩吧」。
61
+ - 压缩顺序固定为「先抢救细节并校验写入本会话档案柜 → 再静默调用宿主 `/compact`」。如果没产生历史消息或压缩报错,计数绝不虚增。
61
62
 
62
- ### 2. 上下文一压缩就“脑叶切除”式失忆
63
- - **普通插件**:压缩一触发,刚查出来的路径、命令和结论全被抹光。
64
- - **`dsh-chief` 解法**:支持「`✦ 智选压缩`」、`10%–95%` / `>= 8k` Token 阈值,以及一句「压缩吧」确定性办理。
65
- - **原子保底**:强制先抢救细节入本会话档案柜并核验落盘,再跨隔离静默 `/compact`;失败或免压绝不虚增计数。
63
+ ### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
64
+ - 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
65
+ - `dsh-chief` 的做法:必须先填并锁定核心目标,再开启 `⚡ 主动强介入`(`0 = ♾️` 无限轮自动续推,自带同报错 3 轮防死循环熔断);在 `🛡 巡检` / `🤖 托管` 下断流自动过墙唤醒续跑,`L3 + 强介入` 还可安全批量收口并产出「🏁 一站式战报」,未通过核验并经你 `✅ 批准结项` 绝不虚报完工。
66
+ - 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
66
67
 
67
- ### 3. 传统记忆插件把对话模型“脑子”搅浑、Token 越用越多
68
- - **普通插件**:每轮把几十篇过时笔记硬灌进 System Prompt,烧 Token 还干扰当下推理。
69
- - **`dsh-chief` 解法**:三层冷库平时 **0 字节 / 0 Token 物理隔离**,沉淀库默认双盲不可见。
70
- - **精准按需**:只有你点击「`📌 摆上桌面`」或「`📤 取出`」时才临时注入,点回封存即刻归零。
68
+ ### 3. 常驻记忆插件每轮塞几千字进提示词,烧 Token 还把模型带偏
69
+ - 常见状况:普通记忆插件每次发消息都把几十条过时笔记硬塞进 System Prompt,主模型被无关旧账带偏,费用还高。
70
+ - `dsh-chief` 的做法:把工程档案分放进 **本会话柜 / 全局柜 / 沉淀冷藏柜**,平时以「一沓纸」折叠收在抽屉里。**只有摆上置顶「📌 认知桌面(上限 `2,400 Tokens / 6 份`)」的卷宗才直接发给主对话**;其余资料只需织好 `🪝` 关键词钩子,AI 需要时自己按标签 `archive.pull` 拉阅,未翻牌冷藏金库对 AI 保持 `0` 字节隔离。
71
71
 
72
- ### 4. 只敢嘴上聊天的“吉祥物副驾”,一放权就裸奔
73
- - **普通插件**:要么只能看不能动,要么一放权就全盘裸奔,改坏了你的文件你也不知道。
74
- - **`dsh-chief` 解法**:默认只读,越权一项项问你 —— 你不管的时候它也不会乱来:
75
- - **新会话一律只读**:只观察、只分析、只给方案,不碰工作区,也不接管主/子工作流。
76
- - **动手前先申请**:改文件、跑命令、调度子代理这类操作,会弹 **「🛡️ 操作授权请求」**(做什么 / 对谁 / 为什么 / 影响),你点「允许本次操作」才执行。
77
- - **高危档位二次确认**:给更高自主权之前,要先读 **「⚠️ 高权限模式风险告知」** 并勾选,后端再校验一次。
78
- - **随时能收回**:红色 **「⏹ 急停」** 一按就切回人工接管,全程留下审计日志。
72
+ ### 4. 权限全放开怕误删误推,全锁死又只剩嘴上聊天
73
+ - 常见状况:次次确认太烦,给了完全权限又怕模型上头跑 `git push --force`、删目录或碰 `.env`;或者参谋长权限一高就爱自己抢着改代码,反而把主对话晾在一边。
74
+ - `dsh-chief` 的做法:底部四档权限(`L0` 只读顾问 · 默认 / `L1` 助手 / `L2` 参谋逐项授权 / `L3` 参谋长)与顶栏三态运行模式(`⏸ 关停 / 🛡 巡检 / 🤖 托管`)两根旋钮独立配合,外加事前物理防线。
75
+ - **新对话默认只读**:只看代码、出方案、记看板,不碰工作区文件,也不插话打断主对话。
76
+ - **工具落地前的事前物理驻墙**:主对话、子代理和参谋只要调用终端命令或读写文件,执行前都要先过宿主 `tools/pre-execute` 检查和你的「物理驻墙」。每堵墙都能切成 `🌐 全局`、`📁 本工程` 或 `⏸ 暂挂`,支持同类墙一键合并;不懂正则还能让参谋帮你手搓草案再点确认落锁。即使在 `L3` 最高权限下也**严禁 AI 私自拆墙**,真撞死仅能提交人类审批单。
77
+ - **参谋懒介入与顺口问**:哪怕开到高权限,没指定让参谋亲自操刀时,它也会先把干活请求派给主对话,不会冒充你在主框里发消息;刚开空白新窗口找参谋,它会先让主模型只读看代码、排计划再回来汇报;半途缺情报就后台悄悄问主对话一句,不打断主对话手头动作。
78
+ - **点完允许自动续跑 & 策略只紧不松**:通过 `TaskLedger` 记下未竟事务,逐项审批或提权通过后会接着往下跑完;内置硬红线(删盘、强推、`git reset --hard`、复合管道、内联 `node -e`/`python -c`、`".\\"env` 变形、NTFS ADS 流与 `-EncodedCommand`)在任何档位都直接拦下并写进 `~/.dsh/chief/chief-audit.jsonl`,也支持外挂只紧不松的 JSON 策略插件进一步限缩工具或目录。
79
79
 
80
- ### 5. 多子代理黑盒迷宫 & 口头红线聊十轮就忘
81
- - **普通插件**:窄视口列表反复拖拽,聊天里交代的红线随上下文滚出窗口。
82
- - **`dsh-chief` 解法**:全铺开金字塔 DAG + 原生分屏看流 + **「`📌` 图钉全局红线」**跨任务永久生效,子代理撞墙主动呈批。
80
+ ### 5. 子代理开了一堆,不知道谁卡住、谁在空转
81
+ - 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
82
+ - `dsh-chief` 的做法:任务页按主代理与子代理展开直观金字塔树状卡片,支持原地改状态、点击 `💬 分屏` 直接看实时修改流、点底栏带图标代理发 `@递话` 精准纠偏;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
83
83
 
84
- ### 6. 换窗口就断档 & 后台偷偷按量计费
85
- - **普通插件**:切窗口前情全丢;后台每轮乱跑总结,还常把订阅模型错配到高价按量渠道。
86
- - **`dsh-chief` 解法**:默认 **`⏸ 按需`(0 后台自动调用)**,严格对齐主会话 `Provider · 模型`;支持跨窗互联、断联净化与一键携参谋部署接力。
84
+ ### 6. 对话聊太长变慢变贵,换新窗口又得从头交代背景
85
+ - 常见状况:开了 100 轮想重开新窗口,却怕丢失背景、模型配置和刚梳理完的任务分工,或者后台总结插件偷偷走高价按量渠道。
86
+ - `dsh-chief` 的做法:顶栏模型选择器支持「跟随主对话」与 `180°` 扇形思考强度表盘(日常 `关停` / `巡检` 平常均 0 后台消耗);在「规划」页对看不懂的步骤点「解释」即可大白话解读,点 `📌 定住防改` 锁定人工核对过的交接单,一键新建窗口接力并可选随带工作档案层级。
87
87
 
88
88
  ---
89
89
 
90
- ## 📸 全景实机导览(`v1.2.0` 7 大核心视窗)
90
+ ## 界面与功能说明
91
91
 
92
- ### 01 · 许愿式参谋指挥舱(`参谋` 页签)
93
- - **实权许愿框**:输入栏居左收拢 `+` 战术驾驶舱,上方直显 `⚡ 强介入 0/♾️`、`✦ 智选压缩`、`🛡 红线哨兵`、`🔵 完全权限` 与红色 `⏹ 急停`。
94
- - **可见工作回执**:结构化战场摘要、边界请示卡、以及 `✦ 智选压缩` 真实压完后写回的可见回执一目了然。
95
- - **同步交接单开关**:右上角可直接切换「提炼摘要后同步更新交接单」。
92
+ ### 01 · 参谋主面板与流光可穿透舞台(`参谋` 页签)
93
+ - 底部输入框支持一句大白话委派探路、手搓物理墙、整理档案或全自动执行;左下控制条汇聚 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`、`L0–L3` 权限与红色 `⏹ 急停`;顶栏直观切换 `⏸ 关停 / 🛡 巡检 / 🤖 托管` 与模型/扇形思考强度。
94
+ - 参谋长后台运行「🌙 梦境漫游」或自动审查时,面板会亮起流动彩色光线外框与毛玻璃舞台,**鼠标单击毛玻璃任意处可立即收起模糊遮罩恢复操作,同时外框流光继续亮着提示后台仍在运作**。
96
95
 
97
- ![01 - 许愿式参谋长全景指挥舱](assets/screenshots/01-chief-cockpit-overview.png)
96
+ ![01 - 参谋长主面板](assets/screenshots/01-chief-cockpit-overview.png)
98
97
 
99
98
  ---
100
99
 
101
- ### 02 · 全铺开金字塔子代理拓扑(`任务` 页签)
102
- - **纵队全铺开**:`👑 主代理 · 总指挥` 居中统帅,下辖子代理横向分列纵队,不再在小视口里来回拖拽。
103
- - **原地闭环操作**:每张节点卡直接集成「状态切换、白话解释、派发执行、对话拆解、`分屏` 实时盯流」。
100
+ ### 02 · 主代理与子代理任务树(`任务` 页签)
101
+ - 按根会话与子代理纵队展开可视化金字塔卡片(配主/子代理前置矢量图标),直接在卡片上调整状态、派发任务或点 `分屏` 看实时输出流。
104
102
 
105
103
  <div align="center">
106
- <img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - 全铺开金字塔任务拓扑" width="76%" />
104
+ <img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - 任务树与子代理卡片" width="80%" />
107
105
  </div>
108
106
 
109
107
  ---
110
108
 
111
- ### 03 · 三层 0-Token 档案金库与双向差分(`档案` 页签)
112
- - **三库严格隔离**:顶部一键切换 **💬 本会话档案柜**(1:1 隔离)、**🌐 全局档案柜**(系统冷库不跟会话)与 **🏛️ 沉淀档案柜**(跨会话双盲冷封存)。
113
- - **四层曲别针收纳**:**多档案柜 → 抽屉 → 金/银/暗铜曲别针卷宗 → 分条记忆点 → 小点记忆**。
114
- - **摆上桌面与双向差分**:全局与本地实时标记「已同步全局 / 本地已改 / 仅本地」;点击「`📌 摆上桌面`」才向主对话与参谋强调,并支持复选多卷「组合递话」。
109
+ ### 03 · 认知桌面与俯视角「一沓纸」三层档案柜(`档案` 页签)
110
+ - 顶部划出置顶 **📌 认知桌面** 与实时 `2,400 Tokens / 6 份` 预算进度条(唯一随轮全文注入主对话,超额按铜/银/金自动退入观察队列);下方分为 **💬 本局档案柜**、**🌐 全局档案柜**、**🏛️ 冷藏档案柜**。
111
+ - 三层抽屉采用俯视角「一沓纸」动态卡片:平时叠放仅露标题与关键词 `🪝` 钩子,点开才展开操作栏与详情,谁能看、谁已拉阅一目了然。
115
112
 
116
113
  <div align="center">
117
- <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层 0-Token 档案金库与双向差分" width="68%" />
114
+ <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层档案柜与认知桌面" width="90%" />
118
115
  </div>
119
116
 
120
117
  ---
121
118
 
122
- ### 04 · 目标督导、步骤白话追问与结项门禁(`规划` 页签上方)
123
- - **核心目标锁定**:点击「`🎯 设为目标`」开启持久目标督导;开启强介入时自动锁定核心目标为唯一终局。
124
- - **点击任意步骤追问**:小任务板每一行都支持菜单弹窗——当场让参谋长白话解读「为什么有这步」,绝不打断主对话。
119
+ ### 04 · 目标锁定与步骤大白话「解释 / 咨询」(`规划` 页签上方)
120
+ - 点击 `🎯 设为目标` 开启目标督导(开强介入前必锁);任意步骤都可点击「解释」让参谋长用通俗大白话解释这条在干嘛、跳过有何影响,全程零打断主对话流程。
125
121
 
126
122
  <div align="center">
127
- <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 核心目标督导与步骤追问解读" width="68%" />
123
+ <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 目标督导与步骤追问" width="68%" />
128
124
  </div>
129
125
 
130
126
  ---
131
127
 
132
- ### 05 · 跨窗口独立会话串联与彩色抽屉信箱(`协同` 页签)
133
- - **跨窗协同集群**:一键串联多个独立 DSH 主窗口互享实时进度;断开链接立即净化外部记忆与缓存防串味。
134
- - **彩色抽屉信箱**:按全网广播(`@all` 自动去重)、多方协作与各窗口会话内部信箱分色归档。
135
- - **原图防幻觉机制**:输入栏粘贴/上传的截图原图落盘至 `<cwd>/.dsh-chief/uploads/`,纯文本参谋自动携带绝对路径降级交由主对话查看。
128
+ ### 05 · 跨窗口协同串联与信箱(`协同` 页签)
129
+ - 可把多个独立 DSH 窗口连在一起互通进度(前端界面 + 后端接口联动);断开协同立即清掉缓存、外部记忆与离线信箱残留。
130
+ - 粘贴进输入框的截图原图会存进 `<cwd>/.dsh-chief/uploads/`,避免纯文本模型看图靠猜。
136
131
 
137
132
  <div align="center">
138
- <img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口独立会话串联与协同网络" width="68%" />
133
+ <img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口协同与信箱" width="68%" />
139
134
  </div>
140
135
 
141
136
  ---
142
137
 
143
- ### 06 · `📌` 图钉全局红线盖章与浓缩(`边界` 页签)
144
- - **双作用域严格区分**:点亮左侧 **`📌` 小图钉** 升格为跨所有任务生效的「全局共享铁律」;未钉住规则仅限当前会话有效。
145
- - **必做清单与撞墙呈批**:支持「必做事项 (`allowed`)」「禁止红线 (`forbidden`)」「注意事项 (`notes`)」,支持子代理撞墙呈批与一键浓缩合并多条旧规则。
138
+ ### 06 · 物理驻墙、必做项与 `📌` 全局红线(`边界` 页签)
139
+ - 顶部「🧱 物理驻墙 · 事前硬拦截」专区:可点 `+ 手动驻墙` 或让 `✨ 参谋手搓墙`,随时在 `🌐 全局`、`📁 本工程`、`⏸ 暂挂` 间切换,支持同类规则一键合并。
140
+ - 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏管理;任何 `L0–L3` 权限都无权私拆物理墙与红线,真撞死仅能提交人类审批单。
146
141
 
147
142
  <div align="center">
148
- <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 图钉全局红线与参谋长边界请示" width="68%" />
143
+ <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 边界规则与全局图钉红线" width="68%" />
149
144
  </div>
150
145
 
151
146
  ---
152
147
 
153
- ### 07 · 跨会话接力、📌 定住防改与一键部署参谋(`规划` 页签底部)
154
- - **可手改与 `📌 定住防改`**:交接单支持手工微调;点亮 **`📌 定住防改`** 自动冻结 `[自动渲染]` 快照并锁死「同步交接单」,防止参谋后续摘要误覆盖。
155
- - **4 档档案跟随策略**:新建或接力至已有会话时,自由选择「不带工作档案 / 仅挂桌面备查 / 带整个抽屉 / 全柜工作档案」,沉淀冷库保持绝对隔离。
156
- - **一键携参谋上任**:无缝继承参谋长专职模型与纪律配置(强介入默认安全置关),搭配 `idle-guard` 防任务半途空转停机。
148
+ ### 07 · 跨会话交接单与携带参谋新开窗口(`规划` 页签底部)
149
+ - 交接单支持手改,点 `📌 定住防改` 后锁定当前快照,不会被后续自动摘要覆盖。
150
+ - 支持一键新开窗口并继承当前工作区 `workspaceId`、参谋配置与指定档案范围(高自主强介入默认安全置关),搭配 `idle-guard` 避免长任务空转停机。
157
151
 
158
152
  <div align="center">
159
- <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话接力与定住防改交接单" width="68%" />
153
+ <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话交接单与新开窗口部署" width="68%" />
160
154
  </div>
161
155
 
162
156
  ---
163
157
 
164
- ## ⚠️ 使用须知与两条硬核免责声明
158
+ ## 使用前建议了解的两件事
165
159
 
166
- > [!IMPORTANT]
167
- > 启用「✦ 许愿框实权执行」「⚡ 主动强介入」「✦ 智选压缩」前,请务必牢记以下两条客观规律:
160
+ > [!NOTE]
161
+ > 开启实权工具、`⚡ 主动强介入` 或 `✦ 智选压缩` 前,下面两点直接决定使用体感:
168
162
  >
169
- > 1. **能力下限靠本插件工程护栏兜底,能力上限完全取决于底层大模型**
170
- > - 本插件通过 0-Token 冷隔离、默认只读越权先问、先落盘复核再压缩、轮数熔断与 `⏹ 急停` 守住安全下限。
171
- > - 但多步工具规划、复杂代码洞察、强介入纠偏与重点提炼的上限,**完全看你为参谋长搭配的模型智商**。
172
- > - 重度工程强烈建议给参谋长选配推理过硬的主力旗舰模型,勿对超轻量小模型抱有超出其推理上限的期待。
173
- > 2. **切忌同时挂载过多“破坏对话模型脑子”的外部注入**
174
- > - 请勿在主对话或项目里叠加上百行互殴的全局 System Prompt / Rules,或会每轮硬塞几千字旧账的传统常驻记忆插件。
175
- > - **过多冗余注入会把模型的“脑子”搅浑、稀释当下注意力**,还极易与参谋长强介入指令冲突,引发死循环或提前熔断。
176
- > - 保持外部提示词干净克制,低频资料交由本插件 **0-Token 冷库** 按需取出,才能发挥最大战力。
163
+ > 1. **工程护栏决定下限,底层模型决定上限**
164
+ > 插件负责保证 0-Token 档案隔离、四档权限审批、压缩前落盘复核、死循环熔断、物理驻墙和 `⏹ 急停` 这些安全下限。但拆任务准不准、找 Bug 稳不稳,完全取决于你给参谋长选了哪个模型。处理复杂工程建议选推理能力强的主力旗舰模型,别用太轻的小模型。
165
+ > 2. **少叠互相冲突的外部常驻注入**
166
+ > 不要一边用本插件,一边在项目里叠加上百条互相对着干的全局 Rules 或每轮强灌大段旧账的记忆插件。无关上下文太多会稀释当前注意力,还容易和参谋的纠偏指令打架。低频资料放进本插件的 **0-Token 档案柜**,仅最常用的摆上 **认知桌面**,主对话才干净。
177
167
 
178
168
  ---
179
169
 
180
- ## 🏗️ 冷热记忆分舱与多代理协同架构
170
+ ## 模块结构与数据流 (`v1.5.0`)
171
+
172
+ `v1.5.0` 包含 **38 个后端模块(含 `pkg/safety/` 下 9 个零业务依赖的安全内核模块)+ 16 个前端模块**(无环依赖、无 `export let` 可变导出),方便审查与长期维护。详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
181
173
 
182
174
  ```mermaid
183
175
  flowchart TB
184
- subgraph UI["DSH 右侧常驻参谋舱 (client.js)"]
185
- T1["参谋台 (许愿框 + 驾驶舱 + 急停)"]
186
- T2["全铺开金字塔任务图"]
187
- T3["跨窗与子代理协同网"]
188
- T4["目标督导 + 交接单定住 + 部署参谋"]
189
- T5["三层 0-Token 档案金库 + 双向差分"]
190
- T6["📌 全局红线 & 守护偏好"]
176
+ subgraph UI["DSH 右侧常驻面板 (client.js <- 16 个前端模块)"]
177
+ T1["参谋页 (问答框 · 180°扇形思考表盘 · 可点穿透流光毛玻璃)"]
178
+ T2["任务页 (主/子代理金字塔 · 实时分屏 · @递话)"]
179
+ T3["协同页 (跨窗联动 · 彩色信箱)"]
180
+ T4["规划页 (必锁目标 · 步骤大白话解释 · 交接单)"]
181
+ T5["档案页 (2400T认知桌面 · 一沓纸三层抽屉与织钩)"]
182
+ T6["边界页 (动态物理驻墙 · 请示拆墙 · 📌全局红线)"]
191
183
  end
192
184
 
193
- subgraph Core["宿主协调与存储内核 (Zero External Deps)"]
194
- Hot["热工作板 & 精炼热摘要\nboard.json / boards/session-*.json"]
195
- Cold["本会话档案柜 + 系统全局冷库 + 沉淀冷库\ncabinets/ + global-vault/ + precipitated/vault-global.json"]
196
- Bus["4 档实权执行器、信使与原图落盘\nchief-executor.js + auto-continue.js + idle-guard.js"]
185
+ subgraph Core["本地后端存储与安全内核 (零外部依赖 · 38 个后端模块)"]
186
+ Hot["热工作板: ~/.dsh/chief/board.json & boards/<sid>.json\n跨进程/工作线程 O_EXCL 自旋锁"]
187
+ Walls["动态物理驻墙: ~/.dsh/chief/guard-walls.json\n全局 / 本工程 / 暂挂三态"]
188
+ Cold["三层档案库: 2400T认知桌面(唯一注入) + 一沓纸钩子柜 + 0-byte双盲冷藏库"]
189
+ Bus["调度与安全: safety/*.js + chief-executor + 关停/巡检/托管(5条件休眠) + 审计"]
197
190
  end
198
191
 
199
- subgraph Agents["多智能体执行集群"]
200
- Lead["当前主代理 (Root Coordinator)"]
201
- Subs["子代理纵队 (@arch / @dev / @bench)"]
202
- Peers["已串联与一键部署的跨窗口会话"]
192
+ subgraph Agents["宿主执行代理 (tools/pre-execute 全员事前拦截)"]
193
+ Lead["主对话 (@lead)"]
194
+ Subs["子代理 (@arch / @dev / @bench)"]
195
+ Peers["跨窗口已串联会话"]
203
196
  end
204
197
 
205
- UI <-->|"25 条同源环回守卫 API (/api/dsh-chief/*)"| Core
206
- Hot -->|"紧凑态势注入"| Lead
207
- Hot -->|"紧凑态势注入"| Subs
208
- Cold -.->|"三层冷库 0 Token 隔离\n仅「📌 摆上桌面」或取出时注入"| Lead
198
+ UI <-->|"27 条同源环回 API (/api/dsh-chief/*, guard fail-closed 403)"| Core
199
+ Hot -->|"紧凑热态势"| Lead
200
+ Hot -->|"紧凑热态势"| Subs
201
+ Walls -->|"事前物理阻断或单次弹窗询问"| Lead
202
+ Walls -->|"事前物理阻断或单次弹窗询问"| Subs
203
+ Cold -.->|"仅📌认知桌面全文注入 · 非桌面仅🪝按需拉阅"| Lead
209
204
  Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
210
205
  ```
211
206
 
212
207
  ---
213
208
 
214
- ## ⚡ 快速安装(零外部依赖)
209
+ ## 安装与宿主版本兼容
215
210
 
216
- 在 DSH 已安装 [dshmarket](https://github.com/dsh-market/dsh-market) 后可直接搜索 **`dsh-chief`**(或 **`DSH 参谋长`**)点击安装,也可使用 CLI 一键装入(`web` 环境把 `desktop` 改为 `web`):
211
+ 在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
217
212
 
218
213
  ```bash
219
- # 方式 1:通过 npm 官方源安装最新版(v1.3.0,国内自动走镜像加速,支持后续检测升级)
214
+ # 方式 1:通过 npm 安装最新版(v1.5.0)
220
215
  dsh plugin --profile desktop add dsh-chief
221
216
 
222
- # 方式 2:安装历史归档 GitHub Release 预构建包(v1.2.1 归档快照)
223
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.2.1/dsh-chief-1.2.1.tgz
224
-
225
- # 方式 3:通过 GitHub 仓库源码直接安装
217
+ # 方式 2:从 GitHub 仓库直接安装(与 main 最新代码同步)
226
218
  dsh plugin --profile desktop add github:gluztm/dsh-chief
219
+
220
+ # 方式 3:安装 GitHub Release 预构建包(v1.5.0)
221
+ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.5.0/dsh-chief-1.5.0.tgz
227
222
  ```
228
223
 
229
- 安装后刷新 DSH 界面(或重启客户端),点击工作区右上侧栏 **✦ `DSH 参谋长`** 图标即可展开指挥舱。
224
+ 装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
230
225
 
231
- ### 宿主版本兼容性矩阵
226
+ ### 宿主版本兼容表
232
227
 
233
- | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层冷库 / 许愿框 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
228
+ | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
234
229
  | :--- | :---: | :---: | :--- |
235
- | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 原生提供 `subagents.resolveName` / `rootOf` / `namesOf` |
236
- | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 提示升级 | 旧版子代理 API;面板自动给出升级引导并拦截风险调用 |
230
+ | **`>= 0.2.2-rc.5`(当前桌面主力版)** | 完整可用 | 完整可用 | 已适配 `dsh-tool-fs`(`read`/`read_image`/`write`/`edit`/`apply_patch`)、`str_replace_editor`、热调 `reasoningEffort` 及原生 `{ kind: 'ask' }` 弹窗 |
231
+ | `0.2.2-rc.2 ~ 0.2.2-rc.4` | 完整可用 | 完整可用 | 宿主原生提供 `subagents.resolveName` / `rootOf` / `namesOf` 与 `tools/pre-execute` 物理拦截 |
232
+ | `0.2.0 ~ 0.2.2-rc.1` | 正常挂载 | 提示升级 | 旧版无命名子代理 API,面板会自动拦截高风险调用并提示升级 |
237
233
 
238
234
  ---
239
235
 
240
- ## 🛠️ 模型工具矩阵(4 Tools)
236
+ ## 注册给模型的 4 个工具
241
237
 
242
- 装入后向模型注册 4 个结构化工具(动作层兼容原生 JSON 数组与宽容文本传参):
238
+ 插件只读注册 4 个结构化工具,动作参数一并兼容严格 JSON 与常见文本写法:
243
239
 
244
- | 工具名 | 核心职责 | 典型高频动作 (`action`) |
240
+ | 工具名 | 用途 | 常用动作 (`action`) |
245
241
  | :--- | :--- | :--- |
246
- | **`chief_board`** | 驱动任务图、小任务板、冷档案检索、跨代理信箱、提权请示与协同压缩 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`archive.save`、`archive.search`、`bounds.propose`、`permission.request`、`context.compact` |
247
- | **`chief_memory`** | 读写会话级高密度热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
248
- | **`chief_boundaries`** | 维护图钉全局红线(`📌`)、必做事项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
249
- | **`chief_handoff`** | 预览与生成自包含跨会话 Markdown 交接单 | `preview` / 新会话接力包 |
242
+ | **`chief_board`** | 驱动任务板、拉取与检索冷档案、跨代理与直呼参谋、回复问询、查询物理墙、调挡与提权、触发压缩 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`chief.request`、`inquiry.reply`、`wall.list`、`archive.save`、`archive.search`、`archive.pull`、`model.effort`、`bounds.propose`、`permission.request`、`context.compact` |
243
+ | **`chief_memory`** | 读写会话级热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
244
+ | **`chief_boundaries`** | 读写全局 `📌` 红线、必做项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
245
+ | **`chief_handoff`** | 预览并生成独立自包含的跨会话 Markdown 交接单 | `preview` / 会话接力 |
246
+
247
+ ---
248
+
249
+ ## 本地存储与安全边界
250
+
251
+ - **跨进程与多线程文件锁**:`board-store.js`、`chief-state.js`、`archive-core.js`、`safety/guard-walls.js` 对每次落盘使用带 `O_EXCL` 和随机抖动重试的文件锁(包含 Windows NTFS 瞬态 `EPERM/EACCES/EBUSY` 重试)以及 `threadId` 唯一临时文件原子替换,高并发写入不丢单。
252
+ - **独立安全内核与反变形检测**:`pkg/safety/`(9 模块)与 `chief-executor.js` 全集通过 MD5 校验守护,覆盖复合管道、内联脚本(`node -e` / `python -c` / `pwsh` / `iex` + Base64)、引号多反斜杠与点号反斜杠凭据变形、`bounds.*` / 物理驻墙人类确认令牌以及单次授权 `capabilityScope` 绑定,正常 `process.env.NODE_ENV` 与 `node .\env\setup.js` 零误杀。
253
+ - **27 条接口同源环回校验**:全部 `/api/dsh-chief/*` 接口先校验 Loopback 来源与 `Origin/Host`,连接守卫异常时 fail-closed 返回 `403`。
254
+ - **凭据防误存与零遥测**:禁止写入 `sk-*`、`ghp_*`、Bearer Token、`AIza*`、`AKIA*` 与私钥片段;一键收纳含疑似密钥的便签会自动脱敏为 `[REDACTED]`。所有状态、档案、物理驻墙与审计日志完全留在本地 `~/.dsh/chief/`,零外部依赖,零遥测上报。
250
255
 
251
256
  ---
252
257
 
253
- ## 🛡️ 工程指标与纯本地安全
258
+ ## 贡献者
254
259
 
255
- - **原子写锁零丢失**:`board.json` 与三库档案文件均受基于 `wx` 排他文件锁 + 陈旧锁自动回收保护,并发写锁零损坏。
256
- - **三层冷库零泄漏**:冷封存卷宗平时 **0 字节**注入主对话,仅在显式「摆上桌面」或「取出」时按需加载。
257
- - **25 条同源环回守卫**:全部 `/api/dsh-chief/*` 接口强制验证 Loopback 地址与同源 `Origin/Host`,防跨站诱导。
258
- - **敏感凭据正则硬拦截**:自动拒存 `sk-*`、`ghp_*`、Bearer Token 与 OpenSSH 私钥,所有数据 100% 存放在本机 `~/.dsh/chief/`,零遥测、零云端上报。
260
+ | 贡献者 | 主要工作 |
261
+ | --- | --- |
262
+ | [gluztm](https://github.com/gluztm) | 项目发起人、产品定义与长期维护 |
263
+ | [@iridiumgit](https://github.com/iridiumgit) | 深度定位并贡献 DSH 浅色主题弹层修复方案([#3](https://github.com/gluztm/dsh-chief/issues/3))、子代理会话隐藏参谋入口定位([#4](https://github.com/gluztm/dsh-chief/issues/4))及交互建议([#5](https://github.com/gluztm/dsh-chief/issues/5)) |
264
+ | [@edz017](https://github.com/edz017) | 首日实测 DSH `0.2.2-rc.1~rc.3` 宿主兼容性、源码级定位命名子代理接口约束与 `preferNewPane` 参数修正([#1](https://github.com/gluztm/dsh-chief/issues/1)) |
265
+ | [Gemini](https://github.com/gemini-code-assist) | 功能研发、`pkg/safety/` 独立安全内核、认知桌面与三态总控、180° 扇形思考表盘及自动化门禁 |
266
+ | [Codex](https://github.com/codex) | 模块化架构设计、高并发压测、红队穿透测试与边界审查 |
267
+ | [deepseek-ai](https://github.com/deepseek-ai) | DeepSeek Harness 宿主运行时与 SuperAgent 协同机制支持 |
259
268
 
260
269
  ---
261
270
 
262
- ## 📄 开源许可 (License)
271
+ ## 开源协议
263
272
 
264
- 基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。欢迎使用、审计与提交 PR。
273
+ 基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源。