前言¶
DeepSeek Harness（DSH）的 Web 界面默认是功能向的样式：对话区、侧边栏够用，但背景与视觉层次往往比较平。若你长期在 desktop profile 里调试智能体，会希望在不改核心代码的前提下，统一主色、背景图，并在界面一角放一个可交互的 Live2D 角色——而不是自己 fork 前端或依赖外网 CDN 拉模型。
下面介绍社区插件 dsh-live2d-theme（维护者 suwenner，GitHub 仓库 suwenner/dsh-live2d-theme，目录分类为「趣味换装」）。它把背景主题与 Q 版看板娘打包进插件，运行时、默认模型和背景都在包内 assets/，装好即可用。
这是什么¶
dsh-live2d-theme 是面向 DSH Web GUI 的美化 / 皮肤类插件：支持替换 Live2D 模型、更换背景图与主题色、调整面板透明度等。宿主侧通过 lib/index.mjs 提供静态资源与配置接口，浏览器侧由 client.js 注入主题 CSS、Live2D 渲染与可视化设置面板。插件在 package.json 中声明 dshTarget 为 0.2.1-rc.2，依赖 @deepseek-ai/cordis ^4.0.1，Node >= 18。
核心功能¶
背景与主题¶
- 可配置主强调色（链接、高亮、焦点环）、文字相关配色，以及深 / 浅两套径向渐变（无背景图时的回退）。
- 支持背景图；面板采用半透明毛玻璃效果，侧边栏与对话区可透出背景。
- 字段包括
accent、backgroundImage、backgroundOpacity、gradientDark、gradientLight等，默认值写在包内assets/config.json。
Live2D 看板娘¶
- 内置 Q 版模型 HK416、Pio（Cubism 2，路径形如
/dsh-live2d-theme/models/HK416/model.json）。 - 支持眼神跟随、点击随机动作、拖动位置、缩放尺寸、隐藏 / 显示、在面板中切换模型。
- Cubism 4 模型（目录内存在
*.model3.json）也可识别；插件启动时会加载 Cubism Core，2 / 4 均可使用。
自包含与注册¶
- PIXI、Live2D 运行时、模型与默认背景位于
assets/，不依赖外网 CDN。 cordis.patch.yml在 bundle 层自注册，即使 profile 的cordis.patch.yml被重写，也不易丢失插件注册。
可视化设置面板¶
看板娘区域右上角提供快捷操作：⚙ 打开设置（实时改配色、背景、尺寸、模型，保存写回配置）；✥ 拖动位置；🙈 隐藏 / 显示。面板内可上传本地图片作为背景，保存时通过宿主 POST /dsh-live2d-theme/config 写入 live2\config.json，重启后仍保留；恢复默认 回到包内内置值。模型列表由 GET /dsh-live2d-theme/models 扫描 live2\models\ 目录得到。
安装与启用¶
方式一：插件管理器（推荐）
在已配置 DSH CLI 的环境下，对 desktop profile 执行：
dsh plugin --profile desktop add github:suwenner/dsh-live2d-theme
也可在 DSH 的「插件」页面通过插件市场或从仓库安装。
方式二：手动放进 profile
- 将插件目录放到
$DSH_HOME/plugins/dsh-live2d-theme/； - 在
$DSH_HOME/profiles/desktop/package.json的dependencies增加"dsh-live2d-theme": "file:../../plugins/dsh-live2d-theme"，并在dsh.profile.bundles中加入"dsh-live2d-theme"； - 在 profile 目录执行
pnpm install，然后重启 DSH。
典型用法¶
用面板改外观（推荐）¶
安装并刷新 Web GUI 后，点击看板娘旁的 ⚙，调整主色、背景透明度、背景图、看板娘宽高与显示状态，点击 保存 持久化。需要换模型时，在「看板娘模型」下拉框选择 HK416 或 Pio，或点 ⟳ 重新扫描新放入的模型目录。
手动编辑 config.json¶
改完保存后刷新页面即可生效（无需重启应用）。示例结构如下（字段含义以 README 为准）：
{
"accent": "#7c5cff",
"backgroundImage": "/dsh-live2d-theme/background/bg.jpg",
"backgroundOpacity": 0.55,
"gradientDark": "radial-gradient(...)",
"gradientLight": "radial-gradient(...)",
"modelUrl": "/dsh-live2d-theme/models/HK416/model.json",
"modelWidth": 260,
"modelHeight": 300,
"marginRight": 18,
"marginBottom": 10,
"visible": true
}
换背景图时，可将图片放到 live2\background\bg.jpg，或修改 backgroundImage 指向其他路径；若文件不存在，会自动回退到渐变背景。
添加自定义模型¶
将完整模型目录放入 live2\models\<名字>\（含 model.json 或 *.model3.json），在设置面板点 ⟳ 刷新列表。README 提到可从 hacxy/l2d-models 获取模型资源；使用前请遵守各模型与 assets/README.md 中的许可说明。
适用场景与注意¶
适合谁：使用 DSH desktop Web GUI、希望在本地环境快速换肤并保留可交互看板娘的用户；分类上属于「趣味换装」，不改变 Harness 核心推理逻辑。
权限与安全：插件与当前 DSH 进程同权运行，会提供配置读写与背景上传等接口。安装前建议阅读 GitHub 源码 与 MIT 许可证，确认符合你的环境策略。社区插件目录 skillhub.cn 独立于 DeepSeek / 幻方，并非官方应用商店。
卸载：删除 profile 中手动添加的依赖与 bundle 项并重启，或直接删除 $DSH_HOME/plugins/dsh-live2d-theme 目录即可回滚。
结尾¶
dsh-live2d-theme 把背景主题与 Live2D 看板娘收敛到一个可安装的 DSH 插件里，默认资源自包含，并可通过 ⚙ 面板或 config.json 持续调整。进一步了解与安装入口：
- 目录页：https://www.skillhub.cn/plugins/suwenner/dsh-live2d-theme
- GitHub：https://github.com/suwenner/dsh-live2d-theme
