dsh-better-workspace 0.9.3 → 0.9.5

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,10 @@ web/                 ← 虚拟分组(不是真实目录,纯命名层级)
 
 工作区里的会话名称同样用 `/` 分层(如 `测试1/两个插件维护`)。会话分组用**次级配色且无文件夹图标**渲染,和工作区文件夹一眼可辨;会话分组可整组重命名(批量改写成员标题)。
 
+**重启后标题不回退**:DSH 重启后的冷列表只为命中投影缓存的会话携带标题——分叉出的会话与从未写过检查点的会话会暂时回退成「工作区名」显示,真实的标题其实还在会话日志里。本插件把每个会话**最近一次的真实标题**持久化在浏览器里(dsh 客户端 store),回退窗口内直接用记忆标题渲染,`/` 分级分组照常成立;打开会话后官方数据到位即自动纠正。
+
+**跨端手动同步(Web ↔ 桌面客户端)**:外观自定义、显式分组与开关默认保存在各设备自己的浏览器里;设置卡片新增「跨端同步」区——Web 上点「从客户端获取」、客户端上点「从 Web 获取」,可选**覆盖本设备**或**合并两端**(并集保留各自独有项),另一端的数据经宿主设置存储(~/.dsh/settings.yaml,两端共享)送达;旁边有「发送本设备数据」按钮,旧版本的历史数据首次同步推一次即可,之后每次修改都会自动写入宿主、对端随手可取。折叠状态仍保持每端独立。
+
 <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,10 @@ 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.
+
+**Manual cross-device sync (web ↔ desktop app)**: appearance, explicit folders, and toggles live in each device's own browser by default. The settings card adds a "Cross-device sync" section — "Pull from desktop app" on the web / "Pull from web" in the desktop app, with an **overwrite-this-device** or **merge-both-sides** mode (the union keeps each side's unique entries); the other surface's data travels through the host settings store (~/.dsh/settings.yaml, shared by both surfaces). A "Send this device's data" button next to it covers history created before this version — push once, and afterwards every edit is written to the host automatically for the other surface to pull. Expansion state stays per-device.
+
 <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.3",
+  "version": "0.9.5",
   "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.3",
+  "version": "0.9.5",
   "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

@@ -92,6 +92,17 @@ window.__ModuleLoader__.load({
       'custom.done': '完成',
       'settings.on': '开',
       'settings.off': '关',
+      'sync.title': '跨端同步',
+      'sync.desc': '外观自定义、显式分组与开关保存在本设备的浏览器里;通过宿主设置存储与另一端互传。平时的新修改会自动写入宿主,另一端点「获取」即可拿到;旧版本的历史数据首次需要点一次「发送」。',
+      'sync.mode.overwrite': '覆盖本设备',
+      'sync.mode.merge': '合并两端',
+      'sync.pull.desktop': '从客户端获取',
+      'sync.pull.web': '从 Web 获取',
+      'sync.push': '发送本设备数据',
+      'sync.done': '已同步',
+      'sync.empty': '另一端暂无数据可获取',
+      'sync.off': '当前环境不支持同步(需要宿主设置服务)',
+      'sync.loading': '正在连接宿主设置…',
       'flow.title': '添加工作区',
       'flow.picked': '所选文件夹',
       'flow.parent': '所属分组',
@@ -181,6 +192,17 @@ window.__ModuleLoader__.load({
       'custom.done': 'Done',
       'settings.on': 'On',
       'settings.off': 'Off',
+      'sync.title': 'Cross-device sync',
+      'sync.desc': "Appearance, explicit folders, and toggles live in this device's browser; they exchange with the other surface (web / desktop app) through the host settings store. New edits are written to the host automatically — the other surface just pulls. History created before this version needs one explicit Send.",
+      'sync.mode.overwrite': 'Overwrite this device',
+      'sync.mode.merge': 'Merge both sides',
+      'sync.pull.desktop': 'Pull from desktop app',
+      'sync.pull.web': 'Pull from web',
+      'sync.push': "Send this device's data",
+      'sync.done': 'Synced',
+      'sync.empty': 'No data on the other surface yet',
+      'sync.off': 'Sync unavailable here (requires the host settings service)',
+      'sync.loading': 'Connecting to host settings…',
       'flow.title': 'Add workspace',
       'flow.picked': 'Chosen folder',
       'flow.parent': 'Parent group',
@@ -304,9 +326,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 || '')
     }
 
@@ -638,6 +668,13 @@ window.__ModuleLoader__.load({
       '@keyframes bw-breathe{0%,100%{filter:drop-shadow(0 0 1px var(--bw-pulse-color));opacity:.55}50%{filter:drop-shadow(0 0 6px var(--bw-pulse-color));opacity:1}}',
       '.bw-pulse-text{animation:bw-breathe-text 1.8s ease-in-out infinite}',
       '@keyframes bw-breathe-text{0%,100%{text-shadow:0 0 1px var(--bw-pulse-color);opacity:.65}50%{text-shadow:0 0 7px var(--bw-pulse-color);opacity:1}}',
+      '.bw-sync-modes{display:flex;gap:6px;margin-top:8px}',
+      '.bw-sync-mode{flex:1;padding:5px 10px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.3));background:transparent;color:var(--dsw-alias-label-secondary,#b8b8b8);cursor:pointer;font-size:12px}',
+      '.bw-sync-mode-on{border-color:var(--dsw-alias-brand-primary,#5b8def);color:var(--dsw-alias-label-primary,#e6e6e6);background:var(--dsw-alias-bg-layer-2,rgba(127,127,127,.12))}',
+      '.bw-sync-actions{display:flex;gap:8px;margin-top:8px}',
+      '.bw-sync-btn{padding:5px 12px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2,rgba(127,127,127,.3));background:transparent;color:var(--dsw-alias-label-secondary,#b8b8b8);cursor:pointer;font-size:12px}',
+      '.bw-sync-btn:disabled{opacity:.45;cursor:default}',
+      '.bw-sync-btn-primary{border-color:var(--dsw-alias-brand-primary,#5b8def);color:var(--dsw-alias-label-primary,#e6e6e6)}',
     ].join('')
 
     const StyleNode = () => E('style', null, CSS_TEXT)
@@ -652,6 +689,30 @@ window.__ModuleLoader__.load({
       // every selector read takes a fallback.
       persist: 'dsh.betterWorkspace.view.v1',
       actions: {
+        // Manual-sync pull targets (overwrite / merge): the host settings
+        // values land in the local store, and rendering keeps reading the
+        // local selectors, so scope-less hosts keep working unchanged.
+        importHost: (d, host) => {
+          if (!host || typeof host !== 'object') return
+          if (host.styling && typeof host.styling === 'object') d.styling = host.styling
+          if (Array.isArray(host.folders)) d.folders = host.folders.slice()
+          if (!d.prefs) d.prefs = {}
+          if (host.compactChains !== undefined) d.prefs.compactChains = host.compactChains !== false
+          if (host.statusPulse !== undefined) d.prefs.statusPulse = host.statusPulse !== false
+        },
+        // Merge mode: union of both sides, the PULLED (host) copy wins any
+        // per-key conflict; prefs take the pulled booleans when present.
+        mergeHost: (d, host) => {
+          if (!host || typeof host !== 'object') return
+          if (host.styling && typeof host.styling === 'object') d.styling = { ...(d.styling || {}), ...host.styling }
+          if (Array.isArray(host.folders)) {
+            const merged = new Set([...(Array.isArray(d.folders) ? d.folders : []), ...host.folders])
+            d.folders = Array.from(merged)
+          }
+          if (!d.prefs) d.prefs = {}
+          if (host.compactChains !== undefined) d.prefs.compactChains = host.compactChains !== false
+          if (host.statusPulse !== undefined) d.prefs.statusPulse = host.statusPulse !== false
+        },
         setExpanded: (d, key, value) => { if (!d.expanded) d.expanded = {}; d.expanded[key] = value },
         setSessionsExpanded: (d, key, value) => { if (!d.sessionsExpanded) d.sessionsExpanded = {}; d.sessionsExpanded[key] = value },
         setSessionGroupExpanded: (d, key, value) => { if (!d.sessionGroups) d.sessionGroups = {}; d.sessionGroups[key] = value },
@@ -676,6 +737,135 @@ 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]]
+          }
+        },
+      },
+    })
+
+    /* ======================= host settings sync ======================= */
+
+    // Cross-device preferences: styling / explicit folders / the two toggles
+    // live in the HOST settings store (~/.dsh/settings.yaml through the
+    // better-workspace namespace). Web and the desktop app share one DSH_HOME,
+    // so a style set in the browser follows the user into the Electron app and
+    // back. The browser localStorage view store stays the rendering source and
+    // the fallback: host values are MIRRORED into it one-way, and every write
+    // goes to BOTH stores (local action for immediate echo, scope.set for
+    // durable cross-device persistence). Hosts without the settingsScope
+    // service — or non-loopback pages where the scope stays process-local —
+    // simply never mirror and never sync, which is exactly the pre-0.9.5
+    // browser-local behavior.
+    let prefsScopeRef = null
+    const HOST_SNAP_UNAVAILABLE = { status: 'unavailable', value: undefined }
+    const hostPrefsOf = (snap) => (snap && snap.status === 'ready' && snap.value && typeof snap.value === 'object'
+      ? snap.value
+      : null)
+    const scopeSet = (field, value) => {
+      const scope = prefsScopeRef
+      if (!scope || typeof scope.set !== 'function') return
+      try {
+        Promise.resolve(scope.set(field, value)).catch((error) => {
+          console.warn('[dsh-better-workspace] host settings write failed: ' + field, error)
+        })
+      } catch (error) {
+        console.warn('[dsh-better-workspace] host settings write threw: ' + field, error)
+      }
+    }
+    // React hook over the scope snapshot; degrades to a stable "unavailable"
+    // constant when the scope is absent so useSyncExternalStore never re-binds.
+    // The hook call itself is unconditional (React discipline: no conditional
+    // hooks) — capability probing lives inside the callbacks.
+    const HAS_USE_SYNC_EXTERNAL_STORE = typeof React.useSyncExternalStore === 'function'
+    const useHostScope = () => {
+      const scope = prefsScopeRef
+      return HAS_USE_SYNC_EXTERNAL_STORE
+        ? React.useSyncExternalStore(
+          (onChange) => (scope && typeof scope.subscribe === 'function' ? scope.subscribe(onChange) : () => {}),
+          () => {
+            try { return scope && typeof scope.getSnapshot === 'function' ? scope.getSnapshot() : HOST_SNAP_UNAVAILABLE } catch { return HOST_SNAP_UNAVAILABLE }
+          },
+        )
+        : HOST_SNAP_UNAVAILABLE
+    }
+
+    // MANUAL cross-device sync (user-chosen, never automatic): the settings
+    // card offers a pull button ("从客户端获取" on the web / "从 Web 获取" in
+    // the desktop app — the other surface's copy arrives through the host
+    // settings store) with an overwrite-or-merge mode choice, plus a push
+    // button that uploads THIS device's current values (pre-0.9.5 history was
+    // never uploaded, so a first explicit push is needed once). Routine new
+    // writes already dual-write through makeSharedWrites, so the host copy
+    // stays fresh after the first push.
+
+    // Shared write wrappers: local action first (immediate echo + fallback
+    // store), then the durable host write computed from the CURRENT rendered
+    // values — after a manual pull the local store already holds the host
+    // copy, so host-only entries written on the other surface survive.
+    const makeSharedWrites = (actions, stylingMap, foldersList) => ({
+      setStyling: (key, value) => {
+        if (actions && typeof actions.setStyling === 'function') actions.setStyling(key, value)
+        const next = { ...stylingMap }
+        if (value === null) delete next[key]
+        else next[key] = value
+        scopeSet('styling', next)
+      },
+      addFolder: (path) => {
+        if (actions && typeof actions.addFolder === 'function') actions.addFolder(path)
+        const p = normPath(path)
+        const base = Array.isArray(foldersList) ? foldersList : []
+        if (p !== '' && !base.includes(p)) scopeSet('folders', [...base, p])
+      },
+      removeFolder: (path) => {
+        if (actions && typeof actions.removeFolder === 'function') actions.removeFolder(path)
+        const base = Array.isArray(foldersList) ? foldersList : []
+        scopeSet('folders', base.filter(f => f !== path))
+      },
+      renameFolder: (oldPath, newPath) => {
+        if (actions && typeof actions.renameFolder === 'function') actions.renameFolder(oldPath, newPath)
+        const base = Array.isArray(foldersList) ? foldersList : []
+        const oo = oldPath + '/'
+        const nn = newPath + '/'
+        scopeSet('folders', Array.from(new Set(base.map(f => (f === oldPath ? newPath : (f.startsWith(oo) ? nn + f.slice(oo.length) : f))))))
+      },
+      setPref: (key, value) => {
+        if (actions && typeof actions.setPref === 'function') actions.setPref(key, value)
+        scopeSet(key, value)
+      },
+    })
+
     /* ============================ flow dialog ========================= */
 
     const BTN = (props) => (
@@ -767,6 +957,8 @@ window.__ModuleLoader__.load({
       // while closed, but its hook sequence must stay stable.
       const snapshotItems = typeof useWorkspaces === 'function' ? useWorkspaces(s => s.items) : []
       const storeFolders = typeof useStore === 'function' ? (useStore(s => s.folders) || []) : []
+      const storeStyling = typeof useStore === 'function' ? (useStore(s => s.styling) || {}) : {}
+      const shared = makeSharedWrites(actions, storeStyling, storeFolders)
 
       React.useEffect(() => {
         if (!open) {
@@ -821,7 +1013,7 @@ window.__ModuleLoader__.load({
               onCancel()
               return
             }
-            if (prefix !== '' && actions && typeof actions.addFolder === 'function') actions.addFolder(prefix)
+            if (prefix !== '') shared.addFolder(prefix)
             onCancel()
           })
           .catch((reason) => {
@@ -1216,10 +1408,53 @@ window.__ModuleLoader__.load({
 
     /* ------------------------- settings page ------------------------- */
 
+    // The desktop renderer serves the shell over the private dsh-app: scheme;
+    // every other context (http/https) is the web profile.
+    const IS_DESKTOP_SURFACE = typeof location !== 'undefined' && location.protocol === 'dsh-app:'
+
     function BetterWorkspaceSettings({ useStore, actions, t }) {
       const prefs = useStore ? (useStore(s => s.prefs) || {}) : {}
+      const localStyling = useStore ? (useStore(s => s.styling) || {}) : {}
+      const localFolders = useStore ? (useStore(s => s.folders) || []) : []
       const compactChains = prefs.compactChains !== false
       const statusPulse = prefs.statusPulse !== false
+      const setPref = (key, value) => {
+        if (actions && typeof actions.setPref === 'function') actions.setPref(key, value)
+        scopeSet(key, value)
+      }
+      // Manual cross-device sync state.
+      const [syncMode, setSyncMode] = React.useState('overwrite')
+      const [syncMsg, setSyncMsg] = React.useState(null)
+      const snap = useHostScope()
+      const host = hostPrefsOf(snap)
+      const scopeLive = prefsScopeRef !== null
+      const onPull = () => {
+        if (host === null) { setSyncMsg(t('sync.empty')); return }
+        if (syncMode === 'merge' && actions && typeof actions.mergeHost === 'function') actions.mergeHost(host)
+        else if (actions && typeof actions.importHost === 'function') actions.importHost(host)
+        else { setSyncMsg(t('sync.off')); return }
+        setSyncMsg(t('sync.done'))
+      }
+      const onPush = () => {
+        const folders = Array.isArray(localFolders) ? localFolders.slice() : []
+        scopeSet('styling', localStyling)
+        scopeSet('folders', folders)
+        scopeSet('compactChains', prefs.compactChains !== false)
+        scopeSet('statusPulse', prefs.statusPulse !== false)
+        setSyncMsg(t('sync.done'))
+      }
+      const modeButton = (id, label) => E('button', {
+        type: 'button',
+        className: cls('bw-sync-mode', syncMode === id && 'bw-sync-mode-on'),
+        'aria-pressed': syncMode === id,
+        onClick: () => { setSyncMode(id); setSyncMsg(null) },
+      }, label)
+      const syncActionButton = (label, onClick, primary, disabled) => E('button', {
+        type: 'button',
+        className: cls('bw-sync-btn', primary && 'bw-sync-btn-primary'),
+        disabled,
+        onClick,
+      }, label)
       return E('div', { className: 'bw-settings' },
         StyleNode(),
         E('div', { className: 'bw-setting-row' },
@@ -1230,7 +1465,7 @@ window.__ModuleLoader__.load({
             'aria-checked': compactChains,
             'aria-label': t('settings.compactChains'),
             className: cls('bw-switch', compactChains && 'bw-switch-on'),
-            onClick: () => { actions.setPref('compactChains', !compactChains) },
+            onClick: () => { setPref('compactChains', !compactChains) },
           }, E('span', { className: 'bw-switch-thumb' })),
         ),
         E('div', { className: 'bw-hint' }, t('settings.compactChains.hint')),
@@ -1242,10 +1477,23 @@ window.__ModuleLoader__.load({
             'aria-checked': statusPulse,
             'aria-label': t('settings.statusPulse'),
             className: cls('bw-switch', statusPulse && 'bw-switch-on'),
-            onClick: () => { actions.setPref('statusPulse', !statusPulse) },
+            onClick: () => { setPref('statusPulse', !statusPulse) },
           }, E('span', { className: 'bw-switch-thumb' })),
         ),
         E('div', { className: 'bw-hint' }, t('settings.statusPulse.hint')),
+        E('div', { className: 'bw-setting-label', style: { marginTop: 16 } }, t('sync.title')),
+        E('div', { className: 'bw-hint' }, t('sync.desc')),
+        E('div', { className: 'bw-sync-modes' },
+          modeButton('overwrite', t('sync.mode.overwrite')),
+          modeButton('merge', t('sync.mode.merge')),
+        ),
+        E('div', { className: 'bw-sync-actions' },
+          syncActionButton(t(IS_DESKTOP_SURFACE ? 'sync.pull.web' : 'sync.pull.desktop'), onPull, true, !scopeLive || snap.status === 'loading'),
+          syncActionButton(t('sync.push'), onPush, false, !scopeLive),
+        ),
+        syncMsg !== null ? E('div', { className: 'bw-hint' }, syncMsg)
+          : (scopeLive ? null : E('div', { className: 'bw-hint' }, t('sync.off'))),
+        scopeLive && snap.status === 'loading' ? E('div', { className: 'bw-hint' }, t('sync.loading')) : null,
       )
     }
 
@@ -1302,10 +1550,45 @@ window.__ModuleLoader__.load({
       const sessionGroupsMap = useStore ? (useStore(s => s.sessionGroups) || {}) : {}
       const prefsMap = useStore ? (useStore(s => s.prefs) || {}) : {}
       const stylingMap = useStore ? (useStore(s => s.styling) || {}) : {}
+      // Dual-write wrappers: every preference mutation lands in the local
+      // store (immediate echo + scope-less fallback) AND the host settings
+      // store (durable cross-device copy for the manual pull on the other
+      // surface). Computed from the CURRENT rendered values.
+      const shared = makeSharedWrites(actions, stylingMap, storeFolders)
       const compactChains = prefsMap.compactChains !== false
       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 +1734,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 +1769,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,
@@ -1868,7 +2151,7 @@ window.__ModuleLoader__.load({
           for (let i = 1; i < segs.length; i++) derived.add(segs.slice(0, i).join('/'))
         }
         if (storeFolders.includes(p) || derived.has(p)) { setErrorText(t('folder.error.exists')); return }
-        actions.addFolder(p)
+        shared.addFolder(p)
         setDialog(null)
       }
 
@@ -1889,14 +2172,14 @@ window.__ModuleLoader__.load({
               await renameWorkspace(w.workspaceId, nextTitle)
             }
           })
-          .then(() => { actions.renameFolder(oldPath, newPath); setDialog(null) })
+          .then(() => { shared.renameFolder(oldPath, newPath); setDialog(null) })
           .catch(fail)
       }
 
       const submitFolderDelete = (path) => {
         const node = findTreeNode(tree, path)
         if (node && countWorkspaces(node) > 0) { setErrorText(t('folder.error.notEmpty')); return }
-        actions.removeFolder(path)
+        shared.removeFolder(path)
         setDialog(null)
       }
 
@@ -2259,8 +2542,8 @@ window.__ModuleLoader__.load({
           open: customize !== null,
           kind: customize ? customize.kind : undefined,
           initial: customize ? styleEntry(customize.entryKey) : undefined,
-          onChange: (style) => { if (customize) actions.setStyling(customize.entryKey, style) },
-          onReset: () => { if (customize) actions.setStyling(customize.entryKey, null) },
+          onChange: (style) => { if (customize) shared.setStyling(customize.entryKey, style) },
+          onReset: () => { if (customize) shared.setStyling(customize.entryKey, null) },
           onClose: () => setCustomize(null),
           t,
         }),
@@ -2276,6 +2559,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 }
@@ -2393,6 +2685,25 @@ 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()
+
+      // Cross-device settings scope (manual sync, see the host-settings-sync
+      // block). Binding is best-effort: a missing/failed bind leaves the
+      // plugin fully browser-local — the pre-0.9.5 behavior.
+      prefsScopeRef = null
+      try {
+        if (ctx.settingsScope && typeof ctx.settingsScope.bind === 'function') {
+          prefsScopeRef = ctx.settingsScope.bind({ namespace: 'better-workspace' })
+        }
+      } catch (error) {
+        console.warn('[dsh-better-workspace] settings scope bind failed; sync stays local', error)
+        prefsScopeRef = null
+      }
+
       // 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
@@ -2424,7 +2735,7 @@ window.__ModuleLoader__.load({
 
     return {
       name: 'dsh-better-workspace',
-      inject: ['slots', 'sessions', 'workspaces', 'locale', 'uiWorkspace'],
+      inject: ['slots', 'sessions', 'workspaces', 'locale', 'uiWorkspace', 'settingsScope'],
       apply,
     }
   },

package/src/index.js

@@ -49,7 +49,17 @@ export function apply(ctx) {
         const ns = typeof ds.settingsNamespace === 'function'
           ? ds.settingsNamespace('better-workspace')
           : 'better-workspace'
-        settings.register(ns, Schema.object({ compactChains: Schema.boolean().default(true) }))
+        settings.register(ns, Schema.object({
+          // Cross-device preferences live in the HOST settings store
+          // (~/.dsh/settings.yaml): web and the desktop app share one
+          // DSH_HOME, so appearance (styling), explicit folders, and the two
+          // toggles follow the user across surfaces. Per-device view state
+          // (expansion) and the cold-restart title cache stay browser-local.
+          compactChains: Schema.boolean().default(true),
+          statusPulse: Schema.boolean().default(true),
+          folders: Schema.array(Schema.string()).default([]),
+          styling: Schema.dict(Schema.any()).default({}),
+        }))
         log('[dsh-better-workspace] settings namespace registered: better-workspace')
       })
       .catch((error) => {