前言¶
DeepSeek Harness（dsh）的 Web 界面通常偏工具化，适合处理任务，但本地使用时如果想换一套更明显的外观，再顺手听一点本地音乐，可以看看这个主题插件。
dsh-theme-cyberpunk 是一个面向 DeepSeek Harness Web 界面的赛博朋克主题插件：它提供霓虹氛围、可切换的背景图库，以及一个右上角可拖动、可收起的 HUD。HUD 里包含「赛博 / 默认」外观切换和本地音乐播放器，歌单与播放状态会持久化。
这是什么¶
dsh-theme-cyberpunk 是一个 DSH Web 主题插件，仓库位于 dlpufan/dsh-theme-cyberpunk，许可证为 MIT。
它解决的是两个小问题：
- 给
dsh的 Web 界面换一个赛博朋克外观，并且可以一键切回默认外观。 - 在右上角提供一个 HUD，里面可展开本地音乐播放器和背景图库。
它不是独立应用，也不是官方应用商店里的系统组件，而是 DSH 插件生态里的一个主题包。
核心功能¶
下面介绍已核实的几项能力。
- 提供赛博朋克外观主题：旋转 RGB 色轮、霓虹光斑、细密 CRT 扫描线、暗角等氛围特效。
- 内置暗色霓虹城市背景，并支持添加、切换、删除本地背景图，且记住选择。
- 提供「赛博 / 默认」外观一键切换，偏好持久化。
- 提供右上角可拖动、可收起的 HUD，HUD 位置可记住。
- 提供本地音乐播放器：
- 添加本地音频组成歌单；
- 播放 / 暂停；
- 上一首 / 下一首；
- 随机顺序；
- 循环模式：关 / 列表 / 单曲；
- 进度拖动与音量调节；
- 歌单与播放状态持久化。
- 支持添加
mp3/flac/wav等本地音频文件。 - 系统开启「减少动态效果」时自动禁用动效。
安装与启用¶
安装前需要满足：
- Node.js 22+
- pnpm
- 已安装并初始化 DeepSeek Harness，且可运行
dsh web
可以按下面方式安装。
从 GitHub 仓库安装¶
dsh plugin --profile web add "github:dlpufan/dsh-theme-cyberpunk"
安装后启动 Web profile：
dsh web
然后刷新浏览器。
本地目录安装¶
在插件目录内执行：
dsh plugin --profile web add .
然后执行：
dsh web
刷新浏览器即可。
手动激活备用配置¶
如果安装后没有自动激活，可以检查：
$DSH_HOME/profiles/web/cordis.patch.yml
在文件中添加：
- insert:
- id: theme-cyberpunk
name: dsh-theme-cyberpunk
保存后重启 DSH Web。
注意：cordis.patch.yml 顶层必须是 YAML 数组，空文件或纯注释会报错。
典型用法¶
安装并运行 dsh web 后，刷新浏览器，右上角会出现一个胶囊 HUD。
切换外观¶
点击 HUD 的「赛博 / 默认」按钮，可在赛博朋克外观与默认外观之间切换。绿点亮起表示赛博朋克开启。
拖动和收起 HUD¶
拖动 HUD 的手柄可调整 HUD 位置，位置会被记住。
点击 HUD 的收起按钮，可将其收起为单个音符按钮；再点击可展开。
使用本地音乐播放器¶
点击 HUD 的音符图标，可打开或收起本地音乐播放器。
在播放器中：
- 使用添加按钮选择本地音频文件，可添加
mp3/flac/wav等文件。 - 点击歌单中的曲目开始播放。
- 使用播放 / 暂停按钮控制播放。
- 使用上一首 / 下一首切换曲目。
- 开启或关闭随机顺序。
- 切换循环模式：关 / 列表 / 单曲。
- 拖动进度条跳转播放位置。
- 调节音量。
歌单与播放状态会持久化，但刷新页面后状态会回位，不会自动播放。
删除歌单中的曲目时，会同时从 IndexedDB 删除对应数据。
管理背景图库¶
点击 HUD 的图片图标，可打开或收起背景图库。
在背景图库中：
- 点击内置默认背景，可切回内置暗色霓虹城市图。
- 添加本地背景图，新图会进入图库。
- 点击缩略图切换为对应背景。
- 删除某张背景图。
如果删除的是当前背景，会自动切回内置默认霓虹城市图。
适用场景与注意¶
这个插件适合本地使用 DeepSeek Harness Web 界面、想换一套赛博朋克外观，并且希望在页面里直接放一个本地音乐播放器的场景。
使用前注意：
- 插件会以当前
dsh进程权限运行，安装前建议检查源码与许可证。 - 许可证为 MIT。
- 本地音频和背景图属于本地文件数据，删除歌单条目会同时从 IndexedDB 删除。
- 刷新页面后，音乐播放器会回到上次持久化状态，但不会自动播放。
- 系统开启「减少动态效果」时，插件会自动禁用动效。
卸载：
dsh plugin --profile web remove dsh-theme-cyberpunk
结尾¶
dsh-theme-cyberpunk 的价值比较具体：它不改变 dsh 的核心能力，而是给 Web 界面加上一层赛博朋克外观，并把外观切换、背景图库和本地音乐播放器放进右上角 HUD。
如果只是想给本地 DeepSeek Harness Web 界面换个更带氛围的样式，同时顺手播放本地音乐，它是一个比较直接的选择。
GitHub 仓库：
https://github.com/dlpufan/dsh-theme-cyberpunk
社区目录页：已核实资料未给出固定 URL，可按插件名在 DSH 社区目录中查找。
