前言¶
DeepSeek Harness（DSH）侧边栏会列出插件、插件市场、自动化任务、任务看板、上下文洞察等一串面板入口。入口一多，列表变长，常用项和偶尔才点的项混在一起，找起来费眼。社区里已有把整段折叠到「更多」下面的做法；本插件换了一种模型：两行常驻、其余收进可折叠的「工具」组，并支持在两组之间拖动调整。下面介绍插件 dsh-sidebar-groups 的定位、能力与安装方式。
这是什么¶
dsh-sidebar-groups 是维护者 yangdinghui 发布的 客户端插件（分类：客户端）。它只改 Web 壳里的侧边栏展示与顺序，不改 DSH 源码、不 patch app.asar；卸载后侧边栏恢复出厂布局。
npm 包名：dsh-sidebar-groups（当前资料中版本 0.1.1）。GitHub 仓库：yangdinghui/dsh-sidebar-groups；社区目录页：skillhub.cn 插件页。
核心功能¶
默认把面板分成两组（资料中的示意）：
插件 ← 常驻
自动化任务 ← 常驻
工具 5 ⌄ ← 点一下收起/展开
插件市场 ┐
任务看板 │ 展开后缩进显示
上下文洞察 │
灵枢 │
记忆系统 ┘
更多
具体能力（均来自 README）：
- 常驻与折叠：默认两行常驻为「插件」「自动化任务」；其余入口收在可折叠的「工具」行下。点「工具」展开或收起，箭头随状态变化；收起时右侧显示组内数量。
- 拖动：把常驻行拖到「工具」行上 → 归入工具组；展开后把工具组某行拖到上方常驻行 → 固定到该位置；常驻区内部可调整顺序。
- 右键菜单：任意行右键也可完成与拖动相同的移动（拖动不可用时的退路）。
- 持久化：布局写在
localStorage，键名为dsh.sidebar-groups.v1；刷新或重启桌面版后保留。 - 窄侧边栏：侧边栏收成 56px 图标轨时，「工具」行自动隐藏，图标轨行为不变。
- React 重渲染：侧边栏由 React 重绘后会自行补回分组，无需整页刷新。
实现上插件不搬运 React 节点，只给真实行写 style.order 与 data-dsh-fold-zone，并追加自己的「工具」按钮；选择器落空时安静退出，避免拖垮 Web 壳启动。
面向 DSH 0.2.x（提供 panelList / panelRow 的版本），Web 与桌面版通用。面板名依赖 aria-label；切换界面语言后，已记住的常驻列表可能对不上，会退回默认（插件 + 自动化任务），重新拖一次即可。
与同类的 dsh-sidebar-fold 相比：后者把插件行整体折到官方「更多」下，靠设置卡片配置；本插件强调 分组 + 拖动，不必进设置页。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证。插件在 当前 DSH 进程权限 下运行，与任何客户端注入类扩展一样，只安装你信任的来源。
npm（推荐）¶
将 <profile> 换成你使用的 DSH profile：
dsh plugin --profile <profile> add dsh-sidebar-groups
从 GitHub 安装（未发 npm 时）¶
dsh plugin --profile <profile> add git+https://github.com/yangdinghui/dsh-sidebar-groups.git
仓库内 lib/client.js 为预构建 bundle，从 Git 安装 不需要 本地构建。
桌面版 / 插件页¶
路径：侧边栏 →「插件」→「添加插件」，填写包名 dsh-sidebar-groups，或本目录 / 打包 tgz 的绝对路径。启用后若侧边栏无变化，重启一次 DeepSeek Harness 桌面版（客户端模块在启动时组装）。
桌面版的 desktop profile 由 Electron 应用独占管理，dsh plugin 会拒绝直接写入，请走插件页。
本地 tgz¶
npm pack # 例如 dsh-sidebar-groups-0.1.0.tgz
dsh plugin --profile <profile> add ./dsh-sidebar-groups-0.1.0.tgz
（README 示例 tgz 文件名为 0.1.0；npm 上 package.json 已为 0.1.1，以你实际 pack 出的文件名为准。）
典型用法¶
- 安装并启用后，观察侧边栏是否出现「工具」行及默认分组。
- 把不常用的常驻项拖到「工具」上，收进折叠组；展开「工具」，把常用项拖回上方常驻区。
- 在常驻区内拖动调整两行（或多行）顺序。
- 若拖动不便，对目标行右键，用菜单完成归组或固定。
卸载：在插件页停用或删除即可；插件会还原插入的行、样式与 order，不留脏 DOM。
适用场景与注意¶
适合：长期在 DSH 里切换多个侧边栏面板、希望固定少数入口、其余收起来的人；不想改 DSH 本体、只想用官方插件机制扩展 UI 的开发者。
注意：
- 依赖侧边栏 DOM（
nav.panelList、button.panelRow等）。DSH 大版本改版后，最坏情况是「工具」行不出现，其余不受影响。 - 资料未写死
engines.dsh；老版本上选择器落空时插件无操作，不会拦安装。 - 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；插件生态遵循 DSH「一切皆插件」的思路，本文事实以 GitHub README 与 package.json 为准。
结尾¶
dsh-sidebar-groups 用分组、折叠和拖动整理侧边栏面板，状态本地持久化，纯客户端、可逆卸载。需要细节、Issue 或自测说明时，见 GitHub 仓库 README 与 SkillHub 目录页。
