dsh-code-server-app 0.3.57 → 0.3.59

package/assets/extensions/dshcs-editor-bridge/extension.js

@@ -13,13 +13,16 @@
 //      就什么都不做。状态栏不显示任何东西,更不弹通知。
 //   3. **绝不覆盖未保存改动**:agent 改了文件而该文档是脏的就只告警 + 给 diff,由用户决定。
 //
-// 「问 DSH」面板(0.2.0 起;0.2.3 起正文走 DSH 官方渲染器):
-//   - 提问走 `/ask`(host 侧以**用户输入**进对话);
-//   - 回答**不再是另一条通道**:host 用 `sessionController.follow` 把该会话的**新内容**
-//     投影成条目,随 `/sync` 的 `thread` 回来,面板用官方 markdown 渲染器显示
-//     (产物由 scripts/build-webview.mjs 打成 webview/thread.js + thread.css);
-//   - 授权(写工作区外文件 / 执行命令):host 的 `approvals` 字段回到面板,用户在面板上
-//     「允许一次 / 拒绝」,扩展调 `/approve` 提交(桥里唯一的非只读路由)。
+// 「问 DSH」对话框(0.2.0 起;0.3.59 起是**唯一**的提问 UI):
+//   - 提问:右键命令只向宿主上报意图(`POST /event {kind:'ask-open', mode}`),对话框开在 **DSH 页面**里;
+//     提问正文由插件的客户端半部经 `/api/code-server/ask/send` 投递(host 侧以**用户输入**进对话);
+//   - 回答:host 用 `sessionController.follow` 把该会话的**新内容**投影成条目,对话框轮询
+//     `/api/code-server/ask/state` 取回,面板用 DSH 官方 markdown 渲染器显示 —— 面板本体在客户端
+//     半部(lib/client.js):手写、不打包,直接用 DSH 页面模块表里那一份渲染器;
+//   - 授权(写工作区外文件 / 执行命令):host 把待决请求放进同一份状态,用户在对话框上
+//     「允许一次 / 拒绝」,客户端半部调 `/api/code-server/ask/approve` 提交;
+//   - 编辑器里**不再有**自己的提问面板:0.3.59 删掉了那份 webview 产物(thread.js/css),
+//     探测不到对话框心跳时只弹一条提示,不开一扇用户看不见的窗。
 //
 // 只依赖 `vscode` 与 Node 内置模块;纯逻辑在 lib/ 下且不 require('vscode'),便于单测。
 
@@ -27,7 +30,6 @@
 
 const vscode = require('vscode');
 const crypto = require('crypto');
-const fs = require('fs');
 const path = require('path');
 
 const {
@@ -37,14 +39,6 @@ const {
 } = require('./lib/bridge-client.js');
 const { createProjector } = require('./lib/context-model.js');
 const { chooseOldSide, createDiffCache, describeChange } = require('./lib/diff-model.js');
-const {
-  applySync,
-  createPanelState,
-  failPanel,
-  panelPayload,
-  pendingQuestion,
-  renderPanelHtml,
-} = require('./lib/ask-panel.js');
 
 /** 状态栏项(仅在桥连通时显示)。 */
 let statusBar = null;
@@ -56,16 +50,8 @@ let client = null;
 let pollTimer = null;
 /** 上次成功轮询的时间(状态栏 tooltip 用)。 */
 let lastPollAt = 0;
-/** 「问 DSH」面板:null = 没开。`{panel, state, mode}`(状态模型见 lib/ask-panel.js)。 */
-let askPanel = null;
-/** 宿主是否支持 DSH 页面里的悬浮对话框(0.2.5 探测;0.3.26 起不再自动启用)。 */
+/** 宿主是否已经把"对话框活着"证明给我们看(host 侧 askDialogLive:5 秒内收到过 /ask/state 轮询)。 */
 let askDialogSupported = false;
-/** 上一份对话流快照(host 只在变化时回传,这里兜住"没变化"的那些轮询)。 */
-let lastThreadSnapshot;
-/** 本扩展**当前持有**的对话流修订号(随请求上报;-1 = 一份都还没有 ⇒ host 必须发). */
-let lastThreadRev = -1;
-/** 扩展根目录(activate 时记下;面板要按它取 webview 产物 URI)。 */
-let extensionRoot = null;
 /** 是否已经确认过 host 端点可达(避免把"IDE 刚起、扩展先加载"误判为断线)。 */
 let connected = false;
 /** 诊断集合缓存:host 请求时现算,这里只做"有没有变化"的计数上报。 */
@@ -397,17 +383,6 @@ async function pollOnce() {
     }),
     diagnostics,
     at: Date.now(),
-    // 面板声明它要看哪个会话:host 据此对齐 `sessionController.follow` 订阅,
-    // 并用"有没有人在看"决定授权请求是先问面板还是直接交给 DSH 界面
-    // (见 host 侧 lib/bridge-thread.mjs / lib/bridge-approval.mjs)。
-    watch: askPanel !== null && askPanel.state.sessionId !== null ? [askPanel.state.sessionId] : [],
-    // 声明"本扩展懂对话流修订号"(0.2.9):host 才会在没变化时省略 thread 省流量。
-    // 不声明(旧扩展)时 host 照旧发整份快照 —— 否则旧扩展会误报"宿主没有对话流能力"。
-    threadRev: lastThreadRev,
-    // 声明"我这边能把授权卡片画出来"(0.3.30):面板开着 **且** 对话流正常(不是那条"宿主没有对话流能力"
-    // 的坏状态)。宿主只在它为 true 时才敢抢答授权 —— 否则"抢过来却没人看得见"就是用户遇到的
-    // "没弹出授权"(官方卡片被我们吞了,面板又不画)。
-    approvalsUi: askPanel !== null && askPanel.state.available === true,
   };
   const result = await client.sync(payload);
   if (result.ok !== true) {
@@ -429,28 +404,15 @@ async function pollOnce() {
     await handleEvent(event);
   }
   if ((result.events ?? []).length > 0) client.persist();
-  // 能力探测:宿主支持悬浮对话框(0.3.24)⇒ 右键提问不再开编辑器面板。
+  // 能力探测(0.3.24):宿主证明"DSH 页面里的对话框活着"⇒ 右键提问走 ask-open 事件。
+  // 0.3.59 起这是**唯一**的提问 UI(编辑器里的 webview 面板已退役):探测不到就只弹一条提示,
+  // 绝不退回到一扇用户看不见的窗。
   if (result.askDialog === true && !askDialogSupported) {
     askDialogSupported = true;
-    log('宿主支持 DSH 页面里的对话对话框(本版仍用编辑器面板,见 0.3.26 回退)');
-  }
-  // 对话流 + 授权待决:host 每趟把被观看会话的**新内容**与待决授权一起回来
-  // (见 host 侧 lib/bridge-thread.mjs / lib/bridge-approval.mjs),面板有变化才重画。
-  // 0.3.27 起 host **没变化就不带 thread**(省掉每 600ms 一份 ~1MB 的快照,那会把 /sync 拖成超时,
-  // 于是 approvals 也一起丢掉、卡片永远不出现)⇒ 这里沿用上一份快照。
-  if (askPanel !== null) {
-    const thread = result.thread !== undefined
-      ? result.thread
-      : (result.threadRev !== undefined ? lastThreadSnapshot : undefined);
-    if (result.thread !== undefined) lastThreadSnapshot = result.thread;
-    if (Number.isSafeInteger(result.threadRev)) lastThreadRev = result.threadRev;
-    // 刚开面板、手里还没有任何快照,而 host 说"没变化"(它只看到我们持有 -1)→ 等下一份,别误报
-    // "宿主没有对话流能力"(0.3.29)。
-    if (result.thread === undefined && lastThreadSnapshot === undefined) {
-      refreshAskPanel();
-      return;
-    }
-    if (applySync(askPanel.state, { ...result, thread })) refreshAskPanel();
+    log('宿主已证明「问 DSH」对话框活着:右键提问将打开 DSH 页面里的对话框');
+  } else if (result.askDialog !== true && askDialogSupported) {
+    askDialogSupported = false;
+    log('宿主不再报告对话框心跳(页面关了/刷新过):右键提问会给出提示');
   }
 }
 
@@ -504,152 +466,14 @@ function captureAskContext(mode) {
   };
 }
 
-/** 把状态推给面板(增量更新:输入框与滚动位置都不受影响)。 */
-function refreshAskPanel() {
-  if (askPanel === null) return;
-  void askPanel.panel.webview.postMessage(panelPayload(askPanel.state));
-}
-
-/** 面板进入错误态:状态行 + 最新一条本地提问都标上原因(绝不静默)。 */
-function failAskPanel(message) {
-  if (askPanel === null) return;
-  failPanel(askPanel.state, message);
+/** 提问对话框不可用时的提示(0.3.59 起不再退回编辑器面板 —— 那一半已退役)。 */
+function notifyAskDialogUnavailable() {
+  const message = '「问 DSH」对话框不可用:请在 DSH 页面里打开(或刷新)Code Server 标签后重试。';
   log(message);
-  refreshAskPanel();
-}
-
-/** 面板收到一条提问:投递到 DSH,**本地先乐观显示**,回答由 host 的对话流回填。 */
-async function sendAskFromPanel(text) {
-  if (askPanel === null || client === null) return;
-  // 用面板自己的意图(selection / file)取上下文:文件级提问永远不带行号。
-  const context = captureAskContext(askPanel.mode) ?? askPanel.state.context;
-  pendingQuestion(askPanel.state, text, context);
-  refreshAskPanel();
-  try {
-    const result = await client.ask({
-      text,
-      file: context === null ? null : context.file,
-      lineStart: context === null ? null : context.lineStart,
-      lineEnd: context === null ? null : context.lineEnd,
-      selection: context === null ? null : context.selection,
-      languageId: context === null ? null : context.languageId,
-    });
-    if (result.ok === true) {
-      askPanel.state.sessionId = typeof result.sessionId === 'string' ? result.sessionId : null;
-      askPanel.state.status = 'thinking';
-      log(`已投递编辑器消息(session=${result.sessionId ?? '?'})`);
-    } else {
-      failAskPanel(`未投递:${result.error ?? '未知原因'}`);
-      return;
-    }
-  } catch (error) {
-    const status = error && error.status;
-    failAskPanel(status === 409
-      ? 'DSH 里没有可投递的会话:请先在 DSH 里打开或新建一个会话。'
-      : (status === 401 || status === 503
-        ? '编辑器桥尚未就绪,请稍后重试。'
-        : `投递失败:${error && error.message ? error.message : error}`));
-    return;
-  }
-  refreshAskPanel();
-}
-
-/**
- * 面板对一条授权请求的决策 → `POST /approve`。
- *
- * 只接受白名单的两个值(host 侧同样只认这两个);失败必须说出来:面板里点不动的时候,
- * 用户唯一的线索就是这行状态/日志。
- */
-async function decideApproval(id, outcome) {
-  if (askPanel === null || client === null) return;
-  if (outcome !== 'allowed-once' && outcome !== 'rejected') return;
-  try {
-    await client.approve(id, outcome);
-    log(`面板授权决策已提交:${id} → ${outcome}`);
-  } catch (error) {
-    const status = error && error.status;
-    const message = status === 409
-      ? '这条授权请求已经过期或已被处理(DSH 界面里会弹同一张卡片)。'
-      : (status === 401 || status === 503
-        ? '编辑器桥尚未就绪,授权没有提交。'
-        : `授权提交失败:${error && error.message ? error.message : error}`);
-    // 卡片已经没意义了:本地撤掉,避免用户反复点。
-    askPanel.state.approvals = askPanel.state.approvals.filter((item) => item.id !== id);
-    failAskPanel(message);
-    return;
-  }
-  refreshAskPanel();
+  void vscode.window.showInformationMessage(message);
 }
 
-/**
- * 打开(或聚焦)「问 DSH」面板。
- * @param {'selection'|'file'} mode 提问意图(决定发送时带不带行号/选区),见 captureAskContext。
- */
-function openAskPanel(mode = 'selection') {
-  const contextInfo = captureAskContext(mode);
-  if (askPanel === null) {
-    // webview 产物是构建出来的(scripts/build-webview.mjs)。缺了就别开一个空白面板。
-    const webviewDir = vscode.Uri.joinPath(extensionRoot, 'webview');
-    const bundle = vscode.Uri.joinPath(webviewDir, 'thread.js');
-    const style = vscode.Uri.joinPath(webviewDir, 'thread.css');
-    if (!fs.existsSync(bundle.fsPath) || !fs.existsSync(style.fsPath)) {
-      const message = `面板产物缺失(${bundle.fsPath}):请重新安装插件,或在源码里跑 pnpm run build:webview`;
-      log(message);
-      void vscode.window.showErrorMessage(message);
-      return;
-    }
-    const panel = vscode.window.createWebviewPanel(
-      'dshAsk',
-      'DSH 对话',
-      // 对话框形状(0.2.4):开在**当前编辑器组**,占满工作台宽度 —— 不再用 `Beside` 挤成一条侧栏。
-      // 面板内容自己居中限宽,看起来就是编辑器上的一扇对话窗;右上角的 ✕ 关掉它。
-      { viewColumn: vscode.ViewColumn.Active, preserveFocus: false },
-      {
-        enableScripts: true,
-        retainContextWhenHidden: true,
-        // 只允许加载扩展自己的 webview 目录(产物 + 字体),不给别的本地文件开口子。
-        localResourceRoots: [webviewDir],
-      },
-    );
-    askPanel = { panel, state: createPanelState(), mode };
-    panel.webview.html = renderPanelHtml({
-      cspSource: panel.webview.cspSource,
-      nonce: crypto.randomBytes(16).toString('base64url'),
-      scriptUri: panel.webview.asWebviewUri(bundle).toString(),
-      styleUri: panel.webview.asWebviewUri(style).toString(),
-    });
-    panel.webview.onDidReceiveMessage((message) => {
-      if (message === null || typeof message !== 'object') return;
-      if (message.type === 'ready') {
-        refreshAskPanel();
-        return;
-      }
-      if (message.type === 'ask' && typeof message.text === 'string') {
-        const text = message.text.trim();
-        if (text !== '') void sendAskFromPanel(text);
-        return;
-      }
-      if (message.type === 'approve' && typeof message.id === 'string') {
-        void decideApproval(message.id, message.outcome);
-        return;
-      }
-      if (message.type === 'close') {
-        // 面板上的 ✕:关掉它(= 不再看这个会话 ⇒ 待决授权立刻交回 DSH 界面,不用干等窗口)。
-        panel.dispose();
-      }
-    });
-    panel.onDidDispose(() => {
-      askPanel = null;
-    });
-  }
-  askPanel.state.context = contextInfo;
-  askPanel.mode = mode;
-  // 已经开着就提到前面(对话框不重复开)。
-  askPanel.panel.reveal(vscode.ViewColumn.Active, false);
-  refreshAskPanel();
-}
-
-/** 选中内容 → DSH(编辑器→DSH 的主入口):打开面板并带上当前上下文。 */
+/** 选中内容 → DSH(编辑器→DSH 的主入口):请宿主打开对话框并带上当前上下文。 */
 async function askAboutSelection() {
   await openAskPanelFor('selection');
 }
@@ -659,7 +483,7 @@ async function askAboutFile() {
   await openAskPanelFor('file');
 }
 
-/** 两个命令的公共前置检查(桥可用 + 有活动编辑器)。 */
+/** 两个命令的公共前置检查(桥可用 + 有活动编辑器 + 对话框活着)。 */
 async function openAskPanelFor(mode) {
   if (client === null || client.isDormant()) {
     vscode.window.showInformationMessage('编辑器桥未启用:请在 DSH 里打开 Code Server 标签后重试。');
@@ -669,25 +493,27 @@ async function openAskPanelFor(mode) {
     vscode.window.showInformationMessage('没有活动的编辑器:请先打开一个文件。');
     return;
   }
-  // 0.3.26 回退:提问**始终**开编辑器里的 webview 面板。
-  // 0.2.5/0.2.6 试过"浮在 DSH 页面上的对话框",但实测在编辑器侧看不到授权卡片,而面板这条路是
-  // 验证过的(0.3.22/0.3.23 实测卡片就在面板里)。功能优先:先把能看、能批授权的 UI 还给用户;
-  // 对话框那套(client 半部 + /api/code-server/ask/*)留着但**不再自动启用**。
-  // 0.3.30:把悬浮对话框还回来(用户要的形态),但只在宿主证明客户端半部在轮询时才用
-  // (askDialogSupported 现在等于 askDialogLive());否则安静退回编辑器面板 —— 两条路都能看能批授权。
-  if (askDialogSupported) {
-    try {
-      const result = await client.askOpen(mode);
-      if (result !== null && result.ok === true) {
-        log('已请宿主打开悬浮对话框(mode=' + mode + ')');
-        return;
-      }
-      log('宿主没有打开对话框(' + (result !== null && result.error ? result.error : '未知原因') + ')→ 退回编辑器面板');
-    } catch (error) {
-      log('ask-open 失败(' + (error && error.message ? error.message : error) + ') → 退回编辑器面板');
+  // 0.3.59:提问 UI 只有一处 —— **DSH 页面里的悬浮对话框**(面板本体在插件客户端半部:手写、不打包,
+  // 直接用页面模块表里的官方渲染器)。编辑器里的 webview 面板已退役:那份 1.4MB 产物 + esbuild +
+  // 十几个打包依赖,只为了兜底一条"宿主证明不了对话框活着"的路 —— 而那种情况下用户在编辑器里
+  // 看到的其实也不是他想要的对话(而且我们在 0.3.30 之后就从没走到过那条路)。
+  // 所以现在:拿不到心跳就**明确说清怎么办**,不再开一扇看不见的窗。
+  if (!askDialogSupported) {
+    notifyAskDialogUnavailable();
+    return;
+  }
+  try {
+    const result = await client.askOpen(mode);
+    if (result !== null && result.ok === true) {
+      log(`已请宿主打开「问 DSH」对话框(mode=${mode})`);
+      return;
     }
+    log(`宿主没有打开对话框(${result !== null && result.error ? result.error : '未知原因'})`);
+    notifyAskDialogUnavailable();
+  } catch (error) {
+    log(`ask-open 失败(${error && error.message ? error.message : error})`);
+    notifyAskDialogUnavailable();
   }
-  openAskPanel(mode);
 }
 
 function showBridgeLog() {
@@ -700,9 +526,6 @@ function activate(context) {
   output = vscode.window.createOutputChannel('DSH Editor Bridge');
   context.subscriptions.push(output);
 
-  // 面板 webview 的产物按扩展根目录取 URI(0.2.3 起正文走官方渲染器,产物是打包出来的)。
-  extensionRoot = context.extensionUri;
-
   statusBar = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Right, 90);
   context.subscriptions.push(statusBar);
 

package/assets/extensions/dshcs-editor-bridge/lib/bridge-client.js

@@ -285,20 +285,12 @@ function createClient(options) {
         // 症状就是"每个 IDE 会话只收到第一条 diff")。退回 0 重新对齐即可自愈。
         const lastSeq = body !== null && Number.isSafeInteger(body.lastSeq) ? body.lastSeq : null;
         if (lastSeq !== null && lastSeq < since) since = 0;
-        // 0.2.3 起面板像 DSH 对话一样显示内容,数据走这三个字段(见 host 侧 lib/bridge-thread.mjs
-        // 与 lib/bridge-approval.mjs):
-        //   - thread:被面板观看的会话的**新内容**条目(旧版宿主没有这个字段 → 面板明确报错);
-        //   - approvals:待决授权请求(工作区外写入 / 命令执行),面板就地作答;
-        //   - uiVersion:DSH 界面的版本(面板据此提示"渲染器与界面版本不一致")。
-        // 全部原样透传,解析与合并交给 lib/ask-panel.js 的纯模型。
+        // 0.3.59:对话流 / 待决授权**不再经这条通道**(那是编辑器 webview 面板时代的分工)。
+        // 现在唯一的面板在 DSH 页面里、由插件的客户端半部直接读 `/api/code-server/ask/state`,
+        // 扩展这边只留下能力位:宿主有没有证明"对话框活着"。
         return {
           ok: true,
           events,
-          thread: body !== null && body.thread !== undefined ? body.thread : undefined,
-          approvals: body !== null && Array.isArray(body.approvals) ? body.approvals : [],
-          approvalHoldMs: body !== null && Number.isSafeInteger(body.approvalHoldMs) ? body.approvalHoldMs : undefined,
-          uiVersion: body !== null && typeof body.uiVersion === 'string' ? body.uiVersion : undefined,
-          // 能力探测(0.3.24):宿主支持 DSH 页面里的悬浮对话框 ⇒ 提问改走 ask-open 事件(不开 webview 面板)。
           askDialog: body !== null && body.askDialog === true,
         };
       } catch (error) {
@@ -316,35 +308,11 @@ function createClient(options) {
         body: JSON.stringify({ kind: 'ask-open', mode: mode === 'file' ? 'file' : 'selection' }),
       });
     },
-    /** 把"选中内容 + 问题"投给 DSH 的当前会话。 */
-    async ask(payload) {
-      return request(`${BRIDGE_BASE}/ask`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify(payload),
-      });
-    },
-    /**
-     * 回答一条待决的授权请求(桥里**唯一**的非只读路由)。
-     *
-     * 约束在 host 侧写死:只认本进程发起、仍未决的 id(单次使用),outcome 只接受
-     * `allowed-once` / `rejected`,不接受任何自由文本 —— 这条路由只能"回答问题",不能"发起动作"。
-     *
-     * @param {string} id 授权请求 id(来自 /sync 的 approvals)
-     * @param {'allowed-once'|'rejected'} outcome
-     */
-    async approve(id, outcome) {
-      return request(`${BRIDGE_BASE}/approve`, {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ id, outcome }),
-      });
-    },
     /**
      * 取一份"写前原文"快照(0.3.55):事件里带的是不透明 key,文本单独取。
      *
-     * 为什么不让事件直接带文本:host 每 600ms 的 `/sync` 响应还驮着对话流与待决授权,
-     * 塞进 ~1MB 文本会把那一趟拖成超时(超时 ⇒ approvals 一起丢 ⇒ 授权卡片永远不出现)。
+     * 为什么不把文本塞进事件:一趟 /sync 要驮的东西越少越好 —— 塞进 ~1MB 文本会把那一趟拖成超时,
+     * 而超时意味着事件也一起丢(用户看到的症状就是"diff 不弹")。
      *
      * 取不到(404 = 过期/被淘汰/宿主重启)时**返回 null 而不是抛**:调用方据此回退到缓冲区或缓存。
      *

package/assets/extensions/dshcs-editor-bridge/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dshcs-editor-bridge",
   "displayName": "DSH Editor Bridge",
-  "description": "只读地把编辑器状态(未保存缓冲区、诊断、活动选区)提供给 DSH;右键提问打开 DSH 页面里的悬浮对话对话框(0.2.5;老宿主退回编辑器面板),正文/思考/上下文都用 DSH 官方渲染器,并可就地回答授权请求。由 dsh-code-server-app 插件安装,可禁用。",
-  "version": "0.2.17",
+  "description": "只读地把编辑器状态(未保存缓冲区、诊断、活动选区)提供给 DSH;右键提问打开 DSH 页面里的悬浮对话对话框(0.3.59 起是唯一路径:面板在插件客户端半部,正文/思考/上下文都用页面模块表里的官方渲染器,并可就地回答授权请求;拿不到对话框心跳时只给一条提示)。由 dsh-code-server-app 插件安装,可禁用。",
+  "version": "0.2.18",
   "publisher": "dsh-code-server-app",
   "license": "MIT",
   "private": true,

package/lib/bridge-session.mjs

@@ -140,6 +140,37 @@ export function pickAgent(ctx) {
   return null;
 }
 
+/**
+ * 忙碌时按 Enter 的投递方式 —— **跟着 DSH 自己的设置走**。
+ *
+ * DSH 的对话插件把这个偏好放在 `ui-conversation` 命名空间的 `busyEnter` 字段
+ * (`dsh-client-ui-conversation` 契约:`BUSY_ENTER_BEHAVIORS = ['queue','steer']`,默认 `'queue'`),
+ * 用户在 设置 → 对话 里改的就是它。面板里按 Enter 与主界面按 Enter 是同一个手势,所以这里读同一个值:
+ *   - `'steer'` ⇒ `agent.steer(msg)`(DSH 契约:"an idle driver starts a turn; a running driver
+ *     consumes it at its **next step boundary**")—— 正在跑的那一轮就能看到你的追问;
+ *   - `'queue'` ⇒ `agent.followup(msg)`(契约:"becomes the sole ordinary message of **its own turn**")
+ *     —— 排到下一轮,不打扰当前轮。
+ *
+ * 读法走官方 API `ctx.settings.get(ns)`(宿主侧 `@deepseek-ai/dsh-settings` 的契约:
+ * "Read one registered namespace's resolved value")。读不到(命名空间没注册 / 极简组合 / 老版本 DSH)
+ * 一律回默认 `'queue'`,并且**逐项特性探测** `agent.steer` 是否存在 —— 探测失败绝不抛。
+ *
+ * @param {object} ctx cordis 上下文
+ * @returns {'queue'|'steer'}
+ */
+export function pickBusyEnter(ctx) {
+  const settings = getService(ctx, 'settings');
+  if (settings === undefined || settings === null || typeof settings.get !== 'function') return 'queue';
+  try {
+    const section = settings.get('ui-conversation');
+    const value = section !== null && typeof section === 'object' ? section.busyEnter : undefined;
+    return value === 'steer' ? 'steer' : 'queue';
+  } catch {
+    // 未注册的命名空间在多数实现里是 undefined,但契约允许实现抛 —— 一律当默认值
+    return 'queue';
+  }
+}
+
 /**
  * 投递一条编辑器消息。
  *
@@ -148,9 +179,10 @@ export function pickAgent(ctx) {
  *
  * @param {object} ctx cordis 上下文
  * @param {object} input `composeEditorPrompt` 的输入
- * @returns {Promise<{ok: boolean, code?: string, error?: string, sessionId?: string, text?: string}>}
+ * @param {{delivery?: 'queue'|'steer'}} [options] 投递方式(缺省按 DSH 设置推导,见 pickBusyEnter)
+ * @returns {Promise<{ok: boolean, code?: string, error?: string, sessionId?: string, text?: string, delivery?: string}>}
  */
-export async function deliverEditorPrompt(ctx, input) {
+export async function deliverEditorPrompt(ctx, input, options = {}) {
   const createUserMessage = await loadDshExport('@deepseek-ai/dsh-llm', 'createUserMessage');
   if (typeof createUserMessage !== 'function') {
     return { ok: false, code: 'NO_LLM', error: '解析不到 @deepseek-ai/dsh-llm 的 createUserMessage(DSH 部署不完整?)' };
@@ -174,9 +206,24 @@ export async function deliverEditorPrompt(ctx, input) {
   } catch (err) {
     return { ok: false, code: 'BAD_MESSAGE', error: `构造消息失败:${err && err.message ? err.message : String(err)}` };
   }
+  // 请求方可以显式指定(queue/steer);没指定就跟着 DSH 的 `ui-conversation.busyEnter` 走。
+  const requested = options.delivery === 'steer' || options.delivery === 'queue' ? options.delivery : null;
+  const busy = agent.status === 'running';
+  let delivery = requested ?? pickBusyEnter(ctx);
+  // 空闲时两者等价(DSH 契约:steer 在空闲驱动上同样"starts a turn"),但**空闲一律走 followup** ——
+  // 语义最直白,也不依赖 steer 存在。
+  if (!busy) delivery = 'queue';
+  // steer 是 0.3.59 才用到的 API:老宿主没有它时静默退回 queue,绝不因为"设置里写了 steer"就投不出去。
+  if (delivery === 'steer' && typeof agent.steer !== 'function') delivery = 'queue';
   try {
-    // followup = 下一轮 + 唤醒:agent 空闲就立刻开一轮,在跑就排队,两种情况用户都能看到。
-    agent.followup(message);
+    if (delivery === 'steer') {
+      // steer = "Submit steering for the nearest step":正在跑的那一轮会在下一个 step 边界领取它,
+      // 所以追问能当轮被看到(而不是等下一轮)。
+      agent.steer(message);
+    } else {
+      // followup = 下一轮 + 唤醒:agent 空闲就立刻开一轮,在跑就排队,两种情况用户都能看到。
+      agent.followup(message);
+    }
   } catch (err) {
     return { ok: false, code: 'DELIVER_FAILED', error: `投递失败:${err && err.message ? err.message : String(err)}` };
   }
@@ -185,5 +232,8 @@ export async function deliverEditorPrompt(ctx, input) {
     : (agent.id ?? null);
   // `agent` 是给调用方用的**内部句柄**(授权拦截要拿 `agent.ctx` 注册 agent 作用域监听),
   // 路由返回前必须剥掉:它不可 JSON 序列化,也不该泄漏进编辑器。
-  return { ok: true, sessionId, text, agent };
+  // `delivery` + `busy` 一并回去:面板据此说清这条追问会怎么被处理 ——
+  // 只看 delivery 会把**空闲**时的 followup 误报成"排到下一轮"(实测踩到:空闲时发一条,
+  // 面板却写"当前轮结束后…",而当时根本没有当前轮,消息是立刻开的新一轮)。
+  return { ok: true, sessionId, text, delivery, busy, agent };
 }

package/lib/bridge.mjs

@@ -29,18 +29,22 @@
  * 挂 `webServer` 前缀(0.3.9–0.3.12)则只有 web profile 有 webServer,desktop 根本没有 HTTP 面。
  * 桥两端本来就是同一台机器上的两个进程,所以传输用本机 IPC,鉴权仍走独立令牌:
  *
- * ## 安全不变量(改这个文件之前先读这四条)
+ * ## 安全不变量(改这个文件之前先读这几条)
  *
- * 1. **`BRIDGE_BASE`(`/code-server-bridge`)命名空间只读**,只有一个写例外:`POST /approve`
- *    (0.3.22,见下)。其余一律不允许出现写文件、改文档、执行命令、拉起进程的路由 ——
- *    `bridge.json` 里那个令牌对本机同用户进程可读,爆炸半径必须封在"泄露编辑器里的信息",
- *    绝不能变成任意文件写 / 任意命令执行。
- * 2. **`/approve` 的四条约束(缺一条就等于开了任意命令执行的后门,不许放宽)**:
+ * 1. **`BRIDGE_BASE`(`/code-server-bridge`)命名空间**只有四条路由,而且**全部只读**:
+ *    `/health`(无鉴权探活)、`/sync`(上报编辑器状态 + 取事件)、`/old`(取写前原文快照)、
+ *    `/event`(上报意图,如"请宿主打开对话框")。这里**不允许**出现写文件、改文档、执行命令、
+ *    拉起进程的路由 —— `bridge.json` 里那个令牌对本机同用户进程可读,爆炸半径必须封在
+ *    "泄露编辑器里的信息",绝不能变成任意文件写 / 任意命令执行。
+ *    提问与授权答复不走这里:它们在 DSH 同源的 `/api/code-server/ask/*` 上,调用方是 DSH 页面里的
+ *    插件客户端(吃 DSH 自己的 cookie/Origin 校验)。
+ * 2. **授权答复的四条约束**(在 `/api/code-server/ask/approve` 上,缺一条就等于开了任意命令执行的后门,
+ *    不许放宽):
  *    (a) 它只能**回答**已经存在的授权请求,不能发起任何动作 —— 请求体只有 `{id, outcome}`,
  *        不接受自由文本 / 路径 / 命令参数;
  *    (b) `id` 必须是本进程自己发起、且**仍未决**的请求(用后即废,单次使用);
  *    (c) `outcome` 只接受 `allowed-once` / `rejected` 两个白名单值,没有"永久允许";
- *    (d) 没有面板在看 / 窗口超时(默认 8s)→ **交回官方链路**,绝不自动放行(DSH 的
+ *    (d) 对话框没在看 / 窗口超时(默认 5 分钟)→ **交回官方链路**,绝不自动放行(DSH 的
  *        `approval/request` 本身 fail closed,这里只能把"没人答"保持成"没人答")。
  * 3. **带 `Origin` 的请求一律 403。** 浏览器发起的请求必带 Origin,扩展宿主进程不带。
  *    这条只排除浏览器,不误伤扩展(也顺带挡住 CSRF / DNS rebinding 这类"用你的浏览器打本机端口")。

package/lib/claim-types.js

@@ -12,8 +12,10 @@
  *   !md          不认领 .md(排除优先于认领)
  * 空文本 = 不认领任何文件类型(只保留页面 tab,文件点击全部落回 DSH 预览)。
  *
- * 本模块是 host(`lib/index.js` 的 Config 默认值)与 client(`src/factory.js` 的 canOpen)的
- * **同一份** 事实来源,随 npm 包一起发布(见 package.json 的 files),避免两边默认值漂移。
+ * 本模块是 host(`lib/index.js` 的 Config 默认值与工具实现)的**事实来源**,随 npm 包一起发布
+ * (见 package.json 的 files),避免两边默认值漂移。
+ * 客户端半部 `lib/client.js` 里有一份**内联副本**(经典脚本拿不到 host 模块,见那个文件的
+ * "认领类型"段),两份逐字等价由 scripts/test-client-entry.mjs 的 E2 守卫钉住 —— 改这里必须同步改那边。
  * 纯字符串逻辑,不碰文件系统 → 可离线单测(scripts/test-claim-types.mjs)。
  */