dsh-better-workspace 0.9.2 → 0.9.4

package/README.md

@@ -1,5 +1,7 @@
 # dsh-better-workspace
 
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
 > 给 [DeepSeek Harness (DSH)](https://www.npmjs.com/package/@deepseek-ai/dsh) 的侧边栏「工作区」列表装上一套**文件夹系统**——工作区还是那个工作区(一个目录),但名字里的 `/` 就是层级,让「网页前端」「网页后端」这类工作区可以归到同一个 `web` 分组下。
 
 ```
@@ -31,6 +33,8 @@ web/                 ← 虚拟分组(不是真实目录,纯命名层级)
 
 工作区里的会话名称同样用 `/` 分层(如 `测试1/两个插件维护`)。会话分组用**次级配色且无文件夹图标**渲染,和工作区文件夹一眼可辨;会话分组可整组重命名(批量改写成员标题)。
 
+**重启后标题不回退**:DSH 重启后的冷列表只为命中投影缓存的会话携带标题——分叉出的会话与从未写过检查点的会话会暂时回退成「工作区名」显示,真实的标题其实还在会话日志里。本插件把每个会话**最近一次的真实标题**持久化在浏览器里(dsh 客户端 store),回退窗口内直接用记忆标题渲染,`/` 分级分组照常成立;打开会话后官方数据到位即自动纠正。
+
 <table>
 <tr>
 <td align="center" width="58%"><img src="docs/screenshots/3-appearance-dialog.png" alt="外观自定义弹窗(实时预览)"/></td>

package/README_EN.md

@@ -1,5 +1,7 @@
 # dsh-better-workspace
 
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
 > A **folder system** for the DeepSeek Harness (DSH) sidebar workspace list — a workspace is still one directory, but every `/` in its name becomes hierarchy, so `web/frontend` and `web/backend` group under one virtual `web` folder.
 
 ```
@@ -29,6 +31,8 @@ Right-click any folder row: new subfolder (parent prefix pre-filled), new worksp
 
 Session titles nest on `/` too (e.g. `test1/plugin maintenance`). Session groups render in a secondary color without a folder icon, so they are clearly distinct from workspace folders; a session group can be renamed as a whole (rewrites member titles).
 
+**No title regression after a restart**: the cold list right after a DSH restart only carries titles for sessions that hit the persisted projection cache — fork-born and never-checkpointed sessions temporarily fall back to the workspace *basename*, even though the real title still lives in the session log. This plugin remembers each session's **last real wire title** in the browser (dsh client store) and renders from memory during that window, so `/` grouping keeps working; the moment a session opens, the official data takes over and self-heals.
+
 <table>
 <tr>
 <td align="center" width="58%"><img src="docs/screenshots/3-appearance-dialog.png" alt="Appearance dialog with live preview"/></td>

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-better-workspace",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "main": "./src/index.js",
   "description": "侧边栏工作区层级树:名称中的 / 即虚拟分组(web/前端 · web/后端),添加工作区的目录流附所属分组弹窗,重命名即时重排层级,可新建空分组。Hierarchy tree for the DSH sidebar workspace list.",
   "engines": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-better-workspace",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "DSH web plugin: a hierarchical workspace tree for the sidebar. Workspace titles containing \"/\" group into virtual folders (web/前端 · web/后端); the add-workspace directory flow gains a parent-group popup; renames re-derive the tree; a new-folder button creates empty levels.",
   "type": "module",
   "repository": {
@@ -16,7 +16,8 @@
     "./client": "./src/client.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=18",
+    "dsh": ">=0.1.0"
   },
   "dsh": {
     "bundle": {

package/src/client.js

@@ -304,9 +304,17 @@ window.__ModuleLoader__.load({
       return p.kind || p.status || p.type || 'pending'
     }
 
-    const sessionTitleOf = (summary, t) => {
+    const sessionTitleOf = (summary, t, rememberedTitle) => {
       if (!summary) return ''
       if (summary.blank) return t('session.new')
+      if (summary.title) return String(summary.title)
+      // Cold-restart window: when the wire omits title, displayTitle is the
+      // host's basename fallback (dsh list only serves the projection cache,
+      // and fork-born/never-checkpointed sessions always miss it — the durable
+      // title stays in the session log, unread for a list row). A title
+      // remembered from an earlier snapshot restores the "/" grouping until
+      // the session opens and the wire catches up.
+      if (typeof rememberedTitle === 'string' && rememberedTitle !== '') return rememberedTitle
       return String(summary.displayTitle || summary.title || '')
     }
 
@@ -676,6 +684,44 @@ window.__ModuleLoader__.load({
       },
     })
 
+    /* ========================= title cache store ====================== */
+
+    // Cold-restart title fallback. The host list serves titles only from the
+    // persisted projection cache: sessions that never wrote a checkpoint —
+    // and every fork-born (seeded) session, which the list skips entirely —
+    // come back after a restart with title absent and displayTitle already
+    // degraded to the workspace basename (dsh displayTitleOf: title → cwd
+    // basename → id). The durable titles live on in each session's log, but
+    // nothing reads a log for a cheap list row. This store remembers the
+    // last REAL wire title per session id (learned only from snapshots where
+    // summary.title exists — never from displayTitle, which is basename
+    // degraded in exactly the window being patched), so the tree restores
+    // the "/" grouping until the wire catches up. Same-value writes are
+    // no-ops (immer produces the same state, nothing persists); entries
+    // evict oldest-at past the hard cap. A stale remembered title (renamed
+    // elsewhere, cleared browser storage) self-heals the moment the wire
+    // carries the truth again; a missing entry just leaves today's fallback.
+    const TITLE_CACHE_LIMIT = 3000
+    const TITLE_CACHE_KEEP = 2400
+    const createTitleCacheStore = () => storeKit.defineStore({
+      init: () => ({ byId: {} }),
+      persist: 'dsh.betterWorkspace.titles.v1',
+      actions: {
+        rememberTitle: (d, id, title, at) => {
+          if (typeof id !== 'string' || id === '' || typeof title !== 'string' || title === '') return
+          if (!d.byId) d.byId = {}
+          const prev = d.byId[id]
+          if (prev && prev.title === title) return
+          d.byId[id] = { title: title, at: typeof at === 'number' ? at : Date.now() }
+          const keys = Object.keys(d.byId)
+          if (keys.length > TITLE_CACHE_LIMIT) {
+            keys.sort((a, b) => ((d.byId[a] && d.byId[a].at) || 0) - ((d.byId[b] && d.byId[b].at) || 0))
+            for (let i = 0; i < keys.length - TITLE_CACHE_KEEP; i++) delete d.byId[keys[i]]
+          }
+        },
+      },
+    })
+
     /* ============================ flow dialog ========================= */
 
     const BTN = (props) => (
@@ -1306,6 +1352,36 @@ window.__ModuleLoader__.load({
       const statusPulse = prefsMap.statusPulse !== false
       const archivedSet = React.useMemo(() => new Set(archivedSessionIds), [archivedSessionIds])
       const subCounts = React.useMemo(() => subagentRunningCounts(list ? list.byId : {}), [list ? list.byId : null])
+      // Last-known real titles for the cold-restart fallback window (see
+      // createTitleCacheStore). Read per render via getSnapshot: no
+      // subscription, because a cache write only happens when summary.title
+      // exists — at that moment the row already renders the wire truth and
+      // no re-render is wanted.
+      const remembered = (titleCacheRef && typeof titleCacheRef.getSnapshot === 'function')
+        ? (titleCacheRef.getSnapshot().byId || {})
+        : {}
+      const rememberedTitleOf = (id) => (remembered[id] ? remembered[id].title : undefined)
+
+      // Learn real titles from every snapshot: remember exactly what the
+      // wire carried (summary.title), never displayTitle — that is already
+      // basename-degraded in the very window this patches. Blank rows are
+      // provisional New Sessions and never learn. rememberTitle itself
+      // no-ops on unchanged values, so the loop is cheap when idle.
+      React.useEffect(() => {
+        if (!list || !list.byId) return
+        const remember = titleCacheRef && titleCacheRef.actions
+          ? titleCacheRef.actions.rememberTitle
+          : null
+        if (typeof remember !== 'function') return
+        const now = Date.now()
+        for (const id of Object.keys(list.byId)) {
+          const summary = list.byId[id]
+          if (!summary || summary.blank) continue
+          const title = summary.title
+          if (typeof title !== 'string' || title === '') continue
+          remember(String(id), title, now)
+        }
+      }, [list ? list.byId : null])
 
       const [query, setQuery] = React.useState('')
       const [searchOpen, setSearchOpen] = React.useState(false)
@@ -1451,8 +1527,8 @@ window.__ModuleLoader__.load({
           if (accounted.has(id) || !sessionVisible(summary, list.current, archivedSet)) continue
           ungrouped.push({
             id,
-            title: sessionTitleOf(summary, t),
-            leaf: sessionTitleOf(summary, t),
+            title: sessionTitleOf(summary, t, rememberedTitleOf(id)),
+            leaf: sessionTitleOf(summary, t, rememberedTitleOf(id)),
             blank: !!summary.blank,
             running: !!summary.running,
             completed: summary.completed === true,
@@ -1486,8 +1562,8 @@ window.__ModuleLoader__.load({
           if (!sessionVisible(summary, list ? list.current : undefined, archivedSet)) continue
           rows.push({
             id,
-            title: sessionTitleOf(summary, t),
-            leaf: sessionTitleOf(summary, t),
+            title: sessionTitleOf(summary, t, rememberedTitleOf(id)),
+            leaf: sessionTitleOf(summary, t, rememberedTitleOf(id)),
             blank: !!summary.blank,
             running: !!summary.running,
             completed: summary.completed === true,
@@ -2276,6 +2352,15 @@ window.__ModuleLoader__.load({
 
     /* ============================ plugin ============================== */
 
+    // Live title-cache store instance, set once per apply() and read directly
+    // by BetterBrowser. NOT a registration store seat: remembered titles only
+    // matter before the wire catches up, and every write happens when the
+    // wire already carries the same truth, so selector-hook re-renders would
+    // be pure noise. One instance per activation (never per mount) keeps the
+    // persist key single-writer — dsh-client-store warns same-key instances
+    // cross-pollinate one localStorage entry.
+    let titleCacheRef = null
+
     const flowSource = (slots, hole) => ({
       getSnapshot: () => {
         try { return slots.entries(hole).length > 0 } catch { return false }
@@ -2294,7 +2379,6 @@ window.__ModuleLoader__.load({
       const sessions = ctx.get('sessions')
       const workspaces = ctx.get('workspaces')
       const uiWorkspace = ctx.get('uiWorkspace')
-      const connection = ctx.get('connection')
       if (!sessions || !workspaces || !uiWorkspace) {
         console.error('[dsh-better-workspace] required services missing', {
           sessions: !!sessions, workspaces: !!workspaces, uiWorkspace: !!uiWorkspace,
@@ -2354,7 +2438,6 @@ window.__ModuleLoader__.load({
         pickDirectory: () => uiWorkspace.pickDirectory(),
         hooks: {
           directoryFlow: flowSource(slots, 'sidebar.workspaces.directoryFlow'),
-          connectionGeneration: connection ? connection.generation : undefined,
         },
       })
       const flowInjected = (hole) => () => ({
@@ -2395,6 +2478,12 @@ window.__ModuleLoader__.load({
       // same persisted state (expansion, folder list, prefs, styling).
       const viewStore = createViewStore()
 
+      // Cold-restart title fallback instance (see createTitleCacheStore).
+      // getSnapshot() during render is intentional: hydration reads
+      // localStorage synchronously at create(), so the first render after a
+      // restart already sees every remembered title.
+      titleCacheRef = createTitleCacheStore().create()
+
       // Settings → Plugins card only (the tab dispatches the intersection of
       // served namespaces — registered host-side — and settings.plugin.item
       // cards). The old left-nav settings.section entry was removed: the
@@ -2426,7 +2515,7 @@ window.__ModuleLoader__.load({
 
     return {
       name: 'dsh-better-workspace',
-      inject: ['slots', 'sessions', 'workspaces', 'locale', 'connection', 'uiWorkspace'],
+      inject: ['slots', 'sessions', 'workspaces', 'locale', 'uiWorkspace'],
       apply,
     }
   },