前言¶
DeepSeek Harness(DSH)桌面端默认是一套通用工作台皮肤。若你长期在本地跑智能体会话,界面配色和开屏体验往往只是「能用」,很难按个人偏好切换,也不方便在保留原生主题的前提下做轻度个性化。
社区插件 dsh-eva-skins(维护者 Iris-change)面向同一类需求:在不改动 DSH 安装目录、不替换 app.asar、不需要独立启动器的前提下,用 DSH 原生插件机制挂上四套 EVA 机体主题,并支持随时切回默认外观。插件归类为「趣味换装」,在 SkillHub 目录页 可查;源码与说明见 GitHub 仓库。
下文按「是什么 → 能做什么 → 怎么装 → 怎么用 → 注意点」说明,事实均来自仓库 README 与 package.json。
这是什么¶
dsh-eva-skins 是 DSH 桌面客户端的皮肤插件:一个 npm 包、一份 client.js,内建四套皮肤(二号机 / 零号机 / 初号机 / 八号机),从 DSH 桌面图标正常启动即可生效。它通过 cordis.patch.yml 注入客户端,并依赖 DSH 的 @deepseek-ai/dsh-client-ui-theme 注入点,而不是在外部覆写应用资源。
仓库自述要求宿主 dsh 版本满足 >=0.2.0-rc.1 <0.3.0-0(见 package.json 的 engines.dsh)。README 中记录的当前包版本为 2.1.6;升级请以 Releases 为准。
核心功能¶
四套皮肤与切换方式¶
装好后,输入框左侧会出现胶囊按钮(示例文案形如 ● UNIT-02 ▾)。点开可在以下选项中切换,并保留「默认主题」回到 DSH 原生外观:
| 皮肤 | 机体 | 配色 |
|---|---|---|
ASUKA · UNIT-02 |
二号机 | 红橙 |
REI · UNIT-00 |
零号机 | 白蓝 |
SHINJI · UNIT-01 |
初号机 | 紫绿 |
MARI · UNIT-08 |
八号机 | 粉绿 |
选择会写入 localStorage,下次启动保持一致。
开机动画¶
每套皮肤有独立开机序列(EVANGELION-02 / 00 / 01 / 08):系统唤醒 → LCL 注入 → 同步率 → 驾驶员确认卡 → 转场到工作台。
- 时长约 20 秒;约 13.3 秒处定格等待确认,点「驾驶员确认,开始同步」继续
- 右下角「进入工作台」或
Esc可跳过;Ctrl+Alt+B可重播 - 每次重新打开应用播一次;20 分钟内刷新页面不重复播放
- 日文播报来自各皮肤目录下的
voice.wav,默认开启;无声卡环境会回退到挂钟计时
快捷键与控制台 API¶
| 组合 | 作用 |
|---|---|
Ctrl + Alt + U |
开 / 关皮肤 |
Ctrl + Alt + B |
重播开机动画 |
Esc |
跳过开机动画 |
脚本或调试时可用:
window.unit02Skin.setSkin("rei") // "off" | "asuka" | "rei" | "shinji" | "mari"
window.unit02Skin.replayBoot()
window.unit02Skin.openPicker()
实现要点(便于判断是否适合你)¶
README 说明:四套皮肤共用一个 client.js,按当前皮肤 id 加载对应动画 iframe 路径(如 /unit02-intro/、/rei-intro/ 等),再切换 CSS 变量与装饰层——不是四个独立插件,因此不会出现多份样式互相覆盖。lib/index.js 在 host 侧为各套动画注册静态路由。
安装与启用¶
插件以当前 dsh 进程权限运行,安装会向 profile 目录(如 ~/.dsh/profiles/desktop/)写入配置;使用前宜浏览源码与 NOTICE.md 中的素材授权说明。SkillHub 为社区目录站点,与 DeepSeek / 幻方无官方从属关系;安装命令以 README 原文为准。
方式 A:Releases 压缩包(README 推荐)¶
到仓库 Releases 下载对应平台包:Windows 解压后双击 一键安装.cmd;macOS 解压后执行 bash install-mac.command。
方式 B:npm(一条命令)¶
dsh plugin --profile desktop add dsh-eva-skins
方式 C:本地目录(README 记载的仓库路径方式)¶
若你已将仓库置于本机目录,README 给出:
dsh plugin --profile desktop add ./dsh-eva-skins
README 注明:该方式在 profile 中记录为 link: 软链,删除文件夹会导致皮肤失效;长期自用可保留目录或改用 Releases / npm。
装完必须彻底退出 DSH(任务栏图标右键退出,或结束 DeepSeek Harness.exe),再重新打开;仅关窗口不算退出。macOS 用户若安装脚本报路径错误,README 建议到 Issue 附带 ls /Applications 结果(脚本未在真机完整验证)。
更新版本¶
皮肤不会自动更新。README 实测:已固定版本号后,再次执行不带版本的 add dsh-eva-skins 不会升级,需指定版本或先卸载再装,例如:
dsh plugin --profile desktop add dsh-eva-skins@2.1.6
或:
dsh plugin --profile desktop remove dsh-eva-skins
dsh plugin --profile desktop add dsh-eva-skins
改完后同样需彻底退出再启动。原因 README 已说明:插件运行在 DSH 进程内,替换自身文件必须重启应用,且宿主暂无「插件自更新」接口。
也可在 DSH 会话中让 agent 代为执行 dsh plugin add,但需授予完全访问权限(workspace-write 模式无法写入 profile 目录外路径)。
典型用法¶
- 按上一节任选一种方式安装,并完全退出后重启 DSH。
- 启动后若播放开机动画,可用
Esc跳过,或等待确认卡后继续。 - 点击输入框左侧胶囊,在四套机体或「默认主题」间切换;需要时用
Ctrl+Alt+U临时关闭皮肤效果。 - 若要在自动化或调试里切皮肤,在 DevTools 控制台调用
window.unit02Skin.setSkin(...)。
卸载:
dsh plugin --profile desktop remove dsh-eva-skins
Windows / macOS 亦可运行包内 卸载.cmd 或 uninstall-mac.command,然后彻底退出重开。
适用场景与注意¶
适合谁: 日常在 DSH 桌面端长时间对话、希望工作台有统一主题与开屏 ritual,又需要一键回到默认 UI 的开发者或爱好者。
版权与分发: 代码(lib/、client/client.js、安装脚本等)以 MIT 发布;EVANGELION、NERV、EVA 机体与角色相关图像、音频不在 MIT 范围内,版权归 khara,仓库作为粉丝创作分发且声明不用于商业用途、不主张权利。介意版权者可按 README「替换素材」一节用同名占位图替换 client/intro*/media/ 下文件,逻辑可保留。
已知限制(README 列举):
- 窗口标题栏(Electron
titleBarOverlay)颜色插件 CSS 无法修改,页面顶部用 2px 皮肤色细线做视觉衔接。 Ctrl+R未必能重载界面;改皮肤后建议彻底退出再启动。- macOS 安装路径为按 Windows 结构推断,遇
not found需在 Issue 反馈环境信息。
结尾¶
dsh-eva-skins 把「四套 EVA 工作台主题 + 可跳过开机动画 + 应用内切换器」收成单个 DSH 插件,安装与卸载都走标准 dsh plugin 或发行包脚本,适合在桌面 harness 里做趣味换装而不碰安装包本体。