dsh-enhanced-plugins

中文 | English

An enhancement suite for DeepSeek Harness (DSH): six independently installable Cordis bundles plus one Windows companion.

• Does not modify DSH core; every Web feature uses public plugin extension points.
• Installs everything in one pass or keeps only the independently packaged features you select.
• Keeps Host, Web Client, and Windows Companion lifecycles and security boundaries separate.

Features · Quick start · Feature guide · Compatibility and migration · Configuration · Development

Features

The installer only needs the stable “feature ID.” Every feature also has a self-contained selective package.

The aggregate package is dsh-enhanced-plugins. With no feature selection, the installer composes all seven entries above; with a selection, it installs only the matching packages or companion.

Quick start

Requirements

• Node.js 22.19.x, or Node.js 24 and later.
• A recent DSH Web profile that runs from source; see the DSH Web UI quickstart.
• This repository is verified against DSH 0.1.1-rc.2, with local ABI baseline commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e.
• Windows Launcher, native sounds, and the desktop pet require Windows 10 or later and Windows PowerShell 5.1. The remaining features are cross-platform.

[!IMPORTANT]
DSH remains a developer preview. If a DSH upgrade causes compatibility issues, check the verified version and commit above first.

[!CAUTION]
Check the DSH/plugin repository layout before copying an install command:

• Sibling-directory install: both repositories share the same parent directory; use the commands below as written.
• Different-directory install: the repositories have different parent directories; add -DshCheckout "absolute path to the DSH source" to the command.

Install every feature

When both repositories share a parent directory, run this from the root of this repository:

<workspace>/
├── deepseek-harness/
└── dsh-enhanced-plugins/

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1

Omitting -Features, or passing -Features all, installs the six Cordis enhancements and Windows Launcher. The launcher is deployed to %LOCALAPPDATA%\DeepSeekHarness\Launcher and creates a Start menu shortcut. Add -CreateLauncherDesktopShortcut if you also want a desktop shortcut.

If the DSH checkout is not a sibling, provide its location explicitly:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
  -DshCheckout "E:\projects\deepseek-harness"

Install selected features

List the stable feature IDs exposed by this version:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 -ListFeatures

Then pass the final set you want to keep. For example, install desktop alerts, MCP management, and message editing only:

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\migrate-to-enhanced-plugin.ps1 `
  -Features notification,mcp-server-manager,edit-last-message

Common combinations can replace the -Features value in that command:

-Features is not an additive list. It describes the final enhanced feature set that the target profile and machine should retain. The installer:

1. Installs dependencies and builds every selected feature.
2. Installs and verifies that every selected bundle or companion loads.
3. Only then removes the aggregate package, unselected sibling features, and declared legacy conflicts.
4. Detects and cleans up the retired file-reference plugin.

If a prerequisite step fails, the installer does not dismantle the previously working combination. Restart the current Web profile once after a successful install if DSH is already running.

Feature guide

1. Windows Launcher

windows-launcher · Start → DeepSeek Harness Launcher · Windows 10+

A Windows control center outside the Cordis plugin tree for local DSH users who do not want to keep a terminal open.

• Web control: inspect status, start, open, restart, or stop Web; identify services already bound to the port without taking ownership of them.
• Tasks and profiles: run one-shot Headless tasks and background profiles with unified UTF-8 results and logs.
• Source maintenance: run git pull --ff-only against the bound DSH checkout and only run pnpm run build after a successful update; explicitly allow build-only operation when Git is unavailable.
• Diagnostics: collect command, port, working directory, status, and log information, with a dedicated DSH Source page.
• Desktop behavior: system tray, optional login startup, wide split layouts, compact layouts, per-monitor DPI scaling, and multi-monitor bounds protection.

2. Desktop alerts and pet

notification · Settings → Desktop Pet · Sounds and pet require Windows 10+

• Confirmation, completion, and blocked events can each be disabled or mapped to two built-in sounds or a custom WAV.
• Changing a sound previews it automatically, with a manual preview button as well. Shared gain ranges from 0–100%; 100% is approximately +6 dB, with soft limiting for near-peak PCM / IEEE Float WAV files.
• Each file is limited to 2 MiB and the shared library to 64 files, all stored in the current DSH profile.
• The pet switches live between the Flat Whale, 3D Whale, and Whale Girl characters.

The pet can be dragged across monitors and stores normalized per-monitor positions. Resolution, scale, work-area, or display-topology changes remap it into a visible area; changing the startup corner clears the drag record. Windows “Show animations” accessibility preferences reduce every state to a representative still frame when animations are disabled.

Both the resident pet and short-lived sound processes are owned by the DSH subprocess service and exit cooperatively when disabled. A known retired pet ID is migrated to Flat Whale on the next launch; other unknown values continue to fail validation.

3. Plugin Community

plugin-market · Settings → Plugin Community

1. The first visit uses a bundled snapshot. “Sync latest index” uses ETags to fetch a schema-validated snapshot published by GitHub Actions every six hours, retrying temporary 429/502/503/504 responses.
2. Search by repository, package, description, or topic. A live preflight checks repository identity, commit, and distribution shape before installation.
3. One-click install is offered only for matching npm bundles with no install lifecycle scripts. Verifiable build-free source bundles can be installed at a pinned commit after confirmation; every other path links to its installation guide.
4. Install and uninstall run as cancellable background jobs. The target profile, bundle patch, and composition are verified afterward, with automatic rollback on failure.
5. The Installed tab separates market-managed plugins from externally managed ones. Only the former can be removed from this page.

4. MCP server manager

mcp-server-manager · Settings → Plugins → Plugin configuration → MCP Servers

1. Add a unique name and choose stdio or Streamable HTTP.
2. Configure command, arguments, working directory, and environment for stdio; configure an HTTP(S) URL and headers for HTTP.
3. The Host can import local Claude Code and Codex configurations in one pass. Duplicates are skipped and unsafe conversions report a reason.
4. Review the format audit at the top of the card and save. The Host starts, updates, or unloads each connection independently.

Environment and header values are masked when existing servers reach the browser. Unchanged secrets are not reconstructed from, or overwritten by, redacted snapshots.

5. pi-ai model request types

model-input-types · Settings → Plugins → Plugin configuration → pi-ai model request types

Add pi-ai model overrides on the DSH Models page or in settings.yaml, then choose Provider default, Text only, or Text and images for each model. Changes save immediately.

The card appears only when the official llm-pi-ai settings namespace is available. It stores a capability declaration and does not probe the endpoint; verify that the provider truly accepts images before declaring Text and images.

6. Edit last message

edit-last-message · Latest editable user-message bubble in the current session

1. Wait for the current session to finish, or stop it first.
2. Select Edit last message and change the text inline.
3. Select Resend or press Ctrl/⌘ + Enter; press Esc or Cancel to leave edit mode.

Resend stays inside the current session: the plugin replaces model context starting at the edited user message, then generates through the same AgentLoop. The DSH Session log remains an append-only audit record, and side effects from tools that already ran are not rolled back. Messages containing images or other non-text blocks do not expose the editor, preventing silent data loss.

7. Product subagents

sub-agent · Settings → Subagents

Enabling Claude Code or Codex applies immediately to every Agent preset carrying this controller, including running sessions. Disabling a toggle removes the matching tool in real time. The corresponding product and its official DSH provider must still be installed locally.

Both toggles default to off. Writes use path-addressed operations and settings revisions, so a redacted or stale snapshot cannot overwrite changes from another page or an external editor.

Compatibility and migration

• Verified baseline: DSH 0.1.1-rc.2, commit b150a551b8d465e31e418e1b2eaf5e79bbb7d28e.
• Architecture boundary: Web features extend public Services, events, slots, and settings. Windows Launcher is an independent companion and never joins the Cordis plugin tree.
• File reference retired: current DSH provides native @ file references. Type @ in the composer, or @" for paths containing spaces. The old referenced-file feature ID and # snapshot syntax are no longer provided.
• Automatic cleanup: -Features referenced-file is rejected explicitly. A normal installer run removes the historical selective package or the feature carried by an older aggregate install.

Configuration

The default composition lives in cordis.patch.yml. A later profile patch replaces the target Loader row's entire config, so an override must restate every field that row still needs.

To expose product-subagent tools to selected Agent presets only, disable or remove the root subagent-product-toggle-tools row and mount the appropriate entry inside each target preset:

• Aggregate package: dsh-enhanced-plugins/sub-agent/preset
• Selective package: dsh-enhanced-sub-agent/preset

Do not mount both layouts in the same scope.

Development and verification

This repository uses the following read-only sibling checkout as its DSH API, type, and assembled Web UI baseline:

D:\work\workspace\github\deepseek-harness

Regular verification commands:

npm install
npm run typecheck
npm test
npm run build
npm run pack:dry-run
git diff --check

Browser bundles use CSS Modules and consume only DSH --dsw-alias-* semantic theme tokens, so they follow light, dark, and system appearance automatically. See the DSH plugin development guide and architecture reference for public extension points.

License

MIT