@starwish-ai/xingyuan-dsh 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -5,6 +5,68 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.2] - 2026-08-27
+
+### Added
+- **Controllable conversation-view tabs**: the six tabs (Today / Wishes / Tasks /
+  Calendar / Growth / Memory) are no longer always present. Default mode **follows the
+  session preset** — tabs appear only in sessions composed from the `xingyuan` preset and
+  stay out of every other conversation. Settings → XingYuan gains a **Tab visibility**
+  card with three modes (`Follow session` / `Always show` / `Always hide`) plus
+  per-tab toggles (`hiddenTabs`, all shown by default). The preference namespace
+  (`xingyuan-ui`) is installed by the bundle layer, so it works before any XingYuan
+  session exists and stays reachable even when tabs are fully hidden (a preset-layer
+  namespace would be unavailable exactly when needed). Today's page shows a one-line
+  notice when "Always show" puts the tabs into a non-XingYuan session (pages stay fully
+  browsable and operable; only the chat-side capabilities are absent). Read-only URL
+  pages (`/xingyuan/*`) and chat cards are unaffected.
+- New tab-visibility policy (`visibleTabIds`) with dirty-value tolerance (unknown/duplicate
+  hidden ids are ignored); covered by `test/tab-policy.test.ts`.
+
+### Fixed
+- Client boot crash: the tab-visibility controller subscribed to the injected `sessions`
+  service itself, which has no `subscribe` — the session-list snapshot lives on
+  `sessions.list`. The client half failed to load entirely ("Failed to load plugins"),
+  which also hid the Settings → XingYuan card. Subscriptions now target
+  `sessions.list` (`getSnapshot`/`subscribe`).
+- Tab-visibility toggles had inverted semantics: the check chips rendered "hidden" as
+  "checked", so ticking a tab produced no change. `shown` now reads
+  `!hiddenTabs.includes(id)` (checked = shown).
+
+## [0.5.1] - 2026-08-27
+
+Patch release. Two hardening changes: sessions that contain `xingyuan/*` card events
+now survive cold loads after a restart, and the client stylesheet no longer depends on
+`color-mix()` support in the hosting browser. No schema changes; existing data stays
+compatible.
+
+### Added
+- Session-log self-repair (`session-log-repair.ts`): at activation the bundle scans
+  `$DSH_HOME/sessions` and adds `"ignorable": true` to `xingyuan/*` event lines, so
+  conversations containing cards are no longer rejected wholesale by the session format
+  reader after a process restart. Files without xingyuan events are never written;
+  non-xingyuan lines keep their exact bytes; originals are backed up before the first
+  rewrite (3 kept per session); torn tails, corrupt frames, version mismatches,
+  unparsable lines, and live sessions are skipped whole-file. A per-session marker
+  records the artifact byte size, so already-repaired sessions skip the decompress scan
+  at the next startup (68 sessions: 3.6s → <10ms). Containers whose first zstd frame is
+  not exactly one header line — a legacy single-frame layout that broke host startup —
+  are rewritten into the valid layout even when no marking is needed.
+- New bundle config `repairSessionLogs` (default `true`) to disable the self-repair pass.
+
+### Changed
+- Client styles no longer use `color-mix()`; derived colors are explicit per-theme rgba
+  tokens (`--xyd-*-border/ring/hatch/hover`). Empty and error states are plain text
+  layouts — the SVG line-art illustrations whose strokes relied on `color-mix()` are
+  removed — and the growth hero gradient is pre-mixed in JS (`darkenHex`).
+
+### Fixed
+- Conversations containing `xingyuan/*` card events could not be reopened after a
+  process restart (`SessionFormatUnsupportedError`); they are now self-healed at
+  activation and replay their cards again.
+- In browsers without `color-mix()` support, decorative strokes (empty-state art, hover
+  rings, hatch fills, danger buttons) silently vanished, leaving isolated accent dots.
+
 ## [0.5.0] - 2026-08-27
 
 Write-path unification and read-side freshness alignment between the chat tools,

package/README.en-US.md

@@ -14,7 +14,7 @@ XingYuan is a wish & habit-building companion, shipped as a DeepSeek Harness plu
 - **Opportunity-day check-ins**: check-in, make-up, cancel, and future pre-checks; progress always recomputed against today
 - **Micro-actions**: break an overwhelming goal into 3–7 tiny steps and walk through them guided
 - **Growth system**: levels Lv.1–Lv.10, streak bonuses, stat cards, 30-day bar chart
-- **Session view tabs**: Today / Wishes / Tasks / Calendar / Growth / Memory — buttons call action endpoints directly
+- **Session view tabs**: Today / Wishes / Tasks / Calendar / Growth / Memory — buttons call action endpoints directly; shown only in XingYuan-preset sessions by default, switchable to always show/hide and per-tab in Settings
 - **Memory**: important memories injected into context (limit configurable), full CRUD
 - **Charts**: 15 chart types rendered as cards
 - **Safe writes**: write operations confirmed by default (configurable); deletion always confirmed
@@ -42,6 +42,7 @@ Business data lives at `~/.dsh/xingyuan/xingyuan.sqlite` and survives uninstall
 | User profile | Nickname, occupation, interests |
 | Write confirmation | Whether create / check-in writes need confirmation (deletion always does) |
 | Memory injection limit | Max memories injected per turn |
+| Tab visibility | Three modes (follow session / always show / always hide) plus per-tab toggles; defaults to follow session |
 
 ## Development
 

package/README.md

@@ -14,7 +14,8 @@
 - **机会日打卡**：周期任务打卡、补卡、取消、未来预勾，进度跨天恒为最新
 - **微行动拆解**：把无从下手的目标拆成 3–7 个小步，引导式逐个完成或跳过
 - **成长体系**：等级 Lv.1–Lv.10、连击加成、统计卡与近 30 天柱状图
-- **会话视图页**：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆 六个标签页，页面按钮直连动作接口
+- **会话视图页**：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆 六个标签页，页面按钮直连动作接口；
+  默认仅星愿预设的会话显示，可在设置里切换「始终显示 / 始终隐藏」并按标签勾选
 - **记忆**：重要记忆自动注入上下文（上限可配），支持增删改查
 - **图表**：15 种统计图表自动渲染为卡片
 - **安全确认**：写操作默认二次确认（可关闭），删除始终确认
@@ -42,6 +43,7 @@ dsh plugin --profile web add @starwish-ai/xingyuan-dsh
 | 用户画像 | 昵称、职业、兴趣 |
 | 写操作二次确认 | 创建 / 打卡类写操作是否确认（删除始终确认） |
 | 记忆注入上限 | 每次注入上下文的记忆条数上限 |
+| 标签页显示 | 三态模式（跟随会话 / 始终显示 / 始终隐藏）+ 六个标签逐个勾选；默认跟随会话 |
 
 ## 开发
 

package/lib/client/i18n.js

@@ -235,7 +235,16 @@ const ZH_DICT = {
     'settings.pref.memoryLimit': '记忆注入上限',
     'settings.pref.memoryLimitHint': '每次对话自动注入上下文的记忆条数上限（5-200，默认 40）；失焦后保存。',
     'settings.pref.limitInvalid': '请输入 5-200 的整数',
+    'settings.tabs.title': '标签页显示',
+    'settings.tabs.mode.follow': '跟随会话',
+    'settings.tabs.mode.show': '始终显示',
+    'settings.tabs.mode.hide': '始终隐藏',
+    'settings.tabs.chooseTab': '显示的标签页',
+    'settings.tabs.loading': '标签页选项加载中…',
+    'settings.tabs.unavailable': '当前连接不支持持久化设置，标签页显示选项不可用。',
+    'settings.tabs.hint': '跟随会话：仅星愿预设的会话显示标签页；其他会话自动隐藏。可单独勾选/取消各标签。',
     'settings.dataHint': '业务数据存于本机 ~/.dsh/xingyuan/，备份即拷贝该目录。',
+    'today.noPresetHint': '当前会话未启用星愿预设：页面数据可浏览、操作可用，但对话中的星愿能力不可用。',
     // --- 微行动卡 ---
     'micro.cleared': '已清除「{task}」的拆解',
     'micro.finished': '「{task}」微行动完成（可打卡了）',
@@ -532,7 +541,16 @@ const EN_DICT = {
     'settings.pref.memoryLimit': 'Memory injection limit',
     'settings.pref.memoryLimitHint': 'Max memories auto-injected per chat (5-200, default 40); saved on blur.',
     'settings.pref.limitInvalid': 'Enter an integer between 5 and 200',
+    'settings.tabs.title': 'Tab visibility',
+    'settings.tabs.mode.follow': 'Follow session',
+    'settings.tabs.mode.show': 'Always show',
+    'settings.tabs.mode.hide': 'Always hide',
+    'settings.tabs.chooseTab': 'Visible tabs',
+    'settings.tabs.loading': 'Loading tab options…',
+    'settings.tabs.unavailable': 'This connection cannot persist settings; tab visibility options are unavailable.',
+    'settings.tabs.hint': 'Follow session: tabs appear only in sessions using the XingYuan preset; other sessions hide them automatically. Toggle individual tabs below.',
     'settings.dataHint': 'Data lives locally at ~/.dsh/xingyuan/ — back it up by copying the folder.',
+    'today.noPresetHint': 'This session is not using the XingYuan preset: pages stay browsable and usable, but XingYuan chat capabilities are unavailable.',
     'micro.cleared': 'Cleared the micro-step plan of “{task}”',
     'micro.finished': 'Micro-steps of “{task}” finished (ready to check in)',
     'micro.step': '“{task}” micro-steps · step {current}/{total}',

package/lib/client/index.js

@@ -2,7 +2,7 @@ import { t, XY_NS, setupLocale } from './i18n.js';
 import { disposeConfirms, disposeToasts } from './ui.js';
 import { STYLE_TEXT } from './styles.js';
 import { CARD_VIEWS } from './cards.js';
-import { CalendarPage, GrowthPage, MemoryPage, TasksPage, TodayPage, WishesPage } from './pages/index.js';
+import { installTabVisibility } from './tab-visibility.js';
 import { SettingsSection } from './pages/settings.js';
 export const inject = ['slots', 'settingsScope', 'conversationEvents'];
 /** 事件类型 → 渲染 kind。 */
@@ -73,19 +73,16 @@ export function apply(ctx) {
         ctx.slots.register({ name: 'conversation.chat.node', key: 'xy-chart' }, CARD_VIEWS.ChartView),
         ctx.slots.register({ name: 'conversation.chat.node', key: 'xy-micro' }, CARD_VIEWS.MicroView),
     ]);
-    // 会话视图环标签页：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆（仅激活时挂载，进入即取最新数据）。
+    // 会话视图环标签页：今日 / 愿望 / 任务 / 日历 / 成长 / 记忆。
+    // 显隐由 tab-visibility 控制器按「界面偏好设置 × 会话预设」动态维护：
+    // 默认跟随会话（星愿预设的会话才显示），设置可切始终显示/始终隐藏并按标签勾选。
     // label 用 thunk 跟随当前语言；locale 声明让壳在语言切换时刷新标签行。
-    ctx.slots.inject('conversation.view', () => [
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-today', order: 21, label: () => t('tab.today'), locale: XY_NS }, TodayPage),
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-wishes', order: 22, label: () => t('tab.wishes'), locale: XY_NS }, WishesPage),
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-tasks', order: 23, label: () => t('tab.tasks'), locale: XY_NS }, TasksPage),
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-calendar', order: 24, label: () => t('tab.calendar'), locale: XY_NS }, CalendarPage),
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-growth', order: 25, label: () => t('tab.growth'), locale: XY_NS }, GrowthPage),
-        ctx.slots.register({ name: 'conversation.view', id: 'xy-memory', order: 26, label: () => t('tab.memory'), locale: XY_NS }, MemoryPage),
-    ]);
-    // 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限（设置命名空间）
+    ctx.slots.inject('conversation.view', () => installTabVisibility(ctx));
+    // 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限
+    // （preset 命名空间）+ 标签页显隐（bundle 常驻命名空间 xingyuan-ui，未选星愿也可调）
     ctx.slots.inject('settings.section', () => {
         const scope = ctx.settingsScope.bind({ namespace: 'xingyuan' });
-        return ctx.slots.register({ name: 'settings.section', id: 'xingyuan', order: 60, label: () => t('settings.tabLabel'), locale: XY_NS }, () => SettingsSection({ scope }));
+        const uiscope = ctx.settingsScope.bind({ namespace: 'xingyuan-ui' });
+        return ctx.slots.register({ name: 'settings.section', id: 'xingyuan', order: 60, label: () => t('settings.tabLabel'), locale: XY_NS }, () => SettingsSection({ scope, uiscope }));
     });
 }

package/lib/client/pages/growth.js

@@ -12,6 +12,13 @@ const LEVEL_TINTS = ['#475569', '#2563eb', '#047857', '#0e7490', '#0369a1', '#1d
 function levelTint(level) {
     return LEVEL_TINTS[Math.min(LEVEL_TINTS.length, Math.max(1, level)) - 1] ?? LEVEL_TINTS[0];
 }
+/** 按比例调暗 #RRGGBB 色值（等价于 color-mix(in srgb, tint ratio%, #000)）。
+ * 用 JS 预混而非 CSS color-mix()：后者在不支持的浏览器里整条声明失效（AGENTS.md §5.10 兼容铁律）。 */
+export function darkenHex(hex, ratio) {
+    const value = parseInt(hex.slice(1), 16);
+    const channel = (shift) => Math.round(((value >> shift) & 0xff) * ratio);
+    return `#${((1 << 24) | (channel(16) << 16) | (channel(8) << 8) | channel(0)).toString(16).slice(1)}`;
+}
 export function GrowthPage() {
     const t = useXyT();
     const stabilize = useStableScrollbar();
@@ -92,8 +99,9 @@ export function GrowthPage() {
     return createElement('div', { className: 'xy-page', ref: stabilize }, createElement('div', {
         className: 'xy-hero',
         // 实色双档渐变（78% 混黑深档 → 基档）：白色文字对底色对比 ≥4.5:1 在两种壳主题下
-        // 都恒成立；半透明渐变（旧版 tint+d9/tint+73）在浅色壳会混入页面白底，右端跌破 3:1
-        style: { background: `linear-gradient(135deg, color-mix(in srgb, ${tint} 76%, #000), ${tint})` },
+        // 都恒成立；半透明渐变（旧版 tint+d9/tint+73）在浅色壳会混入页面白底，右端跌破 3:1。
+        // 深档用 darkenHex 预混（曾用 color-mix 内联，兼容性见 styles.ts 头注铁律）
+        style: { background: `linear-gradient(135deg, ${darkenHex(tint, 0.76)}, ${tint})` },
     }, createElement('div', { className: 'xy-herobadge', style: { background: tint } }, `Lv.${levelNumber}`), createElement('div', { className: 'xy-heromain' }, createElement('div', { className: 'xy-meta xy-onhero' }, t('growth.levelLabel')), createElement('h2', { className: 'xy-herotitle' }, `Lv.${levelNumber} · ${g.levelName ?? t('growth.levelFallback')}`), createElement('div', { className: 'xy-bar xy-bar-onhero' }, createElement('div', { className: 'xy-bar-fill xy-bar-fill-solid', style: { transform: `scaleX(${Math.min(Math.max(g.levelProgress ?? 0, 0), 100) / 100})` } })), createElement('div', { className: 'xy-meta xy-onhero' }, expText))), g.rewardDescription !== undefined
         ? createElement('div', { className: 'xy-meta xy-heroreward' }, t('growth.rewardPrefix', { reward: g.rewardDescription }))
         : null, createElement('div', { className: 'xy-stats' }, stat(g.totalCheckinDays ?? g.totalCheckins ?? 0, t('growth.stat.checkinDays')), stat(g.currentStreak, t('growth.stat.streak'), 'hot'), stat(g.maxStreak, t('growth.stat.maxStreak')), stat(g.wishTotal, t('growth.stat.wishTotal')), stat(g.wishAchieved, t('growth.stat.wishDone')), stat(g.taskTotal ?? t('growth.stat.none'), t('growth.stat.taskTotal'), g.taskTotal === undefined ? 'muted' : undefined), stat(g.taskAchieved ?? t('growth.stat.none'), t('growth.stat.taskDone'), g.taskAchieved === undefined ? 'muted' : undefined)), createElement('h3', { className: 'xy-section-title' }, t('growth.chart.title')), 

package/lib/client/pages/memory.js

@@ -244,9 +244,9 @@ export function MemoryPage() {
     }), notice !== undefined ? createElement('span', { className: 'xy-saved', role: 'status' }, notice) : null), data.total > allItems.length
         ? createElement('div', { className: 'xy-meta xy-memcap' }, t('memory.capNote', { total: data.total, shown: allItems.length }))
         : null, data.total === 0
-        ? createElement(PageEmpty, { art: 'memory', title: t('memory.empty.title'), hint: t('memory.empty.hint') })
+        ? createElement(PageEmpty, { title: t('memory.empty.title'), hint: t('memory.empty.hint') })
         : filtered.length === 0
-            ? createElement(PageEmpty, { art: 'search', title: t('memory.searchEmpty.title') })
+            ? createElement(PageEmpty, { title: t('memory.searchEmpty.title') })
             : // 列表收进单张分组卡：分隔线行替代逐行描边盒子，长列表不再满屏边框噪音
                 createElement('section', { className: 'xy-group' }, createElement('ul', { className: 'xy-grouplist' }, rows)), hasMore
         ? createElement('div', { className: 'xy-memfoot' }, createElement('button', { className: 'xy-btn', disabled: loadingMore || busy, onClick: loadMore }, loadingMore ? `${t('common.loading')}…` : t('memory.more')), loadError !== undefined ? createElement('span', { className: 'xy-field-err' }, loadError) : null)

package/lib/client/pages/settings.js

@@ -1,10 +1,27 @@
-/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限（设置命名空间）。 */
+/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限
+ * （preset 命名空间）+ 标签页显隐（bundle 常驻命名空间 xingyuan-ui，未选星愿也可调）。 */
 import { createElement, useEffect, useRef, useState, useSyncExternalStore } from 'react';
 import { getJson, postJson } from '../api.js';
 import { toastError } from '../ui.js';
 import { useXyT, activeLocale } from '../i18n.js';
+import { TAB_IDS } from '../../tab-policy.js';
 const COACH_IDS = ['gentle', 'strict', 'humorous'];
 const COACH_KEYS = ['settings.coach.gentle', 'settings.coach.strict', 'settings.coach.humorous'];
+/** 显隐三态（顺序即分段按钮顺序；与 tab-policy 字面量同源）。 */
+const MODE_OPTIONS = [
+    { mode: 'follow', key: 'settings.tabs.mode.follow' },
+    { mode: 'show', key: 'settings.tabs.mode.show' },
+    { mode: 'hide', key: 'settings.tabs.mode.hide' },
+];
+/** 六个标签的显示名键（与 tab-visibility 的 entry labelKey 同源）。 */
+const TAB_LABEL_KEYS = {
+    today: 'tab.today',
+    wishes: 'tab.wishes',
+    tasks: 'tab.tasks',
+    calendar: 'tab.calendar',
+    growth: 'tab.growth',
+    memory: 'tab.memory',
+};
 export function SettingsSection(props) {
     const t = useXyT();
     const scope = props.scope;
@@ -12,6 +29,9 @@ export function SettingsSection(props) {
     const snap = useSyncExternalStore((listener) => scope.subscribe(listener), () => scope.getSnapshot());
     const writable = snap.status === 'ready' && snap.writable;
     const limit = String(snap.value?.memoryInjectLimit ?? 40);
+    // 界面偏好命名空间（标签页显隐）独立订阅：两个命名空间各自走自己的快照
+    const uisnap = useSyncExternalStore((listener) => props.uiscope.subscribe(listener), () => props.uiscope.getSnapshot());
+    const uiWritable = uisnap.status === 'ready' && uisnap.writable;
     // 教练风格与画像存于星愿数据库 global 单例（与对话侧工具同一数据源），经 /xingyuan/api/profile 读写
     const [profile, setProfile] = useState(undefined);
     const [profileError, setProfileError] = useState(undefined);
@@ -25,11 +45,44 @@ export function SettingsSection(props) {
     const [savedMsg, setSavedMsg] = useState('');
     // 二次确认开关：本地乐观值（undefined=跟随远端快照）——写入在途时 UI 立即响应，失败回滚
     const [pendingToggle, setPendingToggle] = useState(undefined);
+    // 标签页显隐：模式与勾选各自乐观（写入在途时禁用对应控件，失败回滚 + toast）
+    const [pendingMode, setPendingMode] = useState(undefined);
+    const [pendingHidden, setPendingHidden] = useState(undefined);
     const savedTimer = useRef(undefined);
     // 档案加载代数守卫：慢响应不得覆盖用户已开始的草稿
     const profileSeqRef = useRef(0);
     // 开关显示值：乐观本地值优先（写入在途），否则跟随远端快照
     const confirmWrites = pendingToggle !== undefined ? pendingToggle : snap.value?.confirmWrites !== false;
+    // 标签页显隐显示值：乐观优先，否则远端快照，再兜底 schema 默认
+    const tabMode = pendingMode ?? uisnap.value?.tabVisibilityMode ?? 'follow';
+    const hiddenTabs = pendingHidden ?? uisnap.value?.hiddenTabs ?? [];
+    /** 切换显隐模式：乐观写，失效即回滚（分段按钮视觉与持久化口径一致）。 */
+    const switchTabMode = (next) => {
+        if (!uiWritable || pendingMode !== undefined || next === tabMode)
+            return;
+        setPendingMode(next);
+        void props.uiscope.set('tabVisibilityMode', next)
+            .then(() => setPendingMode(undefined))
+            .catch((err) => {
+            setPendingMode(undefined);
+            toastError(err);
+        });
+    };
+    /** 勾选单个标签（勾选 = 显示）：成员关系按 TAB_IDS 稳定序重算，写入整体数组。 */
+    const toggleTab = (id, willShow) => {
+        if (!uiWritable || pendingHidden !== undefined || tabMode === 'hide')
+            return;
+        const next = willShow
+            ? TAB_IDS.filter((tid) => tid !== id && hiddenTabs.includes(tid))
+            : TAB_IDS.filter((tid) => tid === id || hiddenTabs.includes(tid));
+        setPendingHidden(next);
+        void props.uiscope.set('hiddenTabs', next)
+            .then(() => setPendingHidden(undefined))
+            .catch((err) => {
+            setPendingHidden(undefined);
+            toastError(err);
+        });
+    };
     const loadProfile = () => {
         const seq = ++profileSeqRef.current;
         setProfileError(undefined);
@@ -182,5 +235,32 @@ export function SettingsSection(props) {
         },
     }), createElement('span', { className: 'xy-hint' }, t('settings.pref.memoryLimitHint')), limitError
         ? createElement('span', { id: 'xy-limit-error', className: 'xy-field-err', role: 'alert' }, t('settings.pref.limitInvalid'))
-        : null)), createElement('p', { className: 'xy-hint' }, t('settings.dataHint')));
+        : null)), 
+    // 标签页显示：模式三态（跟随会话/始终显示/始终隐藏）+ 六个标签勾选 chips。
+    // 与教练风格卡同一 xy-seg 视觉语法；「始终隐藏」时勾选区整组禁用置灰。
+    // 命名空间常驻于 bundle 层（未选星愿预设也可调），见 src/ui-settings.ts 头注。
+    createElement('section', { className: 'xy-panel' }, createElement('h3', { className: 'xy-panel-head' }, t('settings.tabs.title')), uisnap.status === 'unavailable'
+        ? createElement('p', { className: 'xy-hint' }, t('settings.tabs.unavailable'))
+        : uisnap.status === 'loading'
+            ? createElement('p', { className: 'xy-hint' }, t('settings.tabs.loading'))
+            : null, createElement('div', { className: 'xy-seg', role: 'group', 'aria-label': t('settings.tabs.title') }, ...MODE_OPTIONS.map((opt) => createElement('button', {
+        key: opt.mode,
+        className: `xy-seg-btn${tabMode === opt.mode ? ' xy-on' : ''}`,
+        'aria-pressed': tabMode === opt.mode,
+        disabled: !uiWritable || pendingMode !== undefined,
+        onClick: () => switchTabMode(opt.mode),
+    }, t(opt.key)))), createElement('div', {
+        className: 'xy-seg',
+        role: 'group',
+        'aria-label': t('settings.tabs.chooseTab'),
+    }, ...TAB_IDS.map((id) => {
+        const shown = !hiddenTabs.includes(id);
+        return createElement('button', {
+            key: id,
+            className: `xy-seg-btn${shown ? ' xy-on' : ''}`,
+            'aria-pressed': shown,
+            disabled: !uiWritable || pendingHidden !== undefined || tabMode === 'hide',
+            onClick: () => toggleTab(id, !shown),
+        }, t(TAB_LABEL_KEYS[id]));
+    })), createElement('p', { className: 'xy-hint' }, t('settings.tabs.hint'))), createElement('p', { className: 'xy-hint' }, t('settings.dataHint')));
 }

package/lib/client/pages/tasks.js

@@ -65,6 +65,6 @@ export function TasksPage() {
     }, t('action.createTask')))), showCreate
         ? createElement('div', { id: 'xy-tasks-create' }, createElement(TaskQuickForm, { today: data.today, onCreated: () => void page.reload() }))
         : null, data.tasks.length === 0 && !showCreate
-        ? createElement(PageEmpty, { art: 'list', title: t('task.empty.title'), hint: t('task.empty.hint') })
+        ? createElement(PageEmpty, { title: t('task.empty.title'), hint: t('task.empty.hint') })
         : sections.map((section) => createElement('section', { key: section.status, className: 'xy-group' }, createElement('h3', { className: 'xy-group-head' }, createElement('span', { className: `xy-group-dot ${DOT_BY_STATUS[section.status]}`, 'aria-hidden': 'true' }), createElement('span', null, t(section.key)), createElement('span', { className: 'xy-group-count' }, String(section.tasks.length))), createElement('div', { className: 'xy-grouplist' }, section.tasks.map(taskRow)))));
 }

package/lib/client/pages/today.js

@@ -1,14 +1,17 @@
 /** 今日页：今日打卡总览 + 一键打卡/领取 + 已完成撤销。 */
-import { createElement } from 'react';
+import { createElement, useSyncExternalStore } from 'react';
 import { postAction } from '../api.js';
 import { toast } from '../ui.js';
 import { useXyT } from '../i18n.js';
 import { softConfirm, useActionGuard, usePageData, useStableScrollbar, localYmd } from '../hooks.js';
 import { PageEmpty, PageError, PageSkeleton } from '../ui.js';
 import { cycleLabel, dateSuffix, formatFriendlyDate } from './format.js';
+import { todayHintStore } from '../tab-hint.js';
 export function TodayPage() {
     const t = useXyT();
     const stabilize = useStableScrollbar();
+    // 「始终显示 × 非星愿会话」轻提示：控制器写值，本页订阅渲染（默认 false 零开销）
+    const showNoPresetHint = useSyncExternalStore(todayHintStore.subscribe, todayHintStore.getSnapshot);
     const overview = usePageData('/xingyuan/api/overview');
     const day = usePageData(() => `/xingyuan/api/day?date=${localYmd(new Date())}`);
     const { busy, guard } = useActionGuard();
@@ -73,7 +76,9 @@ export function TodayPage() {
             'aria-valuenow': ratio,
             'aria-label': heroTitle,
         }, createElement('div', { className: 'xy-bar-fill', style: { transform: `scaleX(${ratio / 100})` } }))
-        : null, allDone ? createElement('div', { className: 'xy-banner-ok' }, t('today.allDone')) : null), rows.length > 0 ? createElement('section', { className: 'xy-group' }, createElement('h3', { className: 'xy-group-head' }, createElement('span', { className: 'xy-group-dot xy-group-dot-warn', 'aria-hidden': 'true' }), createElement('span', null, t('today.sectionOpen')), createElement('span', { className: 'xy-group-count' }, String(rows.length))), createElement('ul', { className: 'xy-grouplist' }, rows)) : null, doneRows.length > 0 ? createElement('section', { className: 'xy-group' }, createElement('h3', { className: 'xy-group-head' }, createElement('span', { className: 'xy-group-dot xy-group-dot-ok', 'aria-hidden': 'true' }), createElement('span', null, t('today.sectionDone')), createElement('span', { className: 'xy-group-count' }, String(doneRows.length))), createElement('ul', { className: 'xy-grouplist' }, doneRows)) : null, data.total === 0
-        ? createElement(PageEmpty, { art: 'rocket', title: t('today.empty.title'), hint: t('today.empty.hint') })
+        : null, allDone ? createElement('div', { className: 'xy-banner-ok' }, t('today.allDone')) : null), 
+    // 始终显示模式下非星愿会话：概览卡下一行轻提示（页面可浏览/操作，对话能力受限）
+    showNoPresetHint ? createElement('p', { className: 'xy-hint' }, t('today.noPresetHint')) : null, rows.length > 0 ? createElement('section', { className: 'xy-group' }, createElement('h3', { className: 'xy-group-head' }, createElement('span', { className: 'xy-group-dot xy-group-dot-warn', 'aria-hidden': 'true' }), createElement('span', null, t('today.sectionOpen')), createElement('span', { className: 'xy-group-count' }, String(rows.length))), createElement('ul', { className: 'xy-grouplist' }, rows)) : null, doneRows.length > 0 ? createElement('section', { className: 'xy-group' }, createElement('h3', { className: 'xy-group-head' }, createElement('span', { className: 'xy-group-dot xy-group-dot-ok', 'aria-hidden': 'true' }), createElement('span', null, t('today.sectionDone')), createElement('span', { className: 'xy-group-count' }, String(doneRows.length))), createElement('ul', { className: 'xy-grouplist' }, doneRows)) : null, data.total === 0
+        ? createElement(PageEmpty, { title: t('today.empty.title'), hint: t('today.empty.hint') })
         : null);
 }

package/lib/client/pages/wishes.js

@@ -100,7 +100,7 @@ export function WishesPage() {
     showCategories
         ? createElement('div', { id: 'xy-wishes-categories' }, createElement(CategoryManager, { onChanged: () => void page.reload() }))
         : null, active.length === 0 && achieved.length === 0 && !showCreate && !showCategories
-        ? createElement(PageEmpty, { art: 'star', title: t('wish.empty.title'), hint: t('wish.empty.hint') })
+        ? createElement(PageEmpty, { title: t('wish.empty.title'), hint: t('wish.empty.hint') })
         : null, ...active.map(card), achieved.length > 0
         ? createElement('h3', { className: 'xy-section-title' }, t('wish.sectionAchieved'))
         : null, ...achieved.map(card));

package/lib/client/styles.js

@@ -8,6 +8,10 @@
  * - 形状纪律四档圆角：卡片 12 / 内嵌块 9 / 控件 8 / 胶囊 999；
  * - 动效刻度：交互 150ms ease-out，进度条 350ms cubic-bezier(.22,1,.36,1)，
  *   prefers-reduced-motion 下全部关闭。
+ *
+ * 兼容性铁律：**禁用 color-mix() 等新式取色函数**。用户的 dsh 壳里存在不支持
+ * color-mix() 的浏览器，凡用它的属性在该环境下按无效处理（装饰线稿曾因此整体
+ * 隐形）。半透明衍生色一律在下方令牌区按主题写显式 rgba。
  */
 export const STYLE_TEXT = `
 /* ===== 品牌与语义令牌 ===== */
@@ -23,8 +27,16 @@ export const STYLE_TEXT = `
   /* 彩底小圆标的前景对：按主题配对保证 ≥4.5:1（深色亮底配深字） */
   --xyd-on-ok:#ffffff;
   --xyd-on-danger:#ffffff;
-  /* 空态插画线稿色（结构色的弱化档） */
-  --xyd-art-line:color-mix(in srgb, var(--dsw-alias-label-secondary) 72%, transparent);
+  /* 半透明衍生色（禁 color-mix，按主题显式 rgba）：强调描边 / 强调悬停环 /
+     危险描边 / 危险悬停底 / 中性行悬停底 / 斜纹纹理与弱化底 */
+  --xyd-accent-border:rgba(26,111,224,.38);
+  --xyd-accent-ring:rgba(26,111,224,.72);
+  --xyd-accent-ring-soft:rgba(26,111,224,.55);
+  --xyd-danger-border:rgba(192,57,43,.4);
+  --xyd-danger-soft:rgba(192,57,43,.09);
+  --xyd-hover:rgba(15,23,42,.05);
+  --xyd-hatch:rgba(100,116,139,.36);
+  --xyd-hatch-faint:rgba(100,116,139,.14);
   /* 圆角刻度 */
   --xyd-r-card:12px;--xyd-r-inner:9px;--xyd-r-ctl:8px;
 }
@@ -39,6 +51,14 @@ body[data-ds-dark-theme]{
   --xyd-ok:#34d399;
   --xyd-on-ok:#052e21;
   --xyd-on-danger:#3f1008;
+  --xyd-accent-border:rgba(96,165,250,.38);
+  --xyd-accent-ring:rgba(96,165,250,.72);
+  --xyd-accent-ring-soft:rgba(96,165,250,.55);
+  --xyd-danger-border:rgba(255,155,143,.4);
+  --xyd-danger-soft:rgba(255,155,143,.12);
+  --xyd-hover:rgba(148,163,184,.1);
+  --xyd-hatch:rgba(139,152,171,.4);
+  --xyd-hatch-faint:rgba(139,152,171,.16);
 }
 
 .xy-visually-hidden{position:absolute;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}
@@ -124,9 +144,8 @@ body[data-ds-dark-theme] .xy-modal{box-shadow:0 24px 48px -16px rgba(0,0,0,.55),
 .xy-skel-row{height:64px;margin-top:10px}
 @keyframes xy-shimmer{from{background-position:180% 0}to{background-position:-20% 0}}
 
-/* ===== 空态插画 ===== */
+/* ===== 空态（纯文字版式，插画已移除：见 PageEmpty 注释）===== */
 .xy-page-center{display:flex;flex-direction:column;align-items:center;gap:6px;padding:44px 0;text-align:center}
-.xy-art{opacity:.92;margin-bottom:2px}
 .xy-empty-title{font-weight:600;color:var(--dsw-alias-label-primary);margin-top:4px}
 .xy-empty-hint{margin-top:2px;max-width:360px}
 
@@ -154,8 +173,8 @@ body[data-ds-dark-theme] .xy-modal{box-shadow:0 24px 48px -16px rgba(0,0,0,.55),
 .xy-btn-icon{width:26px;height:26px;min-height:26px;padding:0;display:inline-flex;align-items:center;justify-content:center;flex:none}
 .xy-btn-primary{background:var(--xyd-accent);border-color:transparent;color:var(--xyd-on-accent)}
 .xy-btn-primary:hover:not(:disabled){filter:brightness(1.06);color:var(--xyd-on-accent)}
-.xy-btn-danger{color:var(--xyd-danger);border-color:color-mix(in srgb, var(--xyd-danger) 40%, transparent);background:transparent}
-.xy-btn-danger:hover:not(:disabled){background:color-mix(in srgb, var(--xyd-danger) 9%, transparent);color:var(--xyd-danger)}
+.xy-btn-danger{color:var(--xyd-danger);border-color:var(--xyd-danger-border);background:transparent}
+.xy-btn-danger:hover:not(:disabled){background:var(--xyd-danger-soft);color:var(--xyd-danger)}
 .xy-input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);border-radius:var(--xyd-r-ctl);padding:5px 8px;font-size:13px;font-family:inherit;transition:border-color .15s ease}
 .xy-input:hover:not(:disabled){border-color:var(--dsw-alias-border-l3)}
 .xy-input::placeholder{color:var(--dsw-alias-label-secondary)}
@@ -187,7 +206,7 @@ body[data-ds-dark-theme] .xy-modal{box-shadow:0 24px 48px -16px rgba(0,0,0,.55),
 .xy-grouplist{list-style:none;display:flex;flex-direction:column;margin:0;padding:0}
 .xy-grouprow{display:flex;justify-content:space-between;align-items:center;gap:10px;padding:11px 14px;border-top:1px solid var(--dsw-alias-border-l1);transition:background-color .15s ease}
 .xy-grouprow:first-child{border-top:none}
-.xy-grouprow:hover{background:color-mix(in srgb, var(--dsw-alias-bg-layer-2) 42%, transparent)}
+.xy-grouprow:hover{background:var(--xyd-hover)}
 /* 分组卡的块级行变体（任务行 + 可选内联详情）；TaskLine 基类本身即两栏网格（见愿望卡段） */
 .xy-taskrow{display:block}
 .xy-taskrow .xy-detail{margin-bottom:2px}
@@ -274,7 +293,7 @@ body[data-ds-dark-theme] .xy-c3 .xy-daynum{background:rgba(52,211,153,.22);color
 .xy-dot{width:10px;height:10px;border-radius:3px;display:inline-block;margin-right:4px;vertical-align:-1px}
 .xy-dot.xy-dot-checked{background:var(--xyd-accent)}
 /* 图例缺口点：与柱体同一斜纹语法（单一事实源，两处永不漂移） */
-.xy-dot.xy-dot-gap{border:1px solid var(--dsw-alias-border-l2);background:repeating-linear-gradient(135deg,color-mix(in srgb,var(--dsw-alias-label-secondary) 55%,transparent) 0 2px,transparent 2px 4px)}
+.xy-dot.xy-dot-gap{border:1px solid var(--dsw-alias-border-l2);background:repeating-linear-gradient(135deg,var(--xyd-hatch) 0 2px,transparent 2px 4px)}
 /* 图例与圆章同构：无安排=描边空心、待打卡=中性底、部分/全部完成=语义柔和底 */
 .xy-dot.xy-c0{background:transparent;border:1px solid var(--dsw-alias-border-l2)}
 .xy-dot.xy-c1{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2)}
@@ -300,7 +319,7 @@ body[data-ds-dark-theme] .xy-dot.xy-c3{background:rgba(52,211,153,.30)}
 /* 层级：普通统计数字用主文字色（页面更安静），仅「当前连续」这张卡以品牌色+浅晕底突出
  * （habit 类 App 把 streak 作为英雄指标置于热力图旁的惯例） */
 .xy-statnum{font-size:24px;font-weight:700;color:var(--dsw-alias-label-primary);font-variant-numeric:tabular-nums}
-.xy-statcard-hot{border-color:color-mix(in srgb, var(--xyd-accent) 38%, transparent);background:linear-gradient(160deg,var(--xyd-accent-soft),transparent 62%),var(--dsw-alias-bg-layer-1)}
+.xy-statcard-hot{border-color:var(--xyd-accent-border);background:linear-gradient(160deg,var(--xyd-accent-soft),transparent 62%),var(--dsw-alias-bg-layer-1)}
 .xy-statcard-hot .xy-statnum{color:var(--xyd-accent)}
 /* 缺省值（暂无/N/A）：次要色小一号，缺失信息不得比真实数据更响 */
 .xy-statcard-muted .xy-statnum{color:var(--dsw-alias-label-secondary);font-size:18px}
@@ -312,9 +331,9 @@ body[data-ds-dark-theme] .xy-dot.xy-c3{background:rgba(52,211,153,.30)}
 /* 未完成缺口：斜纹冗余编码（跟随主题文字色混合）——layer-2 实色在深色壳与面板底
  * 几乎同亮度而隐形，斜纹在两种主题下都有稳定的纹理可见度，且与实心完成柱形成
  * 「形状 × 颜色」双通道区分，不依赖色觉单通道 */
-.xy-growth-missed{width:100%;border-radius:2px 2px 0 0;background:repeating-linear-gradient(135deg,color-mix(in srgb,var(--dsw-alias-label-secondary) 55%,transparent) 0 2px,transparent 2px 5px),color-mix(in srgb,var(--dsw-alias-label-secondary) 14%,transparent)}
+.xy-growth-missed{width:100%;border-radius:2px 2px 0 0;background:repeating-linear-gradient(135deg,var(--xyd-hatch) 0 2px,transparent 2px 5px),var(--xyd-hatch-faint)}
 button.xy-growth-col{cursor:pointer}
-button.xy-growth-col:hover,button.xy-growth-col.xy-hover{box-shadow:inset 0 0 0 2px color-mix(in srgb, var(--xyd-accent) 72%, transparent)}
+button.xy-growth-col:hover,button.xy-growth-col.xy-hover{box-shadow:inset 0 0 0 2px var(--xyd-accent-ring)}
 /* 基线贴柱底（与聊天图表卡的 SVG 基线同一语法），刻度层下移让出线的位置 */
 .xy-growth-axis{position:relative;height:20px;margin-top:0;border-top:1px solid var(--dsw-alias-border-l2)}
 .xy-growth-tick{position:absolute;top:4px;font-size:11px;line-height:16px;color:var(--dsw-alias-label-secondary);white-space:nowrap;font-variant-numeric:tabular-nums}
@@ -325,7 +344,7 @@ button.xy-growth-col:hover,button.xy-growth-col.xy-hover{box-shadow:inset 0 0 0
 .xy-chartload{height:150px;margin-top:8px}
 
 /* ===== 成长页：等级英雄卡 + 等级说明 ===== */
-/* 渐变两端均为实色（深档→基档，见 growth.ts 的 color-mix 内联），白字对底色 ≥4.5:1
+/* 渐变两端均为实色（深档→基档，growth.ts 内联 darkenHex 预混），白字对底色 ≥4.5:1
  * 在浅色壳下同样成立——半透明渐变混入页面白底后右端会跌破 3:1，已弃用。 */
 .xy-hero{display:flex;gap:14px;align-items:center;border-radius:var(--xyd-r-card);padding:18px;margin-top:12px;border:1px solid rgba(255,255,255,.16);box-shadow:0 2px 10px rgba(30,25,60,.16)}
 .xy-herobadge{width:54px;height:54px;border-radius:14px;display:flex;align-items:center;justify-content:center;color:#fff;font-weight:800;font-size:16px;flex:none;text-shadow:0 1px 2px rgba(0,0,0,.18)}
@@ -415,7 +434,7 @@ body[data-ds-dark-theme] .xy-dot.xy-dcell-checked{background:rgba(46,160,105,.45
 .xy-swatchrow{display:flex;flex-wrap:wrap;gap:8px;margin-top:8px;align-items:center}
 /* 色板格：24px 命中目标 + hover 描边 + 主题令牌描边（深色下不再隐身） */
 .xy-swatch{width:24px;height:24px;border-radius:8px;border:1px solid var(--dsw-alias-border-l2);cursor:pointer;padding:0;position:relative;transition:box-shadow .15s ease}
-.xy-swatch:hover{box-shadow:inset 0 0 0 2px color-mix(in srgb, var(--xyd-accent) 55%, transparent)}
+.xy-swatch:hover{box-shadow:inset 0 0 0 2px var(--xyd-accent-ring-soft)}
 /* 选中态双环（内白隙 + 外强调圈）：任何色相下都清晰可辨，不依赖对勾本身的对冲 */
 .xy-swatch.xy-picked{box-shadow:inset 0 0 0 2px rgba(255,255,255,.85),0 0 0 2px var(--xyd-accent)}
 .xy-swatch.xy-picked::after{content:'✓';position:absolute;inset:0;display:flex;align-items:center;justify-content:center;color:#fff;font-size:12px;font-weight:700;text-shadow:0 0 2px rgba(0,0,0,.85),0 1px 3px rgba(0,0,0,.6)}

package/lib/client/tab-hint.js

@@ -0,0 +1,38 @@
+/**
+ * 「今日」页非星愿会话提示行的快照 store。
+ *
+ * 语义：仅「始终显示」模式 × 当前会话非星愿预设时为 true（该模式下标签页
+ * 出现在每个会话里，页面数据与操作可用，但对话中的星愿能力不可用——一行
+ * 轻提示点明落差）。跟随会话模式下非星愿会话标签页整体隐藏，无提示可言。
+ *
+ * 独立成模块：tab-visibility 控制器写入、今日页订阅，避免控制器 ↔ 页面
+ * 双向依赖环；写侧只在值变化时通知，订阅侧 useSyncExternalStore 直接消费。
+ */
+let hintVisible = false;
+const listeners = new Set();
+function publish(value) {
+    if (value === hintVisible)
+        return;
+    hintVisible = value;
+    for (const fn of [...listeners])
+        fn();
+}
+/** 今日页只读入口（getSnapshot/subscribe 满足 useSyncExternalStore 契约）。 */
+export const todayHintStore = {
+    getSnapshot: () => hintVisible,
+    subscribe(fn) {
+        listeners.add(fn);
+        return () => {
+            listeners.delete(fn);
+        };
+    },
+};
+/** 控制器在每次显隐重算后写入；值未变化时零通知。 */
+export function setTodayHint(value) {
+    publish(value);
+}
+/** 控制器卸载时清场（值复位 + 断订；今日页随模块重载自动取新模块实例）。 */
+export function clearTodayHint() {
+    listeners.clear();
+    hintVisible = false;
+}

package/lib/client/tab-visibility.js

@@ -0,0 +1,58 @@
+import { XY_NS, t } from './i18n.js';
+import { TAB_IDS, TAB_VISIBILITY_DEFAULTS, visibleTabIds } from '../tab-policy.js';
+import { CalendarPage, GrowthPage, MemoryPage, TasksPage, TodayPage, WishesPage } from './pages/index.js';
+import { clearTodayHint, setTodayHint } from './tab-hint.js';
+const noopUnsubscribe = () => { };
+const TAB_ENTRIES = [
+    { tabId: 'today', id: 'xy-today', order: 21, labelKey: 'tab.today', component: TodayPage },
+    { tabId: 'wishes', id: 'xy-wishes', order: 22, labelKey: 'tab.wishes', component: WishesPage },
+    { tabId: 'tasks', id: 'xy-tasks', order: 23, labelKey: 'tab.tasks', component: TasksPage },
+    { tabId: 'calendar', id: 'xy-calendar', order: 24, labelKey: 'tab.calendar', component: CalendarPage },
+    { tabId: 'growth', id: 'xy-growth', order: 25, labelKey: 'tab.growth', component: GrowthPage },
+    { tabId: 'memory', id: 'xy-memory', order: 26, labelKey: 'tab.memory', component: MemoryPage },
+];
+/**
+ * 安装标签页显隐控制器，返回随 conversation.view 声明生命周期卸载的 disposer。
+ * 必须在 slots.inject('conversation.view') 回调内调用：保证首次 sync() 时
+ * 槽已声明（未声明时 register 不落账），注册/注销全走壳的 effect 语义。
+ */
+export function installTabVisibility(ctx) {
+    const sessions = ctx.get('sessions');
+    const scope = ctx.settingsScope.bind({ namespace: 'xingyuan-ui' });
+    let disposers = [];
+    let stopped = false;
+    const sync = () => {
+        if (stopped)
+            return;
+        for (const dispose of disposers)
+            dispose();
+        disposers = [];
+        const snap = scope.getSnapshot();
+        const value = snap.value;
+        const mode = value?.tabVisibilityMode ?? TAB_VISIBILITY_DEFAULTS.tabVisibilityMode;
+        const hidden = value?.hiddenTabs ?? TAB_VISIBILITY_DEFAULTS.hiddenTabs;
+        const list = sessions?.list?.getSnapshot();
+        const row = list?.current !== undefined ? list.byId[list.current] : undefined;
+        const isXingyuan = row?.agentPreset === 'xingyuan';
+        // 「始终显示 × 非星愿会话」的今日页轻提示（Q4=b 结论），其余模式不提示
+        setTodayHint(mode === 'show' && !isXingyuan);
+        const visible = new Set(visibleTabIds(mode, hidden, isXingyuan));
+        for (const entry of TAB_ENTRIES) {
+            if (!visible.has(entry.tabId))
+                continue;
+            disposers.push(ctx.slots.register({ name: 'conversation.view', id: entry.id, order: entry.order, label: () => t(entry.labelKey), locale: XY_NS }, entry.component));
+        }
+    };
+    const unsubscribeScope = scope.subscribe(sync);
+    const unsubscribeSessions = sessions?.list?.subscribe(sync) ?? noopUnsubscribe;
+    sync();
+    return () => {
+        stopped = true;
+        clearTodayHint();
+        unsubscribeSessions();
+        unsubscribeScope();
+        for (const dispose of disposers)
+            dispose();
+        disposers = [];
+    };
+}