dsh-tui-theme 0.6.1 → 0.7.1

package/README.md

@@ -6,17 +6,18 @@
 | --- | --- | --- |
 | **三套粉色主题** | 主题运行时（dsh-TUI ≥ 0.10.0）/ 静态资产（旧宿主） | `pink-night` 夜樱 / `pink-day` 昼樱 / `pink-ansi` 樱·ANSI；新宿主优先即时注册，服务晚到时短暂回退并清理本次文件，旧宿主使用 `~/.dsh-tui/themes/` |
 | **缓存背景跟随** | 设置 + 本地缓存 | 可选地应用已有 `theme-follow.json` 的昼樱/夜樱结果；不直接读取终端输入或发送 OSC 查询 |
-| **花符状态行** | `tuiStatus` | 输入框上方一行小装饰：✿ · 时钟 · 实时轮数（默认仅粉主题下显示） |
-| **设置面板** | `tuiSettingsSections` | `/settings` 里一个可编辑区块，改完即时生效 |
+| **花符状态行** | `tuiStatus` | 输入框上方一行小装饰：✿ · 时钟 · 实时轮数（默认仅粉主题下显示）；dsh-TUI ≥ 0.10.1 经富状态视图按主题配色渲染，旧宿主为无色标量行 |
+| **设置面板** | `tuiSettingsSections` | `/settings` 里一个可编辑区块（背景跟随 / 状态行两组子页），改完即时生效 |
 | **屏幕提示** | `tuiToast`（dsh-TUI ≥ 0.10.0） | 背景跟随结果、主题文件自愈、旧文件遮蔽提醒各弹一行短提示；旧宿主自动静默降级 |
+| **旧文件清理** | `tuiDialogs`（dsh-TUI ≥ 0.9.3） | 检测到遮蔽旧主题文件时，额外提供一次性宿主确认对话框，确认后清理逐字节相同的副本；拒绝/忽略则不做任何改动 |
 
-**明确不做的事**：不注册快捷键、不注册/修改任何命令、不拦截输入、不追加会话事件、不注入 system prompt。卸载即无痕（可选删除主题文件）。
+**明确不做的事**：不注册快捷键、不注册/修改任何命令、不拦截输入、不追加会话事件、不注入 system prompt（`tuiDialogs` 是宿主托管的中性确认面板：宿主自渲染、宿主拥有键盘，插件只提交请求，不属于输入拦截）。卸载即无痕（可选删除主题文件）。
 
 ## 主题预览
 
 | 主题 | 基底 | 风格 |
 | --- | --- | --- |
-| `pink-night` 夜樱 | dark | 暗梅底、玫瑰粉强调，95 键全覆盖 |
+| `pink-night` 夜樱 | dark | 暗梅底、玫瑰粉强调，宿主 Theme 全键覆盖（0.10.x 为 73 语义键，旧键名经宿主别名映射兼容） |
 | `pink-day` 昼樱 | light | 象牙粉底、墨梅正文、柔和玫瑰强调（已通过宿主浅色身份判定） |
 | `pink-ansi` 樱·ANSI | dark-ansi | 16 色 ANSI 回退，品牌色映射到 magenta 系 |
 
@@ -62,7 +63,7 @@ dsh-TUI ≥ 0.10.0 上，跟随结果会以 toast 短提示呈现：真正改写
 | 主题文件损坏被自动修复 | ✿ 已修复损坏的主题文件：…（警告色） |
 | 旧版遗留的同名主题文件与内置版本完全相同 | ✿ … 与插件内置相同，删除后配色将随插件自动更新 |
 
-最后一条只针对与内置副本逐字节相同的文件——你手动调过色的文件永远不会被提及或删除。
+最后一条只针对与内置副本逐字节相同的文件——你手动调过色的文件永远不会被提及或删除。遮蔽场景还会在支持该接缝的宿主上（dsh-TUI ≥ 0.9.3）提供一次性确认对话框：确认后插件按同样的逐字节校验清理副本并以 toast 反馈结果，拒绝/忽略则一切维持现状。
 
 ## 安装
 
@@ -88,7 +89,7 @@ dsh plugin --profile dsh-tui add -w dsh-tui-theme@latest
 
 在 dsh-TUI ≥ 0.10.0 中，三套主题通过 `ctx.tuiThemes` 运行时注册：调色板随插件即时生效，正常挂载时不写入用户目录，主题选择器显示中文 `displayName`。若服务晚到，插件会先同步回退到静态路径，并在确认运行时服务后删除本次写入且仍未被改写的文件。旧宿主使用静态文件路径：插件只在主题文件缺失时复制，绝不覆盖你编辑过的 `~/.dsh-tui/themes/pink-*.json`。唯一的例外是已损坏的目标文件（无法解析为 JSON，例如安装中途中断留下的残文件）：插件会把它改名为 `<文件名>.corrupt-<时间戳>` 保留现场，再重新安装内置副本，记录一条警告，并在支持 toast 的宿主上弹一条屏幕提示。
 
-从旧宿主升级后，若希望改用运行时托管，请先备份并删除 `~/.dsh-tui/themes/pink-{night,day,ansi}.json`；插件不会自动删除用户文件。遗留文件若与内置副本完全相同，插件会在运行时托管确认时弹一条一次性提醒，指出哪些文件正在遮蔽配色更新。
+从旧宿主升级后，若希望改用运行时托管，请先备份并删除 `~/.dsh-tui/themes/pink-{night,day,ansi}.json`；插件不会自动删除用户文件。遗留文件若与内置副本完全相同，插件会在运行时托管确认时弹一条一次性提醒，并额外提供一次性确认对话框（宿主 `tuiDialogs` 面板）：确认删除则清理这些遮蔽副本，拒绝或忽略则不做任何改动；你手动调过色的文件永远不会被提及或删除。
 
 旧宿主重启 dsh-TUI 后插件会把三套主题复制进 `~/.dsh-tui/themes/`（**仅缺失时复制，绝不覆盖你已有的同名文件**）；0.10.0 及更新宿主则直接使用运行时注册，然后：
 
@@ -102,14 +103,16 @@ dsh plugin --profile dsh-tui add -w dsh-tui-theme@latest
 
 配置有三层，优先级：`/settings` 用户层 > `cordis.yml` 配置层 > 内置默认值。
 
-`/settings` 里找到 **pink-theme** 区块即可编辑：
+`/settings` 里找到 **pink-theme** 区块即可编辑（分「背景跟随」「状态行」两组子页）：
 
 | 字段 | 默认 | 说明 |
 | --- | --- | --- |
-| `followSystem` | `false` | 启动时应用上次保存的终端背景结果（昼樱 ↔ 夜樱）；插件不刷新缓存 |
-| `showGlyph` | `true` | 花符：开 = ✿ 开头，关 = 不显示 |
+| `followSystem` | `false` | 启动时应用上次保存的终端背景结果（昼樱 ↔ 夜樱）；插件不刷新缓存。开启时该字段会直接显示缓存状态，如 `on（缓存: light · 2026-09-12）` 或 `on（无缓存，启动时不动）` |
+| `showGlyph` | `true` | 花符开关：开 = 以花符开头，关 = 不显示 |
+| `statusGlyph` | `✿` | 花符字符（文本字段）：1–2 个显示单元、不接受控制字符，留空恢复默认 |
 | `showClock` | `true` | 显示 HH:MM 时钟 |
 | `showTurns` | `true` | 显示当前会话轮数（`N✦`，自本次启动起计） |
+| `statusSeparator` | `·` | 各段之间的分隔符（文本字段）：同花符字符的校验规则 |
 | `statusScope` | `pink-only` | 状态行展示：`pink-only` 仅樱花粉主题 / `all-themes` 所有主题 |
 
 三项装饰全关时状态行整体消失。另有仅 profile 层的开关（`cordis.patch.yml`，不出现在 /settings）：`autoInstallThemes`、`statusEnabled`。
@@ -123,9 +126,11 @@ dsh plugin --profile dsh-tui add -w dsh-tui-theme@latest
 | 输入框 ❯ 提示符 | 默认态无颜色参数（终端默认前景色，模型工作时变暗）；最高推理档充能动画用**写死的蓝色 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` |
+| 状态行文字颜色 | 旧路径标量状态行（`tuiStatus.set`）由宿主统一以**无色 + 终端 dim** 渲染；dsh-TUI ≥ 0.10.1 插件已改用 `tuiStatus.registerView` 富状态视图按主题配色渲染（✿ 品牌色 / 正文 text 色 / 分隔符 subtle 色，颜色取自生效主题文件，pink-ansi 为具名 ANSI 值），旧宿主自动回退标量路径（无色 + dim） | `screens/Chat.tsx`、`dsh-adapter/status.ts` |
 | 输入框块状光标 | 宿主挂载期间隐藏终端原生光标（`?25l`），输入框光标由应用以**反色字符**自绘（`<Text inverse>`），颜色即主题 text/background 的反色——OSC 12 光标色只能染到不可见的原生光标，插件无法给输入光标上色（辅助功能模式 `CLAUDE_CODE_ACCESSIBILITY=1` 下原生光标才可见） | `ink/components/App.tsx`、`components/PromptInput.tsx` |
 | 正文链接 | OSC 8 超链接默认**写死的 ANSI 蓝**（`chalk.blue`）；注释说明 wrap-ansi 无法跨 OSC 8 保留主题 RGB 色，故链接色不读主题键 | `cc/hyperlink.ts` |
+| 顶栏像素鲸鱼颜色 | 四色调色板（描边/身体/腹部/嘴）**写死**且模块加载时预渲染，不读取任何主题键——任何主题都无法改变鲸鱼配色 | `components/Whale.tsx` |
+| 顶栏文字色 | ✦ dsh-TUI 字标与欢迎语经 `claude`（0.10.1 起 `accent`）跟主题；`DEEPSEEK` 像素字主色与渐变结尾色分别跟 `claude` / `claudeBlue_FOR_SYSTEM_SPINNER`（0.10.1 起 `accent` / `activity`）；**`HARNESS` 像素字只有主色跟主题——渐变结尾色是宿主固定常量 `PALE`，不读任何主题键**，主题覆盖不到它的结尾段；两词的扫过高光（`FLASH`）同为宿主常量。另：宿主 `parseRGB` 只认 `rgb(r,g,b)` 格式，hex/ansi 值会静默回退固定品牌蓝（pink-ansi 因此顶栏仍为蓝色） | `components/LogoV2.tsx`、`components/bigfont.ts`、`components/shimmer.ts`、`components/Spinner/spinnerUtils.ts` |
 | 主界面组件与布局 | 顶栏像素鲸鱼、工具卡、输入框等宿主组件不可被插件替换或改布局——平台规则（内建优先，无组件替换接缝）；主题能碰的只有颜色层 | 宿主架构约定 |
 
 这些都需要上游 dsh-TUI 修改（例如：把充能色/进度条分段色接入主题键、空余段判断改用 `isLightThemeActive()`、给输入光标增加主题键）。上游修复前，任何社区主题包都受同样约束。
@@ -145,7 +150,7 @@ rm ~/.dsh-tui/theme-follow.json
 ## 开发
 
 ```sh
-npm install
+npm install --include=dev   # 见下方安装前提，本仓不提交 lockfile
 npm run build
 npm run verify
 npm run verify:package
@@ -154,11 +159,16 @@ DSH_TUI_SOURCE_ROOT=/path/to/dsh-TUI-source \
 npm run verify:host
 ```
 
-`verify:host` 默认使用开发依赖中的 dsh-TUI（当前为 0.10.0-beta.4）进行零配置验证；需要验证旧版或发布基线时，再显式指向同一版本的宿主 adapter 与源码。需要锁定版本时，额外设置 `DSH_TUI_EXPECTED_VERSION`。
+安装前提（这两条会让普通 `npm install` 失败或静默不装依赖）：
+
+- **本仓有意不提交 `package-lock.json`。** devDependency 里的宿主 tarball 内嵌 `@dsh-std/*`，其包内 manifest 仍声明 `workspace:*`；提交的 lockfile 会被 npm 忠实重放，于是 `npm install` 与 `npm ci` 都报 `EUNSUPPORTEDPROTOCOL`。删掉 lockfile 后 npm 会直接跳过 tarball 内的 bundle 目录，正常安装。请勿把 lockfile 提交回来（CI 的 `contract` 档会直接拦下）。
+- **安装时不要带 `NODE_ENV=production`。** 该变量会让 npm 按 `omit=dev` 静默省略 devDependencies，表现为 `up to date` 但 `node_modules` 为空、随后 `tsc` 找不到。所以显式写 `--include=dev`（CI 里另外固定 `NODE_ENV=development`）。
+
+`verify:host` 默认使用开发依赖中的 dsh-TUI（当前为 0.10.1）进行零配置验证，无需本地宿主源码检出；需要验证旧版或发布基线时，再显式指向同一版本的宿主 adapter 与源码。需要锁定版本时，额外设置 `DSH_TUI_EXPECTED_VERSION`。CI 只覆盖这条 0.10.1 零配置线，0.9.x 兼容回归仍需本机按上面的 env 指向对应宿主 worktree。
 
 主题调色板改起来最直接：编辑 `themes/*.json` 后重新 `npm run verify`，再删掉 `~/.dsh-tui/themes/` 下对应文件让插件重装。
 
 ## 兼容性
 
-- **dsh-TUI 版本下限：0.8.8**（状态行与设置面板；0.9.3 实测）。0.10.0 及更新版本使用运行时主题注册；更旧的宿主缺 `dsh-tui-extensions` 扩展面时，插件自动降级为“仅安装三套主题”，不报错。
+- **dsh-TUI 版本下限：0.8.8**（状态行与设置面板；0.9.3 实测）。0.10.0 及更新版本使用运行时主题注册；0.10.1 起状态行经富状态视图按主题配色（更旧宿主自动回退无色标量行）；更旧的宿主缺 `dsh-tui-extensions` 扩展面时，插件自动降级为“仅安装三套主题”，不报错。
 - Node `^22.19 || >=24`，纯 ESM，MIT。

package/cordis.patch.yml

@@ -10,6 +10,8 @@
         autoInstallThemes: true
         statusEnabled: true
         followSystem: false
+        statusGlyph: '✿'
+        statusSeparator: '·'
         showGlyph: true
         showClock: true
         showTurns: true

package/docs/decisions/2026-09-12-pink-day-claude-family-lightening.md

@@ -0,0 +1,49 @@
+# 决策：pink-day claude* 家族整体提亮一档（渐变结尾对比度接受 2.47）
+
+- 日期：2026-09-12
+- 状态：已采纳（Accepted-risk）
+- 来源：提交 `bbc7ee7`；代码审查条目 L12（`REVIEW.md`）
+
+## 背景
+
+宿主 `parseRGB` 只接受 `rgb(r,g,b)`，hex 形式的 claude\* 键在顶栏像素字路径上会静默回退固定品牌蓝。`bbc7ee7` 将 pink-night / pink-day 的 claude\* 四键改为 rgb() 值；提交信息只记录了 `claude` 的提亮（对比度地板 3.0→2.5，"lighter sakura-day large-text identity"），pink-day 另外三键的值变更未在提交信息中列出，审查无法直接判定其意图。
+
+## 变更事实
+
+pink-day 四键沿既有粉色阶梯 `#D5517F → #DE6E96 → #E879A0 → #F2A0BF` 整体上移一档：
+
+| 键 | 旧值 | 新值 |
+| --- | --- | --- |
+| `claude` | #D5517F | rgb(222,110,150)（#DE6E96，新设中间档） |
+| `claudeShimmer` | #E879A0 | rgb(242,160,191)（#F2A0BF） |
+| `claudeBlue_FOR_SYSTEM_SPINNER` | #D5517F | rgb(232,121,160)（#E879A0，即旧 claudeShimmer 档） |
+| `claudeBlueShimmer_FOR_SYSTEM_SPINNER` | #E879A0 | rgb(242,160,191)（#F2A0BF） |
+
+pink-night 同提交为纯格式转换，值不变（`claudeBlue == claude`、`claudeBlueShimmer == claudeShimmer` 的平色结构保持）。
+
+## 判定与理由
+
+判定为**有意的昼樱整体提亮**，非误改：
+
+1. 四键沿同一条色阶一致上移，方向与提交信息为 `claude` 记录的 "lighter sakura-day identity" 完全一致；偶发误改不会产生这种连贯模式。
+2. 新结构有明确设计语义：昼樱下 DEEPSEEK 像素字渐变从主色 #DE6E96 到结尾 #E879A0 读作向浅色 fade，与宿主自身 HARNESS 渐变以浅色常量 `PALE` 收尾的语言一致（见 README「顶栏文字色」条目）；shimmer 对统一为 #F2A0BF 则与 pink-night 的 shimmer 平色结构对齐。
+3. 校验脚本中 `claude` 用例的注释（2.5 地板）与本次方向互证。
+
+## 接受的风险
+
+对 pink-day 终端背景 #F6F3ED 的实测对比度（WCAG 相对亮度比）：
+
+- `claude` #DE6E96 = 2.80（守卫地板 2.5，通过）
+- `claudeBlue_FOR_SYSTEM_SPINNER` #E879A0 = **2.47**，低于为 `claude` 采纳的 2.5 大字号地板 0.03
+- `claudeShimmer` / `claudeBlueShimmer` #F2A0BF = 1.80（动画高光，不设数值地板）
+
+接受理由：该键只用于 DEEPSEEK 像素字的装饰性渐变结尾段，同字主色仍由 2.5 地板守卫，正文可读性由 4.5 的 `text` 用例守卫；0.03 的差额在像素字尺寸下不可感知。
+
+## 落地与守卫
+
+- `scripts/validate-themes-against-host.mjs` 新增用例：`['pink-day', 'claudeBlue_FOR_SYSTEM_SPINNER', '#F6F3ED', 2.4]`（0.10.1 起经语义别名读 `activity`），防止后续继续提亮越过已接受点。
+- 替代方案（恢复 `rgb(213,81,127)`）被否决：渐变结尾深于主色与昼樱提亮方向矛盾，且该值是旧 identity 色，与新家族并读不一致。
+
+## 影响范围
+
+仅 pink-day 顶栏 DEEPSEEK 像素字渐变结尾段的观感；无公共契约、接口或行为变更。pink-night / pink-ansi 不受影响。

package/lib/types/autoTheme.d.ts

@@ -13,6 +13,9 @@
  */
 interface FollowCache {
     light: boolean;
+    /** Diagnostic only (the /settings panel shows its date); never an expiry
+     *  signal — the cache is applied as-is whenever the user opts in, and this
+     *  plugin has no producer to refresh it (see the module header). */
     at: number;
 }
 /** The persisted theme pref ({ theme: name }), host format. */

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

@@ -1 +1 @@
-{"version":3,"file":"autoTheme.d.ts","sourceRoot":"","sources":["../../src/autoTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX;AAsCD,+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,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGxE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAA;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,EACxB,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GACvC,IAAI,CAUN"}
+{"version":3,"file":"autoTheme.d.ts","sourceRoot":"","sources":["../../src/autoTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAA;IACd;;wEAEoE;IACpE,EAAE,EAAE,MAAM,CAAA;CACX;AAsCD,+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,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGxE;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,oFAAoF;AACpF,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAA;AAE3B;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,OAAO,EACxB,MAAM,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GACvC,IAAI,CAUN"}

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;AAMlD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAIjF,eAAO,MAAM,IAAI,kBAAY,CAAA;AAE7B,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,eAAe,CAAA;AAUpC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAQrC,CAAA;AAkBF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAwJ7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAKjF,eAAO,MAAM,IAAI,kBAAY,CAAA;AAE7B,wDAAwD;AACxD,MAAM,MAAM,MAAM,GAAG,eAAe,CAAA;AAUpC,eAAO,MAAM,MAAM,EAAE,WAAW,CAAC,MAAM,CAUrC,CAAA;AAoBF;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW,GAAG,IAAI,CAoK7D"}

package/lib/types/index.js

@@ -20,6 +20,7 @@ import { startRuntimeThemes } from './runtimeThemes.js';
 import { startStatusLine } from './statusLine.js';
 import { runFollowSystem } from './autoTheme.js';
 import { registerPinkSettings } from './settingsSection.js';
+import { startShadowCleanup } from './shadowCleanup.js';
 import { startToastRelay } from './toast.js';
 import { PLUGIN_ID } from './pluginId.js';
 export const name = PLUGIN_ID;
@@ -35,6 +36,8 @@ export const Config = z.object({
     autoInstallThemes: z.boolean().default(true),
     statusEnabled: z.boolean().default(true),
     followSystem: z.boolean().default(false),
+    statusGlyph: z.string().default('✿'),
+    statusSeparator: z.string().default('·'),
     showGlyph: z.boolean().default(true),
     showClock: z.boolean().default(true),
     showTurns: z.boolean().default(true),
@@ -44,6 +47,8 @@ const DEFAULTS = {
     autoInstallThemes: true,
     statusEnabled: true,
     followSystem: false,
+    statusGlyph: '✿',
+    statusSeparator: '·',
     showGlyph: true,
     showClock: true,
     showTurns: true,
@@ -61,6 +66,8 @@ export function apply(ctx, config = {}) {
         autoInstallThemes: config.autoInstallThemes ?? DEFAULTS.autoInstallThemes,
         statusEnabled: config.statusEnabled ?? DEFAULTS.statusEnabled,
         followSystem: config.followSystem ?? DEFAULTS.followSystem,
+        statusGlyph: config.statusGlyph ?? DEFAULTS.statusGlyph,
+        statusSeparator: config.statusSeparator ?? DEFAULTS.statusSeparator,
         showGlyph: config.showGlyph ?? DEFAULTS.showGlyph,
         showClock: config.showClock ?? DEFAULTS.showClock,
         showTurns: config.showTurns ?? DEFAULTS.showTurns,
@@ -70,6 +77,11 @@ export function apply(ctx, config = {}) {
     // logger is invisible to a TUI user). Hosts without the 0.10 toast seam
     // degrade to the log-only behavior of previous releases.
     const sendToast = startToastRelay(ctx);
+    // One-shot guided cleanup for byte-identical legacy theme files that shadow
+    // the runtime registry; a host-managed confirm dialog (tuiDialogs), never
+    // raw input interception. Hosts without the seam keep the toast-only
+    // behavior of previous releases.
+    const offerShadowCleanup = startShadowCleanup(ctx, sendToast);
     // New hosts own the palette in memory. Install synchronously first so an old
     // host can resolve a persisted theme during its first render. If a runtime
     // service appears afterwards, remove only files written by this activation
@@ -82,6 +94,9 @@ export function apply(ctx, config = {}) {
         if (!cordis.autoInstallThemes)
             return;
         const result = installBundledThemes();
+        if (result.sourceError !== undefined) {
+            ctx.logger.warn(`${PLUGIN_ID}: ${result.sourceError}`);
+        }
         for (const file of result.installed) {
             ctx.logger.info(`${PLUGIN_ID}: installed bundled theme "${file}" into ~/.dsh-tui/themes/`);
         }
@@ -113,13 +128,15 @@ export function apply(ctx, config = {}) {
         }
         // Same-named static files win over runtime registrations. User-edited
         // files stay unmentioned; files byte-identical to the bundled copy add
-        // nothing but permanently block palette updates, so point them out once.
+        // nothing but permanently block palette updates, so point them out once
+        // and offer the guided cleanup.
         if (!firstConfirmation)
             return;
         const shadowed = findShadowedBundledThemes();
         if (shadowed.length > 0) {
             ctx.logger.info(`${PLUGIN_ID}: legacy static files shadow the runtime registry: ${shadowed.join(', ')}`);
             sendToast(`✿ ${shadowed.join('、')} 与插件内置相同，删除后配色将随插件自动更新`);
+            offerShadowCleanup(shadowed);
         }
     };
     let runtimePresent = false;
@@ -193,7 +210,7 @@ export function apply(ctx, config = {}) {
                 ctx.logger.info(`${PLUGIN_ID}: follow: disabled, manual /theme choice preserved`);
             }
         }
-    });
+    }, dataDir);
     // The follow decision is owned entirely by the /settings layer above: there
     // is no timer or fallback path on hosts without a settings service — the
     // plugin keeps the user's existing theme choice and degrades to static

package/lib/types/ornament.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Validation and sanitization for the two user-configurable ornaments of the
+ * status line (the blossom glyph and the separator).
+ *
+ * The /settings layer validates drafts strictly (1–2 display cells, no
+ * control characters — an invalid draft blocks the save). The render layer
+ * additionally sanitizes whatever actually arrives in the merged config:
+ * hand-edited cordis.yml/settings.yaml values bypass the draft gate, so the
+ * strip mirrors the host's own cleanRenderText (complete ANSI sequences
+ * first, then C0/C1) before a hard 2-cell cap. A broken ornament must never
+ * reach the status line.
+ * @module dsh-tui-theme/ornament
+ */
+/** Rendered width of `text` in terminal cells (code points, wide = 2). */
+export declare function displayCells(text: string): number;
+/** A /settings draft verdict: accept, clear (re-inherit the default), or
+ *  reject (the host blocks the save and keeps the editor open). */
+export type OrnamentDraft = {
+    kind: 'set';
+    value: string;
+} | {
+    kind: 'clear';
+};
+/**
+ * Validate a glyph/separator draft from the /settings text editor. Empty
+ * resets to the built-in default; anything with control/format characters or
+ * outside the 1–2 cell budget is rejected (undefined).
+ */
+export declare function parseOrnamentDraft(text: string): OrnamentDraft | undefined;
+/**
+ * Sanitize an ornament value from any config layer (draft validation only
+ * guards /settings edits): strip complete ANSI sequences, then every control
+ * or format character; fall back when nothing renderable remains, and cap
+ * the rest at 2 cells so a hand-edited 50-character glyph cannot wreck the
+ * line.
+ */
+export declare function sanitizeOrnament(value: unknown, fallback: string): string;
+//# sourceMappingURL=ornament.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ornament.d.ts","sourceRoot":"","sources":["../../src/ornament.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAyBH,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjD;AAcD;mEACmE;AACnE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAA;AAErB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAO1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzE"}

package/lib/types/ornament.js

@@ -0,0 +1,88 @@
+/**
+ * Validation and sanitization for the two user-configurable ornaments of the
+ * status line (the blossom glyph and the separator).
+ *
+ * The /settings layer validates drafts strictly (1–2 display cells, no
+ * control characters — an invalid draft blocks the save). The render layer
+ * additionally sanitizes whatever actually arrives in the merged config:
+ * hand-edited cordis.yml/settings.yaml values bypass the draft gate, so the
+ * strip mirrors the host's own cleanRenderText (complete ANSI sequences
+ * first, then C0/C1) before a hard 2-cell cap. A broken ornament must never
+ * reach the status line.
+ * @module dsh-tui-theme/ornament
+ */
+/** Whether a code point renders double-width in a typical terminal (a
+ *  pragmatic subset of Unicode East Asian Width W/F: CJK, Hangul, fullwidth
+ *  forms, and the common emoji planes). */
+function isWide(code) {
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0x303e) ||
+        (code >= 0x3041 && code <= 0x33ff) ||
+        (code >= 0x3400 && code <= 0x4dbf) ||
+        (code >= 0x4e00 && code <= 0x9fff) ||
+        (code >= 0xa000 && code <= 0xa4cf) ||
+        (code >= 0xa960 && code <= 0xa97f) ||
+        (code >= 0xac00 && code <= 0xd7a3) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe10 && code <= 0xfe19) ||
+        (code >= 0xfe30 && code <= 0xfe6f) ||
+        (code >= 0xff00 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6) ||
+        (code >= 0x1f300 && code <= 0x1faff) ||
+        (code >= 0x20000 && code <= 0x3fffd));
+}
+/** Rendered width of `text` in terminal cells (code points, wide = 2). */
+export function displayCells(text) {
+    let cells = 0;
+    for (const ch of text) {
+        cells += isWide(ch.codePointAt(0) ?? 0) ? 2 : 1;
+    }
+    return cells;
+}
+function capToCells(text, maxCells) {
+    let out = '';
+    let cells = 0;
+    for (const ch of text) {
+        const width = isWide(ch.codePointAt(0) ?? 0) ? 2 : 1;
+        if (cells + width > maxCells)
+            break;
+        out += ch;
+        cells += width;
+    }
+    return out;
+}
+/**
+ * Validate a glyph/separator draft from the /settings text editor. Empty
+ * resets to the built-in default; anything with control/format characters or
+ * outside the 1–2 cell budget is rejected (undefined).
+ */
+export function parseOrnamentDraft(text) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return { kind: 'clear' };
+    if (/[\p{C}]/u.test(trimmed))
+        return undefined;
+    const cells = displayCells(trimmed);
+    if (cells < 1 || cells > 2)
+        return undefined;
+    return { kind: 'set', value: trimmed };
+}
+/**
+ * Sanitize an ornament value from any config layer (draft validation only
+ * guards /settings edits): strip complete ANSI sequences, then every control
+ * or format character; fall back when nothing renderable remains, and cap
+ * the rest at 2 cells so a hand-edited 50-character glyph cannot wreck the
+ * line.
+ */
+export function sanitizeOrnament(value, fallback) {
+    if (typeof value !== 'string')
+        return fallback;
+    const flat = value
+        .replace(/\u001B\][^\u0007]*(?:\u0007|\u001B\\)/gu, '')
+        .replace(/\u001B\[[0-?]*[ -/]*[@-~]/gu, '')
+        .replace(/[\p{C}]/gu, '')
+        .trim();
+    if (flat === '')
+        return fallback;
+    return capToCells(flat, 2);
+}

package/lib/types/settingsSection.d.ts

@@ -9,9 +9,12 @@
  * config layer (mirrors the host's own lang/fullscreen fields), and format()
  * displays the effective value instead of a misleading blank.
  *
- * Both services are consumed through `ctx.inject`, not apply-time `get`
- * probes: this row may start before the host's service rows, and the inject
- * fires whenever each service actually registers.
+ * The section splits into two navigation groups (背景跟随 / 状态行). The two
+ * text fields (glyph, separator) validate their drafts with parse(): an
+ * invalid draft blocks the save, an empty draft clears back to the cordis
+ * default. Both services are consumed through `ctx.inject`, not apply-time
+ * `get` probes: this row may start before the host's service rows, and the
+ * inject fires whenever each service actually registers.
  * @module dsh-tui-theme/settingsSection
  */
 import type { Context } from '@deepseek-ai/cordis';
@@ -33,6 +36,8 @@ export type PinkSettingsDoc = StatusOptions & {
  *   still-unset fields).
  * @param onDoc - Called with the defined-valued subset of the settings doc,
  *   initially and on every committed edit.
+ * @param dataDir - The host data directory (~/.dsh-tui), read by the
+ *   followSystem field's format() to surface the cached follow state.
  */
-export declare function registerPinkSettings(ctx: Context, cordis: StatusOptions, onDoc: (doc: PinkSettingsDoc) => void): void;
+export declare function registerPinkSettings(ctx: Context, cordis: StatusOptions, onDoc: (doc: PinkSettingsDoc) => void, dataDir?: string): void;
 //# sourceMappingURL=settingsSection.d.ts.map

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;AAIlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGpD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,mEAAmE;IACnE,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,CAwDN"}
+{"version":3,"file":"settingsSection.d.ts","sourceRoot":"","sources":["../../src/settingsSection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAIpD,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG;IAC5C,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,mEAAmE;IACnE,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAcD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,EACrC,OAAO,GAAE,MAA0B,GAClC,IAAI,CA0DN"}

package/lib/types/settingsSection.js

@@ -9,13 +9,20 @@
  * config layer (mirrors the host's own lang/fullscreen fields), and format()
  * displays the effective value instead of a misleading blank.
  *
- * Both services are consumed through `ctx.inject`, not apply-time `get`
- * probes: this row may start before the host's service rows, and the inject
- * fires whenever each service actually registers.
+ * The section splits into two navigation groups (背景跟随 / 状态行). The two
+ * text fields (glyph, separator) validate their drafts with parse(): an
+ * invalid draft blocks the save, an empty draft clears back to the cordis
+ * default. Both services are consumed through `ctx.inject`, not apply-time
+ * `get` probes: this row may start before the host's service rows, and the
+ * inject fires whenever each service actually registers.
  * @module dsh-tui-theme/settingsSection
  */
+import { join } from 'node:path';
 import z from '@deepseek-ai/schemastery';
+import { readFollowCache } from './autoTheme.js';
+import { parseOrnamentDraft } from './ornament.js';
 import { PLUGIN_ID } from './pluginId.js';
+import { homeDir } from './themeAssets.js';
 /**
  * Register the settings namespace (mirror the resolved document to the
  * caller) and, separately, the /settings section for it. Each part waits for
@@ -26,8 +33,10 @@ import { PLUGIN_ID } from './pluginId.js';
  *   still-unset fields).
  * @param onDoc - Called with the defined-valued subset of the settings doc,
  *   initially and on every committed edit.
+ * @param dataDir - The host data directory (~/.dsh-tui), read by the
+ *   followSystem field's format() to surface the cached follow state.
  */
-export function registerPinkSettings(ctx, cordis, onDoc) {
+export function registerPinkSettings(ctx, cordis, onDoc, dataDir = joinHomeDataDir()) {
     ctx.inject(['settings'], settingsCtx => {
         const settings = settingsCtx.settings;
         try {
@@ -41,6 +50,8 @@ export function registerPinkSettings(ctx, cordis, onDoc) {
                 showClock: z.boolean(),
                 showTurns: z.boolean(),
                 statusScope: z.union(['pink-only', 'all-themes']),
+                statusGlyph: z.string(),
+                statusSeparator: z.string(),
             }));
             const emit = (doc) => {
                 if (doc === null || typeof doc !== 'object')
@@ -69,7 +80,7 @@ export function registerPinkSettings(ctx, cordis, onDoc) {
         const sections = sectionsCtx
             .tuiSettingsSections;
         try {
-            const unregister = sections.register(sectionDefinition(cordis));
+            const unregister = sections.register(sectionDefinition(cordis, dataDir));
             sectionsCtx.effect(() => () => unregister());
         }
         catch (error) {
@@ -79,15 +90,40 @@ export function registerPinkSettings(ctx, cordis, onDoc) {
         }
     });
 }
+function joinHomeDataDir() {
+    return join(homeDir(), '.dsh-tui');
+}
+/** Draft gate shared by the two ornament fields (see ornament.ts). */
+function ornamentParse(text) {
+    const draft = parseOrnamentDraft(text);
+    if (draft === undefined)
+        return undefined;
+    return draft.kind === 'clear' ? { kind: 'clear' } : { kind: 'set', value: draft.value };
+}
+/** The cached follow result as a date (undefined when absent/invalid). */
+function followCacheDate(at) {
+    if (typeof at !== 'number' || !Number.isFinite(at))
+        return undefined;
+    const date = new Date(at);
+    if (Number.isNaN(date.getTime()))
+        return undefined;
+    const pad = (value) => String(value).padStart(2, '0');
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
 /** The declarative /settings block (labels bilingual, zh via descriptions). */
-function sectionDefinition(cordis) {
+function sectionDefinition(cordis, dataDir) {
     return {
         ns: PLUGIN_ID,
         title: 'pink-theme',
         descriptions: { zh: 'pink-theme' },
+        groups: [
+            { id: 'follow', title: 'Background follow', descriptions: { zh: '背景跟随' } },
+            { id: 'status-line', title: 'Status line', descriptions: { zh: '状态行' } },
+        ],
         fields: [
             {
                 path: ['followSystem'],
+                group: 'follow',
                 label: 'Apply saved terminal background',
                 descriptions: { zh: '应用上次保存的终端背景' },
                 hint: 'Apply a previously saved terminal background result at startup. dsh-TUI does not expose a safe plugin query, so this plugin does not refresh the cache.',
@@ -95,10 +131,24 @@ function sectionDefinition(cordis) {
                     zh: '启动时应用此前保存的终端背景结果。dsh-TUI 未提供安全的插件查询接缝，因此本插件不会刷新该缓存。',
                 },
                 kind: 'boolean',
-                format: (value) => String(value ?? cordis.followSystem),
+                format: (value) => {
+                    const on = typeof value === 'boolean' ? value : (cordis.followSystem ?? false);
+                    if (!on)
+                        return 'off';
+                    // A low-frequency, synchronous read of a tiny file on the settings
+                    // screen only (never on the render path), putting the "toggled on,
+                    // nothing happened" reason on the surface: the state of the cache
+                    // this startup would consult.
+                    const cache = readFollowCache(dataDir);
+                    if (cache === undefined)
+                        return 'on（无缓存，启动时不动）';
+                    const day = followCacheDate(cache.at);
+                    return `on（缓存: ${cache.light ? 'light' : 'dark'}${day === undefined ? '' : ` · ${day}`}）`;
+                },
             },
             {
                 path: ['showGlyph'],
+                group: 'status-line',
                 label: 'Blossom ✿',
                 descriptions: { zh: '花符 ✿' },
                 hint: 'Lead the decorative line above the prompt with ✿.',
@@ -106,8 +156,23 @@ function sectionDefinition(cordis) {
                 kind: 'boolean',
                 format: (value) => String(value ?? cordis.showGlyph),
             },
+            {
+                path: ['statusGlyph'],
+                group: 'status-line',
+                label: 'Blossom glyph',
+                descriptions: { zh: '花符字符' },
+                hint: 'The character leading the decorative line. 1–2 display cells, no control characters; empty resets to the default.',
+                hintDescriptions: {
+                    zh: '装饰行开头的字符。支持 1–2 个显示单元，不接受控制字符；留空恢复默认。',
+                },
+                kind: 'text',
+                placeholder: '✿',
+                format: (value) => typeof value === 'string' && value !== '' ? value : String(cordis.statusGlyph ?? '✿'),
+                parse: ornamentParse,
+            },
             {
                 path: ['showClock'],
+                group: 'status-line',
                 label: 'Clock',
                 descriptions: { zh: '时钟' },
                 kind: 'boolean',
@@ -115,6 +180,7 @@ function sectionDefinition(cordis) {
             },
             {
                 path: ['showTurns'],
+                group: 'status-line',
                 label: 'Turn count',
                 descriptions: { zh: '轮数' },
                 hint: 'Turns of the live session counted since the TUI started.',
@@ -122,8 +188,23 @@ function sectionDefinition(cordis) {
                 kind: 'boolean',
                 format: (value) => String(value ?? cordis.showTurns),
             },
+            {
+                path: ['statusSeparator'],
+                group: 'status-line',
+                label: 'Separator',
+                descriptions: { zh: '分隔符' },
+                hint: 'The character between the line’s cells. 1–2 display cells, no control characters; empty resets to the default.',
+                hintDescriptions: {
+                    zh: '装饰行各段之间的分隔字符。支持 1–2 个显示单元，不接受控制字符；留空恢复默认。',
+                },
+                kind: 'text',
+                placeholder: '·',
+                format: (value) => typeof value === 'string' && value !== '' ? value : String(cordis.statusSeparator ?? '·'),
+                parse: ornamentParse,
+            },
             {
                 path: ['statusScope'],
+                group: 'status-line',
                 label: 'Status line display',
                 descriptions: { zh: '状态行展示' },
                 hint: 'The blossom line is exclusive to the pink palettes by default; all-themes keeps it visible under other themes.',