前言¶
DeepSeek Harness (DSH) Web GUI 的默认界面可能无法满足所有开发场景下的审美或功能需求。dsh-stzb 插件为 DSH Web 提供了一套自定义主题方案,模仿了两种风格:暗色「铁血战场」与亮色「水墨古风」。
这是什么¶
dsh-stzb 是一个纯客户端插件,由 weijunliang23 维护。它通过覆盖设计令牌来改变界面外观,不依赖 React,且不包含任何游戏素材或官方资源。所有视觉素材均由 SVG/CSS 代码生成,无第三方图片,无版权风险。
核心功能¶
- 令牌级换肤:覆盖
--dsw-*全套设计令牌(约 115 项),支持浅色/深色两套配色。 - 全局样式:宋体系衬线字体、宣纸/墨染画布纹理、古风滚动条与选区样式。
- 装饰层:包含顶部青铜金线、左上回纹角饰、右上「率土之滨」印玺及全屏墨韵暗角。所有装饰层设置为
pointer-events: none,不影响交互。 - 系统适配:跟随系统偏好(浅色/深色/跟随系统)自动切换配色。
安装与启用¶
安装命令如下:
dsh plugin --profile web add github:weijunliang23/dsh-stzb
安装后立即生效,无需改动 DSH 本体。
典型用法¶
- 预览效果:在项目根目录下双击
preview.html,即可在浏览器中查看皮肤效果(包含浅色/深色/跟随系统切换)。 - 开发修改:修改
src/tokens.js或src/skin.css源码后,运行npm run build重新生成。
技术原理¶
插件采用零 React 依赖架构。通过 ctx.theme.overrideTokens 叠加令牌层,配合注入的 DOM 节点和纯 CSS 实现装饰层。宿主会扫描 loader 条目并注入引导图,随后将活跃主题的令牌写入 body 内联 CSS 变量。
适用场景¶
适合 DSH Web 用户希望在不修改 DSH 本体代码的情况下,快速切换界面风格,或进行自定义主题开发的场景。