前言¶
DeepSeek Harness (DSH) 采用插件化架构。当用户或开发者希望在不修改源码的情况下改变 Web 客户端的视觉风格或增加交互组件时,可以通过安装主题插件来实现。本插件提供了一套完整的视觉替换方案和交互组件。
插件定位¶
这是一个名为“神里绫华 · 冰华主题 + 桌面宠物”的 DSH Web 客户端主题插件,由 l-vM2k 维护,开源许可为 MIT。
核心功能¶
插件主要包含以下功能:
- 立绘展示:半透明的神里绫华立绘会贴在屏幕右侧。
- 交互式桌面宠物:Q 版绫华小头会趴在聊天输入框的右上角。点击该区域可触发语音与文字气泡同步。
- 环境特效:背景中会混合飘落樱花花瓣与雪花,大小不一,密度稀疏。
- 主题配色:使用冰蓝色进行 UI 配色,支持亮色和暗色双模式。
安装与启用¶
安装命令如下:
dsh plugin --profile web add github:l-vm2k/dsh-ayaka-theme
安装完成后,启动 Web 客户端即可生效:
dsh --profile web
插件结构¶
插件遵循 DSH Bundle 标准,包含以下关键文件和配置:
package.json:声明 bundle 和 client 层。cordis.patch.yml:定义挂载点。assets/:存放图片和音频资源。src/:包含 Node 层和浏览器层的逻辑。
关键配置说明¶
在 package.json 中,dsh 字段用于区分 bundle 和 client 层:
* dsh.bundle.patch:指向 cordis.patch.yml,用于识别 bundle 类型。
* dsh.client:声明浏览器端插件,注入依赖并立即执行。
在 cordis.patch.yml 中,使用一行 insert 操作:
- insert:
- id: ui-ayaka-theme
name: '@l-vm2k/dsh-ayaka-theme'
这行配置会同时触发两个动作:挂载 Node 层(注册路由)和发现 Client 层。
注意事项¶
使用本插件前,请确保 DSH Web 进程当前的主题为深色模式。如果使用亮色模式,界面可能会因配色冲突而显示为白色。