dsh-prompt-optimizer (提示词优化)

August 30, 2026 · View on GitHub

Improve the current chat draft before sending. One click optimizes the draft with the session's currently selected model, then shows an original-vs-result comparison so you decide before anything is applied.

在发送前优化当前聊天输入。一键用当前对话选中的模型优化草稿,并以 原文 / 优化结果对比 的方式呈现,由你确认后再采用。

Features

  • Official entry points — the UI is mounted through official slots (no DOM hacking, no replacement of shipped UI):
    • a button in the composer tool row (conversation.input.left);
    • an action in the session header (conversation.session.header.actions);
    • an /optimize slash command (inputTriggers, when available).
  • Confirm before apply — the result opens in an inline comparison bar mounted in conversation.input.dock, showing 原始输入 / 优化结果 side by side; choose 采用优化结果 or 放弃. Narrow windows stack the columns vertically.
  • Never overwrites your typing — if you keep editing while the request is in flight, the bar warns you and disables "use optimized", so a late result can never clobber new content.
  • Cancellable — the button becomes 取消 while the request runs; cancelling discards the late result.
  • Uses your current model — optimization goes through the official llm service with the session's default model selection (agentDefaultModel). No extra credentials, no separate provider config.
  • Privacy by construction — only the text you actively submit from the composer is sent to the model; nothing is stored, no session history is read, no third-party service is called, and the HTTP route is loopback-only.
  • Accessible & localized — aria-labels, keyboard-operable buttons, Esc / 放弃 to close; UI text follows the DSH locale (zh / en).
  • Safe degradation — missing model, model error, empty result and request failure all surface a friendly message and never lose your draft.
  • Shared state machine — every entry point (button, header action, slash command, comparison bar) reads one module-level state singleton, so all controls stay in sync (running spinner, error banner, cancelled toast).

Install

From the DSH market (once listed), npm, or a Git URL:

# npm / pnpm
npm install @joe0001/dsh-prompt-optimizer
# or from source
git clone https://github.com/LHF198/dsh-prompt-optimizer.git
cd dsh-prompt-optimizer

Then add the loader row (or use the market's install flow):

plugins:
  - id: dsh-prompt-optimizer
    name: '@joe0001/dsh-prompt-optimizer'
    config: {}

After enabling, reload the Web GUI. A 优化 / Optimize action appears at the left end of the composer tool row, in the session header, and as /optimize.

工程化说明:当前包为手写 bundle、无编译步骤——缺省情况下克隆即用,本地校验 用 package 的三个脚本:npm run lint(对 lib/index.jslib/client.jsnode --check)、npm run build(lint 后确认 lib/client.js 存在,并非真正的转译/打包)、 npm run test(运行 node test/verify.js)。pnpm 下等价为 pnpm run <script>。 (当前仓库 URL 已指向 LHF198;创建远程仓库并推送后,即可按 docs/release.md 发布。)

Usage

  1. Type a draft in the chat composer.
  2. Click 优化 (or the 取消 button while it runs).
  3. Review 原始输入 vs 优化结果.
  4. Click 采用优化结果 to replace the draft, or 放弃 to keep your text.

You can also press /optimize in the composer, or use the header action.

Compatibility

  • Requires a DSH release that mounts the host services webServer, llm and agentDefaultModel, the client services slots, locale and timer, and the client slots conversation.input.left, conversation.session.header.actions and conversation.input.dock. The /optimize command additionally needs the optional inputTriggers service (the plugin degrades gracefully without it). Verified against DSH 0.1.1-rc.2, cordis 4.0.1.
  • @deepseek-ai/* core packages are peerDependencies only — the plugin never ships its own copy and never shadows the host version.
  • The client bundle is a standard window.__ModuleLoader__ loader entry with an explicit dsh.client.inject list (slots, locale, timer); no install-time build scripts.
  • The host route is loopback-only and fenced like other DSH web plugins.
  • Local dev toolchain (for contributors): Node.js ≥ 20 (ESM host; verified on Node v26.3.0) and pnpm (recommended; no packageManager pin yet).

Privacy

  • Only the submitted draft text is processed.
  • The optimization prompt is fixed and public (see lib/index.js).
  • No content is persisted, logged as a session event, or sent anywhere other than the currently selected model through DSH's own llm service.

Development

The package ships a hand-built bundle (lib/client.js) and a hand-written host entry (lib/index.js); there is no compile step — the build script does not transpile, it only validates that both halves are syntactically valid and that the client bundle exists. Cloning and enabling is all that is needed to try it.

Validate and verify with the package scripts (run with npm or pnpm):

npm run lint    # node --check lib/index.js && node --check lib/client.js
npm run build   # lint + confirm lib/client.js exists
npm run test    # node test/verify.js

Keep the client bundle free of JSX/TypeScript/import and always register UI through the official slots API. When changing the client, bump the loader entry revision so running pages pick up the new bundle.

See CONTRIBUTING.md for the contribution workflow, commit conventions and testing requirements. Architecture decisions are recorded under docs/adr (start at the index).

License

Apache-2.0 — see LICENSE.