前言¶
DeepSeek Harness (DSH) 采用了插件化架构，允许开发者通过扩展功能来增强客户端体验。在实际使用或开发中，如果需要调整界面风格以适应特定场景（如模拟特定聊天环境或进行 UI 调研），直接修改核心代码往往成本较高。下面介绍 lispking/dsh-qq-skin，它通过覆盖主题 Token 和注入布局层，为 DSH Web 客户端提供原生的 QQ 消息器风格。
插件介绍¶
这是一个面向 DeepSeek Harness (dsh) 的 QQ NT 消息器皮肤插件，由开发者 lispking 维护。它通过双层结构实现 UI 风格切换：不注册新的主题 ID，而是直接覆盖现有的语义 Token（Token layer），并通过全局 CSS 注入调整布局（Layout layer）。浅色模式追求干净克制，深色模式则为冷静的蓝灰色调。
核心功能¶
- 双层架构与零干扰：插件包含 Token 层和布局层两层。卸载时会通过效果清理完全移除，使产品外观恢复默认。它不会触碰用户的浅色/深色/系统跟随偏好设置。
- 五种配色方案：内置 Classic Blue（经典蓝）、Vivid Purple（生动紫）、Clean White（纯净白）、Green Bubble（绿气泡）、Deep Black（深黑）五种变体。
- 可配置开关：支持调节配色方案、气泡尾巴形状、助手头像显示、聊天流最大宽度。
- 热重载：通过设置面板修改配置后，无需重启插件即可立即重新应用两层样式。
安装与启用¶
在终端中执行以下命令，将插件安装到 web profile：
dsh plugin --profile web add dsh-qq-skin
dsh plugin 命令会初始化 profile、在 profile 目录运行 pnpm add，并将插件的 bundle layer 与当前已安装状态合并。插件声明了 dsh.client 与 dsh.bundle.patch，因此 dsh web 启动时会自动加载客户端包并在 ui-theme 激活时应用皮肤。
配置与用法¶
插件接收 Cordis 函数插件格式的配置对象 (apply(ctx, config))，未设置的字段会回退到默认值。
| 配置项 | 默认值 | 说明 |
|---|---|---|
palette |
'classic' |
配色方案：classic (经典蓝) / vivid (生动紫) / clean (纯净白) / green (绿气泡) / black (深黑) |
bubbleTail |
true |
用户气泡右侧的小三角尾巴 |
assistantAvatar |
true |
助手消息左侧的企鹅头像圆盘 |
chatMaxWidth |
880 |
聊天流的最大宽度（像素） |
配置示例（可在 profile 的插件配置中设置）：
{ "palette": "vivid", "bubbleTail": false, "chatMaxWidth": 720 }
注意事项¶
- 依赖版本：需要安装
deepseek-harness (dsh) 0.1.2-alpha.5或更高版本。 - 生态背景：DSH 的插件生态独立于 DeepSeek 官方，社区目录（如 SkillHub）与 DeepSeek / 幻方无官方从属关系。
- 权限与安全：插件以当前 DSH 进程权限运行，安装前建议查阅源码与许可证。
结语¶
lispking/dsh-qq-skin 提供了一种低侵入性的 UI 定制方案，通过热重载和配置化的设计，使得开发者可以快速切换界面风格。更多细节与源码，可参考以下链接：GitHub 仓库 | 插件目录。
