dsh-vscode-mode 0.10.0 → 0.12.0

package/src/client/ui/commandCatalog.ts

@@ -1,12 +1,14 @@
 /**
  * dsh-vscode-mode client — 编辑器指令目录（纯元数据）。
- * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页、快捷键监听与 Monaco 右键菜单
- * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（可选 keybinding）。
+ * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页与 Monaco 右键菜单
+ * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（默认键位见 shared/keybindings SHORTCUT_PROFILES）。
  * run 只派发 `edrv.command.*` 窗口事件，不直接触碰 React/Monaco（`edrv.command.` 前缀
  * 与既有 `edrv:` 刷新/主题事件分属不同命名空间，互不干扰）。
  * 作者 ddj 2026年09月10号
  */
 import { hasEditorModel, hasOpenTabs } from '../editorModelState.js'
+import { activeEditorPath } from '../activePathStore.js'
+import { isMarkdownPath } from '../markdownPreview.js'
 import { svnCurrentStatus } from '../svnStatus.js'
 import { dapStore } from '../dap/store.js'
 import { svnActionOn, svnActionsFor } from '../../shared/svnActions.js'
@@ -22,8 +24,6 @@ export interface CommandDef {
   category: string
   /** 组内排序（小者优先）。 */
   order?: number
-  /** 默认键位弦（可选；可含 `|` 多候选）。声明后由快捷键设置页展示与录制。 */
-  keybinding?: string
   /** 运行体：派发窗口事件或直接执行。 */
   run: () => void
   /** 可用性判定（缺省视为始终可用；返回 false 时命令栏隐藏且 run 被拒）。 */
@@ -62,7 +62,7 @@ function alwaysAvailable(): boolean {
 function nextEditorRowDef(): CommandDef {
   return {
     id: 'edrv.nextEditorRow', label: '下一编辑行（光标整行下移）', category: '导航', order: 50,
-    keybinding: 'Ctrl+Alt+ArrowDown', available: needsModel,
+    available: needsModel,
     run: () => emit('nextEditorRow'),
   }
 }
@@ -75,7 +75,7 @@ function nextEditorRowDef(): CommandDef {
 function prevEditorRowDef(): CommandDef {
   return {
     id: 'edrv.prevEditorRow', label: '上一编辑行（光标整行上移）', category: '导航', order: 60,
-    keybinding: 'Ctrl+Alt+ArrowUp', available: needsModel,
+    available: needsModel,
     run: () => emit('prevEditorRow'),
   }
 }
@@ -88,7 +88,7 @@ function prevEditorRowDef(): CommandDef {
 function gotoLineDef(): CommandDef {
   return {
     id: 'edrv.goToLine', label: '转到行', category: '导航', order: 45,
-    keybinding: 'Ctrl+G', available: needsModel,
+    available: needsModel,
     run: () => emit('goToLine'),
   }
 }
@@ -102,7 +102,7 @@ function gotoLineDef(): CommandDef {
 function addSelectionRefDef(): CommandDef {
   return {
     id: 'edrv.addSelectionRef', label: '添加选中内容为引用', category: '编辑', order: 10,
-    keybinding: 'Ctrl+U', available: needsModel,
+    available: needsModel,
     run: () => emit('addSelectionRef'),
   }
 }
@@ -117,7 +117,7 @@ function addSelectionRefDef(): CommandDef {
 function closeTabDef(): CommandDef {
   return {
     id: 'edrv.closeTab', label: '关闭当前页签', category: '文件', order: 40,
-    keybinding: 'Ctrl+F4', available: hasOpenTabs,
+    available: hasOpenTabs,
     run: () => emit('closeTab'),
   }
 }
@@ -188,34 +188,39 @@ function svnEventOf(action: SvnActionDef): string {
 
 /**
  * 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
- * 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
- * 故不进 BRIDGE_COMMANDS，避免同一按键双执行。
- * @author ddj 2026年09月10号
+ * 键位派发已归官方 shortcuts 机制：默认键位表在 shared/keybindings.ts 的 SHORTCUT_PROFILES，
+ * 由 client/index.ts 经 shortcutsOfficial.registerOfficialShortcuts 注册，本目录只管
+ * 「标签/可用性/执行」。无默认键位的命令同样注册（官方 UI/插件子页内可自定义绑定）。
+ * @author ddj 2026年09月10号 / 2026年10月
  */
 export const EDITOR_COMMANDS: readonly CommandDef[] = [
   {
     id: 'edrv.save', label: '保存文件', category: '文件', order: 10,
-    keybinding: 'Ctrl+S', available: needsModel,
+    available: needsModel,
     run: () => emit('save'),
   },
   {
     id: 'edrv.quickOpen', label: '快速打开文件', category: '文件', order: 20,
-    keybinding: 'Ctrl+P', available: alwaysAvailable,
+    available: alwaysAvailable,
     run: () => emit('quickOpen'),
   },
   {
     id: 'edrv.toggleSidebar', label: '切换侧边栏', category: '视图', order: 10,
-    keybinding: 'Ctrl+B', available: alwaysAvailable,
+    available: alwaysAvailable,
     run: () => emit('toggleSidebar'),
   },
   {
     id: 'edrv.searchInFiles', label: '在工作区中搜索', category: '视图', order: 20,
-    keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
+    available: alwaysAvailable,
     run: () => emit('searchInFiles'),
   },
   {
     id: 'edrv.toggleMarkdownPreview', label: '切换 Markdown 预览', category: '视图', order: 25,
-    keybinding: 'Ctrl+Shift+V', available: alwaysAvailable,
+    // 仅活动文件是 .md 时可用（不可用时官方派发返回 pass 不吞键，保留浏览器「无格式粘贴」语义）
+    available: () => {
+      const path = activeEditorPath()
+      return typeof path === 'string' && isMarkdownPath(path)
+    },
     run: () => emit('toggleMarkdownPreview'),
   },
   {
@@ -225,22 +230,22 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
   },
   {
     id: 'edrv.navigateBack', label: '后退（导航历史）', category: '导航', order: 10,
-    keybinding: 'Alt+ArrowLeft|Ctrl+Alt+-', available: needsModel,
+    available: needsModel,
     run: () => emit('navigateBack'),
   },
   {
     id: 'edrv.navigateForward', label: '前进（导航历史）', category: '导航', order: 20,
-    keybinding: 'Alt+ArrowRight|Ctrl+Shift+-', available: needsModel,
+    available: needsModel,
     run: () => emit('navigateForward'),
   },
   {
     id: 'edrv.nextTab', label: '下一个页签', category: '导航', order: 30,
-    keybinding: 'Ctrl+Alt+ArrowRight|Ctrl+PageDown', available: needsModel,
+    available: needsModel,
     run: () => emit('nextTab'),
   },
   {
     id: 'edrv.prevTab', label: '上一个页签', category: '导航', order: 40,
-    keybinding: 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp', available: needsModel,
+    available: needsModel,
     run: () => emit('prevTab'),
   },
   {
@@ -291,41 +296,41 @@ function debugPaletteDefs(): CommandDef[] {
   return [
     {
       id: 'edrv.debugToggleBreakpoint', label: '调试：切换断点（光标行）', category: '调试', order: 10,
-      keybinding: 'F9', available: needsModel,
+      available: needsModel,
       run: () => emit('debugToggleBreakpoint'),
     },
     {
       id: 'edrv.debugStartContinue', label: '调试：启动 / 继续', category: '调试', order: 20,
-      keybinding: 'F5', available: canStart,
+      available: canStart,
       run: () => emit('debugStartContinue'),
     },
     {
       id: 'edrv.debugStepOver', label: '调试：单步跳过', category: '调试', order: 30,
-      keybinding: 'F10', available: paused,
+      available: paused,
       run: () => emit('debugStepOver'),
     },
     {
       id: 'edrv.debugStepInto', label: '调试：单步步入', category: '调试', order: 40,
-      keybinding: 'F11', available: paused,
+      available: paused,
       run: () => emit('debugStepInto'),
     },
     {
       id: 'edrv.debugStepOut', label: '调试：单步步出', category: '调试', order: 50,
-      keybinding: 'Shift+F11', available: paused,
+      available: paused,
       run: () => emit('debugStepOut'),
     },
     {
       id: 'edrv.debugStop', label: '调试：停止', category: '调试', order: 60,
-      keybinding: 'Shift+F5', available: canStop,
+      available: canStop,
       run: () => emit('debugStop'),
     },
   ]
 }
 
 /**
- * 桥接派发指令（无原生监听，键位由 commandBridge 统一 capture 处理）。
- * 新增「只填目录、不写监听」的编辑器指令一律放这里：键位、命令栏、设置页自动可用。
- * @author ddj 2026年09月10号
+ * 非编辑器原生路径的指令（键位统一由官方 shortcuts 机制派发；历史「桥接」分组名保留）。
+ * 新增「只填目录」的编辑器指令一律放这里：命令栏与官方快捷键目录自动可用。
+ * @author ddj 2026年09月10号 / 2026年10月
  */
 export const BRIDGE_COMMANDS: readonly CommandDef[] = [
   nextEditorRowDef(),
@@ -345,16 +350,6 @@ export const BRIDGE_COMMANDS: readonly CommandDef[] = [
 export function showCommandsDef(run: () => void): CommandDef {
   return {
     id: 'edrv.showCommands', label: '显示所有命令', category: '视图', order: 1,
-    keybinding: 'Ctrl+Shift+P|F1', available: alwaysAvailable, run,
+    available: alwaysAvailable, run,
   }
 }
-
-/**
- * 需要全局键位派发的指令（桥接类 + 命令栏自身；不含 EditorView/QuickOpen 原生监听的那些）。
- * @author ddj 2026年09月10号
- * @param showCommands 命令栏命令定义
- * @returns 派发集合
- */
-export function dispatchedCommands(showCommands: CommandDef): readonly CommandDef[] {
-  return [...BRIDGE_COMMANDS, showCommands]
-}

package/src/client/ui/svnUpdateModel.ts

@@ -0,0 +1,135 @@
+/**
+ * dsh-vscode-mode client — SVN 更新窗口的纯视图逻辑。
+ * @author ddj 2026年09月24号
+ */
+import type { SvnUpdatePhase, SvnUpdateRow } from '../../shared/svn.js'
+
+/**
+ * 只有真实终态允许直接关闭窗口。
+ * @author ddj 2026年09月24号
+ * @param phase 任务阶段
+ * @returns 是否结束
+ */
+export function updateDone(phase: SvnUpdatePhase | undefined): boolean {
+  return phase === 'completed' || phase === 'failed' || phase === 'cancelled'
+}
+
+/**
+ * 后端结束并不等于前端已取完全部结果页。
+ * @author ddj 2026年09月24号
+ * @param phase 后台状态
+ * @param pending 尚有未加载的明细
+ * @returns 结果界面是否完成
+ */
+export function updateReady(phase: SvnUpdatePhase | undefined, pending: boolean): boolean {
+  return updateDone(phase) && !pending
+}
+
+/**
+ * 取消或异常终止会在工作副本上留下 SVN 锁（E155037/E155004）；
+ * 只按失败态原文判定，不推测其他失败的原因。
+ * @author ddj 2026年09月28号
+ * @param state 任务快照
+ * @returns 是否需要先执行 cleanup
+ */
+export function updateLocked(state: { phase?: SvnUpdatePhase; error?: string; rawTail?: string } | null | undefined): boolean {
+  if (!state || state.phase !== 'failed') return false
+  const text = (state.error ?? '') + '\n' + (state.rawTail ?? '')
+  return /E155037|E155004|Previous operation has not finished|run 'cleanup'|Working copy .*locked|工作副本.*锁/i.test(text)
+}
+
+/**
+ * 菜单/二级对话框按 Esc 只关闭自己；连接中断后允许显式暂时关闭。
+ * @author ddj 2026年09月24号
+ * @param ready 已取完后台结果
+ * @param error 连接错误
+ * @param hasJob 是否知道后台 job
+ * @param overlay 子弹窗或菜单是否打开
+ * @returns 自动/显式关闭及确认要求
+ */
+export function updateCloseMode(ready: boolean, error: string, hasJob: boolean, overlay: boolean) {
+  const disconnected = Boolean(error && hasJob && !ready)
+  return {
+    passive: (ready || Boolean(error && !hasJob)) && !overlay,
+    explicit: ready || Boolean(error),
+    confirm: disconnected,
+  }
+}
+
+/**
+ * 窗口只能在发起它的同一会话、同一工作区作用域中挂载。
+ * @author ddj 2026年09月24号
+ * @param dialog 发起窗口时记录的身份
+ * @param sessionId 当前会话
+ * @param scope 当前工作区作用域
+ * @returns 是否允许挂载
+ */
+export function sameUpdateOwner(dialog: { sessionId?: string; scope?: string | null } | null,
+  sessionId?: string, scope?: string | null): boolean {
+  return Boolean(dialog && dialog.sessionId === sessionId && dialog.scope === scope)
+}
+
+/**
+ * 为数千条结果取可视区和小幅缓冲，行高由界面固定约束。
+ * @author ddj 2026年09月24号
+ * @param count 当前记录数
+ * @param scrollTop 列表滚动偏移
+ * @param height 列表高度
+ * @param rowHeight 固定行高
+ * @returns 可见的起止索引（尾部不含）
+ */
+export function updateRange(count: number, scrollTop: number, height: number, rowHeight: number): { start: number; end: number } {
+  const start = Math.min(count, Math.max(0, Math.floor(Math.max(0, scrollTop) / rowHeight) - 8))
+  const end = Math.min(count, Math.ceil((Math.max(0, scrollTop) + Math.max(0, height)) / rowHeight) + 8)
+  return { start, end }
+}
+
+/**
+ * 输出不等于文件真实类型；只给已知扩展名提供可辨识的类型推断。
+ * @author ddj 2026年09月24号
+ * @param path SVN 输出路径
+ * @returns 推断类型，未知为空
+ */
+export function updateType(path: string): string {
+  const ext = path.split('.').pop()?.toLowerCase()
+  const known: Record<string, string> = {
+    bytes: 'application/octet-stream', png: 'image/png', jpg: 'image/jpeg',
+    jpeg: 'image/jpeg', webp: 'image/webp', gif: 'image/gif', pdf: 'application/pdf',
+  }
+  return ext ? known[ext] ?? '' : ''
+}
+
+/**
+ * 行动作是否可用取决于更新是否结束、路径是否在工作区且磁盘是否有文件。
+ * @author ddj 2026年09月24号
+ * @param row 更新行
+ * @param phase 任务阶段
+ * @param kind 磁盘判型；未读到时仅开放父目录/复制
+ * @param revision 完成修订号
+ * @returns 菜单动作集合
+ */
+export function updateActs(row: SvnUpdateRow, phase: SvnUpdatePhase, kind: string, revision: number | null) {
+  const valid = updateDone(phase) && Boolean(row.relPath)
+  const file = valid && kind === 'file' && row.action !== 'D'
+  const binary = Boolean(updateType(row.path))
+  return {
+    compare: file && Boolean(revision) && !binary,
+    log: file,
+    open: file,
+    openWith: file,
+    parent: valid,
+    copy: Boolean(row.path),
+  }
+}
+
+/**
+ * 目录上下文使用工作区相对路径，根文件的父目录表示为工作区根。
+ * @author ddj 2026年09月24号
+ * @param path 工作区相对路径
+ * @returns 父目录相对路径
+ */
+export function updateParent(path: string): string {
+  const normalized = path.replace(/\\/g, '/')
+  const at = normalized.lastIndexOf('/')
+  return at < 0 ? '' : normalized.slice(0, at)
+}

package/src/fileOpenSettings.ts

@@ -407,6 +407,9 @@ export async function updateSection(provider: SettingsProvider | undefined, ns:
  * 构建设置 section schema（install 路径与插件 Config 声明共用，保证两代形状同源）。
  * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
  * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
+ * （keybindings 自 2026-10 起废弃停写：键位持久化归官方 shortcuts 存储
+ *   userData/keybindings.json / dsh.keybindings.v1；字段保留仅为旧档迁移读取与降级回滚，
+ *   见 client/shortcutsOfficial.ts 的 migrateLegacyKeybindings。）
  * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
  * options.volatile：DSH 0.1.7 线的 Config 导出专用——SettingsForms.describe 只下发
  * 含 volatile 字段的 entry（volatileForm 门槛），不标记则 ns 永不出现在 describe、

package/src/index.ts

@@ -123,6 +123,8 @@ export function apply(ctx: Ctx, config?: unknown): void {
   })
   // 卸载时清空文件版本基准表（观察器为模块内单例，不清会跨装配残留陈旧版本）
   ctx.effect(() => () => fileVersions.dispose())
+  // 卸载时结束仍在运行的 SVN 更新，避免无主工作副本更新继续写入
+  ctx.effect(() => () => svnRpc.dispose())
   // 卸载/重启时结束调试会话并强杀适配器子进程（防残留注入器/适配器孤儿）
   ctx.effect(() => () => dapRpc.dispose())
   // 宿主进程退出回收：ctx.effect 清理不覆盖进程退出，缺此注册会留下跨重启的孤儿服务器

package/src/lsp/completionCap.ts

@@ -0,0 +1,80 @@
+/**
+ * dsh-vscode-mode host — 补全结果的前缀感知截断（纯函数，node 可测）。
+ * 背景：RPC 层按固定上限硬截断补全条目，而本仓库的 xLua 绑定桩
+ * （Assets/Scripts/EmmyLuaDefine，形如 CS_IslandSplash_Extensions_Common_ArrayExtension）
+ * 有上万个全局，字母序会把项目自身全局（ECommon / EActivity 等）挤到上限之外；
+ * 截断发生在 Monaco 前缀过滤之前，因此**之后无论输入什么都取不回**该条目。
+ * 改为按当前输入前缀分桶后截断：优先保留真实命中的条目；未超限时零行为变化。
+ * 作者 ddj 2026年09月24号
+ */
+import type { LspCompletionItem } from '../shared/lsp.js'
+
+/** 单次补全返回条目上限（RPC 载荷护栏，与 references 同口径）。 */
+export const COMPLETION_ITEM_CAP = 500
+
+/** 截断结果：items 恒不超上限；truncated 标记本轮是否发生了丢弃。 */
+export interface CappedCompletions {
+  items: LspCompletionItem[]
+  truncated: boolean
+}
+
+/**
+ * 判断 needle 是否为 haystack 的子序列（两侧均已小写）。
+ *
+ * 与 Monaco 候选列表的模糊匹配同口径，保证「分桶判为命中」的条目确实是
+ * 用户输入能筛出来的那些，避免分桶顺序与前端过滤结果互相矛盾。
+ * @author ddj 2026年09月24号
+ * @param haystack 候选文本（已小写）
+ * @param needle 输入前缀（已小写、非空）
+ * @returns 是否为子序列
+ */
+function isSubsequence(haystack: string, needle: string): boolean {
+  let matched = 0
+  for (let i = 0; i < haystack.length && matched < needle.length; i++) {
+    if (haystack[i] === needle[matched]) matched++
+  }
+  return matched === needle.length
+}
+
+/**
+ * 取补全项的匹配文本（Monaco 口径：filterText 优先，回落 label；统一小写）。
+ * @author ddj 2026年09月24号
+ * @param item 补全项
+ * @returns 小写匹配文本；无可用文本时为空串
+ */
+function textOfItem(item: LspCompletionItem): string {
+  const raw = typeof item?.filterText === 'string' && item.filterText ? item.filterText : item?.label
+  return typeof raw === 'string' ? raw.toLowerCase() : ''
+}
+
+/**
+ * 按输入前缀分桶后截断补全列表。
+ *
+ * 分桶优先级：startsWith > includes > 子序列 > 其余；桶内保持服务器原始顺序
+ * （服务器已按相关性排序，不重新打分）。无前缀或未超限时与旧行为完全一致。
+ * @author ddj 2026年09月24号
+ * @param items 服务器归一化后的补全条目
+ * @param prefix 当前输入前缀（Monaco getWordUntilPosition 的词）
+ * @param cap 条目上限（缺省 COMPLETION_ITEM_CAP；测试可注入小值）
+ * @returns 有界条目与截断标记
+ */
+export function capCompletions(
+  items: LspCompletionItem[],
+  prefix?: string,
+  cap: number = COMPLETION_ITEM_CAP,
+): CappedCompletions {
+  if (!Array.isArray(items)) return { items: [], truncated: false }
+  if (items.length <= cap) return { items, truncated: false }
+  const needle = String(prefix ?? '').toLowerCase()
+  if (!needle) return { items: items.slice(0, cap), truncated: true }
+  const buckets: LspCompletionItem[][] = [[], [], [], []]
+  for (const item of items) {
+    const text = textOfItem(item)
+    if (text.startsWith(needle)) buckets[0].push(item)
+    else if (text.includes(needle)) buckets[1].push(item)
+    else if (isSubsequence(text, needle)) buckets[2].push(item)
+    else buckets[3].push(item)
+  }
+  const ordered = buckets[0].concat(buckets[1], buckets[2], buckets[3])
+  return { items: ordered.slice(0, cap), truncated: true }
+}

package/src/lsp/manager.ts

@@ -12,11 +12,13 @@ interface Entry {
   server: LspServer
   refs: number
   failures: number
+  readyAt: number
   restartTimer: ReturnType<typeof setTimeout> | null
 }
 
 const BACKOFF_MS = [1000, 5000, 30000]
 const MAX_FAILURES = 3
+const STABLE_MS = 60000
 
 export interface LspManager {
   /** 获取（或惰性创建）某工作区+语言的服务器；refs+1。 */
@@ -51,6 +53,19 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
 
   const log = (line: string): void => logger?.('[lsp-manager] ' + line)
 
+  /**
+   * 重试耗尽后保留退出根因，并让 UI 不再误报“未启动”。
+   * @author ddj 2026年09月24号
+   * @param entry 服务器条目
+   * @returns 当前可见状态
+   */
+  const statusOf = (entry: Entry): LspServerStatus => {
+    const status = entry.server.status()
+    return entry.failures >= MAX_FAILURES
+      ? { ...status, phase: 'unavailable', reason: (status.reason ?? '服务器已退出') + '（已停止自动重试）' }
+      : status
+  }
+
   /** 同步摘除注册表项并后台回收（refs 归零/工作区清理用；statusAll 立即可见归零）。 */
   const dropEntry = (entry: Entry): void => {
     if (entry.restartTimer) {
@@ -62,20 +77,22 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
   }
 
   const scheduleRestart = (entry: Entry): void => {
-    if (entry.restartTimer) return
+    if (entry.restartTimer || entry.refs === 0 || entries.get(entry.key) !== entry) return
     if (entry.failures >= MAX_FAILURES) {
       log('unavailable after ' + entry.failures + ' failures: ' + entry.key)
+      manager.onStatusChange?.(statusOf(entry))
       return
     }
-    const delay = BACKOFF_MS[Math.min(entry.failures, BACKOFF_MS.length - 1)]
+    const delay = BACKOFF_MS[Math.min(Math.max(entry.failures - 1, 0), BACKOFF_MS.length - 1)]
     entry.restartTimer = setTimeout(() => {
       entry.restartTimer = null
-      if (!entries.has(entry.key)) return
+      if (entries.get(entry.key) !== entry || entry.refs === 0) return
       void (async () => {
         const ok = await entry.server.start()
-        if (!ok) entry.failures++
-        else entry.failures = 0
-        if (!ok && entries.has(entry.key)) scheduleRestart(entry)
+        if (!ok && entries.get(entry.key) === entry && !entry.restartTimer) {
+          entry.failures++
+          scheduleRestart(entry)
+        }
       })()
     }, delay)
   }
@@ -87,13 +104,28 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
       if (!entry) {
         const spec = resolveSpec(languageId)
         const server = createLspServer(spec, root, languageId, log)
-        server.onStateChange = (status) => manager.onStatusChange?.(status)
-        entry = { key, server, refs: 0, failures: 0, restartTimer: null }
+        entry = { key, server, refs: 0, failures: 0, readyAt: 0, restartTimer: null }
         entries.set(key, entry)
+        server.onStateChange = (status) => {
+          const live = entries.get(key)
+          if (live?.server === server) {
+            if (status.phase === 'ready' && live.readyAt === 0) live.readyAt = Date.now()
+            if (status.phase === 'idle' && status.reason?.startsWith('服务器已退出')) {
+              if (live.readyAt && Date.now() - live.readyAt >= STABLE_MS) live.failures = 0
+              live.failures++
+              live.readyAt = 0
+              scheduleRestart(live)
+            }
+          }
+          manager.onStatusChange?.(live?.server === server ? statusOf(live) : status)
+        }
         // 惰性启动：若 spec ready 才启动，否则保持 idle（供 status 展示 reason）
         if (spec.ready) {
           void server.start().then((ok) => {
-            if (!ok && entries.has(key)) entry!.failures++
+            if (!ok && entries.get(key) === entry && server.phase === 'idle' && !entry!.restartTimer) {
+              entry!.failures++
+              scheduleRestart(entry!)
+            }
           })
         }
       }
@@ -126,7 +158,7 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
     },
 
     statusAll(): LspServerStatus[] {
-      return [...entries.values()].map((entry) => entry.server.status())
+      return [...entries.values()].map(statusOf)
     },
 
     peek(root: string, languageId: string): LspServer | undefined {

package/src/lsp/rpc.ts

@@ -10,6 +10,7 @@ import { searchRoot } from '../search/ripgrep.js'
 import { sessionOf, cwdOf } from '../registry.js'
 import { resolveProviderSpec, langOfPath, configFromPlugin, mergeConfig, sanitizeLang, LSP_LANGUAGES, type LspConfig, type LspLangConfig } from './config.js'
 import { clearProviderCache, candidatesFor } from './providers.js'
+import { capCompletions } from './completionCap.js'
 import { onRuntimeProvisioned, envInstallStates } from './dotnetProvision.js'
 import { envRequirementsFor, installRequirement } from './envRequirements.js'
 import type { LspManager } from './manager.js'
@@ -451,11 +452,13 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
           args.context,
         )
         if (!completions) return { ok: true, completions: undefined }
-        const truncated = completions.items.length > 500
-        return {
-          ok: true,
-          completions: truncated ? { ...completions, items: completions.items.slice(0, 500), truncated: true } : completions,
-        }
+        // 前缀感知截断：超限时按当前输入前缀分桶，保证正在打的符号不被挤出上限
+        // （本仓库上万个 CS_* 绑定桩会把 ECommon 等项目全局顶到 500 条之外）。
+        const capped = capCompletions(completions.items, args.prefix)
+        const payload = { ...completions, items: capped.items }
+        if (capped.truncated) payload.truncated = true
+        else delete payload.truncated
+        return { ok: true, completions: payload }
       } catch (error) {
         return { ok: false, error: 'LSP 补全查询失败：' + String(error) }
       }

package/src/lsp/server.ts

@@ -57,6 +57,19 @@ interface OpenDoc {
 }
 
 const RESTARTABLE = true
+const MAX_DOC_VERSION = 2147483647
+
+/**
+ * 使用合法、递增的 Int32 文档版本；旧客户端的毫秒时间戳不能直发给 Roslyn。
+ * @author ddj 2026年09月24号
+ * @param incoming 客户端传来的版本
+ * @param previous 当前服务器记录的版本
+ * @returns 可发送给语言服务器的版本
+ */
+export function lspDocVersion(incoming: number, previous?: number): number {
+  const next = Math.min(MAX_DOC_VERSION, (previous ?? 0) + 1)
+  return Number.isInteger(incoming) && incoming >= next && incoming <= MAX_DOC_VERSION ? incoming : next
+}
 
 /**
  * 创建语言服务器会话。
@@ -237,21 +250,22 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
     sync(path: string, text: string, version: number): void {
       const existing = docs.get(path)
       const uri = existing?.uri ?? docUriOf(path)
+      const safeVersion = lspDocVersion(version, existing?.version)
       if (existing) {
-        existing.version = version
+        existing.version = safeVersion
         existing.text = text
         if (phase === 'ready' || phase === 'indexing') {
           client?.notify('textDocument/didChange', {
-            textDocument: { uri, version },
+            textDocument: { uri, version: safeVersion },
             contentChanges: [{ text }],
           })
         }
         return
       }
-      docs.set(path, { path, uri, version, text })
+      docs.set(path, { path, uri, version: safeVersion, text })
       if (phase === 'ready' || phase === 'indexing') {
         client?.notify('textDocument/didOpen', {
-          textDocument: { uri, languageId, version, text },
+          textDocument: { uri, languageId, version: safeVersion, text },
         })
       }
     },