@philomelcc/dsh-workbench 0.1.3 → 0.1.5

package/README.md

@@ -1,26 +1,23 @@
 # @philomelcc/dsh-workbench
 
-The shell: a second top-bar row of workbench tabs, one page per module, plus the
-small API modules register against.
+外壳本体：顶部第二行的标签切换、每个模块一整页，以及模块注册用的那套小 API。
 
-This package does almost nothing on its own — install it together with at least
-one module:
+它单独装没什么用——至少配一个模块：
 
 ```powershell
 dsh plugin --profile web add @philomelcc/dsh-workbench
 dsh plugin --profile web add @philomelcc/dsh-status-monitor
 ```
 
-Contract: [`docs/SPEC.md`](../../docs/SPEC.md) · module template: [`template/`](../../template) ·
-ready-made modules: [status monitor](../status-monitor), [download center](../download-center).
+契约：[`docs/SPEC.md`](../../docs/SPEC.md) · 模板：[`template/`](../../template) ·
+现成模块：[状态监控](../status-monitor)、[下载中心](../download-center)。
 
-What the shell provides:
+外壳提供：
 
-- `registerView({ id, title, icon, component, order, subtitle, badge, tab })` —
-  one tab, one full page;
-- `components` (StatusDot, Card, SectionHeader, EmptyState, Spinner, Button, Field);
-- `tokens` (theme colors that follow light/dark);
-- `apiVersion` — `1` today;
-- `refresh()` — repaint the tab row after a badge changed.
+- `registerView({ id, title, icon, component, order, subtitle, badge, tab })` —— 一个标签、一整页；
+- `components`（StatusDot / Card / SectionHeader / EmptyState / Spinner / Button / Field）；
+- `tokens`（跟随明暗主题的颜色 token）；
+- `apiVersion` —— 目前是 `1`；
+- `refresh()` —— 角标变化后重绘标签行。
 
-MIT.
+MIT。

package/client.js

@@ -435,84 +435,193 @@ window.__ModuleLoader__.load({
     }
 
     // ---------- theme switcher ----------
-    // `paper` builds on the light palette and overrides the alias layer only.
-    const PAPER_THEME = {
-      id: 'paper',
-      colorScheme: 'light',
-      tokens: {
-        '--dsw-alias-bg-base': '#f4efe3',
-        '--dsw-alias-bg-layer-1': '#efe9db',
-        '--dsw-alias-bg-layer-2': '#e7dfcd',
-        '--dsw-alias-bg-overlay': '#fbf7ee',
-        '--dsw-alias-border-l1': '#d8cfba',
-        '--dsw-alias-border-l2': '#c6bba2',
-        '--dsw-alias-brand-primary': '#8a6a45',
-        '--dsw-alias-label-primary': '#3b342a',
-        '--dsw-alias-label-secondary': '#6f6557',
-        '--dsw-alias-state-error-primary': '#a34a3c',
-        '--dsw-alias-state-warn-primary': '#a8792c',
-        '--dsw-alias-state-success-primary': '#4f7a5a',
-        '--dsw-alias-state-idle-primary': '#a49a89',
-        '--dsw-specific-sidebar-fill': '#efe9db',
-      },
+    // `paper` cannot be a persisted preference: DSH only accepts light / dark /
+    // system there, and anything else is dropped when settings resync (that is
+    // why switching models used to fall back to dark). So the paper palette is
+    // an override layer on top of the legal `light` preference, remembered in
+    // localStorage by us.
+    const PAPER_KEY = 'dsh-workbench:paper';
+    const PAPER_TOKENS = {
+      '--dsw-alias-bg-base': '#f4efe3',
+      '--dsw-alias-bg-layer-1': '#efe9db',
+      '--dsw-alias-bg-layer-2': '#e7dfcd',
+      '--dsw-alias-bg-overlay': '#fbf7ee',
+      '--dsw-alias-border-l1': '#d8cfba',
+      '--dsw-alias-border-l2': '#c6bba2',
+      '--dsw-alias-brand-primary': '#8a6a45',
+      '--dsw-alias-label-primary': '#3b342a',
+      '--dsw-alias-label-secondary': '#6f6557',
+      '--dsw-alias-state-error-primary': '#a34a3c',
+      '--dsw-alias-state-warn-primary': '#a8792c',
+      '--dsw-alias-state-success-primary': '#4f7a5a',
+      '--dsw-alias-state-idle-primary': '#a49a89',
+      '--dsw-specific-sidebar-fill': '#efe9db',
+      // Chat bubbles: the light base uses a pale DeepSeek blue, which looks
+      // wrong on paper. These two are outside the alias layer.
+      '--dsw-specific-bubble': '#efe7d6',
+      '--dsw-specific-bubble-highlight': '#e4d8c0',
     };
 
     // Swatches double as both the current-state indicator and the toggle.
     const THEME_SWATCHES = [
-      { id: 'dark', label: '深色', color: '#15171a' },
-      { id: 'light', label: '浅色', color: '#f7f8fa' },
-      { id: 'paper', label: '纸质', color: '#f4efe3' },
+      { id: 'dark', label: '深色', color: '#15171a', ring: 'rgba(255,255,255,0.28)' },
+      { id: 'light', label: '浅色', color: '#f7f8fa', ring: 'rgba(0,0,0,0.35)' },
+      { id: 'paper', label: '纸质', color: '#efe4cd', ring: 'rgba(0,0,0,0.28)' },
     ];
 
     function createThemeSwitcher(ctx) {
-      function ThemeSwitcher() {
+      const readPreference = () => {
+        try {
+          const theme = typeof ctx.get === 'function' ? ctx.get('theme') : ctx.theme;
+          const snapshot = theme && typeof theme.getTheme === 'function' ? theme.getTheme() : null;
+          return snapshot ? snapshot.preference : null;
+        } catch (_error) {
+          return null;
+        }
+      };
+      const readPaper = () => {
+        try { return window.localStorage.getItem(PAPER_KEY) === '1'; } catch (_error) { return false; }
+      };
+      const writePaper = (on) => {
+        try { window.localStorage.setItem(PAPER_KEY, on ? '1' : '0'); } catch (_error) { /* storage unavailable */ }
+      };
+
+      let paperDispose = null;
+      function setPaper(on) {
         const theme = typeof ctx.get === 'function' ? ctx.get('theme') : ctx.theme;
-        const read = () => {
+        if (!theme) return;
+        if (on) {
+          if (paperDispose) return;
+          // Legal persisted preference first, then paint the paper layer on top.
+          try { theme.setTheme('light'); } catch (error) { console.warn('[workbench] setTheme light failed', error); }
+          const modes = {};
+          Object.keys(PAPER_TOKENS).forEach((name) => {
+            modes[name] = { light: PAPER_TOKENS[name], dark: PAPER_TOKENS[name] };
+          });
           try {
-            const snapshot = theme && typeof theme.getTheme === 'function' ? theme.getTheme() : null;
-            return snapshot ? snapshot.preference : null;
-          } catch (_error) {
-            return null;
+            paperDispose = typeof theme.overrideTokens === 'function' ? theme.overrideTokens('workbench:paper', modes) : null;
+          } catch (error) {
+            console.warn('[workbench] paper override failed', error);
+            paperDispose = null;
           }
-        };
-        const [preference, setPreference] = React.useState(read);
+        } else if (paperDispose) {
+          try { paperDispose(); } catch (_error) { /* already gone */ }
+          paperDispose = null;
+        }
+      }
+
+      function ThemeSwitcher() {
+        const boxRef = React.useRef(null);
+        const [paper, setPaperState] = React.useState(readPaper);
+        const [preference, setPreference] = React.useState(readPreference);
+
+        // The account block is fixed to the right and changes width (a reconnect
+        // banner widens it), so park the swatches against its measured left edge
+        // instead of a guessed margin.
+        React.useEffect(() => {
+          const box = boxRef.current;
+          if (!box) return undefined;
+          const place = () => {
+            const settings = document.querySelector('[class*="settingsArea"]');
+            if (!settings) {
+              box.style.right = '150px';
+              return;
+            }
+            const rect = settings.getBoundingClientRect();
+            if (rect.width > 0) box.style.right = (rect.width + 16 + 12) + 'px';
+            // Same box as the account block, so `align-items: center` lands on
+            // the account's optical center instead of a guessed offset.
+            if (rect.height > 0) {
+              box.style.top = rect.top + 'px';
+              box.style.height = rect.height + 'px';
+            }
+          };
+          place();
+          let observer = null;
+          const settings = document.querySelector('[class*="settingsArea"]');
+          if (settings && typeof ResizeObserver !== 'undefined') {
+            observer = new ResizeObserver(place);
+            // border-box: the account's width changes through its chrome, not
+            // just its text content.
+            observer.observe(settings, { box: 'border-box' });
+          }
+          window.addEventListener('resize', place);
+          return () => {
+            if (observer) observer.disconnect();
+            window.removeEventListener('resize', place);
+          };
+        }, []);
+
+        // Re-apply the saved paper layer after a reload / remount.
+        React.useEffect(() => {
+          if (readPaper()) setPaper(true);
+        }, []);
 
+        // Swatches only re-render on real preference changes; the paper layer is
+        // local state because the theme service does not know about it.
         React.useEffect(() => {
-          if (!theme || typeof theme.getTheme !== 'function' || typeof ctx.on !== 'function') return undefined;
+          if (typeof ctx.on !== 'function') return undefined;
           let off = null;
           try {
-            off = ctx.on('theme/change', () => setPreference(read()));
+            off = ctx.on('theme/change', () => {
+              const next = readPreference();
+              setPreference(next);
+              // Somebody picked a concrete palette in DSH's own settings: drop the layer.
+              if (next && next !== 'light' && paper) {
+                setPaper(false);
+                writePaper(false);
+                setPaperState(false);
+              }
+            });
           } catch (_error) {
             off = null;
           }
           return () => { if (typeof off === 'function') off(); };
-        }, []);
+        }, [paper]);
+
+        const activeId = paper ? 'paper' : (preference === 'dark' ? 'dark' : 'light');
+
+        const choose = (id) => {
+          const theme = typeof ctx.get === 'function' ? ctx.get('theme') : ctx.theme;
+          if (!theme) return;
+          if (id === 'paper') {
+            setPaper(true);
+            writePaper(true);
+            setPaperState(true);
+            return;
+          }
+          setPaper(false);
+          writePaper(false);
+          setPaperState(false);
+          try { theme.setTheme(id); } catch (error) { console.warn('[workbench] setTheme failed', error); }
+        };
 
         return h('div', {
-          style: { display: 'inline-flex', alignItems: 'center', gap: 7, flex: '0 0 auto' },
+          ref: boxRef,
+          style: {
+            position: 'fixed', top: 2, height: 40, zIndex: 301,
+            display: 'inline-flex', alignItems: 'center', gap: 8,
+          },
           title: '主题',
         },
           THEME_SWATCHES.map((swatch) => {
-            const active = preference === swatch.id;
+            const active = activeId === swatch.id;
             return h('button', {
               key: swatch.id,
               type: 'button',
               title: swatch.label,
               'aria-label': swatch.label,
               'aria-pressed': active ? 'true' : 'false',
-              onClick: () => {
-                if (!theme || typeof theme.setTheme !== 'function') return;
-                try { theme.setTheme(swatch.id); } catch (error) { console.warn('[workbench] setTheme failed', error); }
-              },
+              onClick: () => choose(swatch.id),
               style: {
-                width: 15, height: 15, padding: 0, borderRadius: '50%', flex: '0 0 auto',
+                width: 17, height: 17, padding: 0, borderRadius: '50%', flex: '0 0 auto',
                 background: swatch.color,
-                border: '1px solid ' + (active ? 'var(--dsw-alias-brand-primary)' : 'var(--dsw-alias-border-l2)'),
-                boxShadow: active
-                  ? '0 0 0 2px var(--dsw-alias-bg-base), 0 0 0 3px var(--dsw-alias-brand-primary)'
-                  : 'none',
+                // A hairline ring keeps the dark swatch readable on a dark bar;
+                // the selected one only thickens and takes the brand color.
+                border: (active ? '1.5px' : '1px') + ' solid ' + (active ? 'var(--dsw-alias-brand-primary)' : swatch.ring),
+                boxSizing: 'border-box',
                 cursor: 'pointer',
-                transition: 'box-shadow .12s, border-color .12s',
+                transition: 'border-color .12s, border-width .12s',
               },
             });
           }),
@@ -530,7 +639,9 @@ window.__ModuleLoader__.load({
         const tone = snap.phase === 'ready' ? balanceTone(snap.amount) : 'muted';
         const value = snap.phase === 'ready' && typeof snap.amount === 'number' ? snap.amount.toFixed(2) : (snap.phase === 'loading' ? '…' : '—');
         const toneColor = tone === 'green' ? '#4ade80' : tone === 'amber' ? '#e3b341' : tone === 'red' ? '#f87171' : 'var(--dsw-alias-label-secondary)';
-        const borderBase = tone === 'green' ? '#2f4a37' : tone === 'amber' ? '#4a3d22' : tone === 'red' ? '#4a2a2a' : 'var(--dsw-alias-border-l2)';
+        // The border follows the theme: hard-coded dark greens read as a black
+        // ring on light/paper backgrounds.
+        const borderBase = 'var(--dsw-alias-border-l2)';
         const at = new Date(snap.updatedAt || Date.now()).toLocaleTimeString('zh-CN', { hour12: false });
         return h('div', {
           style: { position: 'relative', display: 'inline-flex' },
@@ -726,7 +837,7 @@ window.__ModuleLoader__.load({
               iconBtn('plugins', '插件', IconPlugins),
               iconBtn('schedules', '自动化任务', IconClock),
             ),
-            h('div', { style: { flex: '0 0 auto', marginRight: 150 } }, h(ThemeSwitcher)),
+            h(ThemeSwitcher),
           ),
           h('div', { style: { height: 45, display: 'flex', alignItems: 'center', gap: 8, padding: '0 14px', borderTop: '1px solid var(--dsw-alias-border-l1)' } },
             h('div', { ref: tabsRef, style: { position: 'relative', display: 'flex', alignItems: 'center', gap: 4, flex: 1, overflowX: 'auto', overflowY: 'hidden' } },
@@ -1329,16 +1440,6 @@ div[data-row-key^="session:"]:has(svg[data-state="ongoing"]) svg[data-state="ong
         layoutService = ctx.get('layout') || null;
         layoutGetter = () => ctx.get('layout') || null;
 
-        // Extra palette on top of the built-in light/dark pair.
-        try {
-          const themeService = typeof ctx.get === 'function' ? ctx.get('theme') : null;
-          if (themeService && typeof themeService.register === 'function') {
-            ctx.effect(() => themeService.register(PAPER_THEME), 'workbench: paper theme');
-          }
-        } catch (error) {
-          console.warn('[workbench] paper theme registration failed', error);
-        }
-
         // The shell's own overview lives above the tab row: it is reachable from
         // the top-bar "工作台" icon, so it registers a page without a tab.
         ctx.effect(() => api.registerView({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@philomelcc/dsh-workbench",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "description": "Workbench shell for DeepSeek Harness: a view/page module API, shared UI primitives and a top-bar switcher.",
   "license": "MIT",