前言¶
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
适用场景与注意¶
适用场景
该插件适合需要管理大量第三方插件设置项的用户。通过统一的「扩展设置项」入口,可以快速定位和调整各插件的配置。
注意事项
- 权限范围:插件以当前 DSH 进程权限运行。在安装前,建议检查其源码与许可证,确保符合使用规范。
- 兼容性限制:部分插件(如
dsh-vision-router)使用不同的设置注册机制,暂不支持被dsh-settings-hub发现。 - 排序重置:拖拽排序的数据保存在浏览器 localStorage 中,清除浏览器数据后排序会重置为默认。
结语¶
经过上面的步骤,你可以在 DeepSeek Harness 中拥有一个整洁、有序的设置管理入口。对于追求高效开发流程的 DSH 用户而言,dsh-settings-hub 是提升插件管理体验的有效工具。
插件详情与源码可参考:GitHub