dsh-theme-gallery 0.5.0 → 0.6.0

package/README.md

@@ -11,7 +11,7 @@
 | 自己做皮肤（或让 AI 做） | 在 `lib/themes/` 加 JSON 后重跑 `npm run embed-themes`，或装 `dsh-theme-skin-author` 技能让 AI 生成 |
 | 贡献一个皮肤给所有人 | 在 `lib/themes/` 放一个 JSON，提 PR |
 
-已随 **0.5.0** 发布 **7 套**皮肤：四套复刻自**蜂链商城**电商新零售系统管理后台
+已随 **0.6.0** 发布 **7 套**皮肤：四套复刻自**蜂链商城**电商新零售系统管理后台
 （[`renjie2026/fenglianshop-open`](https://github.com/renjie2026/fenglianshop-open) 的
 `admin-modular/src/utils/themes.js`），两套是本插件**原创**的宠物主题（同一套造色方法，色相取自中国传统色库），
 另有一套是**「纯色/拼色」配色选择器**卡片（15 个可点色值，见下）。
@@ -26,14 +26,17 @@
 | `hu-zi-a-huang` | **虎子阿黄**（原创） | `#896C39` 秋色（按钮/边框族） | `#F0C239` 缃色（中国传统色） |
 | `shi-liu-jin` | **纯色/拼色**（配色选择器） | `#F20C00` 石榴红（默认那套「石榴金」） | `#9D2933` 胭脂（按钮族） |
 
-面板里另有**两张内置外观卡**（`浅色` / `深色`）、**一张宠物挂件卡**（`宠物挂件 · 七只小伙伴`）
-和**一张心情问候卡**（`心情问候`）：它们**都不是皮肤**，所以**不计入上面这 7 套**。
+面板里另有**两张内置外观卡**（`浅色` / `深色`）、**一张宠物挂件卡**（`宠物挂件 · 七只小伙伴`）、
+**一张心情问候卡**（`心情问候`）和**一张菜单折叠卡**（`菜单折叠`）：它们**都不是皮肤**，
+所以**不计入上面这 7 套**。
 内置卡把配色切回官方的浅色 / 深色（与「设置 → 通用 → 外观」同一套），我们在官方浅色/深色上加了一点**小惊喜**
 —— 见 [效果预览](#效果预览) 最后一行。官方外观里的「跟随系统」**不出卡**：它就是浅色/深色二选一，
 再占一张卡只是重复。宠物挂件卡则完全**不碰主题**：点头像换宠物、点卡身开关挂件，
 与任何皮肤都能同时开启（见 [宠物挂件](#宠物挂件七只小伙伴)）。
 心情问候卡同样**不碰主题**：它控制标题栏上一条滚动的问候语，默认开启、35 分钟换一条，
 可调速度 / 方向 / 位置区域（见 [心情问候语](#心情问候语)）。
+菜单折叠卡也**不碰主题**：开启后侧栏不再显示入口，设置页里留一个**轻量一键入口**
+（打开面板 / 恢复侧栏），默认关闭（见 [菜单折叠](#菜单折叠)）。
 
 工作区里另有三套复刻皮肤仍在打磨，**尚未发布**：江畔冬云 `jiang-pan-dong-yun`、
 徐山军月 `xu-shan-jun-yue`、光彩凤晨 `guang-cai-feng-chen`。
@@ -627,6 +630,8 @@ document.body.setAttribute('data-dsh-theme-reading', reading.colorScheme)
   闲聊是单个可取消的定时器，拆台即清 —— 不会无界堆积（跑飞的事故见 [开发](#开发) 一节的背景）；
 - 名字等文本一律以 `textContent` 写入，**不进任何 HTML 字符串**；
 - 急停开关与侧栏素材同源：`cordis.patch.yml` 里 `config: { ambient: false }` 会把挂件一并停掉；
+- **任何模态弹窗打开时挂件自动隐藏**（设置弹窗、确认框等），关闭即恢复 —— 挂件层级
+  高于弹窗，不藏会浮在弹窗内容上；检测走语义属性（`role="dialog"` 等），不碰框架类名；
 - 挂件状态（开关 / 当前宠物 / 名字表 / 位置偏移）**只存 `localStorage`**，绝不写 `ui-theme.preference`；
   一期「小狗斑斑」的旧数据（名字 / 摆位）升级时**自动迁移**，不用重新设置。
 
@@ -661,6 +666,30 @@ document.body.setAttribute('data-dsh-theme-reading', reading.colorScheme)
 状态只存 `localStorage`，绝不写 `ui-theme.preference`；问候条是否真的建出来，
 面板诊断区有一行自检读数（警告无条件显示，例行读数走 debug 开关）。
 
+---
+
+## 菜单折叠
+
+面板里还有一张 **`菜单折叠`** 卡（序号 72，压轴）。它**不是主题，也不是皮肤**，
+管的是**面板入口放在哪**：
+
+- **默认关闭** —— 侧栏照常显示「主题皮肤」入口（就是装插件以来一直有的那个）；
+- **开启后**，左侧栏不再显示「主题皮肤」入口，腾出侧栏空间；同时
+  **左下角头像 → 设置 → 通用设置（agent预设 下方）**的分节里有一键入口：
+  **「打开主题皮肤面板」**（关掉设置弹窗、直接跳到侧栏的全屏面板）与
+  **「恢复侧栏入口」**（把侧栏的入口开回来）—— 卡面上就写着这条路径，
+  忘了从哪找回时看卡面即可；
+- 设置分节是**轻量入口**（当前皮肤 / 侧栏状态两行读数 + 上面两颗按钮），
+  不把整面板塞进弹窗：换肤是全屏效果，弹窗挡着看不全 —— 操作都在主区全屏面板完成
+  （跳转用的是外壳的官方 `layout.selectPanel` 面，关闭弹窗用的是契约自带的 `close`）；
+- **再点一次卡（或在设置分节里点「恢复侧栏入口」）就恢复侧栏显示 ——**
+  开关是双向的，即时生效、不用重启；卡面上还有一枚**胶囊滑块开关**（与心情卡同款，
+  「侧栏入口」一行）—— 点胶囊、点卡身，效果一样，状态一眼可见；
+- 收放用的是外壳槽位系统自己的注册/撤销机制（`sidebar.panellist` 的 disposer），
+  **不用 CSS 硬藏**（框架类名带构建哈希，藏不住也不该藏）；
+- 折叠状态**只存 `localStorage`**（`theme-gallery:menu-collapse`），
+  **绝不写 `ui-theme.preference`** —— 折叠只改入口显隐，**零主题写入**（一次 `setTheme` 都不发）；
+- 设置分节用官方 `settings.section` 槽位注册，**常驻**、不受折叠开关影响。
 
 ---
 
@@ -820,9 +849,9 @@ pnpm run bench     # 调参台
 
 1. **`tsc`（exit 0）**：`types/*.ts` 用官方发布的真实类型包校验插槽注册契约、`defineStore` 座位形状、主题注册与 token 契约。
 2. **契约与桩**：`check-schema`（真实 schemastery 解析 + **10 个反向用例**，含缺 `label`、缺 `description`、`reading.alpha` 越界）、`smoke-host`（**真机加载** `lib/index.js` 跑 `apply`，并守住 `inject` 清单与插槽门控）、`check-store-contract`（`handle.create()` 每次返回新实例）、`check-client-module`（bundle 形状、挂载失败必须可见）。
-3. **启动安全与端到端引导**：`check-boot-safety`（`inject` 清单、无 `modifies` 环）、`check-boot-timing`、`check-boot-path`（桩里跑完整引导：上色确认、默认皮肤、点内置卡不被弹回、切内置主题后素材保留 —— 每条都带**反证**）。
+3. **启动安全与端到端引导**：`check-boot-safety`（`inject` 清单、无 `modifies` 环）、`check-boot-timing`、`check-boot-path`（桩里跑完整引导：上色确认、默认皮肤、点内置卡不被弹回、切内置主题后素材保留、菜单折叠的侧栏收放与设置分节常驻 —— 每条都带**反证**）。
 4. **静态审计（含自检与变异反证）**：`check-declaration-order`、`check-tdz-order` + `check-tdz-logic`、`check-scope-reach` + `check-scope-reach-logic`、`check-undefined-calls`、`check-bounded-work`（有界工作量：指纹守卫、单一路径渲染、循环有截止）、`check-self-emit-guard` + `check-self-emit-guard-logic`（数出**全部**主题服务写入点）。
-5. **主题与皮肤**：`check-theme-contribution`（贡献逻辑与幂等，并断言**注册的 token 必须是字符串**——成对对象会变成 `[object Object]`）、`check-card-order`（卡片顺序、内置卡文案、默认皮肤、色块排版 `card.rows`，含 **17 处变异反证**）、`check-pet-registry`（宠物家族注册表：七只齐全、美术四件套、动画锚点与 PET_CSS 对得上、台词与步态参数在界内、斑斑一期资产指纹、预览页七只都在，含 **4 处变异反证**）、`check-ambient-render`（场景标记与关键帧）、`check-mood`（心情问候语：语料红线黑名单、时段/节日/洗牌轮换、5 等份区域几何、默认开与胶囊开关、shell.overlay 座位与有界性，含 **10 处变异反证**）。
+5. **主题与皮肤**：`check-theme-contribution`（贡献逻辑与幂等，并断言**注册的 token 必须是字符串**——成对对象会变成 `[object Object]`）、`check-card-order`（卡片顺序、内置卡文案、默认皮肤、色块排版 `card.rows`，含 **19 处变异反证**）、`check-pet-registry`（宠物家族注册表：七只齐全、美术四件套、动画锚点与 PET_CSS 对得上、台词与步态参数在界内、斑斑一期资产指纹、预览页七只都在，含 **4 处变异反证**）、`check-ambient-render`（场景标记与关键帧）、`check-mood`（心情问候语：语料红线黑名单、时段/节日/洗牌轮换、5 等份区域几何、默认开与胶囊开关、shell.overlay 座位与有界性，含 **11 处变异反证**）。
 6. **介绍文字不落后于实际**：`check-copy-consistency-logic` —— 核对 README 的皮肤清单 / 数量 / 版本 / 入口说法、面板与预览页的计数口径、README 里写的校验组数，与 `lib/themes`、`package.json`、`lib/client.js` 一致（**10 处变异反证 + 1 个"正式发布一套皮肤必须全过"的对照组**）。发布自检 `npm run publish:check` 用同一份实现，所以"改了皮肤忘了改文案"会在发布前被拦住。
 
 `scripts/embed-themes.mjs` 校验每套皮肤（形状 / id 唯一 / 双配色 / 12 必需 token / `reading`）后内联进 `lib/client.js`，幂等；两个预览页随后重建。

package/lib/client.js

@@ -82,6 +82,9 @@ window.__ModuleLoader__.load({
     // module seed (`dsh-client-store`) or the shell (`react/jsx-runtime`).
     const { defineStore } = require('@deepseek-ai/dsh-client-store')
     const { jsx, jsxs } = require('react/jsx-runtime')
+    // 设置分节组件用：把 pinned store 订阅成 React 视图（useSyncExternalStore，
+    // React 18+；dsh-pet 的分节同样直接消费 react）。本插件其余部分仍零 hooks。
+    const { useSyncExternalStore } = require('react')
 
     /** Panel id shared by the sidebar icon and the main-column page. */
     const PANEL_ID = 'theme-gallery'
@@ -148,6 +151,7 @@ window.__ModuleLoader__.load({
       'hu-zi-a-huang': 75,
       'pet-family': 74,
       'mood-greeting': 73,
+      'menu-collapse': 72,
     }
 
     /**
@@ -640,7 +644,7 @@ window.__ModuleLoader__.load({
      * package.json, and the release workflow fails when re-running the embed step
      * changes a tracked file.
      */
-    const BUNDLED_VERSION = '0.5.0'
+    const BUNDLED_VERSION = '0.6.0'
 
     /**
      * Themes this package contributes, inlined from lib/themes/*.json.
@@ -3649,11 +3653,20 @@ window.__ModuleLoader__.load({
     const zh = {
       title: '主题皮肤',
       hint: '点一下即切换，选中会记入设置',
-      count: '{count} 款皮肤（另有内置浅色/深色、宠物挂件与心情问候四张卡）',
+      count: '{count} 款皮肤（另有内置浅色/深色、宠物挂件、心情问候与菜单折叠五张卡）',
       current: '当前',
       applied: '已应用',
       petOn: '已开启',
       petOff: '已关闭',
+      menuCollapsed: '已折叠',
+      menuShown: '侧栏显示中',
+      menuPillLabel: '侧栏入口',
+      menuHint: '开启后，左侧栏不再显示「主题皮肤」入口；设置 → 通用设置（agent预设 下方）里有轻量入口，可一键打开面板或恢复侧栏显示。默认关闭。',
+      sectionHint: '换皮肤、调挂件与问候语都在主区全屏面板完成，效果看得见；这里是一键入口。',
+      openPanel: '打开主题皮肤面板',
+      restoreSidebar: '恢复侧栏入口',
+      sectionSkinLabel: '当前皮肤：',
+      sectionSidebarLabel: '侧栏入口：',
       empty: '正在读取官方主题注册表…',
       // The diagnostics below the cards are a FEATURE — a live reading of the active skin —
       // and a wall of monospace text reads as a fault unless the panel says otherwise.
@@ -3663,11 +3676,20 @@ window.__ModuleLoader__.load({
     const en = {
       title: 'Theme skins',
       hint: 'Click to switch; the choice is remembered',
-      count: '{count} skins (+ built-in light/dark, the pet-widget card and the mood-greeting card)',
+      count: '{count} skins (+ built-in light/dark, pet-widget, mood-greeting and menu-collapse cards)',
       current: 'Current',
       applied: 'Applied',
       petOn: 'On',
       petOff: 'Off',
+      menuCollapsed: 'Collapsed',
+      menuShown: 'In sidebar',
+      menuPillLabel: 'Sidebar entry',
+      menuHint: 'When on, the sidebar no longer shows this entry; Settings → General (below the Agent preset) has a lightweight entry to open the panel or restore the sidebar. Off by default.',
+      sectionHint: 'Skins, the pet and the greeting live in the full main-area panel where the effect is visible; this is a one-click entry.',
+      openPanel: 'Open the theme panel',
+      restoreSidebar: 'Show the sidebar entry',
+      sectionSkinLabel: 'Current skin: ',
+      sectionSidebarLabel: 'Sidebar entry: ',
       empty: 'Reading the theme registry…',
       diagNote: 'The lines below are intentional diagnostics of the live skin state, '
         + 'not an error report; only lines starting with ⚠ mean the scenery is not working',
@@ -3719,6 +3741,33 @@ window.__ModuleLoader__.load({
       '.tg-badge{font-size:11px;padding:1px 7px;border-radius:999px;',
       'background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary-foreground)}',
       '.tg-desc{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.5}',
+      /* 菜单折叠卡的路径提示（卡面正文）：与 .tg-hint（页头）无关，这是卡内元素。 */
+      '.tg-path{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.55}',
+      /* 菜单折叠卡的胶囊行容器：胶囊行（复用 .tg-mood-row 的排布）+ 路径提示上下排。 */
+      '.tg-menu-body{display:flex;flex-direction:column;gap:8px;align-items:stretch}',
+      /* ── the lightweight settings-section entry (form A, user-approved) ───────
+         设置弹窗里的轻量分节：报状态 + 一键跳转主区面板 + 折叠时给恢复按钮。
+         容器是弹窗内容列（宽度不由我们定），所以全部用自适应宽度 + 垂直节奏，
+         不放网格 —— 完整面板在弹窗里既会挤也没意义（方案 A 的结论）。
+         排版（用户返工 2026-09-27）：读数块（label 左值右）+ 主次分明的按钮组
+         （主按钮 = 品牌色整宽跳转，次按钮 = 描边恢复）。 */
+      '.tg-section{display:flex;flex-direction:column;gap:14px;padding:6px 2px 2px}',
+      '.tg-section-title{font-size:15px;font-weight:600}',
+      '.tg-section-hint{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.65}',
+      '.tg-section-facts{display:flex;flex-direction:column;gap:8px;padding:10px 12px;'
+        + 'border:1px solid var(--dsw-alias-border-l3);border-radius:10px}',
+      '.tg-section-row{display:flex;align-items:center;justify-content:space-between;gap:12px;'
+        + 'font-size:12.5px;color:var(--dsw-alias-label-secondary)}',
+      '.tg-section-value{color:var(--dsw-alias-label-primary);font-weight:600;text-align:right}',
+      '.tg-section-actions{display:flex;flex-direction:column;gap:8px}',
+      '.tg-section-open{width:100%;padding:9px 14px;border:none;border-radius:10px;'
+        + 'background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary-foreground);'
+        + 'font-size:13px;font-weight:600;cursor:pointer}',
+      '.tg-section-open:hover{filter:brightness(1.08)}',
+      '.tg-section-restore{width:100%;padding:9px 14px;border:1px solid var(--dsw-alias-border-l3);'
+        + 'border-radius:10px;background:transparent;color:var(--dsw-alias-label-primary);'
+        + 'font-size:12.5px;cursor:pointer}',
+      '.tg-section-restore:hover{background:var(--dsw-alias-interactive-bg-hover)}',
       '.tg-strip{display:flex;height:6px;border-radius:999px;overflow:hidden;border:.5px solid var(--dsw-alias-border-l3)}',
       '.tg-strip span{flex:1}',
       /* ── the PALETTE PICKER card (15 clickable colour buttons) ────────────────
@@ -3839,6 +3888,7 @@ window.__ModuleLoader__.load({
           scheme: '', selected: 'system', status: '', revision: -1,
           petEnabled: false, petKind: 'ban-ban',
           moodOn: true, moodSpeed: 'medium', moodDirection: 'ltr', moodZone: 'center',
+          menuCollapsed: false,
         }),
         actions: {
           sync: (draft, themes, selected, revision) => {
@@ -3936,6 +3986,15 @@ window.__ModuleLoader__.load({
             draft.moodDirection = String(state.direction)
             draft.moodZone = String(state.zone)
           },
+          /**
+           * 记录菜单折叠的开关状态，给折叠卡的徽标与 aria-pressed 用。
+           *
+           * 与 markPet/markMood 同一条理由：折叠状态不是主题，单独字段，由 `publish()`
+           * 从 localStorage 读出后写进来。**测试桩的 action 表必须跟着长**（规则 8）。
+           * @param draft - store 草稿。
+           * @param on - 侧栏入口是否已折叠。
+           */
+          markMenuCollapse: (draft, on) => { draft.menuCollapsed = on === true },
         },
       })
     }
@@ -4201,10 +4260,11 @@ window.__ModuleLoader__.load({
       const {
         id, label, description, swatches, rows, selected, applied,
         selectedScheme, onSelect, onPickScheme, onTogglePet, petEnabled, petKind, onPickPet,
-        mood, onToggleMood, onSetMood, t,
+        mood, onToggleMood, onSetMood, menuCollapsed, onToggleMenuCollapse, t,
       } = props
       const isWidget = id === PET_WIDGET.id
       const isMood = id === MOOD_WIDGET.id
+      const isMenuCollapse = id === MENU_COLLAPSE_WIDGET.id
       // ── WHY THE FLAG, AND NOT `blocks !== null` ──────────────────────────────
       //
       // Whether this card is a picker has to be read off the DATA, not off the rendered
@@ -4221,17 +4281,20 @@ window.__ModuleLoader__.load({
       // the whole panel — the silent-failure shape this project keeps paying for.
       const shape = cardRowShape({ card: { rows } }, PALETTE_SCHEMES)
       const hasPicker = shape !== undefined
-      // 挂件/问候卡的徽标永远在场（它就是"开关状态"的读数）；其余卡保持原样：选中才亮。
+      // 挂件/问候/折叠卡的徽标永远在场（它就是"开关状态"的读数）；其余卡保持原样：选中才亮。
       const badgeText = (isWidget || isMood)
         ? ((isWidget ? petEnabled === true : mood?.on === true) ? t('petOn') : t('petOff'))
-        : applied
+        : isMenuCollapse
+          ? (menuCollapsed === true ? t('menuCollapsed') : t('menuShown'))
+          : applied
       const head = jsxs('div', {
         className: 'tg-card-top',
         children: [
           jsx('span', { className: 'tg-name', children: label || id }),
-          (selected || isWidget || isMood)
+          (selected || isWidget || isMood || isMenuCollapse)
             ? jsx('span', {
               className: (isWidget && petEnabled !== true) || (isMood && mood?.on !== true)
+                  || (isMenuCollapse && menuCollapsed !== true)
                 ? 'tg-badge tg-badge-off'
                 : 'tg-badge',
               children: badgeText,
@@ -4261,16 +4324,50 @@ window.__ModuleLoader__.load({
               onSetMood,
               dict: t,
             })
-            : swatches.length > 0
-              ? jsx('span', {
-                className: 'tg-strip',
-                children: swatches.map((colour, index) => jsx('span', { style: { background: colour } }, index)),
+            : isMenuCollapse
+              ? jsxs('div', {
+                className: 'tg-menu-body',
+                children: [
+                  // 胶囊滑块（用户 2026-09-27 加）：开关状态一眼可见，label 说明它管什么。
+                  // 样式/结构与心情卡的胶囊同款（类名有意复用 —— 视觉绝对一致，零新 CSS）；
+                  // 点击拦冒泡 —— 卡身也响应点击，不拦会翻转两次。
+                  jsxs('div', {
+                    className: 'tg-mood-row',
+                    children: [
+                      jsx('span', { className: 'tg-mood-row-label', children: t('menuPillLabel') }),
+                      jsxs('button', {
+                        type: 'button',
+                        className: 'tg-mood-switch',
+                        role: 'switch',
+                        'aria-checked': menuCollapsed === true,
+                        title: '开=收起侧栏的「主题皮肤」入口；关=恢复显示（与点卡身等效）',
+                        onClick: (event) => {
+                          if (event !== undefined && typeof event.stopPropagation === 'function') event.stopPropagation()
+                          onToggleMenuCollapse()
+                        },
+                        children: [
+                          jsx('span', { className: 'tg-mood-pill', 'aria-hidden': 'true' }),
+                          jsx('span', {
+                            className: 'tg-mood-state',
+                            children: menuCollapsed === true ? t('menuCollapsed') : t('menuShown'),
+                          }),
+                        ],
+                      }),
+                    ],
+                  }),
+                  jsx('span', { className: 'tg-path', children: t('menuHint') }),
+                ],
               })
-              : null
-      // The picker fills the card and the widget/mood cards draw their own controls,
+              : swatches.length > 0
+                ? jsx('span', {
+                  className: 'tg-strip',
+                  children: swatches.map((colour, index) => jsx('span', { style: { background: colour } }, index)),
+                })
+                : null
+      // The picker fills the card and the widget/mood/menu cards draw their own controls,
       // so none of them prints body copy; `description` stays the tooltip, which is
       // what the schema says the field is for.
-      const desc = !hasPicker && !isWidget && !isMood && description
+      const desc = !hasPicker && !isWidget && !isMood && !isMenuCollapse && description
         ? jsx('span', { className: 'tg-desc', children: description })
         : null
       if (hasPicker) {
@@ -4311,6 +4408,19 @@ window.__ModuleLoader__.load({
           children: [head, body, desc],
         })
       }
+      if (isMenuCollapse) {
+        // 菜单折叠卡：卡身是 **div**（与挂件卡/问候卡同构）——卡内现在装着胶囊按钮
+        // （button 套 button 非法，浏览器会静默重排）。点卡身 = 开关折叠（保留），
+        // 开关语义由**胶囊的 role="switch" + aria-checked** 与徽标表达；**绝不**调用
+        // setTheme —— 折叠只改侧栏入口显隐、零主题写入。卡面正文是路径提示 +
+        // 胶囊行（用户要求把找回路径写在卡上、胶囊让状态一眼可见）。
+        return jsxs('div', {
+          className: 'tg-card tg-menu-card',
+          onClick: () => { onToggleMenuCollapse() },
+          title: description || label,
+          children: [head, body, desc],
+        })
+      }
       return jsxs('button', {
         type: 'button',
         className: 'tg-card',
@@ -8155,6 +8265,22 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * 菜单折叠卡的卡片数据（moodCardTheme 同构）：只在面板里存在的非主题卡，
+     * 走同一条排序与渲染管线（CARD_ORDER 72、tooltip），不注册进主题服务，
+     * 官方外观列表不会多出这一项。
+     * @returns 只带卡片字段的对象（没有 tokens，默认色带为空）。
+     */
+    function menuCollapseCardTheme() {
+      return {
+        id: MENU_COLLAPSE_WIDGET.id,
+        label: MENU_COLLAPSE_WIDGET.label,
+        description: MENU_COLLAPSE_WIDGET.description,
+        colorScheme: 'light',
+        tokens: {},
+      }
+    }
+
     /**
      * 输入框（composer 座位）的矩形。
      *
@@ -8223,6 +8349,9 @@ window.__ModuleLoader__.load({
     /** 挂件层自己的样式表（与 PAGE_CSS 分开：它属于运行时舞台，不属于面板页面）。 */
     const PET_CSS = [
       `#${PET_STAGE_ID}{position:fixed;left:0;top:0;right:0;bottom:0;pointer-events:none;z-index:1200}`,
+      // 弹窗打开时整层隐藏（body 标记类由 syncPetDialogHidden 维护）——
+      // 挂件 z-index 高于模态弹窗，不藏会浮在弹窗内容上方（实机读数 2026-09-27）。
+      'body.dsh-dialog-open #dsh-theme-pet{display:none!important}',
       '.dsh-pet-actor,.dsh-pet-prop{position:absolute;left:0;top:0;pointer-events:auto;cursor:grab;will-change:transform}',
       '.dsh-pet-actor:active,.dsh-pet-prop:active{cursor:grabbing}',
       // flip 层与 figure 层必须分开：**镜像（内联 transform）绝不能和跑步动画（keyframes）
@@ -8471,12 +8600,76 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /* ── 弹窗打开时隐藏挂件（用户 2026-09-27 定）────────────────────────────
+     *
+     * 挂件层挂 body、z-index 1200，高于设置等模态弹窗 —— 弹窗一开，小雪兔就浮在
+     * 弹窗内容上方（实测读数：设置 → 通用设置任何分节都如此）。检测走**语义属性**
+     * （role="dialog" / aria-modal / 原生 <dialog>），绝不碰框架哈希类名（§13）；
+     * 任何弹窗都触发 —— 不止设置弹窗，以后别的确认框也不会被挂件挡。
+     * observer 是事件驱动（childList/attributes），随舞台起停 —— 有界；
+     * body 上的标记类只在挂件存活期间存在，拆除时一并清掉。
+     */
+
+    /** 弹窗隐藏的 observer 句柄；undefined = 未安装。 */
+    let petDialogObserver
+
+    /** 现在有没有模态弹窗开着（语义选择器，一次查询）。 */
+    function petDialogOpen() {
+      try {
+        return typeof document !== 'undefined' && document !== null
+          && document.querySelector('dialog[open], [role="dialog"], [aria-modal="true"]') !== null
+      } catch {
+        return false
+      }
+    }
+
+    /**
+     * 把"弹窗开着"落成 body 标记类（PET_CSS 里一条规则据此藏挂件层）。
+     * @returns 弹窗是否开着（诊断读数用）。
+     */
+    function syncPetDialogHidden() {
+      const open = petDialogOpen()
+      try {
+        document.body?.classList?.toggle('dsh-dialog-open', open)
+      } catch {
+        // classList 不可用（极端桩）时挂件照常显示 —— 隐藏是体验优化，不是功能闸。
+      }
+      return open
+    }
+
+    /** 随舞台安装：装上即先同步一次，之后由 DOM 变化驱动。 */
+    function installPetDialogObserver() {
+      if (petDialogObserver !== undefined) return
+      if (typeof MutationObserver !== 'function') return
+      syncPetDialogHidden()
+      petDialogObserver = new MutationObserver(() => { syncPetDialogHidden() })
+      petDialogObserver.observe(document.body, {
+        childList: true, subtree: true,
+        attributes: true, attributeFilter: ['open', 'role', 'aria-modal', 'class'],
+      })
+    }
+
+    /** 随舞台拆除：断开 observer、清掉标记类 —— 挂件不在了就不该留痕迹。 */
+    function removePetDialogObserver() {
+      if (petDialogObserver === undefined) return
+      try { petDialogObserver.disconnect() } catch {
+        // 断开失败只留一个空 observer，下一次安装会覆盖它。
+      }
+      petDialogObserver = undefined
+      try {
+        document.body?.classList?.remove?.('dsh-dialog-open')
+      } catch {
+        // 同上：清理失败不影响功能。
+      }
+    }
+
     /**
      * 拆掉舞台与其样式表，清空运行态。
      *
      * 定时器、闲聊句柄、document 监听一并清掉：任何一句话都不许对已拆除的节点说。
      */
     function removePetStage() {
+      removePetDialogObserver()
       for (const handle of petTimers) window.clearTimeout(handle)
       petTimers = []
       if (typeof window.clearTimeout === 'function') window.clearTimeout(petChatterTimer)
@@ -8889,6 +9082,8 @@ window.__ModuleLoader__.load({
       if (typeof document !== 'undefined' && typeof document.addEventListener === 'function') {
         document.addEventListener('input', petOnTyping, true)
       }
+      // 弹窗隐藏挂件的 observer 同步起停（装上即先按当前状态同步一次）。
+      installPetDialogObserver()
       schedulePetChatter()
     }
 
@@ -9851,6 +10046,196 @@ window.__ModuleLoader__.load({
       noteMoodReport({ enabled: false, seat: 'absent', css: false, line: null, pool: '-', note: '开关为关' })
     }
 
+    /* ═══════════════════ 菜单折叠（侧栏入口收放 + 设置页常驻面板）═══════════════════
+     *
+     * 方案二（用户定）：设置页入口**常驻**，侧栏入口由本开关收放。三件事：
+     *  ① 面板第 15 张卡「菜单折叠」（默认关）—— 卡面带路径提示，点击只改 localStorage；
+     *  ② `settings.section` 槽位注册一个**常驻**的一级设置分节（用户指定：agent预设下方），
+     *     内容 = 完整面板（ThemeGalleryPage + 同一个 pinned store），侧栏收起后面板仍可达
+     *     —— 这是"不会把自己锁在外面"的关键；
+     *  ③ 侧栏入口的注册/撤销随开关走（槽位 disposer，即时生效，不重启、不碰 CSS）。
+     * 不写主题服务：折叠状态只存 localStorage（铁律）。
+     */
+
+    /** 折叠卡的 id、标题与 tooltip 文案。 */
+    const MENU_COLLAPSE_WIDGET = {
+      id: 'menu-collapse',
+      label: '菜单折叠',
+      description: '开启后，左侧栏不再显示「主题皮肤」入口；设置 → 通用设置（agent预设 下方）'
+        + '里有轻量入口，可一键打开面板或恢复侧栏显示。关闭后恢复侧栏显示。默认关闭。',
+    }
+
+    /** 折叠状态记在这里。与皮肤 id 同一条铁律：绝不写 `ui-theme.preference`。 */
+    const MENU_COLLAPSE_KEY = 'theme-gallery:menu-collapse'
+
+    /**
+     * 设置分节在设置页导航里的位置（order）。
+     *
+     * 探针读数（app.asar + profile 插件，2026-09-27）：settings.section 里 cool-theme=5、
+     * skin-center=120、pet=130；General 行 appearance=10、font-size=11。「agent预设」的
+     * 注册点不在客户端 bundle 里（无法静态标定它的 order），先取 **135**（排在已知插件
+     * 分节之后）；实机若不在 agent预设 下方，改这一个数字即可。
+     */
+    const SETTINGS_SECTION_ORDER = 135
+
+    /**
+     * 读取并消毒折叠状态。缺省**关**（= 侧栏显示现状），坏数据回缺省。
+     * @returns `{ collapsed }`。
+     */
+    function readMenuCollapseState() {
+      try {
+        const raw = window.localStorage?.getItem(MENU_COLLAPSE_KEY)
+        if (typeof raw !== 'string' || raw === '') return { collapsed: false }
+        const parsed = JSON.parse(raw)
+        if (parsed === null || typeof parsed !== 'object') return { collapsed: false }
+        return { collapsed: parsed.collapsed === true }
+      } catch {
+        return { collapsed: false }
+      }
+    }
+
+    /** 合并写回折叠状态（写失败只记录 —— localStorage 被禁用时本次会话仍可玩）。 */
+    function saveMenuCollapseState(patch) {
+      try {
+        window.localStorage?.setItem(MENU_COLLAPSE_KEY, JSON.stringify({ ...readMenuCollapseState(), ...patch }))
+      } catch (error) {
+        console.error('[theme-gallery] could not save the menu-collapse state:', error)
+      }
+    }
+
+    /** 折叠开关现在是否开着（= 侧栏入口已收起）。 */
+    function menuCollapsed() {
+      return readMenuCollapseState().collapsed
+    }
+
+    /** store 未就绪时分节读的兜底快照（hooks 必须恒在场，见 MenuSettingsSection 文档）。 */
+    const SECTION_FALLBACK_SNAPSHOT = { labels: {}, selected: '', menuCollapsed: false }
+
+    /**
+     * 设置页的常驻分节（方案二，形态 A —— 用户 2026-09-27 定）：**轻量入口**。
+     *
+     * 实机读数：完整面板塞进弹窗内容列会白屏（根因 = `store.getState` 与真实
+     * StoreInstance 契约漂移，真实只有 `getSnapshot` —— 已修），而且就算修好，
+     * 弹窗也挡住大半屏幕，换肤的全屏效果在里面看不见。官方契约把 settings.section
+     * 定位为"一个列表项一个设置页"（owner props 只有 close），dsh-pet 的分节同样
+     * 是轻量表单 —— 所以分节只做三件事：报状态（当前皮肤 / 侧栏入口）、给
+     * 「打开主题皮肤面板」跳转（`ctx.layout.selectPanel` —— 契约明说它是给插件
+     * 做面板切换的横切面 + `close` 关弹窗）、折叠开着时给「恢复侧栏入口」。
+     * 真正的换肤 / 挂件 / 问候操作都在主区全屏面板里完成。
+     * @param props - 分节 props（t/close + inject 面成员）。
+     * @returns 分节元素树。
+     */
+    function MenuSettingsSection(props) {
+      const { t, close, store, toggleMenuCollapse } = props
+      // hooks 规则：订阅恒在场 —— store 缺失（inject 面没解析）时订阅空源、读兜底
+      // 快照，分节退化为引导文案，绝不白屏（白屏教训就在眼前）。
+      // 两个包装都是刻意的：抽出方法会丢 this，直接给属性引用在真实引擎上不安全。
+      const snapshot = useSyncExternalStore(
+        (onStoreChange) => (store?.subscribe ? store.subscribe(onStoreChange) : () => {}),
+        () => (store?.getSnapshot ? store.getSnapshot() : SECTION_FALLBACK_SNAPSHOT),
+      )
+      const skinLabel = snapshot?.labels?.[snapshot?.selected] ?? snapshot?.selected ?? ''
+      const collapsed = snapshot?.menuCollapsed === true
+      // 排版（用户 2026-09-27 返工）：标题 → 说明 → 读数块（两行，label 左值右）→
+      // 按钮组（主按钮跳转、次按钮恢复）—— 主次分明、垂直节奏，适配弹窗窄容器。
+      return jsxs('div', {
+        className: 'tg-section',
+        children: [
+          jsx('div', { className: 'tg-section-title', children: t('title') }),
+          jsx('div', { className: 'tg-section-hint', children: t('sectionHint') }),
+          jsxs('div', {
+            className: 'tg-section-facts',
+            children: [
+              jsxs('div', {
+                className: 'tg-section-row',
+                children: [
+                  jsx('span', { children: t('sectionSkinLabel') }),
+                  jsx('span', { className: 'tg-section-value', children: skinLabel }),
+                ],
+              }),
+              jsxs('div', {
+                className: 'tg-section-row',
+                children: [
+                  jsx('span', { children: t('sectionSidebarLabel') }),
+                  jsx('span', {
+                    className: 'tg-section-value',
+                    children: collapsed ? t('menuCollapsed') : t('menuShown'),
+                  }),
+                ],
+              }),
+            ],
+          }),
+          jsxs('div', {
+            className: 'tg-section-actions',
+            children: [
+              jsx('button', {
+                type: 'button',
+                className: 'tg-section-open',
+                onClick: () => {
+                  // 软跳转：布局面不在 / 面板未注册都只留痕，绝不把设置弹窗带崩。
+                  try {
+                    if (ctx !== undefined && ctx !== null && typeof ctx.layout?.selectPanel === 'function') {
+                      ctx.layout.selectPanel(PANEL_ID)
+                    } else {
+                      console.error('[theme-gallery] ctx.layout.selectPanel is unavailable; cannot jump to the panel')
+                    }
+                  } catch (error) {
+                    console.error('[theme-gallery] could not jump to the panel:', error)
+                  }
+                  // 官方明说 close 是给"从分节离开设置"用的 —— 跳转后关掉弹窗，全屏效果可见。
+                  if (typeof close === 'function') close()
+                },
+                children: t('openPanel'),
+              }),
+              collapsed ? jsx('button', {
+                type: 'button',
+                className: 'tg-section-restore',
+                onClick: () => {
+                  // 复用折叠卡的同一动作：写回 localStorage + 重新注册侧栏入口 + publish
+                  // 报回 store —— 分节经订阅重渲染，这颗按钮自己消失。
+                  try { toggleMenuCollapse() } catch (error) {
+                    console.error('[theme-gallery] could not restore the sidebar entry:', error)
+                  }
+                },
+                children: t('restoreSidebar'),
+              }) : null,
+            ],
+          }),
+        ],
+      })
+    }
+
+    /** 侧栏入口的 inject 句柄；undefined = 当前没有注册（已折叠）。 */
+    let sidebarEntryDispose
+
+    /**
+     * 侧栏入口的注册/撤销随折叠开关走（幂等）。
+     *
+     * 撤销用的是槽位系统自己的 disposer —— 官方机制，即时生效；**绝不**用 CSS 硬藏
+     * （框架类名带哈希，§13 的教训）。每次状态变化都留痕（noteAmbientEvent），
+     * "收起了/恢复了"必须可查，而不是靠用户盯着侧栏猜。
+     */
+    function syncSidebarEntry() {
+      if (typeof ctx === 'undefined' || ctx === null) return
+      if (menuCollapsed()) {
+        if (sidebarEntryDispose !== undefined) {
+          sidebarEntryDispose()
+          sidebarEntryDispose = undefined
+          noteAmbientEvent('侧栏入口已收起（菜单折叠开）')
+        }
+        return
+      }
+      if (sidebarEntryDispose !== undefined) return
+      sidebarEntryDispose = ctx.slots.inject('sidebar.panellist', () => ctx.slots.register({
+        name: 'sidebar.panellist',
+        id: PANEL_ID,
+        order: 30,
+        locale: NS,
+        label: () => zh.title,
+      }, PanelGlyph))
+      noteAmbientEvent('侧栏入口已显示（菜单折叠关）')
+    }
+
     /**
      * Render the main-column gallery page.
      *
@@ -9860,7 +10245,7 @@ window.__ModuleLoader__.load({
      * @param props - composed slot props.
      * @returns the page element tree.
      */
-    function ThemeGalleryPage({ t, setTheme, pickScheme, togglePet, pickPet, toggleMood, setMood, useStore, usePanelInfo }) {
+    function ThemeGalleryPage({ t, setTheme, pickScheme, togglePet, pickPet, toggleMood, setMood, toggleMenuCollapse, useStore, usePanelInfo }) {
       const info = usePanelInfo((s) => s.activePanelId)
       const ids = useStore((s) => s.ids)
       const labels = useStore((s) => s.labels)
@@ -9874,6 +10259,7 @@ window.__ModuleLoader__.load({
       const moodSpeed = useStore((s) => s.moodSpeed)
       const moodDirection = useStore((s) => s.moodDirection)
       const moodZone = useStore((s) => s.moodZone)
+      const menuCollapsed = useStore((s) => s.menuCollapsed)
       const selected = useStore((s) => s.selected)
       const status = useStore((s) => s.status)
       // The layout keeps this page registered whatever the selection is, so it
@@ -9905,10 +10291,11 @@ window.__ModuleLoader__.load({
       // official appearance — so counting them here would advertise a number that disagrees
       // with the README and with npm's description ("6 skins"). The cards are named in the
       // same line instead, so nothing is hidden by leaving them out of the number.
-      // 宠物挂件卡同理：它不是主题、不换配色，只开关挂件，所以与内置卡一起排除在
-      // "皮肤数"之外（copy-consistency 的正则钉住的是 skinCount 那一行的形状）。
+      // 宠物挂件卡/心情问候卡/菜单折叠卡同理：它们不是主题、不换配色，只开关各自的
+      // 功能，所以与内置卡一起排除在"皮肤数"之外（copy-consistency 的正则钉住的是
+      // skinCount 那一行的形状）。
       const builtInCards = ids.filter((id) => BUILT_IN_LABELS[id] !== undefined
-        || id === PET_WIDGET.id || id === MOOD_WIDGET.id).length
+        || id === PET_WIDGET.id || id === MOOD_WIDGET.id || id === MENU_COLLAPSE_WIDGET.id).length
       const skinCount = ids.length - builtInCards
       return jsxs('div', {
         className: 'tg-page',
@@ -9958,6 +10345,10 @@ window.__ModuleLoader__.load({
               mood: { on: moodOn === true, speed: moodSpeed, direction: moodDirection, zone: moodZone },
               onToggleMood: () => { toggleMood() },
               onSetMood: (patch) => { setMood(patch) },
+              // 菜单折叠卡：点击 = 收起/恢复侧栏入口（见 ThemeCard 的折叠分支）。
+              // 状态从 localStorage 报来，徽标与 aria-pressed 都读它。
+              menuCollapsed: menuCollapsed === true,
+              onToggleMenuCollapse: () => { toggleMenuCollapse() },
               t,
             }, id)),
           }),
@@ -10085,17 +10476,26 @@ window.__ModuleLoader__.load({
      * That is the pair that makes it safe, and this package now has both:
      *
      *   package.json  dsh.client.inject = ["@deepseek-ai/dsh-client-locale",
+     *                                      "@deepseek-ai/dsh-client-ui-layout",
      *                                      "@deepseek-ai/dsh-client-ui-theme"]
-     *   here          exports.inject   = ['slots', 'locale', 'theme']
+     *   here          the inject list   = ['slots', 'locale', 'theme', 'layout']
      *
      * The two earlier failures were the `modifies` cycle and the missing module declaration.
-     * Both are fixed, and both are asserted in `tests/check-boot-safety.mjs`.
+     * Both are fixed, and both are asserted in `tests/check-boot-safety.mjs`. `layout` joined
+     * in 2026-09-27 for the settings-section jump: without the declaration `ctx.layout` is
+     * undefined and the "open panel" button silently only closed the dialog (实测读数).
+     * Note: the assertion regex is anchored to line start — prose examples like this one
+     * must NOT be written as `exports.inject = [...]`, or the static audit reads the comment.
      *
      * `locale` is declared for the same reason: the sidebar row resolves its label through it,
      * and the providing module is declared in the manifest.
      * @type {string[]}
      */
-    exports.inject = ['slots', 'locale', 'theme']
+    // `layout` 是设置分节「打开主题皮肤面板」的跳转面（ctx.layout.selectPanel —— 官方
+    // Context 合并声明，契约原文说它就是给其他插件做面板切换的横切面）。实机读数
+    // 2026-09-27：没声明它时 ctx.layout 是 undefined，跳转按钮只关了弹窗 —— 插件
+    // 能读到哪些服务完全由这份清单决定，缺一个就是静默失败。
+    exports.inject = ['slots', 'locale', 'theme', 'layout']
 
     /**
      * Marks this client module as a PLUGIN rather than a plain service module.
@@ -10842,9 +11242,9 @@ window.__ModuleLoader__.load({
         // never change which themes exist, what they contain, or the order they were
         // contributed — `cardsInDisplayOrder` is a view over the filtered list.
         // 宠物挂件卡不是主题、不在注册表里：作为一张**只存在于面板**的卡片数据追加进来，
-        // 与其他卡走同一条排序管线（见 `petWidgetCardTheme`）。
+        // 与其他卡走同一条排序管线（见 `petWidgetCardTheme`）。菜单折叠卡同构。
         const themes = cardsInDisplayOrder([...snapshot.themes].filter((theme) => !OMITTED_IDS.has(theme.id))
-          .concat([petWidgetCardTheme(), moodCardTheme()]))
+          .concat([petWidgetCardTheme(), moodCardTheme(), menuCollapseCardTheme()]))
         storeActions.sync(themes, appliedCardId(snapshot), revision)
         // 卡片上点亮哪一格，以及要不要把那一层配色叠上去 —— 两件事都读同一份
         // localStorage，所以"看到的选中态"与"屏幕上的颜色"不可能对不上。
@@ -10855,6 +11255,8 @@ window.__ModuleLoader__.load({
         storeActions.markPetKind(readPetState().kind)
         // 心情问候卡的胶囊开关与三组 chips 读同一个来源。
         storeActions.markMood(readMoodState())
+        // 菜单折叠卡的徽标与 aria-pressed 读同一个来源。
+        storeActions.markMenuCollapse(menuCollapsed())
         // 问候条是幂等同步：状态/几何/文本没变就一个字节都不写（moodBuildBar 指纹守卫），
         // 所以 publish 顺路调用它没有性能负担，还负责把"座位晚渲染"捡起来。
         syncMoodBar()
@@ -10984,6 +11386,23 @@ window.__ModuleLoader__.load({
         }
       }
 
+      /**
+       * 用户点了菜单折叠卡：翻转折叠状态、收放侧栏入口、刷新面板。
+       *
+       * 这条路**完全不碰主题服务** —— 折叠只改侧栏入口的显隐，面板本体（main 槽位）
+       * 与设置分节（settings.section）恒在，所以从任何一侧都能把开关翻回来。
+       * `publish()` 会把新状态经 `markMenuCollapse` 报给页面。
+       */
+      function toggleMenuCollapse() {
+        try {
+          saveMenuCollapseState({ collapsed: !menuCollapsed() })
+          syncSidebarEntry()
+          publish(ctx.theme.getTheme())
+        } catch (error) {
+          console.error('[theme-gallery] could not toggle the menu collapse:', error)
+        }
+      }
+
       /**
        * 用户点了挂件卡上的一颗头像：换成那只宠物并放它出场。
        *
@@ -11364,6 +11783,35 @@ window.__ModuleLoader__.load({
       // shipped panel plugins use the plain form, so this does too — the extra
       // machinery was unverified, and a subscription that never installs is
       // indistinguishable from a panel that never registers.
+      /**
+       * 面板的 inject 面：侧栏页与设置分节（MenuSettingsSection）共用的同一份动作。
+       * **刻意零主题写入的新增** —— setTheme 是外壳槽位动作（审计允许清单精确匹配
+       * 的那一条），其余全部只写 localStorage。
+       * @returns 动作面（含 pinned store，供设置分节的 useSyncExternalStore 订阅）。
+       */
+      function buildPanelFace() {
+        return {
+          setTheme: (id) => { ctx.theme.setTheme(id) },
+          // 配色卡上的 15 个色值按钮走这条。它**不直接**切主题（见 `chooseScheme`），
+          // 所以这里不新增主题写入点。
+          pickScheme: (schemeId) => { chooseScheme(schemeId) },
+          // 挂件卡走这条：只开关挂件、只写 localStorage，同样不新增主题写入点。
+          togglePet: () => { togglePetWidget() },
+          // 头像选择行走这条：换宠物（必要时顺路打开），同样零主题写入。
+          pickPet: (kindId) => { selectPetWidget(kindId) },
+          // 心情问候卡走这两条：胶囊开关/点卡身开关、三组设置 chips。
+          // 一样零主题写入 —— 问候与皮肤正交。
+          toggleMood: () => { toggleMoodWidget() },
+          setMood: (patch) => { setMoodSettings(patch) },
+          // 菜单折叠卡走这条：收放侧栏入口、只写 localStorage，同样不新增主题写入点。
+          toggleMenuCollapse: () => { toggleMenuCollapse() },
+          // 设置分节组件用：pinned store 实例（subscribe/getSnapshot —— StoreInstance
+          // 契约上没有 getState，白屏事故的根因就是按 getState 读的），MenuSettingsSection
+          // 经 useSyncExternalStore 把它绑定成响应式视图。
+          store: storeInstance,
+        }
+      }
+
       ctx.slots.inject('main', () => {
         const disposePage = ctx.slots.register({
           name: 'main',
@@ -11378,20 +11826,7 @@ window.__ModuleLoader__.load({
             // — so it is set BEFORE the publish that reads it.
             injectRan = true
             publish(ctx.theme.getTheme())
-            return {
-              setTheme: (id) => { ctx.theme.setTheme(id) },
-              // 配色卡上的 15 个色值按钮走这条。它**不直接**切主题（见 `chooseScheme`），
-              // 所以这里不新增主题写入点。
-              pickScheme: (schemeId) => { chooseScheme(schemeId) },
-              // 挂件卡走这条：只开关挂件、只写 localStorage，同样不新增主题写入点。
-              togglePet: () => { togglePetWidget() },
-              // 头像选择行走这条：换宠物（必要时顺路打开），同样零主题写入。
-              pickPet: (kindId) => { selectPetWidget(kindId) },
-              // 心情问候卡走这两条：胶囊开关/点卡身开关、三组设置 chips。
-              // 一样零主题写入 —— 问候与皮肤正交。
-              toggleMood: () => { toggleMoodWidget() },
-              setMood: (patch) => { setMoodSettings(patch) },
-            }
+            return buildPanelFace()
           },
         }, ThemeGalleryPage)
 
@@ -11434,13 +11869,33 @@ window.__ModuleLoader__.load({
       // Sidebar entrance: the list id IS the main-panel key. `locale` is declared
       // the way the shipped panel entries declare it, so the row label resolves
       // through the dictionary rather than a raw string.
-      ctx.slots.inject('sidebar.panellist', () => ctx.slots.register({
-        name: 'sidebar.panellist',
-        id: PANEL_ID,
-        order: 30,
-        locale: NS,
-        label: () => zh.title,
-      }, PanelGlyph))
+      // 菜单折叠（方案二）：注册/撤销随折叠开关走 —— syncSidebarEntry 读 localStorage
+      // 决定是否注册；设置页的常驻分节不受它影响（面板永远可达，不会把自己锁在外面）。
+      syncSidebarEntry()
+
+      /**
+       * 一级设置分节（`settings.section`）：完整面板常驻于 设置 → 分节列表。
+       * 槽位契约（官方 d.ts）：id = 分节键、order = 导航位置、label = 注册方本地化文案、
+       * 内容组件 + inject 面由注册方自带。order 的标定读数与"agent预设下方"的对位
+       * 见 SETTINGS_SECTION_ORDER 的文档。
+       */
+      ctx.slots.inject('settings.section', () => {
+        try {
+          const unregister = ctx.slots.register({
+            name: 'settings.section',
+            id: PANEL_ID,
+            order: SETTINGS_SECTION_ORDER,
+            label: () => zh.title,
+            locale: NS,
+            inject: () => buildPanelFace(),
+          }, MenuSettingsSection)
+          return () => { unregister() }
+        } catch (error) {
+          // 分节注册失败绝不拖垮挂载（面板仍在侧栏/主区可达）；失败本身要留痕。
+          console.error('[theme-gallery] could not register the settings section:', error)
+          return () => {}
+        }
+      })
 
       /* ---------------- mood greeting seat ----------------
        *

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-theme-gallery",
-  "version": "0.5.0",
-  "description": "A theme gallery for DeepSeek Harness (DSH): JSON-defined skins with full-screen coverage and sidebar scenery, a 15-swatch palette-picker card, a pet-widget card (7 registry-driven pets playing by the chat input), and a mood-greeting card (a scrolling greeting on the title bar that rotates every 35 minutes), switched from the panel under the sidebar's Plugins icon — adding skins needs no code change",
+  "version": "0.6.0",
+  "description": "A theme gallery for DeepSeek Harness (DSH): JSON-defined skins with full-screen coverage and sidebar scenery, a 15-swatch palette-picker card, a pet-widget card (7 registry-driven pets playing by the chat input), a mood-greeting card (a scrolling greeting on the title bar that rotates every 35 minutes), and a menu-collapse card that moves the panel entry into Settings, switched from the panel under the sidebar's Plugins icon — adding skins needs no code change",
   "author": "renjie2026 (https://github.com/renjie2026)",
   "license": "MIT",
   "repository": {
@@ -39,6 +39,7 @@
       "platform": "web",
       "inject": [
         "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-theme"
       ]
     }
@@ -98,6 +99,7 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
     "@deepseek-ai/dsh-client-store": "*",
+    "@deepseek-ai/dsh-client-ui-layout": "*",
     "@deepseek-ai/dsh-client-ui-slots": "*",
     "@deepseek-ai/dsh-client-ui-theme": "*"
   },