# @domitor-syh/dsh-ui-skin-switcher 中文文档

规范地址：https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/

版本：0\.3\.1
npm 元数据更新时间：2026-11-13T14:00:33.740Z
中文译文更新时间：2026-11-14T10:51:52.190Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40domitor-syh/dsh-ui-skin-switcher
原文对照：https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/?lang=original
项目主页：https://github.com/domitor-syh/dsh-ui-skin-switcher#readme
源码仓库：https://github.com/domitor-syh/dsh-ui-skin-switcher

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：243 kB，12 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：react ^18\.2\.0
- 首次发布：2026-08-27T15:11:33.355Z
- 最新版本发布：2026-11-13T14:00:33.556Z
- 近 30 天下载量：2069（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

模型和推理-努力切换器: 作曲座椅并带有 Off/Max 努力滑行会话. 模式/ 会话.select Model

## 安装

```sh
npm install @domitor-syh/dsh-ui-skin-switcher
```

也可以使用：`pnpm add @domitor-syh/dsh-ui-skin-switcher`、`yarn add @domitor-syh/dsh-ui-skin-switcher`、`bun add @domitor-syh/dsh-ui-skin-switcher`

## README

# dsh-ui-skin-switcher · DeepSeek Harness（DSH）模型与思考强度切换器

![dsh-ui-skin-switcher](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/docs/README-Banner.jpeg)

中文 | [English](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/README.en.md)

[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com/) [![listed plugins](https://img.shields.io/endpoint?url=https://awesome-dsh-plugin.com/count.json)](https://awesome-dsh-plugin.com/) [![npm](https://img.shields.io/npm/v/@domitor-syh/dsh-ui-skin-switcher)](https://www.npmjs.com/package/@domitor-syh/dsh-ui-skin-switcher) [![downloads](https://img.shields.io/npm/dt/@domitor-syh/dsh-ui-skin-switcher)](https://www.npmjs.com/package/@domitor-syh/dsh-ui-skin-switcher) [![MIT License](https://img.shields.io/badge/license-MIT-green)](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/LICENSE) [![CI](https://img.shields.io/github/actions/workflow/status/domitor-syh/dsh-ui-skin-switcher/ci.yml?branch=main)](https://github.com/domitor-syh/dsh-ui-skin-switcher/actions/workflows/ci.yml)

为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）Web 端打造的 **Claude Desktop 同款风格切换器**：换模型、调思考强度，都不用离开输入框。

[是什么](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E6%98%AF%E4%BB%80%E4%B9%88) · [功能特性](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E5%8A%9F%E8%83%BD%E7%89%B9%E6%80%A7) · [视频预览](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E8%A7%86%E9%A2%91%E9%A2%84%E8%A7%88) · [安装](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E5%AE%89%E8%A3%85) · [使用方法](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95) · [为什么没有思考强度？](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E4%B8%BA%E4%BB%80%E4%B9%88%E6%8E%A5%E5%85%A5%E6%A8%A1%E5%9E%8B%E4%B9%8B%E5%90%8E%E6%B2%A1%E6%9C%89%E6%80%9D%E8%80%83%E5%BC%BA%E5%BA%A6) · [常见问题](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98) · [许可证](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/#readme-%E8%AE%B8%E5%8F%AF%E8%AF%81)

## 是什么

一枚悬在输入框旁的**模型与思考强度切换器**：点开下拉挑模型，拖动滑块调推理力度，选定即刻作用于当前会话。

模型按厂商分组排列，当前使用的那一个带勾选标记；强度档位跟随模型自己的能力，切走再切回，上次的选择还记得。

样式致敬 Claude Desktop 的切换器：滑动手感、圆角轨道、悬停高亮。

## 功能特性

| 能力 | 说明 |
| --- | --- |
| 模型切换 | 点击模型入口将展开按厂商依次排列的模型列表，选定模型后立即生效，对应的思考强度也会同步变更。 |
| 思考强度滑块 | 思考强度滑块支持点击与拖动双操作方式，设有多个强度节点；不同模型适配的强度档位存在差异，调节后立即生效。 |
| 最高强度点阵动画 | 达到最高思考强度时，轨道内浮现从右向左扫过的点阵动画，且滑块伴随着发光 |
| 逐模型记忆 | 记住每个模型最后一次选择的思考强度，切走再切回，强度不丢 |
| 主题自适应 | 全部颜色绑定 DSH 主题变量，深浅主题、透明背景皮肤下都清晰可读 |

## 视频预览

[https://github.com/user-attachments/assets/3e60e874-4d08-44b3-be00-5e5ab213187c](https://github.com/user-attachments/assets/3e60e874-4d08-44b3-be00-5e5ab213187c)

> 如页面内视频无法播放，请点击**下方链接**，在新标签页中直接观看，无需登录 GitHub。

**▶︎ [点击观看完整演示视频](https://cdn.jsdelivr.net/gh/domitor-syh/dsh-ui-skin-switcher@main/docs/dsh-ui-skin-switcher-demo.mp4)** —— 模型切换、思考强度滑块、最高档点阵动画的完整演示。

**DIY 调色器** —— 在插件详情页里调整整套界面配色：

![DIY 调色器](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/docs/diy-color-panel-zh.png)

## 安装

**Web 端**（`dsh web`）：

```sh
dsh plugin --profile web add @domitor-syh/dsh-ui-skin-switcher
```

**桌面端**（官方渠道）——在桌面应用的插件安装处粘贴以下包名，即可安装或更新：

```sh
@domitor-syh/dsh-ui-skin-switcher
```

安装后：Web 端重启 `dsh web` 并刷新页面；桌面端重启桌面应用。从 DSH 源码运行 Web 安装命令时，在命令前加 `pnpm`。

当前适配目标为 **DSH 0.2.2-rc.1**，声明的兼容范围为 `>=0.1.5-alpha.1`。该范围基于 `0.1.5-alpha.1`、`0.2.0-rc.2`、`0.2.1-rc.2`、`0.2.1-rc.3`、`0.2.1-rc.5` 与 `0.2.2-rc.1` 的核心接口源码核对；其他构建仍需确认兼容性，未来版本也未全部实测。

## 使用方法

1.  **切模型**：点击输入框旁的按钮，在列表里选一个模型；列表按厂商分组，当前模型带勾选标记。
2.  **调强度**：对提供了思考强度信息的模型，模型右侧会出现思考强度按钮，点击之后——拖动滑块或在轨道上点按即可切换档位。

### 为什么接入模型之后没有思考强度？

这是因为当前模型不支持或尚未配置思考强度（`reasoningEfforts`）。**DSH 0.2.1-rc.1 及更高版本**可在**设置 → 模型**中配置各模型的推理等级；旧版本需自行修改配置文件。为确保模型响应正确，请参照对应厂商的模型配置文档填写支持的档位和值，也可将文档或链接交给大模型协助配置。

> 生效方式：你修改的是 DSH 主目录（`~/.dsh`）下的 `settings.yaml`，**不是本插件的文件**；DSH 会监听该文件并**热加载，立即生效，无需重启**，有效配置会同步到模型列表和强度选项，下次启动依然有效。

为什么要依据厂商文档配置？是为了确保声明的准确——**声明准确 > 声明齐全**。不同厂商、不同模型支持的档位和值可能不同，填写错误可能导致请求失败或配置不生效，因此我们不代填统一档位。

## 常见问题

**为什么我的模型没有出现思考强度滑块？**

滑块只为提供了推理等级信息的模型显示，未支持或未配置时只显示模型切换按钮。**DSH 0.2.1-rc.1 及更高版本**可在**设置 → 模型**中配置各模型的推理等级；旧版本需自行修改配置文件。为确保模型响应正确，请参照对应厂商的模型配置文档填写支持的档位和值。

**切换主题后切换器颜色不对？**

插件颜色全部绑定 DSH 主题变量（`--dsw-alias-*`），随深浅主题自动翻转。若你用了把背景设成透明的皮肤，浮层会自动启用毛玻璃（backdrop-filter）保住可读性。

## 许可证

[MIT](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/LICENSE)

界面内嵌的 Space Grotesk 字体以 SIL OFL 1.1 授权分发，完整许可见 [LICENSES/SpaceGrotesk-OFL.txt](https://npmcn.com/package/%40domitor-syh/dsh-ui-skin-switcher/LICENSES/SpaceGrotesk-OFL.txt)。

## 常见问题

### @domitor-syh/dsh-ui-skin-switcher 是什么？

模型和推理-努力切换器: 作曲座椅并带有 Off/Max 努力滑行会话\. 模式/ 会话\.select Model

### 如何安装 @domitor-syh/dsh-ui-skin-switcher？

在项目目录运行 npm install @domitor-syh/dsh-ui-skin-switcher，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @domitor-syh/dsh-ui-skin-switcher 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/domitor-syh\_\_dsh-ui-skin-switcher 是否存在。

### @domitor-syh/dsh-ui-skin-switcher 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @domitor-syh/dsh-ui-skin-switcher 可以商用吗？

@domitor-syh/dsh-ui-skin-switcher 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @domitor-syh/dsh-ui-skin-switcher 的下载量有多少？

根据 npm 官方下载统计，@domitor-syh/dsh-ui-skin-switcher 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,069 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @domitor-syh/dsh-ui-skin-switcher 还在维护吗？

最新版本 0\.3\.1 发布于 2026/11/13（今天）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/08/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

