dsh-settings-sections

Readme

# dsh-settings-sections

在 DeepSeek Harness 设置面板里管理「侧栏板块」显示 / 隐藏 / 排序的轻量插件(纯客户端,localStorage 持久化)。

A lightweight pure-client plugin for DeepSeek Harness that lets you show, hide and reorder settings sections in the settings sidebar.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## 它能做什么 / What it does

设置页左侧导航的板块太多、顺序不合心意时,用它来整理。隐藏后随时可重新开启,不会删除任何设置内容。

- 在「设置」导航**顶部**新增一个「设置板块」管理页
- 每个板块一个开关,点击**立即**显示 / 隐藏对应板块
- **拖动左侧手柄可调整板块顺序**,顺序会同步到左侧导航
- 「全部显示」「恢复默认排序」一键恢复
- 隐藏状态与排序保存在 localStorage,重启后自动恢复

## 安装 / Install

### 方式一:手动安装(Manually)

1. 把本仓库(或 `dsh-settings-sections` 文件夹)放到 profile 的 node_modules:

   ```
   C:\Users\<用户名>\.dsh\profiles\<profile>\node_modules\dsh-settings-sections\
   ```

2. 在 profile 的 `cordis.patch.yml` 末尾加入:

   ```yaml
   - insert:
       - id: settings-sections
         name: 'dsh-settings-sections'
   ```

3. 完全退出 DSH 再打开,然后 `Ctrl+Shift+R` 刷新页面。

### 方式二:插件市场(Plugin market)

本仓库带有 `dsh-plugin` 标签,可在 DSH 的 Zat 插件市场搜索安装。

## 使用 / Usage

打开「设置」→ 顶部「设置板块」:

- 勾选 / 取消勾选各板块右侧的开关,显示 / 隐藏对应板块;
- 按住某一行左侧的「⠿」手柄上下拖动,调整板块在左侧导航里的顺序;
- 点「全部显示」或「恢复默认排序」一键恢复。

## 原理 / How it works

DSH 设置侧栏的每个板块都是插件通过 `settings.section` 这个 slot 注册的。本插件:

1. 向 `settings.section` 注册一个自己的管理页(放在最顶部);
2. 读取所有已注册板块,渲染成开关列表;
3. 切换开关时,通过 MutationObserver 把左侧导航里被隐藏板块对应的按钮隐藏(`display:none`);
4. 拖动排序时,按自定义顺序重排左侧导航按钮的 DOM 位置;
5. 隐藏列表与排序都写入 localStorage。

## 兼容性 / Compatibility

- DeepSeek Harness EAC(桌面客户端)
- 纯客户端,无宿主端逻辑

## License

MIT