# dsh Plugin Nickname

Custom Chinese nicknames for DeepSeek Harness (dsh) plugins, displayed directly in the native plugin settings page. Supports grouping (by nickname / by tag), collapsible groups, official-plugin protection, and custom tags.

## Features

- Automatically replace English package names in the plugin list with custom Chinese nicknames; hover to see the original English name
- Visual edit panel: click the "📝 Nickname" button in the bottom left, or press `Ctrl+Shift+N`
- Automatically scan all installed plugins for direct editing; nicknames are saved in browser localStorage and persist
- 🛡 Official plugins are protected by default: `@deepseek-ai/*` and dsh's built-in bundles are marked "官方" with a disabled input; an "改官方" (allow official) toggle in Advanced lifts the restriction
- 🗂 Grouping: group by whether a nickname is set, or by tag; group headers collapse/expand and remember their state
- 🏷 Custom tags: create and apply a tag inline via "+ 标签"; toggle or delete tags; fixed categories "官方 / 已修改 / 未修改" are applied automatically
- 🔍 Search box, sort by original/nickname name, export/import, draggable button, master switch, one-click reset

## Installation

### Method 1: Install from GitHub (Recommended)

Desktop (DSH 0.2.0-rc.2): Open "Plugins → Add Plugin" in the sidebar, paste the address below, and select "Enable Now" after installation. If prompted to restart, follow the instructions.

```
github:sanlisanxun/dsh-plugin-nickname
```

### Method 2: Local Directory Installation

1. Download this project and extract it to a local folder
2. Open dsh → Plugins → Add Plugin
3. Enter the full path to the local folder and click install
4. Refresh the page to take effect

## Usage

After installation:
- Click the "📝 Nickname" button in the bottom left, or press `Ctrl+Shift+N` to open the edit panel
- Edit Chinese names directly in the input box, press Tab to save
- Leave blank to restore the original English package name

## Directory Structure

```
dsh-plugin-nickname/
├── lib/
│   ├── index.js      # Host-side plugin entry
│   └── client.js     # Client-side script (injected into the browser page)
├── cordis.patch.yml  # Cordis mount patch
├── package.json      # Package configuration
├── README.md         # Project documentation
└── LICENSE           # Open source license
```

## Changelog

Full changelog: [CHANGELOG.md](CHANGELOG.md).

### v0.3.2
- 🏷 Added tag grouping: a new "by tag" grouping option (alongside "by nickname"); fixed categories "官方 / 已修改 / 未修改" are applied automatically; users can create custom tags and apply them inline, and manage/delete them in Advanced

### v0.3.1
- 🗂 Collapsible groups: when grouping is on, click a group header to expand/collapse; the state persists, with a `▾` / `▸` indicator

### v0.3.0
- 🛡 Official plugins can no longer be renamed by default: `@deepseek-ai/*` and dsh's built-in bundles are skipped, marked “官方” and disabled in the panel
- ✨ New “改官方” (allow official) toggle to lift the restriction when you need it
- ✨ Saving a nickname for an official plugin is blocked even if the UI is bypassed

### v0.2.9
- 🐛 Fixed nicknames not applying in a real browser: the guard counted `childNodes.length <= 2`, so whitespace text nodes from line breaks pushed it to 3 and blocked the replacement; it now counts element children only
- 🐛 Fixed the plugin rewriting its own panel: the package-name labels inside the edit panel were being replaced with the nicknames; nodes inside `[data-nickname-ui]` are now skipped
- ✅ Added real-browser verification: `npm run test:browser` (Chromium loads `tests/harness/index.html`, 7 assertions)

### v0.2.8
- 🐛 Fixed nicknames not applying at all: dsh renders the plugin name inside `<button class="cardTitle">` wrapped in two more `div`s, so the leaf-only rewrite found no direct text node and skipped everything. It now walks down to the node that actually holds the text
- 🐛 Fixed the title button being wiped out: the old `textContent` overwrite also cleared the `<button>`, icon and description
- ✨ Supports dsh's `Display Name (package)` title form, e.g. `上下文 (dsh-context)`
- ✨ `button` added to the default scan selector
- ⚡ The panel list now derives installed packages from dsh's `data-plugin-package` attribute instead of guessing from text

### v0.2.7
- ✨ Works without `__ModuleLoader__` (dsh web): self-boots when no module loader is present
- ✨ Storage falls back to memory when localStorage is unavailable (private mode / web)
- ⚡ Removed the fixed 1 s delay: initializes immediately, then retries for up to ~2 s
- ✨ Advanced settings in the panel: scan selector and package-name regex are configurable
- 🐛 dispose now sweeps UI by session tag at 0 / 200 / 600 ms, removing late-rendered leftovers
- ✨ Shows a "click to reload" hint when no plugin list is detected; panel has a reload button

### v0.2.6
- 🐛 Fixed nickname replacement wiping child elements: only direct text nodes are rewritten now
- 🐛 Fixed package-name prefix collision (`dsh.plugin` vs `dsh.plugin-manager`): longest name wins
- 🐛 Fixed panel markup being broken by quotes/angle brackets in nicknames: HTML-escaped before render
- 🐛 Fixed the panel being closed after reset/import: corrected the open/close semantics
- 🐛 Fixed `<style>` tags accumulating in `<head>` when toggling the panel repeatedly
- 🐛 Hardened dispose: clears the MutationObserver debounce timer and global handles
- 🐛 Fixed the export URL being revoked too early, which could abort the download
- ⚡ Optimized MutationObserver: debounce timer moved into the closure; self-triggered records discarded

### v0.2.5
- 🐛 Fixed undeclared variable (`style` → `styleEl`) when injecting panel styles: no more `ReferenceError` in strict mode, the panel opens correctly
- 🐛 Fixed the injected `<style>` tag not being removable on dispose

### v0.2.4
- ✨ Added uninstall button: clears all local data and prompts you to finish uninstalling in the dsh plugin list

### v0.2.3
- 🐛 Fixed leftover UI after disabling the plugin; improved dispose cleanup

### v0.2.2
- ✨ Added sorting by original name / nickname
- ✨ Added grouping by whether a nickname is set
- 🎨 Improved UI for the dark theme

### v0.2.1
- 🎨 Refined UI styles to better match the dsh dark theme
- Added hover effect and animation to the floating button

### v0.2.0
- ✨ Added master switch for enabling/disabling nickname replacement
- ✨ Added reset button to clear all custom nicknames
- ✨ Added draggable floating button with auto-saved position

### v0.1.1
- ✨ Added search box: quickly find plugins when there are many
- ✨ Added export/import: backup your nickname settings
- ✨ Improved interaction: click outside the panel to auto-close

### v0.1.0
- 🎉 First release
- Support custom plugin Chinese nicknames
- Support visual edit panel
- Support shortcut Ctrl+Shift+N to open panel

## Disclaimer

1. This software is for personal learning, research, and technical exchange only, and may not be used for any illegal or commercial purposes.
2. When using this software, please comply with the laws and regulations of your region, and do not use this software to engage in any illegal activities.
3. Any direct or indirect consequences arising from the use of this software shall be borne by the user, and the author shall not be liable.
4. This software is provided "as is" without any express or implied warranty.

## License

MIT License