dsh-theme-gallery 0.1.2 → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 renjie2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,8 @@
 # dsh-theme-gallery
 
+[![npm version](https://img.shields.io/npm/v/dsh-theme-gallery.svg)](https://www.npmjs.com/package/dsh-theme-gallery)
+[![license](https://img.shields.io/github/license/renjie2026/dsh-theme-gallery.svg)](https://github.com/renjie2026/dsh-theme-gallery/blob/main/LICENSE)
+
 给 DeepSeek Harness 的**主题画廊**：一个插件 + 一堆 JSON 皮肤。装一次，拿到全部主题；加皮肤**不用改代码、不用重启、不用重新装包**。
 
 | 你想要 | 怎么做 |
@@ -84,22 +87,27 @@ const CUBES = [light, dark, system]
 
 ### 三种安装方式
 
-**① 下载构建产物（推荐，零构建授权）**
+**① 用包名安装（推荐）** —— 包已发布到 npm：<https://www.npmjs.com/package/dsh-theme-gallery>
 
-1. 到 [Releases](https://github.com/renjie2026/dsh-theme-gallery/releases/latest) 下载 `dsh-theme-gallery-<版本>.tgz`
-2. **设置 → 插件 → 添加插件** → 粘贴该文件的**完整路径**
-3. **重启应用**
-4. 左侧栏底部出现 **主题皮肤** 入口（**不在**「设置 → 通用 → 外观」里，原因见下文），
+1. **设置 → 插件 → 添加插件** → 填 **`dsh-theme-gallery`**
+2. **重启应用**
+3. 左侧栏底部出现 **主题皮肤** 入口（**不在**「设置 → 通用 → 外观」里，原因见下文），
    当前三个主题：山青婷彩 / 梦海游鱼 / 深色
 
-**② 用包名安装**（需要本包已发布到 npm；桌面版在「添加插件」里直接填包名即可）
+Web / CLI profile 用官方 CLI 装同一个包：
 
 ```sh
 dsh plugin --profile web add dsh-theme-gallery
 ```
 
 > 桌面版的 profile 由 Electron 独占，`dsh plugin --profile desktop …` 会被拒绝 ——
-> 桌面用户请走上面的界面，这条 CLI 写法适用于 Web / CLI profile。
+> 桌面用户请走上面的界面。
+
+**② 下载构建产物**（不经过 npm 的等价方式，零构建授权）
+
+1. 到 [Releases](https://github.com/renjie2026/dsh-theme-gallery/releases/latest) 下载 `dsh-theme-gallery-<版本>.tgz`
+2. **设置 → 插件 → 添加插件** → 粘贴该文件的**完整路径**
+3. **重启应用**
 
 **③ 用仓库地址安装**（`github:renjie2026/dsh-theme-gallery`，拉的是**源码**，不推荐）
 

package/lib/client.js

@@ -1118,22 +1118,36 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Whether the gallery shows its diagnostic line.
+     * Where the debug switch is remembered.
      *
-     * Opt-in through the URL hash — `#theme-gallery-debug` — so the page stays
-     * clean in normal use while the one tool that actually located the token and
-     * presenter faults stays one reload away. From outside the app, "selected but
-     * nothing changed" cannot be split into "not registered", "not selected",
-     * "registered with broken tokens", or "painted over by our own CSS"; this line
-     * splits it by showing what the theme SERVICE believes next to what the
-     * document actually resolves.
-     * @returns true when the debug line should render.
+     * A localStorage flag in addition to the URL fragment, because this plugin
+     * ships as a package inside the desktop app: there is no address bar to add
+     * `#theme-gallery-debug` to, so DevTools is the way in.
+     */
+    const DEBUG_KEY = 'theme-gallery:debug'
+
+    /**
+     * Whether the gallery shows its diagnostic detail lines.
+     *
+     * The raw readings — token counts, geometry, hit tests, the attempt log — are
+     * for whoever is debugging, not for whoever is picking a skin, and this is a
+     * shipped package. So they are opt-in, through either switch:
+     *
+     *   DevTools console:  localStorage.setItem('theme-gallery:debug', '1')
+     *   …or a URL with      #theme-gallery-debug
+     *   turn it off:       localStorage.removeItem('theme-gallery:debug')
+     *
+     * The switch gates DETAIL, never bad news: a line that reports a problem prints
+     * whether or not it is on (see `sceneryLineIsWarning`), because "没有报错" and
+     * "没有观测到报错" have been confused in this project before.
+     * @returns true when the detail lines should render.
      */
     function debugEnabled() {
       try {
-        return typeof window !== 'undefined'
+        if (typeof window !== 'undefined'
           && typeof window.location?.hash === 'string'
-          && window.location.hash.includes('theme-gallery-debug')
+          && window.location.hash.includes('theme-gallery-debug')) return true
+        return typeof window !== 'undefined' && window.localStorage?.getItem(DEBUG_KEY) === '1'
       } catch {
         return false
       }
@@ -1211,12 +1225,15 @@ window.__ModuleLoader__.load({
     /**
      * The one-line scenery status shown on the panel.
      *
-     * Deliberately unconditional during bring-up, and deliberately dumb: it prints
-     * the report whatever it says. The previous revision only spoke when a
-     * self-check considered something wrong, so a check that passed while the
-     * scenery was still invisible produced **silence** — the worst possible output
-     * for a diagnostic. Printing the numbers always means the reader sees the
-     * geometry even when the code's opinion of it is wrong.
+     * Deliberately dumb: it prints the report whatever it says. An earlier
+     * revision only spoke when a self-check considered something wrong, so a check
+     * that PASSED while the scenery was still invisible produced **silence** — the
+     * worst possible output for a diagnostic. Keeping the numbers means the reader
+     * sees the geometry even when the code's opinion of it is wrong.
+     *
+     * It was unconditional while the scenery was being brought up; now that the
+     * package is public the RENDER SITE decides: routine reports wait for
+     * `debugEnabled()`, while warnings and errors always print.
      * @param selected - the preference the page is showing as selected.
      * @returns the line, or null when the active theme asks for no scenery.
      */
@@ -1231,6 +1248,20 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * Whether the scenery line reports a problem rather than a routine pass.
+     *
+     * The line has three shapes: `装饰自检通过 · …` (routine), `⚠ <warning> · …`,
+     * and `装饰自检失败: …`. Only the first may hide behind the debug switch — a
+     * failure has to reach the person looking at the panel without them knowing
+     * that a switch exists.
+     * @param line - the scenery line.
+     * @returns true when the line carries a warning or an error.
+     */
+    function sceneryLineIsWarning(line) {
+      return typeof line === 'string' && (line.startsWith('⚠') || line.includes('失败'))
+    }
+
     /**
      * Render the scenery report as one line.
      * @returns the report text.
@@ -2879,6 +2910,9 @@ window.__ModuleLoader__.load({
           ],
         })
       }
+      // Detail lines are opt-in; a line that reports a problem is not detail.
+      const scenery = sceneryLine(selected)
+      const showScenery = scenery !== null && (debugEnabled() || sceneryLineIsWarning(scenery))
       return jsxs('div', {
         className: 'tg-page',
         children: [
@@ -2891,16 +2925,15 @@ window.__ModuleLoader__.load({
             ],
           }),
           debugEnabled() ? jsx('div', { className: 'tg-debug', children: themeDiagnostics(selected) }) : null,
-          // Unconditional while the scenery is being brought up: when the active
-          // skin's decorations are not on screen, the reason has to reach the person
-          // looking at it. Shows nothing once the report says the layer is drawn and
-          // inside the column.
-          sceneryLine(selected) === null
-            ? null
-            : jsx('div', {
+          // Routine reports wait for the debug switch; warnings and errors print
+          // regardless — when the active skin's decorations are missing, the reason
+          // has to reach the person looking at the panel.
+          showScenery
+            ? jsx('div', {
               className: `tg-debug${ambientWarning(selected) === null ? '' : ' tg-warn'}`,
-              children: sceneryLine(selected),
-            }),
+              children: scenery,
+            })
+            : null,
           jsx('div', {
             className: 'tg-grid',
             children: ids.map((id) => jsx(ThemeCard, {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-theme-gallery",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "A community theme gallery for DeepSeek Harness (DSH): JSON-defined skins with full-screen coverage and ported sidebar scenery, switched from the plugin's own sidebar panel — adding skins needs no code change",
-  "author": "renjie2026 <renjie330@163.com> (https://github.com/renjie2026)",
+  "author": "renjie2026 (https://github.com/renjie2026)",
   "license": "MIT",
   "repository": {
     "type": "git",