dsh-code-server-app 0.3.58 → 0.3.63

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 {
@@ -36,15 +38,18 @@ const {
   createClient,
 } = 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');
+  FIM_DEBOUNCE_DEFAULT_MS,
+  shouldRequest,
+  buildPayload,
+  fingerprint,
+  createCompletionCache,
+  formatTokens,
+  describeFimUsage,
+  matchDisabledGlob,
+  toSingleLine,
+} = require('./lib/fim-completion.js');
+const { chooseOldSide, createDiffCache, describeChange } = require('./lib/diff-model.js');
 
 /** 状态栏项(仅在桥连通时显示)。 */
 let statusBar = null;
@@ -56,16 +61,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 请求时现算,这里只做"有没有变化"的计数上报。 */
@@ -79,6 +76,119 @@ const diffTextStore = new Map();
 /** 同一个文件的 diff tab 不重复开。 */
 const openDiffTabs = new Map();
 
+// ---------------------------------------------------------------- FIM(幽灵)补全:实验性
+//
+// 这条能力**只在宿主说 enabled=true 时才注册 provider**(宿主的 /sync 每趟都带上来),
+// 所以"设置里没开"不会让编辑器每敲一个字就发一次注定被拒的请求。
+//
+// 三条与宿主一致的分工:
+//   - **该不该问**在这里判(纯逻辑 shouldRequest):不值得问的位置根本不发请求 ——
+//     实测模型在被问到"不该补的地方"时会硬凑(2/2),所以判据必须前置;
+//   - **问什么**在这里裁(窗口内的前后文),宿主侧再兜一层同样的上限;
+//   - **问过没有**用本地缓存答(相同前后文 + 语言)。
+/** 宿主报来的 FIM 状态与用量({enabled:false} 表示设置里没开)。 */
+let fimSnapshot = { enabled: false };
+/** 已注册的 provider disposer(null = 未注册)。 */
+let fimProvider = null;
+/** 扩展上下文(activate 里赋值):provider 需要在轮询里注册/注销,而轮询拿不到 context 参数。 */
+let extensionContext = null;
+/** 前后文 → 补全文本 的有界缓存。 */
+const fimCache = createCompletionCache();
+
+/** 取消感知的停顿:打字过程中的请求全丢掉(宿主侧也有速率闸,但那是最后一道)。
+ *  停顿毫秒数由设置在宿主侧提供(0.3.62),每趟 /sync 带上来;拿不到就用默认值。 */
+async function fimWait(token) {
+  const configured = Number.isFinite(fimSnapshot.debounceMs) ? fimSnapshot.debounceMs : FIM_DEBOUNCE_DEFAULT_MS;
+  const deadline = Date.now() + configured;
+  while (Date.now() < deadline) {
+    if (token.isCancellationRequested === true) return false;
+    // 40ms 一跳:足够细,且不会为一次补全拉起一串定时器。
+    await new Promise((resolve) => setTimeout(resolve, 40));
+  }
+  return token.isCancellationRequested !== true;
+}
+
+/** 取光标前后的窗口(只按行取,不把整份文档摸一遍 —— 大文件上每次击键都 getText() 是灾难)。 */
+function fimWindows(document, position) {
+  const startLine = Math.max(0, position.line - 120);
+  const endLine = Math.min(document.lineCount - 1, position.line + 40);
+  const prefixText = document.getText(new vscode.Range(new vscode.Position(startLine, 0), position));
+  const afterEnd = document.lineAt(endLine).range.end;
+  const suffixText = document.getText(new vscode.Range(position, afterEnd));
+  const lineTextBefore = document.lineAt(position.line).text.slice(0, position.character);
+  return { prefixText, suffixText, lineTextBefore };
+}
+
+/** 内联补全 provider。返回 null = 这次不补(与"补一个空串"是两回事)。 */
+function createFimProvider() {
+  return {
+    async provideInlineCompletionItems(document, position, _context, token) {
+      if (fimSnapshot.enabled !== true) return null;
+      const editor = vscode.window.activeTextEditor;
+      const windows = fimWindows(document, position);
+      const decision = shouldRequest({
+        selectionEmpty: editor === undefined || editor === null ? true : editor.selection.isEmpty,
+        scheme: document.uri.scheme,
+        lineCount: document.lineCount,
+        prefixText: windows.prefixText,
+        suffixText: windows.suffixText,
+        lineTextBefore: windows.lineTextBefore,
+      });
+      if (decision.ask !== true) return null;
+      const payload = buildPayload({
+        prefixText: windows.prefixText,
+        suffixText: windows.suffixText,
+        language: document.languageId,
+        path: document.uri.scheme === 'file' ? document.uri.fsPath : document.uri.toString(),
+      });
+      // 按 glob 禁用(0.3.62):**在发请求之前**判 —— 这是这一层存在的主要理由(不花冤枉钱)。
+      // 宿主侧还会再判一次(服务端那道),所以即使这里漏了也不会真的发出去。
+      const blocked = matchDisabledGlob(payload.path, fimSnapshot.disableGlobs);
+      if (blocked !== null) return null;
+      const key = fingerprint(payload.prompt, payload.suffix, payload.language);
+      const cached = fimCache.get(key);
+      if (cached !== null) {
+        return cached === '' ? null : [new vscode.InlineCompletionItem(cached, new vscode.Range(position, position))];
+      }
+      if ((await fimWait(token)) !== true) return null;
+      if (client === null || client.isDormant()) return null;
+      if (typeof client.complete !== 'function') return null;
+      const result = await client.complete(payload);
+      if (token.isCancellationRequested === true) return null;
+      if (result.ok !== true) {
+        if (result.status !== 409 && result.status !== 429) log(`补全失败:${result.error ?? '未知'}(status=${result.status ?? 0})`);
+        return null;
+      }
+      // 多行关掉时宿主已经裁过一道;这里再裁一次是防"宿主版本比扩展旧"(随包分发的静态文件可能不同步)。
+      const raw = typeof result.text === 'string' ? result.text : '';
+      const text = fimSnapshot.multiline === false ? toSingleLine(raw) : raw;
+      fimCache.set(key, text);
+      if (text.trim() === '') return null; // 模型说"这里不用补"是合法回答
+      log(`补全 ${text.length} 字符(${result.ms ?? '?'}ms,缓存${result.usage?.cacheReadTokens ?? 0} tok)`);
+      return [new vscode.InlineCompletionItem(text, new vscode.Range(position, position))];
+    },
+  };
+}
+
+/** 按宿主状态注册/注销 provider(状态翻转时才动)。 */
+function syncFimProvider() {
+  const want = fimSnapshot.enabled === true;
+  if (want && fimProvider === null) {
+    fimProvider = vscode.languages.registerInlineCompletionItemProvider({ pattern: '**' }, createFimProvider());
+    if (extensionContext !== null) extensionContext.subscriptions.push(fimProvider);
+    log('FIM 补全(实验性)已启用:开始提供内联补全');
+  } else if (!want && fimProvider !== null) {
+    try {
+      fimProvider.dispose();
+    } catch {
+      // 已被 VS Code 回收
+    }
+    fimProvider = null;
+    fimCache.clear();
+    log('FIM 补全已关闭:不再提供内联补全');
+  }
+}
+
 /** 把"改动前的文本"登记进 store,返回它的 docId。 */
 function registerDiffText(text) {
   const docId = crypto.createHash('sha256').update(text ?? '').digest('hex');
@@ -397,17 +507,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 +528,22 @@ async function pollOnce() {
     await handleEvent(event);
   }
   if ((result.events ?? []).length > 0) client.persist();
-  // 能力探测:宿主支持悬浮对话框(0.3.24)⇒ 右键提问不再开编辑器面板。
+  // FIM(实验性):宿主每趟带状态与用量上来。只在**翻转**时注册/注销 provider,
+  // 但状态栏每趟都刷 —— 用户要看到的是"这轮补全花了多少 token",它一直在变。
+  const nextFim = result.fim !== null && typeof result.fim === 'object' ? result.fim : { enabled: false };
+  const wasEnabled = fimSnapshot.enabled === true;
+  fimSnapshot = nextFim;
+  if ((nextFim.enabled === true) !== wasEnabled) syncFimProvider();
+  updateStatusBar();
+  // 能力探测(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('宿主不再报告对话框心跳(页面关了/刷新过):右键提问会给出提示');
   }
 }
 
@@ -468,8 +561,23 @@ function startPolling(context) {
 function updateStatusBar() {
   if (statusBar === null) return;
   if (connected && client !== null && client.config !== null) {
-    statusBar.text = '$(plug) DSH';
-    statusBar.tooltip = `编辑器桥已连接:${client.config.pipe}\n上次轮询:${lastPollAt === 0 ? '—' : new Date(lastPollAt).toLocaleTimeString()}\n点击查看日志`;
+    // FIM(实验性)开着时,状态栏多一格 token 计数 —— 这条链路的调用**不进 DSH 的计量**
+    // (一次性调用不是 loop 请求,不进会话日志 ⇒ token-meter 看不到它),所以这里是用户唯一能看到
+    // "补全花了多少"的地方(设置卡里也有同样一份,见 README)。
+    const fimOn = fimSnapshot !== null && fimSnapshot.enabled === true;
+    const used = fimOn ? Number(fimSnapshot.totalTokens ?? 0) : 0;
+    statusBar.text = fimOn
+      ? (used > 0 ? `$(plug) DSH $(zap) ${formatTokens(used)}` : '$(plug) DSH $(zap)')
+      : '$(plug) DSH';
+    const lines = [
+      `编辑器桥已连接:${client.config.pipe}`,
+      `上次轮询:${lastPollAt === 0 ? '—' : new Date(lastPollAt).toLocaleTimeString()}`,
+      '',
+      ...describeFimUsage(fimSnapshot),
+      '',
+      '点击查看日志',
+    ];
+    statusBar.tooltip = lines.join('\n');
     statusBar.command = 'dsh-code-server.showBridgeLog';
     statusBar.show();
   } else {
@@ -504,152 +612,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();
+  void vscode.window.showInformationMessage(message);
 }
 
-/** 面板收到一条提问:投递到 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();
-}
-
-/**
- * 打开(或聚焦)「问 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 +629,7 @@ async function askAboutFile() {
   await openAskPanelFor('file');
 }
 
-/** 两个命令的公共前置检查(桥可用 + 有活动编辑器)。 */
+/** 两个命令的公共前置检查(桥可用 + 有活动编辑器 + 对话框活着)。 */
 async function openAskPanelFor(mode) {
   if (client === null || client.isDormant()) {
     vscode.window.showInformationMessage('编辑器桥未启用:请在 DSH 里打开 Code Server 标签后重试。');
@@ -669,25 +639,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() {
@@ -697,12 +669,10 @@ function showBridgeLog() {
 // ---------------------------------------------------------------- 激活
 
 function activate(context) {
+  extensionContext = 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

@@ -35,6 +35,9 @@ const STATE_FILENAME = 'extension-state.json';
 // 请求超时(0.2.8 起 8s):3s 在实测里太紧 —— 对话流快照一大,宿主序列化就要几秒,
 // 超时会让扩展**丢整份响应**(包括 approvals),表现就是"授权卡片一直不出现"。
 const REQUEST_TIMEOUT_MS = 8000;
+/** 补全请求的超时:**独立且更短**。宿主侧自己在 4s 放弃,这里给 6s 只是别先于宿主超时 ——
+ *  补全的价值在"比你打字快",8s 那个值对它毫无意义,而挂住的请求会挡住下一次补全。 */
+const COMPLETE_TIMEOUT_MS = 6000;
 /** 轮询间隔:host 侧事件只是"去看一眼这个文件"的提示,600ms 足够且几乎无开销。 */
 const POLL_INTERVAL_MS = 600;
 /** 宿主配置重读间隔(端点/令牌轮换后最多这么久恢复)。 */
@@ -285,21 +288,16 @@ 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,
+          // FIM(实验性)状态与用量:宿主每趟都带上来,扩展据此决定"要不要注册补全 provider"
+          // 以及状态栏上那串数字怎么显示。没开时是 {enabled:false}(不是 null)。
+          fim: body !== null && typeof body.fim === 'object' && body.fim !== null ? body.fim : { enabled: false },
         };
       } catch (error) {
         return { ok: false, error: error.message, status: error.status, code: error.code };
@@ -316,35 +314,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 而不是抛**:调用方据此回退到缓冲区或缓存。
      *
@@ -360,11 +334,40 @@ function createClient(options) {
         return null;
       }
     },
+    /**
+     * 求一次 FIM(幽灵)补全(实验性)。
+     *
+     * **不抛**:补全失败是常态(没开、太快、模型抽风),抛异常会让 provider 每次都写错误日志。
+     * 返回值统一是 `{ok, text?, usage?, ms?, error?, status?}` —— 调用方只看 `ok`。
+     * 超时是独立的短超时(宿主侧 4s 就放弃了,这里给到 6s 只是别先于宿主超时)。
+     */
+    async complete(payload) {
+      try {
+        const body = await requestImpl({
+          socketPath: (refreshConfig(true) ?? {}).pipe,
+          path: `${BRIDGE_BASE}/complete`,
+          method: 'POST',
+          headers: { [TOKEN_HEADER]: config === null ? '' : config.token, 'content-type': 'application/json' },
+          body: JSON.stringify(payload),
+          timeoutMs: COMPLETE_TIMEOUT_MS,
+        });
+        if (body === null || typeof body !== 'object') return { ok: false, error: '空响应' };
+        const status = body.status === undefined ? 0 : body.status;
+        if (status < 200 || status >= 300) {
+          const reason = body.json !== null && typeof body.json.error === 'string' ? body.json.error : `HTTP ${status}`;
+          return { ok: false, error: reason, status };
+        }
+        const json = body.json === null || typeof body.json !== 'object' ? {} : body.json;
+        if (json.ok !== true) return { ok: false, error: typeof json.error === 'string' ? json.error : '宿主未返回补全', status };
+        return { ok: true, text: typeof json.text === 'string' ? json.text : '', usage: json.usage ?? null, ms: json.ms ?? null };
+      } catch (error) {
+        return { ok: false, error: error && error.message ? error.message : String(error), status: error && error.status };
+      }
+    },
     /** 把游标落盘(实例重启后不重复播报旧事件)。 */
     persist() {
       return writeState(extensionsDir, { since, pid: config === null ? null : config.pid });
-    },
-    /** 从磁盘恢复游标(实例没换才生效)。 */
+    },    /** 从磁盘恢复游标(实例没换才生效)。 */
     restore() {
       const saved = readState(extensionsDir);
       if (config !== null && saved.pid === config.pid) since = saved.since;
@@ -383,6 +386,7 @@ module.exports = {
   POLL_INTERVAL_MS,
   CONFIG_REREAD_MS,
   REQUEST_TIMEOUT_MS,
+  COMPLETE_TIMEOUT_MS,
   BridgeError,
   isBridgeEndpoint,
   defaultExtensionsDir,