前言¶
DeepSeek Harness（DSH）采用插件化架构，但官方默认主题较为克制，缺少柔和的视觉层次。对于需要长时间盯着界面写代码、调试智能体的开发者来说，一套既有辨识度又不抢眼的皮肤很有价值。
dsh-clay-theme 是一个为 DSH 提供马卡龙软陶风格的主题插件。它通过纯 CSS 注入的方式覆盖 DSH 的设计 token，在不修改 DSH 安装目录的前提下提供浅色和深色双模式。
插件定位¶
- 名称：dsh-clay-theme
- 维护者：Tongnianbutongyang
- 分类：趣味换装
- 简介：马卡龙软陶（Clay/Neumorphism）主题 · DeepSeek Harness（DSH Desktop / DSH NEXT /
dsh --profile web）浅色模式插件 - 许可证：MIT
该插件解决的是 DSH 默认界面在视觉上较为单调的问题，通过马卡龙色系与 Neumorphism（新拟态）风格，让界面呈现柔和的凸起、内凹效果和渐变光晕。
核心功能¶
浅色模式：奶油底色 + 马卡龙光晕¶
- 奶油底色作为基础背景
- 六色马卡龙光晕：粉、薄荷、薰衣草、柠檬、天空、蜜桃
- 凸起按钮、内凹输入框，阴影随马卡龙色调变化
- 14–24px 圆角
- 胶囊分段切换
- 粉桃渐变主按钮
- 马卡龙色设置图标
深色模式：黑巧克力底 + 酒红角落光晕¶
- 黑巧克力色底色
- 酒红色角落光晕
- 随 DSH 外观自动切换（浅色 / 深色 / 跟随系统）
技术特性¶
- 纯 CSS 注入，不修改 DSH 安装目录
- 可随时停用 / 卸载
- 浅色规则限定在
body:not([data-ds-dark-theme])下 - 深色规则限定在
body[data-ds-dark-theme]下 - 主要覆盖官方
--dsw-*设计 token，再补充少量组件样式
安装与启用¶
安装前需要先关闭 DSH，并备份 ~/.dsh/profiles/desktop/package.json 和 pnpm-lock.yaml（Windows 下 ~ 即 C:\Users\<你>\；网页版 profile 为 ~/.dsh/profiles/web）。
步骤¶
-
获取安装包（二选一）：
- 从 Releases 下载dsh-clay-theme-<版本>.tgz；
- 或克隆本仓库后执行npm pack自己打包。 -
把 tgz 放到一个固定位置，例如
~/.dsh/plugins-local/dsh-clay-theme/。 -
编辑
~/.dsh/profiles/desktop/package.json：
{
"dependencies": {
// ...原有依赖保持不变
"dsh-clay-theme": "file:C:/Users/<你>/.dsh/plugins-local/dsh-clay-theme/dsh-clay-theme-0.1.19.tgz"
},
"dsh": {
"profile": {
"bundles": [
// ...原有条目保持不变
"dsh-clay-theme"
]
}
}
}
- 在该 profile 目录执行：
pnpm install --ignore-scripts
- 打开 DSH，在「设置 → 通用 → 外观」选择浅色或深色（或跟随系统），主题会自动切换。
也可以直接用 Git 依赖¶
{
"dependencies": {
"dsh-clay-theme": "github:Tongnianbutongyang/dsh-clay-theme#v0.1.19"
}
}
本包目前未发布到 npm；若日后发布，可直接写 "dsh-clay-theme": "^0.1.19"。
回退 / 卸载¶
- 关闭 DSH；
- 恢复备份的
package.json与pnpm-lock.yaml（或手动删掉上面加的依赖行和bundles里的"dsh-clay-theme"）； - 在 profile 目录重新执行
pnpm install --ignore-scripts。
临时停用：在 DSH 插件管理里关闭 dsh-clay-theme 即可。
典型用法¶
安装完成后，打开 DSH 即可看到新主题。在对话界面、会话列表、设置面板、标签页、会话管理器等区域，主题会自动应用：
- 对话：聊天窗口呈现奶油底色与马卡龙光晕，按钮为凸起效果。
- 会话：会话列表采用胶囊分段切换，主按钮为粉桃渐变。
- 设置：设置图标使用马卡龙色。
- 窄窗口：800px 以下窗口仍保持主题一致性。
适用场景与注意¶
适用人群¶
- 长时间使用 DSH 进行智能体开发、调试的开发者
- 喜欢柔和视觉风格、希望降低界面视觉疲劳的用户
- 需要在浅色和深色模式间切换，希望主题自动同步的用户
注意事项¶
- 部分规则依赖 DSH 当前构建生成的 CSS Module 类名（如
wSkVaW_root、sessionRow、_bubble），DSH 升级后个别区域可能失效，需要更新本主题。 - 布局层（侧栏 / 主框架）刻意不使用
backdrop-filter，避免把第三方插件的position: fixed弹窗困在侧栏里（已验证兼容dsh-session-manager0.6.3）。 - 在 DSH 0.2.0-rc.1（DSH NEXT 2.0.16 / 网页版）上测试。
插件以当前 dsh 进程权限运行，安装前应检查源码与许可证（MIT）。社区目录与 DeepSeek / 幻方无官方从属关系。
总结¶
dsh-clay-theme 为 DSH 提供了一套马卡龙软陶风格的主题方案，浅色为奶油底 + 马卡龙光晕，深色为黑巧克力底 + 酒红角落光晕，支持浅色 / 深色 / 跟随系统自动切换。通过纯 CSS 注入实现，不修改 DSH 安装目录，可随时停用或卸载。
- 插件目录页：https://www.skillhub.cn/plugins/Tongnianbutongyang/dsh-clay-theme
- GitHub：https://github.com/Tongnianbutongyang/dsh-clay-theme
