dsh-remote-plugin 0.6.20 → 0.6.22

package/index.mjs

@@ -19,6 +19,13 @@ export const inject = ['webServer', 'commands', 'agents', 'connection']
 const MOUNT = '/remote'
 const PUBLIC_DIR = fileURLToPath(new URL('./public/', import.meta.url))
 const INDEX_FILE = 'index.html'
+const LONG_RUNNING_COMMAND_TIMEOUT_MS = 120_000
+const DEFAULT_COMMAND_TIMEOUT_MS = 30_000
+const LONG_RUNNING_COMMANDS = new Set(['export'])
+const COMMAND_OPERATION_RETENTION_MS = 10 * 60_000
+// 已登记的命令由 HTTP 请求之外的独立 promise 驱动。这样浏览器断连或等待到期
+// 都不会中止长操作；状态仅保存在进程内，DSH 重启后会话事件重新成为权威来源。
+const commandOperations = new Map()
 const GATEWAY_SCRIPT = fileURLToPath(new URL('./gateway.cjs', import.meta.url))
 const gatewayInstalled = existsSync(GATEWAY_SCRIPT)
 // 本地网关管理 API 代理: 让插件抽屉显示与网关管理页完全一致的数据。
@@ -513,6 +520,73 @@ async function resolveAgent(ctx, sessionId) {
   }
 }
 
+function commandHead(line) {
+  const match = /^\/+(\S+)/.exec(String(line || '').trim())
+  return match ? match[1].replace(/^\/+/, '') : ''
+}
+
+function commandEntryName(entry) {
+  const value = typeof entry === 'string' ? entry : entry?.name
+  return String(value || '').trim().replace(/^\/+/, '')
+}
+
+function commandWasExecuted(result) {
+  // DSH 0.1.x 的 commands.execute() 成功时可以返回 void。只要 Promise 正常
+  // 完成，就不应把同一条 /command 再降级为 session.prompt 的普通文本；只有
+  // 执行器明确返回 false / { executed: false } 才表示未处理。
+  return result !== false && result?.executed !== false
+}
+
+function remoteCommandAuthorized(req) {
+  const expected = gatewayToken()
+  return !!expected && req.headers.authorization === `Bearer ${expected}`
+}
+
+function commandOperationSnapshot(operation) {
+  if (!operation) return { active: false, phase: 'idle', command: '', startedAt: 0, endedAt: 0, message: '' }
+  return {
+    active: operation.active === true,
+    phase: operation.phase || 'idle',
+    command: String(operation.command || ''),
+    startedAt: Number(operation.startedAt) || 0,
+    endedAt: Number(operation.endedAt) || 0,
+    message: String(operation.message || ''),
+  }
+}
+
+async function executeRegisteredCommand(ctx, agent, line, signal) {
+  return ctx.commands.execute.length === 3
+    ? ctx.commands.execute(agent, line, signal)
+    : ctx.commands.execute(agent, line, [], signal)
+}
+
+function beginCommandOperation(ctx, agent, sessionId, line, command) {
+  const existing = commandOperations.get(sessionId)
+  if (existing?.active) return { operation: existing, reused: true }
+  const operation = { active: true, phase: 'running', command, startedAt: Date.now(), endedAt: 0, message: '' }
+  commandOperations.set(sessionId, operation)
+  // 不把已登记命令绑定到 HTTP 超时：真实 command/done 才是完成边界。
+  // 处理器仍接收可用 AbortSignal，以符合命令执行器的契约。
+  const signal = new AbortController().signal
+  void executeRegisteredCommand(ctx, agent, line, signal).then((result) => {
+    operation.active = false
+    operation.endedAt = Date.now()
+    operation.phase = result?.result?.kind === 'error' ? 'failed' : 'complete'
+    operation.message = String(result?.result?.text || '')
+  }, (error) => {
+    operation.active = false
+    operation.endedAt = Date.now()
+    operation.phase = 'failed'
+    operation.message = error?.message || String(error)
+  }).finally(() => {
+    const cleanup = setTimeout(() => {
+      if (commandOperations.get(sessionId) === operation && !operation.active) commandOperations.delete(sessionId)
+    }, COMMAND_OPERATION_RETENTION_MS)
+    cleanup.unref?.()
+  })
+  return { operation, reused: false }
+}
+
 async function resolveFile(pathname) {
   let abs = targetPath(pathname)
   if (abs === null) return null
@@ -740,6 +814,28 @@ async function serveStatic(req, res, ctx) {
     return
   }
 
+  // 命令状态：由插件进程跟踪长期操作，客户端重连后可恢复可见状态。
+  if (pathname === `${MOUNT}/api/command-status`) {
+    if (req.method !== 'GET') {
+      res.writeHead(405, { allow: 'GET' })
+      res.end()
+      return
+    }
+    if (!remoteCommandAuthorized(req)) {
+      sendJson(res, 401, { ok: false, message: 'unauthorized' })
+      return
+    }
+    const sessionId = new URL(req.url ?? '/', 'http://x').searchParams.get('sessionId') || ''
+    if (!sessionId) {
+      sendJson(res, 400, { ok: false, message: 'sessionId required' })
+      return
+    }
+    const operation = commandOperationSnapshot(commandOperations.get(sessionId))
+    // compact 为上一版客户端保留，新的客户端统一读取 operation。
+    sendJson(res, 200, { ok: true, operation, compact: operation.command === 'compact' ? operation : commandOperationSnapshot(null) })
+    return
+  }
+
   // 斜杠命令桥接：客户端 → 网关 → 插件端点 → ctx.commands.execute
   if (pathname === `${MOUNT}/api/command`) {
     if (req.method !== 'POST') {
@@ -747,9 +843,7 @@ async function serveStatic(req, res, ctx) {
       res.end()
       return
     }
-    const auth = req.headers.authorization || ''
-    const expected = gatewayToken()
-    if (!expected || auth !== `Bearer ${expected}`) {
+    if (!remoteCommandAuthorized(req)) {
       sendJson(res, 401, { ok: false, message: 'unauthorized' })
       return
     }
@@ -771,17 +865,42 @@ async function serveStatic(req, res, ctx) {
         sendJson(res, 200, { ok: false, message: 'agent not found', debug: { resolvePath, commandNames: [] } })
         return
       }
+      let commandEntries = null
       let commandNames = []
       try {
-        commandNames = (await ctx.commands.list(agent)).map(c => c.name)
+        const listed = await ctx.commands.list(agent)
+        commandEntries = Array.isArray(listed) ? listed : null
+        commandNames = commandEntries ? commandEntries.map(commandEntryName).filter(Boolean) : []
       } catch (e) {
         commandNames = ['list-error: ' + (e?.message || String(e))]
       }
-      const signal = AbortSignal.timeout(30000)
-      const result = ctx.commands.execute.length === 3
-        ? await ctx.commands.execute(agent, line, signal)
-        : await ctx.commands.execute(agent, line, [], signal)
-      sendJson(res, 200, { ok: true, executed: result !== undefined, debug: { resolvePath, commandNames } })
+      const name = commandHead(line)
+      if (commandEntries && (!name || !commandEntries.some(entry => commandEntryName(entry) === name))) {
+        // 仅把 DSH 已登记的 slash command 截留到命令服务。未知 /xxx 仍让客户端
+        // 按普通文本发送，保持 DSH 自己处理自定义提示词的兼容行为。
+        sendJson(res, 200, { ok: true, executed: false, debug: { resolvePath, commandNames, reason: 'unknown-command' } })
+        return
+      }
+      // /export 的成功结果必须先回到客户端，由客户端再发起 ZIP 下载；其他已登记
+      // 命令统一异步受理，避免把未知耗时绑定到一条 HTTP 请求。
+      if (name && name !== 'export') {
+        const { operation, reused } = beginCommandOperation(ctx, agent, sessionId, line, name)
+        sendJson(res, 202, {
+          ok: true,
+          executed: true,
+          accepted: true,
+          operation: commandOperationSnapshot(operation),
+          compact: name === 'compact' ? commandOperationSnapshot(operation) : undefined,
+          debug: { resolvePath, commandNames, reused },
+        })
+        return
+      }
+      // /export 在持久化历史较大时会等待刷新；其他同步命令沿用较短超时。
+      const signal = AbortSignal.timeout(LONG_RUNNING_COMMANDS.has(name)
+        ? LONG_RUNNING_COMMAND_TIMEOUT_MS
+        : DEFAULT_COMMAND_TIMEOUT_MS)
+      const result = await executeRegisteredCommand(ctx, agent, line, signal)
+      sendJson(res, 200, { ok: true, executed: commandWasExecuted(result), debug: { resolvePath, commandNames } })
     } catch (e) {
       sendJson(res, 200, { ok: false, message: e?.message || String(e) })
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-plugin",
-  "version": "0.6.20",
+  "version": "0.6.22",
   "description": "DSH Remote 官方 bundle 插件：DSH 左侧原生边栏入口 + 右侧抽屉内嵌管理控制台；内置网关随 DSH 自动启停(systemd 独立单元)，抽屉直显令牌与设备监控；网关提供 /fs/* 文件传输端点(列表/断点下载/上传)，配合 Android App 远程操控会话/审批/提问/goal 与文件互传(多服务器测速切换、聊天记录离线缓存)。",
   "type": "module",
   "main": "./index.mjs",

package/public/announcements.json

@@ -108,6 +108,14 @@
           { "id": "other", "label": "其他品牌" }
         ]
       }
+    },
+    {
+      "id": "2026-08-31-plugin-management-demand",
+      "title": "关于下个大版本插件管理功能的需求征集",
+      "content": "大家好，dsh-Remote 下个大版本将尝试引入插件管理相关功能，目前仍处于规划和探索阶段，具体功能范围会根据实际需求进一步评估。\n\n如果你有常用的管理插件，或者希望 dsh-Remote 支持某些插件管理及插件内功能，欢迎通过反馈渠道提交建议。也可以尽量说明具体使用场景、希望实现的操作以及当前遇到的不便，这会帮助我们开发出更符合实际需求的功能。\n\n如果需要加入用户交流群，QQ群号可以在往期公告中找到。\n\n感谢大家的支持与反馈！",
+      "minVersion": "",
+      "maxVersion": "",
+      "publishedAt": "2026-08-31T12:38:43+08:00"
     }
   ]
 }

package/public/app.js

@@ -75,11 +75,17 @@ const state = {
   updateInfo: null,
   warnedGatewayVersions: new Set(),
   announcement: null,
+  announcementItems: [],
+  announcementIndex: 0,
   announcements: [],
   approvals: [],           // 待处理审批
   questions: [],           // 待处理提问
   queues: {},              // sessionId -> queue items
   queueSteering: {},       // sessionId:itemId -> pending steer request
+  compactions: {},         // sessionId -> {active, phase, startedAt, message, source}
+  pendingCommands: {},     // sessionId -> command name; waits briefly before showing generic progress
+  compactionPollTimer: null,
+  compactionClockTimer: null,
   sessionTurnTimes: {},    // sessionId -> 本轮开始/结束时间，避免中间事件推动排序
   jobs: {},                // sessionId -> jobs
   sessionActivity: new Set(), // 已发送消息或已执行命令的会话
@@ -938,10 +944,81 @@ function closeGroupMenu() {
   if (menu) menu.classList.add('hidden')
 }
 
+let groupDrawerReturnFocus = null
+
+function groupDrawerOpen() {
+  return !$('group-drawer')?.classList.contains('hidden')
+}
+
+function renderGroupDrawer() {
+  const trigger = $('group-drawer-trigger')
+  const brandGroup = $('brand-group-name')
+  const current = $('group-drawer-current')
+  const list = $('group-drawer-list')
+  if (brandGroup) brandGroup.textContent = state.activeGroup
+  if (trigger) trigger.setAttribute('aria-label', t('groups.drawerOpen') + '：' + state.activeGroup)
+  if (current) current.textContent = state.activeGroup
+  if (!list) return
+  list.innerHTML = state.groups.map(group => {
+    const servers = groupServers(group)
+    const selected = group === state.activeGroup
+    return `<button type="button" class="group-drawer-option ${selected ? 'current' : ''}" data-quick-group="${esc(group)}" ${selected ? 'aria-current="true"' : ''}>
+      <span class="group-drawer-option-mark" aria-hidden="true"></span>
+      <span class="group-drawer-option-copy"><span class="group-drawer-option-name">${esc(group)}</span><span class="group-drawer-option-meta">${t('groups.serverCount', { count: servers.length })}</span></span>
+      <span class="group-drawer-option-check" aria-hidden="true">${selected ? '✓' : ''}</span>
+    </button>`
+  }).join('')
+}
+
+function openGroupDrawer() {
+  const drawer = $('group-drawer')
+  const backdrop = $('group-drawer-backdrop')
+  const trigger = $('group-drawer-trigger')
+  if (!drawer || !backdrop || !trigger) return
+  renderGroupDrawer()
+  groupDrawerReturnFocus = document.activeElement instanceof HTMLElement ? document.activeElement : trigger
+  drawer.classList.remove('hidden')
+  backdrop.classList.remove('hidden')
+  document.body.classList.add('group-drawer-open')
+  trigger.setAttribute('aria-expanded', 'true')
+  requestAnimationFrame(() => (drawer.querySelector('[data-quick-group].current') || drawer.querySelector('[data-quick-group]') || drawer).focus({ preventScroll: true }))
+}
+
+function closeGroupDrawer({ restoreFocus = true } = {}) {
+  const drawer = $('group-drawer')
+  const backdrop = $('group-drawer-backdrop')
+  const trigger = $('group-drawer-trigger')
+  if (!drawer || !backdrop || drawer.classList.contains('hidden')) return
+  drawer.classList.add('hidden')
+  backdrop.classList.add('hidden')
+  document.body.classList.remove('group-drawer-open')
+  trigger?.setAttribute('aria-expanded', 'false')
+  if (restoreFocus) (groupDrawerReturnFocus || trigger)?.focus({ preventScroll: true })
+  groupDrawerReturnFocus = null
+}
+
+function keepGroupDrawerFocus(event) {
+  if (!groupDrawerOpen()) return
+  if (event.key === 'Escape') {
+    event.preventDefault()
+    closeGroupDrawer()
+    return
+  }
+  if (event.key !== 'Tab') return
+  const drawer = $('group-drawer')
+  const targets = [...drawer.querySelectorAll('button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])')]
+  if (!targets.length) return
+  const first = targets[0]
+  const last = targets[targets.length - 1]
+  if (event.shiftKey && document.activeElement === first) { event.preventDefault(); last.focus() }
+  else if (!event.shiftKey && document.activeElement === last) { event.preventDefault(); first.focus() }
+}
+
 function renderServers() {
   const box = $('server-list')
   if (!box) return
   renderGroupSelect()
+  renderGroupDrawer()
   const groupsHtml = state.groups.map(g => {
     const list = groupServers(g)
     const auto = state.autoSelect[g] !== false
@@ -1526,9 +1603,104 @@ function onHostFrame(full) {
   if (f.type === 'host/remote-event') return scheduleRefresh()
 }
 
+function activeCompaction(sessionId = state.current) {
+  const compact = state.compactions[sessionId]
+  return compact?.active === true ? compact : null
+}
+
+function compactElapsed(startedAt) {
+  const seconds = Math.max(0, Math.floor((Date.now() - Number(startedAt || Date.now())) / 1000))
+  const minutes = Math.floor(seconds / 60)
+  const remain = seconds % 60
+  return minutes > 0 ? `${minutes}:${String(remain).padStart(2, '0')}` : `${remain}s`
+}
+
+function setCompactionStatus(sessionId, next) {
+  if (!sessionId) return
+  const previous = state.compactions[sessionId]
+  const active = next?.active === true
+  if (active) {
+    state.compactions[sessionId] = {
+      active: true,
+      phase: next.phase || previous?.phase || 'running',
+      command: String(next.command || previous?.command || 'compact'),
+      startedAt: Number(next.startedAt) || previous?.startedAt || Date.now(),
+      message: String(next.message || ''),
+      source: next.source || previous?.source || 'event',
+    }
+  } else {
+    delete state.compactions[sessionId]
+    if (previous?.active) {
+      const command = previous.command || 'compact'
+      if (next?.phase === 'failed') toast(command === 'compact'
+        ? t('session.compactFailed', { msg: next.message || t('send.failed') })
+        : t('session.commandFailed', { command, msg: next.message || t('send.failed') }), 'err')
+      else toast(command === 'compact' ? t('session.compactComplete') : t('session.commandComplete', { command }), 'ok')
+    }
+  }
+  ensureCompactionMonitoring()
+  if (state.current === sessionId) updateSessionStatus()
+}
+
+async function refreshCompactionStatus(sessionId = state.current) {
+  if (!sessionId) return
+  try {
+    const signal = typeof AbortSignal?.timeout === 'function' ? AbortSignal.timeout(8000) : undefined
+    const url = new URL(apiUrl('/remote/api/command-status'), location.href)
+    url.searchParams.set('sessionId', sessionId)
+    const res = await fetch(url, { headers: { authorization: 'Bearer ' + state.token, 'x-dsh-remote-client': CAP?.isNativePlatform?.() ? 'app' : 'web', ...clientIdHeaders() }, ...(signal ? { signal } : {}) })
+    if (res.status === 401) { authFailure(); return }
+    if (!res.ok) return
+    const body = await res.json().catch(() => null)
+    const operation = body?.operation || body?.compact
+    if (!operation) return
+    const pending = state.pendingCommands[sessionId]
+    if (operation.active) {
+      delete state.pendingCommands[sessionId]
+      setCompactionStatus(sessionId, { ...operation, source: 'status' })
+    } else if (activeCompaction(sessionId) && activeCompaction(sessionId).source !== 'event') {
+      setCompactionStatus(sessionId, operation)
+    } else if (pending) {
+      if (operation.phase === 'failed') toast(t('session.commandFailed', { command: pending, msg: operation.message || t('send.failed') }), 'err')
+      delete state.pendingCommands[sessionId]
+    }
+  } catch {}
+}
+
+function ensureCompactionMonitoring() {
+  const active = Object.values(state.compactions).some(compact => compact?.active)
+  if (!active) {
+    if (state.compactionPollTimer) clearInterval(state.compactionPollTimer)
+    if (state.compactionClockTimer) clearInterval(state.compactionClockTimer)
+    state.compactionPollTimer = null
+    state.compactionClockTimer = null
+    return
+  }
+  if (!state.compactionClockTimer) {
+    state.compactionClockTimer = setInterval(() => {
+      if (activeCompaction()) updateSessionStatus()
+    }, 1000)
+  }
+  if (!state.compactionPollTimer) {
+    state.compactionPollTimer = setInterval(() => {
+      const compact = activeCompaction()
+      if (compact && compact.source !== 'event') void refreshCompactionStatus()
+    }, 3000)
+  }
+}
+
+function observeCompactionEvent(sessionId, event) {
+  if (event?.type === 'compaction/start') {
+    setCompactionStatus(sessionId, { active: true, phase: 'running', startedAt: activeCompaction(sessionId)?.startedAt || Date.now(), source: activeCompaction(sessionId)?.source || 'event' })
+  } else if (event?.type === 'compaction/end' && activeCompaction(sessionId)?.source === 'event') {
+    setCompactionStatus(sessionId, { active: false, phase: 'complete' })
+  }
+}
+
 function onSessionEvent(sessionId, event) {
   if (!event) return
   const s = state.byId.get(sessionId)
+  observeCompactionEvent(sessionId, event)
   if (event.type === 'turn/start' || event.type === 'turn/end') {
     noteSessionTurnTime(sessionId, event)
     renderSessions()
@@ -2109,6 +2281,7 @@ async function openSession(id) {
   $('history').innerHTML = '<div class="empty">' + t('history.loading') + '</div>'
   renderQueue()
   renderSessionPending()
+  void refreshCompactionStatus(id)
   restoreCachedHistory()
   await loadHistory(true)
   renderSessionCards()
@@ -2203,10 +2376,20 @@ function updateSessionStatus() {
   const head = $('session-head')
   if (!head) return
   const composerStatus = $('composer-status')
-  if (composerStatus) composerStatus.classList.toggle('hidden', !s?.running)
+  const compact = activeCompaction()
+  if (composerStatus) {
+    composerStatus.classList.toggle('hidden', !s?.running && !compact)
+    composerStatus.classList.toggle('compacting', !!compact)
+  }
+  const composerText = $('composer-status-text')
+  if (composerText) composerText.textContent = compact
+    ? (compact.command === 'compact'
+        ? t('session.compacting', { elapsed: compactElapsed(compact.startedAt) })
+        : t('session.commandRunning', { command: compact.command, elapsed: compactElapsed(compact.startedAt) }))
+    : t('composer.running')
   head.classList.remove('running', 'interrupted')
   const queued = (state.queues[state.current] || []).some(i => i.placement !== 'context')
-  if (s?.running || queued) head.classList.add('running')
+  if (s?.running || queued || compact) head.classList.add('running')
   else if (s?.error) head.classList.add('interrupted')
 }
 
@@ -2805,12 +2988,75 @@ async function interruptSubagent(childId) {
 }
 
 /* ---------------- 发送 / 取消 / 快捷菜单 ---------------- */
+const NO_FALLBACK_SLASH_COMMANDS = new Set(['compact', 'export'])
+const SLASH_COMMAND_TIMEOUT_MS = 20_000
+// 比插件端的 120 秒多留 5 秒，让服务端能返回确定的失败结果而非客户端先中断。
+const LONG_RUNNING_SLASH_COMMAND_TIMEOUT_MS = 125_000
+
+function slashCommandName(text) {
+  const match = /^\/+([^\s/]+)/.exec(String(text || '').trim())
+  return match ? match[1].toLowerCase() : ''
+}
+
+function sessionLogFilename(sessionId) {
+  return `dsh-session-${String(sessionId).replace(/[^A-Za-z0-9_-]/g, '_')}.zip`
+}
+
+function sessionLogExportUrl(sessionId, includeToken = false) {
+  const url = new URL(apiUrl('/api/session.export'), location.href)
+  url.searchParams.set('sessionId', sessionId)
+  url.searchParams.set('includeDescendants', 'true')
+  // 网关下载由浏览器/DownloadManager 发起，无法附加 Bearer 头时才使用短期既有 token
+  // 查询参数兼容通道；同源 DSH 插件页仍只使用它自己的登录 Cookie。
+  if (includeToken && state.token) url.searchParams.set('token', state.token)
+  return url
+}
+
+async function downloadSessionExport(sessionId) {
+  const nativePlatform = !!CAP?.isNativePlatform?.()
+  const nativeDownload = !!(nativePlatform && window.NativeFile?.downloadToDownloads)
+  if (nativePlatform && !nativeDownload) {
+    toast(t('fs.downloadUnsupported'), 'err')
+    return
+  }
+  const url = sessionLogExportUrl(sessionId, !nativeDownload && !!state.server)
+  const headers = state.token ? { authorization: 'Bearer ' + state.token, 'x-dsh-remote-client': CAP?.isNativePlatform?.() ? 'app' : 'web', ...clientIdHeaders() } : {}
+  try {
+    const signal = typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'
+      ? AbortSignal.timeout(LONG_RUNNING_SLASH_COMMAND_TIMEOUT_MS)
+      : undefined
+    const preflight = await fetch(url, { method: 'HEAD', headers, ...(signal ? { signal } : {}) })
+    if (preflight.status === 401) { authFailure(); return }
+    if (!preflight.ok) throw new Error('HTTP ' + preflight.status)
+    const filename = sessionLogFilename(sessionId)
+    if (nativeDownload) {
+      window.NativeFile.downloadToDownloads(url.href, filename, state.token)
+      toast(t('fs.downloadStarted'), 'ok')
+      return
+    }
+    // 浏览器下载目的地由浏览器自身的下载设置决定；同源插件页无需暴露网关 token。
+    const anchor = document.createElement('a')
+    anchor.href = url.href
+    anchor.download = filename
+    document.body.appendChild(anchor)
+    anchor.click()
+    anchor.remove()
+    toast(t('session.exportStarted'), 'ok')
+  } catch (e) {
+    console.error('session export download failed', e)
+    toast(t('session.exportFailed', { msg: e?.message || '' }), 'err')
+  }
+}
+
 async function runSlashCommand(text) {
   const clean = String(text || '').trim()
   if (!clean.startsWith('/') || !state.current) return false
+  const command = slashCommandName(clean)
+  const noFallback = NO_FALLBACK_SLASH_COMMANDS.has(command)
+  const longRunning = command === 'export'
   try {
     const signal = typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'
-      ? AbortSignal.timeout(20000)
+      ? AbortSignal.timeout(longRunning ? LONG_RUNNING_SLASH_COMMAND_TIMEOUT_MS : SLASH_COMMAND_TIMEOUT_MS)
       : undefined
     const res = await fetch(apiUrl('/remote/api/command'), {
       method: 'POST',
@@ -2819,12 +3065,31 @@ async function runSlashCommand(text) {
       ...(signal ? { signal } : {})
     })
     if (res.status === 401) { authFailure(); return true }
-    if (!res.ok) return false
+    if (!res.ok) {
+      if (noFallback) toast(t('session.commandTimedOut'), 'err')
+      return noFallback
+    }
     const data = await res.json().catch(() => null)
     if (data?.ok === false) { toast(data.message || t('send.failed'), 'err'); return true }
-    if (data?.ok && data.executed === true) { toast(t('send.commandExecuted'), 'ok'); return true }
+    if (data?.ok && data.executed === true) {
+      if (data.accepted) {
+        if (command === 'compact') {
+          setCompactionStatus(state.current, { ...(data.operation || data.compact), active: true, command, source: 'command' })
+        } else {
+          const sessionId = state.current
+          state.pendingCommands[sessionId] = command
+          setTimeout(() => { if (state.current === sessionId) void refreshCompactionStatus(sessionId) }, 600)
+        }
+      } else if (command === 'export') await downloadSessionExport(state.current)
+      else toast(t('send.commandExecuted'), 'ok')
+      return true
+    }
   } catch (e) {
     console.error('slash command bridge failed', e)
+    if (noFallback) {
+      toast(t('session.commandTimedOut'), 'err')
+      return true
+    }
   }
   return false
 }
@@ -4358,10 +4623,12 @@ function readSeenAnnouncements() {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {}
   } catch { return {} }
 }
-function markAnnouncementSeen(id) {
-  if (!id) return
+function markAnnouncementsSeen(items) {
+  const ids = [...new Set((items || []).map(item => typeof item === 'string' ? item : item?.id).filter(Boolean))]
+  if (!ids.length) return
   const seen = readSeenAnnouncements()
-  seen[id] = Date.now()
+  const now = Date.now()
+  for (const id of ids) seen[id] = now
   const keys = Object.keys(seen)
   if (keys.length > 100) {
     keys.sort((a, b) => Number(seen[a]) - Number(seen[b]))
@@ -4370,6 +4637,7 @@ function markAnnouncementSeen(id) {
   LS.set(ANNOUNCEMENTS_KEY, JSON.stringify(seen))
   renderAnnouncementBoard()
 }
+function markAnnouncementSeen(id) { markAnnouncementsSeen([id]) }
 function readAnnouncementVotes() {
   try {
     const value = JSON.parse(LS.get(ANNOUNCEMENT_VOTES_KEY, '{}'))
@@ -4535,7 +4803,18 @@ function renderAnnouncementPoll(item) {
   submit.classList.toggle('hidden', !!vote)
   submit.disabled = true
 }
-function openAnnouncementModal(item) {
+function renderAnnouncementPagination() {
+  const total = state.announcementItems.length
+  const nav = $('announcement-pagination')
+  if (!nav) return
+  nav.classList.toggle('hidden', total < 2)
+  $('announcement-page').textContent = total > 1 ? t('announcement.page', { current: state.announcementIndex + 1, total }) : ''
+  $('announcement-prev').disabled = state.announcementIndex <= 0
+  $('announcement-next').disabled = state.announcementIndex >= total - 1
+}
+function renderAnnouncementModal() {
+  const item = state.announcementItems[state.announcementIndex]
+  if (!item) return
   state.announcement = item
   $('announcement-title').textContent = item.title
   $('announcement-content').innerHTML = esc(item.content).replace(/\r?\n/g, '<br>')
@@ -4550,9 +4829,23 @@ function openAnnouncementModal(item) {
     action.textContent = ''
     action.classList.add('hidden')
   }
-  $('announcement-later').classList.toggle('hidden', item.force)
+  // 同批存在强制公告时，不能借由切到普通公告而绕过“稍后再看”限制。
+  $('announcement-later').classList.toggle('hidden', state.announcementItems.some(entry => entry.force))
+  renderAnnouncementPagination()
+}
+function openAnnouncementModal(items, index = 0) {
+  const list = (Array.isArray(items) ? items : [items]).filter(item => item?.id)
+  if (!list.length) return
+  state.announcementItems = list
+  state.announcementIndex = Math.max(0, Math.min(Number(index) || 0, list.length - 1))
+  renderAnnouncementModal()
   $('modal-announcement').classList.remove('hidden')
 }
+function showAnnouncementAt(index) {
+  if (!state.announcementItems.length) return
+  state.announcementIndex = Math.max(0, Math.min(index, state.announcementItems.length - 1))
+  renderAnnouncementModal()
+}
 async function submitAnnouncementVote() {
   const item = state.announcement
   const poll = item?.poll
@@ -4616,8 +4909,10 @@ async function submitAnnouncementVote() {
   }
 }
 function closeAnnouncement(markSeen) {
-  if (markSeen && state.announcement) markAnnouncementSeen(state.announcement.id)
+  if (markSeen) markAnnouncementsSeen(state.announcementItems)
   state.announcement = null
+  state.announcementItems = []
+  state.announcementIndex = 0
   $('modal-announcement').classList.add('hidden')
 }
 async function fetchAnnouncements() {
@@ -4640,7 +4935,7 @@ async function fetchAnnouncements() {
     const items = normalized.filter(item => !seen[item.id])
       .sort((a, b) => b.publishedAt - a.publishedAt)
     if (!items.length || state.announcement) return false
-    openAnnouncementModal(items[0])
+    openAnnouncementModal(items)
     return true
   } catch { return false }
 }
@@ -6826,12 +7121,14 @@ function bindUi() {
   $('archive-cancel').addEventListener('click', closeArchiveConfirm)
   $('archive-confirm').addEventListener('click', confirmArchiveSession)
   $('modal-archive').addEventListener('click', (e) => { if (e.target === $('modal-archive')) closeArchiveConfirm() })
+  $('announcement-prev').addEventListener('click', () => showAnnouncementAt(state.announcementIndex - 1))
+  $('announcement-next').addEventListener('click', () => showAnnouncementAt(state.announcementIndex + 1))
   $('announcement-later').addEventListener('click', () => closeAnnouncement(false))
   $('announcement-confirm').addEventListener('click', () => closeAnnouncement(true))
   $('announcement-poll-options').addEventListener('change', () => { $('announcement-poll-submit').disabled = false })
   $('announcement-poll-submit').addEventListener('click', submitAnnouncementVote)
   $('modal-announcement').addEventListener('click', (e) => {
-    if (e.target === $('modal-announcement') && !state.announcement?.force) closeAnnouncement(false)
+    if (e.target === $('modal-announcement') && !state.announcementItems.some(item => item.force)) closeAnnouncement(false)
   })
   $('announcement-history-close').addEventListener('click', closeAnnouncementHistory)
   $('announcement-history-list').addEventListener('click', (e) => {
@@ -6879,6 +7176,22 @@ function bindUi() {
   $('btn-server-add').addEventListener('click', addServer)
   $('btn-group-add').addEventListener('click', addGroup)
   $('group-select-btn').addEventListener('click', (e) => { e.stopPropagation(); toggleGroupMenu() })
+  $('group-drawer-trigger').addEventListener('click', () => { groupDrawerOpen() ? closeGroupDrawer() : openGroupDrawer() })
+  $('group-drawer-close').addEventListener('click', () => closeGroupDrawer())
+  $('group-drawer-backdrop').addEventListener('click', () => closeGroupDrawer())
+  $('group-drawer-list').addEventListener('click', (e) => {
+    const option = e.target.closest('[data-quick-group]')
+    if (!option) return
+    const group = option.dataset.quickGroup
+    closeGroupDrawer({ restoreFocus: false })
+    if (group !== state.activeGroup) switchGroup(group)
+  })
+  $('group-drawer-manage').addEventListener('click', () => {
+    closeGroupDrawer({ restoreFocus: false })
+    showView('view-settings')
+    showSettingsPage('servers')
+  })
+  document.addEventListener('keydown', keepGroupDrawerFocus)
   document.addEventListener('click', (e) => {
     if (!e.target.closest('#group-select')) closeGroupMenu()
   })