dsh-session-flow 1.3.0 → 1.4.0

package/lib/archive.js

@@ -1,7 +1,10 @@
 // lib/archive.js — 会话存档核心：扫描 / 解码 / 解析 / 统计。
 //
-// 数据来源：~/.dsh/sessions/<workspace>/session-<uuid>/session.jsonl.zstd
+// 数据来源：~/.dsh/sessions/<workspace>/session-<uuid>/session[.v2].jsonl.zstd
 // （zstd 压缩的多帧 JSONL；compression: none 时为明文 session.jsonl）。
+// dsh v0.1.3 起存档升级 v2（session.v2.jsonl.zstd，行信封 {type,seq,time,data} 不变，
+// header version:2 + 新增 session/end-seed 等事件）：v1 文件冻结在迁移时刻、v2 持续
+// 写入——读取必须优先 v2，否则读到冻结旧数据、纯 v2 新会话不可见（0.1.3 适配）。
 //
 // 解码使用 Node 内置 node:zlib 的 zstd 支持（Node >= 22.19），零第三方依赖；
 // 帧扫描算法借鉴自 @deepseek-ai/dsh-session-persistence-jsonl (MIT)。
@@ -246,8 +249,12 @@ export function summarizeParsed({ header, title, events }) {
   }
 }
 
-/** 定位一个会话目录里的存档文件（优先 zstd，回退明文）。 */
+/** 定位一个会话目录里的存档文件（优先 v2，回退 v1 zstd，再回退明文）。
+ * dsh v0.1.3 起 v2 存档与 v1 并存：v1 冻结在迁移时刻、v2 持续写入——
+ * 必须优先 v2，否则老会话读到冻结数据、纯 v2 新会话直接漏掉（0.1.3 适配）。 */
 export function sessionFileOf(sessionDir) {
+  const v2 = join(sessionDir, 'session.v2.jsonl.zstd')
+  if (existsSync(v2)) return v2
   const zstd = join(sessionDir, 'session.jsonl.zstd')
   if (existsSync(zstd)) return zstd
   const plain = join(sessionDir, 'session.jsonl')

package/lib/client.js

@@ -47,7 +47,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     dockPinNotice: '📌 直播已钉住原会话（当前已切换会话）', dockPinRebind: '转播当前会话',
     rename: '重命名', renamePlaceholder: '输入新标题…', renameFail: '重命名失败', origTitle: '原名',
     search: '搜索标题/工具/文件… 支持 tool: pwsh · file: src · err:', allWorkspaces: '全部工作区',
-    sortRecent: '最近运行', sortNewest: '最近创建', sortOldest: '最早创建', sortTools: '工具最多', sortLongest: '耗时最长',
+    sortRecent: '最近运行', sortNewest: '最近创建', sortOldest: '最早创建', sortTools: '工具最多', sortLongest: '耗时最长', sortSize: '占用最大',
     noMatch: '没有匹配的会话', noData: '暂无会话数据',
     running: '进行中', ended: '已结束', subagent: '子代理',
     turns: '回合', steps: '步骤', tools: '工具', errors: '错误', msgs: '消息',
@@ -68,7 +68,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     emptyHint: '此会话已创建但尚未开始对话', userNav: '用户发言', noUserNav: '（无用户发言）',
     conclusion: '结论', injected: '注入', lineage: '血缘', noLineage: '（无子代理血缘信息）', task: '任务',    liveTree: '运行时血缘', offlineTree: '档案血缘', modeOneShot: '一次性', modeContinuable: '可续',
     subagentDetail: '子代理详情', loadDetail: '加载子代理详情…', noDetail: '该子代理无可见事件',
-    viewSubagent: '查看子代理', toolTop: '工具 Top', issues: '问题会话', issuesHint: '只显示有错误记录的会话',
+    viewSubagent: '查看子代理', toolTop: '工具 Top', issues: '问题会话', issuesHint: '只显示有错误记录的会话', storage: '存储', storageHint: '当前范围会话存档总占用（只读）',
     searchTab: '检索', searchInPlaceholder: '会话内检索…', noMatches: '无匹配位置', matches: '命中', navUsers: '用户',
     cache: '缓存管理', cacheTotal: '缓存总量', cacheIndex: '会话索引', cacheTimeline: '时间线缓存',
     cleanTimeline: '清理时间线缓存', cleanAll: '清理全部缓存', cacheDone: '已清理', cacheEmpty: '（无缓存文件）',
@@ -108,7 +108,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     dockPinNotice: '📌 Live pinned to previous session (session switched)', dockPinRebind: 'Follow current session',
     rename: 'Rename', renamePlaceholder: 'New title…', renameFail: 'Rename failed', origTitle: 'Original',
     search: 'Search title / tools / files… use tool: · file: · err:', allWorkspaces: 'All workspaces',
-    sortRecent: 'Recently run', sortNewest: 'Recently created', sortOldest: 'Oldest first', sortTools: 'Most tools', sortLongest: 'Longest',
+    sortRecent: 'Recently run', sortNewest: 'Recently created', sortOldest: 'Oldest first', sortTools: 'Most tools', sortLongest: 'Longest', sortSize: 'Largest',
     noMatch: 'No matching sessions', noData: 'No session data yet',
     running: 'Running', ended: 'Ended', subagent: 'subagent',
     turns: 'turns', steps: 'steps', tools: 'tools', errors: 'errors', msgs: 'msgs',
@@ -130,7 +130,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     conclusion: 'Conclusion', injected: 'Injected', lineage: 'Lineage', noLineage: '(no subagent lineage)', task: 'Task',
     liveTree: 'Live lineage', offlineTree: 'Archive lineage', modeOneShot: 'one-shot', modeContinuable: 'continuable',
     subagentDetail: 'Subagent detail', loadDetail: 'Loading subagent detail…', noDetail: 'No visible events for this subagent',
-    viewSubagent: 'View subagent', toolTop: 'Tool Top', issues: 'Problem sessions', issuesHint: 'Only sessions with errors',
+    viewSubagent: 'View subagent', toolTop: 'Tool Top', issues: 'Problem sessions', issuesHint: 'Only sessions with errors', storage: 'Storage', storageHint: 'Total archive size of sessions in scope (read-only)',
     searchTab: 'Search', searchInPlaceholder: 'Search in session…', noMatches: 'No matches', matches: 'matches', navUsers: 'User',
     cache: 'Cache Mgmt', cacheTotal: 'Cache total', cacheIndex: 'Index', cacheTimeline: 'Timeline cache',
     cleanTimeline: 'Clean timeline cache', cleanAll: 'Clean all cache', cacheDone: 'Cleaned', cacheEmpty: '(no cache files)',
@@ -1398,6 +1398,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         if (sort === 'oldest') return r.createdAt || 0
         if (sort === 'tools') return r.toolCalls || 0
         if (sort === 'longest') return (r.lastEventTime || 0) - (r.createdAt || 0)
+        if (sort === 'size') return r.sizeBytes || 0
         return 0
       }
       const ascending = sort === 'oldest'
@@ -1410,17 +1411,19 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       const toolAgg = new Map()
       let issues = 0
       let roots = 0
+      let totalSize = 0
       for (const g of (state.data && state.data.workspaces) || []) {
         if (wsFilter !== '' && wsFilter !== g.name) continue // 统计范围 = 当前选中的工作区
         for (const s of g.sessions) {
           if (s.parentSession) continue
           roots++
           if (s.toolErrors > 0) issues++
+          totalSize += s.sizeBytes || 0
           for (const n of s.toolNames || []) toolAgg.set(n, (toolAgg.get(n) || 0) + 1)
         }
       }
       const topTools = [...toolAgg.entries()].sort((a, b) => b[1] - a[1]).slice(0, 6)
-      return { topTools, issues, roots }
+      return { topTools, issues, roots, totalSize }
     }, [state.data, wsFilter])
 
     const wsNames = ((state.data && state.data.workspaces) || []).map((g) => g.name)
@@ -1445,6 +1448,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           h('option', { value: 'oldest' }, STR.sortOldest),
           h('option', { value: 'tools' }, STR.sortTools),
           h('option', { value: 'longest' }, STR.sortLongest),
+          h('option', { value: 'size' }, STR.sortSize),
         ),
         h('label', { className: 'sf-muted', style: { display: 'inline-flex', alignItems: 'center', gap: 4, cursor: 'pointer', whiteSpace: 'nowrap' } },
           h('input', { type: 'checkbox', checked: showEmpty, onChange: (e) => setShowEmpty(e.target.checked) }),
@@ -1531,6 +1535,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           h('span', {}, '⚠ ' + STR.issues),
           h('span', { className: 'sf-statCount err' }, stats.issues),
         ),
+        h('span', { className: 'sf-statChip', title: STR.storageHint },
+          h('span', {}, STR.storage),
+          h('span', { className: 'sf-statCount' }, fmtSize(stats.totalSize)),
+        ),
       ),
       state.phase === 'loading' && h('div', { className: 'sf-hint' }, STR.scanning),
       state.phase === 'error' && h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, STR.loadFailed + ': ' + String(state.error)),

package/lib/index-store.js

@@ -5,7 +5,7 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
-import { listSessionDirs, summarizeSessionFile } from './archive.js'
+import { listSessionDirs, sessionFileOf, summarizeSessionFile } from './archive.js'
 
 export function dshHome() {
   return process.env.DSH_HOME || join(homedir(), '.dsh')
@@ -22,8 +22,10 @@ export function workspaceIndexFile(home, wsName) {
   return join(indexRoot(home), `index-${safe}.json`)
 }
 
-/** 索引格式版本：升级时旧缓存会被自动全量重扫一次（避免字段缺失）。 */
-const INDEX_VERSION = 4
+/** 索引格式版本：升级时旧缓存会被自动全量重扫一次（避免字段缺失）。
+ * 5（2026-09-08）：dsh v0.1.3 存档 v2 布局适配——存档文件改为 session.v2.jsonl.zstd
+ * （v1 冻结），强制全量重扫让摘要/统计全部来自 v2。 */
+const INDEX_VERSION = 5
 
 export function readIndex(home, wsName) {
   try {
@@ -107,7 +109,9 @@ export function scanWorkspaceIndex(home, wsName, options = {}) {
   return { index, scanned, skipped, removed }
 }
 
-/** 按会话 id 在所有工作区中定位存档（返回 { workspace, dir, file } 或 null）。 */
+/** 按会话 id 在所有工作区中定位存档（返回 { workspace, dir, file } 或 null）。
+ * 文件定位统一走 sessionFileOf（v2 优先，0.1.3 适配——此前硬编码 v1 文件名，
+ * 纯 v2 新会话全部 404「not found in archives」，钢琴条/详情/检索静默失效）。 */
 export function findWorkspaceOfSession(home, sessionId) {
   const root = join(home, 'sessions')
   if (!existsSync(root)) return null
@@ -115,10 +119,8 @@ export function findWorkspaceOfSession(home, sessionId) {
     const wsDir = join(root, wsName)
     try { if (!statSync(wsDir).isDirectory()) continue } catch { continue }
     const dir = join(wsDir, sessionId)
-    const zstd = join(dir, 'session.jsonl.zstd')
-    if (existsSync(zstd)) return { workspace: wsName, dir, file: zstd }
-    const plain = join(dir, 'session.jsonl')
-    if (existsSync(plain)) return { workspace: wsName, dir, file: plain }
+    const file = sessionFileOf(dir)
+    if (file !== null) return { workspace: wsName, dir, file }
   }
   return null
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-session-flow",
   "description": "DSH 会话回顾与归档插件：可折叠信息流 + 会话级汇总——总览工作台、折叠时间线、血缘树、双模式摘要、全文检索、ZIP 导出、实时跟踪、会话重命名（官方数据源对齐）、健康监控",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "lib/host.js",
   "exports": {