dsh-chief 1.3.0 → 1.4.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 +42 -12
- package/README.en.md +143 -116
- package/README.md +134 -142
- package/api-routes.js +19 -2
- package/board-actions.js +72 -1
- package/board-schema.js +1 -1
- package/chief-approvals.js +241 -81
- package/chief-archives.js +35 -0
- package/chief-commands.js +615 -108
- package/chief-executor.js +279 -555
- package/chief-network.js +157 -8
- package/chief-review.js +33 -1
- package/chief-state.js +497 -81
- package/chief-view.js +21 -6
- package/client.js +1953 -506
- package/model-tools.js +78 -2
- package/package.json +35 -24
- package/runtime-hooks.js +108 -2
- 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 +9 -2
package/README.md
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
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 web add dsh-chief`</sub>
|
|
9
9
|
|
|
10
10
|
<br />
|
|
11
11
|
|
|
12
|
-
<img src="assets/hero-banner.png" alt="
|
|
12
|
+
<img src="assets/hero-banner.png" alt="dsh-chief 面板主视图" width="100%" />
|
|
13
13
|
|
|
14
14
|
<br />
|
|
15
15
|
|
|
16
|
-
#
|
|
17
|
-
### DeepSeek Harness
|
|
16
|
+
# DSH 参谋长 (`dsh-chief`)
|
|
17
|
+
### DeepSeek Harness 右侧常驻多代理看护、0-Token 本地档案柜与安全审批面板
|
|
18
18
|
|
|
19
19
|
[](https://dsh.deepseek.com)
|
|
20
20
|
[](https://www.npmjs.com/package/dsh-chief)
|
|
@@ -25,8 +25,8 @@
|
|
|
25
25
|
[](#)
|
|
26
26
|
[](LICENSE)
|
|
27
27
|
|
|
28
|
-
>
|
|
29
|
-
>
|
|
28
|
+
> **当前版本 `v1.4.0`**:新增 9 模块独立安全内核 (`pkg/safety/`)、基于 `tools/pre-execute` 的事前物理驻墙 (`guard-walls.json`)、`role + capabilities` 双层能力与持久化 `TaskLedger` 续跑、参谋懒介入委派 (`[EXECUTION_REQUEST]`) 与后台零中断问询 (`[INQUIRY]`),已适配 DSH `0.2.2-rc.5`。
|
|
29
|
+
> 协同结构参考官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的 Router + Workers 分工模型,保持侧边栏状态与主对话上下文相互隔离。
|
|
30
30
|
|
|
31
31
|
**简体中文** · [English (`README.en.md`)](README.en.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md)
|
|
32
32
|
|
|
@@ -34,231 +34,223 @@
|
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
37
|
-
##
|
|
37
|
+
## 主要解决哪些日常麻烦
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
写代码和跑长会话时最常踩的几个坑,这个面板逐个给了工程上的硬兜底。
|
|
40
40
|
|
|
41
|
-
|
|
42
|
-
-
|
|
43
|
-
-
|
|
44
|
-
-
|
|
45
|
-
- **目标锁死 + 人类拍板结项**:强介入锁定核心目标(支持 `0 = ♾️` 无限轮),达标后核验 `allowed` 必做清单并等待人类点击「`✅ 批准结项`」。
|
|
46
|
-
- **✦ 智选压缩 + 灵活安全阈值**:支持 `✦ 智选压缩` 在阶段收口等主代理空闲后触发,也支持 `10%–95%` / `>= 8k` Token 阈值或直说「压缩吧」。
|
|
47
|
-
- **跨隔离真 `/compact`**:自动跨过 Cordis 服务隔离调用官方 `/compact` 通道,先抢救工程细节入柜并复核落盘,再静默压缩留回执。
|
|
48
|
-
- **三层 0-Token 档案金库**:💬 本会话柜(1:1 隔离)、🌐 系统全局冷库(双向差分)、🏛️ 沉淀冷库(默认双盲 0 字节),支持一键「`📌 摆上桌面`」与「`组合递话`」。
|
|
49
|
-
- **跨窗协同与定住防改交接单**:入网前提示污染风险、断联立即净化防串味,支持手改与一键「`📌 定住防改`」冻结交接快照。
|
|
41
|
+
### 1. 上下文一压缩(`/compact`)就忘了前面查出来的路径和命令
|
|
42
|
+
- 常见状况:对话一长触发压缩,刚找到的配置路径、端口、报错行号和回滚命令全被摘要吃掉,模型回头重读文件、重新踩坑。
|
|
43
|
+
- `dsh-chief` 的做法:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也支持直接在右侧输入「压缩吧」。
|
|
44
|
+
- 压缩顺序固定为「先抢救细节并校验写入本会话档案柜 → 再静默调用宿主 `/compact`」。如果没产生历史消息或压缩报错,计数绝不虚增。
|
|
50
45
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
普通待办只是多了一块手写备忘录,常驻记忆只是每轮往提示词里硬塞几千字旧账;**`dsh-chief` 把「人盯 AI 干活」反转为「许愿式一站式跑通」**。
|
|
46
|
+
### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
|
|
47
|
+
- 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
|
|
48
|
+
- `dsh-chief` 的做法:用核心目标锁死最终验收标准,可开启 `⚡ 主动强介入`(支持 `0 = ♾️` 无限轮自动续推,自带无进展熔断),必须核验完 `allowed` 必做清单并由你点击 `✅ 批准结项` 才会停表。
|
|
49
|
+
- 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
|
|
56
50
|
|
|
57
|
-
###
|
|
58
|
-
-
|
|
59
|
-
-
|
|
60
|
-
-
|
|
51
|
+
### 3. 常驻记忆插件每轮塞几千字进提示词,烧 Token 还把模型带偏
|
|
52
|
+
- 常见状况:普通记忆插件每次发消息都把几十条过时笔记硬塞进 System Prompt,主模型被无关旧账带偏,费用还高。
|
|
53
|
+
- `dsh-chief` 的做法:把工程档案放进三层本地冷库(本会话柜 / 全局柜 / 沉淀柜),**封存时向主对话注入 0 字节、0 Token**。
|
|
54
|
+
- 平时不进上下文,需要参考哪几份卷宗时再点 `📌 摆上桌面` 或 `📤 取出`,用完点 `放回` 就从提示词撤下。
|
|
61
55
|
|
|
62
|
-
###
|
|
63
|
-
-
|
|
64
|
-
-
|
|
65
|
-
-
|
|
56
|
+
### 4. 权限全放开怕误删误推,全锁死又只剩嘴上聊天
|
|
57
|
+
- 常见状况:次次确认太烦,给了完全权限又怕模型上头跑 `git push --force`、删目录或碰 `.env`;或者参谋长权限一高就爱自己抢着改代码,反而把主对话晾在一边。
|
|
58
|
+
- `dsh-chief` 的做法:内置 `advisor`(只读 · 默认)/ `assistant` / `strategist`(逐项授权)/ `chief`(高自主)四档,外加事前物理防线。
|
|
59
|
+
- **新对话默认只读**:只看代码、出方案、记看板,不碰工作区文件,也不插话打断主对话。
|
|
60
|
+
- **工具落地前的事前物理驻墙**:主对话、子代理和参谋只要调用终端命令或读写文件,执行前都要先过宿主 `tools/pre-execute` 检查和你的「物理驻墙」。每堵墙都能切成「全局随身(像偏好一样跟着所有新对话)」、「仅本工程」或「暂挂停用」,支持同类墙一键合并;不懂正则还能让参谋帮你手搓草案再点确认落锁。高危命令墙支持触发 DSH 原生弹窗问你一次是否放行。
|
|
61
|
+
- **参谋懒介入与顺口问**:哪怕开到高权限,没指定让参谋亲自操刀时,它也会先把干活请求派给主对话,不会冒充你在主框里发消息;刚开空白新窗口找参谋,它会先让主模型只读看代码、排计划再回来汇报;半途缺情报就后台悄悄问主对话一句,不打断主对话手头动作,聊完还会顺手刷新顶部摘要。
|
|
62
|
+
- **点完允许自动续跑 & 策略只紧不松**:通过 `TaskLedger` 记下未竟事务,逐项审批或提权通过后会接着往下跑完;内置硬红线(删盘、强推、`git reset --hard`、复合管道、内联 `node -e`/`python -c`、`".\\"env` 变形、NTFS ADS 流与 `-EncodedCommand`)在任何档位都直接拦下并写进 `~/.dsh/chief/chief-audit.jsonl`,也支持外挂只紧不松的 JSON 策略插件进一步限缩工具或目录。
|
|
66
63
|
|
|
67
|
-
###
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
- **精准按需**:只有你点击「`📌 摆上桌面`」或「`📤 取出`」时才临时注入,点回封存即刻归零。
|
|
64
|
+
### 5. 子代理开了一堆,不知道谁卡住、谁在空转
|
|
65
|
+
- 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
|
|
66
|
+
- `dsh-chief` 的做法:任务页按主代理与子代理展开树状卡片,支持原地改状态、白话追问某一步、以及点击 `分屏` 直接拉起实时推理流;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
|
|
71
67
|
|
|
72
|
-
###
|
|
73
|
-
-
|
|
74
|
-
-
|
|
75
|
-
- **新会话一律只读**:只观察、只分析、只给方案,不碰工作区,也不接管主/子工作流。
|
|
76
|
-
- **动手前先申请**:改文件、跑命令、调度子代理这类操作,会弹 **「🛡️ 操作授权请求」**(做什么 / 对谁 / 为什么 / 影响),你点「允许本次操作」才执行。
|
|
77
|
-
- **高危档位二次确认**:给更高自主权之前,要先读 **「⚠️ 高权限模式风险告知」** 并勾选,后端再校验一次。
|
|
78
|
-
- **随时能收回**:红色 **「⏹ 急停」** 一按就切回人工接管,全程留下审计日志。
|
|
79
|
-
|
|
80
|
-
### 5. 多子代理黑盒迷宫 & 口头红线聊十轮就忘
|
|
81
|
-
- **普通插件**:窄视口列表反复拖拽,聊天里交代的红线随上下文滚出窗口。
|
|
82
|
-
- **`dsh-chief` 解法**:全铺开金字塔 DAG + 原生分屏看流 + **「`📌` 图钉全局红线」**跨任务永久生效,子代理撞墙主动呈批。
|
|
83
|
-
|
|
84
|
-
### 6. 换窗口就断档 & 后台偷偷按量计费
|
|
85
|
-
- **普通插件**:切窗口前情全丢;后台每轮乱跑总结,还常把订阅模型错配到高价按量渠道。
|
|
86
|
-
- **`dsh-chief` 解法**:默认 **`⏸ 按需`(0 后台自动调用)**,严格对齐主会话 `Provider · 模型`;支持跨窗互联、断联净化与一键携参谋部署接力。
|
|
68
|
+
### 6. 对话聊太长变慢变贵,换新窗口又得从头交代背景
|
|
69
|
+
- 常见状况:开了 100 轮想重开新窗口,却怕丢失背景、模型配置和刚梳理完的任务分工,或者后台总结插件偷偷走高价按量渠道。
|
|
70
|
+
- `dsh-chief` 的做法:默认 `⏸ 按需`(后台 0 自动调用),严格对齐主会话当前的 Provider 和模型;通过 `📌 定住防改` 锁定人工核对过的交接单,一键新建窗口接力时可选带入哪一层工作档案。
|
|
87
71
|
|
|
88
72
|
---
|
|
89
73
|
|
|
90
|
-
##
|
|
74
|
+
## 界面与功能说明
|
|
91
75
|
|
|
92
|
-
### 01 ·
|
|
93
|
-
-
|
|
94
|
-
-
|
|
95
|
-
-
|
|
76
|
+
### 01 · 参谋主面板(`参谋` 页签)
|
|
77
|
+
- 底部输入框可指派参谋查看代码、让主对话实施改动、手搓物理驻墙或整理档案,按钮统一居中下右下对齐不乱跑。左上角状态胶囊汇总了 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`(开启时会亮起红色胶囊和红盾图标)与当前权限档位,旁边就是红色 `⏹ 急停`。
|
|
78
|
+
- 开启「主动强介入」的确认窗会把当前生效的「物理驻墙」和「禁止红线」同框列出来(点「管理边界」或「一键收起/拉开」就能核对)。
|
|
79
|
+
- 对话区支持 `全部 / 💬 问答 / 📋 回执` 筛选,每一组问答和回执用高对比柔光外框包在一起,支持单组或一键全部收起/拉开;多条建议收拢在顶部 `▶ 执行建议`。参谋长在后台忙于自动审查、收档或手搓墙时,面板会自动切到对应页签,亮起流动渐变和双束跑马光线外框并用毛玻璃字样告诉你它正在干嘛。
|
|
96
80
|
|
|
97
|
-

|
|
98
82
|
|
|
99
83
|
---
|
|
100
84
|
|
|
101
|
-
### 02 ·
|
|
102
|
-
-
|
|
103
|
-
- **原地闭环操作**:每张节点卡直接集成「状态切换、白话解释、派发执行、对话拆解、`分屏` 实时盯流」。
|
|
85
|
+
### 02 · 主代理与子代理任务树(`任务` 页签)
|
|
86
|
+
- 按根会话与子代理纵队展开卡片,直接在卡片上调整状态、让人话解释某一步在干嘛、派发任务或点 `分屏` 看实时输出流。
|
|
104
87
|
|
|
105
88
|
<div align="center">
|
|
106
|
-
<img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 -
|
|
89
|
+
<img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - 任务树与子代理卡片" width="76%" />
|
|
107
90
|
</div>
|
|
108
91
|
|
|
109
92
|
---
|
|
110
93
|
|
|
111
|
-
### 03 ·
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
- **摆上桌面与双向差分**:全局与本地实时标记「已同步全局 / 本地已改 / 仅本地」;点击「`📌 摆上桌面`」才向主对话与参谋强调,并支持复选多卷「组合递话」。
|
|
94
|
+
### 03 · 三层本地冷档案柜(`档案` 页签)
|
|
95
|
+
- 分为三层:**💬 本会话档案柜**(按 `rootSessionId` 严格隔离,支持分柜与「一键收纳入柜」清空临时便签)、**🌐 全局档案柜**(跨会话对比差异,标记仅本地 / 已同步 / 本地已改)、**🏛️ 沉淀档案柜**(跨项目长期经验,默认双盲封存)。
|
|
96
|
+
- 卷宗按目录和金/银/铜曲别针分层收纳,只在点击 `📌 摆上桌面` 时临时放入主对话上下文。
|
|
115
97
|
|
|
116
98
|
<div align="center">
|
|
117
|
-
<img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 -
|
|
99
|
+
<img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层档案柜与双向差分" width="68%" />
|
|
118
100
|
</div>
|
|
119
101
|
|
|
120
102
|
---
|
|
121
103
|
|
|
122
|
-
### 04 ·
|
|
123
|
-
-
|
|
124
|
-
- **点击任意步骤追问**:小任务板每一行都支持菜单弹窗——当场让参谋长白话解读「为什么有这步」,绝不打断主对话。
|
|
104
|
+
### 04 · 目标锁定与步骤白话追问(`规划` 页签上方)
|
|
105
|
+
- 点击 `🎯 设为目标` 开启目标督导;任意计划步骤都可以点开直接问参谋「为什么有这一步、跳过会有什么影响」,不打断主对话正在跑的流程。
|
|
125
106
|
|
|
126
107
|
<div align="center">
|
|
127
|
-
<img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 -
|
|
108
|
+
<img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 目标督导与步骤追问" width="68%" />
|
|
128
109
|
</div>
|
|
129
110
|
|
|
130
111
|
---
|
|
131
112
|
|
|
132
|
-
### 05 ·
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
- **原图防幻觉机制**:输入栏粘贴/上传的截图原图落盘至 `<cwd>/.dsh-chief/uploads/`,纯文本参谋自动携带绝对路径降级交由主对话查看。
|
|
113
|
+
### 05 · 跨窗口协同串联与信箱(`协同` 页签)
|
|
114
|
+
- 可把多个独立 DSH 窗口连在一起互通进度;断开协同立即清掉缓存、外部记忆与离线信箱残留。
|
|
115
|
+
- 粘贴进输入框的截图原图会存进 `<cwd>/.dsh-chief/uploads/`,避免纯文本模型看图靠猜。
|
|
136
116
|
|
|
137
117
|
<div align="center">
|
|
138
|
-
<img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 -
|
|
118
|
+
<img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口协同与信箱" width="68%" />
|
|
139
119
|
</div>
|
|
140
120
|
|
|
141
121
|
---
|
|
142
122
|
|
|
143
|
-
### 06 · `📌`
|
|
144
|
-
-
|
|
145
|
-
-
|
|
123
|
+
### 06 · 物理驻墙、必做项与 `📌` 全局红线(`边界` 页签)
|
|
124
|
+
- 顶部新增「🧱 物理驻墙 · 事前硬拦截」专区:可点 `+ 手动驻墙` 或让 `✨ 参谋手搓墙`,随时把每堵墙设为 `🌐 全局`、`📁 本工程` 或 `⏸ 暂挂`;多条零散同类规则支持多选合并或 `✦ 一键合并`(跨类型规则会直接拦截提示,防止误混并)。
|
|
125
|
+
- 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏管理;点亮左侧 `📌` 图钉写入全局红线(所有新会话自动继承),不点图钉则只作用于当前会话,也接收子代理撞墙后呈交的边界提案。AI 工具永远无法私自删掉或关闭已落锁的物理墙与红线。
|
|
146
126
|
|
|
147
127
|
<div align="center">
|
|
148
|
-
<img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 -
|
|
128
|
+
<img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 边界规则与全局图钉红线" width="68%" />
|
|
149
129
|
</div>
|
|
150
130
|
|
|
151
131
|
---
|
|
152
132
|
|
|
153
|
-
### 07 ·
|
|
154
|
-
-
|
|
155
|
-
-
|
|
156
|
-
- **一键携参谋上任**:无缝继承参谋长专职模型与纪律配置(强介入默认安全置关),搭配 `idle-guard` 防任务半途空转停机。
|
|
133
|
+
### 07 · 跨会话交接单与携带参谋新开窗口(`规划` 页签底部)
|
|
134
|
+
- 交接单支持手改,点 `📌 定住防改` 后锁定当前快照,不会被后续自动摘要覆盖。
|
|
135
|
+
- 支持一键新开窗口并继承当前工作区 `workspaceId` 与参谋配置(高自主强介入默认安全置关),搭配 `idle-guard` 避免长任务空转停机。
|
|
157
136
|
|
|
158
137
|
<div align="center">
|
|
159
|
-
<img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 -
|
|
138
|
+
<img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话交接单与新开窗口部署" width="68%" />
|
|
160
139
|
</div>
|
|
161
140
|
|
|
162
141
|
---
|
|
163
142
|
|
|
164
|
-
##
|
|
143
|
+
## 使用前建议了解的两件事
|
|
165
144
|
|
|
166
|
-
> [!
|
|
167
|
-
>
|
|
145
|
+
> [!NOTE]
|
|
146
|
+
> 开启实权工具、`⚡ 主动强介入` 或 `✦ 智选压缩` 前,下面两点直接决定使用体感:
|
|
168
147
|
>
|
|
169
|
-
> 1.
|
|
170
|
-
>
|
|
171
|
-
>
|
|
172
|
-
> -
|
|
173
|
-
> 2. **切忌同时挂载过多“破坏对话模型脑子”的外部注入**
|
|
174
|
-
> - 请勿在主对话或项目里叠加上百行互殴的全局 System Prompt / Rules,或会每轮硬塞几千字旧账的传统常驻记忆插件。
|
|
175
|
-
> - **过多冗余注入会把模型的“脑子”搅浑、稀释当下注意力**,还极易与参谋长强介入指令冲突,引发死循环或提前熔断。
|
|
176
|
-
> - 保持外部提示词干净克制,低频资料交由本插件 **0-Token 冷库** 按需取出,才能发挥最大战力。
|
|
148
|
+
> 1. **工程护栏决定下限,底层模型决定上限**
|
|
149
|
+
> 插件负责保证 0-Token 冷隔离、四档权限审批、压缩前落盘复核、死循环熔断和 `⏹ 急停` 这些安全下限。但拆任务准不准、找 Bug 稳不稳,完全取决于你给参谋长选了哪个模型。处理复杂工程建议选推理能力强的主力旗舰模型,别用太轻的小模型。
|
|
150
|
+
> 2. **少叠互相冲突的外部常驻注入**
|
|
151
|
+
> 不要一边用本插件,一边在项目里叠加上百条互相对着干的全局 Rules 或每轮强灌大段旧账的记忆插件。无关上下文太多会稀释当前注意力,还容易和参谋的纠偏指令打架。低频资料放进本插件的 **0-Token 档案柜**,要查的时候再取出来用,主对话才干净。
|
|
177
152
|
|
|
178
153
|
---
|
|
179
154
|
|
|
180
|
-
##
|
|
155
|
+
## 模块结构与数据流 (`v1.4.0`)
|
|
156
|
+
|
|
157
|
+
`v1.4.0` 包含 **38 个后端模块(含 `pkg/safety/` 下 9 个零业务依赖的安全内核模块)+ 16 个前端模块**(无环依赖、无 `export let` 可变导出),方便审查与长期维护。详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
|
|
181
158
|
|
|
182
159
|
```mermaid
|
|
183
160
|
flowchart TB
|
|
184
|
-
subgraph UI["DSH
|
|
185
|
-
T1["
|
|
186
|
-
T2["
|
|
187
|
-
T3["
|
|
188
|
-
T4["
|
|
189
|
-
T5["三层 0-Token
|
|
190
|
-
T6["
|
|
161
|
+
subgraph UI["DSH 右侧常驻面板 (client.js <- 16 个前端模块)"]
|
|
162
|
+
T1["参谋页 (问答外框 + 权限 + 红盾哨兵 + 光效舞台)"]
|
|
163
|
+
T2["任务页 (主/子代理树 + 实时分屏)"]
|
|
164
|
+
T3["协同页 (跨窗联动 + 彩色信箱)"]
|
|
165
|
+
T4["规划页 (目标锁 + 定住交接单 + 携带部署)"]
|
|
166
|
+
T5["档案页 (三层 0-Token 冷库 + 一键收纳入柜)"]
|
|
167
|
+
T6["边界页 (动态物理驻墙 + 全局 📌 红线)"]
|
|
191
168
|
end
|
|
192
169
|
|
|
193
|
-
subgraph Core["
|
|
194
|
-
Hot["
|
|
195
|
-
|
|
196
|
-
|
|
170
|
+
subgraph Core["本地后端存储与安全内核 (零外部依赖 · 38 个后端模块)"]
|
|
171
|
+
Hot["热工作板: ~/.dsh/chief/board.json & boards/<sid>.json\n跨进程/工作线程 O_EXCL 自旋锁"]
|
|
172
|
+
Walls["动态物理驻墙: ~/.dsh/chief/guard-walls.json\n全局 / 本工程 / 暂挂三态"]
|
|
173
|
+
Cold["三层档案库: cabinets/ + global-vault/ + precipitated/"]
|
|
174
|
+
Bus["安全与调度: safety/*.js + chief-executor.js + taskLedger + chief-audit.jsonl"]
|
|
197
175
|
end
|
|
198
176
|
|
|
199
|
-
subgraph Agents["
|
|
200
|
-
Lead["
|
|
201
|
-
Subs["
|
|
202
|
-
Peers["
|
|
177
|
+
subgraph Agents["宿主执行代理 (tools/pre-execute 全员事前拦截)"]
|
|
178
|
+
Lead["主对话 (@lead)"]
|
|
179
|
+
Subs["子代理 (@arch / @dev / @bench)"]
|
|
180
|
+
Peers["跨窗口已串联会话"]
|
|
203
181
|
end
|
|
204
182
|
|
|
205
|
-
UI <-->|"
|
|
206
|
-
Hot -->|"
|
|
207
|
-
Hot -->|"
|
|
208
|
-
|
|
183
|
+
UI <-->|"27 条同源环回 API (/api/dsh-chief/*, guard fail-closed 403)"| Core
|
|
184
|
+
Hot -->|"紧凑热态势"| Lead
|
|
185
|
+
Hot -->|"紧凑热态势"| Subs
|
|
186
|
+
Walls -->|"事前物理阻断或单次弹窗询问"| Lead
|
|
187
|
+
Walls -->|"事前物理阻断或单次弹窗询问"| Subs
|
|
188
|
+
Cold -.->|"封存时 0 Token\n仅「📌 摆上桌面」或取出时注入"| Lead
|
|
209
189
|
Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
|
|
210
190
|
```
|
|
211
191
|
|
|
212
192
|
---
|
|
213
193
|
|
|
214
|
-
##
|
|
194
|
+
## 安装与宿主版本兼容
|
|
215
195
|
|
|
216
|
-
|
|
196
|
+
在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
|
|
217
197
|
|
|
218
198
|
```bash
|
|
219
|
-
# 方式 1:通过 npm
|
|
199
|
+
# 方式 1:通过 npm 安装最新版(v1.4.0)
|
|
220
200
|
dsh plugin --profile desktop add dsh-chief
|
|
221
201
|
|
|
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 仓库源码直接安装
|
|
202
|
+
# 方式 2:从 GitHub 仓库直接安装(与 main 最新代码同步)
|
|
226
203
|
dsh plugin --profile desktop add github:gluztm/dsh-chief
|
|
204
|
+
|
|
205
|
+
# 方式 3:安装 GitHub Release 预构建包(v1.4.0)
|
|
206
|
+
dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.4.0/dsh-chief-1.4.0.tgz
|
|
227
207
|
```
|
|
228
208
|
|
|
229
|
-
|
|
209
|
+
装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
|
|
230
210
|
|
|
231
|
-
###
|
|
211
|
+
### 宿主版本兼容表
|
|
232
212
|
|
|
233
|
-
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 /
|
|
213
|
+
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
|
|
234
214
|
| :--- | :---: | :---: | :--- |
|
|
235
|
-
| **`>= 0.2.2-rc.
|
|
236
|
-
| `0.2.
|
|
215
|
+
| **`>= 0.2.2-rc.5`(当前桌面主力版)** | 完整可用 | 完整可用 | 已适配 `dsh-tool-fs`(`read`/`read_image`/`write`/`edit`/`apply_patch`)、`str_replace_editor` 及 `tools/pre-execute` 原生 `{ kind: 'ask' }` 弹窗单次审批 |
|
|
216
|
+
| `0.2.2-rc.2 ~ 0.2.2-rc.4` | 完整可用 | 完整可用 | 宿主原生提供 `subagents.resolveName` / `rootOf` / `namesOf` 与 `tools/pre-execute` 物理拦截 |
|
|
217
|
+
| `0.2.0 ~ 0.2.2-rc.1` | 正常挂载 | 提示升级 | 旧版无命名子代理 API,面板会自动拦截高风险调用并提示升级 |
|
|
237
218
|
|
|
238
219
|
---
|
|
239
220
|
|
|
240
|
-
##
|
|
221
|
+
## 注册给模型的 4 个工具
|
|
241
222
|
|
|
242
|
-
|
|
223
|
+
插件只读注册 4 个结构化工具,动作参数一并兼容严格 JSON 与常见文本写法:
|
|
243
224
|
|
|
244
|
-
| 工具名 |
|
|
225
|
+
| 工具名 | 用途 | 常用动作 (`action`) |
|
|
245
226
|
| :--- | :--- | :--- |
|
|
246
|
-
| **`chief_board`** |
|
|
247
|
-
| **`chief_memory`** |
|
|
248
|
-
| **`chief_boundaries`** |
|
|
249
|
-
| **`chief_handoff`** |
|
|
227
|
+
| **`chief_board`** | 驱动任务板、检索冷档案、跨代理与直呼参谋、回复问询、查询物理墙、申请提权、触发压缩 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`chief.request`、`inquiry.reply`、`wall.list`、`archive.save`、`archive.search`、`bounds.propose`、`permission.request`、`context.compact` |
|
|
228
|
+
| **`chief_memory`** | 读写会话级热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
|
|
229
|
+
| **`chief_boundaries`** | 读写全局 `📌` 红线、必做项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
|
|
230
|
+
| **`chief_handoff`** | 预览并生成独立自包含的跨会话 Markdown 交接单 | `preview` / 会话接力 |
|
|
231
|
+
|
|
232
|
+
---
|
|
233
|
+
|
|
234
|
+
## 本地存储与安全边界
|
|
235
|
+
|
|
236
|
+
- **跨进程与多线程文件锁**:`board-store.js`、`chief-state.js`、`archive-core.js`、`safety/guard-walls.js` 对每次落盘使用带 `O_EXCL` 和随机抖动重试的文件锁(包含 Windows NTFS 瞬态 `EPERM/EACCES/EBUSY` 重试)以及 `threadId` 唯一临时文件原子替换,高并发写入不丢单。
|
|
237
|
+
- **独立安全内核与反变形检测**:`pkg/safety/`(9 模块)与 `chief-executor.js` 全集通过 MD5 校验守护,覆盖复合管道、内联脚本(`node -e` / `python -c` / `pwsh` / `iex` + Base64)、引号多反斜杠与点号反斜杠凭据变形、`bounds.*` / 物理驻墙人类确认令牌以及单次授权 `capabilityScope` 绑定,正常 `process.env.NODE_ENV` 与 `node .\env\setup.js` 零误杀。
|
|
238
|
+
- **27 条接口同源环回校验**:全部 `/api/dsh-chief/*` 接口先校验 Loopback 来源与 `Origin/Host`,连接守卫异常时 fail-closed 返回 `403`。
|
|
239
|
+
- **凭据防误存与零遥测**:禁止写入 `sk-*`、`ghp_*`、Bearer Token、`AIza*`、`AKIA*` 与私钥片段;一键收纳含疑似密钥的便签会自动脱敏为 `[REDACTED]`。所有状态、档案、物理驻墙与审计日志完全留在本地 `~/.dsh/chief/`,零外部依赖,零遥测上报。
|
|
250
240
|
|
|
251
241
|
---
|
|
252
242
|
|
|
253
|
-
##
|
|
243
|
+
## 贡献者
|
|
254
244
|
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
-
|
|
245
|
+
| 贡献者 | 主要工作 |
|
|
246
|
+
| --- | --- |
|
|
247
|
+
| [gluztm](https://github.com/gluztm) | 项目发起人、产品定义与长期维护 |
|
|
248
|
+
| [Gemini](https://github.com/gemini-code-assist) | 功能研发、`pkg/safety/` 独立安全内核、事前物理驻墙、懒介入协同与自动化门禁实现 |
|
|
249
|
+
| [Codex](https://github.com/codex) | 模块化架构设计、高并发压测、红队穿透测试与边界审查 |
|
|
250
|
+
| [deepseek-ai](https://github.com/deepseek-ai) | DeepSeek Harness 宿主运行时与 SuperAgent 协同机制支持 |
|
|
259
251
|
|
|
260
252
|
---
|
|
261
253
|
|
|
262
|
-
##
|
|
254
|
+
## 开源协议
|
|
263
255
|
|
|
264
|
-
基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)**
|
|
256
|
+
基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源。
|
package/api-routes.js
CHANGED
|
@@ -34,6 +34,7 @@ import {
|
|
|
34
34
|
handleApprovalDecision,
|
|
35
35
|
handleElevationDecision,
|
|
36
36
|
} from './chief.js'
|
|
37
|
+
import { getChiefActiveWork } from './chief-state.js'
|
|
37
38
|
import {
|
|
38
39
|
resolveProjectKey,
|
|
39
40
|
getArchiveMeta,
|
|
@@ -48,7 +49,11 @@ import {
|
|
|
48
49
|
mutatePrecipitated,
|
|
49
50
|
copyPrecipitatedToVault,
|
|
50
51
|
} from './archives.js'
|
|
51
|
-
import {
|
|
52
|
+
import {
|
|
53
|
+
DEFAULT_CHIEF_PERMISSION_MODE,
|
|
54
|
+
HUMAN_BOUNDS_CONFIRM_TOKEN,
|
|
55
|
+
listGuardWalls,
|
|
56
|
+
} from './chief-executor.js'
|
|
52
57
|
import {
|
|
53
58
|
API,
|
|
54
59
|
BACKEND_BUILD,
|
|
@@ -264,9 +269,12 @@ export function createApiRoutes(deps) {
|
|
|
264
269
|
paceMode: effCfg.paceMode || 'manual',
|
|
265
270
|
stopped: Boolean(effCfg.stopped || effCfg.paceMode === 'stopped'),
|
|
266
271
|
permissionMode: effCfg.permissionMode || DEFAULT_CHIEF_PERMISSION_MODE,
|
|
272
|
+
capabilities: effCfg.capabilities || {},
|
|
273
|
+
policyPluginsCount: Array.isArray(effCfg.policyPlugins) ? effCfg.policyPlugins.length : 0,
|
|
267
274
|
chiefRiskAcknowledged: Boolean(effCfg.chiefRiskVerified),
|
|
268
275
|
pendingApprovalsCount: ((rootWs && Array.isArray(rootWs.pendingApprovals)) ? rootWs.pendingApprovals : []).filter(a => a && a.status === 'pending').length,
|
|
269
276
|
hasPendingElevation: Boolean(rootWs && rootWs.pendingElevation && rootWs.pendingElevation.status === 'pending'),
|
|
277
|
+
auditLog: ((rootWs && Array.isArray(rootWs.auditLog)) ? rootWs.auditLog : []).slice(-50).reverse(),
|
|
270
278
|
autoPilot: Boolean(effCfg.autoPilot),
|
|
271
279
|
tacticalModes,
|
|
272
280
|
runtimeGuard: (rootWs && rootWs.runtimeGuard) || {},
|
|
@@ -278,9 +286,11 @@ export function createApiRoutes(deps) {
|
|
|
278
286
|
factsCount,
|
|
279
287
|
mailboxCount,
|
|
280
288
|
linkedPeersCount: Math.max(0, cluster.length - 1),
|
|
289
|
+
activeWork: getChiefActiveWork(rootSid),
|
|
281
290
|
contextUsage: sessionId ? getSessionContextBreakdown(runtime, sessionId) : null,
|
|
282
291
|
},
|
|
283
292
|
archiveMeta,
|
|
293
|
+
guardWalls: listGuardWalls({ cwd: sessionArchOpt.cwd }),
|
|
284
294
|
})
|
|
285
295
|
} catch (error) {
|
|
286
296
|
sendJson(res, 500, { ok: false, error: String(error && error.message ? error.message : error) })
|
|
@@ -471,14 +481,21 @@ export function createApiRoutes(deps) {
|
|
|
471
481
|
})
|
|
472
482
|
return
|
|
473
483
|
}
|
|
474
|
-
const result = runAction(
|
|
484
|
+
const result = runAction({
|
|
485
|
+
...(body && typeof body === 'object' ? body : {}),
|
|
486
|
+
_callerOrigin: 'human_ui',
|
|
487
|
+
_humanConfirmToken: HUMAN_BOUNDS_CONFIRM_TOKEN,
|
|
488
|
+
})
|
|
475
489
|
const mergedBoard = result.ok && result.board && sessionId
|
|
476
490
|
? boardForSession(boardFileFor(sessionId))
|
|
477
491
|
: result.board
|
|
478
492
|
const subagents = sessionId && mergedBoard ? await refreshSubagentTree(runtime, sessionId, mergedBoard) : []
|
|
493
|
+
let actionCwd = process.cwd()
|
|
494
|
+
try { actionCwd = archiveTarget(runtime, sessionId, { vaultScope: 'session' }).cwd || actionCwd } catch {}
|
|
479
495
|
sendJson(res, result.ok ? 200 : 400, {
|
|
480
496
|
...result,
|
|
481
497
|
...(mergedBoard ? { board: mergedBoard } : {}),
|
|
498
|
+
...(Array.isArray(result.guardWalls) ? {} : { guardWalls: listGuardWalls({ cwd: actionCwd }) }),
|
|
482
499
|
subagents,
|
|
483
500
|
boundaries: boundaries(runtime, sessionId),
|
|
484
501
|
})
|
package/board-actions.js
CHANGED
|
@@ -24,7 +24,13 @@ import {
|
|
|
24
24
|
getTakenOutGlobalForSession,
|
|
25
25
|
getFlippedOutPrecipitatedForSession,
|
|
26
26
|
} from './archives.js'
|
|
27
|
-
import {
|
|
27
|
+
import {
|
|
28
|
+
DEFAULT_CHIEF_PERMISSION_MODE,
|
|
29
|
+
normalizePermissionMode,
|
|
30
|
+
verifyBoundsWriteAuth,
|
|
31
|
+
listGuardWalls,
|
|
32
|
+
mutateGuardWalls,
|
|
33
|
+
} from './chief-executor.js'
|
|
28
34
|
import {
|
|
29
35
|
enforceAnchorCap,
|
|
30
36
|
STATUSES,
|
|
@@ -675,6 +681,15 @@ export function createBoardActions(deps) {
|
|
|
675
681
|
}
|
|
676
682
|
|
|
677
683
|
if (action === 'bounds.set') {
|
|
684
|
+
const auth = verifyBoundsWriteAuth({
|
|
685
|
+
action,
|
|
686
|
+
field: args.field,
|
|
687
|
+
callerOrigin: args._callerOrigin || '',
|
|
688
|
+
humanConfirmToken: args._humanConfirmToken || null,
|
|
689
|
+
})
|
|
690
|
+
if (!auth.ok) {
|
|
691
|
+
return { ok: false, blockedBySafetyGuard: true, rule: auth.rule, error: auth.error }
|
|
692
|
+
}
|
|
678
693
|
const current = board.bounds || { allowed: [], forbidden: [], notes: [] }
|
|
679
694
|
// A partial list that looks complete is the worst of the three options: the
|
|
680
695
|
// caller walks away believing it imposed 25 restrictions while the board
|
|
@@ -719,6 +734,15 @@ export function createBoardActions(deps) {
|
|
|
719
734
|
}
|
|
720
735
|
|
|
721
736
|
if (action === 'bounds.add' || action === 'bounds.pin' || action === 'bounds.remove' || action === 'bounds.edit' || action === 'bounds.consolidate') {
|
|
737
|
+
const auth = verifyBoundsWriteAuth({
|
|
738
|
+
action,
|
|
739
|
+
field: args.field,
|
|
740
|
+
callerOrigin: args._callerOrigin || '',
|
|
741
|
+
humanConfirmToken: args._humanConfirmToken || null,
|
|
742
|
+
})
|
|
743
|
+
if (!auth.ok) {
|
|
744
|
+
return { ok: false, blockedBySafetyGuard: true, rule: auth.rule, error: auth.error }
|
|
745
|
+
}
|
|
722
746
|
const col = normalizeBoundFieldName(args.field)
|
|
723
747
|
if (!col) {
|
|
724
748
|
return { ok: false, error: 'bounds operation requires field: allowed (必做) | forbidden (禁止) | notes (注意)' }
|
|
@@ -935,6 +959,53 @@ export function createBoardActions(deps) {
|
|
|
935
959
|
return clipped({ ok: true, cursor: current, board: saveBoard(board, file) }, clips)
|
|
936
960
|
}
|
|
937
961
|
|
|
962
|
+
if (action === 'wall.list') {
|
|
963
|
+
const targetCwd = session ? getSessionCwd(deps.hostState && deps.hostState.activeRuntime, session) : process.cwd()
|
|
964
|
+
return {
|
|
965
|
+
ok: true,
|
|
966
|
+
guardWalls: listGuardWalls({ cwd: targetCwd }),
|
|
967
|
+
board: loadBoard(file),
|
|
968
|
+
}
|
|
969
|
+
}
|
|
970
|
+
|
|
971
|
+
if (action === 'wall.save' || action === 'wall.setScope' || action === 'wall.remove' || action === 'wall.merge') {
|
|
972
|
+
const targetCwd = session ? getSessionCwd(deps.hostState && deps.hostState.activeRuntime, session) : process.cwd()
|
|
973
|
+
const op = action === 'wall.save'
|
|
974
|
+
? 'save'
|
|
975
|
+
: (action === 'wall.setScope'
|
|
976
|
+
? 'set_scope'
|
|
977
|
+
: (action === 'wall.merge' ? 'merge' : 'remove'))
|
|
978
|
+
const res = mutateGuardWalls({
|
|
979
|
+
op,
|
|
980
|
+
wall: (args.wall && typeof args.wall === 'object') ? args.wall : args,
|
|
981
|
+
wallId: args.wallId !== undefined ? args.wallId : args.id,
|
|
982
|
+
wallIds: Array.isArray(args.wallIds) ? args.wallIds : [],
|
|
983
|
+
autoGroup: Boolean(args.autoGroup),
|
|
984
|
+
title: typeof args.title === 'string' ? args.title : '',
|
|
985
|
+
scope: args.scope,
|
|
986
|
+
cwd: targetCwd,
|
|
987
|
+
callerOrigin: args._callerOrigin || '',
|
|
988
|
+
humanConfirmToken: args._humanConfirmToken || null,
|
|
989
|
+
})
|
|
990
|
+
if (!res.ok) return res
|
|
991
|
+
const actionLabel = op === 'remove'
|
|
992
|
+
? `移除物理驻墙 ${args.wallId || args.id || ''}`
|
|
993
|
+
: (op === 'merge'
|
|
994
|
+
? `合并同类物理驻墙(${res.mergedCount || 0} 条合为 ${res.createdCount || 1} 条)`
|
|
995
|
+
: (op === 'set_scope'
|
|
996
|
+
? `切换物理驻墙「${(res.wall && res.wall.title) || ''}」状态为 ${args.scope}`
|
|
997
|
+
: `驻防物理墙「${(res.wall && res.wall.title) || ''}」(${res.wall && res.wall.scope === 'workspace' ? '本工程' : (res.wall && res.wall.scope === 'paused' ? '暂挂' : '全局常驻')})`))
|
|
998
|
+
pushLog(board, '🧱 ' + actionLabel, by, session)
|
|
999
|
+
return {
|
|
1000
|
+
ok: true,
|
|
1001
|
+
mergedCount: res.mergedCount || 0,
|
|
1002
|
+
createdCount: res.createdCount || 0,
|
|
1003
|
+
wall: res.wall,
|
|
1004
|
+
guardWalls: res.walls,
|
|
1005
|
+
board: saveBoard(board, file),
|
|
1006
|
+
}
|
|
1007
|
+
}
|
|
1008
|
+
|
|
938
1009
|
if (action === 'note.unpin') {
|
|
939
1010
|
const id = str(args.noteId !== undefined ? args.noteId : args.id, '')
|
|
940
1011
|
const note = board.notes.find(item => item.id === id)
|