前言¶
在 DeepSeek Harness（DSH）里长时间跑智能体、看日志和调设置时，界面是否顺眼、文字是否好读，会直接影响日常效率。不少同学会靠浏览器扩展或事后改 CSS 给客户端「换皮」，但这类做法往往和内置主题系统脱节：切换主题时颜色 token 对不上，磨砂、侧栏纹理等也容易被覆盖掉。
下面介绍社区插件 dsh-desktop-acrylic（维护者 LeoLee0097，分类：趣味换装）。它把 Tokyo Night 暗色 / 亮色两套皮肤注册进 DSH 桌面端内置主题运行时（ctx.theme.register），切换主题即切换运行时偏好，而不是依赖属性开关或事后 CSS 覆盖；同时提供亚克力磨砂面板、材质模糊背景，以及本机等宽字体选择器。
这是什么¶
dsh-desktop-acrylic 是面向 DeepSeek Harness Desktop 的主题插件：Tokyo Night 暗色与亮色各约 410 个皮肤 token（静态色阶、别名色阶、组件专属、语法高亮），并配套对话框磨砂、弹出层 backdrop、工作区侧栏颗粒纹理，以及 genui 卡片库 --tv-* 到别名 token 的桥接（README 记载 249 条，覆盖卡片库引用的全部 --tv-color-* 名称）。
插件当前版本为 0.9.22（见仓库 package.json），许可证 MIT。目录页：SkillHub - dsh-desktop-acrylic；源码：GitHub - LeoLee0097/dsh-desktop-acrylic。
DSH Desktop 测试版获取方式见 deepseek-harness 讨论区。
核心功能¶
真实主题运行时，而非外挂样式¶
两套皮肤都通过 ctx.theme.register 注册。图标在桌面端用 currentColor 绘制且无图标专属 token 时，会跟随 --dsw-alias-label-* / --dsw-alias-brand-primary 变色，无需额外配置。color-scheme 随主题切换，滚动条、复选框等原生控件一并跟随。
亚克力、材质场与可读性¶
| 能力 | 要点（摘自 README） |
|---|---|
| 材质底层 | 主题蓝/紫/青柔和色场，固定最底层并预模糊；强度暗 30% / 亮 24%，blur(28px)（表格另有 0.9.8 定稿参数，见仓库说明） |
| 画布透明度 | 背景族 token 带 alpha，按可读性求解；暗色 0.73、亮色 0.30（白底合成后 ≥ 4.5:1） |
| 弹出菜单 / 浮层 | 下发 --dsw-menu-backdrop-filter，桌面端材质通路渲染：blur(24px) saturate(1.15) |
| 对话框磨砂 | 面板底色约 rgba(…, 0.75) + blur(30px)；静态设置窗口等对元素直接加模糊，并排除含 position: fixed 后代的对话框 |
| 背景遮罩 | --dwa-mask-blur：blur(12px) saturate(1.1)；prefers-reduced-transparency 时随模糊层停用 |
| 侧栏纹理 | 纯 background-image 均匀颗粒；暗色 6% / 亮色 14% |
构建脚本对表面 alpha 设有守卫（scripts/build.mjs 中 GUARD_*）：避免「洞」和组合对比度过低，调参时守卫常量刻意不从 theme.mjs 读取。
等宽字体选择¶
设置 → 通用 → 「Tokyo Night 主题」 提供界面字体与代码字体两个可搜索下拉。列表由渲染进程 canvas 探测（MONO_FONT_BASES × MONO_FONT_SUFFIXES，含 NF / PL 等后缀）与宿主扫描系统字体目录（解析 name / post.isFixedPitch）取并集；诊断行中的 fontSource、fontCount 会标明来源。
安装与启用¶
安装命令须使用 README 原文（桌面 profile）：
# 从 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；单独重载渲染进程也会重新拉取客户端包。宿主半边（lib/index.js）的路由注册需重启进程才生效。
版本兼容性（摘要）¶
| 插件版本 | 支持的 DSH |
|---|---|
| 0.9.0+ | 0.2.0-rc.1 及更高 |
| 0.9.4+ | 0.2.1-rc.2 已验证（peer 为 ^0.2.0-rc.1 \|\| ^0.2.1-rc.2） |
| 0.8.x 及更早 | 0.1.0-rc.6 一线，在 DSH 0.2.0-rc.1 上可能被判定不兼容 |
从 0.8.x 升到 0.9.0：拉新版本并重启；若仍提示不兼容，重新执行安装命令刷新 profile 依赖记录。
网页 profile（可选）¶
开发者声明主要在 Desktop 内测版使用，未在网页端测试。若仍要安装：
dsh plugin --profile web add github:LeoLee0097/dsh-desktop-acrylic
# 或本地目录
dsh plugin --profile web add -w /absolute/path/to/dsh-desktop-acrylic
网页端字体列表无宿主目录扫描，仅渲染进程探测；视觉效果在页面内完成，不依赖窗口材质。
典型用法¶
- 按上一节安装并重启 DSH Desktop。
- 打开 设置 → 通用，找到 「Tokyo Night 主题」 设置行。
- 主题：在暗色 / 亮色 / 默认之间点击，即时切换。
- 亚克力：在「模糊已开 / 模糊已关」间切换；关闭只去掉模糊，保留 Tokyo Night 配色。
- 界面字体 / 代码字体：在下拉中选择本机可用等宽字体，或「恢复默认」。
- 查看诊断行：
当前偏好 · bg-base 计算值 · chrome on/off · hosts 已挂载/候选 · frost n · panels n。bg-base来自getComputedStyle(document.body)，用于确认主题已落到级联上。
调试本机字体扫描（在插件仓库目录）：
node scripts/check-fonts.mjs # 打印宿主扫描的等宽清单
node scripts/check-fonts.mjs --all # 另外打印全部族名
适用场景与注意¶
适合谁：已在 DSH Desktop（0.2.0-rc.1 及以上，或 README 记载的已验证版本）上日常开发、希望统一 Tokyo Night 观感并保留磨砂与材质层次的用户；需要在本机挑选等宽字体（含 Nerd Font 等变体）的开发者。
生态说明：DSH 奉行「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
安全与权限：插件以当前 dsh 进程权限运行，宿主半边可读取系统字体目录。安装前请阅读 仓库源码 与 MIT 许可证，自行评估是否纳入你的工作流。
网页端遇异常时，README 建议反馈时附带诊断行中的 preference / matched / masks 等信息。
结尾¶
dsh-desktop-acrylic 把 Tokyo Night 暗色 / 亮色做成 DSH 主题运行时的正式皮肤，并在一套 token 体系下补齐亚克力面板、材质模糊与等宽字体选择；若你正在用 DSH Desktop 测试版，可按官方命令安装后从「Tokyo Night 主题」设置行完成切换与诊断。
- 目录页：https://www.skillhub.cn/plugins/LeoLee0097/dsh-desktop-acrylic
- GitHub：https://github.com/LeoLee0097/dsh-desktop-acrylic
