前言¶

DeepSeek Harness (DSH) 采用插件化架构，支持通过插件扩展功能。默认的 Web 界面为白色背景，阅读体验较为单调。deepseek-harness-skin 是一个本地插件，旨在为 DSH 的 Web 界面提供动漫风格的背景皮肤，通过 CSS 样式覆盖实现界面美化。

是什么¶

deepseek-harness-skin 是由开发者 Zdram 维护的一个本地插件，开源协议为 MIT。它通过修改 Web 界面的渲染层，为聊天和设置面板增加背景图与半透明玻璃拟态效果，帮助用户在开发智能体时获得更个性化的视觉体验。

功能特性¶

• 全屏固定背景：背景图铺满全屏且固定不随页面滚动。
• 可读性优化：背景上方覆盖极淡遮罩，保证聊天内容清晰可读。
• 玻璃拟态 UI：侧栏、聊天区和设置面板采用浅色半透明样式。
• 状态保持：切换会话时背景持续保留，不会闪回白色。
• 自定义图片：支持在默认背景图之外，配置本地图片作为背景。
• 格式支持：支持 PNG、JPG、JPEG、WebP、GIF 等常见图片格式。

安装与启用¶

安装插件后需要重启 DeepSeek Harness 进程才能生效。

1、在终端中执行以下命令安装插件（默认针对 web profile）：

dsh plugin --profile web add github:Zdram/deepseek-harness-skin

2、重启 DSH 后打开 Web 界面，即可看到背景图和半透明面板效果。

典型用法¶

自定义本地背景¶

如果需要使用自己的动漫图片作为背景，需要编辑对应 profile 的配置文件。

1、找到配置文件路径：
- Windows：%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml
- Linux / macOS：~/.dsh/profiles/web/cordis.patch.yml

2、在文件末尾添加以下配置项：

- id: deepseek-harness-skin
  config:
    background: 'D:/Pictures/bg.png'

3、保存文件并重启 DSH。

验证安装¶

安装完成后，可以通过直接访问插件内置的测试地址来验证插件是否正常加载：

http://127.0.0.1:3080/deepseek-harness-skin/bg.png

如果页面能正常显示图片，说明插件已生效。

注意事项¶

• 路径格式：在 Windows 系统中，配置图片路径时建议使用正斜杠 /（例如 D:/Pictures/bg.png），以避免路径解析错误。
• 路径回退：如果配置的本地图片路径不存在，插件会自动回退到内置的默认背景图。
• Profile 限制：每个 profile 中只保留一个 deepseek-harness-skin 条目，重复添加会覆盖之前的配置。
• 重启生效：任何配置修改（包括更换背景）或插件安装后，都必须重启 DeepSeek Harness 才能生效。