dsh-chief 1.5.0 → 1.7.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 +63 -0
- package/README.en.md +281 -129
- package/README.md +286 -134
- package/api-routes.js +232 -2
- package/board-actions.js +1452 -2005
- package/board-handoff.js +709 -0
- package/board-schema.js +365 -7
- package/chief-approvals.js +6 -2
- package/chief-archives.js +1 -0
- package/chief-commands.js +1884 -3484
- package/chief-compaction.js +1 -0
- package/chief-executor.js +6 -1
- package/chief-models.js +112 -5
- package/chief-network.js +1098 -869
- package/chief-review.js +448 -51
- package/chief-state.js +1996 -2523
- package/chief-view.js +10 -4
- package/client.js +20318 -11591
- package/command-helpers.js +568 -0
- package/command-ops.js +1226 -0
- package/digest.js +29 -4
- package/idle-guard.js +233 -8
- package/index.js +6 -0
- package/locale/en.json +72 -1
- package/locale/zh.json +72 -1
- package/model-tools.js +46 -3
- package/network-harness.js +1047 -0
- package/package.json +13 -5
- package/runtime-hooks.js +316 -14
- package/safety/guard-walls.js +5 -0
- package/safety/invariant-guards.js +126 -6
- package/safety/tool-gate.js +2 -0
- package/state-media.js +173 -0
- package/state-schema.js +1505 -0
- package/subagent-runtime.js +85 -4
package/README.md
CHANGED
|
@@ -1,153 +1,165 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
**给 DeepSeek Harness(DSH)用的右侧栏任务看护、认知桌面、事前物理驻墙与多代理管控面板**
|
|
4
|
-
<sub>长对话 `/compact` 前先存参数再压缩,子代理金字塔一屏看完,改文件跑命令前先过物理墙与逐项审批。</sub>
|
|
5
|
-
|
|
6
|
-
<img src="assets/chief-10s-compare.gif" alt="对比原生长会话与挂载 dsh-chief 后的效果:左边循环重读、压缩丢参数、跨窗失忆;右边先入柜再压缩、可随时熔断、带交接单换窗继续" width="800" />
|
|
7
|
-
|
|
8
|
-
<sub>默认只读起手 · 越权操作前先确认 · `dsh plugin --profile desktop add dsh-chief`</sub>
|
|
9
|
-
|
|
10
|
-
<br />
|
|
11
|
-
|
|
12
|
-
<img src="assets/v150-highlights.png" alt="dsh-chief v1.5.0 核心新特性实机一览:180° 扇形思考强度表盘、托管梦境漫游毛玻璃单击即穿透、认知桌面与俯视角一沓纸档案柜、事前物理驻墙硬拦截" width="100%" />
|
|
13
|
-
|
|
14
|
-
<br />
|
|
15
|
-
|
|
16
|
-
<img src="assets/hero-banner.png" alt="dsh-chief 面板主视图" width="100%" />
|
|
17
|
-
|
|
18
|
-
<br />
|
|
19
|
-
|
|
20
3
|
# DSH 参谋长 (`dsh-chief`)
|
|
21
|
-
|
|
4
|
+
**DeepSeek Harness(DSH)参谋长插件:支持右侧栏与主页面大屏双模式,默认按需启用不打扰普通会话,管任务拓扑、档案记忆、本机外协与执行前物理防线。**
|
|
22
5
|
|
|
23
6
|
[](https://dsh.deepseek.com)
|
|
24
7
|
[](https://github.com/gluztm/dsh-chief/releases)
|
|
25
8
|
[](https://www.npmjs.com/package/dsh-chief)
|
|
26
9
|
[](https://github.com/gluztm/dsh-chief/actions/workflows/ci.yml)
|
|
27
10
|
[](https://awesome-dsh-plugin.com/p/gluztm/dsh-chief/)
|
|
28
|
-
[](https://www.bilibili.com/video/
|
|
11
|
+
[](https://www.bilibili.com/video/BV1Fksq6iEw8)
|
|
29
12
|
[](https://github.com/deepseek-ai/dsh-superagent-prototype)
|
|
30
13
|
[](https://nodejs.org)
|
|
31
14
|
[](#)
|
|
32
15
|
[](LICENSE)
|
|
33
16
|
|
|
34
|
-
|
|
35
|
-
> 协同结构参考官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的 Router + Workers 分工模型,保持侧边栏状态与主对话上下文相互隔离。
|
|
17
|
+
<img src="assets/chief-10s-compare.gif" alt="原生长会话与挂载 dsh-chief v1.6.0 对比:右侧显示 5 页签面板、流程画布、15% 认知桌面、30 次预算上限和执行前拦截规则" width="840" />
|
|
36
18
|
|
|
37
|
-
|
|
19
|
+
<sub>新对话默认只读 · 改文件前先问你 · 一条命令安装</sub>
|
|
38
20
|
|
|
39
|
-
[
|
|
21
|
+
**简体中文** · [English (`README.en.md`)](README.en.md) · [演进之路 (`EVOLUTION.md`)](EVOLUTION.md) · [更新日志 (`CHANGELOG.md`)](CHANGELOG.md) · [架构设计 (`ARCHITECTURE.md`)](ARCHITECTURE.md)
|
|
22
|
+
|
|
23
|
+
[这是什么](#这是什么) · [3 分钟上手](#3-分钟上手) · [选哪个预设](#我该选哪个预设) · [界面](#界面长什么样) · [名词小词典](#名词小词典) · [常见问题](#常见问题) · [进阶](#进阶给想深入了解的人)
|
|
40
24
|
|
|
41
25
|
</div>
|
|
42
26
|
|
|
43
27
|
---
|
|
44
28
|
|
|
45
|
-
##
|
|
29
|
+
## 这是什么?
|
|
30
|
+
|
|
31
|
+
在 DeepSeek Harness(DSH)里,中间主对话窗口的 AI 负责给你看代码、改文件、跑命令。`DSH 参谋长` 是挂在右边栏的一位「助理兼安全员」:平时不抢主对话的活,只在旁边帮你记路径笔记、把长任务拆成步骤盯着推进,在 AI 动你的文件或跑终端命令之前先检查一道。
|
|
32
|
+
|
|
33
|
+
新对话里它默认只看不改,不会自己动手修改工程。
|
|
34
|
+
|
|
35
|
+
**适合谁用**:在 DSH 里跑长任务、怕 AI 失手删改文件,或者聊太长一压缩就把前面查到的路径和报错忘光的人。
|
|
46
36
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
37
|
+
```mermaid
|
|
38
|
+
flowchart LR
|
|
39
|
+
U["你 (下达任务)"] --> L["主对话 AI 干活"]
|
|
40
|
+
L --> C{"要改文件或跑命令"}
|
|
41
|
+
C --> G["参谋长先检查"]
|
|
42
|
+
G --> A["安全:直接放行"]
|
|
43
|
+
G --> B["有风险:弹窗问你"]
|
|
44
|
+
G --> D["碰红线:直接拦下"]
|
|
45
|
+
G -.-> M["顺便记笔记、盯进度"]
|
|
46
|
+
```
|
|
51
47
|
|
|
52
48
|
---
|
|
53
49
|
|
|
54
|
-
##
|
|
50
|
+
## 一句话看懂
|
|
55
51
|
|
|
56
|
-
|
|
52
|
+
- **默认按需启用,不打扰普通会话**:全新聊天窗口默认零侵入(不注提示词、不触发安全拦截、不留垃圾文件),点「在本会话启用」或使用参谋能力才加载,也可在设置里一键改回全自动开启。
|
|
53
|
+
- **压缩前先存档**:对话快满时,先把路径、命令和报错记进本地档案,再调用 `/compact`。
|
|
54
|
+
- **不让任务半途而废**:锁定目标后,模型中途停下会被提醒继续;同一个错连续 3 次就停下。
|
|
55
|
+
- **改文件、跑命令前先过一道检查**:已启用会话里命中「物理驻墙」(执行前的拦截规则)就拦下,或弹窗问你。
|
|
56
|
+
- **默认只读**:启用参谋后新对话里仍默认只看不改,权限需要你手动调高(`L0`–`L3`)。
|
|
57
|
+
- **记忆不白耗 Token**:只有放上「认知桌面」的资料(最多 `2,400 Tokens / 6 份`)每轮发给模型,其余用到时再查。
|
|
58
|
+
- **主页面 + 右侧栏双布局,子代理协同直连**:对话顶部一键切大屏 `参谋长` 主页面(自动藏起下方重复主框),协同页可直连本机 `Codex` / `Claude Code` 并在当前右侧栏加页签查看子代理。
|
|
57
59
|
|
|
58
|
-
|
|
59
|
-
- 常见状况:对话一长触发压缩,刚找到的配置路径、端口、报错行号和回滚命令全被摘要吃掉,模型回头重读文件、重新踩坑。
|
|
60
|
-
- `dsh-chief` 的做法:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也支持直接在右侧输入「压缩吧」。
|
|
61
|
-
- 压缩顺序固定为「先抢救细节并校验写入本会话档案柜 → 再静默调用宿主 `/compact`」。如果没产生历史消息或压缩报错,计数绝不虚增。
|
|
60
|
+
---
|
|
62
61
|
|
|
63
|
-
|
|
64
|
-
- 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
|
|
65
|
-
- `dsh-chief` 的做法:必须先填并锁定核心目标,再开启 `⚡ 主动强介入`(`0 = ♾️` 无限轮自动续推,自带同报错 3 轮防死循环熔断);在 `🛡 巡检` / `🤖 托管` 下断流自动过墙唤醒续跑,`L3 + 强介入` 还可安全批量收口并产出「🏁 一站式战报」,未通过核验并经你 `✅ 批准结项` 绝不虚报完工。
|
|
66
|
-
- 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
|
|
62
|
+
## 3 分钟上手
|
|
67
63
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
64
|
+
1. **安装插件**(网页版把下面命令里的 `desktop` 换成 `web`;也可以直接在 DSH 插件市场搜 `dsh-chief`):
|
|
65
|
+
```bash
|
|
66
|
+
dsh plugin --profile desktop add dsh-chief
|
|
67
|
+
```
|
|
68
|
+
2. **打开面板**:重启或刷新 DSH,点工作区右上角的 `✦ DSH 参谋长` 图标。
|
|
69
|
+
3. **选一个预设**:点顶栏的 `⚙️` 图标,新手建议先用 **🤝 日常协作**(不选也行,新对话默认就是只看不改)。
|
|
70
|
+
4. **正常对话**:主窗口里照常让 AI 干活;想让参谋专门查东西、起草拦截规则或整理笔记,就在右侧面板底部输入框用大白话吩咐。
|
|
71
|
+
5. **随时叫停**:发现不对劲,直接点输入栏最右侧红色的 `⏹ 急停` 按钮。
|
|
71
72
|
|
|
72
|
-
|
|
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 策略插件进一步限缩工具或目录。
|
|
73
|
+
---
|
|
79
74
|
|
|
80
|
-
|
|
81
|
-
- 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
|
|
82
|
-
- `dsh-chief` 的做法:任务页按主代理与子代理展开直观金字塔树状卡片,支持原地改状态、点击 `💬 分屏` 直接看实时修改流、点底栏带图标代理发 `@递话` 精准纠偏;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
|
|
75
|
+
## 我该选哪个预设?
|
|
83
76
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
77
|
+
点顶栏 `⚙️` 设置图标就能直接切换这三档预设:
|
|
78
|
+
|
|
79
|
+
| 你的情况 | 选这个 | 它会做什么 | 会不会花额外的钱 |
|
|
80
|
+
| :--- | :--- | :--- | :--- |
|
|
81
|
+
| 只想先看看,不想它碰任何东西 | `👁 只读旁观`(`L0 · 关停`) | 只看不改,你问它才回答 | 不会主动调用后台模型 |
|
|
82
|
+
| 平时写代码、做日常任务(推荐) | `🤝 日常协作`(`L2 · 巡检`,开红线哨兵) | 报错或被规则拦住时才介入,重要写改逐项弹窗问你 | 空闲时不调用后台模型 |
|
|
83
|
+
| 要离开电脑,让它自己跑完 | `🚀 离桌托管`(`L3 · 托管`) | 持续盯进度,80% 自动压缩,关键节点发通知(切换时需双重确认) | 会调用,默认 30 次或 300K Token 后自动停 |
|
|
87
84
|
|
|
88
85
|
---
|
|
89
86
|
|
|
90
|
-
##
|
|
87
|
+
## 界面长什么样
|
|
88
|
+
|
|
89
|
+
<img src="assets/hero-banner.png" alt="dsh-chief 面板主视图" width="100%" />
|
|
90
|
+
|
|
91
|
+
右侧栏收成 5 个页签加 1 个顶栏设置页,各自管一块:
|
|
92
|
+
|
|
93
|
+
| 位置 | 在这里做什么 |
|
|
94
|
+
| :--- | :--- |
|
|
95
|
+
| `参谋` 页签 | 用大白话给参谋发指令,调权限/托管挡位,看复盘战报和点 `⏹ 急停`。 |
|
|
96
|
+
| `任务` 页签 | 锁定核心目标,在「流程画布」和「组织树」看进度,点步骤「解释」,导出交接单。 |
|
|
97
|
+
| `协同` 页签 | 用「协同系统」连线编队主/子代理、跨窗口与本机 `Codex` / `Claude Code`,支持刷新扫休眠窗与跨窗信箱。 |
|
|
98
|
+
| `档案` 页签 | 管理置顶「认知桌面」和三层档案抽屉,控制哪些背景资料发给主对话。 |
|
|
99
|
+
| `边界` 页签 | 配置「物理驻墙」(执行前拦截规则)、必做检查和全局红线。 |
|
|
100
|
+
| 顶栏 `⚙️ 设置` | 选 3 档预设、切换主页面/右侧栏、设本会话与新会话启用开关、配置告警预算与中英文。 |
|
|
91
101
|
|
|
92
|
-
### 01 ·
|
|
93
|
-
|
|
94
|
-
|
|
102
|
+
### 01 · 参谋主面板(`参谋` 页签)
|
|
103
|
+
**一句话**:在这里用大白话给参谋发指令、调权限与托管挡位,急了直接点红色急停。
|
|
104
|
+
|
|
105
|
+
- 底部输入框用来委派探路、让参谋起草物理驻墙或整理档案;左下控制条放了 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`、`L0–L3` 权限和红色 `⏹ 急停`;顶栏管 `⏸ 关停 / 🛡 巡检 / 🤖 托管` 与模型/扇形思考强度。
|
|
106
|
+
- 后台运行「🌙 梦境漫游」或自动审查时,面板会出现彩色外框和半透明毛玻璃遮罩。**点一下遮罩任意位置就能收起模糊遮罩恢复操作,外框继续亮着提示后台还在跑**。
|
|
95
107
|
|
|
96
108
|

|
|
97
109
|
|
|
98
|
-
|
|
110
|
+
### 02 · 流程画布与组织树(`任务` 页签)
|
|
111
|
+
**一句话**:用「流程画布」看步骤和回指关系,点 `👑 主代理` 整卡展开或收起子代理「组织树」。
|
|
99
112
|
|
|
100
|
-
|
|
101
|
-
- 按根会话与子代理纵队展开可视化金字塔卡片(配主/子代理前置矢量图标),直接在卡片上调整状态、派发任务或点 `分屏` 看实时输出流。
|
|
113
|
+
- 支持在「**流程画布**」(主干步骤 + 子代理分支 + 跨步异常虚线回指弧)和「**组织树**」(默认单行收起省空间,点击整张主代理卡片展开/收起下属 `@subagent` 详情)之间切换,下方接推进任务板、`分屏` 实时流和跨会话交接。
|
|
102
114
|
|
|
103
115
|
<div align="center">
|
|
104
116
|
<img src="assets/screenshots/02-full-spread-pyramid-dag.png" alt="02 - 任务树与子代理卡片" width="80%" />
|
|
105
117
|
</div>
|
|
106
118
|
|
|
107
|
-
|
|
119
|
+
### 03 · 认知桌面与三层档案柜(`档案` 页签)
|
|
120
|
+
**一句话**:只把最常用的几份放上「认知桌面」,其余分三层收进抽屉按钩子按需取用。
|
|
108
121
|
|
|
109
|
-
|
|
110
|
-
-
|
|
111
|
-
- 三层抽屉采用俯视角「一沓纸」动态卡片:平时叠放仅露标题与关键词 `🪝` 钩子,点开才展开操作栏与详情,谁能看、谁已拉阅一目了然。
|
|
122
|
+
- 顶部是置顶 `📌 认知桌面` 和 `2,400 Tokens / 6 份` 实时进度条(这是唯一每轮随对话注入主模型的地方,超出按优先级自动退入观察队列);下面是 **💬 本局档案柜**、**🌐 全局档案柜**、**🏛️ 冷藏档案柜**。
|
|
123
|
+
- 三层抽屉采用叠放卡片样式:平时只露标题和 `🪝` 关键词钩子,点开后显示详情、操作栏以及已被哪些代理拉阅。
|
|
112
124
|
|
|
113
125
|
<div align="center">
|
|
114
126
|
<img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层档案柜与认知桌面" width="90%" />
|
|
115
127
|
</div>
|
|
116
128
|
|
|
117
|
-
|
|
129
|
+
### 04 · 目标锁定与步骤「解释」(`任务` 页签)
|
|
130
|
+
**一句话**:先点 `🎯 设为目标` 锁住方向,碰到看不懂的步骤点「解释」让参谋翻成大白话。
|
|
118
131
|
|
|
119
|
-
|
|
120
|
-
- 点击 `🎯 设为目标` 开启目标督导(开强介入前必锁);任意步骤都可点击「解释」让参谋长用通俗大白话解释这条在干嘛、跳过有何影响,全程零打断主对话流程。
|
|
132
|
+
- 顶部点 `🎯 设为目标` 开启目标督导(开强介入前必须锁定),下面接可折叠拓扑图和推进任务板;任意步骤都能点「解释」,让参谋用通俗语言说清这步在做什么、跳过有什么影响,不会打断主对话正在跑的流程。
|
|
121
133
|
|
|
122
134
|
<div align="center">
|
|
123
135
|
<img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 目标督导与步骤追问" width="68%" />
|
|
124
136
|
</div>
|
|
125
137
|
|
|
126
|
-
|
|
138
|
+
### 05 · 跨窗口协同与信箱(`协同` 页签)
|
|
139
|
+
**一句话**:把几个独立打开的 DSH 窗口连起来互通进度,断开就清掉缓存和信箱。
|
|
127
140
|
|
|
128
|
-
|
|
129
|
-
-
|
|
130
|
-
- 粘贴进输入框的截图原图会存进 `<cwd>/.dsh-chief/uploads/`,避免纯文本模型看图靠猜。
|
|
141
|
+
- 支持把多个独立的 DSH 窗口连起来互通进度和接口约定(前后端联动);断开协同会清掉缓存、外部记忆与离线信箱残留。
|
|
142
|
+
- 粘贴进输入框的截图原图会存进 `<cwd>/.dsh-chief/uploads/`,避免纯文本模型靠猜。
|
|
131
143
|
|
|
132
144
|
<div align="center">
|
|
133
145
|
<img src="assets/screenshots/05-cross-session-collab-bus.png" alt="05 - 跨窗口协同与信箱" width="68%" />
|
|
134
146
|
</div>
|
|
135
147
|
|
|
136
|
-
|
|
148
|
+
### 06 · 物理驻墙、必做项与全局红线(`边界` 页签)
|
|
149
|
+
**一句话**:把不能碰的文件或命令写进顶部「物理驻墙」,在执行前直接拦住,下面分三栏管日常规矩。
|
|
137
150
|
|
|
138
|
-
|
|
139
|
-
-
|
|
140
|
-
- 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏管理;任何 `L0–L3` 权限都无权私拆物理墙与红线,真撞死仅能提交人类审批单。
|
|
151
|
+
- 顶部「🧱 物理驻墙」区支持 `+ 手动驻墙` 或 `✨ 参谋手搓墙`,可以切 `🌐 全局`、`📁 本工程`、`⏸ 暂挂`,同类规则可一键合并。
|
|
152
|
+
- 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏;`L0–L3` 模型都无权私自删掉锁定的驻墙与红线,真撞死只能提交审批单等你点允许。
|
|
141
153
|
|
|
142
154
|
<div align="center">
|
|
143
155
|
<img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 边界规则与全局图钉红线" width="68%" />
|
|
144
156
|
</div>
|
|
145
157
|
|
|
146
|
-
|
|
158
|
+
### 07 · 顶栏设置页:情景预设、显示位置、按需开关与托管预算(`⚙️` 设置页)
|
|
159
|
+
**一句话**:点顶栏齿轮 `⚙️` 一键选预设、调整主页面/右侧栏/子代理打开方式、控制普通窗口是否启用,或配桌面提醒和预算上限。
|
|
147
160
|
|
|
148
|
-
|
|
149
|
-
-
|
|
150
|
-
- 支持一键新开窗口并继承当前工作区 `workspaceId`、参谋配置与指定档案范围(高自主强介入默认安全置关),搭配 `idle-guard` 避免长任务空转停机。
|
|
161
|
+
- 点顶栏 `DSH 参谋长` 与版本号之间的 `⚙️` 图标打开设置页,内有 **3 档情景预设**(只读旁观 / 日常协作 / 离桌托管)、**面板显示位置**(右侧栏 + 主页面 / 仅主页面 / 仅右侧栏、保留输入框或右下角按钮、子代理现有栏加页签/新开分屏、本会话及新会话启用开关)、**7 类关键节点桌面告警与轻柔提示音**、**按 `chat / review / dream` 分类的 LLM 账本与预算上限**,以及 `zh / en` 实时切换;跨会话交接单(`📌 定住防改`)和导出脱敏 `.md` 复盘报告收口在 `任务` 页签底部。
|
|
162
|
+
- 支持一键新开窗口并继承当前工作区 `workspaceId`、参谋配置与指定的档案范围(强介入默认置关),搭配 `idle-guard` 防止任务假死。
|
|
151
163
|
|
|
152
164
|
<div align="center">
|
|
153
165
|
<img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话交接单与新开窗口部署" width="68%" />
|
|
@@ -155,34 +167,197 @@
|
|
|
155
167
|
|
|
156
168
|
---
|
|
157
169
|
|
|
158
|
-
##
|
|
170
|
+
## 名词小词典
|
|
171
|
+
|
|
172
|
+
| 词 | 大白话解释 |
|
|
173
|
+
| :--- | :--- |
|
|
174
|
+
| `主对话 (@lead)` | DSH 中间主窗口里负责读代码、改文件、跑命令的 AI。 |
|
|
175
|
+
| `参谋长 / 参谋` | 本插件右侧栏里的督导 AI,负责记任务、存档案和做执行前检查。 |
|
|
176
|
+
| `子代理` | 主对话分派出去并行干活的小助手(如 `@arch`、`@dev`、`@bench`)。 |
|
|
177
|
+
| `L0–L3 权限` | 四档授权等级:L0 只读(默认)、L1 助手、L2 改前逐项问你、L3 参谋长托管。 |
|
|
178
|
+
| `关停 / 巡检 / 托管` | 顶栏三种后台模式:关停完全不动、巡检出错或被拦才看、托管持续盯完。 |
|
|
179
|
+
| `物理驻墙` | 工具执行前的拦截规则,写文件或跑命令命中规则就拦下或弹窗问你。 |
|
|
180
|
+
| `红线 / 必做事项` | 「边界」页里的规则清单:禁止红线写不能干的事,必做事项写完工前要过的检查。 |
|
|
181
|
+
| `认知桌面` | 档案页最顶部的置顶区,最多放 6 份(2,400 Tokens),只有它会每轮发给主对话。 |
|
|
182
|
+
| `档案柜` | 放长期笔记的地方,分本会话、全局、冷藏三层,未置顶时平时不占主对话 Token。 |
|
|
183
|
+
| `🪝 钩子` | 档案上的关键词标签,AI 需要时靠它按需拉出对应笔记。 |
|
|
184
|
+
| `/compact 压缩` | DSH 对话快满时把前文缩成摘要的内置操作,参谋长会先存档再触发它。 |
|
|
185
|
+
| `✦ 智选压缩` | 开启后到空闲节点或阈值时,自动先存档再做 `/compact`。 |
|
|
186
|
+
| `⚡ 强介入` | 锁定目标后开启,模型半途停下会被接着推动,同错 3 次自动停下。 |
|
|
187
|
+
| `⏹ 急停` | 输入栏的红色按钮,一点立刻打断所有后台继续和督导动作。 |
|
|
188
|
+
| `交接单` | 对话太长换新窗口时生成的背景摘要卡片,点 `📌 定住防改` 可带去新窗口。 |
|
|
189
|
+
| `梦境漫游` | 托管时在后台整理档案卷宗与关键词钩子的动作,会计入 `dream` 账本。 |
|
|
190
|
+
| `Token` | 模型读写文本的计费与上下文长度单位,大约相当于半个到一个中文字或英文词。 |
|
|
191
|
+
|
|
192
|
+
---
|
|
193
|
+
|
|
194
|
+
## 常见问题
|
|
195
|
+
|
|
196
|
+
**会不会偷偷花钱?**
|
|
197
|
+
不会。在 `⏸ 关停` 和 `🛡 巡检` 模式下,空闲时不会在后台额外调用模型。只有在 `🤖 托管` 模式下才会自动巡检和整理档案,而且默认设了 `30 次调用 / 300K Token` 上限,到达就自动停下;顶栏 `⚙️ 设置` 里的账本能按问答、巡检、梦境漫游分项查看实际用量。
|
|
198
|
+
|
|
199
|
+
**不想每个普通聊天都挂着参谋长 / 怕被误拦工作区外读写怎么办?**
|
|
200
|
+
新会话从 `v1.7.0` 起**默认就是未启用状态**:你不点击「在本会话启用」或调用参谋能力前,普通聊天窗不会注入参谋提示词,也不会被安全卫兵拦截,更不会留下空白看板文件;如果你习惯所有新会话一上来就受安全护栏保护,去顶栏 `⚙️ 设置 -> 面板显示位置` 打开「**新会话默认自动启用参谋长**」即可。
|
|
201
|
+
|
|
202
|
+
**会不会乱改我的文件?**
|
|
203
|
+
不会。新对话默认是 `L0 只读`,只看不改;切换到 `L2` 时,重要写改会逐项弹窗等你点允许。删盘、强推、`git reset --hard` 等硬红线在任何档位都会被直接拦住;就算开到 `L3`,AI 也不能删除或停用你锁定的物理驻墙。
|
|
204
|
+
|
|
205
|
+
**怎么马上让它停?**
|
|
206
|
+
点输入栏最右侧红色的 `⏹ 急停` 按钮,就能立刻打断正在跑的后台驱动;想让它平时不再自动介入,把顶栏运行模式切到 `⏸ 关停` 就行。
|
|
159
207
|
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
208
|
+
**我的数据存哪?会上传吗?**
|
|
209
|
+
所有状态、档案、物理驻墙与审计日志都只存在本机 `~/.dsh/chief/` 目录下,没有外部依赖包,也不向外部发送遥测数据。粘贴进对话的疑似密钥或私钥片段在写入档案前会自动替换成 `[REDACTED]`。
|
|
210
|
+
|
|
211
|
+
**需要什么版本?**
|
|
212
|
+
需要 DSH `>= 0.2.2-rc.2`(推荐 `>= 0.2.2-rc.5`)和 Node.js `>= 22.13.0`。更早的 `0.2.0 ~ 0.2.2-rc.1` 面板本身可以挂载,但会自动限制子代理派发并提示升级。具体对照见下方「进阶」里的兼容表。
|
|
213
|
+
|
|
214
|
+
**效果不好怎么办?**
|
|
215
|
+
排查两件事:第一,插件本身只兜住安全边界与流程护栏,拆解任务准不准、找 Bug 稳不稳还是取决于你给参谋长选了哪个模型,跑复杂工程建议选推理能力强的主力模型;第二,不要一边用本插件,一边在项目里叠加上百条互相冲突的全局 Rules 或其他每轮塞大段旧账的记忆插件,低频资料放进档案柜按需拉取即可。
|
|
216
|
+
|
|
217
|
+
**不写代码也能用吗?**
|
|
218
|
+
可以。底部输入框、预设切换和让参谋起草拦截规则都支持大白话;在「任务」页碰到看不懂的步骤时,直接点步骤上的「解释」,参谋长会用通俗语言告诉你这步在干什么、跳过有什么影响。
|
|
167
219
|
|
|
168
220
|
---
|
|
169
221
|
|
|
170
|
-
##
|
|
222
|
+
## 进阶:给想深入了解的人
|
|
223
|
+
|
|
224
|
+
<details>
|
|
225
|
+
<summary>架构演进路线:从右侧记事本到多智能体管理中枢(v1.0 → v1.7)</summary>
|
|
171
226
|
|
|
172
|
-
|
|
227
|
+
从最初共享一份 JSON 的右侧记事本(`dnb-`),到如今 44 个后端模块 + 39 个前端模块、0 外部依赖的管理中枢,每一步都是被真实踩坑推着走的:
|
|
228
|
+
|
|
229
|
+
<div align="center">
|
|
230
|
+
<img src="assets/evolution-roadmap.gif" alt="dsh-chief v1.0 到 v1.7 架构演进动态图" width="840" />
|
|
231
|
+
</div>
|
|
232
|
+
|
|
233
|
+
```mermaid
|
|
234
|
+
flowchart LR
|
|
235
|
+
A["v1.0–v1.1\n右侧副驾\n冷存档案 · 压缩抢救"] --> B["v1.2–v1.2.1\n装手造笼\n执行器 · 四档权限"]
|
|
236
|
+
B --> C["v1.3\n拆巨石\n45 模块 · 文件锁"]
|
|
237
|
+
C --> D["v1.4\n守关口\n独立安全内核 · 物理驻墙"]
|
|
238
|
+
D --> E["v1.5–v1.6\n省注意力\n认知桌面 · 流程画布 · 硬预算"]
|
|
239
|
+
E --> F["v1.7\n成中枢且克制\n主屏 · 外协直连 · 按需零侵入"]
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
想看完整工程故事与设计取舍,直接读 👉 **[架构演进之路 (`EVOLUTION.md`)](EVOLUTION.md)**。
|
|
243
|
+
|
|
244
|
+
</details>
|
|
245
|
+
|
|
246
|
+
<details>
|
|
247
|
+
<summary>v1.7.0 改了什么</summary>
|
|
248
|
+
|
|
249
|
+
- **会话级按需启用(普通窗口零侵入)**:全新聊天窗及其子代理在未主动启用参谋长时全链路放行(不注看板提示词、不拦工作区外工具、不留垃圾盘文件),面板提供一键「在本会话启用」提示条与「本会话启用 / 新会话默认自动启用」双开关,老会话无损兼容。
|
|
250
|
+
- **内置安全卫兵总控开关与误报净化**:设置页新增人类专控的「本会话 / 全局安全卫兵」开关(关闭须风险弹窗确认并写审计,与红线哨兵和手工物理驻墙互相独立);同步修复 `destructive_command` 对非可执行 heredoc/只读查询的误杀,以及 `cursor.blocked` 红色受阻条把「已获批准/无阻塞」等正常陈述误标红的问题。
|
|
251
|
+
- **主页面大屏 (`conversation.view`) 与子代理页签防堆叠**:对话顶部新增简洁「参谋长」页签一键进大屏并自动隐藏宿主重复主框(兼容 `rc.3` Web GUI 贴底与双入口独立开关);点击协同页子代理默认改为在现有右侧栏加页签并去重,可在设置切回新开分屏。
|
|
252
|
+
- **全新「协同系统」与待命池净化**:支持跨平台免 `ccSwitch` 直连本机 `Codex` / `Claude Code` 派单(带红线与物理驻墙)、工作态主题色呼吸泛光与流动连线(空闲全静止)、外协消息统一归入「跨窗」、以及过滤 `Mnemon` 后台任务/空白空壳后的待命池「刷新扫描」。
|
|
253
|
+
- **深浅色主题统一与巨石文件模块化**:5 大页签统一 8 色微色带与卡片折叠条、全面适配 DSH 浅色主题,并拆分为 **44 个后端模块 + 39 个前端模块**。
|
|
254
|
+
|
|
255
|
+
</details>
|
|
256
|
+
|
|
257
|
+
<details>
|
|
258
|
+
<summary>v1.6.0 改了什么</summary>
|
|
259
|
+
|
|
260
|
+
<img src="assets/v160-highlights.png" alt="dsh-chief v1.6.0 功能示意:SVG 流程画布、点击展开组织树、顶栏齿轮设置与情景预设、中英双语切换与脱敏复盘导出" width="100%" />
|
|
261
|
+
|
|
262
|
+
- **流程画布与 5 页签合一**:把原来的「规划」并进「任务」页,顶部精简为 **参谋 / 任务 / 协同 / 档案 / 边界** 5 个页签。「流程画布」用 SVG 画出顺序步骤、嵌套子代理和跨步回指线;「组织树」默认收起,点击 `👑 主代理` 整张卡片即可展开或折叠下属详情。
|
|
263
|
+
- **离桌托管配套提醒与预算上限**:待审批、提权、被拦截、断流续跑、自动休眠、触达预算、急停等 7 个节点会发桌面通知,可选开启提示音(新会话静默建基线,不重放旧通知)。`llmLedger` 按问答、巡检、梦境漫游分账,托管模式下默认达到 `30 次 / 300K tokens` 就停机(你在输入框主动提问不受此限),并可一键导出或复制脱敏后的 `.md` 复盘报告。
|
|
264
|
+
- **顶栏设置页、3 档预设与中英切换**:点顶栏标题旁的 `⚙️` 图标打开设置页,提供 **只读旁观 / 日常协作 / 离桌托管** 三档预设(切到离桌托管有双重风险确认),支持 `自动 / 简体中文 / English` 实时切换。
|
|
265
|
+
- **命令检查与空转拦截补强**:区分 `--format` 参数和真正的磁盘格式化命令(`format C:` 仍直接拦下);增加回合中途重复报错空转检测,防止后台超时或触发上限后继续发送请求。
|
|
266
|
+
|
|
267
|
+
> 协同分工参考了 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的 Router + Workers 模型,侧边栏状态和主对话上下文互相隔离。
|
|
268
|
+
|
|
269
|
+
</details>
|
|
270
|
+
|
|
271
|
+
<details>
|
|
272
|
+
<summary>它具体解决哪些日常问题(6 个真实场景)</summary>
|
|
273
|
+
|
|
274
|
+
### 1. 上下文一压缩(`/compact`)就忘了前面查出来的路径和命令
|
|
275
|
+
**一句话**:压缩前先把关键路径、端口和报错存进本会话档案,再让宿主执行压缩。
|
|
276
|
+
|
|
277
|
+
- **常见状况**:对话长了触发压缩,刚找到的配置路径、端口号、报错行号和回滚命令被摘要删掉,模型回头又重新读文件。
|
|
278
|
+
- **做法**:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也能直接在右侧输入「压缩吧」。执行顺序固定为「先提取细节写入本会话档案柜并核验落盘 → 再静默调用宿主 `/compact`」。没有历史消息或压缩报错时,计数不会增加。
|
|
279
|
+
|
|
280
|
+
### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
|
|
281
|
+
**一句话**:锁好目标后,模型没跑完检查就被督导接着推,同错 3 次停下,随时可点红钮急停。
|
|
282
|
+
|
|
283
|
+
- **常见状况**:无人值守跑多步改动时,模型往往改完一处就汇报完成,漏掉测试和构建验证。
|
|
284
|
+
- **做法**:必须先填并锁定核心目标,再开 `⚡ 主动强介入`(`0 = ♾️` 表示不限轮数,同一个错连续 3 轮就触发停止)。在 `🛡 巡检` / `🤖 托管` 下断流会自动唤醒续跑,`L3 + 强介入` 可以把安全步骤跑完后汇总成 `🏁 一站式战报`,但未通过必做检查或未经你点 `✅ 批准结项` 不会标记完工。想立刻收回控制权,点输入栏红色 `⏹ 急停` 打断后台驱动即可。
|
|
285
|
+
|
|
286
|
+
### 3. 常驻记忆插件每轮塞几千字进提示词,烧 Token 还带偏模型
|
|
287
|
+
**一句话**:只有放上「认知桌面」的少数档案每轮带进提示词,其余档案平时 0 Token 放抽屉里按关键词拉取。
|
|
288
|
+
|
|
289
|
+
- **常见状况**:普通记忆插件每轮把几十条旧笔记塞进 System Prompt,主模型被无关旧账干扰,Token 消耗也高。
|
|
290
|
+
- **做法**:档案分放进 **本会话柜 / 全局柜 / 沉淀冷藏柜**,平时像一沓纸收在抽屉里。只有摆上置顶 `📌 认知桌面`(上限 `2,400 Tokens / 6 份`)的卷宗才会每轮直接发给主对话;其余资料挂好 `🪝` 关键词钩子,AI 需要时自己调 `archive.pull` 按标签拉取,未翻牌的资料对 AI 保持 `0` 字节隔离。
|
|
291
|
+
|
|
292
|
+
### 4. 权限全放开怕误删误推,全锁死又什么都做不了
|
|
293
|
+
**一句话**:新对话默认只读,靠四档权限和执行前物理拦截两道关来管,AI 自己关不掉你设的拦截规则。
|
|
294
|
+
|
|
295
|
+
- **常见状况**:次次手动确认很烦,全放开又怕模型跑出 `git push --force`、删目录或读 `.env`;或者参谋权限高了以后抢着自己改代码,把主对话晾在一边。
|
|
296
|
+
- **做法**:底部四档权限(`L0` 只读顾问 · 默认 / `L1` 助手 / `L2` 参谋逐项授权 / `L3` 参谋长)与顶栏三态模式(`⏸ 关停 / 🛡 巡检 / 🤖 托管`)分开控制,工具落地前还有事前拦截:
|
|
297
|
+
- **新对话默认只读**:只看代码、出方案、记看板,不碰工作区文件,也不插话打断主对话。
|
|
298
|
+
- **工具执行前的「物理驻墙」**:主对话、子代理和参谋只要调用终端命令或读写文件,执行前都要先过宿主 `tools/pre-execute` 检查和你的物理驻墙(执行前的拦截规则)。每堵墙都能切成 `🌐 全局`、`📁 本工程` 或 `⏸ 暂挂`,同类墙可一键合并;不会写正则可以让参谋起草草案,你点确认后才生效。即使在 `L3` 档位下,AI 也无权私自删除或停用已锁定的驻墙,真撞死只能提交审批单等你点批。
|
|
299
|
+
- **优先让主对话干活**:没指定让参谋亲自改文件时,它只给主对话派发任务,不会冒充你在主框发消息;新开的空白窗口里,它会先让主模型只读看代码、排计划;半途缺情报时在后台顺口问主对话一句,不打断当前动作。
|
|
300
|
+
- **批准后自动续跑 & 固定红线**:`TaskLedger` 会记下卡住的步骤,你点允许或提权后接着跑完。几条硬红线(删盘、强推、`git reset --hard`、复合管道、内联 `node -e`/`python -c`、`".\\"env` 变形、NTFS ADS 流与 `-EncodedCommand`)在任何档位都会直接拦下并写进 `~/.dsh/chief/chief-audit.jsonl`,也支持挂载只紧不松的 JSON 策略插件进一步限缩工具或目录。
|
|
301
|
+
|
|
302
|
+
### 5. 子代理开了一堆,不知道谁卡住、谁在空转
|
|
303
|
+
**一句话**:主代理和子代理在同一个树状视图里看进度,点 `@递话` 单独纠偏,重要规矩可以用图钉跨任务固定。
|
|
304
|
+
|
|
305
|
+
- **常见状况**:多个子代理并行干活时散在不同标签页里,挨个点进去看输出很费劲,对话里交代的规矩聊几轮就被冲掉。
|
|
306
|
+
- **做法**:任务页把主代理和子代理画在一张图里,支持原地改状态、点 `💬 分屏` 直接看实时修改流、点底栏代理图标发 `@递话` 纠偏;边界页点亮 `📌` 图钉就能把全局红线跨任务固定下来。
|
|
307
|
+
|
|
308
|
+
### 6. 对话聊太长变慢变贵,换新窗口又得从头交代背景
|
|
309
|
+
**一句话**:平时巡检和关停状态不额外调后台模型,想换窗口时定住交接单就能带去新窗口接着干。
|
|
310
|
+
|
|
311
|
+
- **常见状况**:聊过 100 轮想重开干净窗口,怕丢背景、模型配置和刚梳理完的任务分工;也怕后台总结插件一直走按量付费通道。
|
|
312
|
+
- **做法**:顶栏模型选择器支持「跟随主对话」,旁边是 `180°` 扇形思考强度表盘(`关停` 和 `巡检` 空闲时没有任何后台调用)。任务页里看不懂的步骤点「解释」会给出大白话解读;点交接卡 `📌 定住防改` 锁住核对过的交接单后,可以一键新开窗口并自选要带过去的档案层级,还能导出脱敏 `.md` 复盘报告。
|
|
313
|
+
|
|
314
|
+
</details>
|
|
315
|
+
|
|
316
|
+
<details>
|
|
317
|
+
<summary>完整安装方式与宿主版本兼容表</summary>
|
|
318
|
+
|
|
319
|
+
在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
|
|
320
|
+
|
|
321
|
+
```bash
|
|
322
|
+
# 方式 1:通过 npm 安装最新版(v1.7.0)
|
|
323
|
+
dsh plugin --profile desktop add dsh-chief
|
|
324
|
+
|
|
325
|
+
# 方式 2:从 GitHub 仓库直接安装(与 main 最新代码同步)
|
|
326
|
+
dsh plugin --profile desktop add github:gluztm/dsh-chief
|
|
327
|
+
|
|
328
|
+
# 方式 3:安装 GitHub Release 预构建包(v1.7.0)
|
|
329
|
+
dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.7.0/dsh-chief-1.7.0.tgz
|
|
330
|
+
```
|
|
331
|
+
|
|
332
|
+
装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
|
|
333
|
+
|
|
334
|
+
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
|
|
335
|
+
| :--- | :---: | :---: | :--- |
|
|
336
|
+
| **`>= 0.2.2-rc.5`(当前桌面主力版)** | 完整可用 | 完整可用 | 已适配 `dsh-tool-fs`(`read`/`read_image`/`write`/`edit`/`apply_patch`)、`str_replace_editor`、热调 `reasoningEffort` 及原生 `{ kind: 'ask' }` 弹窗 |
|
|
337
|
+
| `0.2.2-rc.2 ~ 0.2.2-rc.4` | 完整可用 | 完整可用 | 宿主原生提供 `subagents.resolveName` / `rootOf` / `namesOf` 与 `tools/pre-execute` 物理拦截 |
|
|
338
|
+
| `0.2.0 ~ 0.2.2-rc.1` | 正常挂载 | 提示升级 | 旧版无命名子代理 API,面板会自动拦截高风险调用并提示升级 |
|
|
339
|
+
|
|
340
|
+
</details>
|
|
341
|
+
|
|
342
|
+
<details>
|
|
343
|
+
<summary>模块结构与数据流 (v1.7.0)</summary>
|
|
344
|
+
|
|
345
|
+
**一句话**:`44` 个后端模块加 `39` 个前端模块,本地数据全部留在 `~/.dsh/chief/`,未启用的普通会话零介入,已启用会话只有「认知桌面」会每轮注入主对话。
|
|
346
|
+
|
|
347
|
+
`v1.7.0` 包含 **44 个后端模块(含 `pkg/safety/` 下 9 个独立安全内核模块)+ 39 个前端模块**(无环依赖、无 `export let` 可变导出),方便审查与长期维护。详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
|
|
173
348
|
|
|
174
349
|
```mermaid
|
|
175
350
|
flowchart TB
|
|
176
|
-
subgraph UI["DSH
|
|
177
|
-
T1["参谋页 (问答框 · 180°扇形思考表盘 · 可点穿透流光毛玻璃)"]
|
|
178
|
-
T2["任务页 (
|
|
179
|
-
T3["协同页 (
|
|
180
|
-
T4["规划页 (必锁目标 · 步骤大白话解释 · 交接单)"]
|
|
351
|
+
subgraph UI["DSH 右侧栏 & 主页面 Tab (client.js <- 39 个前端模块 · 5 页签 + 顶栏齿轮设置)"]
|
|
352
|
+
T1["参谋页 (问答框 · 180°扇形思考表盘 · 可点穿透流光毛玻璃 · 战报导出)"]
|
|
353
|
+
T2["任务页 (核心目标 · SVG流程画布/点卡拉起组织树 · 合一推进任务板 · 交接部署)"]
|
|
354
|
+
T3["协同页 (协同系统编队 · 本机Codex/Claude直连 · 跨窗消息流 · 子代理页签查看)"]
|
|
181
355
|
T5["档案页 (2400T认知桌面 · 一沓纸三层抽屉与织钩)"]
|
|
182
356
|
T6["边界页 (动态物理驻墙 · 请示拆墙 · 📌全局红线)"]
|
|
357
|
+
T7["顶栏 ⚙️ 设置 (3 档预设 · 主页面/浮钮/子代理打开方式 · 按需开关 · 预算/zh/en)"]
|
|
183
358
|
end
|
|
184
359
|
|
|
185
|
-
subgraph Core["本地后端存储与安全内核 (零外部依赖 ·
|
|
360
|
+
subgraph Core["本地后端存储与安全内核 (零外部依赖 · 44 个后端模块)"]
|
|
186
361
|
Hot["热工作板: ~/.dsh/chief/board.json & boards/<sid>.json\n跨进程/工作线程 O_EXCL 自旋锁"]
|
|
187
362
|
Walls["动态物理驻墙: ~/.dsh/chief/guard-walls.json\n全局 / 本工程 / 暂挂三态"]
|
|
188
363
|
Cold["三层档案库: 2400T认知桌面(唯一注入) + 一沓纸钩子柜 + 0-byte双盲冷藏库"]
|
|
@@ -204,38 +379,12 @@ flowchart TB
|
|
|
204
379
|
Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
|
|
205
380
|
```
|
|
206
381
|
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
## 安装与宿主版本兼容
|
|
210
|
-
|
|
211
|
-
在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
|
|
212
|
-
|
|
213
|
-
```bash
|
|
214
|
-
# 方式 1:通过 npm 安装最新版(v1.5.0)
|
|
215
|
-
dsh plugin --profile desktop add dsh-chief
|
|
216
|
-
|
|
217
|
-
# 方式 2:从 GitHub 仓库直接安装(与 main 最新代码同步)
|
|
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
|
|
222
|
-
```
|
|
223
|
-
|
|
224
|
-
装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
|
|
225
|
-
|
|
226
|
-
### 宿主版本兼容表
|
|
227
|
-
|
|
228
|
-
| DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
|
|
229
|
-
| :--- | :---: | :---: | :--- |
|
|
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,面板会自动拦截高风险调用并提示升级 |
|
|
233
|
-
|
|
234
|
-
---
|
|
382
|
+
</details>
|
|
235
383
|
|
|
236
|
-
|
|
384
|
+
<details>
|
|
385
|
+
<summary>注册给模型的 4 个工具</summary>
|
|
237
386
|
|
|
238
|
-
|
|
387
|
+
插件向模型注册 4 个结构化工具,动作参数兼容严格 JSON 与常见文本写法:
|
|
239
388
|
|
|
240
389
|
| 工具名 | 用途 | 常用动作 (`action`) |
|
|
241
390
|
| :--- | :--- | :--- |
|
|
@@ -244,14 +393,19 @@ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/do
|
|
|
244
393
|
| **`chief_boundaries`** | 读写全局 `📌` 红线、必做项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
|
|
245
394
|
| **`chief_handoff`** | 预览并生成独立自包含的跨会话 Markdown 交接单 | `preview` / 会话接力 |
|
|
246
395
|
|
|
247
|
-
|
|
396
|
+
</details>
|
|
397
|
+
|
|
398
|
+
<details>
|
|
399
|
+
<summary>本地存储与安全边界</summary>
|
|
400
|
+
|
|
401
|
+
**一句话**:文件写入带锁且只存在本地 `~/.dsh/chief/`,接口只认本机回环来源,疑似密钥在入库前自动替换成 `[REDACTED]`。
|
|
248
402
|
|
|
249
|
-
|
|
403
|
+
- **跨进程与多线程文件锁**:`board-store.js`、`chief-state.js`、`archive-core.js`、`safety/guard-walls.js` 落盘使用 `O_EXCL` 加抖动重试的文件锁(涵盖 Windows NTFS 瞬态 `EPERM/EACCES/EBUSY`)以及带 `threadId` 的原子临时文件替换,并发写入不容易丢记录。
|
|
404
|
+
- **独立安全内核与反变形检测**:`pkg/safety/`(9 个模块)与 `chief-executor.js` 通过 MD5 校验守护,覆盖复合管道、内联脚本(`node -e` / `python -c` / `pwsh` / `iex` + Base64)、引号/反斜杠凭据变形、`bounds.*` / 物理驻墙人类确认令牌以及单次授权 `capabilityScope` 绑定,同时对正常的 `process.env.NODE_ENV` 与 `node .\env\setup.js` 放行。
|
|
405
|
+
- **27 条接口同源环回校验**:全部 `/api/dsh-chief/*` 接口先检查 Loopback 来源与 `Origin/Host`,连接检查异常时默认返回 `403`。
|
|
406
|
+
- **凭据防误存与本地运行**:不保存 `sk-*`、`ghp_*`、Bearer Token、`AIza*`、`AKIA*` 与私钥片段;收纳含疑似密钥的便签时会自动替换成 `[REDACTED]`。状态、档案、物理驻墙与审计日志都留在本地 `~/.dsh/chief/`,不依赖外部包,也不向外发送数据。
|
|
250
407
|
|
|
251
|
-
|
|
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/`,零外部依赖,零遥测上报。
|
|
408
|
+
</details>
|
|
255
409
|
|
|
256
410
|
---
|
|
257
411
|
|
|
@@ -260,8 +414,6 @@ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/do
|
|
|
260
414
|
| 贡献者 | 主要工作 |
|
|
261
415
|
| --- | --- |
|
|
262
416
|
| [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
417
|
| [Gemini](https://github.com/gemini-code-assist) | 功能研发、`pkg/safety/` 独立安全内核、认知桌面与三态总控、180° 扇形思考表盘及自动化门禁 |
|
|
266
418
|
| [Codex](https://github.com/codex) | 模块化架构设计、高并发压测、红队穿透测试与边界审查 |
|
|
267
419
|
| [deepseek-ai](https://github.com/deepseek-ai) | DeepSeek Harness 宿主运行时与 SuperAgent 协同机制支持 |
|