dsh-settings-sections:管理 DeepSeek Harness 设置侧栏的显示、隐藏与排序

前言

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 注册的,本插件的做法是:

  1. settings.section 注册一个自己的管理页,放在最顶部;
  2. 读取所有已注册板块,渲染成开关列表;
  3. 切换开关时,通过 MutationObserver 把左侧导航里被隐藏板块对应的按钮隐藏(display:none);
  4. 拖动排序时,按自定义顺序重排左侧导航按钮的 DOM 位置;
  5. 隐藏列表与排序都写入 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 安装。

典型用法

打开「设置」→ 顶部「设置板块」进入管理页:

  1. 勾选或取消勾选各板块右侧的开关,显示或隐藏对应板块;
  2. 按住某一行左侧的「⠿」手柄上下拖动,调整板块在左侧导航里的顺序;
  3. 想恢复原状时,点「全部显示」或「恢复默认排序」一键恢复。

切换开关立即生效;隐藏列表与排序写入 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、幻方没有官方从属关系。

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

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

小夜