dsh-remote-plugin 0.6.22 → 0.6.23

package/gateway.cjs

@@ -183,6 +183,8 @@ const CAPABILITIES = Object.freeze({
   dshLifecycle: DSH_CONTROL_SUPPORT.supported ? 2 : 0,
   centralAnnouncements: 2,
   feedback: 1,
+  compatibilityAdapter: 2,
+  diagnostics: 1,
   deviceKeys: 1,
   healthProbes: 1,
   resumableUploads: 2,
@@ -1340,6 +1342,58 @@ const eventCollectors = { mux: null, host: null }
 // both serve the same zero-build clients.
 let upstreamApiFlavor = 'unknown'
 let upstreamApiFlavorProbe = null
+let upstreamApiFlavorCheckedAt = 0
+let upstreamApiFlavorChangedAt = 0
+let compatibleCollectorFlavor = ''
+let compatibleCollectorRestartScheduled = false
+const UPSTREAM_API_FLAVOR_RECHECK_MS = durationEnv('DSH_REMOTE_UPSTREAM_API_RECHECK_MS', 15_000, 3_000, 10 * 60_000)
+const COMPATIBILITY_LOG_MAX = durationEnv('DSH_REMOTE_COMPATIBILITY_LOG_MAX', 80, 10, 500)
+const compatibilityLog = []
+
+// Compatibility diagnostics deliberately record protocol facts only.  RPC payloads,
+// token values, cookies, host paths, and DSH conversation content must never leave
+// the local machine as part of a support report.
+function redactDiagnosticText(value, limit = 240) {
+  return String(value || '')
+    .replace(/\bBearer\s+[^\s,;]+/gi, 'Bearer [redacted]')
+    .replace(/\b(token|access[_-]?token|cookie|authorization)(\s*[=:]\s*)[^\s,;]+/gi, '$1$2[redacted]')
+    .replace(/https?:\/\/[^\s,;]+/gi, '<url>')
+    .replace(/(?:[A-Za-z]:)?[/\\](?:[^\s/\\]+[/\\])+[^\s/\\]*/g, '<path>')
+    .replace(/[\r\n\t]+/g, ' ')
+    .slice(0, limit)
+}
+
+function recordCompatibility(kind, fields = {}) {
+  const item = {
+    at: new Date().toISOString(),
+    kind: String(kind || 'unknown').replace(/[^a-z0-9._/-]/gi, '').slice(0, 48) || 'unknown',
+    ...fields,
+  }
+  if (item.method !== undefined) item.method = String(item.method).replace(/[^a-z0-9._/-]/gi, '').slice(0, 120)
+  if (item.detail !== undefined) item.detail = redactDiagnosticText(item.detail)
+  if (item.status !== undefined) item.status = Number(item.status) || 0
+  compatibilityLog.push(item)
+  while (compatibilityLog.length > COMPATIBILITY_LOG_MAX) compatibilityLog.shift()
+}
+
+function diagnosticErrorCategory(value) {
+  const text = String(value || '').toLowerCase()
+  if (!text) return ''
+  if (/timeout|timed out|abort/.test(text)) return 'timeout'
+  if (/401|403|auth|cookie/.test(text)) return 'authentication'
+  if (/404|405|501|not found|unavailable/.test(text)) return 'method-unavailable'
+  if (/websocket|socket|econn|network/.test(text)) return 'transport'
+  return 'upstream-error'
+}
+
+function scheduleCompatibleCollectorRestart() {
+  if (compatibleCollectorRestartScheduled) return
+  compatibleCollectorRestartScheduled = true
+  setImmediate(() => {
+    compatibleCollectorRestartScheduled = false
+    void startCompatibleEventCollectors()
+  })
+}
 const modernState = {
   home: '',
   eventClientId: '',
@@ -1362,21 +1416,34 @@ async function callUpstreamRemote(endpoint, args, rpcId = crypto.randomUUID()) {
 }
 
 async function detectUpstreamApiFlavor(force = false) {
-  if (!force && upstreamApiFlavor !== 'unknown') return upstreamApiFlavor
+  const fresh = Date.now() - upstreamApiFlavorCheckedAt < UPSTREAM_API_FLAVOR_RECHECK_MS
+  if (!force && upstreamApiFlavor !== 'unknown' && fresh) return upstreamApiFlavor
   if (!force && upstreamApiFlavorProbe) return upstreamApiFlavorProbe
   upstreamApiFlavorProbe = (async () => {
+    const previous = upstreamApiFlavor
     try {
       const probe = await callUpstreamRemote('session/list', { _request: {} })
-      upstreamApiFlavor = probe.status === 200
+      const detected = probe.status === 200
         && probe.body?.result?.ok === true
         && Array.isArray(probe.body?.result?.value?.items)
         ? 'modern'
-        : 'legacy'
+        : ((probe.status === 404 || probe.status === 405 || (probe.status >= 200 && probe.status < 300)) ? 'legacy' : previous)
+      // A transient DSH restart or an authentication problem must not turn a known
+      // modern server into "legacy" and strand its live event stream.
+      if (detected !== 'unknown') upstreamApiFlavor = detected
+      upstreamApiFlavorCheckedAt = Date.now()
       if (upstreamApiFlavor === 'modern' && probe.body?.result?.ok) {
         updateModernSessions(probe.body.result.value?.items)
       }
-    } catch {
-      upstreamApiFlavor = 'legacy'
+      if (previous !== upstreamApiFlavor) {
+        upstreamApiFlavorChangedAt = upstreamApiFlavorCheckedAt
+        recordCompatibility('protocol-switch', { from: previous, to: upstreamApiFlavor, status: probe.status })
+        scheduleCompatibleCollectorRestart()
+      }
+    } catch (error) {
+      upstreamApiFlavorCheckedAt = Date.now()
+      if (upstreamApiFlavor === 'unknown') upstreamApiFlavor = 'legacy'
+      recordCompatibility('protocol-probe-failed', { detail: error?.message || error })
     } finally {
       upstreamApiFlavorProbe = null
     }
@@ -1404,6 +1471,23 @@ function modernError(message, code = 'upstream-incompatible', details = {}) {
   return { ok: false, error: { code, message, details } }
 }
 
+function modernResponseNeedsLegacyFallback(response) {
+  if (!response) return false
+  if ([404, 405, 501].includes(Number(response.status))) return true
+  const code = String(response.body?.result?.error?.code || response.body?.error?.code || response.body?.error || '').toLowerCase()
+  return ['method-unavailable', 'not-found', 'unsupported-method', 'unsupported_endpoint'].includes(code)
+}
+
+function remoteFailureKind(response) {
+  const raw = String(response?.body?.result?.error?.code || response?.body?.error?.code || response?.body?.error || '')
+  const code = raw.replace(/[^a-z0-9._/-]/gi, '').slice(0, 80)
+  return code || `http-${Number(response?.status) || 0}`
+}
+
+function legacyFallback(reason) {
+  return { __dshRemoteLegacyFallback: true, reason: redactDiagnosticText(reason, 120) }
+}
+
 function legacyHistoryValue(value, summary) {
   const records = Array.isArray(value?.records) ? value.records : []
   return {
@@ -1432,6 +1516,7 @@ async function translateModernRpc(method, payload, rpcId) {
   }
   if (method === 'session.list') {
     const response = await refreshModernSessions()
+    if (modernResponseNeedsLegacyFallback(response)) return legacyFallback('generated RPC session/list unavailable')
     return response.body || legacyEnvelope(rpcId, modernError('DSH session/list returned no JSON response'))
   }
   if (method === 'session.history') {
@@ -1468,7 +1553,7 @@ async function translateModernRpc(method, payload, rpcId) {
     }
   } else if (method.startsWith('session.')) {
     const verb = method.slice('session.'.length)
-    if (!['search', 'create', 'selectModel', 'rename', 'fork', 'prompt', 'attachment', 'updateQueue', 'cancel'].includes(verb)) return null
+    if (!['search', 'create', 'selectModel', 'rename', 'fork', 'prompt', 'attachment', 'updateQueue', 'cancel'].includes(verb)) return legacyFallback('no generated RPC adapter')
     endpoint = 'session/' + verb
     const request = verb === 'prompt' && !payload.requestId
       ? { ...payload, requestId: crypto.randomUUID() }
@@ -1476,12 +1561,12 @@ async function translateModernRpc(method, payload, rpcId) {
     args = verb === 'search' ? { request } : { request }
   } else if (method.startsWith('workspace.')) {
     const verb = method.slice('workspace.'.length)
-    if (!['create', 'rename', 'delete', 'insertBefore', 'insertSessionBefore', 'archiveSession'].includes(verb)) return null
+    if (!['create', 'rename', 'delete', 'insertBefore', 'insertSessionBefore', 'archiveSession'].includes(verb)) return legacyFallback('no generated RPC adapter')
     endpoint = 'workspace/' + verb
     args = { request: payload }
   } else if (method.startsWith('goal.')) {
     const verb = method.slice('goal.'.length)
-    if (!['create', 'edit', 'pause', 'resume', 'complete', 'clear'].includes(verb)) return null
+    if (!['create', 'edit', 'pause', 'resume', 'complete', 'clear'].includes(verb)) return legacyFallback('no generated RPC adapter')
     endpoint = 'goals/' + verb
     args = verb === 'create'
       ? { agentId: payload.sessionId, request: { objective: payload.objective, ...(payload.maxGoalRounds === undefined ? {} : { maxGoalRounds: payload.maxGoalRounds }) } }
@@ -1508,7 +1593,7 @@ async function translateModernRpc(method, payload, rpcId) {
     args = {}
   } else if (method.startsWith('credentials.')) {
     const verb = method.slice('credentials.'.length)
-    if (!['describe', 'set', 'unset'].includes(verb)) return null
+    if (!['describe', 'set', 'unset'].includes(verb)) return legacyFallback('no generated RPC adapter')
     endpoint = 'credentials/' + verb
     args = verb === 'describe' ? { refs: payload.refs } : verb === 'set' ? { ref: payload.ref, value: payload.value } : { ref: payload.ref }
     if (verb !== 'describe') transform = () => ({})
@@ -1531,11 +1616,15 @@ async function translateModernRpc(method, payload, rpcId) {
     }
     transform = models => ({ models: Array.isArray(models) ? models : [] })
   } else {
-    return null
+    return legacyFallback('no generated RPC adapter')
   }
 
   const response = await callUpstreamRemote(endpoint, args, rpcId)
-  if (!response.body?.result?.ok) return response.body || legacyEnvelope(rpcId, modernError(`DSH ${endpoint} returned no JSON response`))
+  if (modernResponseNeedsLegacyFallback(response)) return legacyFallback(`generated RPC ${endpoint} unavailable`)
+  if (!response.body?.result?.ok) {
+    recordCompatibility('generated-rpc-error', { method, status: response.status, detail: remoteFailureKind(response) })
+    return response.body || legacyEnvelope(rpcId, modernError(`DSH ${endpoint} returned no JSON response`))
+  }
   return legacyEnvelope(rpcId, { ok: true, value: transform(response.body.result.value) })
 }
 
@@ -1989,6 +2078,12 @@ function applyModernRemoteEvent(ws, value) {
     legacyPush('host', { type: 'host/session-removed', sessionId: args[0] })
   } else if (value.event === 'api-session/status') {
     legacyPush('host', { type: 'host/session-status', sessionId: args[0], running: !!args[1] })
+  } else if (value.event === 'api-session/activity') {
+    const sessionId = String(args[0] || '')
+    const updatedAt = Number(args[1]) || Date.now()
+    const summary = modernState.sessions.get(sessionId)
+    if (summary) modernState.sessions.set(sessionId, { ...summary, updatedAt })
+    legacyPush('host', { type: 'host/session-activity', sessionId, updatedAt })
   } else if (value.event === 'api-session/error') {
     legacyPush('host', { type: 'host/agent-error', sessionId: args[0], message: String(args[1] || '') })
   } else {
@@ -2106,7 +2201,16 @@ function startModernEventCollector() {
 }
 
 async function startCompatibleEventCollectors() {
-  if (await detectUpstreamApiFlavor() === 'modern') {
+  const flavor = await detectUpstreamApiFlavor()
+  if (compatibleCollectorFlavor === flavor && eventCollectors.mux) return
+  for (const collector of new Set(Object.values(eventCollectors).filter(Boolean))) {
+    try { collector.close?.() } catch {}
+  }
+  eventCollectors.mux = null
+  eventCollectors.host = null
+  compatibleCollectorFlavor = flavor
+  recordCompatibility('collector-mode', { detail: flavor })
+  if (flavor === 'modern') {
     const collector = startModernEventCollector()
     eventCollectors.mux = collector
     eventCollectors.host = collector
@@ -2355,6 +2459,52 @@ async function validatePollVote(payload) {
   return result
 }
 
+function compatibilityDiagnostics() {
+  const events = Object.fromEntries(Object.entries(eventCollectorState).map(([kind, state]) => [kind, {
+    connected: state.connected === true,
+    reconnects: Number(state.reconnects) || 0,
+    lastError: diagnosticErrorCategory(state.lastError),
+    lastCloseCode: Number(state.lastCloseCode) || 0,
+  }]))
+  return {
+    schema: 1,
+    capturedAt: new Date().toISOString(),
+    gateway: { version: VERSION, protocol: PROTOCOL_VERSION, platform: process.platform, node: process.versions.node },
+    upstream: {
+      apiFlavor: upstreamApiFlavor,
+      checkedAt: upstreamApiFlavorCheckedAt ? new Date(upstreamApiFlavorCheckedAt).toISOString() : '',
+      changedAt: upstreamApiFlavorChangedAt ? new Date(upstreamApiFlavorChangedAt).toISOString() : '',
+      collectorFlavor: compatibleCollectorFlavor,
+    },
+    events,
+    recent: compatibilityLog.slice(-20),
+  }
+}
+
+function serveDiagnostics(req, res, url) {
+  cors(res)
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204)
+    res.end()
+    return
+  }
+  if (req.method !== 'GET') {
+    res.writeHead(405, { allow: 'GET' })
+    res.end()
+    return
+  }
+  if (!authorized(req, url)) {
+    authFailures++
+    touchDevice(req, { failedAuth: true })
+    res.writeHead(401, { 'content-type': 'application/json; charset=utf-8' })
+    res.end(JSON.stringify({ error: 'unauthorized' }))
+    return
+  }
+  touchDevice(req)
+  res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
+  res.end(JSON.stringify(compatibilityDiagnostics()))
+}
+
 function serveFeedback(req, res, url) {
   cors(res)
   if (req.method === 'OPTIONS') {
@@ -2391,6 +2541,7 @@ function serveFeedback(req, res, url) {
     let message = String(payload.message || '').trim()
     const contact = String(payload.contact || '').trim()
     const appVersion = String(payload.appVersion || '').trim()
+    const includeDiagnostics = payload.includeDiagnostics === true
     if (!['bug', 'suggestion', 'other', 'poll'].includes(type)) {
       res.writeHead(400, { 'content-type': 'application/json; charset=utf-8' })
       res.end(JSON.stringify({ error: 'invalid type', expect: 'bug|suggestion|other|poll' }))
@@ -2442,6 +2593,7 @@ function serveFeedback(req, res, url) {
         appVersion: appVersion || 'unknown',
         gatewayVersion: VERSION,
         clientIp: maskIp(ip),
+        ...(includeDiagnostics ? { diagnostics: compatibilityDiagnostics() } : {}),
         ...(pollVote || {})
       }),
       signal: AbortSignal.timeout(8000)
@@ -2834,6 +2986,19 @@ async function loadFsWorkspaceRoots(force = false) {
       let value
       if (await detectUpstreamApiFlavor() === 'modern') {
         value = modernState.workspaces
+        // The slash protocol receives workspace state over a stream. Immediately
+        // after a protocol switch that baseline may not have arrived yet; retain
+        // a working dotted workspace.list implementation when this particular
+        // DSH release still exposes it instead of denying an otherwise valid root.
+        if (!Array.isArray(value?.items) || !value.items.length) {
+          try {
+            const legacy = await forwardLegacyRpc(new URL('/api/workspace.list', UPSTREAM), JSON.stringify({
+              type: 'client-request', rpcId: crypto.randomUUID(), method: 'workspace.list', payload: {},
+            }))
+            const body = JSON.parse(legacy.raw || '{}')
+            if (legacy.status === 200 && body?.result?.ok) value = body.result.value
+          } catch {}
+        }
       } else {
         const target = new URL('/api/workspace.list', UPSTREAM)
         const res = await fetch(target, {
@@ -3769,21 +3934,94 @@ function serveWorkbench(req, res, url) {
 }
 
 // ---------- /api 代理 ----------
+const ADAPTIVE_RPC_METHODS = new Set([
+  'host.describe', 'session.list', 'session.history', 'session.models', 'session.search',
+  'session.create', 'session.selectModel', 'session.rename', 'session.fork', 'session.prompt',
+  'session.attachment', 'session.updateQueue', 'session.cancel', 'workspace.list',
+  'workspace.create', 'workspace.rename', 'workspace.delete', 'workspace.insertBefore',
+  'workspace.insertSessionBefore', 'workspace.archiveSession', 'goal.create', 'goal.edit',
+  'goal.pause', 'goal.resume', 'goal.complete', 'goal.clear', 'subagent.list',
+  'subagent.interrupt', 'settings.describe', 'settings.mutate', 'settings.openDocument',
+  'credentials.describe', 'credentials.set', 'credentials.unset', 'llm.providers', 'llm.discoverModels',
+])
+
+function readApiRequest(req, maxBytes = 4 * 1024 * 1024) {
+  return new Promise((resolve, reject) => {
+    let raw = ''
+    req.setEncoding('utf8')
+    req.on('data', chunk => {
+      raw += chunk
+      if (Buffer.byteLength(raw) > maxBytes) reject(new Error('request body too large'))
+    })
+    req.once('end', () => resolve(raw))
+    req.once('error', reject)
+    req.once('aborted', () => reject(new Error('request aborted')))
+  })
+}
+
+async function forwardLegacyRpc(url, raw) {
+  const target = new URL(url.pathname + url.search, UPSTREAM)
+  const response = await fetch(target, {
+    method: 'POST',
+    headers: dshUpstreamHeaders({ 'content-type': 'application/json' }),
+    body: raw,
+    signal: AbortSignal.timeout(UPSTREAM_REQUEST_TIMEOUT_MS),
+  })
+  return { status: response.status, headers: response.headers, raw: await response.text() }
+}
+
+function sendBufferedUpstreamResponse(res, response) {
+  cors(res)
+  res.writeHead(response.status || 502, {
+    'content-type': response.headers?.get?.('content-type') || 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  })
+  res.end(response.raw || '')
+}
+
+async function proxyLegacyRpcWithModernFallback(req, res, url) {
+  const raw = await readApiRequest(req)
+  const legacy = await forwardLegacyRpc(url, raw)
+  if (![404, 405, 501].includes(legacy.status)) {
+    if (legacy.status >= 400) recordCompatibility('legacy-rpc-error', { method: url.pathname.slice('/api/'.length), status: legacy.status })
+    sendBufferedUpstreamResponse(res, legacy)
+    return
+  }
+  let body
+  try { body = JSON.parse(raw || '{}') } catch { body = null }
+  if (body?.type !== 'client-request' || typeof body.rpcId !== 'string' || !ADAPTIVE_RPC_METHODS.has(body.method)) {
+    sendBufferedUpstreamResponse(res, legacy)
+    return
+  }
+  recordCompatibility('legacy-404-fallback', { method: body.method, status: legacy.status })
+  const translated = await translateModernRpc(body.method, body.payload || {}, body.rpcId)
+  if (!translated || translated.__dshRemoteLegacyFallback) {
+    sendBufferedUpstreamResponse(res, legacy)
+    return
+  }
+  // A generated RPC completed, so subsequent requests and live collectors can use
+  // the modern contract immediately instead of waiting for the periodic probe.
+  if (body.method !== 'host.describe') {
+    const previous = upstreamApiFlavor
+    upstreamApiFlavor = 'modern'
+    upstreamApiFlavorCheckedAt = Date.now()
+    if (previous !== 'modern') {
+      upstreamApiFlavorChangedAt = upstreamApiFlavorCheckedAt
+      recordCompatibility('protocol-switch', { from: previous, to: 'modern', detail: 'legacy dotted RPC returned 404' })
+      scheduleCompatibleCollectorRestart()
+    }
+  }
+  cors(res)
+  res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
+  res.end(JSON.stringify(translated))
+}
+
 async function proxyModernApi(req, res, url) {
   if (req.method !== 'POST' || url.pathname.startsWith('/remote/')) return false
   if (await detectUpstreamApiFlavor() !== 'modern') return false
   let raw = ''
   try {
-    raw = await new Promise((resolve, reject) => {
-      req.setEncoding('utf8')
-      req.on('data', chunk => {
-        raw += chunk
-        if (raw.length > 4 * 1024 * 1024) reject(new Error('request body too large'))
-      })
-      req.once('end', () => resolve(raw))
-      req.once('error', reject)
-      req.once('aborted', () => reject(new Error('request aborted')))
-    })
+    raw = await readApiRequest(req)
     const body = JSON.parse(raw || '{}')
     cors(res)
     if (url.pathname === '/api/respond') {
@@ -3814,9 +4052,10 @@ async function proxyModernApi(req, res, url) {
       return true
     }
     const translated = await translateModernRpc(body.method, body.payload || {}, body.rpcId)
-    if (translated === null) {
-      res.writeHead(404, { 'content-type': 'application/json; charset=utf-8' })
-      res.end(JSON.stringify(legacyEnvelope(body.rpcId, modernError(`Remote method ${body.method} is unavailable on this DSH version`, 'method-unavailable'))))
+    if (translated?.__dshRemoteLegacyFallback) {
+      recordCompatibility('modern-legacy-fallback', { method: body.method, detail: translated.reason })
+      const legacy = await forwardLegacyRpc(url, raw)
+      sendBufferedUpstreamResponse(res, legacy)
       return true
     }
     res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
@@ -3832,7 +4071,11 @@ async function proxyModernApi(req, res, url) {
   }
 }
 
-function proxyLegacyApi(req, res, url) {
+async function proxyLegacyApi(req, res, url) {
+  const method = url.pathname.startsWith('/api/') ? decodeURIComponent(url.pathname.slice('/api/'.length)) : ''
+  if (req.method === 'POST' && ADAPTIVE_RPC_METHODS.has(method)) {
+    return proxyLegacyRpcWithModernFallback(req, res, url)
+  }
   const headers = {}
   for (const [k, v] of Object.entries(req.headers)) {
     if (v === undefined) continue
@@ -3905,7 +4148,7 @@ function proxyApi(req, res, url) {
     return
   }
   void proxyModernApi(req, res, url).then(handled => {
-    if (!handled) proxyLegacyApi(req, res, url)
+    if (!handled) return proxyLegacyApi(req, res, url)
   }).catch(error => {
     cors(res)
     if (!res.headersSent) res.writeHead(502, { 'content-type': 'application/json; charset=utf-8' })
@@ -3994,6 +4237,7 @@ const server = http.createServer(async (req, res) => {
     const url = new URL(req.url, 'http://dsh-remote.local')
     if (url.pathname === '/fs' || url.pathname.startsWith('/fs/')) return await serveFs(req, res, url)
     if (url.pathname === '/workbench' || url.pathname.startsWith('/workbench/')) return serveWorkbench(req, res, url)
+    if (url.pathname === '/diagnostics') return serveDiagnostics(req, res, url)
     if (url.pathname === '/feedback') return serveFeedback(req, res, url)
     if (url.pathname.startsWith('/admin/api')) return serveAdminApi(req, res, url)
     if (url.pathname.startsWith('/stats')) return serveStats(req, res, url)

package/package.json

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

package/public/app.js

@@ -293,6 +293,7 @@ function openFeedbackModal() {
   document.querySelectorAll('#fb-chips .fb-chip').forEach(b => b.classList.toggle('current', b.dataset.fbType === 'bug'))
   $('fb-msg').value = ''
   $('fb-contact').value = ''
+  $('fb-include-diagnostics').checked = false
   $('modal-feedback').classList.remove('hidden')
   setTimeout(() => $('fb-msg').focus(), 50)
 }
@@ -309,6 +310,7 @@ async function submitFeedback() {
   const type = state.feedbackType || 'bug'
   const message = $('fb-msg').value.trim()
   const contact = $('fb-contact').value.trim()
+  const includeDiagnostics = $('fb-include-diagnostics').checked
   if (!message) { toast(t('feedback.empty'), 'err'); return }
   if (message.length > 2000) { toast(t('feedback.tooLong'), 'err'); return }
   const btn = $('fb-submit')
@@ -319,7 +321,7 @@ async function submitFeedback() {
     const res = await fetch(base + '/feedback', {
       method: 'POST',
       headers: { 'content-type': 'application/json', authorization: 'Bearer ' + state.token },
-      body: JSON.stringify({ type, message, contact, appVersion: state.localVersion })
+      body: JSON.stringify({ type, message, contact, appVersion: state.localVersion, includeDiagnostics })
     })
     let json = {}
     try { json = await res.json() } catch {}
@@ -1589,6 +1591,11 @@ function onHostFrame(full) {
   const f = full.payload
   if (!f) return
   if (['host/session-added', 'host/session-removed', 'host/workspace-changed', 'host/workspace-removed', 'host/workspace-order-changed', 'host/archived-sessions-changed'].includes(f.type)) return scheduleRefresh()
+  if (f.type === 'host/session-activity') {
+    const session = state.byId.get(f.sessionId)
+    if (session) { session.updatedAt = Number(f.updatedAt) || Date.now(); renderSessions(); renderOverview() }
+    return
+  }
   if (f.type === 'host/session-status') {
     const s = state.byId.get(f.sessionId)
     if (s) { s.running = f.running; if (state.current === f.sessionId) { renderSessionCards(); updateCancelBtn(); renderSessionSub(); updateSessionStatus() } }

package/public/desktop/desktop.css

@@ -166,6 +166,9 @@ html.reorder-scroll-lock body { overscroll-behavior: none; }
 }
 .ds-fb-textarea:focus, .ds-fb-input:focus { border-color: var(--dsr-accent-line); }
 .ds-fb-input { min-height: 42px; }
+.ds-fb-diagnostics { display:grid; grid-template-columns:auto minmax(0,1fr); gap:5px 8px; align-items:start; margin:-1px 1px 4px; color:var(--dsr-text); font-size:13px; line-height:1.45; cursor:pointer; }
+.ds-fb-diagnostics input { width:17px; height:17px; margin:1px 0 0; accent-color:var(--dsr-accent); }
+.ds-fb-diagnostics small { grid-column:2; color:var(--dsr-muted); font-size:11px; line-height:1.45; }
 
 .ds-main { flex: 1; min-width: 0; display: flex; flex-direction: column; background: radial-gradient(900px 560px at 96% -18%, var(--dsr-accent-soft), transparent 64%), linear-gradient(180deg, var(--dsr-bg), var(--dsr-bg-2)); }
 .ds-topbar { height: 58px; flex: none; display: flex; align-items: center; gap: 10px; padding: 0 20px; border-bottom: 1px solid var(--dsr-divider); background: linear-gradient(180deg, var(--dsr-head-bg), transparent); backdrop-filter: blur(16px); }

package/public/desktop/desktop.html

@@ -368,6 +368,7 @@
         </div>
         <textarea id="fb-msg" class="ds-fb-textarea" rows="5" maxlength="2000" data-i18n-placeholder="ds.feedbackMessagePlaceholder" placeholder="请描述遇到的问题或建议（必填，≤2000 字）"></textarea>
         <input id="fb-contact" class="ds-fb-input" maxlength="200" data-i18n-placeholder="ds.feedbackContactPlaceholder" placeholder="联系方式（可选）：邮箱 / 微信 / B站 ID">
+        <label class="ds-fb-diagnostics"><input id="fb-include-diagnostics" type="checkbox"> <span data-i18n="ds.feedbackIncludeDiagnostics">附带兼容性诊断日志（可选）</span><small data-i18n="ds.feedbackDiagnosticsPrivacy">仅上传网关/协议版本、接口失败摘要和实时链路状态；不包含令牌、Cookie、对话内容或文件路径。</small></label>
       </div>
       <div class="ds-modal-actions">
         <button id="fb-cancel" class="ds-btn" data-i18n="ds.feedbackCancel">取消</button>
@@ -497,7 +498,7 @@
         'ds.feedback': '反馈', 'ds.feedbackGithubDesc': '反馈 bug / 提建议', 'ds.feedbackGiteeDesc': '国内镜像，无需代理',
         'ds.feedbackBiliDesc': 'UP 动态页交流', 'ds.feedbackCopyLink': '复制项目链接', 'ds.feedbackCopyDesc': '手动分享给朋友',
         'ds.feedbackCopied': '项目链接已复制', 'ds.feedbackCopyFailed': '复制失败，请手动复制',
-        'ds.feedbackWrite': '写反馈', 'ds.feedbackWriteDesc': 'App 内直接提交', 'ds.feedbackModalTitle': '写反馈',
+        'ds.feedbackWrite': '写反馈', 'ds.feedbackWriteDesc': 'App 内直接提交', 'ds.feedbackModalTitle': '写反馈', 'ds.feedbackIncludeDiagnostics': '附带兼容性诊断日志（可选）', 'ds.feedbackDiagnosticsPrivacy': '仅上传网关/协议版本、接口失败摘要和实时链路状态；不包含令牌、Cookie、对话内容或文件路径。',
         'ds.feedbackTypeBug': 'Bug', 'ds.feedbackTypeSuggestion': '建议', 'ds.feedbackTypeOther': '其他',
         'ds.feedbackMessagePlaceholder': '请描述遇到的问题或建议（必填，≤2000 字）',
         'ds.feedbackContactPlaceholder': '联系方式（可选）：邮箱 / 微信 / B站 ID',
@@ -602,7 +603,7 @@
         'ds.feedback': 'Feedback', 'ds.feedbackGithubDesc': 'Report bugs · suggest features', 'ds.feedbackGiteeDesc': 'Mirror in China, no proxy needed',
         'ds.feedbackBiliDesc': 'Chat on the UP\'s Bilibili page', 'ds.feedbackCopyLink': 'Copy project link', 'ds.feedbackCopyDesc': 'Share it manually',
         'ds.feedbackCopied': 'Project link copied', 'ds.feedbackCopyFailed': 'Copy failed, copy manually',
-        'ds.feedbackWrite': 'Write feedback', 'ds.feedbackWriteDesc': 'Submit from the app', 'ds.feedbackModalTitle': 'Write feedback',
+        'ds.feedbackWrite': 'Write feedback', 'ds.feedbackWriteDesc': 'Submit from the app', 'ds.feedbackModalTitle': 'Write feedback', 'ds.feedbackIncludeDiagnostics': 'Include compatibility diagnostics (optional)', 'ds.feedbackDiagnosticsPrivacy': 'Uploads only gateway/protocol versions, interface failure summaries, and realtime status; no token, cookie, conversation content, or file path.',
         'ds.feedbackTypeBug': 'Bug', 'ds.feedbackTypeSuggestion': 'Suggestion', 'ds.feedbackTypeOther': 'Other',
         'ds.feedbackMessagePlaceholder': 'Describe the bug or suggestion (required, ≤2000 chars)',
         'ds.feedbackContactPlaceholder': 'Contact (optional): email / WeChat / Bilibili ID',

package/public/desktop/desktop.js

@@ -385,6 +385,7 @@ function openFeedbackModal() {
   document.querySelectorAll('#fb-chips .ds-fb-chip').forEach(b => b.classList.toggle('current', b.dataset.fbType === 'bug'))
   $('fb-msg').value = ''
   $('fb-contact').value = ''
+  $('fb-include-diagnostics').checked = false
   $('modal-feedback').classList.remove('hidden')
   setTimeout(() => $('fb-msg').focus(), 50)
 }
@@ -507,6 +508,7 @@ async function submitFeedback() {
   const type = document.querySelector('#fb-chips .ds-fb-chip.current')?.dataset.fbType || 'bug'
   const message = $('fb-msg').value.trim()
   const contact = $('fb-contact').value.trim()
+  const includeDiagnostics = $('fb-include-diagnostics').checked
   if (!message) { toast(t('ds.feedbackEmpty'), 'err'); return }
   if (message.length > 2000) { toast(t('ds.feedbackTooLong'), 'err'); return }
   const btn = $('fb-submit')
@@ -515,7 +517,7 @@ async function submitFeedback() {
     const res = await fetch(apiUrl('/feedback'), {
       method: 'POST',
       headers: { 'content-type': 'application/json', authorization: 'Bearer ' + state.token },
-      body: JSON.stringify({ type, message, contact, appVersion: '' })
+      body: JSON.stringify({ type, message, contact, appVersion: '', includeDiagnostics })
     })
     let json = {}
     try { json = await res.json() } catch {}
@@ -1374,6 +1376,11 @@ function onHostFrame(full) {
   const f = full.payload
   if (!f) return
   if (['host/session-added', 'host/session-removed', 'host/workspace-changed', 'host/workspace-removed', 'host/workspace-order-changed', 'host/archived-sessions-changed'].includes(f.type)) refreshSessions()
+  if (f.type === 'host/session-activity') {
+    const session = state.byId.get(f.sessionId)
+    if (session) { session.updatedAt = Number(f.updatedAt) || Date.now(); renderSessions(); renderOverviewDesktop() }
+    return
+  }
   if (f.type === 'host/session-status') {
     const s = state.byId.get(f.sessionId)
     if (s) { s.running = f.running; if (state.current === f.sessionId) { renderSessions(); renderQueue(); updateComposerStatus() } renderOverviewDesktop() }

package/public/index.html

@@ -665,6 +665,7 @@
         </div>
         <textarea id="fb-msg" class="fb-textarea" rows="5" maxlength="2000" data-i18n-placeholder="feedback.messagePlaceholder" placeholder="请描述遇到的问题或建议（必填，≤2000 字）"></textarea>
         <input id="fb-contact" class="fb-input" maxlength="200" data-i18n-placeholder="feedback.contactPlaceholder" placeholder="联系方式（可选）：邮箱 / 微信 / B站 ID">
+        <label class="fb-diagnostics"><input id="fb-include-diagnostics" type="checkbox"> <span data-i18n="feedback.includeDiagnostics">附带兼容性诊断日志（可选）</span><small data-i18n="feedback.diagnosticsPrivacy">仅上传网关/协议版本、接口失败摘要和实时链路状态；不包含令牌、Cookie、对话内容或文件路径。</small></label>
       </div>
       <div class="modal-actions">
         <button id="fb-cancel" class="btn subtle" data-i18n="feedback.cancel">取消</button>
@@ -1129,7 +1130,7 @@
         'feedback.title': '反馈', 'feedback.githubDesc': '反馈 bug / 提建议', 'feedback.giteeDesc': '国内镜像，无需代理',
         'feedback.biliDesc': 'UP 动态页交流', 'feedback.copyLink': '复制项目链接', 'feedback.copyDesc': '手动分享给朋友',
         'feedback.copied': '项目链接已复制', 'feedback.copyFailed': '复制失败，请手动复制',
-        'feedback.write': '写反馈', 'feedback.writeDesc': 'App 内直接提交', 'feedback.modalTitle': '写反馈',
+        'feedback.write': '写反馈', 'feedback.writeDesc': 'App 内直接提交', 'feedback.modalTitle': '写反馈', 'feedback.includeDiagnostics': '附带兼容性诊断日志（可选）', 'feedback.diagnosticsPrivacy': '仅上传网关/协议版本、接口失败摘要和实时链路状态；不包含令牌、Cookie、对话内容或文件路径。',
         'feedback.typeBug': 'Bug', 'feedback.typeSuggestion': '建议', 'feedback.typeOther': '其他',
         'feedback.messagePlaceholder': '请描述遇到的问题或建议（必填，≤2000 字）',
         'feedback.contactPlaceholder': '联系方式（可选）：邮箱 / 微信 / B站 ID',
@@ -1362,7 +1363,7 @@
         'feedback.title': 'Feedback', 'feedback.githubDesc': 'Report bugs · suggest features', 'feedback.giteeDesc': 'Mirror in China, no proxy needed',
         'feedback.biliDesc': 'Chat on the UP\'s Bilibili page', 'feedback.copyLink': 'Copy project link', 'feedback.copyDesc': 'Share it manually',
         'feedback.copied': 'Project link copied', 'feedback.copyFailed': 'Copy failed, copy manually',
-        'feedback.write': 'Write feedback', 'feedback.writeDesc': 'Submit from the app', 'feedback.modalTitle': 'Write feedback',
+        'feedback.write': 'Write feedback', 'feedback.writeDesc': 'Submit from the app', 'feedback.modalTitle': 'Write feedback', 'feedback.includeDiagnostics': 'Include compatibility diagnostics (optional)', 'feedback.diagnosticsPrivacy': 'Uploads only gateway/protocol versions, interface failure summaries, and realtime status; no token, cookie, conversation content, or file path.',
         'feedback.typeBug': 'Bug', 'feedback.typeSuggestion': 'Suggestion', 'feedback.typeOther': 'Other',
         'feedback.messagePlaceholder': 'Describe the bug or suggestion (required, ≤2000 chars)',
         'feedback.contactPlaceholder': 'Contact (optional): email / WeChat / Bilibili ID',

package/public/styles.css

@@ -1151,6 +1151,9 @@ button.overview-attention-item, button.overview-session-item { cursor:pointer; }
 }
 .fb-textarea:focus, .fb-input:focus { border-color: var(--dsr-accent-line); }
 .fb-input { min-height: 42px; }
+.fb-diagnostics { display:grid; grid-template-columns:auto minmax(0,1fr); gap:5px 8px; align-items:start; margin:-1px 1px 4px; color:var(--dsr-text); font-size:13px; line-height:1.45; cursor:pointer; }
+.fb-diagnostics input { width:17px; height:17px; margin:1px 0 0; accent-color:var(--dsr-accent); }
+.fb-diagnostics small { grid-column:2; color:var(--dsr-muted); font-size:11px; line-height:1.45; }
 .feedback-success-card { max-width: 360px; text-align: center; padding: 22px 20px 18px; }
 .feedback-success-icon {
   width: 52px; height: 52px; display: grid; place-items: center; margin: 0 auto 13px; border-radius: 50%;

package/public/update.json

@@ -1,10 +1,14 @@
 {
-  "version": "0.6.22",
+  "version": "0.6.23",
   "apkUrl": "dsh-remote.apk",
-  "sha256": "0d814d40e58e12794cd1d4729a104ee94756e6f4306a67d47aec91b6e167e4af",
-  "releasedAt": "2026-09-01T03:24:11.551Z",
-  "notes": "0.6.22：斜杠命令统一后台受理并显示运行状态与耗时，/compact 不再受两分钟请求等待限制；/export 可在手机保存到系统下载目录、在浏览器按下载设置保存会话 ZIP；修复命令桥接超时后被误作为普通消息发送的问题。首次有多条未读公告时改为单一分页窗口，可左右切换，确认一次即可全部标为已读。",
+  "sha256": "947d138637edf0b300e9db3e024ac9b983f62e825847a24327bf7399edd56c01",
+  "releasedAt": "2026-09-03T01:19:16.166Z",
+  "notes": "0.6.23：加强 DSH 版本兼容。旧版点号 RPC 与新版 slash Remote API 可自动协商和回退，修复部分新版 DSH 中 host.describe、创建会话等请求返回 404 的问题；DSH 重启或升级后会重新识别协议并恢复实时通道。反馈时可由用户选择附带脱敏兼容性诊断，便于定位接口问题；诊断不包含令牌、Cookie、对话内容或文件路径。",
   "history": [
+    {
+      "version": "0.6.23",
+      "notes": "0.6.23：加强 DSH 版本兼容。旧版点号 RPC 与新版 slash Remote API 可自动协商和回退，修复部分新版 DSH 中 host.describe、创建会话等请求返回 404 的问题；DSH 重启或升级后会重新识别协议并恢复实时通道。反馈时可由用户选择附带脱敏兼容性诊断，便于定位接口问题；诊断不包含令牌、Cookie、对话内容或文件路径。"
+    },
     {
       "version": "0.6.22",
       "notes": "0.6.22：斜杠命令统一后台受理并显示运行状态与耗时，/compact 不再受两分钟请求等待限制；/export 可在手机保存到系统下载目录、在浏览器按下载设置保存会话 ZIP；修复命令桥接超时后被误作为普通消息发送的问题。首次有多条未读公告时改为单一分页窗口，可左右切换，确认一次即可全部标为已读。"
@@ -40,10 +44,6 @@
     {
       "version": "0.6.14",
       "notes": "0.6.14-rc.7：将 Android 后台轮询服务接入与前台 App 相同的 client ID，修复 Dalvik 后台请求被显示为第二台未知设备；保留旧记录的顺序无关迁移；补齐文件上传请求的持久设备 ID；实时扫码继续使用 Worker 解码并降低取样负载；修复非用户来源的 DSH user/message 被误显示为用户输入；新增子代理折叠、排队消息插话、运行中提示和按轮次稳定排序；Markdown 支持 GFM 表格。"
-    },
-    {
-      "version": "0.6.13",
-      "notes": "0.6.13 正式版：新增首次连接 Doctor，集中检查 DSH 服务、远程网关、局域网地址、防火墙、终端配对和实时消息通道；网关控制台新增可选的独立设备密钥，支持设备备注、最近 IP、二维码、令牌轮换、复制和退出，共享令牌在启用后仅保留管理权限；手机端和桌面端支持实时思考内容，并为未声明推理档位的模型提供 low、high、max 三档选择；普通会话列表、工作区树和主页统计不再混入子代理内部会话；Android App 落后于网关版本时显示明确更新提醒；新增网关协议与能力协商并兼容旧网关，同时补充设备隔离、重启持久化、推理显示、会话过滤和版本差异回归测试。"
     }
   ]
 }

package/public/version.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.6.22"
+  "version": "0.6.23"
 }