前言¶
DeepSeek Harness (DSH) 采取“一切皆插件”的架构理念,允许用户通过扩展来改变客户端的行为与外观。默认的 Web GUI 专注于功能性,但在视觉上可能缺乏个性化。dsh-hu-tao-skin 是为此类需求设计的插件,它将界面风格替换为原神角色胡桃的“往生堂”主题,通过叠加样式与 DOM 操作,在不破坏原有主题逻辑的前提下提供沉浸式视觉体验。
插件定位¶
- 名称:dsh-hu-tao-skin
- 定位:DeepSeek Harness Web GUI 客户端插件皮肤
- 核心价值:原神 · 胡桃(往生堂)界面美化
- 维护者:MistyRain-field
- 开源协议:MIT
核心功能¶
本插件通过 14 个主题令牌定义了墨黑、绯红、琥珀金配色,并提供了一套氛围层系统。
-
主题令牌
- 提供明暗两套配色方案。
- 通过
theme.overrideTokens()叠加在当前主题上,不修改主题注册表,不会覆盖用户原本的主题偏好。 - 配色包括底色墨黑、主色绯红、警示色琥珀金。
-
氛围层
- 利用
shell.overlay挂载点实现。 - 包含金点梅纹底、绯红晕染、右下角梅花水印、右侧竖排“往生堂”金印。
- 动态效果包括 14 片飘落梅花瓣与 3 只流光蝴蝶。
- 系统开启“减少动态效果”时,动画会自动停用。
- 利用
-
交互控制
- 浮动开关:位于对话区左下角,可一键开关花瓣与蝶影。该开关通过读取侧栏的网格宽度动态定位,随侧栏拖动或收起而移动。
- 设置页:在 DSH 设置中新增“往生堂”栏目,提供三个独立开关:梅花飘落、蝶影流光、胡桃配色。
-
其他特性
- 首屏徽记:将空白会话的品牌图标替换为五瓣梅花徽记。
- 状态持久化:开关状态保存在
localStorage中,重启后自动恢复。 - 无构建步骤:浏览器半边为手写代码,无需编译,直接加载。
安装与启用¶
插件以 DSH profile bundle 的形式分发,支持一键安装或脚本部署。
方式一:使用部署脚本(推荐)¶
克隆仓库后,使用 PowerShell 执行部署脚本。脚本会将运行时文件安装到指定 profile 的本地插件目录,并修改 profile 的 package.json 以建立依赖关系。
git clone https://github.com/MistyRain-field/dsh-hu-tao-skin.git
cd dsh-hu-tao-skin
pwsh -File tools/deploy.ps1
脚本支持通过参数指定 profile 名称或目录:
pwsh -File tools/deploy.ps1 -ProfileName web
pwsh -File tools/deploy.ps1 -ProfileDir 'D:\some\profile'
安装完成后,必须重启 dsh web 以加载插件。
方式二:使用 DSH 命令行¶
在终端中指定 profile 和仓库路径进行添加。
dsh plugin --profile web add <本仓库路径或 git 地址>
方式三:插件市场一键安装¶
如果已安装插件市场,可在设置中直接安装。
dsh plugin --profile web add dshmarket
典型用法¶
安装并重启后,界面将呈现胡桃主题。
- 视觉体验:观察墨黑与绯红的配色,以及背景中飘落的梅花与流光蝴蝶。
- 交互测试:拖动左侧侧栏,观察左下角浮动开关是否随之平滑移动。
- 开关控制:点击左下角浮动开关,或进入设置 -> 「往生堂」关闭花瓣与蝶影,观察界面变化。
- 持久化验证:关闭并重启
dsh web,再次打开开关,确认状态被保留。
注意事项¶
- 非官方作品:本插件为同人美化,与米哈游及 DeepSeek 无任何关联。
- 生命周期:所有样式与 DOM 操作均在插件生命周期内生效,卸载后会自动恢复到默认界面。
- 系统兼容性:在 Windows 系统中,请确保脚本执行策略允许运行 PowerShell 脚本。
- 动态效果:若系统开启了“减少动态效果”,花瓣与蝴蝶的动画将不会运行。
结尾¶
dsh-hu-tao-skin 为 DSH 用户提供了无需编写代码即可体验同人主题的途径。其通过不侵入注册表的叠加式样式和动态 DOM 操作,实现了轻量级且可逆的界面美化。