@stijnus/dsh-prompt-optimizer
A DeepSeek Harness plugin that
optimizes the prompt you are about to send.
It adds a ✨ Optimize prompt control next to the composer send button.
Clicking it rewrites the current draft into a structured prompt and streams the
result into a panel above the composer, with Use, Undo, Copy, and
Close. Nothing is sent to the agent; the draft is only replaced when you
click Use.
It runs on the model the session is already routed to (the same route the next
turn would use), and it never writes to the Session log.
Prompt style
The rewritten prompt can take three shapes, chosen in Settings → General →
Prompt style:
| Style | Output |
|---|
plain (default) | One continuous, heading-free prompt. |
sections | ## Role / ## Task / ## Context / ## Format headings. |
role-task-goal | Role: / Task: / Goal: labeled lines. |
The row stores a per-browser override. A profile can set the default for
everyone through the plugin's Config:
- id: prompt-optimizer
name: '@stijnus/dsh-prompt-optimizer'
config:
outputStyle: sections
Until the row is changed, it shows that profile default; an override in the row
wins for requests from that browser. The result panel names the style that
produced it.
Naming: this package is scoped because the unscoped name
dsh-prompt-optimizer already belongs to a different author on npm. This
plugin is unrelated to that package; both optimize composer prompts, but this
one reuses oss-prompt-optimizer
as its rewrite engine.
Install
dsh plugin --profile web add @stijnus/dsh-prompt-optimizer
Then restart the Harness (or refresh the page for the Client half). The plugin
appears in Settings → Plugins as Prompt Optimizer.
Compatibility: DSH >=0.2.1-rc.3 <0.3.0-0, Node >=20.
Market
The plugin is listed in the Stijnus market index that the desktop profile already
reads, so it appears in Settings → Plugin Market next to Composer Predictions:
https://raw.githubusercontent.com/Stijnus/dsh-composer-predictions/main/market-index.json
This repository also publishes its own format-1 index, for anyone who wants a
focused source:
https://raw.githubusercontent.com/Stijnus/dsh-prompt-optimizer/main/market-index.json
Market sources are cached for 10 minutes per URL by the Host, so a newly
published version can take that long to show up in an open market panel.
Where the rewrite logic lives
This plugin does not re-implement prompt rewriting. It imports the engine
from the published Prompt Optimizer implementation,
oss-prompt-optimizer.
| Layer | Module | Symbol |
|---|
| Meta-prompt builder | oss-prompt-optimizer/lib/meta.js | buildOptimizePrompt(input, language, extraInstructions, examples, outputStyle, metaLanguage, diagnosis, templates, context, taskType, maxOutputTokens, profile, level, builtinExamples, compact, sceneRefEnabled) |
| Template data | oss-prompt-optimizer/lib/templates.js | META_PROMPT, META_PROMPT_EN, DEFAULT_TEMPLATES |
| System-prompt wrapper | oss-prompt-optimizer/lib/prompt.js | buildOptimizeSystem(ctx, input, outputLanguage, diagnosis, profile) |
| Rewrite executor (full service) | oss-prompt-optimizer/lib/optimizer.js | class PromptOptimizerService, optimize(rawInput, options) |
| Output validation | oss-prompt-optimizer/lib/validate.js | REQUIRED_SECTIONS, hasValidSections, truncateInput, … |
Those files sit behind the package's exports map, which only exposes the root,
./client, ./cordis.patch.yml, and ./package.json. The root re-exports the
functions this plugin needs, so the supported import is:
import { buildOptimizePrompt, detectLanguage } from 'oss-prompt-optimizer'
index.js builds the meta-prompt with
buildOptimizePrompt(draft, 'auto', …, 'plain', metaLanguage), sends the short
user turn "只输出优化后的提示词。" / "Output only the optimized prompt.", and
streams the answer back over SSE. That mirrors the upstream
PromptOptimizerService.optimize() call shape — but the upstream service itself
is not mounted, so this plugin owns its own route, timeout, and SSE framing,
and no second ✨ control or settings panel appears.
Those defaults match upstream: outputLanguage: 'auto' (no forced-language
line, the rewrite follows the draft) and outputStyle: 'plain' (a heading-free
prompt body, which is what the composer holds).
Deep imports such as oss-prompt-optimizer/lib/meta.js are blocked by the
package exports map (ERR_PACKAGE_PATH_NOT_EXPORTED). If a future release
removes the root re-exports, add an exports entry upstream or vendor
lib/meta.js + lib/templates.js into this package.
Files
| File | Role |
|---|
index.js | Host half: POST /prompt-optimizer/optimize (SSE), owner guard, route resolution, timeout, disconnect handling. |
client.js | Browser half: conversation.input.right control and conversation.input.dock panel. |
cordis.patch.yml | Inserts the prompt-optimizer Host row. |
locale/en.json, locale/zh.json | Plugin Manager / Settings display metadata. |
icon.svg | Original artwork. |
UI layout notes
conversation.input.dock renders entries with no width wrapper, so a dock
entry that does not constrain itself becomes full-bleed. The panel adopts the
host's own dock geometry:
max-width: var(--dsh-chat-content-width, 920px) — the inherited transcript /
composer column (clamp(680px, column * .64, 920px), user-draggable).margin: 0 auto calc(0px - var(--dsh-composer-stack-gap, 6px) - 3px) and
top-only border-radius with no bottom border, so the panel merges into the
composer card instead of floating above it.
After a draft is replaced, Undo becomes the primary action and the applied
note is an aria-live status region.
Development
npm install
npm test
npm test runs the Client render tests (module format, slot registrations,
dock geometry, state transitions) and a Host integration test that streams a
stubbed model call through the real route handler.
Local profile install
plugin_manager { action: "install_bundle", target: "<checkout>" }
install_bundle links a local directory (link:), so the profile's pnpm
install does not install this package's dependencies — Node resolves imports
from the plugin's real path. Run npm install in the checkout first, which
creates the local node_modules/oss-prompt-optimizer the Host half imports.
Harness packages used inside oss-prompt-optimizer (such as
@deepseek-ai/cordis) resolve from the DSH installation at runtime.
Release
Releases are tag-driven: pushing vX.Y.Z runs
.github/workflows/release.yml, which checks the tag against package.json,
runs the tests, and publishes to npm with a provenance attestation. See
RELEASING.md for the one-time trusted-publishing setup.
License
MIT. The imported rewrite engine is MIT-licensed by its author
(seven282/oss-prompt-optimizer).
Interrupted or failed rewrites cannot be applied. The original draft remains editable; only a completed result enables Use. Undo restores the draft captured when Use was clicked.
