前言¶
DeepSeek Harness（DSH）把能力拆成插件，每个插件面板在 Web 界面左侧栏各占一行，顺序由各插件自行声明，内核侧没有统一的入口管理；More 菜单里通常只有「浏览插件 / 创建插件」。装到十几个插件之后，这一列很难快速扫到目标入口。
下面介绍社区插件 dsh-plugin-sidebar-manager（维护者 1578361862-art），在左侧栏 More 里增加 Manage sidebar entries…，把几十行入口收成可按需隐藏、可调顺序、可放进命名文件夹的几行结构。配置写入 profile，重载页面后仍生效。
这是什么¶
dsh-plugin-sidebar-manager 是面向 DSH Web GUI 的侧栏入口管理器：不卸载插件即可隐藏不常用面板行，上下调整行序，并把多行收成侧栏里的文件夹行（点一下展开/收起，成员缩进排在下面）。Host 侧提供配置读写，客户端为手写 bundle，无独立构建步骤；当前版本 0.1.0，许可 MIT（© Yee）。
运行环境要求：Node ≥ 20，DSH ≥ 0.2.1-rc.5；插件声明 platform: web，只支持 Web 端，不涉及终端界面。
核心功能¶
管理对话框针对已注册的侧栏行（不是改插件安装状态）：
- 显隐 —— 取消勾选即可隐藏该行；对应面板、插件本体与后台任务不受影响。
- 排序 —— 用 ↑ ↓ 调整顺序，排序立即生效，无需重启。
- 分组 —— 新建命名分组、改名、整块上下移动或删除；侧栏里每个分组占一行文件夹，展开后成员缩进显示。
- 持久化 —— 变更写入当前 profile；关闭对话框时落盘（约 250ms 防抖，关窗会强制 flush）。
界面文案跟随 DSH 界面语言（中文 / English）。
安装与启用¶
先把 <profile> 换成实际 profile 名：DSH Desktop 一般为 desktop，dsh web 一般为 web。安装后需重启 DSH。
推荐从 Release 包安装：
dsh plugin --profile <profile> add https://github.com/1578361862-art/dsh-plugin-sidebar-manager/releases/latest/download/dsh-plugin-sidebar-manager.tgz
也可从仓库源码安装（需 pnpm 允许构建；本插件无构建步骤）：
dsh plugin --profile <profile> add github:1578361862-art/dsh-plugin-sidebar-manager
插件在当前 DSH 进程的权限下运行。安装前建议在 GitHub 上查看源码与 MIT 许可证，确认符合你的环境策略。
典型用法¶
- 左侧栏底部打开 More → Manage sidebar entries…。
- 每一行对应一个已注册面板：开关控制显隐，右侧 ↑ ↓ 调顺序，下拉框可把行放进分组。
- 对话框底部「新建分组」；分组按你排列的顺序变成侧栏里的文件夹行。
- 在侧栏点文件夹行可展开/收起；需要时可点「全部显示」恢复所有行。
卸载侧栏定制（配置仍留在磁盘）：
dsh plugin --profile <profile> remove dsh-plugin-sidebar-manager
卸载后侧栏恢复为「全部显示、按各插件声明顺序」。若要彻底删除配置，可手动删掉 $DSH_HOME/storages/sidebar-manager/ 目录。
配置与边界¶
配置文件路径：
$DSH_HOME/storages/sidebar-manager/config.json
JSON 带 version 字段，并包含 hidden、groups、sections、collapsed、placement、order 等项；经本机 loopback 的 PUT /sidebar-manager/config 写入。
使用前建议知晓的边界：
- 只影响侧栏行。隐藏不等于卸载；真卸载请在 Plugins 页操作。
Plugins行由内核写死：永远显示且为第一行，不进管理器。- 分组行为本插件注册的合成面板（
sm-group:<gid>），点整行是展开/收起，而非选中某个子面板。 - 排序依赖页面内改写注册项
order：插件重载会回到其自身声明顺序，因此每次启动会重放一遍已保存配置。
结尾¶
装多了 DSH 插件之后，侧栏入口管理往往比再加一个新插件更影响日常效率。dsh-plugin-sidebar-manager 用显隐、排序和文件夹分组把左侧栏收成可扫的几行，且不动插件本体与任务状态。
