前言¶

在 DeepSeek Harness（DSH）里做 Web 界面相关任务时，常会用到 ui-ux-pro-max 这类 UI/UX 设计技能。该技能在通用场景下可用，但原生并未按 DSH 插件形态接入；若你希望在对话过程中随时打开或关掉它，又不想改 profile 配置或重启服务，就需要一个在运行时门控技能的客户端插件。

dsh-ui-design-toggle（仓库 YukoZ1227/dsh-ui-design-toggle）由维护者 YukoZ1227 提供，分类为客户端插件。它在 Web GUI 侧边栏底部增加「UI 设计技能」开关，用于启用或停用 ui-ux-pro-max，并适配 DSH 0.2.1-rc.2。下面介绍其定位、能力与安装用法。

这是什么¶

一句话：DSH 插件，在 web profile 的侧边栏底部渲染开关，运行时切换 ui-ux-pro-max 是否参与模型侧技能消费。

插件当前 npm 包版本为 0.2.1，依赖 @deepseek-ai/cordis ~4.0.5、@deepseek-ai/dsh-skill 0.2.1-rc.2、@deepseek-ai/schemastery ~3.18.5，宿主侧仅使用 DSH 自带的 @deepseek-ai/* 包，浏览器侧使用 shell 已提供的 React 与服务，无额外第三方依赖。

核心功能¶

侧边栏开关与界面行为¶

开关挂在 sidebar.footer.action 槽位，不占用主内容区。副标题会显示 ui-ux-pro-max · 已启用 或 已关闭。侧边栏收起时变为图标按钮，悬停可看状态提示。

运行时门控¶

切换后立即生效，无需重启 DSH；开关状态会持久化，重启后保持。

关闭时，目标技能会从以下三条路径一并移除（snapshot() / list() / get() 均覆盖）：

• <available_skills> 目录展示；
• skill 工具加载；
• /ui-ux-pro-max 手势。

要门控的技能名与开关状态写在插件条目 Config 的 volatile() 字段中，随 profile 设置文档保存。

环境与兼容性¶

适用 profile：web（需要 slots、configForms 等服务）。

安装前请确认本机已安装 DSH 与 pnpm：

dsh --version   # 应显示 0.2.1-rc.2 或更高
pnpm -v         # 无输出时可先：npm i -g pnpm

Node 要求 >=20（见 package.json 的 engines）。

安装与启用¶

插件以当前 dsh 进程权限安装与运行；安装前建议浏览仓库源码与 MIT 许可证。DSH 社区插件目录为独立站点（如 SkillHub 条目页），与 DeepSeek / 幻方无官方从属关系。

方式一：插件市场（无需终端）¶

1. 打开 Web GUI → 右上角账号菜单 → 设置 → 插件市场（DSH 0.2.1 起该入口在账号菜单）。
2. 搜索 dsh-ui-design-toggle，或在 UI 增强 分类中查找。
3. 点击 安装，完成后刷新页面。

若市场里搜不到：市场仅展示 awesome-dsh-plugin 精选列表中的插件，未收录时需用下文命令行方式安装。

方式二：一条 npm 命令（常用）¶

在已安装 dsh 与 pnpm 的前提下执行：

dsh plugin --profile web add dsh-ui-design-toggle

该命令会把包装入 profile 依赖，并把 dsh-ui-design-toggle 写入 %DSH_HOME%/profiles/web/package.json 的 dsh.profile.bundles。重启或刷新 Web GUI 后，侧边栏底部应出现「UI 设计技能」开关。

校验是否写入配置：

dsh --profile web --dump-config | grep -A2 ui-design-toggle

期望看到 id: ui-design-toggle、name: dsh-ui-design-toggle 及 config: 段。

其他安装方式（按需）¶

• 预构建 tarball（固定版本或内网分发）：

dsh plugin --profile web add https://github.com/YukoZ1227/dsh-ui-design-toggle/releases/download/v0.2.1/dsh-ui-design-toggle-0.2.1.tgz

• 一键脚本：Windows 用 install.ps1，macOS / Linux 用 install.sh（见仓库 README「方式四」）。
• 若 dsh plugin add 出现 npm error 404，说明 npm 上可能尚未发布该包，可改用 tarball 或按 README「方式五」从源码路径安装。

升级 DSH 后若出现 skipping profile bundle "dsh-ui-design-toggle"，多为 profile node_modules 被清空而 bundles 仍引用该包，重新执行上面的 add 命令即可。

典型用法¶

1. 打开 Web GUI，在侧边栏底部找到「UI 设计技能」开关。
2. 开启：模型侧技能目录包含 ui-ux-pro-max，可正常使用该设计技能。
3. 关闭：技能从目录与 skill 工具中隐藏，上述三条消费路径均不可达。
4. 收起侧边栏时用图标按钮操作，悬停查看当前状态。

配置说明¶

配置写入 profile 的 cordis.patch.yml（设置文档），也可仅通过侧边栏开关修改：

- id: ui-design-toggle
  name: dsh-ui-design-toggle
  config:
    skill: ui-ux-pro-max   # 要门控的技能名（默认 ui-ux-pro-max）
    enabled: true          # 开关状态（默认 true）

适用场景与注意¶

适合已在 web profile 使用 DSH、且需要按需开关 ui-ux-pro-max 的开发者：写前端/UI 稿时打开，做纯后端或不想占用技能槽时关闭，无需手改 YAML 或反复重启。

注意：

• 仅 web profile；其他 profile 不会出现侧边栏开关。
• 门控的是配置项 skill 指定的技能名，默认 ui-ux-pro-max；若你改名或换技能，需同步改 config.skill。
• 插件不替代 ui-ux-pro-max 本身，只控制其在 DSH 中的可见性与加载；设计技能仍需单独安装并满足 DSH 技能体系要求。

结尾¶

dsh-ui-design-toggle 把「是否启用 ui-ux-pro-max」做成侧边栏上的一个持久化开关，并在关闭时从技能目录、skill 工具与手势路径完整移除，适合在 DSH 0.2.1-rc.2 的 Web 工作流里做轻量门控。

• 社区目录：SkillHub - dsh-ui-design-toggle
• 源码与文档：GitHub - YukoZ1227/dsh-ui-design-toggle