dsh-tui-theme 0.2.0 → 0.2.2

package/README.md

@@ -23,6 +23,20 @@
 
 > 小知识：`pink-day` 的 `text` 写成 `rgb(61,43,51)` 而非 hex——宿主按 `text` 墨色亮度自动判定主题深浅，且只认 `rgb()` 格式。
 
+## 截图
+
+实测于 dsh-tui 0.9.0：
+
+| 昼樱 `pink-day` | 夜樱 `pink-night` |
+| :---: | :---: |
+| ![pink-day 主题界面](docs/screenshots/pink-day.png) | ![pink-night 主题界面](docs/screenshots/pink-night.png) |
+
+`/settings` 里的 pink-theme 区块（跟随终端背景 / 花符 / 时钟 / 轮数，保存即时生效）：
+
+![pink-theme 设置区块](docs/screenshots/settings.png)
+
+> 图中底栏上下文进度条的蓝色分段与 ❯ 提示符是宿主硬编码的，见下文[宿主限制](#受宿主限制目前无法定制的部分)。
+
 ## 自动跟随终端背景
 
 设置里的“跟随终端背景”开启后（本部署默认开启）：
@@ -35,11 +49,14 @@
 ## 安装
 
 ```sh
-# 方式一：本地路径（开发/自用）
-dsh plugin --profile dsh-tui add -w /path/to/dsh-tui-theme
+# 方式一：从 npm（已发布）
+dsh plugin --profile dsh-tui add -w dsh-tui-theme
 
-# 方式二：从 GitHub（发布后）
-dsh plugin --profile dsh-tui add -w github:<你的用户名>/dsh-tui-theme
+# 方式二：从 GitHub
+dsh plugin --profile dsh-tui add -w github:xiaoxiaohaigui/dsh-tui-theme
+
+# 方式三：本地路径（开发/自用）
+dsh plugin --profile dsh-tui add -w /path/to/dsh-tui-theme
 ```
 
 重启 dsh-TUI 后插件自动把三套主题复制进 `~/.dsh-tui/themes/`（**仅缺失时复制，绝不覆盖你已有的同名文件**），然后：
@@ -65,7 +82,19 @@ dsh plugin --profile dsh-tui add -w github:<你的用户名>/dsh-tui-theme
 
 三项装饰全关时状态行整体消失。另有仅 profile 层的开关（`cordis.patch.yml`，不出现在 /settings）：`autoInstallThemes`、`statusEnabled`。
 
-> 已知宿主限制：底栏的上下文进度条分段色（蓝色系）与空余段配色是宿主硬编码的，主题与插件均无法覆盖；自定义浅色主题（pink-day）会拿到深色空余段配色（宿主按 `themeName === 'light'` 判断，不识别自定义浅色主题）。这需要上游修复。
+## 受宿主限制、目前无法定制的部分
+
+以下元素的颜色/形态由 dsh-TUI 宿主**硬编码**，不读取任何主题键，主题 JSON 与插件接缝都覆盖不到（dsh-TUI 0.9.0 实测）：
+
+| 元素 | 现状 | 位置（宿主源码） |
+| --- | --- | --- |
+| 输入框 ❯ 提示符 | 默认态无颜色参数（终端默认前景色，模型工作时变暗）；最高推理档充能动画用**写死的蓝色 ramp**（深色端 `#82B9FF` / 浅色端 `#1E5FEB`） | `EffortChargeGlyph.tsx`、`trajectory/effortIgnition.ts` |
+| 底栏上下文进度条分段色 | system / prompt / assistant / thinking / tools 五段为**写死的藏青→品牌蓝系**（`#22305F`→`#5A7CFF`），永远不随主题变化 | `screens/StatusMetrics.ts` |
+| 进度条空余段配色 | 宿主按 `themeName === 'light'` **字符串比较**取浅色配色——自定义浅色主题（如 pink-day）不等于 `'light'`，会拿到深色空余段，在浅色终端上偏深 | `screens/StatusLine.tsx` |
+| 状态行文字颜色 | 插件状态行（tuiStatus）由宿主统一以**无色 + 终端 dim** 渲染，插件无法指定颜色（✿ 行因此继承终端默认前景色） | `screens/Chat.tsx` |
+| 主界面组件与布局 | 顶栏像素鲸鱼、工具卡、输入框等宿主组件不可被插件替换或改布局——平台规则（内建优先，无组件替换接缝）；主题能碰的只有颜色层 | 宿主架构约定 |
+
+这些都需要上游 dsh-TUI 修改（例如：把充能色/进度条分段色接入主题键、空余段判断改用 `isLightThemeActive()`）。上游修复前，任何社区主题包都受同样约束。
 
 ## 卸载
 
@@ -86,5 +115,5 @@ npm run verify               # 沙盒测试（临时 HOME + 伪造 TTY，不碰
 
 ## 兼容性
 
-- dsh-TUI 的 `dsh-tui-extensions` 扩展面（tuiStatus / tuiSettingsSections）；旧版 profile 缺这些服务时插件自动退化为“仅安装主题”，不会报错。
+- **dsh-TUI 版本下限：0.8.8**（全功能，含状态行与设置面板；0.9.0 实测）。更旧的宿主缺 `dsh-tui-extensions` 扩展面时，插件自动降级为“仅安装三套主题 + 背景跟随”，不报错。
 - Node `^22.19 || >=24`，纯 ESM，MIT。

package/lib/types/autoTheme.d.ts

@@ -6,9 +6,9 @@
  * ride it. This module gives pink-day/pink-night the same behavior from the
  * plugin side:
  *
- * - at apply() (which runs before the React tree mounts and reads
- *   ~/.dsh-tui/theme.json), the cached detection writes the resolved theme
- *   name into the pref synchronously — always in time for this boot;
+ * - the caller wires this from the settings inject callback (see index.ts):
+ *   that fires before the React tree mounts and reads ~/.dsh-tui/theme.json,
+ *   so the cached detection still decides this boot;
  * - a fresh OSC 11 query then refreshes the cache for the next boot. The
  *   very first enabling (or a system flip between boots) lands one boot
  *   late — the same cadence as the host's own "re-select auto or restart".

package/lib/types/autoTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autoTheme.d.ts","sourceRoot":"","sources":["../../src/autoTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAgBH,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX;AAgCD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGxE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,WAA4B,EAC3C,KAAK,GAAE,MAAM,CAAC,UAA0B,EACxC,YAAY,GAAE,OAAO,UAAuB,GAC3C,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAmD9B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,IAAI,CAYN"}
+{"version":3,"file":"autoTheme.d.ts","sourceRoot":"","sources":["../../src/autoTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX;AA4BD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGxE;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQrE;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAM,CAAC,WAA4B,EAC3C,KAAK,GAAE,MAAM,CAAC,UAA0B,EACxC,YAAY,GAAE,OAAO,UAAuB,GAC3C,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAmD9B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,IAAI,CAYN"}

package/lib/types/autoTheme.js

@@ -6,9 +6,9 @@
  * ride it. This module gives pink-day/pink-night the same behavior from the
  * plugin side:
  *
- * - at apply() (which runs before the React tree mounts and reads
- *   ~/.dsh-tui/theme.json), the cached detection writes the resolved theme
- *   name into the pref synchronously — always in time for this boot;
+ * - the caller wires this from the settings inject callback (see index.ts):
+ *   that fires before the React tree mounts and reads ~/.dsh-tui/theme.json,
+ *   so the cached detection still decides this boot;
  * - a fresh OSC 11 query then refreshes the cache for the next boot. The
  *   very first enabling (or a system flip between boots) lands one boot
  *   late — the same cadence as the host's own "re-select auto or restart".
@@ -19,7 +19,6 @@
  * @module dsh-tui-theme/autoTheme
  */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
 /** The pair this feature switches between (light terminal → day). */
 const LIGHT_THEME = 'pink-day';
@@ -29,9 +28,6 @@ const QUERY = '\x1b]11;?\x07';
 // ST terminated.
 const REPLY = /\x1b\]11;rgb:([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})(?:\x07|\x1b\\)/;
 const DETECT_TIMEOUT_MS = 400;
-function homeDir() {
-    return homedir() || process.env.USERPROFILE || process.env.HOME || '';
-}
 function prefPath(dir) {
     return join(dir, 'theme.json');
 }

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEjF,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,eAAe,CAAA;AAUpC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAOrC,CAAA;AAiBF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAsC7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEjF,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,eAAe,CAAA;AAUpC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAOrC,CAAA;AAwBF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAgE7D"}

package/lib/types/index.js

@@ -44,6 +44,12 @@ const DEFAULTS = {
     showClock: true,
     showTurns: true,
 };
+/**
+ * Backstop delay for the cordis-layer follow decision on hosts without a
+ * settings service (see apply). Stays under the host's own 300ms pre-mount
+ * settings gate so the pref write still lands before first paint.
+ */
+const FOLLOW_FALLBACK_MS = 150;
 /**
  * Wire the pink theme plugin.
  * @param ctx - Cordis context (the plugin's own activation).
@@ -69,18 +75,45 @@ export function apply(ctx, config = {}) {
             ctx.logger.warn(`dsh-tui-theme: could not install bundled theme "${file}"`);
         }
     }
-    // Background follow runs before the React tree mounts (which reads the
-    // theme pref), so the cached detection decides this boot.
-    if (cordis.followSystem) {
-        runFollowSystem(join(homeDir(), '.dsh-tui'), message => {
-            ctx.logger.info(`dsh-tui-theme: ${message}`);
-        });
-    }
     // The /settings user layer (settings.yaml) overrides the cordis layer and
     // lands live through scope.watch; both override the hardcoded defaults.
     let effective = cordis;
+    // Background follow honors the MERGED knob (cordis layer overlaid by the
+    // /settings user layer), so the decision cannot be taken synchronously at
+    // apply(): the user layer is only readable once the settings service
+    // answers. The settings callback still fires before the host's React tree
+    // mounts (the host gates its own mount on the same service, probed
+    // against 0.9.0), so the pref write decides this boot exactly like a sync
+    // write would, and toggling followSystem in /settings re-decides live.
+    let followActive;
+    const dataDir = join(homeDir(), '.dsh-tui');
+    const startFollow = () => {
+        runFollowSystem(dataDir, message => {
+            ctx.logger.info(`dsh-tui-theme: ${message}`);
+        });
+    };
     registerPinkSettings(ctx, cordis, doc => {
         effective = { ...cordis, ...doc };
+        if (effective.followSystem !== followActive) {
+            followActive = effective.followSystem;
+            if (followActive) {
+                startFollow();
+            }
+            else {
+                ctx.logger.info('dsh-tui-theme: follow: disabled, manual /theme choice preserved');
+            }
+        }
     });
+    // Degradation backstop for hosts that never provide a settings service:
+    // the inject callback never fires there, so the cordis-layer decision
+    // applies instead. The delay lets any pending service registration (and
+    // its callback) land first — it no-ops once followActive is settled, and
+    // stays inside the host's own 300ms pre-mount settings gate either way.
+    setTimeout(() => {
+        if (followActive === undefined && cordis.followSystem) {
+            followActive = true;
+            startFollow();
+        }
+    }, FOLLOW_FALLBACK_MS);
     startStatusLine(ctx, () => effective);
 }

package/lib/types/settingsSection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settingsSection.d.ts","sourceRoot":"","sources":["../../src/settingsSection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GACpC,IAAI,CAuCN"}
+{"version":3,"file":"settingsSection.d.ts","sourceRoot":"","sources":["../../src/settingsSection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAcD;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GACpC,IAAI,CA2CN"}

package/lib/types/settingsSection.js

@@ -46,8 +46,12 @@ export function registerPinkSettings(ctx, cordis, onDoc) {
             }
             onDoc(clean);
         };
-        emit(scope.get());
-        scope.watch(emit);
+        // Own the watcher on the inject-scoped ledger so it survives exactly as
+        // long as this activation (scope.watch's disposer is otherwise leaked).
+        settingsCtx.effect(() => {
+            emit(scope.get());
+            return scope.watch(emit);
+        });
     });
     ctx.inject(['tuiSettingsSections'], sectionsCtx => {
         const sections = sectionsCtx

package/lib/types/statusLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusLine.d.ts","sourceRoot":"","sources":["../../src/statusLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;AAoBrD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,GAAG,IAAI,CAoDvF"}
+{"version":3,"file":"statusLine.d.ts","sourceRoot":"","sources":["../../src/statusLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,MAAM,WAAW,aAAa;IAC5B,2EAA2E;IAC3E,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAA;AAoBrD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,GAAG,IAAI,CAsDvF"}

package/lib/types/statusLine.js

@@ -38,12 +38,14 @@ export function startStatusLine(ctx, getEffective) {
             try {
                 const eff = getEffective();
                 const parts = [];
-                if (eff.showGlyph)
-                    parts.push(GLYPH);
-                if (eff.showClock)
-                    parts.push(clockText());
-                if (eff.showTurns && current !== undefined) {
-                    parts.push(`${turns.get(current) ?? 0}✦`);
+                if (eff.statusEnabled) {
+                    if (eff.showGlyph)
+                        parts.push(GLYPH);
+                    if (eff.showClock)
+                        parts.push(clockText());
+                    if (eff.showTurns && current !== undefined) {
+                        parts.push(`${turns.get(current) ?? 0}✦`);
+                    }
                 }
                 const text = parts.join(' · ');
                 // The trailing identity must be the inject-scoped context (the same

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tui-theme",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Sakura-pink themes for dsh-TUI with terminal-background auto-follow (pink-day/pink-night), a blossom status line, and a /settings section. No shortcuts, no commands.",
   "type": "module",
   "main": "lib/types/index.js",
@@ -16,6 +16,7 @@
   "files": [
     "lib",
     "themes",
+    "docs",
     "cordis.patch.yml"
   ],
   "engines": {