dsh-settings-organizer

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 🧰 DSH Settings Organizer

**A low-intrusion Settings presentation layer for DeepSeek Harness (DSH): group, hide, search and restore your settings — without ever changing another plugin's configuration.**

[English](README.md) · [简体中文](README.zh-CN.md)

![npm version](https://img.shields.io/npm/v/dsh-settings-organizer) ![license](https://img.shields.io/npm/l/dsh-settings-organizer)

---

## ✨ Highlights

| Icon | Feature | In one line |
|:---:|---|---|
| 🗂️ | **Group by plugin** | Every plugin's settings render as one collapsible group |
| 🎚️ | **Collapse / expand** | Per-group, state **persisted** across restarts |
| 🙈 | **Hide anything** | Hide a single field or a whole plugin's settings |
| 🔍 | **Search** | Matches label / key / path / plugin name / description; ignores collapsed state |
| ↩️ | **Manage Hidden** | Restore one field, one plugin, or everything in one click |
| 🧹 | **Zero side effects** | Never edits other plugins; uninstall leaves no trace |

---

## 🚀 Quick start (30 seconds)

```
1️⃣ Install the plugin (one command — see below)
2️⃣ Restart DSH
3️⃣ Open Settings → "Settings Overview"
4️⃣ Collapse groups you don't care about → search → hide noise → done
```

---

## 📥 Installation

```bash
dsh plugin --profile web add dsh-settings-organizer@latest --config.auto-install-peers=false
```

> 💡 `--config.auto-install-peers=false` skips a few DSH core packages that aren't on the public registry — the DSH runtime provides them.

> 🐛 **`@latest` resolves an old version?** That's pnpm 11's `minimumReleaseAge` supply-chain policy (versions younger than ~30 days are excluded from resolution). Install an exact version once — it auto-whitelists, then `@latest` works:
>
> ```bash
> dsh plugin --profile web add dsh-settings-organizer@0.1.1 --config.auto-install-peers=false
> ```
>
> Or disable the age gate entirely by adding `minimumReleaseAge: 0` at the top of the profile's `pnpm-workspace.yaml` (PowerShell one-liner):
>
> ```powershell
> $f = "$env:USERPROFILE\.dsh\profiles\web\pnpm-workspace.yaml"
> $c = Get-Content $f -Raw
> if ($c -notmatch '(?m)^minimumReleaseAge:') {
>   Set-Content -LiteralPath $f -Value ("minimumReleaseAge: 0`n" + $c) -Encoding utf8
>   Write-Output "已添加 minimumReleaseAge: 0"
> } else {
>   Write-Output "已存在，无需修改"
> }
> ```

---

## 🧩 What it does

Registered as a **new, additive Settings section** ("Settings Overview") plus a header **"Manage Hidden"** action:

1. **Plugin groups** — each settings *namespace* (`ns`) from `settings.describe()` renders as one collapsible group.
2. **Collapse / expand** — per-group, with the collapsed state **persisted**.
3. **Hide a single setting** — removes one field from the overview (pure presentation).
4. **Hide a whole plugin** — hides every field of a namespace group.
5. **Search** — matches label / key / path / plugin name / description; search **ignores collapsed state**, and a hidden item that matches shows a **"Hidden · Restore"** hint — it is **never auto-unhidden**.
6. **Manage Hidden** — a header action opening a modal that restores a single hidden field, a whole hidden plugin, or everything.

---

## 🛡️ Safety guarantees

- **Hiding ≠ disabling ≠ deleting.** Hiding only edits *our own* persisted presentation lists — another plugin's config is never updated, replaced, or unregistered.
- **Removable with zero residue.** Everything this plugin registers lives on its own cordis fiber; disabling/removing it restores DSH stock settings pages exactly.
- **No DSH Core surgery.** No DOM monkey-patching, no fragile CSS selectors, no private-state manipulation — only the official `settings`, `settingsScope` and `slots` seams.
- **Robust to bad state.** Invalid persisted data is sanitized before it reaches the view — it can't crash or miswrite.

---

## 🔄 Compatibility

- DSH **web profile** with the settings domain (`dsh-client-ui-settings` / the `-general` shell), client runtime/slots and the locale plugin.
- Peer packages: `@deepseek-ai/dsh-client-*` `^0.1.0-rc.6`, `@deepseek-ai/cordis` `^4.0.1`, `react` `^18.2.0`.

---

## ❓ FAQ

**Q: Does hiding a setting change its value?**
No. Hiding only edits this plugin's own presentation lists; the setting's value and its owning plugin's config stay untouched.

**Q: Will uninstalling the plugin break my settings?**
No. Everything is registered on the plugin's own cordis fiber and disposed on removal — other plugins' pages return to DSH stock.

**Q: Is the collapsed state saved?**
Yes — persisted in the shared settings document (`~/.dsh/settings.yaml`) under this plugin's own namespace.

**Q: Can search unhide things?**
No. A hidden item is never auto-unhidden — you'll see a "Hidden · Restore" hint and restore deliberately.

**Q: Does it work if I have a lot of plugins?**
Yes — groups are lazy-rendered by namespace; collapse hides the noise, search finds anything instantly.

---

## 📋 Known limitation

Hiding applies to the **overview page only**: DSH has no per-field renderer inside other plugins' own Settings pages, so a field hidden here still appears on its owner's page. Hiding outside the overview would need an optional Core extension point (see docs).

---

## 👩‍💻 For developers

- [DEVELOPERS.md](DEVELOPERS.md) — build / typecheck / the tag-triggered auto-publish pipeline (npm via OIDC trusted publishing + GitHub Release with auto notes).
- Spec & architecture — `docs/dsh-settings-tidy.md`, `docs/phase-a/architecture.md`, `docs/phase-a/rfc-option-c-section-filter.md` (hard invariants, mounting & packaging, state model).

---

## 📄 License

MIT — see [LICENSE](LICENSE).