前言¶
在 DeepSeek Harness 中安装插件后，设置侧边栏会随着插件数量的增加而变长，每个插件都会增加一个独立的导航条目。这导致面板显得杂乱，难以快速定位核心设置。dsh-settings-nav-organizer 旨在解决这一问题。它将第三方插件和扩展条目折叠到单个可折叠的组中，并提供书签式的自定义分组、快速搜索、可滚动导航以及 AI 自动分类功能，以保持设置面板的整洁。
核心功能¶
- 折叠插件条目：将所有插件和扩展条目折叠到一个名为
Plugin entries (N) ▾的组行中，官方系统设置（通用设置、模型、插件、Agent 预设）保持顶部平铺。 - 快速搜索：在导航栏顶部提供搜索框，输入关键词可实时过滤条目名称和插件 ID，匹配项会高亮并自动展开对应组。
- 可滚动导航：当条目过多时，侧边栏支持滚动，避免条目被裁剪且无滚动条。
- 折叠开关：在“分组管理”页面提供开关，可一键开启或关闭折叠功能。
- 书签式自定义组：支持创建命名组，像书签文件夹一样管理条目，并在导航中独立展开或折叠。
- 持久化配置：分组配置和折叠开关状态保存在
localStorage中，重启后保留。 - 自动更新：根据
settings.sectionledger 实时重算条目数量和折叠位置，插件注册/注销设置页面时会自动反映在导航中。 - 当前部分保持可见：即使处于折叠状态，当前激活的页面条目也会保持可见。
- AI 自动分类：支持开启 AI 自动分类模式，插件可根据市场分类、本地规则或 AI 模型自动归类。
- 简化的 AI 模型配置：提供预设模型下拉框（DeepSeek、OpenAI、Qwen 等），自动填充 API URL，支持测试配置并自动保存。
- 空闲插件自动修剪：扫描插件工具调用历史，标记超过空闲阈值（默认 30 天）的插件，支持一键清理。
- 本地化支持：跟随 UI 语言（中文/英文）显示。
安装与启用¶
通过命令行安装插件：
dsh plugin --profile web add dsh-settings-nav-organizer
安装完成后，重启 dsh 进程，并刷新浏览器页面以加载插件。在设置面板中找到“分组管理”页面，开启“折叠第三方插件入口”开关即可生效。
基础用法¶
- 折叠管理：打开设置面板，进入“分组管理”页面。开启顶部的“折叠第三方插件入口”开关。此时，所有插件条目会折叠到
Plugin entries (N) ▾行下，系统核心设置保持顶部平铺。 - 手动展开/折叠：点击导航栏中的组行（如
Plugin entries或自定义组），即可展开或折叠其下的条目。 - 创建分组：在“分组管理”页面，输入组名称并点击“新建组”。
- 移动条目：在“未分组”区域，通过下拉菜单选择目标分组，将条目移动进去。点击组名右上角的“重命名”或“删除”可管理分组（删除分组会将条目移回未分组区）。
高级配置¶
- AI 自动分类：
在“分组管理”页面开启“自动分类”开关。点击配置区域，从预设模型下拉框选择模型（如 DeepSeek），输入 API Key 和 URL。点击“测试配置”验证连接，随后点击“分类未分组插件”。系统会依次使用市场分类标签、本地启发式规则和 AI 模型对插件进行归类。 - 空闲插件修剪：
在“分组管理”页面开启“空闲插件自动修剪”开关。插件会扫描各插件的工具调用历史。默认阈值为 30 天，可在此处查看被标记为空闲的插件列表。确认无误后点击清理按钮即可移除。
注意事项¶
- 重启与刷新：安装或卸载插件后，必须重启
dsh并刷新浏览器页面才能生效。 - 配置存储：所有分组配置和折叠状态均存储在
localStorage的dsh.settingsNavFold.v1键下。 - 依赖关系：该插件依赖
settings.section ledger。 - 受保护组件：核心 DSH、本插件自身以及核心 UI 包受保护，不会被折叠或列出。
该插件由 zhengjy01 维护，开源协议为 MIT，源码位于 GitHub。
