前言¶

DeepSeek Harness (DSH) 的默认外观满足基础需求，但若需要更精细的视觉控制，dsh-aurora-skin 插件提供了一套方案。该插件通过纯 CSS token 覆盖的方式，为 DSH 提供了三款手工调优的皮肤，且不涉及核心代码修改。

皮肤列表¶

插件包含三款经过手工调优的配色方案，每个颜色值均为具体的 CSS 颜色，无 var() 间接引用，确保全 UI 范围内的对比度。

1. Aurora 极光

   • 模式： Dark
   • 色调： 深午夜蓝、电青色、暖珊瑚色。
   • 风格： 在精密控制室之上浮现极光。

2. Paper 纸本

   • 模式： Light
   • 色调： 凉纸白、深青色。
   • 风格： 感觉像研究论文，适合日间阅读。

3. Hologram 全息

   • 模式： Dark
   • 色调： 近黑、酸青色。
   • 风格： 具有鲜明的终端氛围，类似精密仪器。

安装¶

可以通过官方命令安装插件，或从本地目录安装。

官方命令：

dsh plugin --profile web add breaker505/dsh-aurora-skin

本地 pnpm 安装：

cd ~/.dsh/profiles/web
pnpm add file:path/to/dsh-aurora-skin

本地 Git 克隆：

git clone https://github.com/breaker505/dsh-aurora-skin

克隆后，将 "dsh-aurora-skin" 添加到 dsh.profile.bundles 数组中，并重启 dsh web。

使用¶

安装完成后，打开 Settings（设置） -> General（通用） -> Aurora Skins。

1. 在列表中选择一个皮肤。
2. 若要恢复 DSH 默认外观，点击 “Follow system”（跟随系统）。

注：Aurora Skins 选择器行位于 dsh-skin 行上方（插槽顺序 15 vs 20），因此自定义皮肤会优先显示。

实现细节¶

该插件的设计哲学基于以下原则：

• Tokens, not code（基于 Token，而非代码）： 插件仅向 <body> 添加 --dsw-alias-* 自定义属性。不进行 DOM 变异，不覆盖内部 DSH 组件，也不进行 monkey-patching。
• Reversible by design（可逆设计）： 选择“Follow system”会清除覆盖，UI 恢复至 DSH 原始调色板，无需在安装时进行逆向补丁。
• 持久化： 设置存储在 localStorage 中。
• 开发方式： lib/client.js 为手工编写的 CJS 代码，使用 window.__ModuleLoader__.load 包装运行时加载的工厂。无需构建步骤，直接编辑该文件并刷新 dsh web 即可生效。

许可证¶

MIT — 详见 LICENSE 文件。