dsh-agent-vault 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.3.0 — 2026-10-21
+
+### 新增
+
+- **自动开启新对话**：接力页签新增开关「检查点后自动开启新对话」。当前会话写下检查点、且该回合结束后，客户端自动新建一个会话并切过去——继承源会话的工作区、绑定、审批策略、模型与 Agent preset（模式），旧会话自动归档。
+- 触发条件（客户端 5 秒轮询）：检查点会话必须是**当前选中**的会话、已生成检查点且带有交接意图、当前没有运行中的回合；只触发一次，不会在不同会话之间乱跳。
+- `handoff.status` 每个会话新增 `workspaceId` 与 `agentPreset`，`handoff.arm` 响应同步带 `agentPreset`，供客户端切换时定位工作区并沿用模式。
+
+### 修复
+
+- 续会话 / 自动切换生成的新会话会丢掉当前模式：原来回落到默认 Agent preset（如 `standard`），现在沿用源会话当前的 preset（如「创造模式」）。preset 读取 `agentPreset` 投影（实时切换后的值），旧 host 回退到 session header。
+
+### 说明
+
+- 自动切换是客户端行为，需要 DSH 页面/面板在运行；关闭页面就不会触发。
+- 与手动「续会话」走同一条继承链路，只是把点击省掉了。
+- 客户端改动需要刷新页面（或重启应用）后生效。
+
 ## 1.2.0 — 2026-10-21
 
 ### 包名

package/README.md

@@ -32,7 +32,7 @@ DSH 的会话本身是无状态的。跨任务时，你需要自己把上下文
 | 知识库自主查 | `agent_knowledge_search` / `read` / `write` 由模型自行决定调用 |
 | 讨论室 | 可建多个房间；用户指定哪些智能体加入，成员可中途加入或退出；每条发言标注是哪个智能体说的 |
 | 私有日志 | 每个智能体一份详细的日记式记录，**只有它自己能读写**，按需检索，不自动注入 |
-| 接力（检查点） | 上下文到阈值时提醒模型先写记忆和日志，两件都完成后自动把检查点写进该智能体的日志；可选额外导出 markdown；settle 后新会话自动继承绑定、审批策略与模型，面板「续会话」一键续到新会话 |
+| 接力（检查点） | 上下文到阈值时提醒模型先写记忆和日志，两件都完成后自动把检查点写进该智能体的日志；可选额外导出 markdown；settle 后新会话自动继承绑定、审批策略与模型，面板「续会话」一键续到新会话；可开启「检查点后自动开启新对话」 |
 | 自动归档 | 续会话/新会话接管后，旧会话自动转为**归档**（只读、可查看、不能继续）；面板「对话」页签可取消归档、转**强归档**（侧栏隐藏、面板灰色）或转回归档 |
 
 ## 安装
@@ -160,7 +160,7 @@ dsh plugin --profile <你的 profile> add /path/to/dsh-agent-memory
 
 「接力」页签的会话列表里，处于等待沉淀或已生成检查点的会话那一行会有「重置」。它只清掉该会话的阶段记录，让它重新从 `watching` 开始；已经写进日志的检查点**不会删除**。适合手动压缩过上下文、或者想在同一会话里再走一轮的时候。
 
-v1 只做「沉淀」，**不会自动切换会话**。检查点落盘后会记一个 30 分钟内有效的「下一会话」意图：在这个目录里新建的会话会自动绑定同一智能体，并继承审批策略与模型（`resume`、子智能体和已绑定的会话不会误消费）。面板的「续会话」按钮把意图刷新 + 新建会话合成一步，并让新会话落在源会话所在的工作区。自动切换（不经用户点击）和旧会话自动归档仍未实现，API 事实与剩余工作见 [docs/handoff-v2.md](docs/handoff-v2.md)。
+检查点落盘后会记一个 30 分钟内有效的「下一会话」意图：在这个目录里新建的会话会自动绑定同一智能体，并继承审批策略、模型与 Agent preset（`resume`、子智能体和已绑定的会话不会误消费）。面板的「续会话」按钮把意图刷新 + 新建会话合成一步，并让新会话落在源会话所在的工作区、沿用源会话的模式。开启「检查点后自动开启新对话」后，客户端在回合结束、会话空闲时自动完成这套切换，旧会话自动归档；API 事实与实现细节见 [docs/handoff-v2.md](docs/handoff-v2.md)。
 
 ## 面板
 

package/client.js

@@ -124,6 +124,8 @@ window.__ModuleLoader__.load({
         handoffExportHint: '填了就额外写一份 markdown 到该目录；日志始终是唯一真相。',
         handoffSessions: '当前会话压力',
         handoffNoSessions: '当前没有活动会话。',
+        autoSwitch: '检查点后自动开启新对话',
+        autoSwitchHint: '当前会话写下检查点、且这个回合结束后，自动新建一个对话并切过去（继承绑定、工作区、审批策略与模型），旧会话转为归档。需要面板保持打开或页面在运行。',
         'stage.off': '已关闭',
         'stage.watching': '观察中',
         'stage.due': '已到阈值',
@@ -269,6 +271,8 @@ window.__ModuleLoader__.load({
         handoffExportHint: 'When set, a markdown copy is written there too; the journal stays the source of truth.',
         handoffSessions: 'Current session pressure',
         handoffNoSessions: 'No live sessions right now.',
+        autoSwitch: 'Start a new conversation after a checkpoint',
+        autoSwitchHint: 'Once the current session has a checkpoint and its turn is over, a fresh conversation opens automatically in the same workspace with the inherited agent, approval policy and model; the old one is archived.',
         'stage.off': 'off',
         'stage.watching': 'watching',
         'stage.due': 'at threshold',
@@ -840,8 +844,12 @@ window.__ModuleLoader__.load({
           setFailure(t('handoffNoWorkspace'))
           return
         }
-        // Inherit the source session's workspace, not whatever tab was last used.
-        ui.startSession(armed.workspaceId || undefined)
+        // Inherit the source session's workspace and Agent preset, not whatever
+        // tab or mode was last used.
+        ui.startSession(
+          armed.workspaceId || undefined,
+          armed.agentPreset ? { agentPreset: armed.agentPreset } : undefined,
+        )
         setHandoffVersion(item => item + 1)
       }
 
@@ -1364,6 +1372,13 @@ window.__ModuleLoader__.load({
               disabled: busy !== '',
               onChange: checked => void saveHandoff({ enabled: checked }),
             }),
+            h(Switch, {
+              checked: handoffInfo?.config?.autoSwitch === true,
+              label: t('autoSwitch'),
+              hint: t('autoSwitchHint'),
+              disabled: busy !== '',
+              onChange: checked => void saveHandoff({ autoSwitch: checked }),
+            }),
             h(Field, { label: t('handoffThreshold') }, h('input', {
               className: 'am-input',
               type: 'number',
@@ -2065,6 +2080,7 @@ window.__ModuleLoader__.load({
         let sectionOpen = true
         let lastAgents = []
         let bannerSessionId = ''
+        const autoSwitched = new Set()
         let observer = null
         let observedRoot = null
         const collapsed = new Set()
@@ -2248,6 +2264,38 @@ window.__ModuleLoader__.load({
             } else if (banner !== null) {
               banner.remove()
             }
+            // Auto handoff: when the selected session has just written a
+            // checkpoint and its turn is over, open a fresh conversation.
+            if (state?.capabilities?.arm === true && selectedId !== '') {
+              const statusPayload = await request('/op', {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ op: 'handoff.status', args: {} }),
+              })
+              if (stopped) return
+              const status = statusPayload.value
+              if (status?.config?.autoSwitch === true) {
+                const row = (status.sessions ?? []).find(item => item.sessionId === selectedId)
+                const running =
+                  lastAgents.flatMap(agent => agent.sessions).find(item => item.sessionId === selectedId)?.running === true
+                if (row?.stage === 'settled' && row.armed === true && !running && !autoSwitched.has(selectedId)) {
+                  const ui = ctx.get('uiWorkspace')
+                  if (ui !== undefined && typeof ui.startSession === 'function') {
+                    autoSwitched.add(selectedId)
+                    try {
+                      // Keep the conversation's mode: a fresh Session starts on
+                      // the default preset unless we pass the source one along.
+                      ui.startSession(
+                        row.workspaceId || undefined,
+                        row.agentPreset ? { agentPreset: row.agentPreset } : undefined,
+                      )
+                    } catch {
+                      autoSwitched.delete(selectedId)
+                    }
+                  }
+                }
+              }
+            }
           } catch {
             /* the API may not be mounted yet */
           }

package/docs/handoff-v2.md

@@ -1,6 +1,6 @@
 # 接力 v2：自动续会话的设计草案
 
-> 状态：**1.1/1.2 已实现**：settle 时武装 `next` 意图，`agent/created` 自动继承绑定、审批策略与模型，面板「续会话」按钮一步新建会话并继承源会话的工作区（1.2）。**未实现**（留到下一个版本）：自动切换（不经点击）、旧会话自动归档。本文件保留 API 事实与剩余工作。
+> 状态：**1.3 已完成**：settle 时武装 `next` 意图，`agent/created` 自动继承绑定/审批/模型；面板「续会话」一步新建并继承源工作区；开启「检查点后自动开启新对话」后，客户端在回合结束、会话空闲时自动切到新会话（旧会话自动归档）。自动切换是客户端轮询实现（5 秒），需要页面在运行。
 
 ## 目标
 
@@ -70,10 +70,18 @@
 - `handoff.status` 返回 `capabilities.arm`，旧主机（没重启）下按钮自动隐藏，不会露出必然报错的入口；
 - 测试：`test-handoff.mjs` 覆盖一次性/cwd/过期/模型透传，`test-host.mjs` 覆盖 resume 不消费、subagent 不抢、startup 绑定 + 策略 + 模型继承 + 不复用。
 
-## 尚未实现（下个版本）
-
-- **自动切换**：仍要用户点「续会话」（或自己新建会话），插件不会在回合中途替用户切走；
-- **旧会话归档**：面板没有做 archive，旧会话留在列表里。
+## 自动切换（1.3 已实现）
+
+- 接力页签开关 `autoSwitch`（handoff.json 里的布尔值，默认关）；
+- 客户端每 5 秒拉一次 `handoff.status`，触发条件全部满足才切：
+  1. `config.autoSwitch === true`；
+  2. 检查点会话就是**当前选中**的会话；
+  3. `stage === 'settled'` 且 `armed === true`（检查点写入时武装的意图还在 30 分钟有效期内）；
+  4. 该会话当前没有运行中的回合（`bound.list` 的 `running` 为 false）；
+  5. 同一个 session 只触发一次。
+- 触发后 `uiWorkspace.startSession(row.workspaceId, { agentPreset: row.agentPreset })`；新会话的 `agent/created` 消费意图，继承绑定/审批/模型，并把旧会话记为归档。
+- 模式（Agent preset）由客户端透传：`handoff.status` 每行从 `agentPreset` 投影读当前 preset（实时切换后的值，不是 header），`handoff.arm` 响应也带同一个字段，供手动「续会话」复用。
+- 这是客户端行为：DSH 页面关掉就不会切换；也不在回合中途切，避免把正在生成的回答甩在旧会话里。
 
 ### 4. 未决问题
 

package/handoff.js

@@ -65,6 +65,7 @@ export function createHandoff(options = {}) {
       triggerTokens: clampTokens(raw.triggerTokens, DEFAULT_TRIGGER_TOKENS),
       remindEverySteps: Math.min(Math.max(Math.round(Number(raw.remindEverySteps) || DEFAULT_REMIND_EVERY), 1), 20),
       exportDir: typeof raw.exportDir === 'string' ? raw.exportDir.trim() : '',
+      autoSwitch: raw.autoSwitch === true,
     }
   }
 
@@ -77,6 +78,7 @@ export function createHandoff(options = {}) {
       next.remindEverySteps = Math.min(Math.max(Math.round(Number(patch.remindEverySteps) || current.remindEverySteps), 1), 20)
     }
     if (typeof patch.exportDir === 'string') next.exportDir = patch.exportDir.trim()
+    if (typeof patch.autoSwitch === 'boolean') next.autoSwitch = patch.autoSwitch
     writeAtomic(files.config, `${JSON.stringify(next, null, 2)}\n`)
     return next
   }

package/index.js

@@ -472,6 +472,28 @@ function sessionCwd(ctx, sessionId) {
   }
 }
 
+/**
+ * The Agent preset a Session actually runs. DSH keeps this in the
+ * `agentPreset` projection (a live preset switch appends an event without
+ * touching the immutable header), so read the projection first and only fall
+ * back to the header on older hosts.
+ */
+function agentPresetOf(ctx, sessionId) {
+  try {
+    const session = sessionOf(ctx, sessionId)
+    if (session === undefined) return ''
+    const projections = ctx.get('sessionProjections')
+    if (projections !== undefined && typeof projections.stateOf === 'function') {
+      const value = projections.stateOf(session, 'agentPreset')
+      if (typeof value === 'string' && value !== '') return value
+    }
+    const headerPreset = session.header?.agentPreset
+    return typeof headerPreset === 'string' ? headerPreset : ''
+  } catch {
+    return ''
+  }
+}
+
 function approvalOf(ctx, sessionId) {
   try {
     const session = sessionOf(ctx, sessionId)
@@ -699,6 +721,8 @@ function handoffStatus(ctx, store, handoff) {
       tokens,
       agentId: bound,
       stage,
+      workspaceId: workspaceIdOf(ctx, sessionCwd(ctx, sessionId)),
+      agentPreset: agentPresetOf(ctx, sessionId),
       requestedAt: state?.requestedAt,
       settledAt: state?.settledAt,
       checkpoint: state?.checkpoint,
@@ -972,6 +996,7 @@ async function handleOp(ctx, store, rooms, journals, handoff, archives, op, args
         triggerTokens: args.triggerTokens,
         remindEverySteps: args.remindEverySteps,
         exportDir: args.exportDir,
+        autoSwitch: args.autoSwitch,
       })
     case 'handoff.reset':
       handoff.clearState(args.sessionId)
@@ -987,7 +1012,13 @@ async function handleOp(ctx, store, rooms, journals, handoff, archives, op, args
         approval: approvalOf(ctx, sessionId),
         model: modelOf(ctx, sessionId),
       })
-      return { sessionId, agentId, workspaceId: workspaceIdOf(ctx, cwd), next }
+      return {
+        sessionId,
+        agentId,
+        workspaceId: workspaceIdOf(ctx, cwd),
+        agentPreset: agentPresetOf(ctx, sessionId),
+        next,
+      }
     }
     case 'workspace.list':
       return { workspaces: listWorkspaces(ctx) }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-agent-vault",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Per-agent memory, one shared knowledge base, and per-conversation agent roles for DeepSeek Harness",
   "type": "module",
   "exports": {