前言¶
DeepSeek Harness(DSH)的理念是「一切皆插件」,设置侧栏里的每个板块都是插件通过 settings.section slot 注册的。插件装多了,导航板块随之变多,顺序又取决于注册顺序,用不到的板块也只能一直挂在导航里。dsh-settings-sections 就是为这个场景准备的:把设置侧栏的显示、隐藏和排序交给用户自己管理。下面介绍它的功能、安装方式和使用步骤。
这是什么¶
dsh-settings-sections 是 ovo669 维护的一个轻量插件,当前版本 1.0.1,MIT 许可证。一句话定位:在 DeepSeek Harness 设置面板里管理「侧栏板块」显示、隐藏与排序,纯客户端实现,状态保存在 localStorage。
两个特点先交代清楚:
- 纯客户端,无宿主端逻辑,兼容 DeepSeek Harness EAC(桌面客户端);
- 隐藏板块只是不在导航里显示,不会删除任何设置内容,随时可以重新开启。
核心功能¶
按 README 描述,插件提供这些能力:
- 在「设置」导航顶部新增一个「设置板块」管理页;
- 每个板块一个开关,点击立即显示或隐藏对应板块;
- 拖动某一行左侧的手柄可调整板块顺序,顺序同步到左侧导航;
- 「全部显示」「恢复默认排序」一键恢复;
- 隐藏状态与排序保存在 localStorage,重启后自动恢复。
实现原理¶
DSH 设置侧栏的每个板块都是插件通过 settings.section 这个 slot 注册的,本插件的做法是:
- 向
settings.section注册一个自己的管理页,放在最顶部; - 读取所有已注册板块,渲染成开关列表;
- 切换开关时,通过 MutationObserver 把左侧导航里被隐藏板块对应的按钮隐藏(
display:none); - 拖动排序时,按自定义顺序重排左侧导航按钮的 DOM 位置;
- 隐藏列表与排序都写入 localStorage。
整个过程纯客户端完成,不涉及宿主端逻辑。
安装¶
README 提供两种安装方式,未给出 CLI 安装命令。
方式一:手动安装¶
先把仓库(或 dsh-settings-sections 文件夹)放到 profile 的 node_modules:
C:\Users\<用户名>\.dsh\profiles\<profile>\node_modules\dsh-settings-sections\
再在 profile 的 cordis.patch.yml 末尾加入:
- insert:
- id: settings-sections
name: 'dsh-settings-sections'
然后完全退出 DSH 再打开,按 Ctrl+Shift+R 刷新页面。经过上面的步骤,管理页就会出现在设置导航顶部。插件声明的 peerDependency 是 @deepseek-ai/cordis ^4.0.1。
方式二:插件市场¶
仓库带有 dsh-plugin 标签,可以在 DSH 的 Zat 插件市场搜索 dsh-settings-sections 安装。
典型用法¶
打开「设置」→ 顶部「设置板块」进入管理页:
- 勾选或取消勾选各板块右侧的开关,显示或隐藏对应板块;
- 按住某一行左侧的「⠿」手柄上下拖动,调整板块在左侧导航里的顺序;
- 想恢复原状时,点「全部显示」或「恢复默认排序」一键恢复。
切换开关立即生效;隐藏列表与排序写入 localStorage,重启 DSH 后仍会保留。
适用场景与注意事项¶
适合的场景:
- 安装的插件较多,设置侧栏板块拥挤,想隐藏不常用的板块;
- 对板块顺序有偏好,想让高频板块排在导航前面;
- 顺序被打乱后,需要一键恢复默认排序。
安装前需要注意:
- 插件以当前 dsh 进程的权限运行,安装前建议查看仓库源码,确认行为符合预期;
- 许可证为 MIT,仓库地址见文末;
- 隐藏板块不会删除任何设置内容,随时可在管理页重新开启。
结尾¶
dsh-settings-sections 解决的是一个小而具体的问题:设置侧栏的显示与排序。如果 DSH 里的板块越装越多,可以用它整理一遍,成本低,随时可逆。
- 社区插件目录页:https://www.skillhub.cn/plugins/ovo669/dsh-settings-sections
- GitHub 仓库:https://github.com/ovo669/dsh-settings-sections
其中 skillhub.cn 是独立的社区插件目录,与 DeepSeek、幻方没有官方从属关系。