dsh-sidebar-overflow: Collapse DSH left sidebar into "More" with item-by-item customization.

前言

DeepSeek Harness(DSH)左侧边栏会堆上插件、插件市场、自动化任务、灵枢、上下文洞察、WSL 等入口。装得多了,主导航就挤在一起,真正常用的往往只有几项。官方侧边栏本身不提供「只显示常用、其余折叠」的粒度控制;若靠改主题或手工改 DOM,既难维护,升级客户端后也容易失效。

下面介绍社区插件 dsh-sidebar-overflow(维护者 cxv117793-blip):它不新增主导航按钮的业务逻辑、也不替换官方侧边栏组件,而是在官方扩展槽位上注册「更多」,由你在菜单里逐项决定哪些入口留在侧边栏、哪些收进「更多」。当前 Release 为 v0.1.0,许可证 MIT。

这是什么

dsh-sidebar-overflow 是 DSH 客户端类插件:在主导航列表末尾出现官方 shell 渲染的「更多」入口,点开可看到当前全部侧边栏项(含底部工具区),每一项都能单独切换「收进『更多』/ 显示到侧边栏」。收进去的入口并未删除,仍可从「更多」打开;选择写入 profile 的 cordis.patch.yml,完全退出应用再启动后仍会恢复。

插件目录页:https://www.skillhub.cn/plugins/cxv117793-blip/dsh-sidebar-overflow
源码与说明:https://github.com/cxv117793-blip/dsh-sidebar-overflow

核心功能

资料中明确列出的能力如下。

能力 说明
逐个选择 菜单列出全部入口,每行可切换收进「更多」或显示到侧边栏
搜索过滤 菜单顶部搜索框按名称筛选;无匹配时有明确空态
一键还原 「全部恢复」清空 panel: 与 footer: 两类键,全部放回
失效条目清理 插件卸载后配置可能残留 panel:<已删除的 id>,菜单会提示,可用「全部恢复」清理
底部工具区 侧边栏底部小按钮(用量、余额等)也可隐藏
即时生效 点击后立刻变化,无需刷新页面
重启保留 写入 cordis.patch.yml,DSH 重启后回放
中英双语 跟随 DSH 语言设置

使用上的固定规则(README 写明):「插件」入口不能收起(插件管理器入口);「更多」按钮在插件启用后常驻列表末尾;本版不做拖拽排序;菜单不记忆滚动位置。

安装与启用

插件以当前 DSH 进程权限在客户端运行,安装前建议通读仓库源码并确认 MIT 许可证。README 说明:仅写一个配置字段 config.hidden,不写会话数据、不联网、不上报。

桌面版 不要 用 dsh plugin --profile desktop ... 改 profile——该 profile 由 Electron 应用内插件管理器独占,命令行会拒绝(profile "desktop" is managed exclusively by the Electron application)。

任选一种安装方式:

1、从本地目录(开发/自用)

在 DSH 内:设置 → 插件 → 添加插件 → 从本地目录,选中仓库根目录。

2、从 GitHub 仓库

在同一安装框粘贴:

https://github.com/cxv117793-blip/dsh-sidebar-overflow

3、从 Release 的 .tgz

永远指向最新版(文件名固定):

https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/latest/download/dsh-sidebar-overflow.tgz

锁定 v0.1.0:

https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/download/v0.1.0/dsh-sidebar-overflow-0.1.0.tgz

也可先下载再装:

curl -L -o dsh-sidebar-overflow.tgz \
  https://github.com/cxv117793-blip/dsh-sidebar-overflow/releases/latest/download/dsh-sidebar-overflow.tgz

非 desktop 的 profile 才可用命令行(路径换成本地仓库绝对路径):

dsh plugin --profile <你的profile> add file:<本仓库绝对路径>

装完之后必须 完全退出应用(文件 → 退出,或托盘右键退出)再启动。仅刷新页面不够——客户端模块只在应用启动时装配一次;否则界面可能看不到「更多」。装好后主导航末尾应出现「更多」(宽侧边栏带文字,窄侧边栏为图标)。

开发与实测环境为 DSH 0.2.1-rc.3(CLI 0.2.0-rc.2)。插件依赖 slots、locale、configForms 等服务面,未在 README 中声明更老版本的验证结果。Node 要求见 package.json:^22.19.0 || >=24.0.0。

典型用法

  1. 点侧边栏 更多。
  2. 在 已收进「更多」 分组中,点 显示到侧边栏 把项放回主导航。
  3. 在 留在侧边栏 分组中,点 收进『更多』 挪走不常用项。
  4. 在 底部工具区 分组中,同样双向切换底部小按钮。
  5. 分组标题旁 全部恢复 可一次清空收纳状态。

点「插件」会提示「该面板不能收起」。全部恢复后「更多」仍在,菜单可能显示「还没有收起来的按钮」,侧边栏视觉与未收纳时一致。

若需手工编辑配置,在 profile 的 cordis.patch.yml 中示例形如:

- id: dsh-sidebar-overflow
  name: dsh-sidebar-overflow
  config:
    hidden:
      - panel:dsh-wsl
      - panel:dsh-market
      - footer:0

键名规则:panel: 后接 sidebar.panellist 里的面板 id;footer: 为底部工具区按渲染顺序从 0 起的序号(记位置而非 id)。改完后同样需要完全退出再启动;重置可删除整个 hidden 段。

工作原理(简要)

全部走官方扩展点,README 概括为:向 sidebar.panellist.actions 槽位注册一条,官方据此渲染「更多」;通过 sidebar 插件下发的 setPinned 与自身 Config.hidden 控制主列表显示并持久化;底部工具区无官方 pin 机制,按 DOM 顺序做 best-effort 隐藏。停用或卸载时会还原 pin 状态并清理相关 DOM 标记。

适用场景与注意

适合谁: 已安装多个 DSH 插件或常用功能较多、希望主导航只留少数入口、其余从「更多」进入的用户。

已知限制(资料原文):

  • 底部工具区按顺序记忆,装卸插件后序号可能变化,表现为隐藏错位;可在菜单里重新点选修正。
  • 换主题后底部隐藏可能失效。
  • 无拖拽排序;菜单每次从顶部打开。

安全与权限: 插件在 DSH 客户端进程内执行;安装前请自行审查 GitHub 仓库 源码。社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态强调「一切皆插件」,本文介绍的是社区维护的客户端插件,非官方内置功能。

装完看不到「更多」时:确认已完全退出重启、且在 设置 → 插件 中已启用。若刷新页面后收纳状态丢失,检查 cordis.patch.yml 是否含有 dsh-sidebar-overflow 的 config.hidden。

结尾

dsh-sidebar-overflow 用官方「更多」槽位和配置持久化,把「侧边栏拥挤」变成可逐项管理的收纳列表,且不改变被收入口的实际能力。需要安装包或 Issue 时,以 GitHub 为准:

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

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

Xiaoye