前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。随着开发者安装的插件增多，全局设置对话框中的分区会变得杂乱。dsh-settings-manager 旨在解决这一问题，提供一个无需修改上游代码（deepseek-harness）就能管理其他插件在设置界面中放置的方案。
插件简介¶
该插件由开发者 Yiklek 维护，属于客户端组件。它的核心价值在于统一管理设置导航栏的布局，允许用户对已注册的设置分区进行显示/隐藏、排序和重命名，并确保这些策略持久化保存。
核心功能¶
插件提供以下具体能力：
- 显示/隐藏分区：在设置导航栏中直接控制分区的可见性，隐藏的分区将不再渲染。
- 排序与拖拽：支持上移、下移按钮调整顺序，也支持拖拽操作。松手后，分区会按插入位置重排，编号精确且无冲突。
- 行内改名：点击铅笔图标进入编辑模式，修改设置导航的显示名称，内容头仍由原插件控制。
- 导航滚动适配：修复了设置外壳导航栏无法滚动的问题，确保所有分区（包括排到末尾的）均可访问。
- 窄屏适配：在 ≤520px 的视口下自动收窄导航栏并紧凑布局，隐藏拖拽抓手。
- 多语言支持：内置简体中文与英文，跟随外壳语言切换。
- 信息展示：展示每个分区的 ID 与来源插件（registrant）。
- 策略持久化：所有更改通过 DSH 标准的 settings 命名空间（
settings-manager）持久化到服务端。
安装与启用¶
使用官方 CLI 进行安装。
dsh plugin --profile web add dsh-settings-manager
安装完成后，重启 dsh web 进程即可生效。
典型用法¶
安装后，进入全局设置界面，导航栏顶部会出现「设置编排」入口。在该面板中可以执行以下操作：
- 列出与查看：查看所有已注册的设置分区（包含内置的 base 分区）。
- 隐藏/显示：点击开关切换分区可见性。
- 拖拽排序：按住行首抓手拖动分区，蓝色指示线会显示落点位置。
- 重命名：点击铅笔图标修改导航名称。
- 重置：清除单个分区或全部分区的自定义策略，恢复默认状态。
适用场景与注意事项¶
该插件适合希望定制化 DeepSeek Harness 设置界面布局的开发者或高级用户。
- 本地保存：策略变更即时生效，并保存在浏览器本地。
- 自身保护：本插件自身的分区（
settings-manager）不可隐藏，确保管理入口始终可达。 - Base 分区优先：通用设置、模型、插件等 base 分区永远先于第三方插件注册，本插件通过读路径拦截覆盖所有分区，不依赖加载顺序。
- 图标限制：导航图标来自设置外壳的内置封闭列表，本插件仅显示通用齿轮图标。
- 空状态处理：隐藏当前正在查看的分区时，内容区会显示空占位符，导航栏其余项仍可点击。
结语¶
dsh-settings-manager 让用户在不触碰上游源码的情况下，获得了对 DSH 设置界面的完全控制权。这种轻量级的定制能力是 DSH 插件生态的重要补充。
