dsh-sidebar-fold:折叠 DeepSeek Harness 侧边栏插件列表面板区

前言

在 DeepSeek Harness(DSH)里装多个带侧边栏入口的插件时,sidebar.panellist 注册项会连在一起变长,占掉左侧纵向空间,下面的工作区 / 会话浏览器容易被挤小。官方 0.2.x 侧边栏本身没有「整块面板列表一键收起」的交互。下面介绍社区插件 dsh-sidebar-fold:在面板列表上方加一行可折叠标题,单击收起全部入口、再单击展开,把纵向空间还给工作区区域。

这是什么

dsh-sidebar-fold(GitHub:Yazzyk/dsh-sidebar-fold,维护者 Yazzyk)是面向 DSH 客户端(web) 的插件:让左侧边栏中 插件 / global-panel 入口所在的那一段列表 可折叠。无 host 侧逻辑、无工具、无存储、无网络,纯浏览器端行为。许可证为 MIT(见仓库 README)。

核心功能

资料中可核实的能力如下。

  1. 折叠区目标:针对侧边栏里插件与 global-panel 的入口列表;在列表上方插入紧凑的区段标题,一次点击收起全部条目,再点击恢复。
  2. 与现版侧边栏共存:面向随 DSH 发布的 0.2.x 侧边栏(抽屉、固定、more 菜单、快捷键仍可用);通过观察 nav[aria-label] 地标实现,不引入或替换其他插件组件。
  3. 显示条件:仅在 展开态 侧栏列生效;列表 至少 2 个入口 时才出现折叠标题。56px 窄轨仍只显示图标列;仅 1 个入口时不增加额外 UI。
  4. 无障碍与文案:折叠标题在收起时显示数量徽标,带 aria-expanded / aria-controls;标签本地化(中文「面板」、英文 Panels)。
  5. 状态:折叠为瞬时视图状态,页面重载后恢复,与 shell 自身折叠行为一致。

安装与启用

仓库已提交 lib/,Git 安装无需额外构建依赖。将 web 换成你实际使用的 profile 名(例如 desktop):

npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Yazzyk/dsh-sidebar-fold

安装本地目录时:

npx -p @deepseek-ai/dsh dsh plugin --profile web add /path/to/dsh-sidebar-fold

完成后 重启对应 profile 的 DSH 进程,客户端才会加载 lib/client.js。

插件通过 cordis.patch.yml 插入一行(config 为空对象,无额外配置项):

- insert:
    - id: sidebar-fold
      name: dsh-sidebar-fold
      config: {}

典型用法

安装并重启后,无需改配置:当侧栏展开且面板类入口 不少于 2 个 时,列表上方会出现折叠标题。点击即可收起整块入口列表(收起时标题旁有数量徽标);再点一次展开。单入口或侧栏处于窄轨图标模式时不会出现该标题。

维护者在仓库中给出的本地校验命令(面向插件开发者自测,非终端用户必做步骤):

npm run build     # 从 src/ 重新生成 lib/
npm run verify    # 检查 exports、模块协议、patch、工厂约定
npm test          # 在最小 DOM stub 上跑行为测试

适用场景与注意

适合:经常在 DSH web 客户端挂多个带侧边栏面板的插件,希望列表可一键收起、给工作区 / 会话列表腾空间的开发者。

注意:

  • 插件在 当前 DSH 进程的客户端上下文 中运行;安装前建议浏览仓库源码与 LICENSE,确认符合你的环境与合规要求。
  • 折叠状态不持久化,刷新页面后回到默认展开逻辑。
  • 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护,与 DeepSeek / 幻方无官方从属关系;DSH 生态主张「一切皆插件」,目录站是独立聚合,不是官方应用商店。
  • package.json 声明 engines.node: >=22,开发与跑测试时需满足 Node 版本;peer 依赖 @deepseek-ai/cordis >=0.1.0。

结尾

dsh-sidebar-fold 用一行折叠标题缓解「插件面板列表过长挤占侧栏」的问题,实现方式轻量、不改变 host,也不动已有侧边栏组件。需要安装命令与细节时,可看目录页与仓库 README。

  • 目录页:https://www.skillhub.cn/plugins/Yazzyk/dsh-sidebar-fold
  • GitHub:https://github.com/Yazzyk/dsh-sidebar-fold
羽毛球分组比赛记分
小程序二维码

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

小夜