dsh-desktop-acrylic
适用于 DeepSeek Harness (DSH) Desktop 的 Tokyo Night 深色和浅色主题——真正的主题运行时皮肤，配备亚克力面板、材质模糊效果和等宽字体选择器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:LeoLee0097/dsh-desktop-acrylic#eda9c03f345863210d21ba19149c0cc528ab3a03Desktop Acrylic 以 dsh-desktop-acrylic 发布，当前版本为 0.9.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 · English
Tokyo Night themes for DeepSeek Harness (DSH) Desktop — 两套主题（暗色 / 亮色）、磨砂面板、等宽字体选择。
两套皮肤都是注册进内置主题运行时的真实主题（ctx.theme.register），因此切换主题就是切换
运行时偏好本身，不依赖属性开关或事后 CSS 覆盖。
DSH Desktop 测试版下载：deepseek-harness 讨论区。
若你在论文、报告或其它项目中使用本项目，请引用它 —— 引用模板见引用与许可， 仓库根目录也提供了机器可读的
CITATION.cff（GitHub 会据此显示 "Cite this repository"）。
暗色 —— 欢迎页：
亮色 —— 欢迎页：
设置窗口 —— 磨砂面板与背景遮罩模糊（暗色；可见「Tokyo Night 主题」设置行与 masks 1 诊断）：
| 能力 | 实现方式 | 参数 |
|---|---|---|
| 主题：Tokyo Night 暗色 / 亮色 | 皮肤 token（静态色阶 + 别名色阶 + 组件专属 + 语法高亮），两套各 180 个 token | 暗色底#1a1b26；亮色底偏白（#e7e8ee → #eff1f6 一族） |
| 图标随主题变色 | 桌面端用currentColor 绘制图标且没有图标专属 token，因此图标自动跟随 --dsw-alias-label-* / --dsw-alias-brand-primary | 无需额外配置 |
| 画布透明度 | 背景族 token 带 alpha | 暗色0.10（90% 透明）；亮色 0.30 |
| 材质底层 | 用主题自身的蓝/紫/青做的柔和色场，固定在最底层并预模糊 | 强度 暗 30% / 亮 24%，blur(28px) |
| 弹出菜单 / 下拉 / 浮层 | 皮肤下发--dsw-menu-backdrop-filter，由桌面端自带材质通路渲染 | blur(24px) saturate(1.15) |
| 对话框（设置窗口等） | 磨砂面板：定位元素走 isolation + 绝对定位 ::before；静态元素（设置窗口常见）改把模糊直接加在元素上，但先排除含 position: fixed 后代的对话框 | 底色rgba(…, 0.75)（25% 透明）+ blur(30px) |
| 对话框背景遮罩 | 弹窗背后压暗页面的遮罩挂 backdrop-filter，透出磨砂主界面；原生 <dialog> 走 ::backdrop；prefers-reduced-transparency 时随模糊层一并停用 | blur(12px) saturate(1.1)（--dwa-mask-blur） |
| 工作区主侧栏 | 均匀颗粒纹理（纯background-image，无方向性、无边缘） | 暗色 6% / 亮色 14%（明暗感知不对称，故分开设值） |
| 卡片与表格（genui） | 把卡片库自带的--tv-* 调色板桥接到我们的别名 token | 22 条桥接，覆盖表面 / 交互 / 文字 / 图标 / 边框 |
| 原生控件 | color-scheme 随主题切换 | 滚动条、复选框等原生部件一并跟随 |
| 字体 | 两个可搜索下拉（界面字体 / 代码字体），列出本机可用的等宽字体（含 NF / PL 变体） | 见下文「字体探测」 |
集中定义：src/theme.mjs 的 ACRYLIC（模糊半径等）、surfaceTable（表面与 alpha）、
MONO_FONTS / MONO_FONT_BASES / MONO_FONT_SUFFIXES（字体数据）；样式规则由构建脚本生成。
# 从 GitHub
dsh plugin --profile desktop add github:LeoLee0097/dsh-desktop-acrylic
# 从本地目录（-w 必需，profile 目录本身是 pnpm workspace 根）
dsh plugin --profile desktop add -w /absolute/path/to/dsh-desktop-acrylic
安装后完全退出并重启 DSH Desktop。此后单独重载渲染进程也会重新拉取客户端包。
| 插件版本 | 支持的 DSH | 说明 |
|---|---|---|
| 0.9.0+ | 0.2.0-rc.1 及更高 | peer 依赖对齐 @deepseek-ai/dsh-client-* @ ^0.2.0-rc.1、@deepseek-ai/cordis @ ^4.0.4；移除已下线的 @deepseek-ai/dsh-client-runtime，改为声明实际提供服务的包（dsh-client-store / dsh-client-locale / dsh-client-ui-theme / dsh-client-ui-settings-general） |
| 0.9.2+ | 0.2.0-rc.2 已验证 | 在 DSH 0.2.0-rc.2 上实测：全部 peer 仍然满足（^0.2.0-rc.1 覆盖同 0.2.0 三元组的预发布版本，如 rc.2）。注意精确版本豁免是按 DSH 版本记账的：升级 DSH 后老的 exemption 全部失效，需要按新版本重新生成 compatibility.json |
| 0.8.x 及更早 | 0.1.0-rc.6 一线 | 仍声明 dsh-client-runtime ^0.1.0-rc.6，在 DSH 0.2.0-rc.1 上会被插件管理器判定不兼容 |
若你从 0.8.x 升级到 0.9.0：拉到新版本后重启 DSH Desktop 即可，插件管理器会重新读取
peerDependencies；若仍提示不兼容，请重新执行上面的安装命令刷新 profile 的依赖记录。
本次升级不涉及任何客户端 API 变更——__ModuleLoader__、ctx.slots.inject/register、
ctx.theme.register、ctx.on('theme/change')、webServer.register({ kind: 'exact' })
在 0.2.0-rc.1 中均保持不变（已逐一核对）。
声明：开发者主要在 DSH Desktop 内测版中使用本插件，未在网页端进行过测试。如遇异常， 请把设置行诊断信息（
preference/matched/masks等）一并反馈。
同一插件可直接装到 web profile——桌面端本来就跑在 @deepseek-ai/dsh-web-app 上，浏览器半边
按 platform: "web" 声明，安装命令只是把 profile 换掉：
dsh plugin --profile web add github:LeoLee0097/dsh-desktop-acrylic
# 或本地目录
dsh plugin --profile web add -w /absolute/path/to/dsh-desktop-acrylic
网页端与桌面端的差异（客户端已自动降级，无需配置）：
localStorage——网页端 origin 固定，这层反而比桌面端更稳；matched / masks 会如实显示 0。安装后完全退出并重启 DSH Desktop。此后单独重载渲染进程也会重新拉取客户端包。
注意：宿主半边（
lib/index.js）的改动只有重启进程才会生效，因为它的路由表在进程启动时 注册。客户端半边（lib/client.js）与数据表只需重载渲染进程。这一区别曾经导致过 「明明改了却 404」的误判，故明确写在这里。
设置 → 通用 → 「Tokyo Night 主题」：
当前偏好 · bg-base 计算值 · chrome on/off · hosts 已挂载/候选 · frost n · panels n。bg-base 取自 getComputedStyle(document.body)，是浏览器实际解析出的值——用来确认主题真的
落到了级联上，而不是「看起来没变化」。
浏览器不允许枚举系统已安装字体，因此字体列表由两条路合并而成：
MONO_FONT_BASES × MONO_FONT_SUFFIXES
（42 基名 × 6 后缀 = 252 个探测名，后缀含 NF / NFM / Nerd Font / Nerd Font Mono / PL）。
用 canvas 测量候选字体与三个 fallback 下的同一段文本宽度，任一不同即判定存在。name 表（族名）与
post 表的 isFixedPitch（格式自带的等宽标志），因此能发现候选表之外的族（含 CJK 等宽）。两者取并集。诊断字段 fontSource 会如实报告 probe / host / host+probe，fontCount 是条目数。
node scripts/check-fonts.mjs # 打印宿主扫描结果（等宽清单）
node scripts/check-fonts.mjs --all # 另外打印全部族名
dsh-desktop-acrylic/
├── src/
│ ├── theme.mjs # 调色板、两套皮肤、面板/纹理/字体/桥接 CSS（手写，规范来源）
│ └── client.tpl.js # 浏览器半边模板（手写）
├── scripts/
│ ├── build.mjs # 构建 + 自检 → 产出下面两项
│ └── check-fonts.mjs # 本机字体扫描的调试工具
├── lib/
│ ├── index.js # 宿主半边：状态路由 + 本机字体路由
│ └── client.js # 浏览器半边（GENERATED，勿手改）
├── themes/
│ ├── tokyo-night.json
│ └── tokyo-night-day.json
├── docs/desktop-window-material.md
├── cordis.patch.yml # profile 补丁层：insert 一个 loader 条目
├── package.json # dsh.bundle.patch + dsh.client.inject 两处声明
└── LICENSE / README.md / .gitignore / .gitattributes / snapdark.png / snaplight.png / setting.png
node scripts/build.mjs # 或 npm run build
构建脚本在写盘前做四类自检，任一条不通过就直接失败：
#hex、rgb(a)、color-mix、blur(..) saturate(..)、
transparent、<n>px，或指向自身别名 token 的 var(--dsw-…)），且不含分号花括号；::before 图层上、磨砂面板必须带不透明底色 token，且没有任何规则
给布局容器本体加滤镜或定位。插件把运行实况上报给宿主路由，写入 ~/.dsh/dark-acrylic-state.json：
curl http://127.0.0.1:<端口>/dark-acrylic/state # 状态与上报
curl http://127.0.0.1:<端口>/dark-acrylic/fonts # 本机字体目录（host 扫描）
curl -X PUT http://127.0.0.1:<端口>/dark-acrylic/preference \
-H 'content-type: application/json' \
-d '{"preference": "tokyo-night"}' # 主题偏好落盘到 profile 补丁层
curl http://127.0.0.1:<端口>/dark-acrylic/preference # 回读各 profile 补丁层的 ui-theme 偏好
{
"version": 2,
"plugin": "tokyo-night-theme",
"themes": ["tokyo-night", "tokyo-night-day"],
"chosen": "tokyo-night",
"acrylic": true,
"font": "LXGW WenKai Mono",
"codeFont": "",
"preference": "tokyo-night",
"chrome": true,
"hosts": 0,
"hostStats": { "matched": 23, "armed": 0, "skipped": 23 },
"frost": 1,
"panels": 1,
"masks": 1,
"heals": 0,
"layer": "written",
"fontSource": "probe",
"fontCount": 18,
"panelDebug": ["div.ZTP_x 900x600 → flat"],
"maskDebug": ["div.aGz_z → mask"],
"computed": {
"bgBase": "rgba(22, 22, 30, 0.1)",
"sidebar": "rgba(15, 16, 23, 0.1)",
"menuBlur": "blur(24px) saturate(1.15)"
},
"instance": "…",
"at": "…"
}
hosts / hostStats 用来解释「为什么某处没有磨砂」：matched 是候选容器数，armed 是成功
挂上模糊层的数量——布局列普遍是静态元素，被守卫拒绝是正常结果。heals 是静默重置侦测触发恢复
的次数（健康 shell 中恒为 0，持续大于 0 说明 shell 在反复重置偏好）；layer 是偏好落盘状态
（written / unchanged / error / unavailable）。
panels 是当前挂着磨砂面板的对话框数量；panelDebug 逐条说明为什么被挂上或被跳过：
div.… 900x600 → flat、→ positioned、→ skip(static, anchored=3)、→ skip(small)。anchored 是
框内 position: fixed/absolute 后代总数——静态对话框本体不是包含块，滤镜一旦落在本体上，这些后代
会被重新锚进框内并被裁剪（工具栏只显示一半），所以含锚定后代的静态对话框一律不做 flat 磨砂。对话框
没效果时，先看这一行。
masks 是背后遮罩被磨砂的数量；maskDebug 记录遮罩命中情况：div.… → mask（命中）或
div.… → no-mask（没找到符合「视口级 fixed/absolute 覆盖层」的父级或相邻兄弟——原生
<dialog> 此时仍走 ::backdrop 规则）。背景没磨砂时先看这一行。
backdrop-filter：它会让元素成为 position: fixed 后代的包含块，
而桌面端把侧栏开关、新建会话按钮正是这样钉在标题栏上的——结果就是控件重新锚定、直接消失。--dsw-font-family: X, var(--dsw-font-family) 是 CSS 循环，
会让该变量与所有读取它的 font: 简写一起失效。t（来自 locale）、useStore（来自 store）、
以及 inject(actions) 的返回值——props 上没有环境里的主题服务。<select> 的弹出列表是系统级窗口，只能靠
color-scheme 间接影响，长列表的滚轮行为也不可靠；需要可控的下拉就得自绘。::before 上，静态面板（设置窗口就是这种）会被守卫
整体跳过、表现为「完全没效果」。要覆盖两种结构，就得有一条把模糊直接加在元素上的兜底路径，
并且先排除含 position: fixed 后代的对话框——那类后代正是滤镜会重新锚定的对象。system）——且不发可靠事件、不重读补丁层（已验证：重置从不写 cordis.patch.yml，运行期写
补丁文件也进不了运行中的会话）；快照应用的时机还在我们插件 apply 之后，所以启动时 setTheme
总是先赢后输。对策就是 0.8.6 的恢复网：偏好落盘进补丁层（跨重启有效）、DOM 突变 / 点击事件驱动
heal、theme/change('system') 签名立即重断言 + 事后回读补丁层判定（真选则让位）。Windows 上主窗口没有申请窗口材质（只有欢迎窗口有；macOS 主窗口是 vibrancy: "sidebar"）。
因此本插件在 Windows 能做到的是：配色、半透明表面、面板与浮层的磨砂，以及一层应用内的材质
色场；「主界面透出桌面」需要桌面端主进程给主窗口加 backgroundMaterial: "acrylic" 与透明
底色，见 docs/desktop-window-material.md。
prefers-reduced-transparency: reduce 时模糊层自动停用。
0.9.3 — 撤掉卡片正文上的 overflow-x: auto：把它当滚动容器会给绝对定位子元素一个 0 高度视口，「卡片空白」正是这样产生的；改为只保留 min-width: 0，并新增 CARD_CSS_ENABLED 开关，需要时一键关掉整段卡片规则。同时记录「卡片渲染失效」的真实归因：那是 dsh-genui 在 DSH 升级后被拒绝加载（精确版本豁免按 DSH 版本记账，旧授权对新版本无效），与主题无关。
0.9.2 — 适配 DSH 0.2.0-rc.2（5 条 peer 全部复核通过）+ 「全透明」兜底：材质场此前只画在 body::before 上，一旦该伪元素不绘制（层叠上下文变化 / 节点被替换 / 滤镜被丢弃），而 html 底色在暗色下又是 transparent，页面背后就什么都没有，表现为界面整体突然透明。现在同一份材质同时画在 body 自身的 background-image 上，并配近不透明的 --dwa-canvas-base（暗色 88%），最坏情况是画布变朴素，而不是整个界面消失。诊断新增 canvas / material。
0.9.1 — 卡片宽度修复：卡片库用类而不是容器决定宽度（.tiny-card.tiny-card--large-width{width:var(--tv-Card-large-width)}，而该变量在 .tiny-card 自身上声明为 4px × 144 = 576px），因此未写 auto-width 的卡片只占半行。现用选择器中和四个宽度类（width: auto; max-width: 100%）。规则放在基础样式里，与亚克力层无关。
0.9.0 — 兼容 DSH 0.2.0-rc.1：peer 依赖升级到 @deepseek-ai/dsh-client-* ^0.2.0-rc.1 与
@deepseek-ai/cordis ^4.0.4；移除已下线的 @deepseek-ai/dsh-client-runtime，客户端模块依赖改为
声明实际提供所需服务的包（store / locale / ui-theme / ui-settings-general）。运行期 API 未变，
无需改动任何插件代码——仅元数据对齐。
0.8.6 — 偏好落盘 + 静默重置侦测：主题选择写入 profile 补丁层的 ui-theme 配置（与原生主题
选择同一落点），跨重启不丢；但 shell 的 ui-theme 配置是会话启动时组合一次的快照，运行期
写补丁文件不会进入运行中的会话——切换模型 / 思考强度、开关设置菜单等任意设置变更触发重建时，
它重放的是会话快照（经我们界面选主题时从未进过快照的 system），把运行时偏好重置回去（已验证：
重置从不写补丁文件）。因此每层重建都需要当场应答：DOM 突变观察者（250ms 去抖 + 廉价预检后直接
heal，无二次去抖）在突变落定瞬间恢复，每次 chrome 同步时重新锚定到当前根元素（防止整树替换后
观察者挂在已分离节点上静默死亡），pointerdown 监听覆盖不改变 DOM 的重置；收到重置签名
theme/change('system') 时立即重断言（否则用户每次改设置都要看 1.5 秒默认主题），随后的
1.5s / 3.5s 两拍经 GET /dark-acrylic/preference 回读补丁层判定：层值仍等于已存选择即为重置，
继续恢复并回写补丁层加固；层值已是 system 即为用户在原生界面真选默认（原生选择会持久化进补丁层，
fontSize 同块可证），镜像并让位（重新应用 system）。经我们设置行选「默认」先持久化后发事件，
不会被误反击。诊断新增 heals 计数与 layer 落盘状态（设置行同时显示 heals）。
0.8.5 — 对话框背景遮罩磨砂：弹窗背后压暗页面的遮罩现在挂 backdrop-filter（默认
blur(12px) saturate(1.1)，可调 --dwa-mask-blur），透出磨砂主界面；原生 <dialog> 走
::backdrop；诊断新增 masks / maskDebug，设置行显示 masks。
本项目的正式名称、版本与 URL：
| 字段 | 值 |
|---|---|
| 名称 | dsh-desktop-acrylic |
| 副题 | Tokyo Night themes for DeepSeek Harness Desktop |
| 作者 | LeoLee0097 |
| 版本 | 0.8.6 |
| 年份 | 2026 |
| 仓库 | https://github.com/LeoLee0097/dsh-desktop-acrylic |
| 许可 | MIT |
BibTeX（推荐，适用于 LaTeX / Zotero / JabRef）
@software{leolee0097_dsh_desktop_acrylic_2026,
author = {LeoLee0097},
title = {{dsh-desktop-acrylic}: Acrylic {Tokyo} Night style themes for {DeepSeek} {Harness} Desktop},
year = {2026},
version = {0.8.6},
license = {MIT},
url = {https://github.com/LeoLee0097/dsh-desktop-acrylic},
note = {Dark and light themes, acrylic panels, monospace font picker}
}
GB/T 7714-2015（中文论文常用，电子资源 [EB/OL]）
LeoLee0097. dsh-desktop-acrylic: DeepSeek Harness Desktop 的 Tokyo Night 风格磨砂界面主题[EB/OL].
(2026-09-26)[2026-09-26]. https://github.com/LeoLee0097/dsh-desktop-acrylic.
APA 7（计算机软件 [Computer software]）
LeoLee0097. (2026). dsh-desktop-acrylic: Acrylic Tokyo Night style themes for DeepSeek Harness Desktop
(Version 0.8.6) [Computer software]. https://github.com/LeoLee0097/dsh-desktop-acrylic
MLA 9
LeoLee0097. "dsh-desktop-acrylic: Acrylic Tokyo Night Style Themes for DeepSeek Harness Desktop." GitHub, 2026,
github.com/LeoLee0097/dsh-desktop-acrylic. Accessed 26 Sept. 2026.
纯文本（README、博客、演示稿末尾一类场合）
dsh-desktop-acrylic — Acrylic Tokyo Night style themes for DeepSeek Harness Desktop, by LeoLee0097 (MIT).
https://github.com/LeoLee0097/dsh-desktop-acrylic
引用日期请替换为你实际访问的日期；版本号随发布更新。机器可读版本见 CITATION.cff。
配色灵感与色值来源为 Tokyo Night（作者 enkia），本项目对亮色盘做了提亮与降饱和处理， 并新增了面板、纹理与桥接层：
enkia. Tokyo Night[EB/OL]. https://github.com/enkia/tokyo-night-vscode-theme.
如果你同时需要使用上游配色，请一并向其致谢；上游与本项目均为 MIT 许可。
MIT —— 见 LICENSE。
0.8.4 — 对话框磨砂修复：新增静态对话框兜底路径（模糊直接加在元素上，并先排除含 position: fixed
后代的对话框）；诊断新增 panelDebug 与 panels，设置行也显示 panels / fonts。
0.8.3 — 文档：中英文双语 README（README.md / README.en.md）、CITATION.cff 与引用模板。
0.8.x — 字体：改为列出本机可用的等宽字体（渲染进程探测 + 宿主目录扫描，含 NF / PL 变体）；
自绘可搜索下拉替代原生 select（原生弹层滚不动）；卡片与表格桥接 tiny-vue 调色板；
原生控件 color-scheme 随主题。
0.7.x — 字体输入框 → 下拉菜单（仅等宽）；宿主新增 /dark-acrylic/fonts 路由。
0.6.x — 亮色盘整体提亮、降饱和、文字加深；侧栏与画布同源消除竖向色差；颗粒改为无方向均匀纹理 并按主题分设强度；对话框改为真正的磨砂面板（25% 透明 + 30px 模糊）。
0.5.x — 静态磨砂纹理（供无法模糊的侧栏使用）、对话框几何判定试验与相应收紧、
frost / frostTargets 诊断。
0.4.x — 材质底层（柔和色场）解决「没有东西可模糊」；色场强度与预模糊调优； 菜单材质半径与 chrome 层解耦。
0.3.x — 按「用主题的方式实现」重做：两套真实皮肤 + 设置行（主题 / 字体）+ 亚克力层； 分阶段启用定位故障面；安全模式加固（不透明页面基色、可读性优先 alpha、失败隔离、构建期校验）。
0.1.0 - 0.2.x — 早期版本：皮肤注册、设置行、持久开关、透明度档位与相应回归修复。