前言¶
DeepSeek Harness（DSH）的 Web GUI 出厂是中性灰界面。若你长期在 Harness 里写插件、调智能体，界面气质与项目无关时，换肤往往只能改 CSS 变量或自己 fork 前端——成本高，还容易和宿主升级打架。社区插件 dsh-theme-holo 走正规 DSH 插件形态：宿主侧 index.js 提供素材路由，浏览器侧 client.js 注入主题 token 与装饰层，不改宿主 flex 布局。下面介绍它是什么、能做什么，以及如何安装与按需关掉组件。
这是什么¶
dsh-theme-holo 是维护者 1015677515 发布的 DSH 主题类插件，在 SkillHub 目录 中归类为「趣味换装」。当前版本 1.0.6（MIT 许可证），面向 DSH Web GUI，包体约 21 MB，其中绝大部分是图片、视频与音频素材。
装上之后，界面从中性灰变为羊皮纸底色与麦金强调色（浅色「麦秋晨光」；深色「星夜麦田」为开发中的测试功能），并叠加开场动画、可拖动字标、输入框旁的探头角色、账户悬停小卡、侧栏脚下麦田、右栏开始页待机画面等装饰。设计原则之一是：装饰挂在独立浮动层或纯 CSS 上，不改动宿主尺寸与 overflow。
环境要求¶
安装前请对照 README 中的约束：
| 项 | 要求 |
|---|---|
| DeepSeek Harness | >=0.2.0-rc.1 且 <0.3.0-0（低于此范围会静默不生效） |
| Node.js | >=22 |
| 平台 | Windows / macOS / Linux；README 记载在 Windows 11 + DSH 0.2.1-rc.2 实测 |
| 第三方 npm 依赖 | 无，安装后不需要 pnpm install |
核心功能¶
全局配色¶
两套 token 表（PALETTE / PALETTE_DARK）通过 theme.overrideTokens 等接口覆盖 Web GUI 颜色。插件设置里的「黑夜模式」与「设置 → 外观」共用同一主题偏好；深色模式下部分暖色装饰会统一隐藏，README 注明黑夜模式尚未完全适配。
开场动画（12 秒）¶
全屏 canvas 2D 实时绘制（非视频），1920×1080、约 30 fps、总长 12 秒：暗处红眼、狼影描红、光炸开、DEEPSEEK / HARNESS 标题解码、进度条与就绪帧。任意点击或按键可在约 0.55 秒内跳过；右下角可开关音效（默认关）。系统开启「减少动态效果」时直接停在收尾帧。插件设置里可永久关闭，关闭后不再创建 canvas。
浮动字标¶
顶部「狼与香辛料」浮雕字标（assets/logo.png）以视口百分比存位置与大小，日常 pointer-events: none 不挡操作。在插件设置中进入「更改 logo 位置」后可拖动与缩放，并可整体隐藏或恢复默认。
偷看的她与探头语音¶
输入框右侧只露兜帽与双眼，指针靠近会升起，可左右拖动。点击可播放「疑惑」语音，并在探头右上角浮出中文译文；「探头语音」可在设置中关闭。
动态档案卡、日志标签、侧栏麦田¶
悬停左下账户行会升起 Steam 式小卡；思考 / 读取 / 运行命令等日志行有暖色标签；侧栏脚下麦穗宽度随侧栏变化。README 说明这三项为静态展示或样式，未提供开关（关掉需改代码或卸载插件）。
右栏待机画面与羊皮纸便笺¶
右栏自己的开始页播放待机动画（六段可换），进入会话后熄灭，点击可应答一句。右下角麦穗环徽章可打开可打字、可贴图的便笺；入口可改为顶部按钮。二者在设置中有独立开关。
小鲸鱼挂件联动¶
若检测到 dsh-whale-widget，首次会询问是否把赫萝角色与语音装入挂件；可选「暂不安装」且之后不再弹出。
插件详情页横幅¶
在 DSH 插件管理器进入本插件详情时，内容区顶部显示 1920×620 封面图。
插件设置项（可单独关闭的七组）¶
README 明确列出设置里 七组开关，关闭后会移除对应 DOM，不留残余：
- 开场动画
- 偷看的她
- 探头语音
- 黑夜模式（含未完全适配提示）
- 右栏待机动画
- 羊皮纸便笺（总开关 + 入口模式）
- 浮动字标显隐
其余如动态档案卡、日志标签、侧栏麦田为常驻装饰。
安装与启用¶
在 DSH 中打开 设置 → 插件 → 添加插件，填入仓库标识：
github:1015677515/dsh-theme-holo
点安装，等待下载完成后 立即启用，然后 重启 DSH。README 注明：若 github: 解析失败，可参考仓库内 INSTALL.md 的本地 link 安装与故障排查。
生效标志：重启后播放完开场动画（若未关闭），界面变为羊皮纸暖色。
典型用法与调试¶
日常¶
- 安装并启用后重启 DSH。
- 在 设置 → 插件 → dsh-theme-holo 中按偏好关闭动画、探头或字标等。
- 需要调整字标时，在设置里打开「更改 logo 位置」，拖好后点「完成调整（固定下来）」或按
Esc退出编辑态。
URL 调试（开场动画）¶
README 提供的 hash 入口（写在浏览器地址栏）：
#boot-hold：片头停在关键帧；#boot-hold=11.4可指定秒数，缺省约 10.2 秒。#videocap：停在片头供录屏；#videocap=tail多留 5 秒画面。
与小鲸鱼挂件¶
同意联动后，可通过挂件鲸鱼触发与主题一致的语音译文气泡；细节见 README「小鲸鱼挂件联动」一节。
适用场景与注意¶
适合谁：已在 DSH 0.2.x Web GUI 上日常开发、希望界面统一为《狼与香辛料》赫萝风格、且能接受约 21 MB 素材占用的用户。
权限与安全：DSH 插件与当前 Harness 进程同权限运行。安装前应阅读 GitHub 源码 与 MIT 许可证；素材含音频与视频，由宿主 HTTP 路由本地送出，运行时不依赖外网。
已知边界：README「已知边界」一节列有深色适配、字标 z-index 与布局取舍等说明；深色「星夜麦田」仍为测试功能。
生态说明：SkillHub 等为社区目录站点，与 DeepSeek / 幻方无官方从属关系；插件星标以 GitHub 为准（线索页为 0）。
结尾¶
dsh-theme-holo 把 DSH Web GUI 换成暖纸赫萝皮肤，并把开场、字标、探头、待机、便笺等做成可关的装饰层，尽量不动宿主布局。需要安装标识、完整设置说明与素材版权声明时，请查阅 SkillHub 目录页 与 GitHub 仓库 README。
