dsh-code-server-app 0.3.59 → 0.3.65

package/assets/extensions/dshcs-editor-bridge/lib/fim-completion.js

@@ -0,0 +1,264 @@
+// dshcs-editor-bridge / lib/fim-completion.js —— 纯逻辑:FIM 补全的请求决策与载荷构造
+//
+// 来源与许可:本文件**为独立实现,不含 continuedev/continue 的源码**;其门控/窗口/缓存的设计与
+// 设置项划分**参考**了该项目(Apache License 2.0, Copyright 2023 Continue)。详见 `THIRD_PARTY_NOTICES.md`。
+//
+// **不 require('vscode')**:入参都是纯文本/数字,所以能在没有 VS Code 的环境里单测
+// (scripts/test-fim.mjs 就是这么用的)。与编辑器交互的部分在 extension.js(glue)里。
+//
+// 这个文件回答三个问题(顺序就是补全一次要过的三关):
+//   1. **该不该问**(`shouldRequest`)—— 模型在被问到"不该补的地方"时会硬凑(实测 2/2),
+//      所以"不值得问"必须在**发请求之前**判掉,而不是拿到回答再丢;
+//   2. **问什么**(`buildPayload`)—— 只送光标附近的窗口,不是整份文件;
+//   3. **问过没有**(`createCompletionCache`)—— 同样的前后文重复问是纯浪费(实测 temperature=0
+//      下两次回答逐字相同 ⇒ 缓存命中率会很高)。
+//
+// 窗口常量与宿主侧 `lib/fim-adapter.mjs` **同名同值**:扩展是随包分发的静态文件、不能 import
+// 宿主代码,所以一致性靠 scripts/test-fim.mjs 的断言钉住(与 bridge-client.js 的桥常量同一套做法)。
+
+'use strict';
+
+/** 与宿主 lib/fim-adapter.mjs 保持一致(改一边就要改另一边,测试会拦)。 */
+const FIM_MAX_PREFIX_CHARS = 6000;
+const FIM_MAX_SUFFIX_CHARS = 2000;
+const FIM_MAX_PREFIX_LINES = 120;
+const FIM_MAX_SUFFIX_LINES = 40;
+
+/** 停顿多久才真的发请求(毫秒)。打字过程中的请求全是浪费,而且会被宿主的速率闸挡掉。 */
+const FIM_DEBOUNCE_MS = 250;
+
+/** 超过这个行数的文档不参与补全(大文件里补全的收益低;用行数而不是字符数是为了避免
+ *  每次击键都 `document.getText()` 把整份文档摸一遍)。 */
+const FIM_MAX_DOCUMENT_LINES = 20000;
+
+/** 缓存条目上限与有效期(键 = 前后文指纹;命中直接给结果,不再问模型)。 */
+const FIM_CACHE_MAX = 24;
+const FIM_CACHE_TTL_MS = 120000;
+
+/** 把文本裁到窗口内(与宿主侧 `trimWindow` 同语义:字符与行数取先到者)。 */
+function trimWindow(text, maxChars, maxLines, fromEnd) {
+  if (typeof text !== 'string' || text === '') return '';
+  let out = text;
+  if (maxLines > 0) {
+    const split = out.split('\n');
+    if (split.length > maxLines) out = (fromEnd ? split.slice(split.length - maxLines) : split.slice(0, maxLines)).join('\n');
+  }
+  if (maxChars > 0 && out.length > maxChars) out = fromEnd ? out.slice(out.length - maxChars) : out.slice(0, maxChars);
+  return out;
+}
+
+/**
+ * 该不该为这次光标位置请求补全。
+ *
+ * 判据都是"**便宜且不会错判**"的那些 —— 宁可不补,也不要补错(补错一次,用户就关掉它)。
+ *
+ * @param {{selectionEmpty: boolean, scheme: string, lineCount: number,
+ *          prefixText: string, suffixText: string, lineTextBefore: string}} input
+ * @returns {{ask: boolean, reason: string}}
+ */
+function shouldRequest(input) {
+  const value = input === null || input === undefined ? {} : input;
+  if (value.selectionEmpty !== true) return { ask: false, reason: '有选区(用户在选中内容,不是在打字)' };
+  if (value.scheme !== 'file') return { ask: false, reason: `非文件文档(${value.scheme ?? '未知'})` };
+  if (!(Number.isFinite(value.lineCount) && value.lineCount > 0)) return { ask: false, reason: '空文档' };
+  if (value.lineCount > FIM_MAX_DOCUMENT_LINES) return { ask: false, reason: '文档过大' };
+  if (typeof value.prefixText !== 'string' || typeof value.suffixText !== 'string') return { ask: false, reason: '拿不到前后文' };
+  // 光标前整行都是空白、且前面也没有内容 ⇒ 没什么可续的(新建的空文件、文件开头按回车)。
+  if (typeof value.lineTextBefore === 'string' && value.lineTextBefore.trim() === '') {
+    if (value.prefixText.trim() === '' && value.suffixText.trim() === '') return { ask: false, reason: '空上下文' };
+  }
+  return { ask: true, reason: 'ok' };
+}
+
+/** 前后文的指纹(缓存键):只看窗口内的内容,与路径/语言一起构成键。 */
+function fingerprint(prefix, suffix, language) {
+  const text = `${language ?? ''}\u0000${prefix ?? ''}\u0000${suffix ?? ''}`;
+  let hash = 2166136261;
+  for (let i = 0; i < text.length; i += 1) {
+    hash ^= text.charCodeAt(i);
+    hash = Math.imul(hash, 16777619);
+  }
+  return `${text.length}:${(hash >>> 0).toString(36)}`;
+}
+
+/**
+ * 构造发往宿主的载荷(只含窗口内的前后文)。
+ * @returns {{prompt: string, suffix: string, language: string, path: string}}
+ */
+function buildPayload({ prefixText, suffixText, language, path }) {
+  return {
+    prompt: trimWindow(prefixText ?? '', FIM_MAX_PREFIX_CHARS, FIM_MAX_PREFIX_LINES, true),
+    suffix: trimWindow(suffixText ?? '', FIM_MAX_SUFFIX_CHARS, FIM_MAX_SUFFIX_LINES, false),
+    language: typeof language === 'string' ? language : '',
+    path: typeof path === 'string' ? path : '',
+  };
+}
+
+/** 有界 + 带 TTL 的结果缓存。 */
+function createCompletionCache({ max = FIM_CACHE_MAX, ttlMs = FIM_CACHE_TTL_MS, now = () => Date.now() } = {}) {
+  const store = new Map();
+  return {
+    get(key) {
+      const hit = store.get(key);
+      if (hit === undefined) return null;
+      if (now() - hit.at > ttlMs) {
+        store.delete(key);
+        return null;
+      }
+      store.delete(key);
+      store.set(key, hit);
+      return hit.text;
+    },
+    set(key, text) {
+      if (typeof key !== 'string' || key === '' || typeof text !== 'string') return false;
+      store.delete(key);
+      store.set(key, { text, at: now() });
+      while (store.size > max) {
+        const oldest = store.keys().next();
+        if (oldest.done === true) break;
+        store.delete(oldest.value);
+      }
+      return true;
+    },
+    size() {
+      return store.size;
+    },
+    clear() {
+      store.clear();
+    },
+  };
+}
+
+/** 数字 → 状态栏用短串(1.2k / 12k / 1.2M)。 */
+function formatTokens(n) {
+  if (!Number.isFinite(n) || n <= 0) return '0';
+  if (n < 1000) return String(Math.round(n));
+  if (n < 10000) return `${(n / 1000).toFixed(1)}k`;
+  if (n < 1000000) return `${Math.round(n / 1000)}k`;
+  return `${(n / 1000000).toFixed(1)}M`;
+}
+
+/** 状态栏 tooltip 里那段 FIM 说明(纯字符串组装,便于单测)。 */
+function describeFimUsage(fim) {
+  if (fim === null || typeof fim !== 'object') return [];
+  if (fim.enabled !== true) return ['FIM 补全:已关闭(设置里可开,实验性)'];
+  const lines = [
+    `FIM 补全(实验性):已开启${fim.available === false ? ` —— 不可用:${fim.reason ?? '原因未知'}` : ''}`,
+    `调用 ${fim.calls ?? 0} 次(成功 ${fim.ok ?? 0}/失败 ${fim.failed ?? 0})`,
+    `输入 ${formatTokens(fim.inputTokens)} tok · 输出 ${formatTokens(fim.outputTokens)} tok · 缓存命中 ${formatTokens(fim.cacheReadTokens)} tok`,
+    `停顿 ${Number.isFinite(fim.debounceMs) ? Math.round(fim.debounceMs) : FIM_DEBOUNCE_DEFAULT_MS}ms · `
+      + `${fim.multiline === false ? '仅单行' : '允许多行'}`
+      + `${Array.isArray(fim.disableGlobs) && fim.disableGlobs.length > 0 ? ` · 禁用 ${fim.disableGlobs.length} 条 glob` : ''}`,
+  ];
+  if (Number.isFinite(fim.lastMs)) lines.push(`最近一次 ${Math.round(fim.lastMs)}ms`);
+  if (typeof fim.lastError === 'string' && fim.lastError !== '') lines.push(`最近错误:${fim.lastError}`);
+  return lines;
+}
+
+// ---------------------------------------------------------------- 与宿主同语义的两件小事
+//
+// 为什么在这里**再实现一遍**:扩展是随包分发的静态文件,不能 import 宿主代码(ESM/CJS + 树内外),
+// 而这两个判据必须在"发请求之前/收响应之后"本地生效 —— 一致性由 scripts/test-fim.mjs 用同一组
+// 语料对两边做等价断言(与桥常量、窗口常量同一套做法)。
+
+/** 与宿主 lib/fim-adapter.mjs 的 FIM_DEBOUNCE_DEFAULT_MS 同值(宿主会在 /sync 里给实际值)。 */
+const FIM_DEBOUNCE_DEFAULT_MS = 250;
+
+/** 解析 glob 清单(与宿主 compileGlobList 同语义)。 */
+function compileGlobList(text) {
+  if (typeof text !== 'string' || text.trim() === '') return [];
+  const seen = new Set();
+  const out = [];
+  for (const raw of text.split(/[;,\s]+/)) {
+    const item = raw.trim().replace(/\\/g, '/').replace(/^\.\//, '');
+    if (item === '' || seen.has(item)) continue;
+    seen.add(item);
+    out.push(item);
+  }
+  return out;
+}
+
+/** glob → 正则(与宿主 globToRegExp 同语义:`*` 不跨目录、`**` 跨目录、不含 `/` 只匹配文件名)。 */
+function globToRegExp(glob) {
+  let g = typeof glob === 'string' ? glob.trim().replace(/\\/g, '/').replace(/^\.\//, '') : '';
+  if (g === '') return null;
+  if (g.endsWith('/')) g += '**';
+  const anchored = g.includes('/');
+  let out = '';
+  for (let i = 0; i < g.length; i += 1) {
+    const ch = g[i];
+    if (ch === '*') {
+      if (g[i + 1] === '*') {
+        if (g[i + 2] === '/') {
+          out += '(?:.*/)?';
+          i += 2;
+        } else {
+          out += '.*';
+          i += 1;
+        }
+      } else {
+        out += '[^/]*';
+      }
+    } else if (ch === '?') {
+      out += '[^/]';
+    } else {
+      out += ch.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+  }
+  return { re: new RegExp(`^${out}$`), anchored };
+}
+
+/** 路径是否命中禁用清单(返回命中的模式或 null)。
+ *  含 `/` 的模式按**完整路径与各层尾段**各试一次(与宿主 lib/fim-adapter.mjs 同语义:
+ *  用户写 `vendor/**` 的直觉是"任何层级下的 vendor",而绝对路径永远以 `/` 或盘符开头)。 */
+function matchDisabledGlob(filePath, globs) {
+  if (typeof filePath !== 'string' || filePath === '') return null;
+  const list = Array.isArray(globs) ? globs : compileGlobList(globs);
+  if (list.length === 0) return null;
+  const full = filePath.replace(/\\/g, '/');
+  const slash = full.lastIndexOf('/');
+  const base = slash === -1 ? full : full.slice(slash + 1);
+  for (const glob of list) {
+    const parsed = globToRegExp(glob);
+    if (parsed === null) continue;
+    if (!parsed.anchored) {
+      if (parsed.re.test(base)) return glob;
+      continue;
+    }
+    if (parsed.re.test(full)) return glob;
+    for (let i = full.indexOf('/'); i !== -1; i = full.indexOf('/', i + 1)) {
+      if (parsed.re.test(full.slice(i + 1))) return glob;
+    }
+  }
+  return null;
+}
+
+/** 只保留第一行(宿主在关掉多行时也会做;这里是第二道)。 */
+function toSingleLine(text) {
+  if (typeof text !== 'string' || text === '') return '';
+  const first = text.split('\n')[0];
+  return first.trim() === '' ? '' : first;
+}
+
+module.exports = {
+  FIM_MAX_PREFIX_CHARS,
+  FIM_MAX_SUFFIX_CHARS,
+  FIM_MAX_PREFIX_LINES,
+  FIM_MAX_SUFFIX_LINES,
+  FIM_DEBOUNCE_MS,
+  FIM_DEBOUNCE_DEFAULT_MS,
+  FIM_MAX_DOCUMENT_LINES,
+  FIM_CACHE_MAX,
+  FIM_CACHE_TTL_MS,
+  trimWindow,
+  shouldRequest,
+  fingerprint,
+  buildPayload,
+  createCompletionCache,
+  formatTokens,
+  describeFimUsage,
+  compileGlobList,
+  globToRegExp,
+  matchDisabledGlob,
+  toSingleLine,
+};

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

@@ -1,8 +1,8 @@
 {
   "name": "dshcs-editor-bridge",
   "displayName": "DSH Editor Bridge",
-  "description": "只读地把编辑器状态(未保存缓冲区、诊断、活动选区)提供给 DSH;右键提问打开 DSH 页面里的悬浮对话对话框(0.3.59 起是唯一路径:面板在插件客户端半部,正文/思考/上下文都用页面模块表里的官方渲染器,并可就地回答授权请求;拿不到对话框心跳时只给一条提示)。由 dsh-code-server-app 插件安装,可禁用。",
-  "version": "0.2.18",
+  "description": "对工作区只读地把编辑器状态(未保存缓冲区、诊断、活动选区)提供给 DSH(不写文件、不执行命令);右键提问打开 DSH 页面里的悬浮对话对话框(0.3.59 起是唯一路径:面板在插件客户端半部,正文/思考/上下文都用页面模块表里的官方渲染器,并可就地回答授权请求;拿不到对话框心跳时只给一条提示)。由 dsh-code-server-app 插件安装,可禁用。另有**实验性**的 FIM 内联补全(灰字续写):默认关闭,在插件设置卡里开启;关闭时本扩展连 provider 都不注册,不会发出任何补全请求。",
+  "version": "0.2.20",
   "publisher": "dsh-code-server-app",
   "license": "MIT",
   "private": true,

package/lib/bridge.mjs

@@ -31,11 +31,14 @@
  *
  * ## 安全不变量(改这个文件之前先读这几条)
  *
- * 1. **`BRIDGE_BASE`(`/code-server-bridge`)命名空间**只有四条路由,而且**全部只读**:
+ * 1. **`BRIDGE_BASE`(`/code-server-bridge`)命名空间**是**四条只读路由 + 一条有界的模型调用**:
  *    `/health`(无鉴权探活)、`/sync`(上报编辑器状态 + 取事件)、`/old`(取写前原文快照)、
- *    `/event`(上报意图,如"请宿主打开对话框")。这里**不允许**出现写文件、改文档、执行命令、
+ *    `/event`(上报意图,如"请宿主打开对话框"),以及 **`/complete`**(0.3.61,**实验性 FIM 补全**):
+ *    它把光标前后的两段文本交给模型换回一段补全文本 —— **仍然不写文件、不执行命令**,
+ *    而且默认关(设置里开启前一律 403),有速率/并发/长度/超时上限(见 lib/index.js 的
+ *    handleBridgeComplete 与 lib/fim-adapter.mjs)。这里**不允许**出现写文件、改文档、执行命令、
  *    拉起进程的路由 —— `bridge.json` 里那个令牌对本机同用户进程可读,爆炸半径必须封在
- *    "泄露编辑器里的信息",绝不能变成任意文件写 / 任意命令执行。
+ *    "泄露编辑器里的信息 + 替用户花一点补全 token",绝不能变成任意文件写 / 任意命令执行。
  *    提问与授权答复不走这里:它们在 DSH 同源的 `/api/code-server/ask/*` 上,调用方是 DSH 页面里的
  *    插件客户端(吃 DSH 自己的 cookie/Origin 校验)。
  * 2. **授权答复的四条约束**(在 `/api/code-server/ask/approve` 上,缺一条就等于开了任意命令执行的后门,

package/lib/client.js

@@ -14,6 +14,14 @@
  *   ④ 各段落原来的顶层标识符现在共享同一作用域 —— 新增顶层名字时先搜一遍别撞名
  *      (var/function 撞名是**静默覆盖**,不会报错)。
  *
+ * DSH 支持范围(2026-09-22 收敛;判据一律是**能力是否被声明**,不做版本号比较):
+ *   · rc 线    0.1.5-rc.x(最新 0.1.5-rc.3 = npm latest/next)
+ *              旧座位 `settings.plugin.item` + 会话列表快照上的 `current`
+ *   · alpha 线 ≥ 0.1.6-alpha.2(最新 0.1.7-alpha.1)
+ *              新座位 `plugins.bundle.config` + 会话作用域标准 prop `sessionId`
+ *   更早的 alpha(0.1.5-alpha.x、0.1.6-alpha.1)形状与 rc 线相同 —— 代码天然走得通,但**不作为目标**,
+ *   也不为它们写任何专门分支。本文件里凡出现"哪一版"的说法,都按这两条线命名。
+ *
  * 段落(按依赖顺序):地址语法 → 工作区解析 → 常驻面 → 全屏动作 → 认领类型(与 lib/claim-types.js
  * 同源的一致性副本)→ 插件主体。
  */
@@ -126,9 +134,9 @@ function resolveFilePath(parsed, cwd) {
 // —— 解析"当前工作区目录"(决定 workbench 用哪个 `?folder=` 打开)
 //
 // 为什么单独成模块:这段逻辑的真实输入是 **DSH 客户端 store 的形状**,而它随 DSH 版本变过 ——
-//   · DSH ≤ 0.1.6-alpha.1:`SessionListState` 带 `current`(选中的会话 id 就挂在会话列表快照上,
+//   · rc 线(≤ 0.1.5-rc.3,最新 rc 仍是这样):`SessionListState` 带 `current`(选中的会话 id 挂在快照上,
 //     老写法 `useSessions(s => s).current` 即"当前会话");
-//   · DSH ≥ 0.1.6-alpha.2:`current` 被移出列表 store(上游 refactor 的注释:view selection remains
+//   · alpha 线(≥ 0.1.6-alpha.2,含最新 0.1.7-alpha.1):`current` 被移出列表 store(上游 refactor 注释:view selection remains
 //     outside the Controller;快照只剩 `{ ids, byId, phase, subagentsByParent, jobsBySession }`),
 //     会话作用域插槽改为用标准 prop `sessionId` 告诉 body"你是哪个会话的" —— 官方自己的右侧栏标签
 //     就是这么读 cwd 的(ui-deliverables 的 ReviewTab:`useSessions(s => s.byId[sessionId]?.cwd)`)。
@@ -149,7 +157,7 @@ function cwdOf(sessions, sessionId) {
   return typeof row.cwd === 'string' && row.cwd !== '' ? row.cwd : undefined
 }
 
-/** 工作区表里"包含该会话"的那个工作区的路径(DSH ≤ 0.1.6-alpha.1 的 currentAddress 语义由它兜底)。 */
+/** 工作区表里"包含该会话"的那个工作区的路径(rc 线的 currentAddress 语义由它兜底)。 */
 function pathHoldingSession(workspaces, sessionId) {
   if (workspaces == null || !Array.isArray(workspaces.items)) return undefined
   if (typeof sessionId !== 'string' || sessionId === '') return undefined
@@ -660,6 +668,18 @@ function normalizeClaimExtensions(text) {
   return seen.join(';')
 }
 
+/**
+ * FIM 停顿毫秒数的归一化(0.3.62):与宿主 lib/fim-adapter.mjs 的 `clampDebounce` **同语义**。
+ * 客户端也夹一次的理由:输入框里可以是任何东西(空、负数、10^9),用户在点保存之前就该看到
+ * "保存后会变成什么",而不是保存完发现值被宿主悄悄改掉 —— 这与认领类型那行显示"实际规则"同一考虑。
+ */
+function normalizeFimDebounce(value) {
+  if (value === undefined || value === null || value === '') return 250
+  var n = typeof value === 'number' ? value : Number(value)
+  if (!isFinite(n)) return 250
+  return Math.min(3000, Math.max(100, Math.round(n)))
+}
+
 /**
  * 解析策略文本。
  * @param text - 归一化前或后的文本都接受。
@@ -751,7 +771,7 @@ function intersects(list, group) {
 // 数据通道:同源 fetch DSH Connection 的共享 /api(status / start / stop / setup / open-file / ui-mode;
 // web 走 webServer 的 /api 前缀,desktop 走 IPC 帧管道 → 插件不依赖 webServer)。
 //
-// UI 载体只有右侧栏标签(需要 sidebarRightTabs / sidebarRight 服务,DSH ≥ 0.1.5-alpha.1):
+// UI 载体只有右侧栏标签(需要 sidebarRightTabs / sidebarRight 服务;rc 线与 alpha 线都有):
 //   一段 ctx.sidebarRightTabs.register({ id, kind, priority, patterns, canOpen, title, guide })
 //     → guide 页入口框;并通过 patterns 认领 `dsh-resource://file/**` 文件地址,成为官方 openFile
 //       (产物 chip / "交付"卡片预览 / 正文提及)与任何 openResource(fileAddress) 的落点。
@@ -804,8 +824,8 @@ let React = require('react')
     }
 
     // ---------- 标准 prop 里的会话/工作区快照 ----------
-    // 取哪条路、退到哪条路**全在本文件的工作区解析段**(纯函数):DSH ≤ 0.1.6-alpha.1 的
-    // `SessionListState.current` 在 0.1.6-alpha.2 被移出列表 store,会话作用域插槽改用标准 prop
+    // 取哪条路、退到哪条路**全在本文件的工作区解析段**(纯函数):rc 线(≤ 0.1.5-rc.3)的
+    // `SessionListState.current` 在 alpha 线(≥ 0.1.6-alpha.2)被移出列表 store,会话作用域插槽改用标准 prop
     // `sessionId` 标识当前会话 —— 只认旧形状会让 cwd 静默变成 undefined(IDE 以空工作区启动)。
     /** 服务缺失时的占位选择器:**hook 调用次数必须恒定**(React 按位置对账),
      *  否则"服务晚到"的那一次渲染会抛 "Rendered more hooks than during the previous render"。 */
@@ -946,7 +966,7 @@ let React = require('react')
       document.head.appendChild(tag)
     }
 
-    // ---------- 右侧栏标签(DSH ≥ 0.1.5-alpha.1:ctx.sidebarRightTabs / ctx.sidebarRight) ----------
+    // ---------- 右侧栏标签(rc 线与 alpha 线都有:ctx.sidebarRightTabs / ctx.sidebarRight) ----------
     // 二段式注册:类型定义进 sidebarRightTabs,body 进 keyed 插槽 sidebar.right.pane.tab。
     // 服务始终不就绪(旧版 DSH)→ 判定 legacy:只留设置页提示(见 internalApply)。
     var CS_KIND = 'code-server'
@@ -1057,7 +1077,7 @@ let React = require('react')
       var navigation = tab.navigation
       var revision = navigation != null && typeof navigation.revision === 'number' ? navigation.revision : 0
       // 地址:文件 tab 可能来自会话树里的别的会话,故优先用地址里的 sessionId 对齐工作区;
-      // 页面 tab 用**会话作用域标准 prop** `sessionId`(DSH ≥ 0.1.6-alpha.2 的当前会话信源,
+      // 页面 tab 用**会话作用域标准 prop** `sessionId`(alpha 线 ≥ 0.1.6-alpha.2 的当前会话信源,
       // 老版的 `useSessions().current` 已被上游移除 —— 详见本文件的工作区解析段)。
       var address = navigation != null && typeof navigation.address === 'string' ? navigation.address : ''
       var parsed = isPageAddress(address) ? null : parseFileAddress(address)
@@ -1236,9 +1256,9 @@ let React = require('react')
     // ---------- 设置(参照 auto-open-web 的自绘卡片模式) ----------
     // 数据通道:settingsScope(官方 settings 域,命名空间 code-server)—— 两个座位共用。
     // 座位(0.3.50 起两条腿都注册,谁被声明谁生效):
-    //   · `plugins.bundle.config`(DSH ≥ 0.1.6-alpha.2):插件页按**包名**派发的配置区,页面自带
+    //   · `plugins.bundle.config`(alpha 线 ≥ 0.1.6-alpha.2,含最新 0.1.7-alpha.1):插件页按**包名**派发的配置区,页面自带
     //     标题/面包屑,我们只出表单 + 保存控件(seat='bundle-config');
-    //   · `settings.plugin.item`(DSH ≤ 0.1.6-alpha.1):设置页里自绘的可折叠卡片(已在新版退役)。
+    //   · `settings.plugin.item`(rc 线 ≤ 0.1.5-rc.3,最新 rc 仍在用):设置页里自绘的可折叠卡片(alpha 线已退役)。
     var CARD_CSS =
       '.dshcs-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}' +
       '.dshcs-card:hover{border-color:var(--dsw-alias-label-dimmed,var(--dsw-alias-border-l2))}' +
@@ -1325,6 +1345,20 @@ let React = require('react')
         React.createElement('span', { className: 'dshcs-hint' }, props.children)
       )
     }
+    /** 数字输入(0.3.62 起,用于"停顿毫秒数"这类有上下限的整数)。
+     *  为什么不用文本框:用户在点保存**之前**就该看到 min/max 这层约束;真正的夹取在
+     *  保存时 `normalizeFimDebounce`(与宿主 clampDebounce 同语义),两者一致才不会"保存后被悄悄改掉"。 */
+    function csNumber(props) {
+      return React.createElement('label', { className: 'dshcs-text' },
+        React.createElement('input', {
+          type: 'number',
+          value: props.value === undefined || props.value === null ? '' : String(props.value),
+          min: props.min, max: props.max, step: props.step === undefined ? 10 : props.step,
+          disabled: props.disabled === true, spellCheck: false, autoComplete: 'off',
+          onChange: function (event) { props.onChange(event.target.value) },
+        })
+      )
+    }
     /** 多行文本输入(0.3.52 起,用于"认领类型"这类清单)。
      *  为什么不是单行 input:0.3.51 之后默认值有 98 条排除项(≈700 字符),单行框只能看到开头,
      *  剩下全靠横向滚动 —— 既看不全也改不动。这里改用 textarea,并**按内容自动长高**(上限 12 行),
@@ -1423,6 +1457,10 @@ let React = require('react')
         keepResident: value.keepResident !== false,
         claimExtensions: typeof value.claimExtensions === 'string' ? value.claimExtensions : DEFAULT_CLAIM_EXTENSIONS,
         fullscreenOnOpen: value.fullscreenOnOpen !== false,
+        fim: value.fim === true,
+        fimDebounceMs: normalizeFimDebounce(value.fimDebounceMs),
+        fimMultiline: value.fimMultiline !== false,
+        fimDisableGlobs: typeof value.fimDisableGlobs === 'string' ? value.fimDisableGlobs : '',
       }
       // ---- 旧版 DSH(无右侧栏服务):本页是唯一的提示出口,不显示任何设置项 ----
       if (liveStore != null && liveStore.sidebarUi === 'legacy') {
@@ -1438,7 +1476,7 @@ let React = require('react')
             React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 0 } },
               '未检测到右侧栏插件服务 sidebarRightTabs / sidebarRight,因此插件不提供任何入口'
               + '(旧版的悬浮球与浮动窗口已移除),也不会后台启动 IDE。'
-              + '\n升级 DSH 到带右侧栏的版本(≥ 0.1.5-alpha.1)后,Code Server 会出现在右侧栏标签里,'
+              + '\n升级 DSH 到 rc 线(0.1.5-rc.x)或 0.1.6-alpha.2 起的 alpha 线后,Code Server 会出现在右侧栏标签里,'
               + '本页同时显示完整设置项;升级后无需重装本插件,刷新页面即可。'
             )
           )
@@ -1447,9 +1485,17 @@ let React = require('react')
       var overriddenKeep = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'keepResident')
       var overriddenClaim = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'claimExtensions')
       var overriddenFullscreen = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fullscreenOnOpen')
+      var overriddenFim = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fim')
+      var overriddenFimDebounce = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimDebounceMs')
+      var overriddenFimMultiline = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimMultiline')
+      var overriddenFimGlobs = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimDisableGlobs')
       var dirty = draft !== null && (draft.keepResident !== loaded.keepResident
         || normalizeClaimExtensions(draft.claimExtensions) !== normalizeClaimExtensions(loaded.claimExtensions)
-        || draft.fullscreenOnOpen !== loaded.fullscreenOnOpen)
+        || draft.fullscreenOnOpen !== loaded.fullscreenOnOpen
+        || draft.fim !== loaded.fim
+        || normalizeFimDebounce(draft.fimDebounceMs) !== normalizeFimDebounce(loaded.fimDebounceMs)
+        || draft.fimMultiline !== loaded.fimMultiline
+        || draft.fimDisableGlobs !== loaded.fimDisableGlobs)
       var saveDisabled = !dirty || saving
       var state = {
         available: true,
@@ -1473,6 +1519,10 @@ let React = require('react')
             await props.scope.set('keepResident', d.keepResident === true)
             await props.scope.set('claimExtensions', normalizeClaimExtensions(d.claimExtensions))
             await props.scope.set('fullscreenOnOpen', d.fullscreenOnOpen === true)
+            await props.scope.set('fim', d.fim === true)
+            await props.scope.set('fimDebounceMs', normalizeFimDebounce(d.fimDebounceMs))
+            await props.scope.set('fimMultiline', d.fimMultiline === true)
+            await props.scope.set('fimDisableGlobs', typeof d.fimDisableGlobs === 'string' ? d.fimDisableGlobs : '')
             setDraft(null)
             syncStatusToStore()
           } catch (e) {
@@ -1490,10 +1540,18 @@ let React = require('react')
             await props.scope.unset('keepResident')
             await props.scope.unset('claimExtensions')
             await props.scope.unset('fullscreenOnOpen')
+            await props.scope.unset('fim')
+            await props.scope.unset('fimDebounceMs')
+            await props.scope.unset('fimMultiline')
+            await props.scope.unset('fimDisableGlobs')
           } else {
             await props.scope.set('keepResident', value.keepResident === undefined || value.keepResident === null ? true : value.keepResident)
             await props.scope.set('claimExtensions', typeof value.claimExtensions === 'string' ? normalizeClaimExtensions(value.claimExtensions) : DEFAULT_CLAIM_EXTENSIONS)
             await props.scope.set('fullscreenOnOpen', value.fullscreenOnOpen === undefined || value.fullscreenOnOpen === null ? true : value.fullscreenOnOpen)
+            await props.scope.set('fim', value.fim === true)
+            await props.scope.set('fimDebounceMs', normalizeFimDebounce(value.fimDebounceMs))
+            await props.scope.set('fimMultiline', value.fimMultiline !== false)
+            await props.scope.set('fimDisableGlobs', typeof value.fimDisableGlobs === 'string' ? value.fimDisableGlobs : '')
           }
           setDraft(null)
           syncStatusToStore()
@@ -1503,8 +1561,8 @@ let React = require('react')
         setSaving(false)
       }
       var fields = [
-        // 三个设置(0.2.11 起):认领类型 + 打开即全屏 + 后台常驻。入口/依赖安装/环境检测三行已移除
-        // (入口在右侧栏「开始」页的 guide 入口框;诊断看 host 日志里的 [code-server] 输出)。
+        // 一行一个可改设置(0.2.11 起):认领类型 + 打开即全屏 + FIM 补全(0.3.61,含 0.3.62 的三个子项)
+        // + 后台常驻。入口/依赖安装/环境检测三行已移除(入口在右侧栏「开始」页的 guide 入口框;诊断看 host 日志)。
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, '认领类型(按扩展名,分号分隔)'),
@@ -1565,6 +1623,92 @@ let React = require('react')
             '只影响"打开那一刻":切走再切回、再次打开文件 tab 会重新切全屏;'
             + 'DSH 未向插件开放模式接口,本项由点击右侧栏自身的「全屏」按钮实现。')
         ),
+        React.createElement('div', { className: 'dshcs-field' },
+          React.createElement('div', { className: 'dshcs-fieldHead' },
+            React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM 补全(实验性)'),
+            overriddenFim === true
+              ? React.createElement(csBadges, {
+                  overridden: true, disabled: snapshot.writable !== true,
+                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
+                  onReset: function () { doReset() },
+                })
+              : null
+          ),
+          React.createElement(csCheck, {
+            checked: draft !== null ? draft.fim : loaded.fim,
+            disabled: snapshot.writable !== true,
+            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fim: v === true }) }); setFailed(false) },
+          }, '开启后,在编辑器里打字停顿约 0.3 秒会向模型要一次「续写」,以灰字显示在光标后:Tab 接受、Esc 丢弃。默认关闭'),
+          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
+            '实验性功能,默认关闭。三点须知:'
+            + '① 它是本插件**唯一会把内容发出去**的能力 —— 每次补全会把光标附近的一小段代码(有上限)交给模型,'
+            + '桥的其余部分只读编辑器状态、不外发内容;'
+            + '② 这条调用不计入 DSH 自己的 token 计量(它不是一次会话请求),'
+            + '用量只在 IDE 状态栏的 DSH 项上是可见的;'
+            + '③ 模型偶尔会在"并不需要补"的位置硬凑一段,忽略即可(Esc 或继续打字都会让它消失)。'
+            + '关掉本项后扩展会立刻注销补全 provider,不再发出任何补全请求。')
+        ),
+        React.createElement('div', { className: 'dshcs-field' },
+          React.createElement('div', { className: 'dshcs-fieldHead' },
+            React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 停顿毫秒数(停下多久才请求)'),
+            overriddenFimDebounce === true
+              ? React.createElement(csBadges, {
+                  overridden: true, disabled: snapshot.writable !== true,
+                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
+                  onReset: function () { doReset() },
+                })
+              : null
+          ),
+          React.createElement(csNumber, {
+            value: draft !== null ? draft.fimDebounceMs : loaded.fimDebounceMs,
+            min: 100, max: 3000, step: 50, disabled: snapshot.writable !== true,
+            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimDebounceMs: v }) }); setFailed(false) },
+          }),
+          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
+            '有效范围 100–3000ms,保存时按它夹取(与宿主同一套规则)。实测这条端点往返 112–416ms,'
+            + '所以停顿基本就是"感知到的延迟":太小会在打字过程中反复触发,太大要等很久才出现灰字。')
+        ),
+        React.createElement('div', { className: 'dshcs-field' },
+          React.createElement('div', { className: 'dshcs-fieldHead' },
+            React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 允许多行补全'),
+            overriddenFimMultiline === true
+              ? React.createElement(csBadges, {
+                  overridden: true, disabled: snapshot.writable !== true,
+                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
+                  onReset: function () { doReset() },
+                })
+              : null
+          ),
+          React.createElement(csCheck, {
+            checked: draft !== null ? draft.fimMultiline : loaded.fimMultiline,
+            disabled: snapshot.writable !== true,
+            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimMultiline: v === true }) }); setFailed(false) },
+          }, '允许补出多行(关掉后只取第一行;首行为空 = 这次不补)'),
+          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
+            '默认开。实测模型在"并不需要补"的位置会硬凑一段,多行会把这种噪声放大 —— 想更克制就关掉它。')
+        ),
+        React.createElement('div', { className: 'dshcs-field' },
+          React.createElement('div', { className: 'dshcs-fieldHead' },
+            React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 按 glob 禁用(分号或换行分隔)'),
+            overriddenFimGlobs === true
+              ? React.createElement(csBadges, {
+                  overridden: true, disabled: snapshot.writable !== true,
+                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
+                  onReset: function () { doReset() },
+                })
+              : null
+          ),
+          React.createElement(csTextarea, {
+            value: draft !== null ? draft.fimDisableGlobs : loaded.fimDisableGlobs,
+            disabled: snapshot.writable !== true,
+            placeholder: '例如 *.md;**/dist/**;vendor/**',
+            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimDisableGlobs: v }) }); setFailed(false) },
+          }),
+          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
+            '留空 = 不禁用。语法:`*` 不跨目录、`**` 跨目录、不含 `/` 的模式只匹配文件名、`/` 结尾视作 `/**`。'
+            + '例:`*.md`(所有 Markdown)、`vendor/**`、`**/dist/**`、`**/*.min.js`。'
+            + '两边都会判:扩展侧先判(根本不发请求),宿主侧再判一遍。')
+        ),
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, '后台常驻(切标签不重载)'),
@@ -1588,7 +1732,7 @@ let React = require('react')
               : '当前浏览器不支持 Element.moveBefore(Chromium <133)→ 常驻不可用,切标签仍会整页重载(升级浏览器后自动生效)')
         )
       ]
-      // ---- 插件页的配置区(DSH ≥ 0.1.6-alpha.2)----
+      // ---- 插件页的配置区(alpha 线 ≥ 0.1.6-alpha.2)----
       // 上游把插件设置从"设置 → 插件"搬到**插件页**:页面自己画标题/图标/面包屑,把
       // `plugins.bundle.config`(按包名为键)渲染在描述与行之间,只问 `view: 'page'`。
       // 所以这里不再套可折叠卡片(标题会与页面标题重复),只出表单 + 自己的保存控件
@@ -1615,7 +1759,7 @@ let React = require('react')
       }
       return React.createElement(csCard, {
         title: 'Code Server',
-        description: '入口:右侧栏标签(DSH ≥ 0.1.5-alpha.1);认领类型决定哪些文件交给 Code Server 打开',
+        description: '入口:右侧栏标签(需 DSH 带 sidebarRight/sidebarRightTabs,即 rc 线或 0.1.6-alpha.2 起的 alpha 线);认领类型决定哪些文件交给 Code Server 打开',
         state: state,
         unsavedLabel: '未保存', readOnlyLabel: '本部署的设置为只读。',
         saveFailedLabel: '本部署没有接受这些值，已保留供你修改。',
@@ -2723,21 +2867,21 @@ let React = require('react')
       }).catch(function () { /* 首次失败由后续轮询补救 */ })
 
       // ---- 设置:两条腿都注册,谁被声明谁生效(两次注册不会同时出现) ----
-      // ① 插件页的配置区(DSH ≥ 0.1.6-alpha.2):`settings.plugin.item` 退役,上游把插件配置搬到
+      // ① 插件页的配置区(alpha 线 ≥ 0.1.6-alpha.2,含最新 0.1.7-alpha.1):`settings.plugin.item` 退役,上游把插件配置搬到
       //    插件页 —— 键是**包名**(页面按 `pkg.name` 派发),只问 `view: 'page'`。插件页只在
       //    `ledger.bundles.has(包名)` 时才渲染那一块,所以键写错就等于"设置又不见了"。
       slots.inject('plugins.bundle.config', () => slots.register(
         { name: 'plugins.bundle.config', key: PKG_NAME, inject: function () { return { scope: scope } } },
         BundleConfigEntry
       ))
-      // ② 设置页里的插件卡片(DSH ≤ 0.1.6-alpha.1;也是极旧 DSH 里唯一的提示出口)。
+      // ② 设置页里的插件卡片(rc 线 ≤ 0.1.5-rc.3,最新 rc 仍在用;也是没有右侧栏服务的旧 DSH 里唯一的提示出口)。
       //    `slots.inject` 只在插槽真被声明时才回调 ⇒ 新 DSH 上这一条自然不生效。
       slots.inject('settings.plugin.item', () => slots.register(
         { name: 'settings.plugin.item', key: 'code-server', label: 'Code Server', inject: function () { return { scope: scope } } },
         csSettingsPage
       ))
 
-      // ---- 能力探测:只有带右侧栏服务(DSH ≥ 0.1.5-alpha.1)才注册可用 UI;探测不到就只留设置页提示 ----
+      // ---- 能力探测:只有带右侧栏服务(sidebarRightTabs/sidebarRight;rc 线与 alpha 线都有)才注册可用 UI;探测不到就只留设置页提示 ----
       var modernSettled = false
 
       function onModernUi(sctx, via) {