dsh-better-workspace 0.9.4 → 0.9.6

package/README.md

@@ -33,7 +33,9 @@ web/                 ← 虚拟分组(不是真实目录,纯命名层级)
 
 工作区里的会话名称同样用 `/` 分层(如 `测试1/两个插件维护`)。会话分组用**次级配色且无文件夹图标**渲染,和工作区文件夹一眼可辨;会话分组可整组重命名(批量改写成员标题)。
 
-**重启后标题不回退**:DSH 重启后的冷列表只为命中投影缓存的会话携带标题——分叉出的会话与从未写过检查点的会话会暂时回退成「工作区名」显示,真实的标题其实还在会话日志里。本插件把每个会话**最近一次的真实标题**持久化在浏览器里(dsh 客户端 store),回退窗口内直接用记忆标题渲染,`/` 分级分组照常成立;打开会话后官方数据到位即自动纠正。
+**重启后标题不回退**:DSH 重启后的冷列表只为命中投影缓存的会话携带标题——分叉出的会话与从未写过检查点的会话会暂时回退成「工作区名」显示,真实的标题其实还在会话日志里。本插件把每个会话**最近一次的真实标题**持久化在浏览器里(带防抖的本地缓存,变更合并整写一次),回退窗口内直接用记忆标题渲染,`/` 分级分组照常成立;打开会话后官方数据到位即自动纠正。
+
+**跨端手动同步(Web ↔ 桌面客户端)**:外观自定义、显式分组与开关默认保存在各设备自己的浏览器里;设置卡片新增「跨端同步」区——Web 上点「从客户端获取」、客户端上点「从 Web 获取」,可选**覆盖本设备**或**合并两端**(并集保留各自独有项),另一端的数据经宿主设置存储(~/.dsh/settings.yaml,两端共享)送达;旁边有「发送本设备数据」按钮,旧版本的历史数据首次同步推一次即可,之后每次修改都会自动写入宿主、对端随手可取。折叠状态仍保持每端独立。
 
 <table>
 <tr>

package/README_EN.md

@@ -31,7 +31,9 @@ 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.
+**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 (a debounced local cache: real changes coalesce into one write) 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>

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-better-workspace",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "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.4",
+  "version": "0.9.6",
   "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": {

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',
@@ -646,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)
@@ -660,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 },
@@ -696,29 +749,150 @@ window.__ModuleLoader__.load({
     // 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
+    // the "/" grouping until the wire catches up. 0.9.6: plain module
+    // state with one debounced whole-file save per real change batch
+    // (issue #1: per-session reactive-store dispatches cost O(sessions)
+    // immer produces per snapshot tick and froze large installs). Same-
+    // value scans allocate nothing; 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]]
-          }
-        },
+    const TITLE_CACHE_KEY = 'dsh.betterWorkspace.titles.v1'
+    const titleCache = { byId: {} }
+    let titleSaveTimer = null
+    const loadTitleCache = () => {
+      try {
+        const raw = localStorage.getItem(TITLE_CACHE_KEY)
+        if (raw !== null) {
+          const parsed = JSON.parse(raw)
+          if (parsed && typeof parsed.byId === 'object' && parsed.byId !== null) titleCache.byId = parsed.byId
+        }
+      } catch (e) { /* storage unavailable/corrupt: cold start without cache */ }
+    }
+    const scheduleTitleSave = () => {
+      clearTimeout(titleSaveTimer)
+      titleSaveTimer = setTimeout(() => {
+        try { localStorage.setItem(TITLE_CACHE_KEY, JSON.stringify(titleCache)) } catch (e) {}
+      }, 200)
+    }
+    // One plain-object batch pass per snapshot (issue #1). Unchanged scans
+    // cost one loop with zero allocation; only real changes mark dirty;
+    // eviction runs once per changed batch followed by ONE debounced save.
+    const rememberAllTitles = (list) => {
+      if (!list || !list.byId) return false
+      const byId = titleCache.byId
+      const now = Date.now()
+      let changed = false
+      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
+        const prev = byId[id]
+        if (prev && prev.title === title) continue
+        byId[id] = { title: title, at: now }
+        changed = true
+      }
+      if (!changed) return false
+      const keys = Object.keys(byId)
+      if (keys.length > TITLE_CACHE_LIMIT) {
+        keys.sort((a, b) => ((byId[a] && byId[a].at) || 0) - ((byId[b] && byId[b].at) || 0))
+        for (let i = 0; i < keys.length - TITLE_CACHE_KEEP; i++) delete byId[keys[i]]
+      }
+      scheduleTitleSave()
+      return true
+    }
+
+    /* ======================= 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)
       },
     })
 
@@ -813,6 +987,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) {
@@ -867,7 +1043,7 @@ window.__ModuleLoader__.load({
               onCancel()
               return
             }
-            if (prefix !== '' && actions && typeof actions.addFolder === 'function') actions.addFolder(prefix)
+            if (prefix !== '') shared.addFolder(prefix)
             onCancel()
           })
           .catch((reason) => {
@@ -1262,10 +1438,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' },
@@ -1276,7 +1495,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')),
@@ -1288,10 +1507,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,
       )
     }
 
@@ -1348,12 +1580,17 @@ 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
+      // the title-cache block). 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.
@@ -1365,21 +1602,13 @@ window.__ModuleLoader__.load({
       // 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.
+      // provisional New Sessions and never learn. One plain-object batch
+      // call per snapshot (issue #1): unchanged scans cost one loop with
+      // zero allocation, real changes schedule one debounced save.
       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)
+        if (titleCacheRef && typeof titleCacheRef.rememberAllTitles === 'function') {
+          titleCacheRef.rememberAllTitles(list)
         }
       }, [list ? list.byId : null])
 
@@ -1944,7 +2173,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)
       }
 
@@ -1965,14 +2194,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)
       }
 
@@ -2335,8 +2564,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,
         }),
@@ -2478,11 +2707,24 @@ 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()
+      // Cold-restart title fallback (see the title-cache block). Hydration
+      // reads localStorage synchronously here, before the first render, so a
+      // restart's first tree already shows every remembered title.
+      loadTitleCache()
+      titleCacheRef = { getSnapshot: () => titleCache, rememberAllTitles }
+
+      // 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
@@ -2515,7 +2757,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) => {