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/README.md CHANGED
@@ -1,20 +1,20 @@
1
1
  <div align="center">
2
2
 
3
- **AI 管 AI,你当甩手掌柜 —— 你不在的时候,它也替你盯着。**
4
- <sub>它自己派活、自己盯子代理、自己收口;跑偏了先熔断,不用你守着屏幕。</sub>
3
+ **给 DeepSeek Harness(DSH)用的右侧栏任务看护、防压缩忘事与权限管控面板**
4
+ <sub>长对话 `/compact` 前先存参数再压缩,子代理进度一屏看完,改文件跑命令前逐项弹窗问你。</sub>
5
5
 
6
- <img src="assets/chief-10s-compare.gif" alt="10 秒看懂 dsh-chief:左边是原生长会话——循环重读、压缩丢参数、跨窗失忆;右边是参谋长——一键熔断、参数先入柜、归档随取。默认只读起手" width="800" />
6
+ <img src="assets/chief-10s-compare.gif" alt="对比原生长会话与挂载 dsh-chief 后的效果:左边循环重读、压缩丢参数、跨窗失忆;右边先入柜再压缩、可随时熔断、带交接单换窗继续" width="800" />
7
7
 
8
- <sub>默认只读起手 · 越权改工作区会先问你 · `dsh plugin --profile web add dsh-chief`</sub>
8
+ <sub>默认只读起手 · 越权操作前先确认 · `dsh plugin --profile web add dsh-chief`</sub>
9
9
 
10
10
  <br />
11
11
 
12
- <img src="assets/hero-banner.png" alt="DSH 参谋长 (dsh-chief) v1.2.0 — 许愿式一站式多代理指挥与三层冷库中枢" width="100%" />
12
+ <img src="assets/hero-banner.png" alt="dsh-chief 面板主视图" width="100%" />
13
13
 
14
14
  <br />
15
15
 
16
- # ✦ DSH 参谋长 (`dsh-chief`)
17
- ### DeepSeek Harness 多智能体指挥舱 · ✦ 许愿框一站式办理 · 三层 0-Token 档案金库 · `✦ 智选压缩`
16
+ # DSH 参谋长 (`dsh-chief`)
17
+ ### DeepSeek Harness 右侧常驻多代理看护、0-Token 本地档案柜与安全审批面板
18
18
 
19
19
  [![DSH Compatibility](https://img.shields.io/badge/DSH-%3E%3D%200.2.2--rc.2-38bdf8?style=flat-square)](https://dsh.deepseek.com)
20
20
  [![npm version](https://img.shields.io/npm/v/dsh-chief?color=cb3837&style=flat-square)](https://www.npmjs.com/package/dsh-chief)
@@ -25,8 +25,8 @@
25
25
  [![Zero Dependencies](https://img.shields.io/badge/Dependencies-0%20External-ffe033?style=flat-square)](#)
26
26
  [![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-f87171?style=flat-square)](LICENSE)
27
27
 
28
- > **不盯着也不出事:向右侧「✦ 许愿框」许下意图,它自己把流程跑完,跑歪了先拦住(`v1.3.0`)**
29
- > 做法对齐 DeepSeek 官方 **[SuperAgent (`dsh-superagent-prototype`)](https://github.com/deepseek-ai/dsh-superagent-prototype)** 的「Router 统筹 + Workers 隔离执行」:把散装聊天窗收成一张常驻指挥台。
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
- ## 🔗 与 SuperAgent 及 DSH 原生能力深度联动
37
+ ## 主要解决哪些日常麻烦
38
38
 
39
- - **模块化低耦合架构(`v1.3.0`)**:29 个后端与 16 个前端单一职责模块协同(无环依赖、零可变导出),搭配跨进程/多线程 `O_EXCL` 自旋锁与 `chief-audit.jsonl` 只追加审计账本,兼顾长期可维护性与高并发鲁棒性。
39
+ 写代码和跑长会话时最常踩的几个坑,这个面板逐个给了工程上的硬兜底。
40
40
 
41
- - **常驻指挥中枢**:把主对话、子代理和跨窗独立会话收拢到同一张**全铺开金字塔拓扑图**,不再在十几个黑盒标签页间来回切换。
42
- - **原生分屏盯流 (`subagentchat`)**:任意子代理卡片点击「`分屏`」,直连 `sidebarRight.openResource` 拉开实时推理流。
43
- - **默认只读,先看后动 (`chief-executor`)**:新开与接力的会话都从只读起手 —— 先观察、先出方案;要改工作区、跑命令、调度子代理,得逐项拿到你的允许,敏感动作弹窗确认并留审计日志。
44
- - **空白新对话即开即用**:主对话尚未发送第一条消息时,自动定位当前工作区开工,或预埋待领包给即将开启的 `@lead`。
45
- - **目标锁死 + 人类拍板结项**:强介入锁定核心目标(支持 `0 = ♾️` 无限轮),达标后核验 `allowed` 必做清单并等待人类点击「`✅ 批准结项`」。
46
- - **✦ 智选压缩 + 灵活安全阈值**:支持 `✦ 智选压缩` 在阶段收口等主代理空闲后触发,也支持 `10%–95%` / `>= 8k` Token 阈值或直说「压缩吧」。
47
- - **跨隔离真 `/compact`**:自动跨过 Cordis 服务隔离调用官方 `/compact` 通道,先抢救工程细节入柜并复核落盘,再静默压缩留回执。
48
- - **三层 0-Token 档案金库**:💬 本会话柜(1:1 隔离)、🌐 系统全局冷库(双向差分)、🏛️ 沉淀冷库(默认双盲 0 字节),支持一键「`📌 摆上桌面`」与「`组合递话`」。
49
- - **跨窗协同与定住防改交接单**:入网前提示污染风险、断联立即净化防串味,支持手改与一键「`📌 定住防改`」冻结交接快照。
41
+ ### 1. 上下文一压缩(`/compact`)就忘了前面查出来的路径和命令
42
+ - 常见状况:对话一长触发压缩,刚找到的配置路径、端口、报错行号和回滚命令全被摘要吃掉,模型回头重读文件、重新踩坑。
43
+ - `dsh-chief` 的做法:支持 `✦ 智选压缩`、自定义 `10%–95%` 或 `>= 8,000` Token 触发线,也支持直接在右侧输入「压缩吧」。
44
+ - 压缩顺序固定为「先抢救细节并校验写入本会话档案柜 → 再静默调用宿主 `/compact`」。如果没产生历史消息或压缩报错,计数绝不虚增。
50
45
 
51
- ---
52
-
53
- ## 💡 为什么需要「DSH 参谋长」?(6 大日常痛点 × 独家破局机制)
54
-
55
- 普通待办只是多了一块手写备忘录,常驻记忆只是每轮往提示词里硬塞几千字旧账;**`dsh-chief` 把「人盯 AI 干活」反转为「许愿式一站式跑通」**。
46
+ ### 2. 长任务跑到一半停下,或者丢下一句“改好了你自己测”
47
+ - 常见状况:无人值守或挂机跑多步改动时,模型跑完一半就汇报完成,漏掉测试和构建验证。
48
+ - `dsh-chief` 的做法:用核心目标锁死最终验收标准,可开启 `⚡ 主动强介入`(支持 `0 = ♾️` 无限轮自动续推,自带无进展熔断),必须核验完 `allowed` 必做清单并由你点击 `✅ 批准结项` 才会停表。
49
+ - 想立刻收回控制权时,点击输入栏红色 `⏹ 急停` 直接打断后台驱动。
56
50
 
57
- ### 1. AI 半途偷懒交差(“改好了你自己测吧”)
58
- - **普通插件**:只有静态文字清单,模型自说自话就能宣布完成。
59
- - **`dsh-chief` 解法**:用「🎯 目标督导」+「⚡ 强介入(`0 = ♾️` 无限轮)」锁死终点,未核验 `allowed` 必做清单且未获你点击「`✅ 批准结项`」绝不放行。
60
- - **可控急停**:触发高危动作前先弹窗确认,随时点击红色 **「⏹ 急停」** 秒切人工接管。
51
+ ### 3. 常驻记忆插件每轮塞几千字进提示词,烧 Token 还把模型带偏
52
+ - 常见状况:普通记忆插件每次发消息都把几十条过时笔记硬塞进 System Prompt,主模型被无关旧账带偏,费用还高。
53
+ - `dsh-chief` 的做法:把工程档案放进三层本地冷库(本会话柜 / 全局柜 / 沉淀柜),**封存时向主对话注入 0 字节、0 Token**。
54
+ - 平时不进上下文,需要参考哪几份卷宗时再点 `📌 摆上桌面` 或 `📤 取出`,用完点 `放回` 就从提示词撤下。
61
55
 
62
- ### 2. 上下文一压缩就“脑叶切除”式失忆
63
- - **普通插件**:压缩一触发,刚查出来的路径、命令和结论全被抹光。
64
- - **`dsh-chief` 解法**:支持「`✦ 智选压缩`」、`10%–95%` / `>= 8k` Token 阈值,以及一句「压缩吧」确定性办理。
65
- - **原子保底**:强制先抢救细节入本会话档案柜并核验落盘,再跨隔离静默 `/compact`;失败或免压绝不虚增计数。
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
- ### 3. 传统记忆插件把对话模型“脑子”搅浑、Token 越用越多
68
- - **普通插件**:每轮把几十篇过时笔记硬灌进 System Prompt,烧 Token 还干扰当下推理。
69
- - **`dsh-chief` 解法**:三层冷库平时 **0 字节 / 0 Token 物理隔离**,沉淀库默认双盲不可见。
70
- - **精准按需**:只有你点击「`📌 摆上桌面`」或「`📤 取出`」时才临时注入,点回封存即刻归零。
64
+ ### 5. 子代理开了一堆,不知道谁卡住、谁在空转
65
+ - 常见状况:多个子代理并行干活时分散在不同标签页里,挨个点开看推理流很费劲,口头叮嘱的规矩聊几轮就忘。
66
+ - `dsh-chief` 的做法:任务页按主代理与子代理展开树状卡片,支持原地改状态、白话追问某一步、以及点击 `分屏` 直接拉起实时推理流;边界页支持点亮 `📌` 图钉把全局红线跨任务固定下来。
71
67
 
72
- ### 4. 只敢嘴上聊天的“吉祥物副驾”,一放权就裸奔
73
- - **普通插件**:要么只能看不能动,要么一放权就全盘裸奔,改坏了你的文件你也不知道。
74
- - **`dsh-chief` 解法**:默认只读,越权一项项问你 —— 你不管的时候它也不会乱来:
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
- ## 📸 全景实机导览(`v1.2.0` 7 大核心视窗)
74
+ ## 界面与功能说明
91
75
 
92
- ### 01 · 许愿式参谋指挥舱(`参谋` 页签)
93
- - **实权许愿框**:输入栏居左收拢 `+` 战术驾驶舱,上方直显 `⚡ 强介入 0/♾️`、`✦ 智选压缩`、`🛡 红线哨兵`、`🔵 完全权限` 与红色 `⏹ 急停`。
94
- - **可见工作回执**:结构化战场摘要、边界请示卡、以及 `✦ 智选压缩` 真实压完后写回的可见回执一目了然。
95
- - **同步交接单开关**:右上角可直接切换「提炼摘要后同步更新交接单」。
76
+ ### 01 · 参谋主面板(`参谋` 页签)
77
+ - 底部输入框可指派参谋查看代码、让主对话实施改动、手搓物理驻墙或整理档案,按钮统一居中下右下对齐不乱跑。左上角状态胶囊汇总了 `⚡ 强介入`、`✦ 智选压缩`、`🛡 红线哨兵`(开启时会亮起红色胶囊和红盾图标)与当前权限档位,旁边就是红色 `⏹ 急停`。
78
+ - 开启「主动强介入」的确认窗会把当前生效的「物理驻墙」和「禁止红线」同框列出来(点「管理边界」或「一键收起/拉开」就能核对)。
79
+ - 对话区支持 `全部 / 💬 问答 / 📋 回执` 筛选,每一组问答和回执用高对比柔光外框包在一起,支持单组或一键全部收起/拉开;多条建议收拢在顶部 `▶ 执行建议`。参谋长在后台忙于自动审查、收档或手搓墙时,面板会自动切到对应页签,亮起流动渐变和双束跑马光线外框并用毛玻璃字样告诉你它正在干嘛。
96
80
 
97
- ![01 - 许愿式参谋长全景指挥舱](assets/screenshots/01-chief-cockpit-overview.png)
81
+ ![01 - 参谋长主面板](assets/screenshots/01-chief-cockpit-overview.png)
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 - 全铺开金字塔任务拓扑" width="76%" />
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 · 三层 0-Token 档案金库与双向差分(`档案` 页签)
112
- - **三库严格隔离**:顶部一键切换 **💬 本会话档案柜**(1:1 隔离)、**🌐 全局档案柜**(系统冷库不跟会话)与 **🏛️ 沉淀档案柜**(跨会话双盲冷封存)。
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 - 三层 0-Token 档案金库与双向差分" width="68%" />
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 - 核心目标督导与步骤追问解读" width="68%" />
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
- - **跨窗协同集群**:一键串联多个独立 DSH 主窗口互享实时进度;断开链接立即净化外部记忆与缓存防串味。
134
- - **彩色抽屉信箱**:按全网广播(`@all` 自动去重)、多方协作与各窗口会话内部信箱分色归档。
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 - 跨窗口独立会话串联与协同网络" width="68%" />
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
- - **必做清单与撞墙呈批**:支持「必做事项 (`allowed`)」「禁止红线 (`forbidden`)」「注意事项 (`notes`)」,支持子代理撞墙呈批与一键浓缩合并多条旧规则。
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 - 图钉全局红线与参谋长边界请示" width="68%" />
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
- - **4 档档案跟随策略**:新建或接力至已有会话时,自由选择「不带工作档案 / 仅挂桌面备查 / 带整个抽屉 / 全柜工作档案」,沉淀冷库保持绝对隔离。
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 - 跨会话接力与定住防改交接单" width="68%" />
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
- > [!IMPORTANT]
167
- > 启用「✦ 许愿框实权执行」「⚡ 主动强介入」「✦ 智选压缩」前,请务必牢记以下两条客观规律:
145
+ > [!NOTE]
146
+ > 开启实权工具、`⚡ 主动强介入` 或 `✦ 智选压缩` 前,下面两点直接决定使用体感:
168
147
  >
169
- > 1. **能力下限靠本插件工程护栏兜底,能力上限完全取决于底层大模型**
170
- > - 本插件通过 0-Token 冷隔离、默认只读越权先问、先落盘复核再压缩、轮数熔断与 `⏹ 急停` 守住安全下限。
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 右侧常驻参谋舱 (client.js)"]
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["宿主协调与存储内核 (Zero External Deps)"]
194
- Hot["热工作板 & 精炼热摘要\nboard.json / boards/session-*.json"]
195
- Cold["本会话档案柜 + 系统全局冷库 + 沉淀冷库\ncabinets/ + global-vault/ + precipitated/vault-global.json"]
196
- Bus["4 档实权执行器、信使与原图落盘\nchief-executor.js + auto-continue.js + idle-guard.js"]
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["当前主代理 (Root Coordinator)"]
201
- Subs["子代理纵队 (@arch / @dev / @bench)"]
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 <-->|"25 条同源环回守卫 API (/api/dsh-chief/*)"| Core
206
- Hot -->|"紧凑态势注入"| Lead
207
- Hot -->|"紧凑态势注入"| Subs
208
- Cold -.->|"三层冷库 0 Token 隔离\n仅「📌 摆上桌面」或取出时注入"| Lead
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
- 在 DSH 已安装 [dshmarket](https://github.com/dsh-market/dsh-market) 后可直接搜索 **`dsh-chief`**(或 **`DSH 参谋长`**)点击安装,也可使用 CLI 一键装入(`web` 环境把 `desktop` 改为 `web`):
196
+ 在已装好 [dshmarket](https://github.com/dsh-market/dsh-market) 的 DSH 里直接搜 **`dsh-chief`** 或 **`DSH 参谋长`** 就能点安装,也可以用命令行(网页版把 `desktop` 换成 `web`):
217
197
 
218
198
  ```bash
219
- # 方式 1:通过 npm 官方源安装最新版(v1.3.0,国内自动走镜像加速,支持后续检测升级)
199
+ # 方式 1:通过 npm 安装最新版(v1.4.0)
220
200
  dsh plugin --profile desktop add dsh-chief
221
201
 
222
- # 方式 2:安装历史归档 GitHub Release 预构建包(v1.2.1 归档快照)
223
- dsh plugin --profile desktop add https://github.com/gluztm/dsh-chief/releases/download/v1.2.1/dsh-chief-1.2.1.tgz
224
-
225
- # 方式 3:通过 GitHub 仓库源码直接安装
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
- 安装后刷新 DSH 界面(或重启客户端),点击工作区右上侧栏 **✦ `DSH 参谋长`** 图标即可展开指挥舱。
209
+ 装好后重启或刷新 DSH 客户端,点工作区右上角 **✦ `DSH 参谋长`** 图标打开面板。
230
210
 
231
- ### 宿主版本兼容性矩阵
211
+ ### 宿主版本兼容表
232
212
 
233
- | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层冷库 / 许愿框 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
213
+ | DeepSeek Harness (DSH) 版本 | 面板 / 看板 / 三层档案柜 / 事前物理墙 | 命名子代理树 (`task.dispatch` / `team.*`) | 说明 |
234
214
  | :--- | :---: | :---: | :--- |
235
- | **`>= 0.2.2-rc.2`(推荐 `rc.3+`)** | ✅ 完整支持 | ✅ 完整支持 | 原生提供 `subagents.resolveName` / `rootOf` / `namesOf` |
236
- | `0.2.0 ~ 0.2.2-rc.1` | ✅ 正常挂载 | ⚠️ 提示升级 | 旧版子代理 API;面板自动给出升级引导并拦截风险调用 |
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
- ## 🛠️ 模型工具矩阵(4 Tools)
221
+ ## 注册给模型的 4 个工具
241
222
 
242
- 装入后向模型注册 4 个结构化工具(动作层兼容原生 JSON 数组与宽容文本传参):
223
+ 插件只读注册 4 个结构化工具,动作参数一并兼容严格 JSON 与常见文本写法:
243
224
 
244
- | 工具名 | 核心职责 | 典型高频动作 (`action`) |
225
+ | 工具名 | 用途 | 常用动作 (`action`) |
245
226
  | :--- | :--- | :--- |
246
- | **`chief_board`** | 驱动任务图、小任务板、冷档案检索、跨代理信箱、提权请示与协同压缩 | `graph.plan`、`task.add`、`task.update`、`plan.set`、`cursor.set`、`mail.send`、`archive.save`、`archive.search`、`bounds.propose`、`permission.request`、`context.compact` |
247
- | **`chief_memory`** | 读写会话级高密度热记忆(决策 / 进展 / 验证 / 风险) | `list`、`get`、`add`、`update`、`remove` |
248
- | **`chief_boundaries`** | 维护图钉全局红线(`📌`)、必做事项(`allowed`)与注意事项 | `get`、`set`、`add`、`pin`、`remove` |
249
- | **`chief_handoff`** | 预览与生成自包含跨会话 Markdown 交接单 | `preview` / 新会话接力包 |
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
- - **原子写锁零丢失**:`board.json` 与三库档案文件均受基于 `wx` 排他文件锁 + 陈旧锁自动回收保护,并发写锁零损坏。
256
- - **三层冷库零泄漏**:冷封存卷宗平时 **0 字节**注入主对话,仅在显式「摆上桌面」或「取出」时按需加载。
257
- - **25 条同源环回守卫**:全部 `/api/dsh-chief/*` 接口强制验证 Loopback 地址与同源 `Origin/Host`,防跨站诱导。
258
- - **敏感凭据正则硬拦截**:自动拒存 `sk-*`、`ghp_*`、Bearer Token 与 OpenSSH 私钥,所有数据 100% 存放在本机 `~/.dsh/chief/`,零遥测、零云端上报。
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
- ## 📄 开源许可 (License)
254
+ ## 开源协议
263
255
 
264
- 基于 **[GNU Affero General Public License v3.0 (`AGPL-3.0-only`)](LICENSE)** 开源发布。欢迎使用、审计与提交 PR。
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 { DEFAULT_CHIEF_PERMISSION_MODE } from './chief-executor.js'
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(body)
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 { DEFAULT_CHIEF_PERMISSION_MODE, normalizePermissionMode } from './chief-executor.js'
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)
package/board-schema.js CHANGED
@@ -8,7 +8,7 @@ import { normalizeMemory } from './memory.js'
8
8
 
9
9
  export const API = '/api/dsh-chief'
10
10
 
11
- export const BACKEND_BUILD = '1.3.0'
11
+ export const BACKEND_BUILD = '1.4.0'
12
12
 
13
13
  export const BOARD_VERSION = 1
14
14