dsh-prompt-enhance 0.3.0 → 0.3.1

package/README.md

@@ -47,14 +47,14 @@ flowchart LR
 
 The plugin is one npm package with two halves, following the dsh plugin conventions:
 
-- **Host half** (`exports "."`, Node): declares the `prompt-enhance` settings schema (schemastery — the built-in plugin config page renders it straight from the loader config, and the plugin **re-reads it on every request** instead of caching the boot snapshot), registers the `POST /prompt-enhance/enhance` route on the shared webserver (loopback-fenced, body-capped), and the `/enhance` slash command. The model call goes through `ctx.llm.stream` with a normalized output pass — the same auxiliary-call discipline the harness applies to session titles: deadline + caller cancellation rechecked during and after the stream, terminal-finish validation, tool-call rejection.
+- **Host half** (`exports "."`, Node): declares the `prompt-enhance` settings schema (schemastery, every field marked `.volatile()` — the host's `describe()` **drops any entry with no volatile field**, so that mark is both what makes the config page appear and the contract for "edits apply to the next request"; the plugin **re-reads it on every request** instead of caching the boot snapshot), registers the `POST /prompt-enhance/enhance` route on the shared webserver (loopback-fenced, body-capped), and the `/enhance` slash command. The model call goes through `ctx.llm.stream` with a normalized output pass — the same auxiliary-call discipline the harness applies to session titles: deadline + caller cancellation rechecked during and after the stream, terminal-finish validation, tool-call rejection.
 - **Browser half** (`exports "./client"`): registers the enhance button into the `conversation.input.right` slot and the undo bar into `conversation.input.dock`, binds a live mirror of the settings namespace, and installs the global shortcut. All copy is localized (zh/en) through the harness locale system.
 
 ## Requirements
 
 - `dsh >= 0.1.1-rc.2 < 0.3.0` — the range states what has actually been exercised, not an open-ended promise.
 - Boot-verified on `0.1.1-rc.2`, `0.1.2-alpha.3`, `0.1.7-rc.2`, `0.2.0-rc.2`, and **`0.2.1-rc.2`** (layer mounts, enhance route answers, client bundle builds; on alpha the plugin takes the newer `ctx.settings.installSection` registration path, and on `0.2.0-rc.2` it also passes the runtime's plugin-compatibility gate). The `0.2.1-rc.2` check is a **real-host end-to-end smoke**: with the local build installed into a temporary profile, the enhance route returned a real model result; setting that profile's `maxInputChars` to `300` made a 400-character draft fail with `422 {count: 400, max: 300}`, and after editing the same profile to `20000` — **without restarting** — the identical draft went through, so a settings edit reaches the *next* request instead of staying at the boot-time snapshot. The `0.2.0-rc.2` checks include the **dsh desktop application** — the environment this plugin is normally used in. On a `0.2.x` runtime expect some *other* plugins to disappear from the UI: the gate skips any bundle whose `peerDependencies` pin an older `@deepseek-ai/dsh-*` range (observed: `dshmarket`, `dsh-find-plugin`, `dsh-better-sidebar`). The harness has broken several of the APIs this plugin touches: `@deepseek-ai/dsh-settings` changed its registration entry between the two early lines, from `0.1.5-rc.3` the settings service became `SettingsForms` (no synchronous `get`), and `0.2.x` **deleted the `installSettingsSection` / `settingsNamespace` exports outright**; `dsh-agent-default-model` moved the harness default model behind its own `ctx.agentDefaultModel.currentSelection()` service; and the browser-side settings mirror moved from `ctx.settingsScope` to `ctx.configForms`. The plugin probes every generation at runtime and adapts, no configuration needed.
-- The ceiling covers the whole `0.2.x` line (including its prereleases); a `0.3.x` is untested and therefore outside the range. `dsh.engines` is advisory metadata read by the loader and plugin manager — it states support, it does not enforce it.
+- The ceiling covers the whole `0.2.x` line (including its prereleases); a `0.3.x` is untested and therefore outside the range. `dsh.engines` **is enforced**: the host's boot preflight marks a mismatched entry `disabled = true`, and only an explicit `--accept-risk` gets past the throw (`Incompatible plugins may cause crashes or data loss`). A wrong range means the plugin does not load — not that it loads with a warning.
 - Node `^22.19.0 || >=24.0.0` (for building from source)
 - Browser peers `react` / `react-dom` (`^18.2.0`) come from the web shell's module registry. The host-half module `@deepseek-ai/dsh-llm` is a **runtime module supplied by the dsh host and is not installed from npm** (the `lib/` bundles keep every package import external), so it is declared as an *optional* peer: an install that does not provide it produces no warning, and the plugin reports a normal error at enhance time rather than failing to load.
 

package/README.zh-CN.md

@@ -47,14 +47,14 @@ flowchart LR
 
 插件是单个 npm 包、双半区结构,完全遵循 dsh 插件规范:
 
-- **宿主半区**(`exports "."`,Node):声明 `prompt-enhance` 设置 schema(schemastery,由内置插件配置页按加载器配置直接渲染,插件在**每次请求时**重新读取,而不是缓存启动快照),注册共享 webserver 上的 `POST /prompt-enhance/enhance` 路由(仅回环、限长),以及 `/enhance` 斜杠命令。模型调用走 `ctx.llm.stream` 并做规范化处理——与 harness 对会话标题相同的辅助调用纪律:超时与调用方取消在流过程中和结束后复查、终结 finish 校验、拒绝工具调用。
+- **宿主半区**(`exports "."`,Node):声明 `prompt-enhance` 设置 schema(schemastery,每个字段带 `.volatile()`——宿主的 `describe()` 会**跳过没有任何 volatile 字段的条目**,这个标记既是"设置页会出现"的前提,也是"改完下次请求就生效"的契约;插件在**每次请求时**重新读取,而不是缓存启动快照),注册共享 webserver 上的 `POST /prompt-enhance/enhance` 路由(仅回环、限长),以及 `/enhance` 斜杠命令。模型调用走 `ctx.llm.stream` 并做规范化处理——与 harness 对会话标题相同的辅助调用纪律:超时与调用方取消在流过程中和结束后复查、终结 finish 校验、拒绝工具调用。
 - **浏览器半区**(`exports "./client"`):把增强按钮注册进 `conversation.input.right` 插槽、撤销条注册进 `conversation.input.dock` 插槽,绑定设置命名空间的实时镜像,并安装全局快捷键。全部文案经 harness locale 系统提供中英双语。
 
 ## 环境要求
 
 - `dsh >= 0.1.1-rc.2 < 0.3.0` —— 这个区间表示**实际验证过的范围**,而不是无限期的承诺。
 - 实测环境:`0.1.1-rc.2`、`0.1.2-alpha.3`、`0.1.7-rc.2`、`0.2.0-rc.2`、**`0.2.1-rc.2`** 均已 boot 验证(插件层挂载、增强路由应答、客户端 bundle 构建通过;alpha 上走新版 `ctx.settings.installSection` 注册路径,`0.2.0-rc.2` 上还通过了运行时的插件兼容性闸门)。`0.2.1-rc.2` 的验证是**真实宿主的端到端冒烟**:在临时 profile 里装入本地构建后,增强路由对着在线模型返回了真实结果;把该 profile 的 `maxInputChars` 设为 `300` 后,400 字草稿被 `422 {count:400,max:300}` 拒绝,随后**不重启**把它改成 `20000`,同一份草稿立即通过——设置改动确实作用到下一次请求,而不是停在启动时的快照。其中 `0.2.0-rc.2` 的验证包含 **dsh 桌面应用**——也就是本插件日常实际运行的环境。在 `0.2.x` 运行时上,可能会发现**别的**插件从界面消失:凡 `peerDependencies` 把 `@deepseek-ai/dsh-*` 锁在旧区间的 bundle 都会被闸门跳过(实测被跳过的是 `dshmarket`、`dsh-find-plugin`、`dsh-better-sidebar`)。宿主在插件用到的几处 API 上做过破坏性变更:`@deepseek-ai/dsh-settings` 的注册入口在两条早期版本线之间变过,`0.1.5-rc.3` 起 settings 服务改为 `SettingsForms`(不再有同步 `get`),而 `0.2.x` 干脆**删掉了 `installSettingsSection` / `settingsNamespace` 导出**;`dsh-agent-default-model` 把全局默认模型收进了自己的 `ctx.agentDefaultModel.currentSelection()` 服务;浏览器侧的设置镜像则从 `ctx.settingsScope` 迁到了 `ctx.configForms`。插件对每一代形态均做运行时探测并自动适配,无需配置。
-- 上界覆盖整条 `0.2.x` 线(含其预发布版本);`0.3.x` 尚未验证,因此不在区间内。`dsh.engines` 是加载器与插件管理器读取的**声明性元数据**——它表达支持范围,并不强制拦截。
+- 上界覆盖整条 `0.2.x` 线(含其预发布版本);`0.3.x` 尚未验证,因此不在区间内。`dsh.engines` **是强制的**:宿主启动预检会把不匹配的条目直接 `disabled = true`,要放行必须显式 `--accept-risk`,否则抛 `Incompatible plugins may cause crashes or data loss`。所以这个区间写错的结果是**插件不加载**,而不是"只提示一下"。
 - Node `^22.19.0 || >=24.0.0`(仅从源码构建时需要)
 - 浏览器侧 peer `react` / `react-dom`(`^18.2.0`)由 Web 壳的模块注册表提供。宿主半区用到的 `@deepseek-ai/dsh-llm` 是**由 dsh 宿主提供的运行时模块,不从 npm 安装**(`lib/` 产物把包引用全部保持为外部),因此声明为**可选** peer:未提供它的环境不会出现安装警告,增强时按正常错误路径报错,而不是加载失败。
 

package/docs/release-0.3.1.md

@@ -0,0 +1,50 @@
+# 0.3.1 — 设置页真的会出现，失败流真的会关
+
+0.3.0 把插件搬到了 `0.2.1-rc.2` 的契约上，但有两条最关键的路径**在真实宿主上从未生效**：设置页不存在，失败流不结束。两条都属于"看着在、其实不在"，所以这次每条都配了一个**在旧代码上必然失败**的测试。
+
+## 两个致命项
+
+| 面 | 0.2.x 的真实行为 | 用户看到什么 | 修法 |
+|---|---|---|---|
+| **设置** | `SettingsForms.describe()` 用内部 `volatileForm()` 过滤每个条目：**没有任何字段带 `meta.volatile` 时整条被丢弃** | 设置页里没有本插件；即使写入也会抛 `Plugin entry "prompt-enhance" has no volatile fields` | 16 个字段全部加 `.volatile()`；schema 库从裸 `schemastery` 换成 `@deepseek-ai/schemastery`（只有它带 `.volatile()` 与配套的位置校验） |
+| **流式失败** | 错误分支写了 `event: error` 帧，**没有 `res.end()`** | 浏览器因为收到帧而正常显示错误；`curl` / `response.text()` / 代理**永久挂起** | 成功与失败共用 `endResponse()` 收尾 |
+
+复现与验证（不是推断）：
+
+```
+宿主 volatileForm(Config)  → 修复前: undefined（条目被跳过）
+                           → 修复后: present, 16 个字段
+真宿主 dsh web @0.2.1-rc.2 → 插件激活、POST /prompt-enhance/enhance
+                             返回 deepseek-official / deepseek-flash 的真实结果
+```
+
+失败流那条的证伪：把 `endResponse(res)` 注释掉，新用例在 2.07 秒被 abort 判失败——正是"永久挂起"。
+
+## 生命周期与失败路径
+
+- **路由不随卸载回收**：`webServer.register` 只返回"从表里删项"的函数，disposer 却存在模块级 map 里、无人调用 ⇒ 卸载后路由仍用旧配置与旧限流窗答卷，重载撞 `duplicate prefix route`。改为 `ctx.inject(['webServer'])` + `ctx.effect`，服务按身份跟随、随光纤回收。
+- **`/enhance` 在无 webServer 的组合里整体消失**：`inject` 里硬写了 `['llm','webServer']`。`webServer` 移出硬依赖、改按需注入后，斜杠命令在纯 CLI 组合里依然可用。
+- **`/enhance` 遇配置异常直接抛**：`readConfig()` 在 `try` 之外，provider/model 半填时抛出的是未捕获异常，而不是路由侧那句中英双语提示。已移入 `try`。
+- **流式端点把"服务端拒绝"当成"宿主不支持流式"**：`response.ok === false` 时丢弃整个错误信封并**原样重发一次**——429 反而打两次、结构化原因（`limit`/`retryAfterSeconds`）全丢。现在先按 `ok` 分流：拒绝即报拒绝，只有"200 但不是流"才回退一次性。
+- **面板打开时快捷键打到别的会话**：结果面板 `createPortal` 挂在 `body` 上并接管焦点，上溯循环走到 `body` 时 `body.contains(每个 composer)` 恒真 ⇒ 返回注册表里的第一个会话。现在遇 `body`/`documentElement` 即停，退回"最近挂载的会话"。证伪：去掉这行判断，用例立刻变成"点了另一个会话"。
+- **设置镜像可能永久停在默认值**：`boundId` 在 `forms.get()` **之前**落值，取不到时后续每次 describe tick 都因 `entryId === boundId` 直接返回 ⇒ 永不重试。改为取到 form 之后才认领 id。
+
+## 可诊断性与小项
+
+- 客户端三处空 `catch` 改为 `console.warn`（模块注释早就承诺 "caught and logged"，代码里一行都没有）——"按钮不出现"这类报告唯一的线索来源。
+- 对话框 Tab 焦点陷阱的**反向**漏：面板根节点是刻意 `tabIndex={-1}`，既不是 first 也不是 last，`Shift+Tab` 能直接逃出。已把根节点视为"first 之前"。
+- 关闭插件后不再抢键：此前仍 `preventDefault` 后跑一个空动作，等于静默吃掉用户绑给同一组合的宿主快捷键。
+- `scripts/build.mjs` 列在 `tsconfig.include` 里但 `allowJs` 没开 ⇒ 从未被检查。现在开 `checkJs`，并给 esbuild 选项补 JSDoc（否则 `packages: 'external'` 会退化成 `string`）。
+- README 不再称 `dsh.engines` 为"声明性、不强制"：宿主启动预检会直接 `disabled = true`，放行必须显式 `--accept-risk`。
+
+## 验证
+
+- `npm run typecheck` 干净（`build.mjs` 现在确实在检查范围内，`tsc --listFilesOnly` 命中 1）
+- `npm test` **24 文件 / 242 用例全绿**（0.3.0 为 22 / 231，新增 `client-enhance-client`、`client-shortcut-target` 及配置/路由/镜像若干条）
+- 真实宿主冒烟：临时 profile 装本地包 → 插件激活、无 `pending` / `did not activate` → 增强路由返回真实模型结果 → 临时 profile 与临时目录已删除
+
+## 未做（有意）
+
+- **快捷键没有迁移到宿主的 `shortcuts` 服务**（`dsh-client-shortcuts` 支持用户改键与冲突消解）。迁移需要先确认该服务的注册契约与冲突语义，属于独立改动，不在这次"失败路径闭包"的范围内。
+- **`Origin` 只比对 hostname、不比对端口**：任意 `localhost:任意端口` 的页面都被信任。收紧需要把服务实际监听的端口传进栅栏，同样属独立改动。
+- 跨代探测的兼容死分支（`installSection`、旧 settings 模块、`webUiSettings`、`settingsScope`）保留：它们在旧版本线上仍是唯一的路径。

package/lib/client.js

@@ -124,6 +124,16 @@ async function readEnvelope(response) {
   }
   throw new EnhanceClientError({ code: "internal", message: `\u5BBF\u4E3B\u670D\u52A1\u8FD4\u56DE\u5F02\u5E38\uFF08HTTP ${response.status}\uFF09\u3002` });
 }
+async function rejectionOf(response) {
+  try {
+    const parsed = await response.json();
+    if (parsed !== null && typeof parsed === "object" && parsed.error !== void 0) {
+      return new EnhanceClientError(parseError(parsed.error));
+    }
+  } catch {
+  }
+  return new EnhanceClientError({ code: "internal", message: `\u5BBF\u4E3B\u670D\u52A1\u62D2\u7EDD\u4E86\u8BF7\u6C42\uFF08HTTP ${response.status}\uFF09\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002` });
+}
 function takeFrames(buffer) {
   const frames = [];
   let rest = buffer;
@@ -170,9 +180,9 @@ async function requestEnhanceStream(body, options) {
     throw new EnhanceClientError({ code: "internal", message: "\u65E0\u6CD5\u8FDE\u63A5\u5BBF\u4E3B\u670D\u52A1\uFF0C\u8BF7\u786E\u8BA4 dsh web \u6B63\u5728\u8FD0\u884C\u540E\u91CD\u8BD5\u3002" });
   }
   const contentType = String(response.headers.get("content-type") ?? "").toLowerCase();
+  if (!response.ok) throw await rejectionOf(response);
   const stream = response.body;
-  const streamable = response.ok && stream !== null && stream !== void 0 && contentType.includes("event-stream");
-  if (stream === null || stream === void 0 || !streamable) {
+  if (stream === null || stream === void 0 || !contentType.includes("event-stream")) {
     void Promise.resolve().then(() => stream?.cancel()).catch(() => {
     });
     return requestEnhance(body, options.signal);
@@ -295,10 +305,12 @@ function ResultPanel(props) {
         const first = focusables[0];
         const last = focusables[focusables.length - 1];
         if (first === void 0 || last === void 0) return;
-        if (event.shiftKey && document.activeElement === first) {
+        const active = document.activeElement;
+        const atRoot = active === panel;
+        if (event.shiftKey && (active === first || atRoot)) {
           event.preventDefault();
           last.focus();
-        } else if (!event.shiftKey && document.activeElement === last) {
+        } else if (!event.shiftKey && active === last) {
           event.preventDefault();
           first.focus();
         }
@@ -562,6 +574,7 @@ function shortcutTarget() {
   if (active !== null && active instanceof Element) {
     let node = active;
     for (let depth = 0; depth < 8 && node !== null; depth++) {
+      if (node === document.body || node === document.documentElement) break;
       for (const entry of sessions.values()) {
         if (entry.root !== null && (node === entry.root || node.contains(entry.root))) {
           const found = entry;
@@ -1168,12 +1181,6 @@ function installClientSettingsSource(ctx, options) {
     const bind = () => {
       const entryId = resolveEntryId();
       if (entryId === void 0 || entryId === boundId) return;
-      try {
-        unsubscribeForm?.();
-      } catch {
-      }
-      unsubscribeForm = void 0;
-      boundId = entryId;
       let form;
       try {
         form = forms.get?.(entryId);
@@ -1181,6 +1188,12 @@ function installClientSettingsSource(ctx, options) {
         return;
       }
       if (form === void 0) return;
+      try {
+        unsubscribeForm?.();
+      } catch {
+      }
+      unsubscribeForm = void 0;
+      boundId = entryId;
       adoptSnapshot(RANK.configForms, form);
       try {
         unsubscribeForm = form.subscribe?.(() => adoptSnapshot(RANK.configForms, form));
@@ -1263,15 +1276,22 @@ function installClientSettingsSource(ctx, options) {
 
 // src/client/index.tsx
 var inject = [];
+function report(step, error) {
+  try {
+    console.warn(`[prompt-enhance] ${step} failed; that feature stays off.`, error);
+  } catch {
+  }
+  return () => {
+  };
+}
 function apply(ctx) {
   ensureStyles();
   ctx.inject(["locale"], (localeCtx) => {
     ctx.effect(() => {
       try {
         return localeCtx.locale.register(NS, dictionaries);
-      } catch {
-        return () => {
-        };
+      } catch (error) {
+        return report("dictionary registration", error);
       }
     }, "dsh-prompt-enhance: dictionaries");
   });
@@ -1289,9 +1309,8 @@ function apply(ctx) {
           { name: "conversation.input.right", id: "prompt-enhance", order: 60, locale: NS },
           EnhanceButton
         );
-      } catch {
-        return () => {
-        };
+      } catch (error) {
+        return report("composer enhance button slot", error);
       }
     });
   });
@@ -1304,16 +1323,17 @@ function apply(ctx) {
           { name: "conversation.input.dock", id: "prompt-enhance-undo", order: 90, locale: NS },
           UndoBar
         );
-      } catch {
-        return () => {
-        };
+      } catch (error) {
+        return report("undo bar slot", error);
       }
     });
   });
   ctx.effect(() => {
     const onKeyDown = (event) => {
       if (event.defaultPrevented || event.isComposing) return;
-      const combo = parseShortcut(getClientSettings().shortcut);
+      const settings = getClientSettings();
+      if (!settings.enabled) return;
+      const combo = parseShortcut(settings.shortcut);
       if (!matchesShortcut(event, combo)) return;
       const target = shortcutTarget();
       if (target === void 0) return;

package/lib/index.js

@@ -1,5 +1,5 @@
 // src/config.ts
-import z from "schemastery";
+import z from "@deepseek-ai/schemastery";
 var PROMPT_ENHANCE_NAMESPACE = "prompt-enhance";
 var DEFAULT_CONFIG = {
   enabled: true,
@@ -18,22 +18,22 @@ var DEFAULT_CONFIG = {
   contextMaxChars: 4e3
 };
 var Config = z.object({
-  enabled: z.boolean().default(DEFAULT_CONFIG.enabled).description("\u603B\u5F00\u5173\uFF1A\u5173\u95ED\u540E\u9690\u85CF\u8F93\u5165\u6846\u589E\u5F3A\u6309\u94AE\u5E76\u505C\u7528\u6240\u6709\u89E6\u53D1\u65B9\u5F0F"),
-  provider: z.string().description("\u8986\u76D6\u6A21\u578B\u8DEF\u7531\u7684 provider\uFF08\u4E0E\u300C\u6A21\u578B\u300D\u5FC5\u987B\u6210\u5BF9\u586B\u5199\uFF1B\u7559\u7A7A\u8DDF\u968F\u5F53\u524D\u4F1A\u8BDD\u6A21\u578B\uFF09"),
-  model: z.string().description("\u8986\u76D6\u6A21\u578B\u8DEF\u7531\u7684 model\uFF08\u4E0E\u300Cprovider\u300D\u5FC5\u987B\u6210\u5BF9\u586B\u5199\uFF1B\u7559\u7A7A\u8DDF\u968F\u5F53\u524D\u4F1A\u8BDD\u6A21\u578B\uFF09"),
-  temperature: z.number().min(0).max(1).step(0.05).default(DEFAULT_CONFIG.temperature).description("\u91C7\u6837\u6E29\u5EA6\uFF1B\u4F4E\u6E29\u6539\u5199\u66F4\u5FE0\u5B9E\u4E8E\u539F\u610F"),
-  maxOutputTokens: z.number().step(1).min(256).max(32768).default(DEFAULT_CONFIG.maxOutputTokens).description("\u5355\u6B21\u589E\u5F3A\u7684\u8F93\u51FA token \u4E0A\u9650"),
-  maxInputChars: z.number().step(1).min(200).max(2e5).default(DEFAULT_CONFIG.maxInputChars).description("\u8F93\u5165\u5B57\u6570\u4E0A\u9650\uFF1B\u8D85\u9650\u62D2\u7EDD\u800C\u4E0D\u622A\u65AD\uFF0C\u907F\u514D\u6539\u53D8\u539F\u610F"),
-  timeoutMs: z.number().step(1).min(5e3).max(6e5).default(DEFAULT_CONFIG.timeoutMs).description("\u5355\u6B21\u589E\u5F3A\u7684\u8D85\u65F6\uFF08\u6BEB\u79D2\uFF09"),
-  systemPrompt: z.string().role("textarea").default(DEFAULT_CONFIG.systemPrompt).description("\u7CFB\u7EDF\u63D0\u793A\u8BCD\uFF1B\u7559\u7A7A\u4F7F\u7528\u5185\u7F6E\u589E\u5F3A\u7B56\u7565"),
-  strategyMode: z.union(["replace-default", "extend-default"]).default(DEFAULT_CONFIG.strategyMode).description("\u81EA\u5B9A\u4E49\u7CFB\u7EDF\u63D0\u793A\u8BCD\u7684\u7EC4\u5408\u65B9\u5F0F\uFF1A\u6574\u4F53\u66FF\u6362\u5185\u7F6E\u7B56\u7565\uFF08\u9ED8\u8BA4\uFF1B\u5185\u7F6E\u7B56\u7565\u7684\u4E0D\u7F16\u9020\u3001\u53EA\u8F93\u51FA\u6B63\u6587\u7B49\u786C\u6027\u7EA6\u675F\u4E0D\u4F1A\u81EA\u52A8\u4FDD\u7559\uFF09\uFF0C\u6216\u628A\u81EA\u5B9A\u4E49\u6587\u672C\u8FFD\u52A0\u5728\u5185\u7F6E\u7B56\u7565\u4E4B\u540E\uFF08\u786C\u6027\u7EA6\u675F\u7EE7\u7EED\u751F\u6548\uFF09"),
-  shortcut: z.string().default(DEFAULT_CONFIG.shortcut).description("\u89E6\u53D1\u5FEB\u6377\u952E\uFF08\u5982 ctrl+alt+e\uFF1B\u987B\u5305\u542B ctrl/alt/meta \u4E2D\u81F3\u5C11\u4E00\u4E2A\u4FEE\u9970\u952E\uFF0Cshift \u4EC5\u53EF\u4F5C\u9644\u52A0\uFF0C\u7EAF\u5B57\u6BCD/\u6570\u5B57\u6216 shift+\u5B57\u6BCD\u4F1A\u88AB\u5FFD\u7565\uFF1B\u7559\u7A7A\u7981\u7528\uFF09"),
-  maxConcurrent: z.number().step(1).min(1).max(16).default(DEFAULT_CONFIG.maxConcurrent).description("\u5BBF\u4E3B\u4FA7\u5E76\u53D1\u4E0A\u9650\uFF1A\u540C\u65F6\u8FDB\u884C\u7684\u589E\u5F3A\u8C03\u7528\u6570\uFF0C\u8D85\u51FA\u7684\u8BF7\u6C42\u8FD4\u56DE 429"),
-  rateLimitPerMinute: z.number().step(1).min(1).max(600).default(DEFAULT_CONFIG.rateLimitPerMinute).description("\u6BCF\u5206\u949F\u589E\u5F3A\u6B21\u6570\u4E0A\u9650\uFF08\u6ED1\u52A8\u7A97\u53E3\uFF09\uFF0C\u8D85\u51FA\u8FD4\u56DE 429"),
-  streaming: z.boolean().default(DEFAULT_CONFIG.streaming).description("\u589E\u91CF\u5C55\u793A\uFF1A\u6A21\u578B\u8FB9\u5199\u8FB9\u5728\u9762\u677F\u663E\u793A\uFF08\u4EC5\u5F71\u54CD\u663E\u793A\u8282\u594F\uFF0C\u6700\u7EC8\u7ED3\u679C\u4E0D\u53D8\uFF1B\u5BBF\u4E3B\u6216\u7F51\u7EDC\u4E0D\u652F\u6301\u65F6\u81EA\u52A8\u56DE\u9000\u4E3A\u4E00\u6B21\u6027\u8FD4\u56DE\uFF09"),
-  contextAware: z.boolean().default(DEFAULT_CONFIG.contextAware).description("\u4E0A\u4E0B\u6587\u611F\u77E5\uFF1A\u8BFB\u53D6\u5F53\u524D\u4F1A\u8BDD\u8FD1\u671F\u5BF9\u8BDD\uFF0C\u7528\u4E8E\u6D88\u89E3\u6307\u4EE3\u3001\u8865\u5168\u7701\u7565\u4E0E\u672F\u8BED\u7EA6\u675F\uFF1B\u65E0\u5386\u53F2\u6216\u5386\u53F2\u4E0D\u8DB3\u65F6\u81EA\u52A8\u56DE\u9000\u4E3A\u5355\u6761\u589E\u5F3A\uFF0C\u4E0D\u81C6\u9020\u4FE1\u606F"),
-  contextMaxMessages: z.number().step(1).min(0).max(50).default(DEFAULT_CONFIG.contextMaxMessages).description("\u4E0A\u4E0B\u6587\u7A97\u53E3\uFF08\u6761\u6570\uFF09\uFF1A\u6700\u591A\u53C2\u8003\u6700\u8FD1\u591A\u5C11\u6761 user/assistant \u8F6E\u6B21\uFF1B0 \u8868\u793A\u4E0D\u53C2\u8003"),
-  contextMaxChars: z.number().step(1).min(0).max(1e5).default(DEFAULT_CONFIG.contextMaxChars).description("\u4E0A\u4E0B\u6587\u7A97\u53E3\uFF08\u5B57\u6570\uFF09\uFF1A\u5386\u53F2\u7247\u6BB5\u7684\u5B57\u7B26\u9884\u7B97\uFF0C\u4ECE\u6700\u65B0\u4E00\u6761\u5411\u524D\u88C5\u914D\uFF1B0 \u8868\u793A\u4E0D\u53C2\u8003")
+  enabled: z.boolean().default(DEFAULT_CONFIG.enabled).description("\u603B\u5F00\u5173\uFF1A\u5173\u95ED\u540E\u9690\u85CF\u8F93\u5165\u6846\u589E\u5F3A\u6309\u94AE\u5E76\u505C\u7528\u6240\u6709\u89E6\u53D1\u65B9\u5F0F").volatile(),
+  provider: z.string().description("\u8986\u76D6\u6A21\u578B\u8DEF\u7531\u7684 provider\uFF08\u4E0E\u300C\u6A21\u578B\u300D\u5FC5\u987B\u6210\u5BF9\u586B\u5199\uFF1B\u7559\u7A7A\u8DDF\u968F\u5F53\u524D\u4F1A\u8BDD\u6A21\u578B\uFF09").volatile(),
+  model: z.string().description("\u8986\u76D6\u6A21\u578B\u8DEF\u7531\u7684 model\uFF08\u4E0E\u300Cprovider\u300D\u5FC5\u987B\u6210\u5BF9\u586B\u5199\uFF1B\u7559\u7A7A\u8DDF\u968F\u5F53\u524D\u4F1A\u8BDD\u6A21\u578B\uFF09").volatile(),
+  temperature: z.number().min(0).max(1).step(0.05).default(DEFAULT_CONFIG.temperature).description("\u91C7\u6837\u6E29\u5EA6\uFF1B\u4F4E\u6E29\u6539\u5199\u66F4\u5FE0\u5B9E\u4E8E\u539F\u610F").volatile(),
+  maxOutputTokens: z.number().step(1).min(256).max(32768).default(DEFAULT_CONFIG.maxOutputTokens).description("\u5355\u6B21\u589E\u5F3A\u7684\u8F93\u51FA token \u4E0A\u9650").volatile(),
+  maxInputChars: z.number().step(1).min(200).max(2e5).default(DEFAULT_CONFIG.maxInputChars).description("\u8F93\u5165\u5B57\u6570\u4E0A\u9650\uFF1B\u8D85\u9650\u62D2\u7EDD\u800C\u4E0D\u622A\u65AD\uFF0C\u907F\u514D\u6539\u53D8\u539F\u610F").volatile(),
+  timeoutMs: z.number().step(1).min(5e3).max(6e5).default(DEFAULT_CONFIG.timeoutMs).description("\u5355\u6B21\u589E\u5F3A\u7684\u8D85\u65F6\uFF08\u6BEB\u79D2\uFF09").volatile(),
+  systemPrompt: z.string().role("textarea").default(DEFAULT_CONFIG.systemPrompt).description("\u7CFB\u7EDF\u63D0\u793A\u8BCD\uFF1B\u7559\u7A7A\u4F7F\u7528\u5185\u7F6E\u589E\u5F3A\u7B56\u7565").volatile(),
+  strategyMode: z.union(["replace-default", "extend-default"]).default(DEFAULT_CONFIG.strategyMode).description("\u81EA\u5B9A\u4E49\u7CFB\u7EDF\u63D0\u793A\u8BCD\u7684\u7EC4\u5408\u65B9\u5F0F\uFF1A\u6574\u4F53\u66FF\u6362\u5185\u7F6E\u7B56\u7565\uFF08\u9ED8\u8BA4\uFF1B\u5185\u7F6E\u7B56\u7565\u7684\u4E0D\u7F16\u9020\u3001\u53EA\u8F93\u51FA\u6B63\u6587\u7B49\u786C\u6027\u7EA6\u675F\u4E0D\u4F1A\u81EA\u52A8\u4FDD\u7559\uFF09\uFF0C\u6216\u628A\u81EA\u5B9A\u4E49\u6587\u672C\u8FFD\u52A0\u5728\u5185\u7F6E\u7B56\u7565\u4E4B\u540E\uFF08\u786C\u6027\u7EA6\u675F\u7EE7\u7EED\u751F\u6548\uFF09").volatile(),
+  shortcut: z.string().default(DEFAULT_CONFIG.shortcut).description("\u89E6\u53D1\u5FEB\u6377\u952E\uFF08\u5982 ctrl+alt+e\uFF1B\u987B\u5305\u542B ctrl/alt/meta \u4E2D\u81F3\u5C11\u4E00\u4E2A\u4FEE\u9970\u952E\uFF0Cshift \u4EC5\u53EF\u4F5C\u9644\u52A0\uFF0C\u7EAF\u5B57\u6BCD/\u6570\u5B57\u6216 shift+\u5B57\u6BCD\u4F1A\u88AB\u5FFD\u7565\uFF1B\u7559\u7A7A\u7981\u7528\uFF09").volatile(),
+  maxConcurrent: z.number().step(1).min(1).max(16).default(DEFAULT_CONFIG.maxConcurrent).description("\u5BBF\u4E3B\u4FA7\u5E76\u53D1\u4E0A\u9650\uFF1A\u540C\u65F6\u8FDB\u884C\u7684\u589E\u5F3A\u8C03\u7528\u6570\uFF0C\u8D85\u51FA\u7684\u8BF7\u6C42\u8FD4\u56DE 429").volatile(),
+  rateLimitPerMinute: z.number().step(1).min(1).max(600).default(DEFAULT_CONFIG.rateLimitPerMinute).description("\u6BCF\u5206\u949F\u589E\u5F3A\u6B21\u6570\u4E0A\u9650\uFF08\u6ED1\u52A8\u7A97\u53E3\uFF09\uFF0C\u8D85\u51FA\u8FD4\u56DE 429").volatile(),
+  streaming: z.boolean().default(DEFAULT_CONFIG.streaming).description("\u589E\u91CF\u5C55\u793A\uFF1A\u6A21\u578B\u8FB9\u5199\u8FB9\u5728\u9762\u677F\u663E\u793A\uFF08\u4EC5\u5F71\u54CD\u663E\u793A\u8282\u594F\uFF0C\u6700\u7EC8\u7ED3\u679C\u4E0D\u53D8\uFF1B\u5BBF\u4E3B\u6216\u7F51\u7EDC\u4E0D\u652F\u6301\u65F6\u81EA\u52A8\u56DE\u9000\u4E3A\u4E00\u6B21\u6027\u8FD4\u56DE\uFF09").volatile(),
+  contextAware: z.boolean().default(DEFAULT_CONFIG.contextAware).description("\u4E0A\u4E0B\u6587\u611F\u77E5\uFF1A\u8BFB\u53D6\u5F53\u524D\u4F1A\u8BDD\u8FD1\u671F\u5BF9\u8BDD\uFF0C\u7528\u4E8E\u6D88\u89E3\u6307\u4EE3\u3001\u8865\u5168\u7701\u7565\u4E0E\u672F\u8BED\u7EA6\u675F\uFF1B\u65E0\u5386\u53F2\u6216\u5386\u53F2\u4E0D\u8DB3\u65F6\u81EA\u52A8\u56DE\u9000\u4E3A\u5355\u6761\u589E\u5F3A\uFF0C\u4E0D\u81C6\u9020\u4FE1\u606F").volatile(),
+  contextMaxMessages: z.number().step(1).min(0).max(50).default(DEFAULT_CONFIG.contextMaxMessages).description("\u4E0A\u4E0B\u6587\u7A97\u53E3\uFF08\u6761\u6570\uFF09\uFF1A\u6700\u591A\u53C2\u8003\u6700\u8FD1\u591A\u5C11\u6761 user/assistant \u8F6E\u6B21\uFF1B0 \u8868\u793A\u4E0D\u53C2\u8003").volatile(),
+  contextMaxChars: z.number().step(1).min(0).max(1e5).default(DEFAULT_CONFIG.contextMaxChars).description("\u4E0A\u4E0B\u6587\u7A97\u53E3\uFF08\u5B57\u6570\uFF09\uFF1A\u5386\u53F2\u7247\u6BB5\u7684\u5B57\u7B26\u9884\u7B97\uFF0C\u4ECE\u6700\u65B0\u4E00\u6761\u5411\u524D\u88C5\u914D\uFF1B0 \u8868\u793A\u4E0D\u53C2\u8003").volatile()
 });
 function resolveConfig(config) {
   if (config === null || typeof config !== "object") throw new Error("prompt-enhance: configuration is required");
@@ -867,6 +867,13 @@ function writeJson(res, status, body) {
   });
   res.end(JSON.stringify(body));
 }
+function endResponse(res) {
+  if (res.writableEnded || res.destroyed) return;
+  try {
+    res.end();
+  } catch {
+  }
+}
 
 // src/enhance-routes.ts
 var bodyCapOf = (maxInputChars) => maxInputChars * 6 + 4096;
@@ -1005,12 +1012,7 @@ data: ${JSON.stringify({ type: "delta", text: tail })}
 data: ${JSON.stringify({ type: "done", value })}
 
 `);
-        if (!res.writableEnded && !res.destroyed) {
-          try {
-            res.end();
-          } catch {
-          }
-        }
+        endResponse(res);
       } finally {
         sse.dispose();
       }
@@ -1030,10 +1032,16 @@ data: ${JSON.stringify({ type: "done", value })}
     }
     const wire = toEnhanceError(error);
     if (stream && res.headersSent) {
-      if (!res.writableEnded) res.write(`event: error
+      if (!res.writableEnded) {
+        try {
+          res.write(`event: error
 data: ${JSON.stringify({ type: "error", error: wire })}
 
 `);
+        } catch {
+        }
+      }
+      endResponse(res);
     } else {
       writeJson(res, wire.code === "timeout" ? 504 : wire.code === "unconfigured" ? 409 : 502, { ok: false, error: wire });
     }
@@ -1044,27 +1052,40 @@ data: ${JSON.stringify({ type: "error", error: wire })}
 }
 var mounts = /* @__PURE__ */ new WeakMap();
 function registerEnhanceRoute(ctx, readConfig) {
-  const webserver = ctx.get("webServer");
-  if (webserver === void 0) return;
-  const existing = mounts.get(ctx);
-  if (existing !== void 0 && existing.webserver === webserver) return;
-  if (existing !== void 0) {
-    try {
-      existing.dispose();
-    } catch {
-    }
-  }
-  const gate = { stamps: [], active: 0, failures: 0, cooldownUntil: 0 };
-  const dispose = webserver.register({
-    kind: "prefix",
-    path: ENHANCE_PREFIX,
-    handler: (req, res) => {
-      const pathname = new URL(req.url ?? "/", "http://x").pathname;
-      return serveEnhance(ctx, readConfig, gate, pathname, req, res, pathname === ENHANCE_STREAM_ENDPOINT);
+  ctx.inject(["webServer"], (routeCtx) => {
+    const webserver = routeCtx.get("webServer");
+    if (webserver === void 0) return;
+    const existing = mounts.get(ctx);
+    if (existing !== void 0 && existing.webserver === webserver) return;
+    if (existing !== void 0) {
+      try {
+        existing.dispose();
+      } catch {
+      }
+      mounts.delete(ctx);
     }
+    const gate = { stamps: [], active: 0, failures: 0, cooldownUntil: 0 };
+    routeCtx.effect(() => {
+      const dispose = webserver.register({
+        kind: "prefix",
+        path: ENHANCE_PREFIX,
+        handler: (req, res) => {
+          const pathname = new URL(req.url ?? "/", "http://x").pathname;
+          return serveEnhance(ctx, readConfig, gate, pathname, req, res, pathname === ENHANCE_STREAM_ENDPOINT);
+        }
+      });
+      const disposed = typeof dispose === "function" ? dispose : () => {
+      };
+      mounts.set(ctx, { webserver, dispose: disposed });
+      return () => {
+        if (mounts.get(ctx)?.dispose === disposed) mounts.delete(ctx);
+        try {
+          disposed();
+        } catch {
+        }
+      };
+    }, "prompt-enhance: enhance route");
   });
-  mounts.set(ctx, { webserver, dispose: typeof dispose === "function" ? dispose : () => {
-  } });
 }
 
 // src/enhance-command.ts
@@ -1081,15 +1102,15 @@ function registerEnhanceCommand(ctx, readConfig) {
       if (raw === "") {
         return { kind: "error", text: "\u7528\u6CD5\uFF1A/enhance <\u6587\u672C>\u3002\u8981\u589E\u5F3A\u8F93\u5165\u6846\u91CC\u7684\u8349\u7A3F\uFF0C\u8BF7\u7528\u8F93\u5165\u6846\u53F3\u4FA7\u7684\u300C\u589E\u5F3A\u300D\u6309\u94AE\u6216\u5FEB\u6377\u952E\u3002" };
       }
-      const config = readConfig();
-      if (!config.enabled) {
-        return { kind: "error", text: "\u63D0\u793A\u8BCD\u589E\u5F3A\u5DF2\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u5173\u95ED\u3002" };
-      }
-      const check = checkInputText(raw, config.maxInputChars);
-      if (!check.ok) {
-        return { kind: "error", text: formatInputCheckZh(check) };
-      }
       try {
+        const config = readConfig();
+        if (!config.enabled) {
+          return { kind: "error", text: "\u63D0\u793A\u8BCD\u589E\u5F3A\u5DF2\u5728\u63D2\u4EF6\u8BBE\u7F6E\u4E2D\u5173\u95ED\u3002" };
+        }
+        const check = checkInputText(raw, config.maxInputChars);
+        if (!check.ok) {
+          return { kind: "error", text: formatInputCheckZh(check) };
+        }
         const value = await runEnhance(ctx, config, {
           text: raw,
           sessionRoute: sessionRouteOf(ctx, invocation.agent.session.id),
@@ -1107,7 +1128,7 @@ function registerEnhanceCommand(ctx, readConfig) {
 
 // src/index.ts
 var name = "prompt-enhance";
-var inject = ["llm", "webServer"];
+var inject = ["llm"];
 function apply(ctx, config = { ...DEFAULT_CONFIG }) {
   const source = installSettingsSource(ctx, {
     namespace: PROMPT_ENHANCE_NAMESPACE,