dsh-settings-hub:统一管理 DeepSeek Harness 第三方插件设置项

前言

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。开发者通常会安装多个第三方插件来扩展功能,例如模型路由、视觉处理等。这些插件各自注册设置项,导致侧边栏设置列表逐渐膨胀且杂乱。dsh-settings-hub 插件旨在解决这一问题,通过统一的入口聚合所有第三方插件的设置项。

插件介绍

名称:dsh-settings-hub

维护者:Amengclass

定位:统一管理 DeepSeek Harness 第三方插件设置项的插件

核心功能

该插件主要解决第三方插件设置项分散的问题,具体能力如下:

  • 统一入口:所有第三方插件的设置项自动归入「扩展设置项」分组,不再散落在侧边栏各处。
  • 动态发现:新安装的插件自动出现,无需手动配置或修改代码。
  • 分组归属:按父插件自动分组,每个插件的子设置项聚合在一起。
  • 拖拽排序:支持拖拽调整分组和子项顺序,顺序持久化到 localStorage。
  • 幽灵拖拽:拖拽时原位置保持不变,半透明幽灵跟随鼠标,视觉反馈清晰。
  • 零侵入:不修改 DSH 源码,通过官方 shadow 机制接管 sidebar.settings 插槽。
  • 双端兼容:同时支持 dsh web 与 DSH 桌面应用(DSH 0.1.x / 0.2.x)。

安装与启用

Web 端安装

先执行安装命令:

dsh plugin --profile web add dsh-settings-hub

安装完成后,启动 Web 端即可:

dsh web

打开浏览器访问 http://127.0.0.1:3080,点击左下角「设置」即可看到效果。

前置条件注意事项

  • pnpm 11 用户:如果安装遇到问题,需在 ~/.dsh/profiles/web/pnpm-workspace.yaml 中添加以下配置:
    minimumReleaseAgeExclude:
      - dsh-settings-hub
  • 桌面端用户:DSH 桌面应用使用独立的 profile(~/.dsh/profiles/desktop),需要在桌面端自带的插件管理界面安装本插件,而不是执行 dsh plugin --profile web add。

典型用法

安装后,用户可以通过以下命令进行管理:

  • 卸载:
    dsh plugin --profile web remove dsh-settings-hub
  • 查看插件目录:确认插件是否安装成功,可执行:
    ls node_modules/dsh-settings-hub

适用场景与注意

适用场景

该插件适合需要管理大量第三方插件设置项的用户。通过统一的「扩展设置项」入口,可以快速定位和调整各插件的配置。

注意事项

  1. 权限范围:插件以当前 DSH 进程权限运行。在安装前,建议检查其源码与许可证,确保符合使用规范。
  2. 兼容性限制:部分插件(如 dsh-vision-router)使用不同的设置注册机制,暂不支持被 dsh-settings-hub 发现。
  3. 排序重置:拖拽排序的数据保存在浏览器 localStorage 中,清除浏览器数据后排序会重置为默认。

结语

经过上面的步骤,你可以在 DeepSeek Harness 中拥有一个整洁、有序的设置管理入口。对于追求高效开发流程的 DSH 用户而言,dsh-settings-hub 是提升插件管理体验的有效工具。

插件详情与源码可参考:GitHub

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜