@starwish-ai/xingyuan-dsh 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -5,6 +5,34 @@ 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

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/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/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
+        : 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/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 = [];
+    };
+}

package/lib/client.js

@@ -231,7 +231,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}」微行动完成（可打卡了）",
 	"micro.step": "「{task}」拆解执行 · 第 {current}/{total} 步",
@@ -518,7 +527,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}",
@@ -1973,12 +1991,88 @@ const CARD_VIEWS = {
 	MicroView
 };
 
+//#endregion
+//#region src/tab-policy.ts
+/**
+* 会话视图标签页显隐策略（host/client 两半侧共用 + 测试对拍）的纯函数与常量。
+*
+* 决策口径（设计评审结论）：
+* - mode=follow（默认）：仅当前会话 agentPreset === 'xingyuan' 时显示标签页；
+* - mode=show：所有会话都显示；mode=hide：任何会话都不显示；
+* - hiddenTabs：在「显示」前提下被勾掉的单个标签（默认空数组 = 六个全显示）。
+* 未知/重复的 hiddenTabs 值一律容错忽略（settings.yaml 手改脏值不炸）。
+*/
+/** 六个会话视图标签的稳定业务名（与 slot entry id 的 xy- 前缀解耦，settings.yaml 可读）。 */
+const TAB_IDS = [
+	"today",
+	"wishes",
+	"tasks",
+	"calendar",
+	"growth",
+	"memory"
+];
+/** 命名空间缺省（与 xingyuan-ui schema 默认值同源，见 src/ui-settings.ts）。 */
+const TAB_VISIBILITY_DEFAULTS = {
+	tabVisibilityMode: "follow",
+	hiddenTabs: []
+};
+/**
+* 计算当前应注册的标签集合。唯一事实口径：client 注册控制器、设置页回显、
+* 单元测试三方共用，任何一侧不得另写一份判定。
+*/
+function visibleTabIds(mode, hiddenTabs, isXingyuanSession) {
+	if (mode === "hide") return [];
+	if (mode === "follow" && !isXingyuanSession) return [];
+	const hidden = new Set(hiddenTabs);
+	return TAB_IDS.filter((id) => !hidden.has(id));
+}
+
+//#endregion
+//#region src/client/tab-hint.ts
+/**
+* 「今日」页非星愿会话提示行的快照 store。
+*
+* 语义：仅「始终显示」模式 × 当前会话非星愿预设时为 true（该模式下标签页
+* 出现在每个会话里，页面数据与操作可用，但对话中的星愿能力不可用——一行
+* 轻提示点明落差）。跟随会话模式下非星愿会话标签页整体隐藏，无提示可言。
+*
+* 独立成模块：tab-visibility 控制器写入、今日页订阅，避免控制器 ↔ 页面
+* 双向依赖环；写侧只在值变化时通知，订阅侧 useSyncExternalStore 直接消费。
+*/
+let hintVisible = false;
+const listeners = /* @__PURE__ */ new Set();
+function publish(value) {
+	if (value === hintVisible) return;
+	hintVisible = value;
+	for (const fn of [...listeners]) fn();
+}
+/** 今日页只读入口（getSnapshot/subscribe 满足 useSyncExternalStore 契约）。 */
+const todayHintStore = {
+	getSnapshot: () => hintVisible,
+	subscribe(fn) {
+		listeners.add(fn);
+		return () => {
+			listeners.delete(fn);
+		};
+	}
+};
+/** 控制器在每次显隐重算后写入；值未变化时零通知。 */
+function setTodayHint(value) {
+	publish(value);
+}
+/** 控制器卸载时清场（值复位 + 断订；今日页随模块重载自动取新模块实例）。 */
+function clearTodayHint() {
+	listeners.clear();
+	hintVisible = false;
+}
+
 //#endregion
 //#region src/client/pages/today.ts
 /** 今日页：今日打卡总览 + 一键打卡/领取 + 已完成撤销。 */
 function TodayPage() {
 	const t = useXyT();
 	const stabilize = useStableScrollbar();
+	const showNoPresetHint = (0, react.useSyncExternalStore)(todayHintStore.subscribe, todayHintStore.getSnapshot);
 	const overview = usePageData("/xingyuan/api/overview");
 	const day = usePageData(() => `/xingyuan/api/day?date=${localYmd(/* @__PURE__ */ new Date())}`);
 	const { busy, guard } = useActionGuard();
@@ -2052,7 +2146,7 @@ function TodayPage() {
 	}, (0, react.createElement)("div", {
 		className: "xy-bar-fill",
 		style: { transform: `scaleX(${ratio / 100})` }
-	})) : null, allDone ? (0, react.createElement)("div", { className: "xy-banner-ok" }, t("today.allDone")) : null), rows.length > 0 ? (0, react.createElement)("section", { className: "xy-group" }, (0, react.createElement)("h3", { className: "xy-group-head" }, (0, react.createElement)("span", {
+	})) : null, allDone ? (0, react.createElement)("div", { className: "xy-banner-ok" }, t("today.allDone")) : null), showNoPresetHint ? (0, react.createElement)("p", { className: "xy-hint" }, t("today.noPresetHint")) : null, rows.length > 0 ? (0, react.createElement)("section", { className: "xy-group" }, (0, react.createElement)("h3", { className: "xy-group-head" }, (0, react.createElement)("span", {
 		className: "xy-group-dot xy-group-dot-warn",
 		"aria-hidden": "true"
 	}), (0, react.createElement)("span", null, t("today.sectionOpen")), (0, react.createElement)("span", { className: "xy-group-count" }, String(rows.length))), (0, react.createElement)("ul", { className: "xy-grouplist" }, rows)) : null, doneRows.length > 0 ? (0, react.createElement)("section", { className: "xy-group" }, (0, react.createElement)("h3", { className: "xy-group-head" }, (0, react.createElement)("span", {
@@ -3580,9 +3674,102 @@ function MemoryPage() {
 	}, t("memory.clearAll")), (0, react.createElement)("span", { className: "xy-meta" }, t("memory.footNote"))) : null);
 }
 
+//#endregion
+//#region src/client/tab-visibility.ts
+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 语义。
+*/
+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 value = scope.getSnapshot().value;
+		const mode = value?.tabVisibilityMode ?? TAB_VISIBILITY_DEFAULTS.tabVisibilityMode;
+		const hidden = value?.hiddenTabs ?? TAB_VISIBILITY_DEFAULTS.hiddenTabs;
+		const list = sessions?.list?.getSnapshot();
+		const isXingyuan = (list?.current !== void 0 ? list.byId[list.current] : void 0)?.agentPreset === "xingyuan";
+		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 = [];
+	};
+}
+
 //#endregion
 //#region src/client/pages/settings.ts
-/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限（设置命名空间）。 */
+/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限
+* （preset 命名空间）+ 标签页显隐（bundle 常驻命名空间 xingyuan-ui，未选星愿也可调）。 */
 const COACH_IDS = [
 	"gentle",
 	"strict",
@@ -3593,12 +3780,38 @@ const COACH_KEYS = [
 	"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"
+};
 function SettingsSection(props) {
 	const t = useXyT();
 	const scope = props.scope;
 	const snap = (0, react.useSyncExternalStore)((listener) => scope.subscribe(listener), () => scope.getSnapshot());
 	const writable = snap.status === "ready" && snap.writable;
 	const limit = String(snap.value?.memoryInjectLimit ?? 40);
+	const uisnap = (0, react.useSyncExternalStore)((listener) => props.uiscope.subscribe(listener), () => props.uiscope.getSnapshot());
+	const uiWritable = uisnap.status === "ready" && uisnap.writable;
 	const [profile, setProfile] = (0, react.useState)(void 0);
 	const [profileError, setProfileError] = (0, react.useState)(void 0);
 	const [nicknameDraft, setNicknameDraft] = (0, react.useState)("");
@@ -3609,9 +3822,32 @@ function SettingsSection(props) {
 	const [saving, setSaving] = (0, react.useState)(false);
 	const [savedMsg, setSavedMsg] = (0, react.useState)("");
 	const [pendingToggle, setPendingToggle] = (0, react.useState)(void 0);
+	const [pendingMode, setPendingMode] = (0, react.useState)(void 0);
+	const [pendingHidden, setPendingHidden] = (0, react.useState)(void 0);
 	const savedTimer = (0, react.useRef)(void 0);
 	const profileSeqRef = (0, react.useRef)(0);
 	const confirmWrites = pendingToggle !== void 0 ? pendingToggle : snap.value?.confirmWrites !== false;
+	const tabMode = pendingMode ?? uisnap.value?.tabVisibilityMode ?? "follow";
+	const hiddenTabs = pendingHidden ?? uisnap.value?.hiddenTabs ?? [];
+	/** 切换显隐模式：乐观写，失效即回滚（分段按钮视觉与持久化口径一致）。 */
+	const switchTabMode = (next) => {
+		if (!uiWritable || pendingMode !== void 0 || next === tabMode) return;
+		setPendingMode(next);
+		props.uiscope.set("tabVisibilityMode", next).then(() => setPendingMode(void 0)).catch((err) => {
+			setPendingMode(void 0);
+			toastError(err);
+		});
+	};
+	/** 勾选单个标签（勾选 = 显示）：成员关系按 TAB_IDS 稳定序重算，写入整体数组。 */
+	const toggleTab = (id, willShow) => {
+		if (!uiWritable || pendingHidden !== void 0 || 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);
+		props.uiscope.set("hiddenTabs", next).then(() => setPendingHidden(void 0)).catch((err) => {
+			setPendingHidden(void 0);
+			toastError(err);
+		});
+	};
 	const loadProfile = () => {
 		const seq = ++profileSeqRef.current;
 		setProfileError(void 0);
@@ -3769,7 +4005,30 @@ function SettingsSection(props) {
 		id: "xy-limit-error",
 		className: "xy-field-err",
 		role: "alert"
-	}, t("settings.pref.limitInvalid")) : null)), (0, react.createElement)("p", { className: "xy-hint" }, t("settings.dataHint")));
+	}, t("settings.pref.limitInvalid")) : null)), (0, react.createElement)("section", { className: "xy-panel" }, (0, react.createElement)("h3", { className: "xy-panel-head" }, t("settings.tabs.title")), uisnap.status === "unavailable" ? (0, react.createElement)("p", { className: "xy-hint" }, t("settings.tabs.unavailable")) : uisnap.status === "loading" ? (0, react.createElement)("p", { className: "xy-hint" }, t("settings.tabs.loading")) : null, (0, react.createElement)("div", {
+		className: "xy-seg",
+		role: "group",
+		"aria-label": t("settings.tabs.title")
+	}, ...MODE_OPTIONS.map((opt) => (0, react.createElement)("button", {
+		key: opt.mode,
+		className: `xy-seg-btn${tabMode === opt.mode ? " xy-on" : ""}`,
+		"aria-pressed": tabMode === opt.mode,
+		disabled: !uiWritable || pendingMode !== void 0,
+		onClick: () => switchTabMode(opt.mode)
+	}, t(opt.key)))), (0, react.createElement)("div", {
+		className: "xy-seg",
+		role: "group",
+		"aria-label": t("settings.tabs.chooseTab")
+	}, ...TAB_IDS.map((id) => {
+		const shown = !hiddenTabs.includes(id);
+		return (0, react.createElement)("button", {
+			key: id,
+			className: `xy-seg-btn${shown ? " xy-on" : ""}`,
+			"aria-pressed": shown,
+			disabled: !uiWritable || pendingHidden !== void 0 || tabMode === "hide",
+			onClick: () => toggleTab(id, !shown)
+		}, t(TAB_LABEL_KEYS[id]));
+	})), (0, react.createElement)("p", { className: "xy-hint" }, t("settings.tabs.hint"))), (0, react.createElement)("p", { className: "xy-hint" }, t("settings.dataHint")));
 }
 
 //#endregion
@@ -3858,59 +4117,20 @@ function apply(ctx) {
 			key: "xy-micro"
 		}, CARD_VIEWS.MicroView)
 	]);
-	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));
 	ctx.slots.inject("settings.section", () => {
 		const scope = ctx.settingsScope.bind({ namespace: "xingyuan" });
+		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 }));
+		}, () => SettingsSection({
+			scope,
+			uiscope
+		}));
 	});
 }
 

package/lib/index.js

@@ -3,6 +3,7 @@ import { makeXingyuanStore, xingyuanDomainSpec } from './domain.js';
 import { registerXingyuanRoutes } from './routes/index.js';
 import { ensurePresetRoot } from './preset-root.js';
 import { repairSessionLogs } from './session-log-repair.js';
+import { installUiSettings } from './ui-settings.js';
 export { xingyuanDomainSpec, DOMAIN_VERSION, COACH_STYLES } from './domain.js';
 /** Cordis 插件名。 */
 export const name = 'xingyuan';
@@ -25,6 +26,8 @@ export async function apply(ctx, config) {
         if (domain)
             await domain.close();
     });
+    // 界面偏好命名空间（标签页显隐）常驻注册：不依赖 settings 服务存在，服务挂载后自动生效
+    installUiSettings(ctx);
     // preset 发布成功后再开领域；两步就绪后才 provide，注入方（preset 子树）由
     // cordis inject 语义等待本行激活完成
     await ensurePresetRoot();

package/lib/tab-policy.js

@@ -0,0 +1,28 @@
+/**
+ * 会话视图标签页显隐策略（host/client 两半侧共用 + 测试对拍）的纯函数与常量。
+ *
+ * 决策口径（设计评审结论）：
+ * - mode=follow（默认）：仅当前会话 agentPreset === 'xingyuan' 时显示标签页；
+ * - mode=show：所有会话都显示；mode=hide：任何会话都不显示；
+ * - hiddenTabs：在「显示」前提下被勾掉的单个标签（默认空数组 = 六个全显示）。
+ * 未知/重复的 hiddenTabs 值一律容错忽略（settings.yaml 手改脏值不炸）。
+ */
+/** 六个会话视图标签的稳定业务名（与 slot entry id 的 xy- 前缀解耦，settings.yaml 可读）。 */
+export const TAB_IDS = ['today', 'wishes', 'tasks', 'calendar', 'growth', 'memory'];
+/** 命名空间缺省（与 xingyuan-ui schema 默认值同源，见 src/ui-settings.ts）。 */
+export const TAB_VISIBILITY_DEFAULTS = {
+    tabVisibilityMode: 'follow',
+    hiddenTabs: [],
+};
+/**
+ * 计算当前应注册的标签集合。唯一事实口径：client 注册控制器、设置页回显、
+ * 单元测试三方共用，任何一侧不得另写一份判定。
+ */
+export function visibleTabIds(mode, hiddenTabs, isXingyuanSession) {
+    if (mode === 'hide')
+        return [];
+    if (mode === 'follow' && !isXingyuanSession)
+        return [];
+    const hidden = new Set(hiddenTabs);
+    return TAB_IDS.filter((id) => !hidden.has(id));
+}

package/lib/types/client/i18n.d.ts

@@ -208,7 +208,16 @@ declare const ZH_DICT: {
     readonly 'settings.pref.memoryLimit': "记忆注入上限";
     readonly 'settings.pref.memoryLimitHint': "每次对话自动注入上下文的记忆条数上限（5-200，默认 40）；失焦后保存。";
     readonly 'settings.pref.limitInvalid': "请输入 5-200 的整数";
+    readonly 'settings.tabs.title': "标签页显示";
+    readonly 'settings.tabs.mode.follow': "跟随会话";
+    readonly 'settings.tabs.mode.show': "始终显示";
+    readonly 'settings.tabs.mode.hide': "始终隐藏";
+    readonly 'settings.tabs.chooseTab': "显示的标签页";
+    readonly 'settings.tabs.loading': "标签页选项加载中…";
+    readonly 'settings.tabs.unavailable': "当前连接不支持持久化设置，标签页显示选项不可用。";
+    readonly 'settings.tabs.hint': "跟随会话：仅星愿预设的会话显示标签页；其他会话自动隐藏。可单独勾选/取消各标签。";
     readonly 'settings.dataHint': "业务数据存于本机 ~/.dsh/xingyuan/，备份即拷贝该目录。";
+    readonly 'today.noPresetHint': "当前会话未启用星愿预设：页面数据可浏览、操作可用，但对话中的星愿能力不可用。";
     readonly 'micro.cleared': "已清除「{task}」的拆解";
     readonly 'micro.finished': "「{task}」微行动完成（可打卡了）";
     readonly 'micro.step': "「{task}」拆解执行 · 第 {current}/{total} 步";

package/lib/types/client/pages/settings.d.ts

@@ -1,5 +1,7 @@
-/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限（设置命名空间）。 */
+/** 星愿设置整页（设置 → 星愿）：教练风格/画像（星愿库）+ 二次确认开关与注入上限
+ * （preset 命名空间）+ 标签页显隐（bundle 常驻命名空间 xingyuan-ui，未选星愿也可调）。 */
 import { type ReactElement } from 'react';
+import { type TabId, type TabVisibilityMode } from '../../tab-policy.js';
 /** 与 dsh-client-runtime 的 SettingsScope 快照对齐的叶子视图（只读字段）。 */
 interface ScopeSnapshotLike {
     readonly status: 'loading' | 'ready' | 'unavailable';
@@ -9,6 +11,22 @@ interface ScopeSnapshotLike {
     };
     readonly writable: boolean;
 }
+/** xingyuan-ui 命名空间快照（标签页显隐字段）。 */
+interface UiScopeSnapshotLike {
+    readonly status: 'loading' | 'ready' | 'unavailable';
+    readonly value?: {
+        readonly tabVisibilityMode?: TabVisibilityMode;
+        readonly hiddenTabs?: readonly TabId[];
+    };
+    readonly writable: boolean;
+}
+/** xingyuan-ui 命名空间的 scope 形状（bind 返回结构，见 dsh-client-runtime contract/settings-scope）。 */
+export interface UiScopeLike {
+    getSnapshot(): UiScopeSnapshotLike;
+    subscribe(listener: () => void): () => void;
+    set(field: string, value: unknown): Promise<void>;
+    unset(field: string): Promise<void>;
+}
 /**
  * settingsScope.bind() 返回的真实形状：getSnapshot()/subscribe()/set()/unset()。
  * 注意 scope 本身没有 .value 字段——值在快照里（此前直接读 scope.value 导致整节渲染崩溃）。
@@ -21,5 +39,6 @@ export interface SettingsScopeLike {
 }
 export declare function SettingsSection(props: {
     scope: SettingsScopeLike;
+    uiscope: UiScopeLike;
 }): ReactElement;
 export {};

package/lib/types/client/tab-hint.d.ts

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

package/lib/types/client/tab-visibility.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 会话视图标签页显隐控制器（client 半侧）。
+ *
+ * 机制：conversation.view 标签环把「全部已注册 entries」投影为标签（无
+ * per-session 过滤），因此按会话预设自动显隐只能动态维护注册表——本控制器
+ * 订阅「界面偏好设置快照 × 会话列表」，每次任一输入变化时 dispose 旧组、
+ * 按 src/tab-policy.ts 纯策略 register 应显示的组（标签环对槽版本号订阅，
+ * 重投影即刷新）。切换瞬间至多一帧旧标签，壳的 resolveActiveView 对已注销
+ * 的活跃视图回落 Chat（官方契约），不会渲染空白。
+ *
+ * 判据：settingsScope('xingyuan-ui').tabVisibilityMode × hiddenTabs ×
+ * 当前（staged）会话 SessionSummary.agentPreset === 'xingyuan'。
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+/**
+ * 安装标签页显隐控制器，返回随 conversation.view 声明生命周期卸载的 disposer。
+ * 必须在 slots.inject('conversation.view') 回调内调用：保证首次 sync() 时
+ * 槽已声明（未声明时 register 不落账），注册/注销全走壳的 effect 语义。
+ */
+export declare function installTabVisibility(ctx: ClientContext): () => void;

package/lib/types/tab-policy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 会话视图标签页显隐策略（host/client 两半侧共用 + 测试对拍）的纯函数与常量。
+ *
+ * 决策口径（设计评审结论）：
+ * - mode=follow（默认）：仅当前会话 agentPreset === 'xingyuan' 时显示标签页；
+ * - mode=show：所有会话都显示；mode=hide：任何会话都不显示；
+ * - hiddenTabs：在「显示」前提下被勾掉的单个标签（默认空数组 = 六个全显示）。
+ * 未知/重复的 hiddenTabs 值一律容错忽略（settings.yaml 手改脏值不炸）。
+ */
+/** 六个会话视图标签的稳定业务名（与 slot entry id 的 xy- 前缀解耦，settings.yaml 可读）。 */
+export declare const TAB_IDS: readonly ["today", "wishes", "tasks", "calendar", "growth", "memory"];
+export type TabId = (typeof TAB_IDS)[number];
+/** 显隐模式：跟随会话 / 始终显示 / 始终隐藏。 */
+export type TabVisibilityMode = 'follow' | 'show' | 'hide';
+/** 命名空间缺省（与 xingyuan-ui schema 默认值同源，见 src/ui-settings.ts）。 */
+export declare const TAB_VISIBILITY_DEFAULTS: {
+    tabVisibilityMode: TabVisibilityMode;
+    hiddenTabs: TabId[];
+};
+/**
+ * 计算当前应注册的标签集合。唯一事实口径：client 注册控制器、设置页回显、
+ * 单元测试三方共用，任何一侧不得另写一份判定。
+ */
+export declare function visibleTabIds(mode: TabVisibilityMode, hiddenTabs: readonly TabId[], isXingyuanSession: boolean): readonly TabId[];

package/lib/types/ui-settings.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 星愿 bundle 层「界面偏好」设置命名空间（xingyuan-ui）：
+ * 会话视图标签页显隐（跟随会话/始终显示/始终隐藏 + 单标签勾选）。
+ *
+ * 挂在 bundle 常驻层而非 preset 层的理由（设计评审结论）：
+ * preset 层命名空间（xingyuan）随星愿会话挂载/卸载而存在/消失——用户处于
+ * 「全部隐藏」状态想找回标签时，恰恰可能没有任何星愿会话在跑，开关不可达。
+ * bundle 层命名空间常驻：未选过星愿预设也能调整，且与 dsh host-backed
+ * settings 惯例一致（跟随 $DSH_HOME/settings.yaml 跨 Web 端口）。
+ *
+ * installSettingsSection 经 ctx.inject(['settings']) 等待 settings 服务挂载，
+ * 服务缺席（headless 等）时整段不运行，bundle 激活不依赖它。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type TabId, type TabVisibilityMode } from './tab-policy.js';
+/** 界面偏好命名空间（client 半侧 settingsScope 同名配对，勿改）。 */
+export declare const UI_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** 命名空间解析值（schema 默认 → base 层 → 用户层）。 */
+export interface UiSettings {
+    tabVisibilityMode: TabVisibilityMode;
+    hiddenTabs: TabId[];
+}
+/** 配置 schema（默认值写进 schema；schemastery 无 z.enum，枚举用 const+union）。 */
+export declare const UiSettingsSchema: z<UiSettings>;
+/** bundle 层安装界面偏好命名空间（幂等：注册随插件 fiber 生命周期自动清理）。 */
+export declare function installUiSettings(ctx: Context): void;

package/lib/ui-settings.js

@@ -0,0 +1,22 @@
+import z from '@deepseek-ai/schemastery';
+import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings';
+import { TAB_IDS, TAB_VISIBILITY_DEFAULTS } from './tab-policy.js';
+/** 界面偏好命名空间（client 半侧 settingsScope 同名配对，勿改）。 */
+export const UI_NS = settingsNamespace('xingyuan-ui');
+/** 配置 schema（默认值写进 schema；schemastery 无 z.enum，枚举用 const+union）。 */
+export const UiSettingsSchema = z.object({
+    tabVisibilityMode: z.union([
+        z.const('follow'),
+        z.const('show'),
+        z.const('hide'),
+    ]).default(TAB_VISIBILITY_DEFAULTS.tabVisibilityMode),
+    hiddenTabs: z.array(z.union(TAB_IDS.map((id) => z.const(id)))).default([]),
+});
+/** bundle 层安装界面偏好命名空间（幂等：注册随插件 fiber 生命周期自动清理）。 */
+export function installUiSettings(ctx) {
+    installSettingsSection(ctx, UI_NS, UiSettingsSchema, TAB_VISIBILITY_DEFAULTS, {
+        // 本命名空间只有 client 半侧消费（经 wire 读快照），host 侧无派生事实
+        setSource: () => { },
+        onChange: () => { },
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starwish-ai/xingyuan-dsh",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "星愿 XingYuan for DeepSeek Harness: 对话创建愿望/任务、机会日打卡、微行动、记忆与图表的 Agent Preset 组合包",
   "type": "module",
   "license": "MIT",
@@ -95,6 +95,7 @@
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-host-webserver": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-session": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-storage": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-storage-domain": "^0.1.1-rc.2",
     "@deepseek-ai/dsh-system-prompt": "^0.1.1-rc.2",