前言¶
DeepSeek Harness（DSH）的设置页左侧是分区导航，当插件或配置项变多时，顺序固定、隐藏/抽屉等操作都要在入口页里逐个调整，或者依赖宿主提供的默认顺序，没有持久化的整理能力。本插件给设置页导航加上「拖拽排序 · 显隐 · 抽屉收纳」，并把常用分区钉到主界面插件栏，一键直达。
插件定位¶
dsh-settings-nav-manager 是一个给 DSH 设置页左侧分区导航提供整理能力的插件，由 ZIye1208 维护，分类为客户端。它适用于 DSH 的 web 与 desktop 两个 profile，纯 JavaScript / ESM，无需构建。数据写入 DSH 设置命名空间 settings-nav-manager，随重启与语言切换保留。
核心功能¶
编辑模式¶
设置弹窗标题栏「打开配置文件」左侧新增齿轮。点击进入编辑模式，再点或 Escape 退出。齿轮常驻，编辑模式是临时态，不持久化。齿轮旁的「侧栏入口」开关只在编辑模式出现。每行右端此时多一颗星标（固定到侧栏），与眼睛并排。
拖拽排序¶
编辑模式下按住条目整行上下拖动即可排序，实时预览插入位置，松手定序并立即保存。位移阈值 > 6px 判定为拖拽，低于阈值按普通点击放行，不误触发导航跳转。拖拽被中断（窗口失焦、触屏手势被系统接管）会自动回滚。
显隐开关¶
点行右端的眼睛切换。隐藏条目在编辑模式内仍可见（置灰 + 划线眼），非编辑模式下 display:none。允许全部隐藏。若隐藏的正是当前浏览的分区，会自动切到第一个可见分区。
抽屉收纳¶
新建命名抽屉把条目收进去：拖入 / 拖出 / 组内排序，双击抽屉名改名（1–32 字符，可重名），点抽屉头任意位置折叠 / 展开，一键解散（成员回到未分组、保留顺序）。支持空抽屉。抽屉内条目左侧有 L 型归属线。
侧栏入口¶
主界面左侧插件栏新增一行「设置导航」，排在插件市场 / 自动化任务之后。点进去是一页全部分区清单，点任意一行直接打开设置并选中该分区；列表跟随你整理的顺序与抽屉分组，已隐藏的分区折在底部。
分区固定（1.3.0）¶
入口页每行右侧的 ☆ 一点变 ★，该分区就钉到主界面插件栏（最多 5 个，排在「设置导航」入口之后）。点那一行直接打开设置并选中该分区，而且当前主面板不会被切走。固定行若是被布局恢复、深链或键盘激活切过去，也有兜底页兜住。
即时说明¶
编辑模式下齿轮左侧浮出一张三行说明（拖拽/星标/眼睛、双击改名与新建抽屉、齿轮旁侧栏开关），8 秒后自动淡出，鼠标回到齿轮区可再看。浮层不参与标题栏排版、不吃点击。
安装与启用¶
从 npm 安装（推荐）：
网页版（dsh web）：
dsh plugin --profile web add dsh-settings-nav-manager
桌面版（Desktop 桌面应用）：
- 启动一次桌面应用（初始化 profile），然后完全退出；
- 执行安装：
dsh plugin --profile desktop add dsh-settings-nav-manager
- 重新打开桌面应用，进入设置使用。
安装后重启（网页版 dsh web / 桌面版重开应用），打开设置即可看到齿轮按钮。
从 GitHub 安装（tarball）：
# 网页版
dsh plugin --profile web add github:ZIye1208/dsh-settings-nav-manager
# 桌面版
dsh plugin --profile desktop add github:ZIye1208/dsh-settings-nav-manager
典型用法¶
- 打开设置，点击标题栏「打开配置文件」左侧的齿轮进入编辑模式。
- 排序：按住任意条目整行上下拖动，松手保存。也可聚焦某行后按
Alt+↑/↓。 - 隐藏：点条目右端的眼睛（或聚焦该行按
h）；隐藏后条目置灰、眼睛变划线眼，再点恢复。 - 固定：点条目最右端的星标（和眼睛并排）→ 变星，该分区立刻钉到主界面插件栏；再点取消。
- 抽屉：点底部「＋ 新建抽屉」创建并立即改名；拖条目到抽屉名入组，拖到抽屉外出组；点抽屉头任意位置折叠 / 展开；双击抽屉名改名，点 × 解散。
- 恢复默认：点底部「恢复默认」清空所有整理，回到宿主原始顺序。
- 按
Escape或再点齿轮退出编辑模式。所有改动即时持久化，重启保留。 - 钉到侧栏：主界面插件栏点「设置导航」进入入口页 → 点某行右侧的星标（变星）→ 侧栏插件栏立刻多一行，点它直接打开设置并选中该分区；再点星标取消。
- 收起入口行：编辑模式下齿轮旁「侧栏入口」开关可把「设置导航」那行藏起来；想找回就再进设置点一次。
适用场景与注意¶
适合需要频繁整理 DSH 设置页分区导航的用户。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。本插件不依赖构建，纯 JavaScript / ESM，适用于 DSH web 与 desktop profile。数据存放在 DSH 设置命名空间 settings-nav-manager，写入前过滤非法元素；读取异常一律回退默认值，不报错。
结尾¶
本插件通过拖拽排序、显隐、抽屉收纳与侧栏固定，让 DSH 设置页导航整理从手动逐个调整变为即时、持久、可复用的操作，适合需要频繁调整分区顺序与常用入口的开发者。
