前言¶
DeepSeek Harness（DSH）的界面由设计令牌驱动：--dsw-alias-* 与静态中性色阶共同决定侧栏、对话框、输入区与代码块的外观。若只改主栏背景或少量 CSS，各区域容易脱节，开机首屏也常与日常主题不一致。dsh-skin-magiclab 在令牌层按皮肤整体重写样式，并为每套皮肤配备专属开机动画与音效，适合希望在同一 Harness 实例里切换多种视觉气质、又不想 fork 主题仓库的开发者。
这是什么¶
dsh-skin-magiclab 是 magiceric 维护的 DSH 插件，归属社区分类「趣味换装」。它提供五套可切换界面皮肤，每套含一段专属开机动画与声音设计；偏好保存在本机 localStorage，不做网络请求与遥测。社区插件目录见 SkillHub 条目，源码与说明在 GitHub。
核心功能¶
令牌级换肤¶
插件按皮肤重写 DSH 的设计令牌，侧栏、对话框、Composer 与代码块随 html[data-dsh-skin="…"] 一并切换，而非仅改主栏。
五套皮肤¶
| 皮肤 ID | 视觉 | 开机画面 | 音效要点 |
|---|---|---|---|
longmarch |
暖金、近黑底、印红点缀 | 路线在抽象浮雕上自绘，旗标引导 | 行军队列脉冲与双音号角 |
sonar |
深青、磷光绿、等宽字 | 声呐扫掠与接触环 | Ping 与低频 swell |
splitflap |
板岩灰、琥珀数字 | 翻页字符落入出发牌 | 机械翻页声 |
film |
暖棕、颗粒、2.39:1 遮幅 | 放映倒计时、片门抖动、划痕 | 放映机咔哒 |
ink |
宣纸、水墨、印红 | 笔触与落墨水滴 | 水滴与纸张 |
开机动画与音频¶
每次应用启动时，当前皮肤可播放一次与主题匹配的开机动画（约前两秒与成品一致）。动画与音频在浏览器内用绘制代码与 Web Audio 生成，不依赖预录媒体文件（longmarch 另含一条经作者授权的 TTS 台词）。
外观实验室控件¶
在 设置 → 外观实验室 或侧栏 外观实验室 面板中可即时切换皮肤，并调节：
- 开机动画：开关与 重播 预览当前皮肤序列
- 开机音效：各皮肤独立提示音；浏览器策略要求首次指针或按键交互后才可出声
- 颗粒/纹理：多数皮肤使用的颗粒层
偏好键名为 dsh.skinlab.v1，仅存本机。
安装与启用¶
npm 发布渠道安装（README 写明「发布后即可用」）：
dsh plugin add dsh-skin-magiclab
从未发布仓库直接安装：
dsh plugin add github:magiceric/dsh-skin-magiclab
安装后重启宿主或刷新页面以加载 bundle。DSH Desktop 请走 设置 → 插件，由桌面端管理独立 profile。
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证（美术为代码绘制，开机音为运行时合成）。
典型用法¶
1、完成上述 dsh plugin add 之一并重载界面。
2、打开 设置 → 外观实验室，选择皮肤（如 sonar），界面应即时变化。
3、如需预览开机流程：开启 开机动画，点 重播；试听音效时先点击页面任意处再触发 重播 或重启应用。
4、不需要颗粒时可关闭 颗粒/纹理。
实现要点（供排查兼容性问题）¶
dsh.bundle.patch指向cordis.patch.yml，将插件插入 profile 层栈，使dsh plugin add生效。- 客户端为自包含
lib/client.js，经window.__ModuleLoader__注册；皮肤为基于data-dsh-skin的纯 CSS 令牌覆盖。 - 兼容 DeepSeek Harness 0.2.x（Web 与 Desktop）。若宿主重命名
--dsw-alias-*令牌，主题会回退默认，开机动画仍可工作。
适用场景与注意¶
适合长时间使用 DSH、希望用皮肤区分项目或演示场景、且接受本地存储偏好的用户。不适合需要云端同步主题或企业统一品牌化（本插件无账号与上报）的场景。
社区目录 skillhub.cn 与 GitHub 仓库 为同一插件的索引与源码入口；目录站为社区生态站点，与 DeepSeek / 幻方无官方从属关系。
