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/CHANGELOG.md +84 -12
- package/README.en.md +156 -113
- package/README.md +149 -140
- package/api-routes.js +183 -4
- package/archive-core.js +136 -8
- package/archive-dossiers.js +450 -20
- package/archive-precipitated.js +115 -36
- package/auto-continue.js +13 -5
- package/board-actions.js +131 -5
- package/board-schema.js +1 -1
- package/chief-approvals.js +415 -90
- package/chief-archives.js +191 -29
- package/chief-commands.js +1178 -207
- package/chief-executor.js +279 -555
- package/chief-models.js +158 -28
- package/chief-network.js +157 -8
- package/chief-review.js +240 -67
- package/chief-state.js +855 -109
- package/chief-view.js +38 -20
- package/client.js +5602 -2618
- package/digest.js +18 -9
- package/model-tools.js +92 -6
- package/package.json +41 -25
- package/runtime-hooks.js +221 -12
- package/safety/audit-log.js +95 -0
- package/safety/command-analyzer.js +339 -0
- package/safety/guard-walls.js +993 -0
- package/safety/index.js +78 -0
- package/safety/invariant-guards.js +280 -0
- package/safety/path-guard.js +227 -0
- package/safety/policy-engine.js +387 -0
- package/safety/policy-plugin.js +391 -0
- package/safety/tool-gate.js +278 -0
- package/subagent-runtime.js +266 -3
package/README.md
CHANGED
|
@@ -1,264 +1,273 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
<sub
|
|
3
|
+
**给 DeepSeek Harness(DSH)用的右侧栏任务看护、认知桌面、事前物理驻墙与多代理管控面板**
|
|
4
|
+
<sub>长对话 `/compact` 前先存参数再压缩,子代理金字塔一屏看完,改文件跑命令前先过物理墙与逐项审批。</sub>
|
|
5
5
|
|
|
6
|
-
<img src="assets/chief-10s-compare.gif" alt="
|
|
6
|
+
<img src="assets/chief-10s-compare.gif" alt="对比原生长会话与挂载 dsh-chief 后的效果:左边循环重读、压缩丢参数、跨窗失忆;右边先入柜再压缩、可随时熔断、带交接单换窗继续" width="800" />
|
|
7
7
|
|
|
8
|
-
<sub>默认只读起手 ·
|
|
8
|
+
<sub>默认只读起手 · 越权操作前先确认 · `dsh plugin --profile desktop add dsh-chief`</sub>
|
|
9
9
|
|
|
10
10
|
<br />
|
|
11
11
|
|
|
12
|
-
<img src="assets/
|
|
12
|
+
<img src="assets/v150-highlights.png" alt="dsh-chief v1.5.0 核心新特性实机一览:180° 扇形思考强度表盘、托管梦境漫游毛玻璃单击即穿透、认知桌面与俯视角一沓纸档案柜、事前物理驻墙硬拦截" width="100%" />
|
|
13
13
|
|
|
14
14
|
<br />
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
|
|
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
|
[](https://dsh.deepseek.com)
|
|
24
|
+
[](https://github.com/gluztm/dsh-chief/releases)
|
|
20
25
|
[](https://www.npmjs.com/package/dsh-chief)
|
|
26
|
+
[](https://github.com/gluztm/dsh-chief/actions/workflows/ci.yml)
|
|
21
27
|
[](https://awesome-dsh-plugin.com/p/gluztm/dsh-chief/)
|
|
22
|
-
[](https://www.bilibili.com/video/BV1DqsV6QEGi)
|
|
23
29
|
[](https://github.com/deepseek-ai/dsh-superagent-prototype)
|
|
24
30
|
[](https://nodejs.org)
|
|
25
31
|
[](#)
|
|
26
32
|
[](LICENSE)
|
|
27
33
|
|
|
28
|
-
>
|
|
29
|
-
>
|
|
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
|
-
##
|
|
38
|
-
|
|
39
|
-
- **模块化低耦合架构(`v1.3.0`)**:29 个后端与 16 个前端单一职责模块协同(无环依赖、零可变导出),搭配跨进程/多线程 `O_EXCL` 自旋锁与 `chief-audit.jsonl` 只追加审计账本,兼顾长期可维护性与高并发鲁棒性。
|
|
45
|
+
## `v1.5.0` 重点升级一览
|
|
40
46
|
|
|
41
|
-
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
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
|
-
##
|
|
54
|
+
## 主要解决哪些日常麻烦
|
|
54
55
|
|
|
55
|
-
|
|
56
|
+
写代码和跑长会话时最常踩的几个坑,这个面板逐个给了工程上的硬兜底。
|
|
56
57
|
|
|
57
|
-
### 1.
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
58
|
+
### 1. 上下文一压缩(`/compact`)就忘了前面查出来的路径和命令
|
|
59
|
+
- 常见状况:对话一长触发压缩,刚找到的配置路径、端口、报错行号和回滚命令全被摘要吃掉,模型回头重读文件、重新踩坑。
|
|
60
|
+
- `dsh-chief` 的做法:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也支持直接在右侧输入「压缩吧」。
|
|
61
|
+
- 压缩顺序固定为「先抢救细节并校验写入本会话档案柜 → 再静默调用宿主 `/compact`」。如果没产生历史消息或压缩报错,计数绝不虚增。
|
|
61
62
|
|
|
62
|
-
### 2.
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
63
|
+
### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
|
|
64
|
+
- 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
|
|
65
|
+
- `dsh-chief` 的做法:必须先填并锁定核心目标,再开启 `⚡ 主动强介入`(`0 = ♾️` 无限轮自动续推,自带同报错 3 轮防死循环熔断);在 `🛡 巡检` / `🤖 托管` 下断流自动过墙唤醒续跑,`L3 + 强介入` 还可安全批量收口并产出「🏁 一站式战报」,未通过核验并经你 `✅ 批准结项` 绝不虚报完工。
|
|
66
|
+
- 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
|
|
66
67
|
|
|
67
|
-
### 3.
|
|
68
|
-
-
|
|
69
|
-
-
|
|
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
|
-
-
|
|
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
|
-
-
|
|
80
|
+
### 5. 子代理开了一堆,不知道谁卡住、谁在空转
|
|
81
|
+
- 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
|
|
82
|
+
- `dsh-chief` 的做法:任务页按主代理与子代理展开直观金字塔树状卡片,支持原地改状态、点击 `💬 分屏` 直接看实时修改流、点底栏带图标代理发 `@递话` 精准纠偏;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
|
|
83
83
|
|
|
84
|
-
### 6.
|
|
85
|
-
-
|
|
86
|
-
-
|
|
84
|
+
### 6. 对话聊太长变慢变贵,换新窗口又得从头交代背景
|
|
85
|
+
- 常见状况:开了 100 轮想重开新窗口,却怕丢失背景、模型配置和刚梳理完的任务分工,或者后台总结插件偷偷走高价按量渠道。
|
|
86
|
+
- `dsh-chief` 的做法:顶栏模型选择器支持「跟随主对话」与 `180°` 扇形思考强度表盘(日常 `关停` / `巡检` 平常均 0 后台消耗);在「规划」页对看不懂的步骤点「解释」即可大白话解读,点 `📌 定住防改` 锁定人工核对过的交接单,一键新建窗口接力并可选随带工作档案层级。
|
|
87
87
|
|
|
88
88
|
---
|
|
89
89
|
|
|
90
|
-
##
|
|
90
|
+
## 界面与功能说明
|
|
91
91
|
|
|
92
|
-
### 01 ·
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
- **同步交接单开关**:右上角可直接切换「提炼摘要后同步更新交接单」。
|
|
92
|
+
### 01 · 参谋主面板与流光可穿透舞台(`参谋` 页签)
|
|
93
|
+
- 底部输入框支持一句大白话委派探路、手搓物理墙、整理档案或全自动执行;左下控制条汇聚 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`、`L0–L3` 权限与红色 `⏹ 急停`;顶栏直观切换 `⏸ 关停 / 🛡 巡检 / 🤖 托管` 与模型/扇形思考强度。
|
|
94
|
+
- 参谋长后台运行「🌙 梦境漫游」或自动审查时,面板会亮起流动彩色光线外框与毛玻璃舞台,**鼠标单击毛玻璃任意处可立即收起模糊遮罩恢复操作,同时外框流光继续亮着提示后台仍在运作**。
|
|
96
95
|
|
|
97
|
-

|
|
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 -
|
|
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 ·
|
|
112
|
-
-
|
|
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 -
|
|
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 -
|
|
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
|
-
-
|
|
134
|
-
-
|
|
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 -
|
|
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
|
-
-
|
|
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 -
|
|
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
|
-
-
|
|
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 -
|
|
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
|
-
> [!
|
|
167
|
-
>
|
|
160
|
+
> [!NOTE]
|
|
161
|
+
> 开启实权工具、`⚡ 主动强介入` 或 `✦ 智选压缩` 前,下面两点直接决定使用体感:
|
|
168
162
|
>
|
|
169
|
-
> 1.
|
|
170
|
-
>
|
|
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
|
|
185
|
-
T1["
|
|
186
|
-
T2["
|
|
187
|
-
T3["
|
|
188
|
-
T4["
|
|
189
|
-
T5["
|
|
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["
|
|
194
|
-
Hot["
|
|
195
|
-
|
|
196
|
-
|
|
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["
|
|
201
|
-
Subs["
|
|
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 <-->|"
|
|
206
|
-
Hot -->|"
|
|
207
|
-
Hot -->|"
|
|
208
|
-
|
|
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
|
-
|
|
211
|
+
在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
|
|
217
212
|
|
|
218
213
|
```bash
|
|
219
|
-
# 方式 1:通过 npm
|
|
214
|
+
# 方式 1:通过 npm 安装最新版(v1.5.0)
|
|
220
215
|
dsh plugin --profile desktop add dsh-chief
|
|
221
216
|
|
|
222
|
-
# 方式 2
|
|
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
|
-
|
|
224
|
+
装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
|
|
230
225
|
|
|
231
|
-
###
|
|
226
|
+
### 宿主版本兼容表
|
|
232
227
|
|
|
233
|
-
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 /
|
|
228
|
+
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
|
|
234
229
|
| :--- | :---: | :---: | :--- |
|
|
235
|
-
| **`>= 0.2.2-rc.
|
|
236
|
-
| `0.2.
|
|
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
|
-
##
|
|
236
|
+
## 注册给模型的 4 个工具
|
|
241
237
|
|
|
242
|
-
|
|
238
|
+
插件只读注册 4 个结构化工具,动作参数一并兼容严格 JSON 与常见文本写法:
|
|
243
239
|
|
|
244
|
-
| 工具名 |
|
|
240
|
+
| 工具名 | 用途 | 常用动作 (`action`) |
|
|
245
241
|
| :--- | :--- | :--- |
|
|
246
|
-
| **`chief_board`** |
|
|
247
|
-
| **`chief_memory`** |
|
|
248
|
-
| **`chief_boundaries`** |
|
|
249
|
-
| **`chief_handoff`** |
|
|
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
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
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
|
-
##
|
|
271
|
+
## 开源协议
|
|
263
272
|
|
|
264
|
-
基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)**
|
|
273
|
+
基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源。
|