前言¶
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。
典型用法¶
- 点侧边栏 更多。
- 在 已收进「更多」 分组中,点 显示到侧边栏 把项放回主导航。
- 在 留在侧边栏 分组中,点 收进『更多』 挪走不常用项。
- 在 底部工具区 分组中,同样双向切换底部小按钮。
- 分组标题旁 全部恢复 可一次清空收纳状态。
点「插件」会提示「该面板不能收起」。全部恢复后「更多」仍在,菜单可能显示「还没有收起来的按钮」,侧边栏视觉与未收纳时一致。
若需手工编辑配置,在 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 为准: