DeepSeek Harness (DSH) 插件介绍：dsh-trae-skin

前言¶

DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。除了功能扩展，开发者往往也需要定制界面风格以适应不同的工作流或个人偏好。dsh-trae-skin 是一个纯皮肤插件，它不改变 DSH 的任何业务逻辑，仅通过覆盖样式变量和 DOM 结构，将 Web GUI 换成一套近黑纸面、薄荷绿强调色、带渐变字标状态带的视觉风格。

是什么¶

dsh-trae-skin 是一个由 RonnyJung2021 维护的 MIT 协议插件。它的核心作用是“整页换肤”，基于 DSH Web GUI 的官方文档接口（--dsw-* token），重写了约 93 个页面的颜色与样式定义。它不依赖外部字体文件或图片资源，所有样式通过纯 CSS 变量和少量内联脚本实现，产物体积控制在 45.7 KB 左右。

主要功能¶

整页换肤¶

插件只通过产品已有的文档化 token 进行改色，不触碰页面结构，也不修改生成的 CSS-module 类名。它覆盖了页面底色、抬升面（菜单、代码块）、正文、次级文字以及边框和遮罩层。

三档配色¶

插件提供三档配色方案：
* 深色：默认方案，页面底色为近黑（#0a0b0d），强调色为薄荷绿。
* 浅色：页面底色为纯白，强调色自动适配。
* 跟随产品：配色跟随 DSH 引擎自身的明暗设置。当引擎切换明暗模式时，皮肤会自动重绘。

一个输入框 → 一整套安全色¶

在设置面板中，你只需提供一个十六进制颜色值（默认为 #32f08c）。插件会根据这个主色，自动派生出填充色、Hover 状态色、12% 底色、用于文字显示的可读色以及两套渐变色。派生出的文字颜色会经过 WCAG AA 标准的对比度校验（浅色底白字、深色底黑字）。

顶部状态带¶

界面顶部固定一条 32px 的状态带，包含以下元素：
* 渐变字标：默认显示 DEEPSEEK HARNESS，支持 1-24 字符的自定义。
* 指示灯：空闲时为空心圆，输入框聚焦或鼠标悬停时填实。
* 呼吸效果：仅在引擎报告“推理中”时呼吸脉冲；若无法读取该信号，则变为持续呼吸。
* 无障碍：声明为 role="status"，仅用于屏幕阅读器。

细节修饰¶

几何：统一使用 2px 或 4px 的直角，没有中间值。
投影：使用 0.5px 的内高光与柔和投影。
禁用项：明确不使用径向渐变、辉光、backdrop-filter 或混合模式。

插件卡片设置面板¶

在侧栏的“插件”菜单中，点击已安装的 dsh-trae-skin 卡片，下方会展开专门的设置页。这里包含 10 项外观配置，分为“外观”和“呼吸灯”两组。修改后点击保存，页面会立即重画。设置面板支持“恢复默认”操作，并在保存前对非法值进行校验。

安装与启用¶

安装¶

使用 DSH 命令行安装插件：

dsh plugin --profile web add https://github.com/RonnyJung2021/dsh-trae-skin

或者在 Web GUI 中操作：侧栏插件 → Add plugin → 输入 dsh-trae-skin → Install → Enable now。

启用与配置¶

安装并启用后，在侧栏 插件 → 已安装 中找到 dsh-trae-skin。
点击卡片下方的设置页。
调整配色、字标内容或呼吸灯参数。
点击保存，界面即时更新。

配置项¶

配置写入 profiles/web/cordis.patch.yml，包含以下主要项：

配置项	类型	默认值	说明
`scheme`	`dark` \| `light` \| `auto`	`dark`	外壳配色方案
`accent`	`#rgb` / `#rrggbb`	`#32f08c`	强调色，驱动整套色系
`wordmark`	string (1-24 chars)	`DEEPSEEK HARNESS`	顶部状态带文字
`strip`	boolean	`true`	是否显示顶部状态带
`stripBare`	boolean	`false`	条带是否仅显示文字（不画底）
`pulse`	boolean	`true`	推理时是否开启呼吸
`pulseColor`	`follow` / `#rrggbb`	`follow`	光晕扩散颜色模式
`pulseScale`	number (1.2-2.4)	`1.6`	光晕扩散大小倍数
`pulsePeriodMs`	number (800-4000)	`1600`	呼吸周期（毫秒）
`pulseOpacity`	number (0.1-0.6)	`0.35`	光晕强度

卸载¶

如需移除插件，执行以下命令：

dsh plugin --profile web remove dsh-trae-skin

或在 Web GUI 的插件卡片中点击卸载。卸载后，样式表、状态带、呼吸灯效果以及配置文件中的相关条目将一并清除，界面恢复到产品自带状态。

注意事项¶

宿主半边加载：宿主侧的样式只在引擎启动时加载一次。升级插件或修改 cordis.patch.yml 后，必须重启 DSH 引擎才能生效，刷新页面无效。
无额外资源：插件不包含任何字体文件或图片资源，所有图标和字体均依赖宿主系统或 DSH 自带资源。
环境要求：需要 DSH 版本 0.1.5-rc.2 及以上。

总结¶

dsh-trae-skin 是一个轻量级、纯样式的 DSH 外观插件。它通过单一强调色驱动整套视觉体系，提供了深色/浅色/跟随三档模式，并包含一个具备呼吸效果的顶部状态带。对于希望将 DSH 界面统一为特定设计风格（如参考 trae.cn）的开发者，这是一个无需重构代码即可落地的方案。