dsh-sessions-manager 3.2.2 → 3.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-sessions-manager",
   "description": "DSH 设置面板会话管理器：归档 / 恢复 / 彻底删除 / 移动到其他工作区，带工作区标签与会话日期；统一「会话管理」面板。Session manager for the DeepSeek Harness settings panel — archive / restore / permanently delete / move sessions across workspaces, with workspace tags & session dates in one unified panel.",
-  "version": "3.2.2",
+  "version": "3.4.0",
   "type": "module",
   "main": "lib/index.js",
   "exports": {

package/src/auto-archive.js

@@ -0,0 +1,168 @@
+// Durable "auto-archive" settings (schema v4) + the pure candidate rule.
+//
+// Auto-archive hides conversations that have been idle for N days. It is OFF
+// by default: archiving rewrites durable workspace state, so the plugin must
+// never touch a conversation the user has not asked it to.
+//
+// Deliberately mirrors the star index (src/star-index.js): version field,
+// defensive coercion of whatever is on disk, atomic write (tmp + rename) and a
+// single chained mutation queue. The candidate rule lives here as a pure
+// function so it can be tested without a DSH host.
+import { mkdir, rename, writeFile } from 'node:fs/promises'
+import { readFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+// v4 keeps clear of the recycle bin's v1/v2 and the star index's v3, so a
+// copied or mixed-up file can never be silently accepted as another store.
+export const AUTO_ARCHIVE_SCHEMA_VERSION = 4
+
+// Allowed idle windows. 0 = disabled. Deliberately coarse: a free-form number
+// would let a typo schedule archiving "tomorrow" for every conversation.
+export const INACTIVE_DAY_OPTIONS = Object.freeze([0, 30, 60, 90])
+
+const DAY_MS = 86400000
+// Re-run at most once per day: the sweep is triggered by panel reads, and a
+// user flipping settings back and forth must not archive in a loop.
+export const RUN_INTERVAL_MS = DAY_MS
+
+const DEFAULT_DIR = join(homedir(), '.dsh', 'sessions-manager')
+
+/**
+ * Coerce anything on disk (or nothing at all) into a valid v4 store.
+ */
+export function normalizeAutoArchiveStore(raw) {
+  const source = raw && typeof raw === 'object' && !Array.isArray(raw) ? raw : {}
+  const settings = source.settings && typeof source.settings === 'object' ? source.settings : {}
+  const inactiveDays = INACTIVE_DAY_OPTIONS.includes(settings.inactiveDays) ? settings.inactiveDays : 0
+  return {
+    schemaVersion: AUTO_ARCHIVE_SCHEMA_VERSION,
+    settings: {
+      inactiveDays,
+      // Starred sessions are an explicit "keep" mark, so they are skipped
+      // unless the user opts out.
+      skipStarred: settings.skipStarred !== false,
+    },
+    lastRunAt: Number.isFinite(source.lastRunAt) ? source.lastRunAt : null,
+    lastArchivedCount: Number.isInteger(source.lastArchivedCount) && source.lastArchivedCount >= 0 ? source.lastArchivedCount : 0,
+  }
+}
+
+/**
+ * Which sessions should be auto-archived right now? Pure — no I/O, no host.
+ *
+ * The rule is intentionally conservative: anything we cannot prove is idle
+ * (unknown last-activity, already archived, starred, currently open) is left
+ * alone. A wrong archive is a visible regression; a missed one is invisible.
+ *
+ * @param {Array<{sessionId: string, archived?: boolean, starred?: boolean,
+ *   updatedAt?: number|null}>} items
+ * @param {object} options
+ * @param {number} options.inactiveDays - Idle window in days (0 disables).
+ * @param {number} [options.now] - Reference timestamp (tests inject it).
+ * @param {boolean} [options.skipStarred=true] - Keep starred sessions.
+ * @param {string|null} [options.activeSessionId] - Never archive the open one.
+ * @returns {string[]} Session ids to archive.
+ */
+export function pickInactiveCandidates(items, options = {}) {
+  const days = options.inactiveDays
+  if (!INACTIVE_DAY_OPTIONS.includes(days) || days === 0) return []
+  const now = Number.isFinite(options.now) ? options.now : Date.now()
+  const cutoff = now - days * DAY_MS
+  const skipStarred = options.skipStarred !== false
+  const activeId = options.activeSessionId != null ? String(options.activeSessionId) : null
+  const list = Array.isArray(items) ? items : []
+
+  const out = []
+  const seen = new Set()
+  for (const item of list) {
+    if (!item || item.sessionId == null) continue
+    const id = String(item.sessionId)
+    if (seen.has(id)) continue
+    if (item.archived) continue
+    if (skipStarred && item.starred) continue
+    if (activeId !== null && id === activeId) continue
+    const updatedAt = Number(item.updatedAt)
+    // No usable timestamp → cannot prove it is idle → leave it alone.
+    if (!Number.isFinite(updatedAt) || updatedAt <= 0) continue
+    if (updatedAt < cutoff) { seen.add(id); out.push(id) }
+  }
+  return out
+}
+
+/**
+ * Open the auto-archive settings store.
+ * @param {object} [options]
+ * @param {string} [options.dir] - Directory holding the index (tests inject a temp dir).
+ * @param {string} [options.indexPath] - Full index path, overriding `dir`.
+ */
+export function createAutoArchiveStore(options = {}) {
+  const dir = options.dir || process.env.DSH_SESSIONS_MANAGER_AUTO_ARCHIVE_DIR || DEFAULT_DIR
+  const indexPath = options.indexPath || join(dir, 'auto-archive.json')
+  let mutation = Promise.resolve()
+
+  async function read() {
+    try {
+      return normalizeAutoArchiveStore(JSON.parse(readFileSync(indexPath, 'utf8')))
+    } catch {
+      return normalizeAutoArchiveStore(null)
+    }
+  }
+
+  async function write(store) {
+    await mkdir(dir, { recursive: true })
+    const tmp = join(dir, `.auto-archive-${process.pid}-${Date.now()}.tmp`)
+    await writeFile(tmp, JSON.stringify(normalizeAutoArchiveStore(store), null, 2), { encoding: 'utf8', mode: 0o600 })
+    await rename(tmp, indexPath)
+  }
+
+  function mutate(mutator) {
+    const operation = mutation.then(async () => {
+      const store = await read()
+      const result = await mutator(store)
+      await write(store)
+      return result
+    })
+    mutation = operation.catch(() => {})
+    return operation
+  }
+
+  /**
+   * Merge a partial settings patch.
+   * @param {{inactiveDays?: number, skipStarred?: boolean}} patch
+   * @returns {Promise<object>} The store's settings after the change.
+   */
+  function update(patch = {}) {
+    return mutate((store) => {
+      if (Object.prototype.hasOwnProperty.call(patch, 'inactiveDays')) {
+        const days = Number(patch.inactiveDays)
+        if (!INACTIVE_DAY_OPTIONS.includes(days)) {
+          const error = new Error(`inactiveDays 仅支持 ${INACTIVE_DAY_OPTIONS.join('、')}`)
+          error.status = 400
+          throw error
+        }
+        store.settings.inactiveDays = days
+      }
+      if (Object.prototype.hasOwnProperty.call(patch, 'skipStarred')) {
+        store.settings.skipStarred = !!patch.skipStarred
+      }
+      return store.settings
+    })
+  }
+
+  /** Record that a sweep ran, so the once-a-day throttle can skip the next one. */
+  function recordRun(count, at = Date.now()) {
+    return mutate((store) => {
+      store.lastRunAt = at
+      store.lastArchivedCount = Number.isInteger(count) && count >= 0 ? count : 0
+      return store
+    })
+  }
+
+  /** True when a sweep already ran within RUN_INTERVAL_MS. */
+  function isFresh(store, now = Date.now()) {
+    return Number.isFinite(store && store.lastRunAt) && (now - store.lastRunAt) < RUN_INTERVAL_MS
+  }
+
+  return { read, write, mutate, update, recordRun, isFresh, indexPath, dir }
+}

package/src/client/index.jsx

@@ -11,7 +11,7 @@
  */
 
 import React, { useEffect, useMemo, useRef, useState } from 'react'
-import { canDropOnWorkspace, dotStateFor, sessionForNodes, workspaceForNodes } from './logic.js'
+import { canDropOnWorkspace, dotStateFor, sessionForNodes, starredOf, workspaceForNodes } from './logic.js'
 
 export const inject = ['slots']
 
@@ -55,6 +55,11 @@ const CSS = `
 .archv-id{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:10.5px;color:var(--dsw-alias-label-tertiary);flex:none}
 .archv-dot{color:var(--dsw-alias-border-l3);flex:none}
 .archv-check{width:15px;height:15px;accent-color:var(--dsw-alias-state-business-primary);flex:none;cursor:pointer}
+.archv-star{appearance:none;width:24px;height:24px;flex:none;display:inline-flex;align-items:center;justify-content:center;border:none;background:0 0;border-radius:7px;cursor:pointer;color:var(--dsw-alias-label-tertiary);transition:color .15s ease,background-color .15s ease}
+.archv-star:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}
+.archv-star svg{fill:none;stroke:currentColor;stroke-width:1.5;stroke-linejoin:round}
+.archv-star-on,.archv-star-on:hover{color:var(--dsw-alias-state-business-primary)}
+.archv-star-on svg{fill:currentColor}
 .archv-body{flex:1;min-width:0;display:flex;align-items:center;gap:12px}
 .archv-actions{display:flex;gap:8px;flex:none;flex-wrap:nowrap;justify-content:flex-end}
 .archv-btn{appearance:none;min-height:32px;padding:0 12px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-fill-subtle);color:var(--dsw-alias-label-secondary);border-radius:9px;font-size:12px;font-weight:500;cursor:pointer;white-space:nowrap;display:inline-flex;align-items:center;justify-content:center;gap:6px;text-align:center;transition:background-color .15s ease,border-color .15s ease,color .15s ease}
@@ -100,6 +105,9 @@ const CSS = `
 .dtl-k{font-size:11px;color:var(--dsw-alias-label-tertiary)}
 .dtl-v{font-size:12px;color:var(--dsw-alias-label-primary);word-break:break-all}
 .dtl-sec{margin-top:12px}
+.dtl-export{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
+.dtl-export .archv-btn{text-decoration:none}
+.dtl-note{margin-top:8px;font-size:11px;color:var(--dsw-alias-label-tertiary);line-height:1.5}
 .dtl-sec-t{font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary);text-transform:uppercase;letter-spacing:.03em;margin-bottom:6px}
 .dtl-tags{display:flex;flex-wrap:wrap;gap:6px}
 .dtl-tag{display:inline-flex;font-size:11px;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-fill-elevated);border:1px solid var(--dsw-alias-border-l2);border-radius:var(--dsm-radius-tag);padding:2px 8px}
@@ -212,7 +220,9 @@ function SessionPanel({ workspacesSvc }) {
   const [sessions, setSessions] = useState(null)
   const [workspaces, setWorkspaces] = useState([])
   const initialPrefs = useRef(loadPanelPrefs()).current
-  const [filter, setFilter] = useState(() => ['all', 'active', 'archived', 'trash'].includes(initialPrefs.filter) ? initialPrefs.filter : 'all')
+  // 注意：'storage' 已从可持久化取值中移除（它不再是视图），旧版残留的
+  // filter='storage' 会自动回落到 'all'，避免落到一个已不存在的界面。
+  const [filter, setFilter] = useState(() => ['all', 'active', 'archived', 'starred', 'trash'].includes(initialPrefs.filter) ? initialPrefs.filter : 'all')
   const [query, setQuery] = useState('')
   const [workspaceFilter, setWorkspaceFilter] = useState(() => initialPrefs.workspaceFilter || 'all')
   const [sortBy, setSortBy] = useState(() => ['newest', 'oldest', 'title'].includes(initialPrefs.sortBy) ? initialPrefs.sortBy : 'newest')
@@ -235,8 +245,23 @@ function SessionPanel({ workspacesSvc }) {
   const [details, setDetails] = useState({})
   const [openDetails, setOpenDetails] = useState(null)
   const [detailsLoading, setDetailsLoading] = useState(null)
+  const [mdBusy, setMdBusy] = useState(null)
+  const [zipOk, setZipOk] = useState(true)
+  const [storage, setStorage] = useState(null)
+  const [storageBusy, setStorageBusy] = useState(false)
+  // 存储统计要 stat 每条会话日志，开销不小：面板默认收起、按需加载，
+  // 且展开状态刻意不持久化——否则每次打开设置面板都会触发一次全量扫描。
+  const [storageOpen, setStorageOpen] = useState(false)
+  const [storageError, setStorageError] = useState(null)
+  const [aa, setAa] = useState({ settings: { inactiveDays: 0, skipStarred: true }, lastRunAt: null, lastArchivedCount: 0 })
+  const [aaOpen, setAaOpen] = useState(false)
+  const [aaBusy, setAaBusy] = useState(false)
+  const zipChecked = useRef(false)
   const [openMenu, setOpenMenu] = useState(null)
   const timer = useRef(null)
+  // 存储面板关着时会话集合若发生变化，标脏；下次展开时再刷新，
+  // 既不会显示过期数字，也避免每次 refresh 都白扫一遍全量日志。
+  const storageDirty = useRef(false)
   const menuRef = useRef(null)
   const dialogRef = useRef(null)
 
@@ -264,6 +289,9 @@ function SessionPanel({ workspacesSvc }) {
         setConfirmBatch(false)
         if (!targetWs && works.items && works.items.length) setTargetWs(works.items[0].workspaceId)
         loadTrash()
+        // 会话集合变了：面板开着就同步刷新；关着则只标脏，等展开时再刷。
+        if (storageOpen) loadStorage()
+        else storageDirty.current = true
       })
       .catch((e) => setError(String((e && e.message) || e)))
   }
@@ -278,6 +306,60 @@ function SessionPanel({ workspacesSvc }) {
     try { localStorage.setItem(PANEL_PREFS_KEY, JSON.stringify({ filter, workspaceFilter, sortBy })) } catch (e) {}
   }, [filter, workspaceFilter, sortBy])
 
+  // 自动归档设置随面板加载一次（host 侧读取即触发每日检查）。
+  // 存储统计刻意不在这里预取：它要 stat 每条日志，只在用户展开面板时才算。
+  useEffect(() => {
+    loadAutoArchive()
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [])
+
+  // 收藏切换：乐观更新 + 失败回滚（star 是高频轻操作，不等网络往返）。
+  const toggleStar = async (it) => {
+    const next = !it.starred
+    setSessions((s) => s && s.map((x) => (x.sessionId === it.sessionId ? { ...x, starred: next } : x)))
+    try {
+      await postJSON('/archived-sessions/star/set', { sessionId: it.sessionId, starred: next })
+    } catch (e) {
+      setSessions((s) => s && s.map((x) => (x.sessionId === it.sessionId ? { ...x, starred: !next } : x)))
+      showToast('收藏失败：' + String((e && e.message) || e))
+    }
+  }
+
+  // Markdown 导出：自有路由（/archived-sessions/export-md），blob 触发下载。
+  const exportMarkdown = async (it) => {
+    if (mdBusy) return
+    setMdBusy(it.sessionId)
+    try {
+      const res = await fetch('/archived-sessions/export-md?sessionId=' + encodeURIComponent(it.sessionId))
+      if (!res.ok) throw new Error('HTTP ' + res.status)
+      const blob = await res.blob()
+      const url = URL.createObjectURL(blob)
+      const a = document.createElement('a')
+      a.href = url
+      a.download = 'dsh-session-' + it.sessionId + '.md'
+      document.body.appendChild(a)
+      a.click()
+      a.remove()
+      URL.revokeObjectURL(url)
+      showToast('已导出 Markdown')
+    } catch (e) {
+      showToast('导出失败：' + String((e && e.message) || e))
+    } finally {
+      setMdBusy(null)
+    }
+  }
+
+  // 官方 ZIP 导出预检（一次性）：后端不支持 raw artifacts 时返回 501，
+  // 此时隐藏 ZIP 入口只留 Markdown（全局缓存，后端能力不会中途变）。
+  // 探针用非法 id 走 HEAD：命中 501 = 不支持；404/400 = 路由活着且支持。
+  useEffect(() => {
+    if (openDetails === null || zipChecked.current) return
+    zipChecked.current = true
+    fetch('/api/session.export?sessionId=probe&includeDescendants=false', { method: 'HEAD' })
+      .then((res) => setZipOk(res.status !== 501))
+      .catch(() => setZipOk(true))
+  }, [openDetails])
+
   // Close the ⋯ menu on outside click / Escape (no full-screen backdrop).
   useEffect(() => {
     if (openMenu === null) return
@@ -314,9 +396,10 @@ function SessionPanel({ workspacesSvc }) {
 
   const archivedList = sessions ? sessions.filter((x) => x.archived) : []
   const activeList = sessions ? sessions.filter((x) => !x.archived) : []
+  const starredList = starredOf(sessions)
   const list = useMemo(() => {
     if (filter === 'trash') return []
-    const base = filter === 'archived' ? archivedList : filter === 'active' ? activeList : sessions || []
+    const base = filter === 'archived' ? archivedList : filter === 'active' ? activeList : filter === 'starred' ? starredList : sessions || []
     const needle = query.trim().toLocaleLowerCase()
     const filtered = base.filter((item) => {
       if (workspaceFilter !== 'all' && (item.workspacePath || '') !== workspaceFilter) return false
@@ -330,6 +413,8 @@ function SessionPanel({ workspacesSvc }) {
     })
   }, [sessions, filter, query, workspaceFilter, sortBy])
   const selIds = Object.keys(selected).filter((k) => selected[k])
+  // 「回收站」是独立视图，不共用会话列表。
+  const showSessionList = filter !== 'trash'
 
   const toggle = (id) => setSelected((s) => ({ ...s, [id]: !s[id] }))
   const clearSel = () => setSelected({})
@@ -386,6 +471,47 @@ function SessionPanel({ workspacesSvc }) {
       .catch((e) => { setTrashBusy(null); setError(String((e && e.message) || e)) })
   }
 
+  // 存储占用分析：只读聚合（按工作区排行 + 最大的会话）。按需调用，不在面板加载时预取。
+  const loadStorage = () => {
+    setStorageBusy(true)
+    setStorageError(null)
+    postJSON('/archived-sessions/storage', { topN: 10 })
+      .then((r) => { setStorageBusy(false); setStorage(r); storageDirty.current = false })
+      // 错误留在面板内自行重试，不冒泡成整个设置面板的错误条。
+      .catch((e) => { setStorageBusy(false); setStorageError(String((e && e.message) || e)) })
+  }
+
+  // 自动归档设置。一次纯读取会顺带让 host 跑一遍每日检查（host 侧按天节流）。
+  const applyAa = (r) => setAa({ settings: r.settings || { inactiveDays: 0, skipStarred: true }, lastRunAt: r.lastRunAt ?? null, lastArchivedCount: r.lastArchivedCount || 0 })
+
+  const loadAutoArchive = () => {
+    postJSON('/archived-sessions/auto-archive/settings', {})
+      .then(applyAa)
+      .catch(() => {})
+  }
+
+  const updateAutoArchive = (patch) => {
+    if (aaBusy) return
+    setAaBusy(true)
+    postJSON('/archived-sessions/auto-archive/settings', patch)
+      .then((r) => { setAaBusy(false); applyAa(r); showToast('已更新自动归档策略') })
+      .catch((e) => { setAaBusy(false); setError(String((e && e.message) || e)) })
+  }
+
+  const runAutoArchive = () => {
+    if (aaBusy) return
+    setAaBusy(true)
+    postJSON('/archived-sessions/auto-archive/run', {})
+      .then((r) => {
+        setAaBusy(false)
+        applyAa(r)
+        const n = r.archived || 0
+        if (r.skipped === 'disabled') showToast('自动归档未启用')
+        else { showToast(`已自动归档 ${n} 个会话`); if (n > 0) refresh() }
+      })
+      .catch((e) => { setAaBusy(false); setError(String((e && e.message) || e)) })
+  }
+
   const restoreTrash = (sid) => {
     if (trashBusy) return
     setTrashBusy(sid)
@@ -569,10 +695,101 @@ function SessionPanel({ workspacesSvc }) {
             <button type="button" role="tab" aria-selected={filter === 'all'} className={'sess-fbtn' + (filter === 'all' ? ' sess-fbtn-on' : '')} onClick={() => { setFilter('all'); clearSel(); setConfirmBatch(false) }}>全部 ({sessions.length})</button>
             <button type="button" role="tab" aria-selected={filter === 'active'} className={'sess-fbtn' + (filter === 'active' ? ' sess-fbtn-on' : '')} onClick={() => { setFilter('active'); clearSel(); setConfirmBatch(false) }}>活动 ({activeList.length})</button>
             <button type="button" role="tab" aria-selected={filter === 'archived'} className={'sess-fbtn' + (filter === 'archived' ? ' sess-fbtn-on' : '')} onClick={() => { setFilter('archived'); clearSel(); setConfirmBatch(false) }}>已归档 ({archivedList.length})</button>
+            <button type="button" role="tab" aria-selected={filter === 'starred'} className={'sess-fbtn' + (filter === 'starred' ? ' sess-fbtn-on' : '')} onClick={() => { setFilter('starred'); clearSel(); setConfirmBatch(false) }}>已收藏 ({starredList.length})</button>
             <button type="button" role="tab" aria-selected={filter === 'trash'} className={'sess-fbtn' + (filter === 'trash' ? ' sess-fbtn-on' : '')} onClick={() => { setFilter('trash'); clearSel(); setConfirmBatch(false) }}>回收站 ({trash.length})</button>
           </div>
 
-          {filter !== 'trash' && (
+          {/* 维护栏是面板级工具，与当前查看哪一组会话无关，故所有视图都显示。 */}
+          <div className="maint-bar">
+              <button type="button" className={'archv-btn' + (aa.settings.inactiveDays ? ' archv-go' : '')} aria-expanded={aaOpen} onClick={() => setAaOpen(!aaOpen)}>
+                自动归档{aa.settings.inactiveDays ? `：${aa.settings.inactiveDays} 天未活跃` : '：未启用'}
+              </button>
+              {aa.lastRunAt ? <span className="maint-note">上次检查 {fmtDate(aa.lastRunAt)}，归档 {aa.lastArchivedCount} 个</span> : <span className="maint-note">尚未检查</span>}
+              <button type="button" className="archv-btn maint-bar-right" aria-expanded={storageOpen} onClick={() => { const next = !storageOpen; setStorageOpen(next); if (next && (!storage || storageDirty.current) && !storageBusy) loadStorage() }}>
+                存储占用{storage ? ` · ${fmtBytes(storage.totalBytes) || '0 B'}` : ''}
+              </button>
+          </div>
+          {aaOpen && (
+            <div className="mv-sheet" aria-label="自动归档设置">
+              <div className="mv-sheet-head">
+                <h3 className="mv-sheet-title">自动归档</h3>
+                <button type="button" className="mv-sheet-close" aria-label="关闭" onClick={() => setAaOpen(false)}>×</button>
+              </div>
+              <div className="mv-field">
+                <label className="mv-field-label" htmlFor="dsm-aa-days">将多久未活跃的会话自动归档</label>
+                <select id="dsm-aa-days" value={aa.settings.inactiveDays} disabled={aaBusy} onChange={(e) => updateAutoArchive({ inactiveDays: Number(e.target.value) })}>
+                  <option value="0">不自动归档</option>
+                  <option value="30">30 天未活跃</option>
+                  <option value="60">60 天未活跃</option>
+                  <option value="90">90 天未活跃</option>
+                </select>
+              </div>
+              <label className="aa-check">
+                <input type="checkbox" checked={aa.settings.skipStarred !== false} disabled={aaBusy} onChange={(e) => updateAutoArchive({ skipStarred: e.target.checked })} />
+                跳过已收藏的会话
+              </label>
+              <div className="mv-foot">
+                <button type="button" className="archv-btn" disabled={aaBusy || !aa.settings.inactiveDays} onClick={runAutoArchive}>{aaBusy ? '检查中…' : '立即检查'}</button>
+              </div>
+              <div className="dtl-note">
+                自动归档只是把会话收进「已归档」，不删除任何数据，随时可恢复。当前正在使用的会话永远不会被自动归档。检查在打开本面板时触发，每天最多一次。
+              </div>
+            </div>
+          )}
+          {storageOpen && (
+            <div className="mv-sheet" aria-label="存储占用">
+              <div className="mv-sheet-head">
+                <h3 className="mv-sheet-title">存储占用</h3>
+                <div className="mv-sheet-actions">
+                  <button type="button" className="archv-btn" disabled={storageBusy} onClick={loadStorage}>{storageBusy ? '统计中…' : '重新统计'}</button>
+                  <button type="button" className="mv-sheet-close" aria-label="关闭" onClick={() => setStorageOpen(false)}>×</button>
+                </div>
+              </div>
+              {storageError ? (
+                <div className="archv-err" role="alert">
+                  <span>{storageError}</span>
+                  <button type="button" className="archv-errretry" onClick={loadStorage}>重试</button>
+                </div>
+              ) : !storage ? (
+                <div className="archv-empty">统计中…</div>
+              ) : storage.sessionCount === 0 ? (
+                <div className="archv-empty">暂无会话，没有可统计的存储占用。</div>
+              ) : (
+                <>
+                  <div className="dsm-storage-sum">
+                    共 {fmtBytes(storage.totalBytes) || '0 B'} · {storage.sessionCount} 个会话{storage.unknownSessions ? ` · ${storage.unknownSessions} 个大小未知` : ''}
+                  </div>
+                  <div className="dsm-storage-list">
+                    {storage.workspaces.map((w) => (
+                      <div className="dsm-storage-row" key={w.key}>
+                        <span className="dsm-storage-name" title={w.path || '未分组'}>{w.title || (w.path ? pathName(w.path) : '未分组')}</span>
+                        <span className="dsm-storage-bar" aria-hidden="true"><span className="dsm-storage-fill" style={{ width: `${Math.round((w.share || 0) * 100)}%` }} /></span>
+                        <span className="dsm-storage-size">{fmtBytes(w.bytes) || '—'}</span>
+                        <span className="dsm-storage-count">{w.sessions} 个</span>
+                      </div>
+                    ))}
+                  </div>
+                  {storage.top.length > 0 && (
+                    <div className="dtl-sec">
+                      <div className="dtl-sec-t">占用最大的会话</div>
+                      <div className="dsm-storage-list">
+                        {storage.top.map((s) => (
+                          <div className="dsm-storage-row" key={s.sessionId}>
+                            <span className="dsm-storage-name" title={s.sessionId}>{s.title || s.sessionId}</span>
+                            <span className="dsm-storage-size">{fmtBytes(s.sizeBytes) || '—'}</span>
+                            <span className="dsm-storage-count">{s.workspaceTitle || (s.workspacePath ? pathName(s.workspacePath) : '未分组')}</span>
+                          </div>
+                        ))}
+                      </div>
+                    </div>
+                  )}
+                  <div className="dtl-note">统计的是会话日志文件的磁盘占用（压缩后的实际大小），只读，不修改任何数据。</div>
+                </>
+              )}
+            </div>
+          )}
+
+          {showSessionList && (
             <>
               <div className="sess-tools" aria-label="查找和整理会话">
                 <div className="sess-field">
@@ -593,13 +810,13 @@ function SessionPanel({ workspacesSvc }) {
                   </select>
                 </div>
               </div>
-              <div className="sess-results" role="status">显示 {list.length} 个会话{query || workspaceFilter !== 'all' ? `，共 ${filter === 'archived' ? archivedList.length : filter === 'active' ? activeList.length : sessions.length} 个` : ''}</div>
+              <div className="sess-results" role="status">显示 {list.length} 个会话{query || workspaceFilter !== 'all' ? `，共 ${filter === 'archived' ? archivedList.length : filter === 'active' ? activeList.length : filter === 'starred' ? starredList.length : sessions.length} 个` : ''}</div>
             </>
           )}
 
-          {filter !== 'trash' && list.length > 0 && (
+          {showSessionList && list.length > 0 && (
             <div className="sess-batch">
-              <span className="sess-btntext">{selIds.length ? `已选 ${selIds.length} 项` : (filter === 'archived' ? `共 ${archivedList.length} 个归档会话` : `共 ${sessions.length} 个会话（活动 ${activeList.length} / 已归档 ${archivedList.length}）`)}</span>
+              <span className="sess-btntext">{selIds.length ? `已选 ${selIds.length} 项` : (filter === 'archived' ? `共 ${archivedList.length} 个归档会话` : filter === 'starred' ? `共 ${starredList.length} 个收藏会话` : `共 ${sessions.length} 个会话（活动 ${activeList.length} / 已归档 ${archivedList.length}）`)}</span>
               <button type="button" className="archv-btn" disabled={list.length === 0} onClick={selectAll}>全选</button>
               {selIds.length > 0 && (
                 <>
@@ -618,9 +835,9 @@ function SessionPanel({ workspacesSvc }) {
             </div>
           )}
 
-          {filter !== 'trash' && list.length === 0 ? (
-            <div className="archv-empty">{query || workspaceFilter !== 'all' ? '没有匹配的会话。请调整搜索词或工作区筛选。' : filter === 'archived' ? '目前没有归档会话。在“全部”里选中会话点“归档”即可收纳进来。' : filter === 'active' ? '目前没有活动会话。' : '暂无可管理的会话。'}</div>
-          ) : filter !== 'trash' ? (
+          {showSessionList && list.length === 0 ? (
+            <div className="archv-empty">{query || workspaceFilter !== 'all' ? '没有匹配的会话。请调整搜索词或工作区筛选。' : filter === 'archived' ? '目前没有归档会话。在“全部”里选中会话点“归档”即可收纳进来。' : filter === 'active' ? '目前没有活动会话。' : filter === 'starred' ? '还没有收藏的会话。点击会话左侧的星标即可收藏。' : '暂无可管理的会话。'}</div>
+          ) : showSessionList ? (
             <div className="archv-list" role="list">
               {list.map((it) => {
                 const date = fmtDate(it.createdAt)
@@ -635,6 +852,16 @@ function SessionPanel({ workspacesSvc }) {
                         onChange={() => toggle(it.sessionId)}
                         aria-label={'选择 ' + (it.title || it.sessionId)}
                       />
+                      <button
+                        type="button"
+                        className={'archv-star' + (it.starred ? ' archv-star-on' : '')}
+                        aria-pressed={!!it.starred}
+                        aria-label={(it.starred ? '取消收藏 ' : '收藏 ') + (it.title || it.sessionId)}
+                        title={it.starred ? '取消收藏' : '收藏'}
+                        onClick={(e) => { e.stopPropagation(); toggleStar(it) }}
+                      >
+                        <svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false"><path d="M12 2.5l2.9 5.9 6.6.9-4.8 4.6 1.2 6.5-5.9-3.1-5.9 3.1 1.2-6.5L2.5 9.3l6.6-.9z" /></svg>
+                      </button>
                       <div className="archv-body">
                         <div className="archv-main">
                           <div className="archv-name" title={it.title || ''}>{it.title || '(无标题)'}</div>
@@ -746,6 +973,20 @@ function SessionPanel({ workspacesSvc }) {
                                   </div>
                                 </div>
                               )}
+                              <div className="dtl-sec">
+                                <div className="dtl-sec-t">导出</div>
+                                <div className="dtl-export">
+                                  <a
+                                    className="archv-btn"
+                                    href={`/api/session.export?sessionId=${encodeURIComponent(it.sessionId)}&includeDescendants=true`}
+                                    onClick={(e) => e.stopPropagation()}
+                                    style={zipOk ? undefined : { pointerEvents: 'none', opacity: 0.45 }}
+                                    title={zipOk ? '含子会话与附件，由 DSH 提供' : '当前持久化后端不支持原始日志导出'}
+                                  >下载原始日志 (ZIP)</a>
+                                  <button type="button" className="archv-btn" disabled={mdBusy === it.sessionId} onClick={() => exportMarkdown(it)}>{mdBusy === it.sessionId ? '生成中…' : '导出 Markdown'}</button>
+                                </div>
+                                <div className="dtl-note">ZIP 含子会话与附件，由 DSH 提供 · Markdown 为本插件生成的可读对话记录</div>
+                              </div>
                             </div>
                           )
                         })()}
@@ -876,6 +1117,21 @@ const SIDEBAR_AUG_CSS = `
 .dsm-trash-date{font-size:11px;color:var(--dsw-alias-label-tertiary);flex:none;white-space:nowrap}
 .dsm-trash-actions{display:flex;gap:6px;flex:none}.dsm-trash-actions .archv-btn{min-width:72px}
 .dsm-trash-empty{font-size:12px;color:var(--dsw-alias-label-tertiary);padding:6px 2px}
+.dsm-storage-sum{font-size:12px;color:var(--dsw-alias-label-secondary);margin-bottom:10px}
+.dsm-storage-list{display:flex;flex-direction:column;gap:6px}
+.dsm-storage-row{display:flex;align-items:center;gap:10px;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2);border-radius:9px;background:var(--dsw-alias-fill-elevated)}
+.dsm-storage-name{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:12.5px;color:var(--dsw-alias-label-primary)}
+.dsm-storage-bar{flex:0 0 96px;height:6px;border-radius:999px;background:var(--dsw-alias-fill-subtle);overflow:hidden}
+.dsm-storage-fill{display:block;height:100%;border-radius:999px;background:var(--dsw-alias-state-business-primary)}
+.dsm-storage-size{font-size:12px;color:var(--dsw-alias-label-secondary);flex:none;white-space:nowrap}
+.dsm-storage-count{font-size:11px;color:var(--dsw-alias-label-tertiary);flex:none;white-space:nowrap;max-width:32%;overflow:hidden;text-overflow:ellipsis}
+.maint-bar{display:flex;align-items:center;gap:10px;flex-wrap:wrap;margin:0 0 8px}
+.maint-bar-right{margin-left:auto}
+.maint-note{font-size:11px;color:var(--dsw-alias-label-tertiary)}
+.mv-sheet-actions{display:flex;align-items:center;gap:6px}
+.aa-check{display:flex;align-items:center;gap:8px;font-size:12px;color:var(--dsw-alias-label-secondary);cursor:pointer}
+.aa-check input{width:15px;height:15px;accent-color:var(--dsw-alias-state-business-primary);cursor:pointer;flex:none}
+@media (max-width:640px){.dsm-storage-bar{display:none}.dsm-storage-count{max-width:40%}}
 `
 
 // Shared status-dot state so the ⋯-menu "标记未读" action can toggle the

package/src/client/logic.js

@@ -51,3 +51,9 @@ export function workspaceForNodes(nodes) {
   }
   return null
 }
+
+// 收藏过滤：返回已收藏子集。star 是用户标记，与 DSH 的活动/归档状态正交
+// （可叠加），所以这里不做任何状态联合判断，只认 starred 字段。
+export function starredOf(items) {
+  return (items || []).filter((item) => item && item.starred)
+}