# dsh-presets-hidden

[中文版 README](README.md)

A browser-side DeepSeek Harness plugin for controlling agent-preset visibility and ordering. It adds search, visibility filtering, per-preset toggles, and reordering under **Settings -> Preset Visibility**, and replaces the Agent preset selector on the new-session page with the filtered list.

> **Compatibility**: `0.2.x` requires deepseek-harness `0.1.7-rc.1` or later (`engines.dsh: >=0.1.7-rc.1`). Use plugin `0.1.x` with DSH `0.1.5` and earlier.
>
> From `0.2.1` the plugin also supports `0.1.7-rc.2`, which dropped the Host-side "mode selection for new tasks" policy field and gates preset selection on **Developer tools** alone. The plugin reads a missing policy field as "selection allowed", so it no longer reports the picker as off.
>
> From `0.2.2` the `peerDependencies` cover both the `0.1.7-rc.1` and `0.2.0-rc.1` lines, so DSH `0.2.0-rc.x` no longer classifies this plugin as incompatible (through `0.2.1` the peer range was `^0.1.7-rc.1`, which DSH's plugin compatibility gate rejected at install time and skipped at load time). The 0.2 line is verified through the real install gate, the build, and the full unit-test suite.
>
> From `0.2.3` the plugin follows upstream's Coding Tools semantics change (issue #2). Since DSH `0.2.1-alpha.1`, `developerTools.enabled` is no longer a master switch that hides the whole preset control: it is the Coding Tools switch, and turning it off withholds only the shipped PTC and Minimal presets. The plugin now applies the same rule — PTC and Minimal leave the picker and cannot be switched to, while the control itself stays visible. On older DSH (through `0.2.0-rc.2`), where the official control still hides entirely when the preference is off, this plugin keeps the control: an intentional divergence, documented under Behavior boundaries.

## Behavior boundaries

- Both built-in and custom presets can be hidden and reordered.
- On loopback pages, the visibility list and ordering are volatile fields of the plugin Config, saved to the active profile's `cordis.patch.yml` (entry id `preset-visibility`); edits apply live and are stored per profile. On non-loopback pages, the current browser’s `localStorage` is still used, with the key `dsh.presets-hidden.visibility.v1`.
- Legacy data migrates automatically, once, while the profile stores neither field: after DSH 0.1.7 renames `$DSH_HOME/settings.yaml` to `settings.yaml.imported`, the plugin imports its `preset-visibility` section into the active profile; legacy `localStorage` data migrates the first time a loopback page opens.
- Like the official chip (Coding Tools semantics): **with Coding Tools (formerly Developer tools) off, only the shipped PTC and Minimal presets are withheld** — they leave the new-session picker and cannot be switched to, while Standard, Creator, and custom presets stay selectable and the control itself stays visible. The settings page marks those two presets as needing Coding Tools. While a "mode selection for new tasks" policy the Host still publishes is off, the whole control is hidden and the Host default applies, as before; DSH `0.1.7-rc.2` and later publish no such policy field.
- Intentional divergence on older DSH: releases before `0.2.1-alpha.1` (including `0.2.0-rc.2`) treat Coding Tools as a master switch and hide the official control entirely; from `0.2.3` this plugin keeps the control and withholds only PTC and Minimal.
- Move-up and move-down operate on the full list; when search or visibility filtering is active, the reorder buttons are disabled to avoid ambiguous moves across invisible items.
- Newly created custom presets are appended to the end of the existing order; **Restore default order** reverts to the Host roster order.
- Only the new-session page preset selector is affected. The official **Agent Presets** management page, session titles, old-session recovery, direct API calls, and plugin diagnostics still use the full list.
- When the currently selected preset of an empty session is hidden, the plugin switches to the first visible preset via the official selection API.
- When all presets are hidden, the new-session page hides the preset control; the Host default preset still applies.

## Install

After publishing to npm, install via the DSH plugin mechanism:

```sh
dsh plugin --profile web add dsh-presets-hidden
```

## Development

Build and test:

```sh
pnpm install
pnpm run check
```

If you want to develop against a local deepseek-harness checkout, override the relevant `@deepseek-ai/*` dependencies to local paths via `.npmrc` or `pnpm.overrides` in `package.json` instead of the default registry versions.

## Install as a local bundle (Web profile)

Build first, then add the current directory as a local bundle:

```sh
pnpm run build
dsh plugin --profile web add /Users/baihaoran/Code/github.com/tkliuxing/dsh-presets-hidden
```

When using the CLI from the DSH source checkout, change the second command to:

```sh
pnpm dsh plugin --profile web add /Users/baihaoran/Code/github.com/tkliuxing/dsh-presets-hidden
```

## Release

- CI: `.github/workflows/ci.yml` runs `pnpm run check` on push/PR.
- Release: After creating a Release on GitHub, `.github/workflows/release.yml` automatically builds, tests, and publishes to npm with provenance. npm is configured to use **Trusted Publisher**, so no `NPM_TOKEN` secret is required on the GitHub side; the workflow only needs the `npm-publish` environment and `id-token: write` permission.

The package declares `dsh.bundle` and `dsh.client`. The Host entry exports a `Config` with volatile fields, which DSH's settings service serves as the `preset-visibility` form (the generated Plugins-page form is turned off; edit under **Settings → Preset display**).