dsh-code-server-app 0.3.59 → 0.3.65

package/README.md

@@ -27,11 +27,11 @@
 > 公式都一致,而且**不可能**版本错配),授权也在同一个对话框里就地处理 —— 详见
 > 「与 DSH 的协同:编辑器桥」。整条链上**没有任何构建步骤**。
 
-## UI 载体与 DSH 版本要求(0.2.3 起只支持带右侧栏的 DSH)
+## UI 载体与 DSH 支持范围(0.2.3 起只支持带右侧栏的 DSH;2026-09-22 收敛为下面两条线)
 
 | DSH 版本 | 载体 | 入口 |
 |---|---|---|
-| **≥ 0.1.5-alpha.1**(有 `sidebarRight` / `sidebarRightTabs` 服务) | **右侧栏标签**(kind=`code-server`,标签名 `Code Server`),并**认领文件地址**(见下) | ① **DSH 官方的产物 chip / 「交付」卡片预览 / 正文里的文件名**(0.2.5 起,走官方 `openFile` → 文件地址 → 本 tab);② 右侧栏「开始」页的 **Code Server 入口框**;③ 设置 → 插件 → Code Server → **「在右侧栏打开」** |
+| **rc 线** `0.1.5-rc.x`(最新 `0.1.5-rc.3` = npm `latest`/`next`)**与 alpha 线** `≥ 0.1.6-alpha.2`(最新 `0.1.7-alpha.1`)—— 判据是**有没有** `sidebarRight` / `sidebarRightTabs` 服务,不按版本号硬判 | **右侧栏标签**(kind=`code-server`,标签名 `Code Server`),并**认领文件地址**(见下) | ① **DSH 官方的产物 chip / 「交付」卡片预览 / 正文里的文件名**(0.2.5 起,走官方 `openFile` → 文件地址 → 本 tab);② 右侧栏「开始」页的 **Code Server 入口框**;③ 设置 → 插件 → Code Server → **「在右侧栏打开」** |
 | 更早(无右侧栏服务) | **不受支持**:除设置页的一条提示外**不提供任何入口** | 无(设置 → 插件 → Code Server 显示升级提示) |
 
 - 检测方式:先 `ctx.get('sidebarRightTabs') / ctx.get('sidebarRight')` 同步探测;
@@ -62,7 +62,7 @@
     含窄视口下的连带处理)。按钮找不到时保持原模式并 `console.warn` 一条,绝不影响面板渲染。
 - **IDE 常驻(0.2.2 起,默认开)**:切到别的标签/收起侧栏再回来**不再重载** code-server——
   未保存的编辑缓冲区、终端、调试会话都留在原处(见下方「为什么切标签不再重载」)。
-- 设置卡片只有**三个设置**:「**认领类型**」「**打开即全屏**」与「**后台常驻(切标签不重载)**」——没有其它行(0.2.7 起移除「入口」「依赖安装」「环境检测」)。
+- 设置卡片只有**四组设置**:「**认领类型**」「**打开即全屏**」「**FIM 补全(实验性,默认关;含停顿毫秒数 / 允许多行 / 按 glob 禁用三个子项)**」与「**后台常驻(切标签不重载)**」——没有其它行(0.2.7 起移除「入口」「依赖安装」「环境检测」)。
   打开 IDE 用右侧栏「开始」页的 **Code Server 入口框**,或直接点官方的产物 chip / 交付卡片 / 正文文件名;
   诊断看 DSH host 日志里的 `[code-server]` 输出(`/api/code-server/status` 仍返回 `env` 供脚本排查)。
   旧版的 `windowedOpen`(窗口化打开)、`reserveComposer` 已在 0.2.6 移除:旧设置文档里残留的这两个键不会报错,只是被忽略(不再出现在 schema 里)。
@@ -200,7 +200,7 @@ DSH 用**资源地址**命名文件,`openFile` 只负责把地址交给右侧栏
 边界(说清楚,不夸大):这一层挡的是"本机其它应用/端口扫描器/浏览器页面"顺手访问你的 IDE;
 **同用户的本地恶意程序**本来就能直接读你的文件、也能读那个令牌文件 —— 那不在本插件的威胁模型内。
 
-- 在 `cordis.patch.yml` 的 `config.serve`(或设置文档里的 `code-server.serve`)切换,下次启动生效 —— **设置卡片不提供这一行**(卡片只有认领类型/打开即全屏/后台常驻三个设置)。
+- 在 `cordis.patch.yml` 的 `config.serve`(或设置文档里的 `code-server.serve`)切换,下次启动生效 —— **设置卡片不提供这一行**(卡片只有认领类型/打开即全屏/后台常驻/FIM 补全四个设置)。
 - `dsh` 模式的实际收益:单一 URL/单一端口(远程访问 DSH 即可用 IDE)、不再暴露额外回环端口、认证与 DSH 同级。
 - `dsh` 模式的两点**已知取舍**:
   1. iframe 与 DSH **同源** → 该模式下不再挂 `sandbox`(同源 + `allow-same-origin` 可被 frame 自行摘除,属"看起来有防护");
@@ -365,6 +365,51 @@ seq,并且 `/sync` 回应里带 `lastSeq`(高水位),扩展据此自查游标是
 诊断:`GET /api/code-server/status` 的 `bridge` 字段返回
 `{ enabled, live, toolsRegistered, supported, url, file }` —— **不含令牌**(令牌只在那个文件里)。
 
+## FIM 补全(实验性,0.3.61 起,**默认关**)
+
+在编辑器里打字停顿时,光标后出现灰色续写(Tab 接受、Esc 丢弃)。**默认关闭**,在设置卡片里那一行开启,开启后即时生效(不用重启宿主、也不用重装插件)。
+
+| 项 | 值 |
+|---|---|
+| 端点 | DeepSeek **FIM(Beta)**:`POST https://api.deepseek.com/beta/completions`,参数 `prompt`(前缀)+ `suffix`(后缀) |
+| 模型 | `deepseek-flash`(官方 FIM 文档的示例模型,也就是本部署的默认模型) |
+| 凭据 | 复用 DSH 里已有的 `DEEPSEEK_API_KEY`:`ctx.get('credentials').resolve(...)`,与官方适配器同一条路(取不到再退回启动环境变量) |
+| 实测延迟 | **112–416 ms**(非流式;流式反而更慢 ⇒ 故意用非流式) |
+| 触发条件 | 停顿 ≥250ms 且通过门控:有选区 / 非 `file` 文档 / 空上下文 / 文档 >2 万行 —— 这几种**根本不发请求** |
+
+**它怎么接进来的(方案 A)**:FIM 走的是 Completions API,而 `ctx.llm.stream(GenerateOptions)` 的词汇表里
+只有 `messages`(没有 `prompt`/`suffix`,`purpose` 还是封闭联合 `'compaction' | 'session-title'`)⇒ 插件
+**自己注册一个 LLM 适配器路由** `dshcs-fim`:把前缀/后缀装进一条带固定前缀(`dshcs-fim/1 `)的 messages 信封,
+适配器解出信封再打那个端点。这样这条调用**仍然走 DSH 的 LLM 服务** —— 取消、超时、终态 chunk、稳定错误码
+都按服务契约走(而不是插件自己直连绕过服务层)。依据与实测数据见 `docs/analysis-continuedev-reuse.md` 的 B6/B7。
+
+**三个可调项(0.3.62,都在设置卡里,即时生效)**:
+
+| 设置 | 默认 | 作用 |
+|---|---|---|
+| 停顿毫秒数 | `250` | 打字停下多久才请求一次。范围 100–3000ms(保存时夹取);**实测端点往返 112–416ms**,所以停顿基本就是"感知到的延迟" |
+| 允许多行补全 | 开 | 关掉后宿主只回第一行;首行是空白 ⇒ 这次不补。想更克制(少被打扰)就关掉它 |
+| 按 glob 禁用 | 空 | 这些文件里**根本不发请求**。语义:`*` 不跨目录、`**` 跨目录、不含 `/` 的模式只匹配文件名、含 `/` 的模式按**路径尾段**匹配(所以 `vendor/**`、`src/*.ts` 在任何层级都生效)、`/` 结尾视作 `/**`。例:`*.md;vendor/**;**/dist/**` |
+
+> 这三项的语义在**宿主与扩展各有一份实现**(扩展是随包分发的静态文件,不能 import 宿主代码),
+> 一致性由 `scripts/test-fim.mjs` 用同一组(模式,路径)语料对两侧做等价断言钉住。
+
+**安全与边界**(这是本插件唯一会把内容发出去的能力):
+
+- **只读不变**:扩展仍然不写文件、不执行命令 —— 它只"提议"一段文本,插入由你按 Tab 完成;
+- 只有开启后桥才有第五条路由 `POST /complete`(**唯一一条会发起模型调用**的);没开一律 403,不发任何请求;
+- 有界:前后缀各 ≤6000/2000 字符(120/40 行,字符与行数取先到者)、输出 ≤2000 字符、单次 4s 超时、
+  最小间隔 120ms、并发 1、每分钟 60 次;超限的请求被拒(409/429),扩展这一轮就当"这次没有补全";
+- 扩展侧还有一层:关掉开关后立刻注销 provider(连请求都不发),相同前后文 2 分钟内直接命中本地缓存;
+
+**用量只在两处可见**:这条调用**不是会话请求**,不写会话日志 ⇒ DSH 自己的 token 计量(逐轮用量、
+上下文压力、遥测)**都不含它**。所以用量显示在:① IDE 状态栏的 DSH 项 —— 开启后多一格 `$(zap) 1.2k`,
+悬停看输入 / 输出 / 缓存命中 / 最近耗时 / 最近错误;② `GET /api/code-server/status` 的 `fim` 字段(同一份快照)。
+
+**已知限制**:模型偶尔会在"并不需要补"的位置硬凑一段(实测在不该补的位置 2/2 复现);过滤管线会剥掉代码围栏与
+控制标记,但"该不该补"最终由你判断 —— Esc 或继续打字都会让它消失。更稳的形态要等更快的完成路由,
+或者 DSH 把 completion 做成一等请求(那时把适配器里的取数换成新 API 即可,调用方一行不用改)。
+
 ## 旧版 DSH(0.2.3 起不再支持)
 
 **行为**:探测不到 `sidebarRightTabs` / `sidebarRight` 时,插件只注册一张设置卡片,内容是:
@@ -372,7 +417,7 @@ seq,并且 `/sync` 回应里带 `lastSeq`(高水位),扩展据此自查游标是
 > **Code Server** — 当前 DSH 版本不受支持(缺少右侧栏服务)
 > 本插件自 0.2.3 起不再兼容旧版 DSH。
 > 未检测到右侧栏插件服务 sidebarRightTabs / sidebarRight,因此插件不提供任何入口(旧版的悬浮球与浮动窗口已移除),
-> 也不会后台启动 IDE。升级 DSH 到带右侧栏的版本(≥ 0.1.5-alpha.1)后,Code Server 会出现在右侧栏标签里,
+> 也不会后台启动 IDE。升级 DSH 到 rc 线(0.1.5-rc.x)或 0.1.6-alpha.2 起的 alpha 线后,Code Server 会出现在右侧栏标签里,
 > 本页同时显示完整设置项;升级后无需重装本插件,刷新页面即可。
 
 - **没有任何其他 UI**:不注册 `shell.overlay`(悬浮球)、不认领文件地址、不做常驻预热。
@@ -388,8 +433,8 @@ seq,并且 `/sync` 回应里带 `lastSeq`(高水位),扩展据此自查游标是
 
 - code-server 服务目录**跟随活动工作区/会话**:打开期间切换 DSH 会话/工作区,code-server 自动切到新目录
   (解析优先级:当前会话 cwd → 会话所属 `workspace.path` → 最近活跃会话所属 workspace → 首个 workspace.path;
-  **"当前会话"的信源随 DSH 版本而变**:≥ 0.1.6-alpha.2 读会话作用域标准 prop `sessionId`,
-  ≤ 0.1.6-alpha.1 退回会话列表快照上的 `current` —— 详见下面 0.3.48 那条;纯逻辑内联在 `lib/client.js`
+  **"当前会话"的信源随支持线而变**:alpha 线(≥ 0.1.6-alpha.2)读会话作用域标准 prop `sessionId`,
+  rc 线(≤ 0.1.5-rc.3)退回会话列表快照上的 `current` —— 详见下面 0.3.48 那条;纯逻辑内联在 `lib/client.js`
   的"工作区解析"段,两版形状的契约由 `scripts/test-client-bundle-cwd.mjs` 直接对**入口**钉住);
   打开目录显示在 code-server 页面内(`?folder=<cwd>`,跟随切换时页面自动重新加载);
   实现要点:iframe src 必须带 `?folder=<cwd>`——code-server 前端会记住“最近工作区”并自行恢复,
@@ -422,7 +467,7 @@ seq,并且 `/sync` 回应里带 `lastSeq`(高水位),扩展据此自查游标是
   (客户端半部与提问面板都是入库的手写源码 —— 整条链上**没有任何构建步骤**)。
 
 > 本机(BM: Windows 11 ARM64)实测:树/依赖全链路是"平台子包直挂插件依赖"供给 ——
-> 树包 `@jinsiyu/dshcs-vscode-server`(当前 4.137.0,50.8 MB tgz)、纯 JS 内部依赖与 8 个平台无关
+> 树包 `@jinsiyu/dshcs-vscode-server`(当前 4.138.0,50.9 MB tgz)、纯 JS 内部依赖与 8 个平台无关
 > 重打包包直接进插件 `dependencies`、8 个平台专属重打包包按 win32-arm64/x64 进
 > `optionalDependencies`(包自带 os/cpu 自动选),原始名字由 `lib/native.js` 补 junction 还原
 > → healthz 200 → 停止 → 回收全链路验证。
@@ -478,7 +523,7 @@ pnpm run promote -- <version>
 | 目标 | 命令 |
 |---|---|
 | **打最新版(上游 code-server 发行版)** | `pnpm run vendor:latest`(= `--force`):从 registry 取 `code-server@latest` 的树到 `vendor/vscode`;之后**必须**重跑 `repack:build` 并重发全部子包 |
-| **指定版本** | `pnpm run vendor:vscode -- --version 4.137.0` |
+| **指定版本** | `pnpm run vendor:vscode -- --version 4.138.0` |
 | **从已装好的树快照** | `pnpm run vendor:vscode -- --from <code-server 目录>`(秒级) |
 | **开发期让树可直接跑** | `pnpm run vendor:vscode -- --dev-links`(额外把 `lib/vscode/node_modules` 用 junction 补上) |
 | **完整重打子包** | `pnpm run repack:build -- --target win32-arm64,win32-x64 --pack`(不给 `--from` 会自动 npm install 解包 + 编译,耗时)。`--target` 只决定**本次在这台机器上构建哪些目标**(原生包要现编,所以 Linux 目标在 Linux 机器或 `repacks.yml` 的 Linux 腿上构建);产品覆盖哪些目标、每模块在哪些目标上有子包,由 `scripts/repack-platforms.json` 决定 |
@@ -505,12 +550,12 @@ pnpm test:bridge-extension   # 编辑器桥扩展侧纯逻辑:未保存缓冲区
 pnpm test:ask-dialog         # 「问 DSH」对话框的接线:没有产物/构建链了、宿主 4 条 ask 路由、扩展只上报编辑器状态、授权四条、桥的安全不变式
 pnpm test:launcher-routes    # launcher 的 HTTP 面(起真进程,较慢)
 pnpm test:workspace-switch   # 切工作区不重启进程
-pnpm test:workspace-cwd      # "当前工作区目录"解析:DSH 0.1.6-alpha.2(sessionId)与旧版(current)两套形状
+pnpm test:workspace-cwd      # "当前工作区目录"解析:alpha 线(≥0.1.6-alpha.2,sessionId)与 rc 线(≤0.1.5-rc.3,current)两套形状
 pnpm test:client-cwd         # 同一件事但直接对**客户端入口** lib/client.js 验(注册出来的 body 真发不发 cwd、URL 带不带 folder)
 pnpm test:client-tabs        # "DSH 侧只留一个 code-server 标签页":新标签挂载时收掉同窗格旧标签(跨窗格/不可见时不动)
 pnpm test:client-entry       # 客户端入口守卫:经典脚本+工厂包装、require 白名单(= DSH 模块表种子词)、src/ 已消失、与 lib/claim-types.js 逐字一致
 pnpm test:ask-panel          # 「问 DSH」对话框面板(0.3.59 起手写):注入机制已下线、视图白名单、注入 CSS 的选择器/var() 安全、六种条目与授权卡片、三条消息落点、拿不到官方部件时的降级
-pnpm test:client-seat        # 设置卡住哪个座位:插件页 plugins.bundle.config(DSH ≥ 0.1.6-alpha.2)vs settings.plugin.item(≤ alpha.1;新版已退役)
+pnpm test:client-seat        # 设置卡住哪个座位:alpha 线用插件页 plugins.bundle.config(≥ 0.1.6-alpha.2)vs rc 线用 settings.plugin.item(≤ 0.1.5-rc.3;alpha 线已退役)
 pnpm test:fullscreen         # 打开标签即全屏
 pnpm test:vendored           # 重打包表 ↔ 插件依赖表一致(无 npm: 别名 / 无聚合包 / vendored.json 进了 files)
 pnpm test:dsh-resolve        # 部署位置表:各平台全局装布局(npm --prefix / nvm / pnpm global / %APPDATA%)都能找到 DSH 部署
@@ -940,7 +985,7 @@ dsh plugin --profile web add C:\Users\User\Desktop\dsh-code-server-app
 ### 升级 VS Code 树(上游 = code-server 发行版)
 
 - **打包期决定版本**:`pnpm run vendor:latest`(= `--force`)取 npm **最新版 code-server** 的树并重建 `vendor/vscode`;
-  也可 `pnpm run vendor:vscode -- --version 4.137.0` 或设 `DSHCS_CODE_SERVER_VERSION`。
+  也可 `pnpm run vendor:vscode -- --version 4.138.0` 或设 `DSHCS_CODE_SERVER_VERSION`。
   已有 `vendor/vscode` 时,不带 `--force`/`--version` 不会升级(日常 `pnpm pack` 是 no-op)。
   **源树优先级(0.2.13 修正)**:显式 `--from` 用给定树;显式 `--force`/`--version` **一定走 registry**
   —— 修正前它们会被"本机已有源树"抢走(`defaultSourceTree()` 先命中 `vendor/code-server` 或 profile 里的旧树),
@@ -959,7 +1004,7 @@ dsh plugin --profile web add C:\Users\User\Desktop\dsh-code-server-app
 - `productPath`(`<quality>-<commit>`,客户端 WS 路径的组成)**从 `lib/vscode/product.json` 现算**,
   升级树后无需改代码 —— 但也意味着切版本后必须重启 dsh web(路由在激活期注册)。
 - **不再有运行期自动升级**:不会在启动时联网取 latest;版本完全由内置产物决定。
-- 本机当前内置:`code-server@4.137.0` 的树(VS Code 1.137.0,`productPath=stable-b11dabda…`)。
+- 本机当前内置:`code-server@4.138.0` 的树(VS Code 1.138.0,`productPath=stable-59c988c7…`)。
 
 ### 兼容旧安装位
 
@@ -974,8 +1019,8 @@ host 探测顺序:`@jinsiyu/dshcs-vscode-server/vscode`(**0.2.0+ 正式布局**)
 
 | DSH | 座位 | 长什么样 |
 |---|---|---|
-| **≥ 0.1.6-alpha.2** | `plugins.bundle.config`,**键 = 包名** `dsh-code-server-app` | 插件页 → 找到 `dsh-code-server-app` → 打开该插件页面,设置区在**描述与各行之间**(页面自己画标题/图标/面包屑,我们只出表单 + 保存控件) |
-| ≤ 0.1.6-alpha.1 | `settings.plugin.item`(key `code-server`) | 设置 → 插件 → Code Server 的自绘可折叠卡片(该插槽在新版**已退役**) |
+| **alpha 线 ≥ 0.1.6-alpha.2**(最新 0.1.7-alpha.1) | `plugins.bundle.config`,**键 = 包名** `dsh-code-server-app` | 插件页 → 找到 `dsh-code-server-app` → 打开该插件页面,设置区在**描述与各行之间**(页面自己画标题/图标/面包屑,我们只出表单 + 保存控件) |
+| **rc 线 ≤ 0.1.5-rc.3**(最新 rc 仍是这一支) | `settings.plugin.item`(key `code-server`) | 设置 → 插件 → Code Server 的自绘可折叠卡片(该插槽在新版**已退役**) |
 
 > 为什么必须跟着搬:上游 agent note《插件页上的插件配置》把配置从设置页搬到插件页,并**删掉了
 > `settings.plugin.item`**;插件页只在 `ledger.bundles.has(包名)` 时才渲染那块区域 —— 键写错或还用旧座位,
@@ -988,8 +1033,12 @@ host 探测顺序:`@jinsiyu/dshcs-vscode-server/vscode`(**0.2.0+ 正式布局**)
 | `claimExtensions` | `*` + 三组排除(预览友好 / 可执行文件 / Office 文档;完整清单见「认领类型」一节) | **认领类型**(0.2.11,取代 0.2.5 的 `fileOpenScope`):按扩展名决定哪些文件交给 VS Code,分号分隔;`*` = 其余类型也认领,`!ext` = 不认领(排除优先)。默认把 DSH 预览渲染得好的四类(markdown/html/图片/PDF)**以及可执行文件(0.3.51)与 Office 文档(0.3.51)**留给 DSH,其余全进 IDE;清空 = 不认领任何文件。**不再区分 session/absolute 作用域** |
 | `fullscreenOnOpen` | `true` | **打开即全屏**(0.2.9):打开 Code Server 标签(含点开文件)时自动把右侧栏切到全屏(铺满窗口);关闭则保持 DSH 默认的 push(与对话并排)。只影响打开那一刻,用户点「退出全屏」不会被抢回去 |
 | `keepResident` | `true` | **后台常驻**:开启后宿主启动即把 IDE 预加载到"停放区",切标签/收起侧栏不重载、首次打开免等待;关闭则只在打开面板时加载(省内存) |
+| `fim` | `false` | **FIM 补全(实验性,0.3.61)**:开启后编辑器里打字停顿会出现灰字续写(Tab 接受 / Esc 丢弃)。**默认关闭** —— 它是本插件唯一会把内容发出去的能力(每次补全把光标附近有上限的一小段代码交给模型),而且这条调用**不进 DSH 的 token 计量**,用量只在 IDE 状态栏可见。详见「FIM 补全」一节 |
+| `fimDebounceMs` | `250` | **FIM · 停顿毫秒数**(0.3.62):打字停下多久才发一次补全请求。有效范围 **100–3000ms**,保存时按它夹取(与宿主同一套规则);空/非法值回落 250 |
+| `fimMultiline` | `true` | **FIM · 允许多行补全**(0.3.62):关掉后宿主只回第一行(首行为空 = 这次不补)。实测模型在不该补的位置会硬凑,多行会放大这种噪声 |
+| `fimDisableGlobs` | 空 | **FIM · 按 glob 禁用**(0.3.62):分号/换行分隔。`*` 不跨目录、`**` 跨目录、不含 `/` 的模式只匹配文件名、含 `/` 的模式按路径尾段匹配、`/` 结尾视作 `/**`。例:`*.md`、`vendor/**`、`**/dist/**`。**两边都判**:扩展侧先判(根本不发请求),宿主侧再判一遍 |
 
-(0.2.9 起卡片只留上面三个设置;`windowedOpen` 与 `reserveComposer` 已移除 —— 旧设置文档里残留的键既不报错也不生效。
+(0.2.9 起卡片只留上面这些设置(0.3.61 加 FIM 补全,0.3.62 加它的三个子项);`windowedOpen` 与 `reserveComposer` 已移除 —— 旧设置文档里残留的键既不报错也不生效。
 `serve` 仍是设置命名空间里的键(便于用设置文档切换),但**没有卡片行**,见「服务方式」。)
 
 0.2.7 起卡片**没有**「入口」「依赖安装」「环境检测」三行:入口在右侧栏「开始」页的 Code Server 入口框(或官方的文件点击),
@@ -1113,6 +1162,19 @@ desktop profile 由 `apps/desktop-host` 把 `/api/*` 交给同一个 `createShar
     ```
   - 影响面:不只本插件——**任何**客户端插件升级后都可能继续跑旧代码;发布后请按上面的标记法确认渲染器真的换了 bundle。
 
+## 第三方与许可
+
+本项目自身以 **MIT** 发布(见 [`LICENSE`](LICENSE))。实验性 **FIM 补全**的设计**参考**了
+[continuedev/continue](https://github.com/continuedev/continue)(Apache License 2.0,Copyright 2023 Continue)——
+具体是它 `tabAutocompleteOptions` 的设置项划分(`debounceDelay` / `useAutocompleteMultilineCompletions` /
+`disableInFiles`)与停顿去抖、光标附近窗口、过滤、有界缓存的思路。
+
+**本项目不含 continuedev/continue 的任何源码片段、模板字符串或整份文件**(补全请求走 DeepSeek 官方
+FIM(Beta)端点,提示词形态由其官方文档与本机实测确定)。标准 Apache-2.0 全文随包分发
+([`LICENSE-Apache-2.0.txt`](LICENSE-Apache-2.0.txt)),逐处参考登记见
+[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md) —— 将来若真移植代码片段,Apache-2.0 的义务
+(声明、标注被改动文件、保留上游 NOTICE)已经就位。Apache-2.0 不含商标授权,本项目不使用 "Continue" 作名称或宣传。
+
 ## 已知限制
 
 - **~~编辑器桥需要 DSH 提供 `webServer`~~ 已不成立(0.3.13 修正)**:桥改走**本机 IPC**
@@ -1153,6 +1215,7 @@ desktop profile 由 `apps/desktop-host` 把 `/api/*` 交给同一个 `createShar
   `loopback` 模式跨源,`sandbox` 作为真防护保留。
 - **跨会话单实例**:host 级共享一份 IDE;切换 cwd 只换 workbench 目录(0.2.12 起不重启进程,旧目录的后台终端不会被收走)。
 - **旧版 DSH 不受支持(0.2.3 起)**:没有 `sidebarRightTabs`/`sidebarRight` 的 DSH 上,除设置页一条升级提示外无任何入口;
+  支持范围**只有两条线**(2026-09-22 收敛):rc 线 `0.1.5-rc.x`(旧座位 + 快照上的 `current`)与 alpha 线 `≥ 0.1.6-alpha.2`(新座位 + `sessionId` 标准 prop);更早的 alpha(`0.1.5-alpha.x`、`0.1.6-alpha.1`)**不单独支持** —— 形状与 rc 线相同,所以代码走得通,但不作为验证目标。
   旧版用户请留在 `0.2.2`(`dsh plugin --profile web add dsh-code-server-app@0.2.2`)。
 - **侧栏标签切换**(0.2.2 起不再重载):DSH 右侧栏只渲染当前激活标签的 body,React 卸载会移走 iframe;
   插件把 iframe 收成单例常驻面,用 `Element.moveBefore()`(状态保持型原子移动)在停靠位与文档级停放区之间搬,

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,60 @@
+# 第三方声明(Third-Party Notices)
+
+本项目 `dsh-code-server-app` 自身以 **MIT** 许可发布(见 [`LICENSE`](LICENSE))。
+在开发过程中**参考**过下列第三方开源项目,本文件登记参考范围、许可与本项目的处理方式。
+
+---
+
+## continuedev/continue —— Apache License 2.0
+
+| 项 | 值 |
+|---|---|
+| 上游 | https://github.com/continuedev/continue |
+| 参考时修订 | `5522c6f44ca0ac3528b37244818fbfa39b5af470`(`refs/heads/main`,2026-09-21 取) |
+| 许可 | **Apache License 2.0**,Copyright 2023 Continue |
+| 上游 `NOTICE` | **没有**(已核对根目录清单;将来若出现,按 Apache-2.0 一并保留) |
+| 许可全文 | [`LICENSE-Apache-2.0.txt`](LICENSE-Apache-2.0.txt)(标准 Apache-2.0 文本,11,357 字节,含 §9 与 APPENDIX) |
+
+### 参考了什么(逐处登记)
+
+| 本项目位置 | 参考内容 | 是否含上游代码 |
+|---|---|---|
+| `lib/fim-adapter.mjs`、`assets/extensions/dshcs-editor-bridge/lib/fim-completion.js` | 实验性 **FIM(幽灵)补全**的**设计**:停顿去抖、只送光标附近的窗口、结果过滤与单行化、有界缓存、按文件禁用;以及**设置项划分**(对应上游 `tabAutocompleteOptions` 的 `debounceDelay` / `useAutocompleteMultilineCompletions` / `disableInFiles`) | **否**,独立实现 |
+| `lib/index.js`、`lib/client.js`、`assets/extensions/dshcs-editor-bridge/extension.js` | 上述设计在本插件内的接线(桥的第五条路由、设置卡三行、内联补全 provider) | 否 |
+| `docs/analysis-continuedev-reuse.md` | 对上游模块的**事实性描述与判定**(路径、字节数、blob sha、用途) | 否(事实与评述) |
+
+**本项目的全部源码均为独立编写,不含 continuedev/continue 的任何源码片段、模板字符串或整份文件。**
+补全请求走的是 DeepSeek 官方的 FIM(Beta)端点(`POST https://api.deepseek.com/beta/completions`,
+参数 `prompt` + `suffix`),提示词形态由该官方文档与本机实测确定,与上游的 FIM 模板表无关
+(那张表在本机路由上实测不可用,见 `docs/analysis-continuedev-reuse.md` 的 B6)。
+
+### 将来若要移植上游代码片段,按 Apache-2.0 必须做到
+
+1. **标注被改动的文件**:在每个移植文件头部写明 `来源: continuedev/continue@<sha> <path> · Apache-2.0 · 已改动`;
+2. **保留版权与许可声明**:本文件 + `LICENSE-Apache-2.0.txt` 已经随包分发,移植时无需新增文件;
+3. **上游 `NOTICE` 若出现则一并保留**;
+4. **不含商标授权**:Apache-2.0 不授予商标权 —— 不得用 "Continue" 作为本项目的名称、包名或宣传语。
+
+---
+
+## 随包分发的第三方依赖
+
+本包依赖的第三方包(`@jinsiyu/dshcs-*`、`@vscode/*`、`@xterm/*`、`zod` 等)各自带有许可与声明文件,
+随 `node_modules` 一并分发,不在此重复登记;内嵌的 VS Code 树自带 `ThirdPartyNotices.txt`。
+
+---
+
+## English summary
+
+`dsh-code-server-app` is MIT-licensed (see `LICENSE`). Its experimental **FIM completion** feature was
+**designed with reference to** [continuedev/continue](https://github.com/continuedev/continue)
+(Apache License 2.0, Copyright 2023 Continue) — specifically the settings taxonomy of upstream
+`tabAutocompleteOptions` (`debounceDelay`, `useAutocompleteMultilineCompletions`, `disableInFiles`) and its
+debounce / cursor-window / filter / bounded-cache approach.
+
+**No source code, template strings, or files from continuedev/continue are included in this project**;
+every implementation here is independently written, and the completion requests target DeepSeek's official
+FIM (Beta) endpoint as documented by DeepSeek. The standard Apache License 2.0 text ships as
+`LICENSE-Apache-2.0.txt` so that Apache-2.0's obligations (notices, marking modified files, preserving an
+upstream `NOTICE` if one appears) are already satisfied should a code fragment ever be ported in.
+Apache-2.0 grants no trademark rights: "Continue" must not be used as this project's name or in its promotion.

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

@@ -38,6 +38,17 @@ const {
   createClient,
 } = require('./lib/bridge-client.js');
 const { createProjector } = require('./lib/context-model.js');
+const {
+  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');
 
 /** 状态栏项(仅在桥连通时显示)。 */
@@ -65,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');
@@ -404,6 +528,13 @@ async function pollOnce() {
     await handleEvent(event);
   }
   if ((result.events ?? []).length > 0) client.persist();
+  // 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 面板已退役):探测不到就只弹一条提示,
   // 绝不退回到一扇用户看不见的窗。
@@ -430,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 {
@@ -523,6 +669,7 @@ function showBridgeLog() {
 // ---------------------------------------------------------------- 激活
 
 function activate(context) {
+  extensionContext = context;
   output = vscode.window.createOutputChannel('DSH Editor Bridge');
   context.subscriptions.push(output);
 

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;
 /** 宿主配置重读间隔(端点/令牌轮换后最多这么久恢复)。 */
@@ -292,6 +295,9 @@ function createClient(options) {
           ok: true,
           events,
           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 };
@@ -328,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;
@@ -351,6 +386,7 @@ module.exports = {
   POLL_INTERVAL_MS,
   CONFIG_REREAD_MS,
   REQUEST_TIMEOUT_MS,
+  COMPLETE_TIMEOUT_MS,
   BridgeError,
   isBridgeEndpoint,
   defaultExtensionsDir,