@nonamelego/dsh-catppuccin 0.5.10-beta.0 → 0.6.0

package/README.en.md

@@ -19,29 +19,39 @@
 
 ## Contents
 
-- [Introduction](#introduction)
-- [Features](#features)
-- [Previews](#previews)
-- [Installation](#installation)
-- [Usage](#usage)
-- [Glassmorphism](#glassmorphism)
-- [Compatibility, permissions and failure bounds](#compatibility-permissions-and-failure-bounds)
-- [Development](#development)
-- [🙋 FAQ](#-faq)
-- [💝 Credits](#-credits)
+<p align="center">
+	<a href="#introduction">Introduction</a> ·
+	<a href="#features">Features</a> ·
+	<a href="#previews">Previews</a> ·
+	<a href="#installation">Installation</a> ·
+	<a href="#usage">Usage</a> ·
+	<a href="#glassmorphism">Glassmorphism</a> ·
+	<a href="#compatibility-permissions-and-failure-bounds">Compatibility</a> ·
+	<a href="#development">Development</a> ·
+	<a href="#-faq">🙋 FAQ</a> ·
+	<a href="#-credits">💝 Credits</a>
+</p>
 
 <p align="center">
 	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/combined.png" width="100%" alt="DeepSeek Harness under the four Catppuccin flavours"/>
-	<br/><br/>
+</p>
+
+<details>
+<summary>🪟 Glass skin (Mica mode) · Latte &amp; Mocha</summary>
+
+<p align="center">
 	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-combined.png" width="100%" alt="Glass skin · Latte & Mocha"/>
 </p>
 
+</details>
+
 ## Introduction
 
 A [Catppuccin](https://github.com/catppuccin/catppuccin) theme plugin for
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — one package that fits
 the **Web GUI** (`dsh web`), the **desktop shells** (the official Electron `apps/desktop` and the
-community DSH Desktop — both on the same `desktop` profile) and **dsh-TUI** alike: full recolouring plus a
+community DSH Desktop — both on the same `desktop` profile) and
+**[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)** alike: full recolouring plus a
 glass skin on Web / Desktop, and the four official theme palettes auto-synced to the TUI.
 
 It ships all four Catppuccin flavours — **Latte**, **Frappé**, **Macchiato**, **Mocha** —
@@ -75,8 +85,9 @@ Catppuccin theme automatically.
 - 🔄 **Update check**: one-click "Check for updates" in Settings compares the latest npm
   version and gives you a copyable upgrade command; **auto-check is on by default** (once at
   startup, then every 6 hours) and the release channel switches between stable and beta
-- 💻 **dsh-TUI terminal themes**: one command installs into dsh-TUI; the four themes sync to
-  `~/.dsh-tui/themes/` automatically (see [Installation · dsh-TUI](#dsh-tui-terminal-themes))
+- 💻 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) terminal themes**: one command installs into
+  dsh-TUI; the four themes sync to `~/.dsh-tui/themes/` automatically
+  (see [Installation · dsh-TUI](#dsh-tui-terminal-themes))
 
 ## Previews
 
@@ -170,7 +181,8 @@ plugin UI, while the **community shell** runs the same command with
 
 ### dsh-TUI (terminal) themes
 
-The same package covers the TUI. Install it into the dsh-tui profile:
+This section covers **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)**, a third-party terminal
+front end (install it first). The same package covers the TUI — install it into the dsh-tui profile:
 
 ```sh
 dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
@@ -213,6 +225,11 @@ installing, launch `dsh --profile dsh-tui` and pick the theme with `/theme` —
 4. Choosing **Follow system** reverts to the official theme — it restores the preference
    you had before enabling Catppuccin (light / dark / follow system) instead of forcing a reset.
 
+> **Second entrance**: open this plugin's own card on the **Plugins** page and the middle of
+> its detail page shows the **same settings** (Catppuccin theme / Glass / Check for updates) —
+> both read and write one set of preferences, so either place works. That area comes from the
+> host's plugin detail page (`0.2.0-rc.2` and later); older versions do not have it.
+
 ### Other options in the Catppuccin row
 
 - **Code highlight style**: default / **italic comments** — affects only the shiki colours used
@@ -412,6 +429,19 @@ link debugging; state-contract migration rules are in
   point** — **remove the plugin in its plugin UI, then enter the package name
   `@nonamelego/dsh-catppuccin` again to reinstall**, and restart the app. The two routes are not
   interchangeable; see the table under Install → Desktop.
+- **Q: "I ran the upgrade but the version did not change (the desktop app still shows the old one)?"**
+  A: Most likely pnpm 11's built-in **minimum release age** (`minimumReleaseAge`, default **24 hours**)
+  silently filtered the fresh release out: `pnpm add` resolves to the **previous** version inside the
+  window (installing `@beta` on release day lands on the previous beta) while the UI keeps showing the
+  target version. Three ways out, pick one:
+  ① **name the exact version** (easiest) — `@nonamelego/dsh-catppuccin@0.5.10-beta.0`; pnpm then records
+  that version in the profile's `minimumReleaseAgeExclude` automatically;
+  ② give this package a **whole-package exemption** in the profile's `pnpm-workspace.yaml` (configure once,
+  every future beta installs immediately): `minimumReleaseAgeExclude:` then a new line with
+  `  - '@nonamelego/dsh-catppuccin'`; ③ wait until the release is 24 hours old.
+  To confirm: check `version` in the profile's
+  `node_modules/@nonamelego/dsh-catppuccin/package.json` and the `specifier:` for that package in
+  `pnpm-lock.yaml`.
 
 ## 💝 Credits
 

package/README.md

@@ -17,30 +17,39 @@
 
 ## 目录
 
-- [简介](#简介)
-- [特性](#特性)
-- [预览](#预览)
-- [安装](#安装)
-- [使用](#使用)
-- [玻璃拟态（Glassmorphism）](#玻璃拟态glassmorphism)
-- [兼容性、权限与失败边界](#兼容性权限与失败边界)
-- [开发](#开发)
-- [🙋 常见问题](#常见问题)
-- [💝 致谢](#致谢)
+<p align="center">
+	<a href="#简介">简介</a> ·
+	<a href="#特性">特性</a> ·
+	<a href="#预览">预览</a> ·
+	<a href="#安装">安装</a> ·
+	<a href="#使用">使用</a> ·
+	<a href="#玻璃拟态glassmorphism">玻璃拟态</a> ·
+	<a href="#兼容性权限与失败边界">兼容性</a> ·
+	<a href="#开发">开发</a> ·
+	<a href="#-常见问题">🙋 常见问题</a> ·
+	<a href="#-致谢">💝 致谢</a>
+</p>
 
 <p align="center">
 	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/combined.png" width="100%" alt="Catppuccin 四主题下的 DeepSeek Harness"/>
-	<br/><br/>
+</p>
+
+<details>
+<summary> 关键字高亮 · Latte &amp; Mocha</summary>
+
+<p align="center">
 	<img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-combined.png" width="100%" alt="玻璃质感 · Latte & Mocha"/>
 </p>
 
+</details>
+
 ## 简介
 
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的
 [Catppuccin](https://github.com/catppuccin/catppuccin) 主题插件——一个包同时适配
 **Web GUI**（`dsh web`）、**桌面版**（官方 Electron 壳 `apps/desktop` 与社区 DSH Desktop，
-共用 `desktop` profile）与 **dsh-TUI** 终端：Web / 桌面端做全界面换色与玻璃质感，
-TUI 端自动同步四套官方主题色板。
+共用 `desktop` profile）与 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)** 终端：
+Web / 桌面端做全界面换色与玻璃质感，TUI 端自动同步四套官方主题色板。
 
 它内置 Catppuccin 的四个主题——**Latte**、**Frappé**、**Macchiato**、**Mocha**——
 把整个界面的配色都换成对应的 Catppuccin 色板；并在 **设置 → 常规 → 外观**
@@ -68,7 +77,7 @@ Catppuccin 主题。
   纯色背景跟随主题底色——内容滚入视口边缘时柔化穿过，层次更立体
 - 🎨 玻璃配色自动跟随当前 Catppuccin 主题
 - 🔄 **检查 Catppuccin 插件更新**：设置页一键检测本插件（dsh-catppuccin）在 npm 上的最新版本，发现新版直接给出可复制的升级命令；**默认开启自动检查**（启动后一次 + 每 6 小时），更新渠道可选稳定版 / Beta
-- 💻 **dsh-TUI 终端主题**：一条安装命令装进 dsh-TUI，四套主题自动同步到 `~/.dsh-tui/themes/`，见[安装 · dsh-TUI](#dsh-tui-终端版主题)
+- 💻 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) 终端主题**：一条安装命令装进 dsh-TUI，四套主题自动同步到 `~/.dsh-tui/themes/`，见[安装 · dsh-TUI](#dsh-tui终端版主题)
 
 ## 预览
 
@@ -151,9 +160,10 @@ dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
 桌面版同理，但按上面的表走：**官方壳**在插件界面里直接填 Git 地址；**社区壳**把这条命令的
 `dsh plugin --profile web add …` 换成 `dsh plugin --profile desktop add …`。
 
-### dsh-TUI（终端版）主题
+### **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)**（终端版）主题
 
-与 Web GUI 插件同一个包。用标准的插件安装命令装进 dsh-tui profile：
+本节针对第三方终端前端 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)**（需先自行装好它）。
+与 Web GUI 插件同一个包，用标准的插件安装命令装进 dsh-tui profile：
 
 ```sh
 dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
@@ -187,6 +197,10 @@ dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-th
 4. 选择 **跟随系统** 则回退到官方主题——会还原你启用 Catppuccin 之前
    的官方偏好（浅色 / 深色 / 跟随系统），而不是强制重置。
 
+> **另一处入口**：在 **插件页**（Plugins）点开本插件自己的卡片，中间会出现**同一组设置**
+> （Catppuccin 主题 / 玻璃质感 / 检查更新）——两处读写的是同一份偏好，改哪边都一样。
+> 该区域由宿主（≥ `0.2.0-rc.2` 的插件详情页）提供，更旧的版本上没有。
+
 ### Catppuccin 行里的其它选项
 
 - **代码高亮风格**：默认 / **注释斜体**（italic-comments）——只影响代码块与 diff 的 shiki 高亮配色。
@@ -376,6 +390,16 @@ CHANGELOG 草稿由 `pnpm changelog:gen` 从 conventional 提交里产出。
   DSH 终端里用同一条命令（把 `web` 换成 `desktop`）；**官方壳没有升级入口**——要在插件界面里
   **先删掉本插件，再重新填一遍包名 `@nonamelego/dsh-catppuccin` 安装**，然后重启应用。
   两种方式不通用，详见上面「安装 → 桌面版」的对照表。
+- Q: **_"升级命令跑了，但版本没变（桌面版重启后也还是旧的）？"_**\
+  A: 大概率是 pnpm 11 内置的**最小发布年龄**（`minimumReleaseAge`，默认 **24 小时**）把刚发布的版本
+  静默过滤掉了：`pnpm add` 会解析到**上一个**符合窗口的版本（例如新 beta 发布当天去装 `@beta`，
+  实际装到的仍是上一个 beta），而界面显示的却是目标版本。三条出路，任选其一：
+  ① **指名精确版本**（最省事）——`@nonamelego/dsh-catppuccin@0.5.10-beta.0`，pnpm 会自动把该版本
+  写进当前 profile 的 `minimumReleaseAgeExclude`；② 在当前 profile 的 `pnpm-workspace.yaml` 里
+  给本包**整包豁免**（一次配置，之后每个新 beta 都能立刻装）：
+  `minimumReleaseAgeExclude:` 换行再加 `  - '@nonamelego/dsh-catppuccin'`；③ 等版本发布满 24 小时。
+  判断方法：看 profile 里 `node_modules/@nonamelego/dsh-catppuccin/package.json` 的 `version`,
+  以及 `pnpm-lock.yaml` 里那个包的 `specifier:`。
 
 ## 💝 致谢