dsh-chief 1.4.0 → 1.6.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,11 +1,15 @@
1
1
  <div align="center">
2
2
 
3
- **给 DeepSeek Harness(DSH)用的右侧栏任务看护、防压缩忘事与权限管控面板**
4
- <sub>长对话 `/compact` 前先存参数再压缩,子代理进度一屏看完,改文件跑命令前逐项弹窗问你。</sub>
3
+ **给 DeepSeek Harness(DSH)用的右侧栏任务看护、认知桌面、事前物理驻墙与多代理管控面板**
4
+ <sub>长对话 `/compact` 前先存参数再压缩,子代理金字塔一屏看完,改文件跑命令前先过物理墙与逐项审批。</sub>
5
5
 
6
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
+
10
+ <br />
11
+
12
+ <img src="assets/v160-highlights.png" alt="dsh-chief v1.6.0 核心新特性实机一览:SVG 流程画布与跨步回指、默认单行收敛与点整卡秒展组织树、顶栏旋转齿轮「设置」情景预设与分类预算熔断、zh / en 实时双语与脱敏 .md 复盘战报" width="100%" />
9
13
 
10
14
  <br />
11
15
 
@@ -14,26 +18,39 @@
14
18
  <br />
15
19
 
16
20
  # DSH 参谋长 (`dsh-chief`)
17
- ### DeepSeek Harness 右侧常驻多代理看护、0-Token 本地档案柜与安全审批面板
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/BV1Fksq6iEw8)
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.4.0`**:新增 9 模块独立安全内核 (`pkg/safety/`)、基于 `tools/pre-execute` 的事前物理驻墙 (`guard-walls.json`)、`role + capabilities` 双层能力与持久化 `TaskLedger` 续跑、参谋懒介入委派 (`[EXECUTION_REQUEST]`) 与后台零中断问询 (`[INQUIRY]`),已适配 DSH `0.2.2-rc.5`。
34
+ > **当前版本 `v1.6.0`**:推出**可视化工作拓扑(「流程画布」SVG 推进流与跨步回指 + 点整卡拉起「组织树」)与 5 页签统一任务台**、**离桌托管闭环(7 类关键节点桌面告警与可选提示音 + 按 `chat / review / dream` 分类账本及硬预算熔断 + 一键导出脱敏 `.md` 复盘战报)**,以及**顶栏旋转齿轮「设置」页、3 档开箱情景预设与 `zh / en` 全界面实时双语**;同时延续 `v1.5.0` 认知桌面(`2,400 Tokens / 6 份`)、`180°` 扇形思考表盘、可点穿透流光毛玻璃与 `--format` 零误杀安全守卫,完整适配 DSH `0.2.2-rc.5`。
29
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.6.0 亮点](#v160-重点升级一览) · [核心痛点](#主要解决哪些日常麻烦) · [界面实机](#界面与功能说明) · [模块架构](#模块结构与数据流-v160) · [安装与兼容](#安装与宿主版本兼容) · [安全边界](#本地存储与安全边界) · [贡献者](#贡献者)
32
40
 
33
41
  </div>
34
42
 
35
43
  ---
36
44
 
45
+ ## `v1.6.0` 重点升级一览
46
+
47
+ - **🧭 可视化工作拓扑、5 页签合一与全站统一拉起**:原「规划」正式并入「任务」页签,顶部收口为 **参谋 / 任务 / 协同 / 档案 / 边界** 5 大页签;「流程画布」用 SVG 画出顺序步骤、嵌套子代理分支与跨步回指交卷连线;「组织树」默认收起,点 `👑 主代理` 整卡一键拉起/收起,全站统一 `AccCard` 拉起折叠体验与浅色主题适配。
48
+ - **🌙 离桌托管闭环(桌面提醒 + 分类账本 + 硬预算熔断 + 复盘战报)**:待批/提权/撞墙/断流救活/自动休眠/预算熔断/紧急煞停等 7 类里程碑支持系统桌面告警与可选轻柔提示音(首次会话静默建基线,绝不重放旧告警);`llmLedger` 按问答/巡检/梦境漫游分账并设 `30 次 / 300K tokens` 默认硬熔断保护(人类 `ask_chief` 问答永不拦截);一键导出或复制 `.md` 复盘战报并自动脱敏密钥凭据。
49
+ - **⚙️ 顶栏旋转齿轮「设置」、3 档情景预设与中英双语**:顶栏品牌标题与 `v1.6.0` 之间新增旋转齿轮按钮一键打开「设置」,内建 **👁 只读旁观 / 🤝 日常协作 / 🚀 离桌托管** 三档情景预设(进离桌托管必过 L3 + 托管双重确认门)与 `自动 / 简体中文 / English` 实时语言切换。
50
+ - **🛡️ 安全内核与强介入防空转加固**:精确区分 `--format` 参数与真实磁盘格式化命令(零误杀且硬拦 `format C:`);强化强介入在 `off/patrol` 模式、冷却期重排、空督导兜底及回合中途打转/连错空转检测;延承 `2,400T/6` 认知桌面、`180°` 扇形思考强度表盘、`🔒 锁挡` 与点击穿透流光毛玻璃。
51
+
52
+ ---
53
+
37
54
  ## 主要解决哪些日常麻烦
38
55
 
39
56
  写代码和跑长会话时最常踩的几个坑,这个面板逐个给了工程上的硬兜底。
@@ -45,64 +62,62 @@
45
62
 
46
63
  ### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
47
64
  - 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
48
- - `dsh-chief` 的做法:用核心目标锁死最终验收标准,可开启 `⚡ 主动强介入`(支持 `0 = ♾️` 无限轮自动续推,自带无进展熔断),必须核验完 `allowed` 必做清单并由你点击 `✅ 批准结项` 才会停表。
65
+ - `dsh-chief` 的做法:必须先填并锁定核心目标,再开启 `⚡ 主动强介入`(`0 = ♾️` 无限轮自动续推,自带同报错 3 轮防死循环熔断);在 `🛡 巡检` / `🤖 托管` 下断流自动过墙唤醒续跑,`L3 + 强介入` 还可安全批量收口并产出「🏁 一站式战报」,未通过核验并经你 `✅ 批准结项` 绝不虚报完工。
49
66
  - 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
50
67
 
51
68
  ### 3. 常驻记忆插件每轮塞几千字进提示词,烧 Token 还把模型带偏
52
69
  - 常见状况:普通记忆插件每次发消息都把几十条过时笔记硬塞进 System Prompt,主模型被无关旧账带偏,费用还高。
53
- - `dsh-chief` 的做法:把工程档案放进三层本地冷库(本会话柜 / 全局柜 / 沉淀柜),**封存时向主对话注入 0 字节、0 Token**。
54
- - 平时不进上下文,需要参考哪几份卷宗时再点 `📌 摆上桌面` 或 `📤 取出`,用完点 `放回` 就从提示词撤下。
70
+ - `dsh-chief` 的做法:把工程档案分放进 **本会话柜 / 全局柜 / 沉淀冷藏柜**,平时以「一沓纸」折叠收在抽屉里。**只有摆上置顶「📌 认知桌面(上限 `2,400 Tokens / 6 份`)」的卷宗才直接发给主对话**;其余资料只需织好 `🪝` 关键词钩子,AI 需要时自己按标签 `archive.pull` 拉阅,未翻牌冷藏金库对 AI 保持 `0` 字节隔离。
55
71
 
56
72
  ### 4. 权限全放开怕误删误推,全锁死又只剩嘴上聊天
57
73
  - 常见状况:次次确认太烦,给了完全权限又怕模型上头跑 `git push --force`、删目录或碰 `.env`;或者参谋长权限一高就爱自己抢着改代码,反而把主对话晾在一边。
58
- - `dsh-chief` 的做法:内置 `advisor`(只读 · 默认)/ `assistant` / `strategist`(逐项授权)/ `chief`(高自主)四档,外加事前物理防线。
74
+ - `dsh-chief` 的做法:底部四档权限(`L0` 只读顾问 · 默认 / `L1` 助手 / `L2` 参谋逐项授权 / `L3` 参谋长)与顶栏三态运行模式(`⏸ 关停 / 🛡 巡检 / 🤖 托管`)两根旋钮独立配合,外加事前物理防线。
59
75
  - **新对话默认只读**:只看代码、出方案、记看板,不碰工作区文件,也不插话打断主对话。
60
- - **工具落地前的事前物理驻墙**:主对话、子代理和参谋只要调用终端命令或读写文件,执行前都要先过宿主 `tools/pre-execute` 检查和你的「物理驻墙」。每堵墙都能切成「全局随身(像偏好一样跟着所有新对话)」、「仅本工程」或「暂挂停用」,支持同类墙一键合并;不懂正则还能让参谋帮你手搓草案再点确认落锁。高危命令墙支持触发 DSH 原生弹窗问你一次是否放行。
61
- - **参谋懒介入与顺口问**:哪怕开到高权限,没指定让参谋亲自操刀时,它也会先把干活请求派给主对话,不会冒充你在主框里发消息;刚开空白新窗口找参谋,它会先让主模型只读看代码、排计划再回来汇报;半途缺情报就后台悄悄问主对话一句,不打断主对话手头动作,聊完还会顺手刷新顶部摘要。
76
+ - **工具落地前的事前物理驻墙**:主对话、子代理和参谋只要调用终端命令或读写文件,执行前都要先过宿主 `tools/pre-execute` 检查和你的「物理驻墙」。每堵墙都能切成 `🌐 全局`、`📁 本工程` 或 `⏸ 暂挂`,支持同类墙一键合并;不懂正则还能让参谋帮你手搓草案再点确认落锁。即使在 `L3` 最高权限下也**严禁 AI 私自拆墙**,真撞死仅能提交人类审批单。
77
+ - **参谋懒介入与顺口问**:哪怕开到高权限,没指定让参谋亲自操刀时,它也会先把干活请求派给主对话,不会冒充你在主框里发消息;刚开空白新窗口找参谋,它会先让主模型只读看代码、排计划再回来汇报;半途缺情报就后台悄悄问主对话一句,不打断主对话手头动作。
62
78
  - **点完允许自动续跑 & 策略只紧不松**:通过 `TaskLedger` 记下未竟事务,逐项审批或提权通过后会接着往下跑完;内置硬红线(删盘、强推、`git reset --hard`、复合管道、内联 `node -e`/`python -c`、`".\\"env` 变形、NTFS ADS 流与 `-EncodedCommand`)在任何档位都直接拦下并写进 `~/.dsh/chief/chief-audit.jsonl`,也支持外挂只紧不松的 JSON 策略插件进一步限缩工具或目录。
63
79
 
64
80
  ### 5. 子代理开了一堆,不知道谁卡住、谁在空转
65
81
  - 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
66
- - `dsh-chief` 的做法:任务页按主代理与子代理展开树状卡片,支持原地改状态、白话追问某一步、以及点击 `分屏` 直接拉起实时推理流;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
82
+ - `dsh-chief` 的做法:任务页按主代理与子代理展开直观金字塔树状卡片,支持原地改状态、点击 `💬 分屏` 直接看实时修改流、点底栏带图标代理发 `@递话` 精准纠偏;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
67
83
 
68
84
  ### 6. 对话聊太长变慢变贵,换新窗口又得从头交代背景
69
85
  - 常见状况:开了 100 轮想重开新窗口,却怕丢失背景、模型配置和刚梳理完的任务分工,或者后台总结插件偷偷走高价按量渠道。
70
- - `dsh-chief` 的做法:默认 `⏸ 按需`(后台 0 自动调用),严格对齐主会话当前的 Provider 和模型;通过 `📌 定住防改` 锁定人工核对过的交接单,一键新建窗口接力时可选带入哪一层工作档案。
86
+ - `dsh-chief` 的做法:顶栏模型选择器支持「跟随主对话」与 `180°` 扇形思考强度表盘(日常 `关停` / `巡检` 平常均 0 后台消耗);在「任务」页对看不懂的步骤点「解释」即可大白话解读,在底部交接卡点 `📌 定住防改` 锁定人工核对过的交接单,一键新建窗口接力并可选随带工作档案层级,还可导出脱敏 `.md` 复盘战报。
71
87
 
72
88
  ---
73
89
 
74
90
  ## 界面与功能说明
75
91
 
76
- ### 01 · 参谋主面板(`参谋` 页签)
77
- - 底部输入框可指派参谋查看代码、让主对话实施改动、手搓物理驻墙或整理档案,按钮统一居中下右下对齐不乱跑。左上角状态胶囊汇总了 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`(开启时会亮起红色胶囊和红盾图标)与当前权限档位,旁边就是红色 `⏹ 急停`。
78
- - 开启「主动强介入」的确认窗会把当前生效的「物理驻墙」和「禁止红线」同框列出来(点「管理边界」或「一键收起/拉开」就能核对)。
79
- - 对话区支持 `全部 / 💬 问答 / 📋 回执` 筛选,每一组问答和回执用高对比柔光外框包在一起,支持单组或一键全部收起/拉开;多条建议收拢在顶部 `▶ 执行建议`。参谋长在后台忙于自动审查、收档或手搓墙时,面板会自动切到对应页签,亮起流动渐变和双束跑马光线外框并用毛玻璃字样告诉你它正在干嘛。
92
+ ### 01 · 参谋主面板与流光可穿透舞台(`参谋` 页签)
93
+ - 底部输入框支持一句大白话委派探路、手搓物理墙、整理档案或全自动执行;左下控制条汇聚 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`、`L0–L3` 权限与红色 `⏹ 急停`;顶栏直观切换 `⏸ 关停 / 🛡 巡检 / 🤖 托管` 与模型/扇形思考强度。
94
+ - 参谋长后台运行「🌙 梦境漫游」或自动审查时,面板会亮起流动彩色光线外框与毛玻璃舞台,**鼠标单击毛玻璃任意处可立即收起模糊遮罩恢复操作,同时外框流光继续亮着提示后台仍在运作**。
80
95
 
81
96
  ![01 - 参谋长主面板](assets/screenshots/01-chief-cockpit-overview.png)
82
97
 
83
98
  ---
84
99
 
85
- ### 02 · 主代理与子代理任务树(`任务` 页签)
86
- - 按根会话与子代理纵队展开卡片,直接在卡片上调整状态、让人话解释某一步在干嘛、派发任务或点 `分屏` 看实时输出流。
100
+ ### 02 · 可视化工作流「流程画布」与点卡秒展「组织树」(`任务` 页签)
101
+ - **双视角 SVG 工作拓扑**:支持「**流程画布**」(主干步骤推演 + 子代理分支 + 跨步异常虚线回指弧)与「**组织树**」(默认单行收敛省空间,**点击整张主代理卡片**瞬间展开/收起下属 `@subagent` 详情,去掉冗余开关按钮),下方统一整合推进任务板、`分屏` 实时流与跨会话交接。
87
102
 
88
103
  <div align="center">
89
- <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%" />
90
105
  </div>
91
106
 
92
107
  ---
93
108
 
94
- ### 03 · 三层本地冷档案柜(`档案` 页签)
95
- - 分为三层:**💬 本会话档案柜**(按 `rootSessionId` 严格隔离,支持分柜与「一键收纳入柜」清空临时便签)、**🌐 全局档案柜**(跨会话对比差异,标记仅本地 / 已同步 / 本地已改)、**🏛️ 沉淀档案柜**(跨项目长期经验,默认双盲封存)。
96
- - 卷宗按目录和金/银/铜曲别针分层收纳,只在点击 `📌 摆上桌面` 时临时放入主对话上下文。
109
+ ### 03 · 认知桌面与俯视角「一沓纸」三层档案柜(`档案` 页签)
110
+ - 顶部划出置顶 **📌 认知桌面** 与实时 `2,400 Tokens / 6 份` 预算进度条(唯一随轮全文注入主对话,超额按铜/银/金自动退入观察队列);下方分为 **💬 本局档案柜**、**🌐 全局档案柜**、**🏛️ 冷藏档案柜**。
111
+ - 三层抽屉采用俯视角「一沓纸」动态卡片:平时叠放仅露标题与关键词 `🪝` 钩子,点开才展开操作栏与详情,谁能看、谁已拉阅一目了然。
97
112
 
98
113
  <div align="center">
99
- <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层档案柜与双向差分" width="68%" />
114
+ <img src="assets/screenshots/03-cold-archive-cabinet.png" alt="03 - 三层档案柜与认知桌面" width="90%" />
100
115
  </div>
101
116
 
102
117
  ---
103
118
 
104
- ### 04 · 目标锁定与步骤白话追问(`规划` 页签上方)
105
- - 点击 `🎯 设为目标` 开启目标督导;任意计划步骤都可以点开直接问参谋「为什么有这一步、跳过会有什么影响」,不打断主对话正在跑的流程。
119
+ ### 04 · 目标锁定、流程拓扑与步骤大白话「解释 / 咨询」(`任务` 页签)
120
+ - 顶部点击 `🎯 设为目标` 开启目标督导(开强介入前必锁),其下紧接可折叠「可视化工作拓扑」(支持「流程画布」SVG 回指视图与点整卡拉起「组织树」)及合并推进任务板;任意步骤都可点击「解释」让参谋长用通俗大白话解释这条在干嘛、跳过有何影响,全程零打断主对话流程。
106
121
 
107
122
  <div align="center">
108
123
  <img src="assets/screenshots/04-dual-tier-goal-and-step-qa.png" alt="04 - 目标督导与步骤追问" width="68%" />
@@ -111,7 +126,7 @@
111
126
  ---
112
127
 
113
128
  ### 05 · 跨窗口协同串联与信箱(`协同` 页签)
114
- - 可把多个独立 DSH 窗口连在一起互通进度;断开协同立即清掉缓存、外部记忆与离线信箱残留。
129
+ - 可把多个独立 DSH 窗口连在一起互通进度(前端界面 + 后端接口联动);断开协同立即清掉缓存、外部记忆与离线信箱残留。
115
130
  - 粘贴进输入框的截图原图会存进 `<cwd>/.dsh-chief/uploads/`,避免纯文本模型看图靠猜。
116
131
 
117
132
  <div align="center">
@@ -121,8 +136,8 @@
121
136
  ---
122
137
 
123
138
  ### 06 · 物理驻墙、必做项与 `📌` 全局红线(`边界` 页签)
124
- - 顶部新增「🧱 物理驻墙 · 事前硬拦截」专区:可点 `+ 手动驻墙` 或让 `✨ 参谋手搓墙`,随时把每堵墙设为 `🌐 全局`、`📁 本工程` 或 `⏸ 暂挂`;多条零散同类规则支持多选合并或 `✦ 一键合并`(跨类型规则会直接拦截提示,防止误混并)。
125
- - 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏管理;点亮左侧 `📌` 图钉写入全局红线(所有新会话自动继承),不点图钉则只作用于当前会话,也接收子代理撞墙后呈交的边界提案。AI 工具永远无法私自删掉或关闭已落锁的物理墙与红线。
139
+ - 顶部「🧱 物理驻墙 · 事前硬拦截」专区:可点 `+ 手动驻墙` 或让 `✨ 参谋手搓墙`,随时在 `🌐 全局`、`📁 本工程`、`⏸ 暂挂` 间切换,支持同类规则一键合并。
140
+ - 下方分 `必做事项 (allowed)`、`禁止红线 (forbidden)`、`注意事项 (notes)` 三栏管理;任何 `L0–L3` 权限都无权私拆物理墙与红线,真撞死仅能提交人类审批单。
126
141
 
127
142
  <div align="center">
128
143
  <img src="assets/screenshots/06-pinned-bounds-and-handoff.png" alt="06 - 边界规则与全局图钉红线" width="68%" />
@@ -130,9 +145,9 @@
130
145
 
131
146
  ---
132
147
 
133
- ### 07 · 跨会话交接单与携带参谋新开窗口(`规划` 页签底部)
134
- - 交接单支持手改,点 `📌 定住防改` 后锁定当前快照,不会被后续自动摘要覆盖。
135
- - 支持一键新开窗口并继承当前工作区 `workspaceId` 与参谋配置(高自主强介入默认安全置关),搭配 `idle-guard` 避免长任务空转停机。
148
+ ### 07 · 顶栏旋转齿轮「设置」页:情景预设、托管预算与双语切换
149
+ - 点击顶栏 `DSH 参谋长` 与版本号之间的旋转 `⚙️` 图标直达**独立设置页**:提供 **3 档开箱情景预设**(只读旁观 / 日常协作 / 离桌托管)、**7 类关键节点桌面告警与轻柔提示音**、**按 `chat / review / dream` 分类的 LLM 账本与硬预算熔断**,以及 `zh / en` 实时双语切换;跨会话交接单(`📌 定住防改`)与一键导出脱敏 `.md` 复盘战报统一收口在 `任务` 页签底部。
150
+ - 支持一键新开窗口并继承当前工作区 `workspaceId`、参谋配置与指定档案范围(高自主强介入默认安全置关),搭配 `idle-guard` 避免长任务空转停机。
136
151
 
137
152
  <div align="center">
138
153
  <img src="assets/screenshots/07-session-handoff-and-guard.png" alt="07 - 跨会话交接单与新开窗口部署" width="68%" />
@@ -146,32 +161,32 @@
146
161
  > 开启实权工具、`⚡ 主动强介入` 或 `✦ 智选压缩` 前,下面两点直接决定使用体感:
147
162
  >
148
163
  > 1. **工程护栏决定下限,底层模型决定上限**
149
- > 插件负责保证 0-Token 冷隔离、四档权限审批、压缩前落盘复核、死循环熔断和 `⏹ 急停` 这些安全下限。但拆任务准不准、找 Bug 稳不稳,完全取决于你给参谋长选了哪个模型。处理复杂工程建议选推理能力强的主力旗舰模型,别用太轻的小模型。
164
+ > 插件负责保证 0-Token 档案隔离、四档权限审批、压缩前落盘复核、死循环熔断、物理驻墙和 `⏹ 急停` 这些安全下限。但拆任务准不准、找 Bug 稳不稳,完全取决于你给参谋长选了哪个模型。处理复杂工程建议选推理能力强的主力旗舰模型,别用太轻的小模型。
150
165
  > 2. **少叠互相冲突的外部常驻注入**
151
- > 不要一边用本插件,一边在项目里叠加上百条互相对着干的全局 Rules 或每轮强灌大段旧账的记忆插件。无关上下文太多会稀释当前注意力,还容易和参谋的纠偏指令打架。低频资料放进本插件的 **0-Token 档案柜**,要查的时候再取出来用,主对话才干净。
166
+ > 不要一边用本插件,一边在项目里叠加上百条互相对着干的全局 Rules 或每轮强灌大段旧账的记忆插件。无关上下文太多会稀释当前注意力,还容易和参谋的纠偏指令打架。低频资料放进本插件的 **0-Token 档案柜**,仅最常用的摆上 **认知桌面**,主对话才干净。
152
167
 
153
168
  ---
154
169
 
155
- ## 模块结构与数据流 (`v1.4.0`)
170
+ ## 模块结构与数据流 (`v1.6.0`)
156
171
 
157
- `v1.4.0` 包含 **38 个后端模块(含 `pkg/safety/` 下 9 个零业务依赖的安全内核模块)+ 16 个前端模块**(无环依赖、无 `export let` 可变导出),方便审查与长期维护。详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
172
+ `v1.6.0` 包含 **38 个后端模块(含 `pkg/safety/` 下 9 个零业务依赖的安全内核模块)+ 20 个前端模块**(无环依赖、无 `export let` 可变导出),方便审查与长期维护。详情见 [ARCHITECTURE.md](ARCHITECTURE.md)。
158
173
 
159
174
  ```mermaid
160
175
  flowchart TB
161
- subgraph UI["DSH 右侧常驻面板 (client.js <- 16 个前端模块)"]
162
- T1["参谋页 (问答外框 + 权限 + 红盾哨兵 + 光效舞台)"]
163
- T2["任务页 (主/子代理树 + 实时分屏)"]
164
- T3["协同页 (跨窗联动 + 彩色信箱)"]
165
- T4["规划页 (目标锁 + 定住交接单 + 携带部署)"]
166
- T5["档案页 (三层 0-Token 冷库 + 一键收纳入柜)"]
167
- T6["边界页 (动态物理驻墙 + 全局 📌 红线)"]
176
+ subgraph UI["DSH 右侧常驻面板 (client.js <- 20 个前端模块 · 5 页签 + 顶栏齿轮设置)"]
177
+ T1["参谋页 (问答框 · 180°扇形思考表盘 · 可点穿透流光毛玻璃 · 战报导出)"]
178
+ T2["任务页 (核心目标 · SVG流程画布/点卡拉起组织树 · 合一推进任务板 · 交接部署)"]
179
+ T3["协同页 (跨窗联动 · 彩色信箱 · 实时分屏)"]
180
+ T5["档案页 (2400T认知桌面 · 一沓纸三层抽屉与织钩)"]
181
+ T6["边界页 (动态物理驻墙 · 请示拆墙 · 📌全局红线)"]
182
+ T7["顶栏 ⚙️ 设置 (3 档预设 · 桌面告警/提示音 · 账本预算熔断 · zh/en 切换)"]
168
183
  end
169
184
 
170
185
  subgraph Core["本地后端存储与安全内核 (零外部依赖 · 38 个后端模块)"]
171
186
  Hot["热工作板: ~/.dsh/chief/board.json & boards/<sid>.json\n跨进程/工作线程 O_EXCL 自旋锁"]
172
187
  Walls["动态物理驻墙: ~/.dsh/chief/guard-walls.json\n全局 / 本工程 / 暂挂三态"]
173
- Cold["三层档案库: cabinets/ + global-vault/ + precipitated/"]
174
- Bus["安全与调度: safety/*.js + chief-executor.js + taskLedger + chief-audit.jsonl"]
188
+ Cold["三层档案库: 2400T认知桌面(唯一注入) + 一沓纸钩子柜 + 0-byte双盲冷藏库"]
189
+ Bus["调度与安全: safety/*.js + chief-executor + 关停/巡检/托管(5条件休眠) + 审计"]
175
190
  end
176
191
 
177
192
  subgraph Agents["宿主执行代理 (tools/pre-execute 全员事前拦截)"]
@@ -185,7 +200,7 @@ flowchart TB
185
200
  Hot -->|"紧凑热态势"| Subs
186
201
  Walls -->|"事前物理阻断或单次弹窗询问"| Lead
187
202
  Walls -->|"事前物理阻断或单次弹窗询问"| Subs
188
- Cold -.->|"封存时 0 Token\n仅「📌 摆上桌面」或取出时注入"| Lead
203
+ Cold -.->|"仅📌认知桌面全文注入 · 非桌面仅🪝按需拉阅"| Lead
189
204
  Bus <-->|"chief_board / chief_memory\nchief_boundaries / chief_handoff"| Agents
190
205
  ```
191
206
 
@@ -196,14 +211,14 @@ flowchart TB
196
211
  在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
197
212
 
198
213
  ```bash
199
- # 方式 1:通过 npm 安装最新版(v1.4.0)
214
+ # 方式 1:通过 npm 安装最新版(v1.6.0)
200
215
  dsh plugin --profile desktop add dsh-chief
201
216
 
202
217
  # 方式 2:从 GitHub 仓库直接安装(与 main 最新代码同步)
203
218
  dsh plugin --profile desktop add github:gluztm/dsh-chief
204
219
 
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
220
+ # 方式 3:安装 GitHub Release 预构建包(v1.6.0)
221
+ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.6.0/dsh-chief-1.6.0.tgz
207
222
  ```
208
223
 
209
224
  装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
@@ -212,7 +227,7 @@ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/do
212
227
 
213
228
  | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
214
229
  | :--- | :---: | :---: | :--- |
215
- | **`>= 0.2.2-rc.5`(当前桌面主力版)** | 完整可用 | 完整可用 | 已适配 `dsh-tool-fs`(`read`/`read_image`/`write`/`edit`/`apply_patch`)、`str_replace_editor` 及 `tools/pre-execute` 原生 `{ kind: 'ask' }` 弹窗单次审批 |
230
+ | **`>= 0.2.2-rc.5`(当前桌面主力版)** | 完整可用 | 完整可用 | 已适配 `dsh-tool-fs`(`read`/`read_image`/`write`/`edit`/`apply_patch`)、`str_replace_editor`、热调 `reasoningEffort` 及原生 `{ kind: 'ask' }` 弹窗 |
216
231
  | `0.2.2-rc.2 ~ 0.2.2-rc.4` | 完整可用 | 完整可用 | 宿主原生提供 `subagents.resolveName` / `rootOf` / `namesOf` 与 `tools/pre-execute` 物理拦截 |
217
232
  | `0.2.0 ~ 0.2.2-rc.1` | 正常挂载 | 提示升级 | 旧版无命名子代理 API,面板会自动拦截高风险调用并提示升级 |
218
233
 
@@ -224,7 +239,7 @@ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/do
224
239
 
225
240
  | 工具名 | 用途 | 常用动作 (`action`) |
226
241
  | :--- | :--- | :--- |
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` |
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` |
228
243
  | **`chief_memory`** | 读写会话级热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
229
244
  | **`chief_boundaries`** | 读写全局 `📌` 红线、必做项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
230
245
  | **`chief_handoff`** | 预览并生成独立自包含的跨会话 Markdown 交接单 | `preview` / 会话接力 |
@@ -245,7 +260,7 @@ dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/do
245
260
  | 贡献者 | 主要工作 |
246
261
  | --- | --- |
247
262
  | [gluztm](https://github.com/gluztm) | 项目发起人、产品定义与长期维护 |
248
- | [Gemini](https://github.com/gemini-code-assist) | 功能研发、`pkg/safety/` 独立安全内核、事前物理驻墙、懒介入协同与自动化门禁实现 |
263
+ | [Gemini](https://github.com/gemini-code-assist) | 功能研发、`pkg/safety/` 独立安全内核、认知桌面与三态总控、180° 扇形思考表盘及自动化门禁 |
249
264
  | [Codex](https://github.com/codex) | 模块化架构设计、高并发压测、红队穿透测试与边界审查 |
250
265
  | [deepseek-ai](https://github.com/deepseek-ai) | DeepSeek Harness 宿主运行时与 SuperAgent 协同机制支持 |
251
266
 
package/api-routes.js CHANGED
@@ -33,8 +33,20 @@ import {
33
33
  mutateChiefFact,
34
34
  handleApprovalDecision,
35
35
  handleElevationDecision,
36
+ scheduleChiefTurnReview,
36
37
  } from './chief.js'
37
- import { getChiefActiveWork } from './chief-state.js'
38
+ import {
39
+ getChiefActiveWork,
40
+ mutateChiefState,
41
+ ensureWorkspace,
42
+ queueChiefApproval,
43
+ normalizeSuggestion,
44
+ hasValidChiefRiskAck,
45
+ summarizeLlmLedger,
46
+ SUGGESTIONS_CAP,
47
+ CHAT_CAP,
48
+ nextId,
49
+ } from './chief-state.js'
38
50
  import {
39
51
  resolveProjectKey,
40
52
  getArchiveMeta,
@@ -53,6 +65,9 @@ import {
53
65
  DEFAULT_CHIEF_PERMISSION_MODE,
54
66
  HUMAN_BOUNDS_CONFIRM_TOKEN,
55
67
  listGuardWalls,
68
+ normalizePermissionMode,
69
+ permissionRank,
70
+ buildCapabilityScope,
56
71
  } from './chief-executor.js'
57
72
  import {
58
73
  API,
@@ -267,6 +282,18 @@ export function createApiRoutes(deps) {
267
282
  backendBuild: BACKEND_BUILD,
268
283
  hostCompat,
269
284
  paceMode: effCfg.paceMode || 'manual',
285
+ runMode: effCfg.runMode || 'off',
286
+ managedIdleTimeoutMs: effCfg.managedIdleTimeoutMs || 15 * 60 * 1000,
287
+ notifyEnabled: effCfg.notifyEnabled !== false,
288
+ notifySound: Boolean(effCfg.notifySound),
289
+ uiLang: effCfg.uiLang || 'auto',
290
+ managedBudgetMaxCalls: effCfg.managedBudgetMaxCalls ?? 30,
291
+ managedBudgetMaxTokens: effCfg.managedBudgetMaxTokens ?? 300000,
292
+ llmLedgerSummary: summarizeLlmLedger(rootWs && rootWs.llmLedger, effCfg),
293
+ alertEvents: ((rootWs && Array.isArray(rootWs.alertEvents)) ? rootWs.alertEvents : []).slice(-10),
294
+ thinkingEffort: effCfg.thinkingEffort || 'auto',
295
+ teamEffortMode: effCfg.teamEffortMode || 'auto',
296
+ lockedModelEfforts: effCfg.lockedModelEfforts || {},
270
297
  stopped: Boolean(effCfg.stopped || effCfg.paceMode === 'stopped'),
271
298
  permissionMode: effCfg.permissionMode || DEFAULT_CHIEF_PERMISSION_MODE,
272
299
  capabilities: effCfg.capabilities || {},
@@ -320,7 +347,8 @@ export function createApiRoutes(deps) {
320
347
  agentIdentity,
321
348
  teamTasks: sessionId ? fetchTeamTasks(runtime, { id: sessionId }) : undefined,
322
349
  takenOutArchives: archCtx.takenOutArchives,
323
- sessionArchiveBriefs: archCtx.sessionArchiveBriefs,
350
+ sessionHookedArchives: archCtx.sessionHookedArchives,
351
+ desktopUsedTokens: archCtx.desktopUsedTokens,
324
352
  smartCompactActive: archCtx.smartCompactActive,
325
353
  chiefPermissionMode: archCtx.chiefPermissionMode,
326
354
  linkedPeersCount: linked.linkedPeersCount,
@@ -543,6 +571,7 @@ export function createApiRoutes(deps) {
543
571
  text: typeof body.text === 'string' ? body.text : '',
544
572
  forcedTarget: typeof body.target === 'string' ? body.target : '',
545
573
  forcedMode: typeof body.mode === 'string' ? body.mode : 'steer',
574
+ quickAction: typeof body.quickAction === 'string' ? body.quickAction.trim().slice(0, 40) : '',
546
575
  images: Array.isArray(body.images) ? body.images : [],
547
576
  })
548
577
  const board = out.ok && sessionId ? boardForSession(boardFileFor(sessionId)) : undefined
@@ -620,7 +649,46 @@ export function createApiRoutes(deps) {
620
649
  const body = await readBody(req)
621
650
  const sessionId = typeof body?.session === 'string' ? body.session : ''
622
651
  const rootSid = resolveRootSessionId(sessionId) || sessionId || 'global'
623
- const updated = updateChiefConfig({ ...(body || {}), sessionId: rootSid })
652
+ const cleanBody = (body && typeof body === 'object') ? { ...body } : {}
653
+ delete cleanBody._fromUiPanel
654
+ if (cleanBody.toggleLockAgentEffort && typeof cleanBody.toggleLockAgentEffort === 'object') {
655
+ const lkTarget = String(cleanBody.toggleLockAgentEffort.target || 'lead').trim().slice(0, 64)
656
+ const lkVal = Boolean(cleanBody.toggleLockAgentEffort.locked)
657
+ const rawAliases = Array.isArray(cleanBody.toggleLockAgentEffort.aliases)
658
+ ? cleanBody.toggleLockAgentEffort.aliases.map(x => String(x || '').trim().slice(0, 64)).filter(Boolean)
659
+ : []
660
+ const shortT = lkTarget.includes('/') ? lkTarget.split('/').pop() : ''
661
+ const allKeys = Array.from(new Set([lkTarget, shortT, ...rawAliases].filter(Boolean)))
662
+ if (allKeys.length) {
663
+ const nextLocks = {
664
+ ...((cleanBody.lockedModelEfforts && typeof cleanBody.lockedModelEfforts === 'object') ? cleanBody.lockedModelEfforts : {}),
665
+ }
666
+ for (const k of allKeys) nextLocks[k] = lkVal
667
+ cleanBody.lockedModelEfforts = nextLocks
668
+ }
669
+ }
670
+ const updated = updateChiefConfig({
671
+ ...cleanBody,
672
+ sessionId: rootSid,
673
+ _fromUiPanel: true,
674
+ byUser: true,
675
+ by: 'operator',
676
+ })
677
+ let effortRes = null
678
+ if (updated && updated.ok !== false && body && body.directSetAgentEffort && typeof body.directSetAgentEffort === 'object') {
679
+ const chiefDeps = makeChiefDeps(runtime)
680
+ if (typeof chiefDeps.controlMainAgent === 'function') {
681
+ effortRes = await chiefDeps.controlMainAgent({
682
+ rootId: rootSid,
683
+ sessionId: sessionId || rootSid,
684
+ op: 'set_effort',
685
+ target: body.directSetAgentEffort.target || 'lead',
686
+ reasoningEffort: body.directSetAgentEffort.effort || 'medium',
687
+ reason: '用户从参谋面板手动调节模型思考强度',
688
+ byUser: true,
689
+ }).catch(err => ({ ok: false, error: String(err && err.message || err) }))
690
+ }
691
+ }
624
692
  const wantsInterventionOn = Boolean(body && body.tacticalModes && body.tacticalModes.intervention === true)
625
693
  const coreObjDraft = typeof body?.coreObjective === 'string' ? body.coreObjective.trim() : ''
626
694
  const targetSessionForBoard = sessionId || (rootSid !== 'global' ? rootSid : '')
@@ -639,10 +707,142 @@ export function createApiRoutes(deps) {
639
707
  if (rootSid && rootSid !== sessionId) deps.hostState.activeAutoContinue.cancelSession(rootSid, 'chief stopped')
640
708
  }
641
709
  }
710
+ let immediateKickoff = null
711
+ if (updated && updated.ok !== false && wantsInterventionOn && targetSessionForBoard && body && body.startImmediately === true) {
712
+ const boardNow = boardForSession(boardFileFor(targetSessionForBoard))
713
+ const lockedGoal = coreObjDraft || String((boardNow && boardNow.objective) || '').trim()
714
+ const stateNow = loadChiefState()
715
+ const ownWsNow = stateNow.workspaces && stateNow.workspaces[rootSid]
716
+ const cfgNow = resolveWorkspaceConfig(stateNow, rootSid)
717
+ const effectivePerm = normalizePermissionMode(cfgNow.permissionMode || DEFAULT_CHIEF_PERMISSION_MODE, {
718
+ requireAck: true,
719
+ hasChiefRiskAck: hasValidChiefRiskAck(ownWsNow),
720
+ })
721
+ const permRk = permissionRank(effectivePerm)
722
+ const agentsSvc = runtime && typeof runtime.get === 'function' ? runtime.get('agents') : null
723
+ const leadAg = agentsSvc && typeof agentsSvc.get === 'function' ? agentsSvc.get(targetSessionForBoard) : null
724
+ const leadRunning = Boolean(leadAg && leadAg.status === 'running')
725
+ if (lockedGoal && !cfgNow.stopped) {
726
+ const kickoffText = [
727
+ '【强介入已开启并锁定核心总目标 — 立即开始推进】',
728
+ `🎯 锁定核心总目标:${lockedGoal}`,
729
+ '请立即围绕上述已锁定的核心总目标核对当前看板任务与未完成项并直接推进执行(若已有待办先继续推进并在收尾时提交实测验证),无需等待用户再次手动输入“继续”。',
730
+ ].join('\n')
731
+ if (leadRunning) {
732
+ immediateKickoff = { triggered: false, alreadyRunning: true, mode: effectivePerm }
733
+ } else if (permRk >= 3) {
734
+ const chiefDeps = makeChiefDeps(runtime)
735
+ const delivRes = await deliverCrossMessage(chiefDeps, {
736
+ fromSession: rootSid,
737
+ fromLabel: 'DSH 参谋长 (强介入锁定目标立即推进)',
738
+ target: 'lead',
739
+ subject: '强介入已开启 · 立即围绕总目标推进',
740
+ text: kickoffText,
741
+ mode: 'followup',
742
+ envelopeKind: 'execution_request',
743
+ }).catch(err => ({ ok: false, error: String(err && err.message || err) }))
744
+ mutateChiefState((st) => {
745
+ const ws = ensureWorkspace(st, rootSid)
746
+ ws.chat.push({
747
+ id: nextId('chat'),
748
+ role: 'chief',
749
+ kind: 'receipt',
750
+ text: `- 【⚡ 强介入已锁定目标并立即推进】已自动向 \`@lead\` 下发首轮推进请求\n- 【🎯 锁定总目标】${lockedGoal.slice(0, 180)}`,
751
+ actions: [delivRes && delivRes.ok ? '⚡ 已立即唤醒推进' : '⚠️ 唤醒未送达'],
752
+ at: Date.now(),
753
+ })
754
+ if (ws.chat.length > CHAT_CAP) ws.chat = ws.chat.slice(-CHAT_CAP)
755
+ })
756
+ immediateKickoff = { triggered: Boolean(delivRes && delivRes.ok), mode: effectivePerm }
757
+ } else if (permRk === 2) {
758
+ queueChiefApproval(rootSid, {
759
+ category: 'main_workflow',
760
+ operationLabel: '强介入开启 · 立即唤醒主对话推进',
761
+ targetLabel: '主对话 (@lead)',
762
+ reason: '强介入已锁定核心总目标,按 L2 参谋模式请您一键放行首轮推进执行请求(之后无需手动发“继续”)',
763
+ impact: '允许后立即向 @lead 投递首轮强介入推进指令',
764
+ preview: lockedGoal.slice(0, 220),
765
+ kind: 'relay',
766
+ capabilityScope: buildCapabilityScope({ kind: 'relay', tool: 'relay', target: 'lead' }),
767
+ payload: {
768
+ fromSession: rootSid,
769
+ fromLabel: 'DSH 参谋 (强介入锁定目标立即推进)',
770
+ target: 'lead',
771
+ subject: '强介入已开启 · 立即推进',
772
+ text: kickoffText,
773
+ mode: 'followup',
774
+ envelopeKind: 'execution_request',
775
+ },
776
+ by: 'chief',
777
+ })
778
+ immediateKickoff = { triggered: false, queuedApproval: true, mode: effectivePerm }
779
+ } else {
780
+ mutateChiefState((st) => {
781
+ const ws = ensureWorkspace(st, rootSid)
782
+ const sug = normalizeSuggestion({
783
+ kind: 'relay',
784
+ fromAgent: '⚡ 强介入首轮就绪',
785
+ title: '立即向主对话发首轮强介入推进指令',
786
+ reason: `已锁定核心总目标并开启强介入(当前 ${effectivePerm === 'assistant' ? 'L1 助手档' : 'L0 顾问档'},无权直改主对话工作流;升至 L2/L3 即可全自动推跑)。`,
787
+ target: 'lead',
788
+ targetLabel: '主对话 (@lead)',
789
+ mode: 'followup',
790
+ draftText: kickoffText,
791
+ })
792
+ if (sug) {
793
+ ws.suggestions.push(sug)
794
+ if (ws.suggestions.length > SUGGESTIONS_CAP) ws.suggestions = ws.suggestions.slice(-SUGGESTIONS_CAP)
795
+ }
796
+ ws.chat.push({
797
+ id: nextId('chat'),
798
+ role: 'chief',
799
+ kind: 'receipt',
800
+ text: `- 【⚡ 强介入已锁定核心总目标(当前 ${effectivePerm === 'assistant' ? 'L1' : 'L0'} 仅监督待命)】已生成首轮推进建议,升至 L2/L3 即可直接自动推动 \`@lead\`。\n- 【🎯 锁定总目标】${lockedGoal.slice(0, 180)}`,
801
+ actions: ['🎯 目标已锁定'],
802
+ at: Date.now(),
803
+ })
804
+ if (ws.chat.length > CHAT_CAP) ws.chat = ws.chat.slice(-CHAT_CAP)
805
+ })
806
+ immediateKickoff = { triggered: false, queuedSuggestion: true, mode: effectivePerm }
807
+ }
808
+ }
809
+ }
810
+ const cfgActive = updated && updated.config ? updated.config : null
811
+ const switchedToActiveRunOrIntv = Boolean(
812
+ wantsInterventionOn
813
+ || body?.runMode === 'managed'
814
+ || body?.runMode === 'patrol'
815
+ || body?.paceMode === 'auto'
816
+ || body?.paceMode === 'smart'
817
+ || body?.autoPilot === true,
818
+ )
819
+ if (
820
+ updated
821
+ && updated.ok !== false
822
+ && targetSessionForBoard
823
+ && !(immediateKickoff && immediateKickoff.triggered)
824
+ && cfgActive
825
+ && !cfgActive.stopped
826
+ && cfgActive.tacticalModes
827
+ && cfgActive.tacticalModes.intervention === true
828
+ && switchedToActiveRunOrIntv
829
+ ) {
830
+ const agentsSvcNow = runtime && typeof runtime.get === 'function' ? runtime.get('agents') : null
831
+ const leadAgNow = agentsSvcNow && typeof agentsSvcNow.get === 'function' ? agentsSvcNow.get(targetSessionForBoard) : null
832
+ if (leadAgNow && leadAgNow.status !== 'running') {
833
+ scheduleChiefTurnReview(makeChiefDeps(runtime), {
834
+ agent: leadAgNow,
835
+ sessionId: targetSessionForBoard,
836
+ abnormalTrigger: 'config_activated',
837
+ })
838
+ }
839
+ }
642
840
  const view = await getChiefView(makeChiefDeps(runtime), sessionId, { autoSummarize: false })
643
841
  const latestBoard = targetSessionForBoard ? boardForSession(boardFileFor(targetSessionForBoard)) : null
644
842
  sendJson(res, updated && updated.ok === false ? 400 : 200, {
645
843
  ...updated,
844
+ ...(effortRes ? { effortRes } : {}),
845
+ ...(immediateKickoff ? { immediateKickoff } : {}),
646
846
  ...(latestBoard ? { board: latestBoard } : {}),
647
847
  view,
648
848
  })
@@ -1159,6 +1359,7 @@ export function createApiRoutes(deps) {
1159
1359
  folder: typeof body.folder === 'string' ? body.folder : '',
1160
1360
  scope: typeof body.scope === 'string' ? body.scope : 'unorganized',
1161
1361
  instruction: typeof body.instruction === 'string' ? body.instruction : '',
1362
+ ...(typeof body.reasonKind === 'string' && body.reasonKind ? { reasonKind: body.reasonKind } : {}),
1162
1363
  })
1163
1364
  const stNow = loadChiefState()
1164
1365
  const wsNow = rootSid && stNow.workspaces ? stNow.workspaces[rootSid] : null