前言¶

DeepSeek Harness (DSH) 提供了模块化的开发环境，默认配置通常能满足基础需求。对于需要更精细控制显示效果的场景，手动修改样式往往涉及繁琐的构建步骤或引入大量依赖。

@hmkk/dsh-appearance 旨在解决这个问题。这是一个专为 DSH 设计的轻量级插件，它不打包任何字体文件，通过修改官方 token（变量）来实现界面与代码块的样式覆盖。它没有复杂的构建流程，仅包含两个 JS 文件和一个配置覆盖层，直接修改字体栈与配色即可生效。

核心功能¶

该插件主要解决两个核心问题：字体显示与界面配色。

零依赖与轻量化¶

• 无文件依赖：不打包任何字体文件，仅使用系统字体栈。
• 零构建步骤：仓库根目录即为插件包，无需编译。
• 零运行时依赖：没有额外的 JS 库依赖。

字体与配色¶

• 字体分离选择：中文字体与西文字体（界面与正文）分开选择，代码字体单独列选。候选列表仅显示本机已安装的字体。
• 官方色板预设：内置 One Dark Pro / Dracula / Nord / GitHub / Catppuccin 五套官方色板，包含深色与浅色模式。
• 深度覆盖：覆盖 42 个 token，包括底色、表面、文字、边框、状态、卡片、代码块等，确保侧栏、菜单、卡片与代码块风格统一。
• 质量校验：内置对比度检查机制，确保配色符合可读性标准。

安装与启用¶

安装前请确保 DSH 版本为 0.2.0-rc.2 或更新。

使用官方 CLI 安装（推荐）：

npx -y --package @deepseek-ai/dsh dsh plugin --profile desktop add @hmkk/dsh-appearance

安装完成后，在 DSH 的「设置」页面中找到「外观」区域即可进行配置。

配置说明¶

在设置页中主要分为三个区域：

1. 字体设置：
   • 界面与正文字体（支持中英文分选）。
   • 代码字体。
   • 正文字号（范围 10-22px）。
2. 配色设置：
   • 选择预设主题（One Dark Pro / Dracula / Nord / GitHub / Catppuccin）。
   • 手动调整强调色、背景色与文字色。
3. 高级设置：
   • 导入或导出配置（格式为 dsh-appearance-v1:{...}）。
   • 重置全部设置。

注意事项¶

• 版本要求：需要 DSH 0.2.0-rc.2 或更新版本。
• 覆盖范围：不覆盖终端字体与 ANSI 色彩；不覆盖 UI 全局字号（仅支持 10-22px）。
• 字体来源：插件仅使用系统字体栈，不包含任何字体文件，不会出现字体缺失报错。
• 首屏过渡：由于配色是明暗双态切换，插件加载后才会应用配色，刷新页面时会有极短的默认配色过渡。

结语¶

@hmkk/dsh-appearance 通过复用官方主题扩展点与 token 机制，为 DSH 提供了一套轻量、无构建、即插即用的外观增强方案。适合希望快速统一界面风格、进行深度主题定制的开发者。

GitHub 仓库 | 插件目录页