dsh-assistant-optimization

A DSH plugin for the web profile that makes model output easier to read and your prompts easier to write.

中文文档

Features

Four capabilities, all plug-and-play. Official rendering is never replaced — the plugin shadows DSH components and delegates back to them, so Markdown, tool cards, images, and tables keep working exactly as shipped.

Reasoning fold

Some providers (OpenAI-compatible APIs with no dedicated reasoning_content channel) dump chain-of-thought into the regular text stream:

The user wants to know about X, I should explain Y first...
</thinking>

Here is the answer to your question...

DSH renders that as a single block. This plugin splits it at configurable markers so the reasoning folds into the native "Think" disclosure and only the answer stays visible. Manage the markers under Settings → General → Thinking Tag Markers.

Mermaid diagrams

Mermaid code blocks render inline as interactive SVG. Toolbar buttons zoom and reset, the scroll wheel zooms, and mouse or touch drag pans.

Edit diff counts

Write and Edit rows carry a +N (added) / -N (removed) badge right after the file path, visible without expanding the row. A failed edit produces no diff, so it gets no badge.

Prompt enhance

A sparkle button sits left of the send button and rewrites a rough draft into a clearer instruction using the model already selected in the composer. It sends one plain chat request — no session, nothing logged — and replaces the draft in place, so Ctrl/Cmd+Z undoes it.

While running it shows a spinning arc and "增强中"; on success a green check; on failure the icon flashes red with the reason in its tooltip and the draft is never cleared. The tooltip also reports how much context the last call actually received — the first thing to check when a rewrite is unhelpful.

Semantic search (context_search)

A host-side tool for vague or unclear searches: when you know what a feature does but not which files or symbols implement it, pass a natural-language query and get back a two-section result — the complete file list (each file with its line ranges) first, then each file's full range code (under two byte budgets — use read for anything beyond; list and contents are separate sections, never interleaved). It runs an agentic search loop (repo map → ripgrep/read/tree → answer), built on the fast-context approach and driven by a Windsurf key. The result is the context itself: no keyword or config lines; include_content: false degrades it to the file list only.

Key gating — the whole point. The tool and its one-line prompt guidance are registered only when a Windsurf key resolves. With no key, nothing is registered, so the model is never told about a tool it cannot call. The injected guidance is deliberately two sentences (purpose + when to reach for it + minimal call shape) — no background, no examples — because that text is paid for on every turn.

The key is resolved in this order (first hit wins):

1. WINDSURF_API_KEY environment variable
2. Manual entry — Settings → General → Windsurf API Key (saved to ~/.dsh/dsao-windsurf-key, mode 0600), or PUT /api/dsao/windsurf-key
3. Local auto-read — the logged-in Windsurf/Devin editor's state.vscdb (read via Node's built-in node:sqlite; a snapshot copy is taken, the live DB is never locked)

DSAO_FC_AUTO_KEY=0 disables step 3. A change to the manual key takes effect on the next dsh web restart (tool registration happens at profile boot). The key is never echoed back beyond a 4+4 preview.

Non-official protocol note: the search loop and the local key read touch Windsurf/Devin endpoints and app data. See lib/fast-context/NOTICE.md.

Installation

dsh plugin --profile web add github:qianshe/dsh-assistant-optimization
dsh web

Open http://127.0.0.1:3080 — the plugin activates automatically. A restart is required after install, update, and removal, because both halves load at profile boot.

Configuration

How it works

Each capability shadows a DSH rendering slot and delegates back to the official renderer — no product UI is replaced.

• Reasoning fold wraps the assistant message renderer, splits text blocks at the configured markers into alternating reasoning + text blocks, and hands the rest back to DSH.
• Edit diff counts wraps the file-mutation tool row and injects a +N/-N badge derived from DSH's own diff model; errored edits get no badge.
• Prompt enhance anchors a button in the composer and exposes one loopback-only route (POST /api/dsao/prompt-enhance) that calls the currently selected model with the draft plus project/session context as private reference, then writes the result back through the normal input path so undo still works.
• Semantic search registers a host-side tool (context_search) plus a two-sentence prompt section, both only when a Windsurf key resolves (env → manual file → local auto-read). The tool runs the agentic loop in lib/fast-context/ (repo map → restricted commands over ripgrep/read/tree → answer); the local deployment model is the automatic fallback when the Windsurf side fails mid-search. Result formatting lives in content-embed.js: the output is two independent sections — the complete file list (each file with its line ranges) first, then each file's full range code (no hard line cap; two byte budgets — total / per-file, env-tunable; a budget-truncated tail gets a marker pointing at read). Content is re-read from disk at format time, so even a cache hit yields fresh code; a missing file, a binary file, or an exhausted budget degrades to a marker line and never fails the search. The prompt-enhance route pins include_content: false for this tool (its rewrite policy must not carry code into the prompt).

For slot keys, priorities, the exact reference-extraction contract, and the failure-status map, see docs/technical-reference.md.

File structure

├── cordis.patch.yml   # composition layer: plugin row insert
├── lib/
│   ├── index.js       # Host half: prompt-enhance route + windsurf-key route + tool registration
│   ├── client.js      # shipped browser bundle (__ModuleLoader__.load)
│   └── fast-context/  # semantic search tool (MIT-ported, see NOTICE.md)
│       ├── tool.js        # key-gated registration + minimal prompt section
│       ├── key-source.js  # env → manual file → local auto-read
│       ├── core.js        # the search loop (brain abstraction + A→B fallback)
│       ├── windsurf.js    # Windsurf Devstral protocol (brain A)
│       ├── brain-llm.js   # local deployment model (brain B)
│       ├── executor.js    # restricted commands (rg/readfile/tree/ls/glob)
│       ├── extract-key.js # local state.vscdb key read (node:sqlite)
│       ├── content-embed.js # result formatting: file list + budget-limited code
│       └── …              # protocol / path-safety / repair / cache / shared
├── package.json       # dsh.bundle + dsh.client metadata
├── src/               # module sources (development reference)
│   ├── client.js      # apply() — slot registrations
│   ├── host.js
│   └── modules/
│       ├── markers.js         # marker storage
│       ├── text-split.js      # splitText + transformBlocks
│       ├── tool-diff.js       # diffStats + ensureBadge
│       ├── wrapper.js         # shadowing components
│       ├── context.js         # private-reference extraction
│       ├── prompt-enhance.js  # composer button + placement
│       ├── mermaid.js         # SVG rendering + pan/zoom
│       └── settings.js        # settings row component
├── test/
│   ├── load-module.mjs        # evaluate one bundle module in isolation
│   ├── dom-stub.mjs           # minimal DOM + ToolRow fixture
│   ├── diff-stats.test.mjs
│   ├── ensure-badge.test.mjs
│   ├── context.test.mjs
│   ├── prompt-enhance.test.mjs
│   ├── host-prompt-enhance.test.mjs
│   ├── fast-context-gate.test.mjs
│   └── content-embed.test.mjs
└── docs/
    ├── design.md
    └── technical-reference.md  # DSH slot & tool-call rendering reference

lib/client.js is the shipped artifact: the same modules assembled as window.__ModuleLoader__.load() registrations. Change behaviour in both src/ and lib/.

Development

node test/diff-stats.test.mjs          # diff counting + error suppression
node test/ensure-badge.test.mjs        # DOM convergence, incl. running → errored
node test/context.test.mjs             # reference extraction + exclusions
node test/prompt-enhance.test.mjs      # button placement + cleanup
node test/host-prompt-enhance.test.mjs # inject contract, route guards, model call
node test/fast-context-gate.test.mjs   # key gate: no key ⇒ no tool, no prompt
node test/content-embed.test.mjs       # result formatting: budgeted embed, marker fallbacks
node --check lib/client.js             # bundle syntax

Tests load the shipped modules from lib/client.js / lib/index.js, not a re-implementation.

Requirements

• DSH (DeepSeek Harness) with the web profile
• Internet access only for the mermaid.js CDN, and only when a diagram is present

License

MIT