前言¶
DeepSeek Harness Web（dsh web）的默认界面是一套中性的工程风格，长期盯着看，想调整外观基本只有两条路：自己动手改界面样式，或者等一个现成的主题机制。DSH 的理念是「一切皆插件」，界面换装这件事同样可以交给插件来做。
下面介绍 dsh-columbina-theme，一个由 hyposelen1a 维护的主题插件：它把原神角色「哥伦比娅」的主题应用到 DSH Web 上——背景、蒙版、配色，安装后首帧即生效，不需要改动 DSH 本身的代码。
这是什么¶
dsh-columbina-theme 是为 DeepSeek Harness Web 打造的主题插件，一句话定位：背景、蒙版、配色——来自挪德卡莱的月光。插件归类为「趣味换装」，当前版本 0.1.1，代码采用 MIT 许可。
插件随包附带两张预设背景：columbina-1 用于浅色模式，columbina-2 用于深色模式，切换明暗模式时背景与配色一起切换。
核心功能¶
插件的能力分两组：一组是主题本身，一组是实现方式。
主题部分：
- 浅色/深色双默认：浅色默认背景
columbina-1+ 浅色配色，深色默认背景columbina-2+ 深色配色； - 可调蒙版：0% 等于背景原图效果（主界面面板通透度同步归零），越高越不透明，100% 为完全覆盖当前明暗主题底色；
- 自定义颜色：蒙版、输入框、侧边栏、字体颜色均可自定义，留空即跟随明暗主题默认色；
- 自定义背景：上传 PNG/JPEG/WebP/GIF 图片作为背景；放进
assets/backgrounds/目录的任意图片自动成为预设； - 选中会话标题特效：当前会话标题使用蓝紫渐变文字与光晕；
- 通透的界面表面：会话区、气泡等主内容表面的通透度跟随蒙版设置；输入框固定 80% 不透明；侧边栏与浮层始终不透明，保证可读性。
实现部分：
- 首帧即生效：主题样式通过
webServer.tapIndex注入每次页面响应，加载无闪烁； - 上传的自定义图片限制在 15MB 以内，位图超过 512KB 时由服务端生成 640px 宽的 JPEG 预览缩略图。
安装与启用¶
前置条件：DeepSeek Harness（dsh）、Node.js ≥ 22、pnpm 在 PATH 中。
1、先完全退出 DSH（不只是关闭浏览器标签页）。
2、安装插件。从 GitHub 安装：
dsh plugin --profile web add github:hyposelen1a/dsh-columbina-theme
插件发布到 npm 后，也可以直接按包名安装：
dsh plugin --profile web add dsh-columbina-theme
本地开发调试用 link 方式，路径换成你的实际目录：
dsh plugin --profile web add link:/path/to/dsh-columbina-theme
3、经过上面的步骤，重新启动 dsh web 并硬刷新浏览器（Ctrl+F5），打开 设置 → 插件 → 哥伦比娅主题 即可配置。
不想卸载、只想临时停用时，编辑 $DSH_HOME/profiles/web/cordis.patch.yml，加入下面两行并重启：
- id: dsh-columbina-theme
disabled: true
删除这两行（或改回 false）再重启，即可恢复启用。
典型用法¶
安装后，插件的设置入口在 设置 → 插件 → 哥伦比娅主题，常用几项：
- 背景预设：留空为自动（浅色
columbina-1/ 深色columbina-2）； - 上传自定义图片：支持 PNG/JPEG/WebP/GIF，不超过 15MB，上传后作为背景使用；
- 蒙版不透明度：0% 为原图效果，100% 为完全覆盖当前明暗主题底色；
- 颜色：蒙版、输入框、侧边栏、字体颜色均可自定义，留空跟随明暗主题；
- 选中会话标题特效：开关当前会话标题的渐变 + 光晕效果。
想添加自己的预设背景，把图片放进插件的 assets/backgrounds/ 目录即可。文件名只能包含字母、数字、-、_（如 columbina-3.jpg），支持 svg/png/jpg/jpeg/webp/gif 格式，重启 DSH 后自动出现在预设网格，不需要改代码。
超过 512KB 的位图会自动使用服务端生成的 640px 宽 JPEG 预览缩略图，避免设置界面加载原图。上传的自定义图片与预设缩略图缓存统一保存在 $DSH_HOME/storages/dsh-columbina-theme/。
插件的所有设置保存在 $DSH_HOME/settings.yaml 的 dsh-columbina-theme 命名空间下。
适用场景与注意¶
适合的人：每天使用 dsh web，希望在不动 DSH 本身代码的前提下给界面换一套固定风格的玩家和开发者。
几个已知的限制，装之前建议过一遍：
- 插件针对 DeepSeek Harness
0.1.0-rc.7开发（@deepseek-ai/cordis ^4.0.1、dsh-* ^0.1.0-rc.7）。DSH 仍处于 developer preview 阶段，接口可能发生破坏性变更；升级后如果主题失效，先查看仓库的 CHANGELOG 与 release 说明。 - 选中会话标题特效依赖会话行的 DOM 结构，DSH 界面内部类名随版本变化时可能需要调整选择器。
- 表面透明度通过 CSS token 覆盖实现，DSH 版本升级后个别表面可能不再受控。
- 多实例共享
$DSH_HOME/settings.yaml时，并发写入以最后一次为准。 - 版权要分开看：代码与程序生成的预设资源采用 MIT 许可；随包附带的两张背景图
columbina-1.png/columbina-2.png为作者自备素材，版权归原作者所有，详见仓库的 ASSET_LICENSE.md。
最后照例提醒：安装任何 DSH 插件，插件都会以当前 dsh 进程的权限运行。dsh-columbina-theme 的代码采用 MIT 许可、源码公开在 GitHub，建议安装前自行检查源码与许可证。
结尾¶
dsh-columbina-theme 只做一件事：把 DSH Web 换成「哥伦比娅」主题，同时保持界面可读可用。浅色/深色双默认、可调蒙版、放进目录即成预设的背景机制，把自定义门槛压得比较低。如果你想要一个开箱即用的换装方案，或者想看看 web profile 主题插件怎么写，它的仓库值得一读。
- GitHub 仓库：https://github.com/hyposelen1a/dsh-columbina-theme
- 社区目录页：https://www.skillhub.cn/plugins/hyposelen1a/dsh-columbina-theme
