前言¶
DeepSeek Harness（DSH）桌面端支持通过插件扩展界面，但默认仍是平台原生配色。若你希望在不改安装包、不碰聊天数据的前提下，给侧栏、输入区和聊天页统一一套角色向的视觉（全窗口壁纸、明暗两套遮罩、日常表情），需要走官方 ThemeRuntime 与插件注入机制。下面介绍社区维护的 dsh-vesna-theme（薇斯纳主题）是什么、能做什么，以及如何安装与恢复。
这是什么¶
dsh-vesna-theme 是由 Mahiru0427 维护的 DSH Desktop 主题插件（npm 包名与安装标识均为 dsh-vesna-theme，当前 Release 安装包版本 0.3.5）。分类上属于社区目录中的「趣味换装」类。
插件定位：为 DeepSeek Harness Desktop 提供独立主题——用户认可的双手托脸角色、无边框全窗壁纸、六款卡通表情，以及「春日浅色 / 夜宴深色」等配色；图片构建时内嵌，不需要联网加载。它不接触模型、凭据或聊天文件，也不替换程序安装文件。
核心功能¶
配色与 ThemeRuntime¶
在 设置 → 通用 中会出现「薇斯纳主题」入口，可选：
- 春日浅色
- 夜宴深色
- 跟随系统
- 默认配色
插件通过官方 ThemeRuntime 的 token 覆盖接口，调整侧栏、阅读区、输入区、按钮、菜单、链接、代码块等使用平台 CSS 变量的组件。明暗偏好由 DSH 保存；角色配色、壁纸和表情开关单独保存在本机。点「默认配色」会撤下插件配色和壁纸并隐藏表情，仍保留当前原生明暗模式；支持读取第一版保存记录。
全窗口壁纸与模糊遮罩¶
同一张壁纸铺满整个窗口最外层；聊天视口与消息气泡为透明，避免重复画面。左栏、顶部应用控制栏和右侧工具栏采用 12px 高斯模糊及半透明遮罩（v0.3.5 起底栏与左栏模糊背景统一，减少接缝色差）；输入框、设置卡片和内容工具保持可读背景。浅色使用奶白遮罩，深色使用海军蓝遮罩。插件遵循系统「降低透明度」偏好。
聊天框视觉效果（v0.3.3+）¶
在 设置 → 薇斯纳主题 → 聊天框效果 可切换：
- 液态玻璃：薄雾、平滑圆角、方向性边缘反光和轻微背景折射（参考苹果设计原则的网页近似效果）
- 高斯模糊：3px 静态模糊和细边框，关闭动态高光与边缘折射，降低快速滚动时的渲染开销
所选效果会自动保存，重启后无需重设；旧设置默认保留液态玻璃。
日常表情¶
六张表情接入固定位置，例如：比耶→新会话；思考→欢迎；读书→文件入口悬停；疑惑→负面评价悬停；点赞→正面评价悬停；爱心→发送。主页招呼语为「找我什么事呀，亲爱的朋友~」。发送按钮保留小箭头，停止和删除等控件保留原生图标；默认配色或关闭表情后恢复原生功能控件，按钮事件与可访问名称保留。设置卡片提供预览及壁纸/表情独立开关。
许可与素材说明¶
插件代码为 MIT 许可；不包含角色名称与角色图像的权利。这是非官方主题，社区目录（如 SkillHub 插件页）与 GitHub 无 DeepSeek / 幻方官方从属关系。
安装与启用¶
维护者在 README 中给出两种路径；安装命令以原文为准，勿用旧版全局 CLI 改 Desktop 配置（本机 Desktop 若不允许 dsh plugin --profile desktop 管理，应走应用内插件页）。
最简方法： 在官方 Desktop 插件 → 添加插件 输入下面包名安装，可选择中国大陆镜像源或 npm 官方源（新版本在镜像源上可能存在同步延迟；该窗口是官方安装器，不代表插件通过官方市场审核）。
dsh-vesna-theme
安装包方式：
- 从仓库 Releases 下载
dsh-vesna-theme-0.3.5.tgz。 - 打开 DeepSeek Harness Desktop → 插件 → 添加插件，选择该安装包。
- 安装后点击「立即启用」。
- 到 设置 → 通用设置 → 薇斯纳主题 选择配色、壁纸和表情开关。
仓库已预构建 lib/client.js，普通用户无需自行编译。维护者文档记载已在 Desktop 0.2.0-rc.2 中实际安装并启用；升级宿主应用后主题可能需要重新适配消息结构与 CSS 模块角色。
若希望由桌面内的 DSH 协助安装，可将 README 中的说明发给 DSH（能否自动完成取决于当前工具权限）：
请帮我安装或更新这个DSH Desktop主题插件：https://github.com/Mahiru0427/dsh-vesna-theme
请下载最新Release的tgz安装包，保留现有主题设置，按当前Desktop版本支持的插件安装方式处理；不要使用旧版全局CLI改Desktop配置。
典型用法¶
- 安装并启用插件后，打开 设置 → 通用设置 → 薇斯纳主题。
- 选择「夜宴深色」或「春日浅色」，或选「跟随系统」。
- 按需打开壁纸、表情开关；在「聊天框效果」中选择液态玻璃或高斯模糊。
- 在侧栏使用带表情的新会话按钮，在主页或聊天页使用发送区域；悬停或键盘聚焦可展开较大表情预览（具体尺寸与位置见 README 界面调整说明）。
临时恢复原生主题外观：在主题设置中点 默认配色。卸载前建议先恢复默认，再到 Plugins 禁用或移除 dsh-vesna-theme，退出并重新打开 Desktop；本机角色主题选择记录会保留，再次安装可沿用。
适用场景与注意¶
适合谁： 长期在 DSH Desktop 上工作、希望统一视觉又不愿 fork 客户端的开发者或重度用户；接受非官方角色主题与 MIT 仅覆盖代码的许可边界。
权限与安全： 插件以当前 DSH Desktop 进程权限运行，通过 Cordis patch 注入客户端模块（如 @deepseek-ai/dsh-client-ui-theme 等）。安装前应自行查看 源码仓库 与 LICENSE。
使用注意（来自维护者说明）：
- 透明聊天内容与玻璃效果的可读性受壁纸影响；逻辑配色对比度测试不保证任意壁纸均达到 4.5:1。
- 全窗口壁纸与 backdrop-filter 对显卡与系统合成有一定开销；窄屏下主页输入区最小宽度约 360px，布局已做自适应。
- Windows 上曾修复全窗口壁纸下发送/停止按钮悬停闪烁等问题；macOS 部分实机体验维护者标注仍待用户确认。
维护者本地构建与测试命令（供贡献者参考）：
node scripts/build.mjs
node --test tests/controller.test.mjs
结尾¶
dsh-vesna-theme 把壁纸、明暗 token、聊天框玻璃/模糊和六处日常表情收进一个可安装、可一键恢复默认的 Desktop 主题插件，适合在「一切皆插件」的 DSH 生态里做界面换装而不动核心数据路径。
