dsh-theme-palette 1.4.2 → 1.4.3

package/CHANGELOG.md

@@ -4,6 +4,19 @@
 
 ## 版本一览
 
+### 1.4.3
+安全审计后的整改（`@应用安全工程师` 审计，逐条复核后落地）：
+
+- **文档**：`tools/README.md` 删掉「把 `--remote-debugging-port` 长期写进快捷方式」的建议，改为「只在截图那一次开、抓完即关」，并说明该端口无鉴权等价于渲染进程任意代码执行，同时给出 `--remote-debugging-pipe` 替代
+- **`tools/release.mjs` 去 shell 拼接**：name/version/tag 先过严格白名单，命令一律 `execFileSync(程序, 参数数组)`，npm 走 `node <npm-cli.js>`；registry 探测改用 `fetch`（不再 curl）；`--dry` 无副作用
+- **发布前校验**：`PLUGIN_VERSION` 必须等于 `package.json.version`；CI 下自动加 `--provenance`；配了 `user.signingkey` 时 tag 自动用 `-s`
+- **dev 钩子收口**：默认不暴露，必须 URL 带 `?dshThemeDev=1`；`attach` 返回的清理函数在插件卸载时调用；`setTheme` 补 `light/dark/system` 白名单（此前是唯一不校验输入的 setter）
+- **自愈定时器**：4s → 15s，且 `visibilityState === 'hidden'` 直接早退（不再后台空转样式回读）
+- **token 前缀**：`--dsh-*` → `--dshtp-*`（与宿主 `--dsh-content-*` 等命名解耦，避免跨插件碰撞）
+- **`tools/shoot-desktop.mjs`**：修收尾处引用未定义变量 `original` 的崩溃；还原动作移进 `try/finally`，中途失败也不会把用户明暗偏好留在被改写状态
+- **声明补齐**：peer 补 `dsh-client-ui-theme` / `dsh-client-ui-settings`（optional），`engines.dsh >= 0.2.1-rc.1`；`files` 移出 `palette-dev.mjs` 与 `tools/*`（发布面从 24 个文件降到 14 个）
+- **README 五语版本钉** 1.4.0 → 1.4.3
+
 ### 1.4.2
 - **修复启动崩溃**：1.4.1 为了展示元数据加了 `exports`，但漏了 `"./client"` —— 宿主 `client-modules` 找不到 client bundle 时会让 **required 插件 `modules` 启动失败**，整个 profile 的插件全部不加载（重启后界面报错、插件消失）
 - `exports` 现在显式列出 `./client`、`./client.js`、`./index.js`、`./cordis.patch.yml`、`./package.json`

package/README-es.md

@@ -31,13 +31,13 @@ cd ~/.dsh/profiles/desktop
 pnpm add dsh-theme-palette
 
 # o una versión concreta
-pnpm add dsh-theme-palette@1.4.0
+pnpm add dsh-theme-palette@1.4.3
 ```
 
 Desde el tarball del release de GitHub:
 
 ```bash
-pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.0/dsh-theme-palette-1.4.0.tgz"
+pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.3/dsh-theme-palette-1.4.3.tgz"
 ```
 
 Después **reinicia la interfaz**: un proceso en marcha conserva el módulo antiguo. Se abre en avatar → Ajustes → **Color theme**.

package/README-hi.md

@@ -31,13 +31,13 @@ cd ~/.dsh/profiles/desktop
 pnpm add dsh-theme-palette
 
 # या कोई विशेष संस्करण
-pnpm add dsh-theme-palette@1.4.0
+pnpm add dsh-theme-palette@1.4.3
 ```
 
 GitHub रिलीज़ के tarball से:
 
 ```bash
-pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.0/dsh-theme-palette-1.4.0.tgz"
+pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.3/dsh-theme-palette-1.4.3.tgz"
 ```
 
 इसके बाद **GUI को फिर से शुरू करें** — चल रहा प्रोसेस पुराना मॉड्यूल रखता है। खोलें: अवतार → सेटिंग्स → **Color theme**।

package/README-pt.md

@@ -31,13 +31,13 @@ cd ~/.dsh/profiles/desktop
 pnpm add dsh-theme-palette
 
 # ou uma versão específica
-pnpm add dsh-theme-palette@1.4.0
+pnpm add dsh-theme-palette@1.4.3
 ```
 
 A partir do tarball do release do GitHub:
 
 ```bash
-pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.0/dsh-theme-palette-1.4.0.tgz"
+pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.3/dsh-theme-palette-1.4.3.tgz"
 ```
 
 Depois **reinicie a interface**: um processo em execução mantém o módulo antigo. Abra em avatar → Configurações → **Color theme**.

package/README-zh.md

@@ -31,13 +31,13 @@ cd ~/.dsh/profiles/desktop
 pnpm add dsh-theme-palette
 
 # 或指定版本
-pnpm add dsh-theme-palette@1.4.0
+pnpm add dsh-theme-palette@1.4.3
 ```
 
 从 GitHub Release 的 tarball：
 
 ```bash
-pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.0/dsh-theme-palette-1.4.0.tgz"
+pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.3/dsh-theme-palette-1.4.3.tgz"
 ```
 
 装完**必须重启 GUI**（运行中的进程仍持旧模块）。入口：左下角头像 → **设置** → 「**主题色**」。

package/README.md

@@ -31,13 +31,13 @@ cd ~/.dsh/profiles/desktop
 pnpm add dsh-theme-palette
 
 # or a specific version
-pnpm add dsh-theme-palette@1.4.0
+pnpm add dsh-theme-palette@1.4.3
 ```
 
 From the GitHub Release tarball:
 
 ```bash
-pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.0/dsh-theme-palette-1.4.0.tgz"
+pnpm add "https://github.com/zuoyunlai/dsh-theme-palette/releases/download/v1.4.3/dsh-theme-palette-1.4.3.tgz"
 ```
 
 Then **restart the GUI** — a running process keeps the old module. Open it from avatar → Settings → **Color theme**.

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.4.2'
+    const PLUGIN_VERSION = '1.4.3'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -171,7 +171,7 @@ window.__ModuleLoader__.load({
      * 右侧栏底色。宿主的右栏（ui-layout 的 RightbarColumn）**没有自己的背景**，
      * 露出的是 frame 的 --dsw-alias-bg-base（也就是会话区画布色），所以看着和中间一样。
      * 元素上有一个稳定钩子 `data-rightbar-col`，用一条 CSS 规则就能单独上色，
-     * 具体颜色由 token 层给的 --dsh-rightbar-fill 决定（默认直接引用左栏 token）。
+     * 具体颜色由 token 层给的 --dshtp-rightbar-fill 决定（默认直接引用左栏 token）。
      */
     const RIGHTBAR_MODES = [
       { id: 'sidebar', label: '同左栏' },
@@ -673,20 +673,20 @@ window.__ModuleLoader__.load({
       // 会得到一张近白卡片，而卡片文字是 label-primary（深色下近白）→ 白底白字。
       const accentHex = ramps.deepseek['500']
       const accentDark = ramps.deepseek['400']
-      pairs['--dsh-card-picked'] = {
+      pairs['--dshtp-card-picked'] = {
         light: mixHex(accentHex, ramps.bluish['00'], 0.10),
         dark: mixHex(accentDark, ramps.bluish['950'], 0.16),
       }
       const rightbarFill = rightbarMode === 'canvas'
         ? 'var(--dsw-alias-bg-base)'
         : 'var(--dsw-specific-sidebar-fill)'
-      pairs['--dsh-rightbar-fill'] = { light: rightbarFill, dark: rightbarFill }
+      pairs['--dshtp-rightbar-fill'] = { light: rightbarFill, dark: rightbarFill }
       // Markdown 强调色：标题 = 正文色混 40% 强调色；加粗 = 混 20%（比标题弱一档）
       if (scheme.tinted) {
         if (mdMode === 'off') {
           const inherit = { light: 'inherit', dark: 'inherit' }
-          pairs['--dsh-md-heading'] = inherit
-          pairs['--dsh-md-strong'] = inherit
+          pairs['--dshtp-md-heading'] = inherit
+          pairs['--dshtp-md-strong'] = inherit
         } else {
           // 加粗：只加色度、不动明度 —— 混色会把正文调亮（浅色下反而比正文更弱）。
           // 标题：再往中间推一点明度（浅色提亮 / 深色压暗），配合更大的字号拉开层级。
@@ -695,11 +695,11 @@ window.__ModuleLoader__.load({
             const acc = toOklch(accentHex)
             return fromOklch(clamp(L + lift, 0.05, 0.97), C + acc[1] * extraChroma, acc[2])
           }
-          pairs['--dsh-md-heading'] = {
+          pairs['--dshtp-md-heading'] = {
             light: tintText(ramps.bluish['1000'], ramps.deepseek['500'], 0.45, 0.065),
             dark: tintText(ramps.bluish['50'], ramps.deepseek['400'], 0.40, -0.030),
           }
-          pairs['--dsh-md-strong'] = {
+          pairs['--dshtp-md-strong'] = {
             light: tintText(ramps.bluish['1000'], ramps.deepseek['500'], 0.32, 0.012),
             dark: tintText(ramps.bluish['50'], ramps.deepseek['400'], 0.32, -0.010),
           }
@@ -708,11 +708,11 @@ window.__ModuleLoader__.load({
       // 代码块底色：宿主用 bg-layer-1，浅色下与画布同色（都指 00）→ 看不出边界。
       // 这里给它一档独立的"内嵌面板"色：卡层色 + 少量强调色相，保证与画布有可辨差。
       // mixHex(a, b, w) = a*w + b*(1-w)：a 是要掺进去的颜色，b 是底色。
-      pairs['--dsh-code-fill'] = {
+      pairs['--dshtp-code-fill'] = {
         light: mixHex(ramps.deepseek['500'], ramps.bluish['60'], 0.08),
         dark: mixHex(ramps.deepseek['400'], ramps.bluish['875'], 0.10),
       }
-      pairs['--dsh-code-inline'] = {
+      pairs['--dshtp-code-inline'] = {
         light: mixHex(ramps.deepseek['500'], ramps.bluish['50'], 0.05),
         dark: mixHex(ramps.deepseek['400'], ramps.bluish['900'], 0.07),
       }
@@ -771,16 +771,16 @@ window.__ModuleLoader__.load({
      * 全屏右栏时退回画布色 —— 那时右栏就是整块内容区，染成侧栏色会像只剩一条侧栏。
      */
     const RIGHTBAR_CSS = [
-      '[data-rightbar-col]{background:var(--dsh-rightbar-fill,var(--dsw-alias-bg-base))}',
+      '[data-rightbar-col]{background:var(--dshtp-rightbar-fill,var(--dsw-alias-bg-base))}',
       '[data-rightbar-fullscreen] [data-rightbar-col]{background:var(--dsw-alias-bg-base)}',
       // Markdown 标题/加粗：容器类是 CSS Modules 的 `_markdown_<hash>_<n>`，
       // 用「类名里含 _markdown_」做钩子（局部名稳定，比整串哈希耐版本）。
-      '[class*="_markdown_"] :where(h1,h2,h3,h4,h5,h6){color:var(--dsh-md-heading,inherit)}',
-      '[class*="_markdown_"] strong{color:var(--dsh-md-strong,inherit)}',
+      '[class*="_markdown_"] :where(h1,h2,h3,h4,h5,h6){color:var(--dshtp-md-heading,inherit)}',
+      '[class*="_markdown_"] strong{color:var(--dshtp-md-strong,inherit)}',
       // 代码块：宿主把底色写在 CSS Modules 的 .block 上（浅色与画布同为 00，看不出边界）。
       // 这里以 `.md-code-block` 提高一级特异性覆盖，不需要 !important。
-      '[class*="_markdown_"] .md-code-block{background:var(--dsh-code-fill,inherit)}',
-      '[class*="_markdown_"] :not(pre) > code{background:var(--dsh-code-inline,inherit)}',
+      '[class*="_markdown_"] .md-code-block{background:var(--dshtp-code-fill,inherit)}',
+      '[class*="_markdown_"] :not(pre) > code{background:var(--dshtp-code-inline,inherit)}',
     ].join('')
 
     /* ================= 设置页样式（head 里第二条 CSS） ================= */
@@ -795,7 +795,7 @@ window.__ModuleLoader__.load({
 @media (max-width:620px){.dsh-tp-grid{grid-template-columns:1fr}}
 .dsh-tp-card{position:relative;display:flex;flex-direction:column;gap:8px;text-align:left;font:inherit;cursor:pointer;padding:9px;border-radius:14px;border:.5px solid var(--dsw-alias-border-l4);background:transparent;transition:background .12s ease,border-color .12s ease}
 .dsh-tp-card:hover{background:var(--dsw-alias-interactive-bg-hover)}
-.dsh-tp-card.is-on{background:var(--dsh-card-picked,var(--dsw-alias-bg-module-platform));border-color:var(--t-accent-l)}
+.dsh-tp-card.is-on{background:var(--dshtp-card-picked,var(--dsw-alias-bg-module-platform));border-color:var(--t-accent-l)}
 body[data-ds-dark-theme] .dsh-tp-card.is-on{border-color:var(--t-accent-d)}
 .dsh-tp-thumb{display:flex;height:56px;border-radius:9px;overflow:hidden;border:.5px solid rgba(128,128,128,.28)}
 .dsh-tp-thumb-side{width:34%;background:var(--t-side-l)}
@@ -1302,8 +1302,20 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
     }
 
     /* ================= 插件 ================= */
+    /**
+     * 开发期接口默认**关闭**：只有在页面 URL 上显式带 `?dshThemeDev=1` 时才暴露。
+     * 这不是安全边界（同上下文脚本本就有同等权力），而是防止"谁先定义谁拿到全部 setter"
+     * 的默认开放；一旦宿主将来把插件放进受限上下文，它就是跨权限入口。
+     */
+    const DEV_OPT_IN = (() => {
+      try {
+        const search = typeof location !== 'undefined' && location ? String(location.search || '') : ''
+        return /(?:^|[?&])dshThemeDev=1(?:&|$)/.test(search)
+      } catch (err) { return false }
+    })()
+
     // 开发期接口：palette-dev.mjs 通过它拿到同一套引擎（避免「报表好看、上线不一样」）
-    if (typeof window !== 'undefined' && typeof window.__DSH_THEME_PALETTE_DEV__ === 'function') {
+    if (DEV_OPT_IN && typeof window !== 'undefined' && typeof window.__DSH_THEME_PALETTE_DEV__ === 'function') {
       window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, RIGHTBAR_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, contrast, toOklch, rampsFor, settingsCss: SETTINGS_CSS, cardColors })
     }
 
@@ -1543,11 +1555,13 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
         } catch (err) { /* 没有 MutationObserver 就只在打开设置页时读一次 */ }
 
         // 开发期自动化接口：截图回归要从外部驱动「换配色 / 换明暗」，而这两件事
-        // 平时只能点界面。暴露一组 setter，让 CDP 的 Runtime.evaluate 能直接调用。
+        // 平时只能点界面。默认不暴露，必须 URL 带 ?dshThemeDev=1 才挂（见 DEV_OPT_IN）。
+        let detachDev = null
         try {
-          const dev = typeof window !== 'undefined' ? window.__DSH_THEME_PALETTE_DEV__ : undefined
+          const dev = DEV_OPT_IN && typeof window !== 'undefined' ? window.__DSH_THEME_PALETTE_DEV__ : undefined
           if (dev && typeof dev.attach === 'function') {
-            dev.attach({
+            const THEME_IDS = ['light', 'dark', 'system']
+            const attached = dev.attach({
               setPalette,
               setSidebarMode,
               setTextMode,
@@ -1557,9 +1571,11 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
               getPreference: () => theme.getTheme().preference,
               setLangPref,
               locales: LOCALES,
-              setTheme: (id) => theme.setTheme(id),
+              // 和其它 setter 一样过白名单：任意字符串会原样进宿主主题状态并被持久化
+              setTheme: (id) => { if (THEME_IDS.indexOf(id) !== -1) theme.setTheme(id) },
               schemes: SCHEMES.map((s) => s.id),
             })
+            if (typeof attached === 'function') detachDev = attached
           }
         } catch (err) {
           console.warn('[dsh-theme-palette] dev hook attach 失败：', err)
@@ -1579,7 +1595,11 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
         } catch (err) { /* 无 DOM 时跳过 */ }
         try { ctx.on('theme/change', healOnTheme) } catch (err) { /* 事件名变了就只靠定时器 */ }
         try {
-          healTimer = setInterval(() => ensureApplied('interval'), 4000)
+          healTimer = setInterval(() => {
+            // 页面不可见时不做样式回读：容器里长时间后台驻留时，4 秒一次 getComputedStyle 是纯浪费
+            try { if (document.visibilityState === 'hidden') return } catch (err) { /* 无该 API */ }
+            ensureApplied('interval')
+          }, 15000)
           if (healTimer && typeof healTimer.unref === 'function') healTimer.unref()
         } catch (err) { /* 无定时器环境 */ }
 
@@ -1597,6 +1617,7 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
               window.removeEventListener('pageshow', healOnShow)
             } catch (err) { /* 同上 */ }
             if (healTimer !== null) { clearInterval(healTimer); healTimer = null }
+            if (typeof detachDev === 'function') { try { detachDev() } catch (err) { /* 忽略 */ } }
             if (langObserver !== null) { langObserver.disconnect(); langObserver = null }
           }
         }, 'dsh-theme-palette: token layer + 右栏样式')

package/docs/DESIGN.md

@@ -105,13 +105,13 @@ MIN_MAIN 从 15.5 放宽到 12：给“带色正文”留出明度空间，仍
 
 ```css
 /* 插件注入到 <head>，用官方同一套 data-plugin-css 标记 */
-[data-rightbar-col]{background:var(--dsh-rightbar-fill,var(--dsw-alias-bg-base))}
+[data-rightbar-col]{background:var(--dshtp-rightbar-fill,var(--dsw-alias-bg-base))}
 [data-rightbar-fullscreen] [data-rightbar-col]{background:var(--dsw-alias-bg-base)}
 ```
 
 - 钩子是 `data-rightbar-col` —— ui-layout 里 `RightbarColumn` 上的**语义属性**，不是哈希类名，
   宿主升级时不会跟着变；
-- 颜色不经硬编码：token 层只给一个 `--dsh-rightbar-fill`，值是 `var(--dsw-specific-sidebar-fill)`
+- 颜色不经硬编码：token 层只给一个 `--dshtp-rightbar-fill`，值是 `var(--dsw-specific-sidebar-fill)`
   或 `var(--dsw-alias-bg-base)`，所以它会自动跟着「左侧栏底色」三档一起变；
 - 全屏右栏时退回画布色 —— 那时右栏就是整块内容区，染成侧栏色会像只剩一条侧栏。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-theme-palette",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
   "type": "module",
   "main": "index.js",
@@ -21,14 +21,6 @@
     "icon.svg",
     "README.md",
     "LICENSE",
-    "palette-dev.mjs",
-    "tools/sheet.mjs",
-    "tools/shoot-sheet.mjs",
-    "tools/shoot-html.mjs",
-    "tools/preview-settings.mjs",
-    "tools/shoot-desktop.mjs",
-    "tools/compare.mjs",
-    "tools/release.mjs",
     "CHANGELOG.md",
     "docs/DESIGN.md",
     "README-zh.md",
@@ -38,10 +30,13 @@
     "locale"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.0"
+    "@deepseek-ai/cordis": "^4.0.0",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.2.1-rc.1"
   },
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.1-rc.1"
   },
   "dsh": {
     "bundle": {
@@ -78,5 +73,16 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
-  "packageManager": "pnpm@11.7.0"
+  "packageManager": "pnpm@11.7.0",
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-theme": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    }
+  }
 }

package/palette-dev.mjs

@@ -1,140 +0,0 @@
-/**
- * 配色报表（开发期）。
- *
- * 直接加载 client.js 的**生产引擎**（经 window.__DSH_THEME_PALETTE_DEV__ 这个开发期钩子），
- * 不保留第二份配色实现 —— 早先这份文件自带旧引擎，报表和上线不是同一套。
- *
- * 用法：node palette-dev.mjs
- */
-import fs from 'node:fs'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const here = path.dirname(fileURLToPath(import.meta.url))
-const source = fs.readFileSync(path.join(here, 'client.js'), 'utf8')
-
-let engine = null
-const sandbox = {
-  window: {
-    __ModuleLoader__: { load: (def) => { sandbox.__def = def } },
-    __DSH_THEME_PALETTE_DEV__: (api) => { engine = api },
-  },
-  localStorage: { getItem: () => null, setItem: () => {} },
-  document: { documentElement: { lang: 'zh' } },
-  navigator: { language: 'zh' },
-}
-new Function('window', 'localStorage', 'document', 'navigator', source)(
-  sandbox.window, sandbox.localStorage, sandbox.document, sandbox.navigator,
-)
-sandbox.__def.factory(() => ({
-  createElement: () => null,
-  useState: () => [null, () => {}],
-  useSyncExternalStore: () => 'mono',
-}))
-if (!engine) throw new Error('生产引擎没有暴露 dev 钩子')
-
-const { buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, contrast, toOklch } = engine
-
-/** 真实承载面 → 落在该面上的前景。取自宿主 ui-theme 的别名映射。 */
-const SURFACES = [
-  { name: '画布 00', step: 'neutral-bluish-00', fg: ['1000', '700', '600', 'link500'] },
-  { name: '卡层 60', step: 'neutral-bluish-60', fg: ['1000', '700', '600', 'link500'] },
-  { name: '悬浮 150*', step: 'neutral-bluish-150', fg: ['600', 'link500'], scope: false },
-  { name: '深画布 950', step: 'neutral-bluish-950', fg: ['50', '300', '400', 'link400'] },
-  // 875 = bg-layer-1（弹层/抽屉），850 = bg-layer-2，800 = bg-layer-3 兼 bg-module-platform。
-  // 三层都要报：文末的「承诺面」是这三个面里最亮的 800，不是画布。
-  { name: '深层1 875', step: 'neutral-bluish-875', fg: ['50', '300', '400', 'link400'] },
-  { name: '深卡 850', step: 'neutral-bluish-850', fg: ['50', '300', '400', 'link400'] },
-  { name: '深模块 800', step: 'neutral-bluish-800', fg: ['50', '300', '400', 'link400'] },
-]
-// 合规下限：低于它才是违规（正文 AAA 7 / 次级与三级 AA 4.62）。
-// '1000' 的 15.5 与 '700' 的 6.2 是设计目标，一并当硬线放在这里，因为浅色侧从来没破过。
-const FLOOR = { '1000': 15.5, '700': 6.2, '600': 4.62, link500: 4.62, '50': 7, '300': 6, '400': 4.62, link400: 4.62 }
-// 设计目标（高于 WCAG）：深色正文希望 ≥10。缺口只记 △，不算违规 ——
-// 800 是最亮的深色面（layer-3 / module），正文在那里天然最低（8.95–9.56，仍是 AAA 7 的 1.3 倍）。
-const TARGET = { '50': 10 }
-
-// 链接报**实际渲染用的那条**（`--dsw-alias-link`），不是色阶中段：
-// 中段 500 是设计稿给的标准色（品牌基准色），它在浅色 150 面上本来就过不了 AA，
-// 插件已把「当文字用」的链接单独派生。若改用 static-500 报，会报出一个界面里不存在的数值。
-const getter = (tokens) => (key) => {
-  if (key === 'link500') return tokens['--dsw-alias-link'].light
-  if (key === 'link400') return tokens['--dsw-alias-link'].dark
-  const name = /^[0-9]+$/.test(key) ? `neutral-bluish-${key}` : key
-  return tokens[`--dsw-static-${name}`].light
-}
-
-const lab = (hex) => {
-  const [L, C, h] = toOklch(hex)
-  return [L, C * Math.cos((h * Math.PI) / 180), C * Math.sin((h * Math.PI) / 180)]
-}
-const dE = (x, y) => {
-  const [L1, a1, b1] = lab(x), [L2, a2, b2] = lab(y)
-  return Math.hypot(L1 - L2, a1 - a2, b1 - b2) * 100
-}
-
-let violations = 0
-for (const scheme of SCHEMES) {
-  if (!scheme.tinted) { console.log(`\n=== ${scheme.label} ===（未覆盖，走宿主原值）`); continue }
-  const tokens = buildTokens(scheme, 'deep')
-  const get = getter(tokens)
-  console.log(`\n=== ${scheme.label} ===`)
-  for (const surface of SURFACES) {
-    const bg = get(surface.step)
-    const parts = surface.fg.map((fg) => {
-      const ratio = contrast(get(fg), bg)
-      const ok = surface.scope === false ? true : ratio >= FLOOR[fg]
-      if (!ok) violations++
-      const short = ok && TARGET[fg] !== undefined && ratio < TARGET[fg]
-      return `${fg} ${ratio.toFixed(2)}${ok ? (short ? ' △' : '') : ' ✗'}`
-    })
-    console.log(`  ${surface.name.padEnd(12)} ${bg}  ${parts.join('  ')}`)
-  }
-
-  console.log('  品牌基准色 / 链接')
-  {
-    const anchor = tokens['--dsw-static-deepseek-500'].light
-    const rgb = 'rgb(' + [1, 3, 5].map((i) => parseInt(anchor.slice(i, i + 2), 16)).join(', ') + ')'
-    const lk = tokens['--dsw-alias-link']
-    console.log(`    基准色 500 ${anchor} ${rgb}（卡片预览 / info 填充 / 焦点环）`
-      + `  白字对比 ${contrast('#ffffff', anchor).toFixed(2)}`)
-    console.log(`    链接 浅 ${lk.light}  对 150 ${contrast(lk.light, get('neutral-bluish-150')).toFixed(2)}`
-      + ` / 卡层 ${contrast(lk.light, get('neutral-bluish-60')).toFixed(2)}`
-      + `  | 深 ${lk.dark}  对 800 ${contrast(lk.dark, get('neutral-bluish-800')).toFixed(2)}`)
-  }
-
-  console.log('  侧栏三档（ΔE：画布↔侧栏 / 悬停 / 选中）')
-  for (const mode of SIDEBAR_MODES) {
-    const tk = buildTokens(scheme, mode.id)
-    const fill = tk['--dsw-specific-sidebar-fill'].light
-    const hov = tk['--dsw-specific-sidebar-nav-item-hover'].light
-    const act = tk['--dsw-specific-sidebar-nav-item-active'].light
-    const dFill = tk['--dsw-specific-sidebar-fill'].dark
-    const dHov = tk['--dsw-specific-sidebar-nav-item-hover'].dark
-    const dAct = tk['--dsw-specific-sidebar-nav-item-active'].dark
-    const canvas = get('neutral-bluish-00')
-    const dCanvas = get('neutral-bluish-950')
-    const mark = mode.id === 'deep' ? ' ←默认' : ''
-    console.log(`    ${mode.label}  浅 ${fill} / ${hov} / ${act}  ΔE ${dE(canvas, fill).toFixed(2)}/${dE(fill, hov).toFixed(2)}/${dE(fill, act).toFixed(2)}${mark}`)
-    console.log(`    ${''.padEnd(mode.label.length)}  深 ${dFill} / ${dHov} / ${dAct}  ΔE ${dE(dCanvas, dFill).toFixed(2)}/${dE(dFill, dHov).toFixed(2)}/${dE(dFill, dAct).toFixed(2)}`)
-  }
-}
-
-console.log(`\n低于下限的配对：${violations} 处`)
-console.log(`侧栏档位：${SIDEBAR_MODES.map((m) => m.label).join(' / ')}`)
-
-console.log('\n文字着色三档')
-for (const scheme of SCHEMES) {
-  if (!scheme.tinted) continue
-  console.log(`  ${scheme.label}`)
-  for (const mode of TEXT_MODES) {
-    const t = buildTokens(scheme, 'deep', mode.id)
-    const g = (k) => t[`--dsw-static-${k}`].light
-    const cL = (fg, bg) => contrast(g(fg), g(bg)).toFixed(2)
-    console.log(`    ${mode.label.padEnd(4)} 正文 ${g('neutral-bluish-1000')}  次文 ${g('neutral-bluish-700')}`
-      + `  深正文 ${g('neutral-bluish-50')}`
-      + `  | 正文 ${cL('neutral-bluish-1000', 'neutral-bluish-00')}`
-      + `  三级 ${cL('neutral-bluish-600', 'neutral-bluish-60')}`
-      + `  深正文 ${cL('neutral-bluish-50', 'neutral-bluish-950')}`)
-  }
-}

package/tools/README.md

@@ -1,66 +0,0 @@
-# 截图回归
-
-配色插件的回归分两层，**能跑哪层取决于你想要多接近真实界面**。
-
-| 层 | 截的是什么 | 需要什么 | 能发现什么 |
-|---|---|---|---|
-| **A. 配色看板**（已就绪） | `tools/sheet.html`：每套配色一屏，浅色 + 深色两个面板，内含侧栏条目、气泡、卡片、代码块、按钮、开关、滚动条、正文四档文字 | 只要 Chrome/Edge | 配色系统本身的变化：色相、层次、对比度、气泡/按钮的落色 |
-| **B. 真机**（需一次重启） | 桌面版**真实窗口**（Electron 渲染进程） | 桌面版以 `--remote-debugging-port=9333` 启动一次 | 真实内容下的观感、真实间距/组件、宿主改版导致的偏移 |
-
-两层的产物都进 `tools/out/<run>/`，与 `tools/baseline/` 做 sha256 对比。
-
-## A. 配色看板
-
-```bash
-node tools/sheet.mjs                              # 生成 tools/sheet.html（颜色来自生产引擎）
-node tools/shoot-sheet.mjs                        # 4 张 → tools/out/<时间戳>/
-node tools/compare.mjs --dir tools/out/<run>      # 与基线比
-node tools/compare.mjs --dir tools/out/<run> --update   # 认这次为新基线
-```
-
-同一台机器上渲染是确定的：连跑两次哈希一致（已实测 4/4 未变），所以**字节变化 = 像素变化**，
-不需要容忍阈值。变了就并排看两张 PNG。
-
-## B. 桌面版真机
-
-桌面版是 Electron，Web GUI 跑在渲染进程里、鉴权由 App 内部完成，所以外部拿不到 token ——
-但 Electron 支持标准 CDP，只要**带调试端口启动一次**：
-
-```powershell
-# 关掉当前 DSH，然后：
-& "D:\Programs\DeepSeek Harness\DeepSeek Harness.exe" --remote-debugging-port=9333
-```
-
-（想长期这样用：右键桌面快捷方式 → 属性 → 目标末尾加 ` --remote-debugging-port=9333`。）
-
-然后：
-
-```bash
-node tools/shoot-desktop.mjs --out tools/out/desk1        # 4 套 × 浅/深 = 8 张
-node tools/compare.mjs --dir tools/out/desk1 --baseline tools/baseline-desktop
-```
-
-`shoot-desktop.mjs` 的驱动方式不是"点界面"，而是走插件自己的开发期接口：
-
-```js
-window.__DSH_THEME_PALETTE_DEV__.setPalette('warm')
-window.__DSH_THEME_PALETTE_DEV__.setTheme('dark')
-```
-
-这样不依赖按钮文字、不依赖设置页结构，宿主改版也不会把脚本搞坏。**抓完会把原来的配色与
-明暗偏好还原**（`setTheme` 会写进宿主设置，不还会改用户配置）。
-
-> 为什么不用 `--profile desktop --dump-config` 之类：那验的是配置层，不是渲染层，
-> 而配色的问题全都长在渲染层（色域、层次、对比度）。
-
-## 什么时候跑
-
-- 改 `SCHEMES` / `TEXT_MODES` / `SIDEBAR_MODES` 等参数之后；
-- 改 `aliasOverrides`（气泡、按钮、边框、滚动条、注释）之后；
-- 升宿版本之后（token 名或步号映射可能变）。
-
-## 已知边界
-
-- A 层是**忠实投影**但不是真机：不含宿主的真实排版、字体回退、外部插件注入的样式；
-- B 层依赖调试端口，属于开发期手段，不要常开；
-- 两层都只做"变了没有"，不做"变得对不对" —— 判断仍要人看。

package/tools/compare.mjs

@@ -1,62 +0,0 @@
-/**
- * 截图回归比对：把一批截图与基线逐张比 sha256，报「新增 / 未变 / 变化」。
- *
- * 为什么用哈希而不是逐像素差分：同一台机器、同一 Chrome、同一视口下渲染是确定的
- * （`--force-color-profile=srgb` + `deviceScaleFactor` 固定），字节相同就真的没变；
- * 变了就是像素变了，不需要容忍阈值。要「变在哪」就看两张 PNG 并排。
- *
- * 用法：
- *   node tools/compare.mjs --dir tools/out/<run>            # 与基线比
- *   node tools/compare.mjs --dir tools/out/<run> --update   # 把这次设为新基线
- */
-import fs from 'node:fs'
-import path from 'node:path'
-import { createHash } from 'node:crypto'
-import { fileURLToPath } from 'node:url'
-
-const here = path.dirname(fileURLToPath(import.meta.url))
-const argv = process.argv.slice(2)
-const arg = (k, d) => { const i = argv.indexOf('--' + k); return i >= 0 ? argv[i + 1] : d }
-const has = (k) => argv.includes('--' + k)
-
-const dir = path.resolve(arg('dir', path.join(here, 'out')))
-const base = path.resolve(arg('baseline', path.join(here, 'baseline')))
-if (!fs.existsSync(dir)) { console.error('找不到截图目录：' + dir); process.exit(2) }
-
-const hash = (p) => createHash('sha256').update(fs.readFileSync(p)).digest('hex').slice(0, 16)
-const pngs = (d) => fs.existsSync(d) ? fs.readdirSync(d).filter((f) => f.endsWith('.png')).sort() : []
-
-if (has('update')) {
-  fs.mkdirSync(base, { recursive: true })
-  for (const f of fs.readdirSync(base)) if (f.endsWith('.png')) fs.unlinkSync(path.join(base, f))
-  for (const f of pngs(dir)) fs.copyFileSync(path.join(dir, f), path.join(base, f))
-  console.log(`✓ 基线已更新：${base}（${pngs(dir).length} 张）`)
-  process.exit(0)
-}
-
-const current = pngs(dir)
-const baseline = pngs(base)
-if (baseline.length === 0) {
-  console.log('还没有基线。第一次请跑：node tools/compare.mjs --dir ' + path.relative(process.cwd(), dir) + ' --update')
-  process.exit(2)
-}
-
-const rows = []
-let changed = 0
-let missing = 0
-for (const name of current) {
-  const inBase = baseline.includes(name)
-  const same = inBase && hash(path.join(dir, name)) === hash(path.join(base, name))
-  if (!inBase) missing++
-  else if (!same) changed++
-  rows.push({ name, status: !inBase ? '新增（基线里没有）' : same ? '未变' : '变化', size: fs.statSync(path.join(dir, name)).size })
-}
-const gone = baseline.filter((n) => !current.includes(n))
-
-const pad = (s, n) => String(s).padEnd(n)
-console.log(pad('截图', 26) + pad('状态', 18) + '大小')
-for (const r of rows) console.log(pad(r.name, 26) + pad(r.status, 18) + (r.size / 1024).toFixed(0) + ' KB')
-if (gone.length) console.log('\n基线里有、这次没抓：' + gone.join(', '))
-
-console.log(`\n合计 ${current.length} 张：未变 ${current.length - changed - missing}，变化 ${changed}，新增 ${missing}`)
-process.exit(changed + missing > 0 ? 1 : 0)