dsh-vscode-mode 0.1.36 → 0.1.43

package/src/compat.ts

@@ -10,8 +10,9 @@ import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { entriesOf } from './mcp.js'
-import { loadSettingsDeps } from './fileOpenSettings.js'
+import { loadSettingsDeps, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
+import { compareDshVersions, detectDshVersion, familyLabel, parseDshVersion } from './dshVersion.js'
 import type { CompatAdapter, CompatReport } from './shared/compat.js'
 import type { Ctx } from './store.js'
 import { ROUTE_PREFIX } from './paths.js'
@@ -127,24 +128,64 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
   ]
 }
 
+/** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
+const TESTED_DSH_MAX = '0.1.2-alpha.4'
+
+/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
+export function versionAdapters(dshVersion: string): CompatAdapter[] {
+  const adapters: CompatAdapter[] = []
+  const parsed = parseDshVersion(dshVersion)
+  if (dshVersion === '') {
+    adapters.push({ name: 'DSH 版本', active: false, note: '未探测到版本号（能力探测模式运行）' })
+  } else if (!parsed) {
+    adapters.push({ name: 'DSH 版本', active: false, note: '无法解析版本号 ' + dshVersion + '（能力探测模式运行）' })
+  } else {
+    adapters.push({ name: 'DSH 版本', active: true, note: dshVersion + ' · ' + familyLabel(dshVersion) })
+  }
+  const strategy = settingsInstallStrategy()
+  adapters.push({
+    name: '设置 section 安装（版本适配）',
+    active: strategy === 'legacy' || strategy === 'service',
+    note: settingsInstallNote(),
+  })
+  return adapters
+}
+
 /**
  * 构建完整兼容性报告（RPC 与启动日志共用）。
- * @author ddj 2026年08月24号
+ * @author ddj 2026年08月24号 / 2026年09月02号
  * @param ctx DSH host 上下文
- * @param options 测试注入：depsAvailable 跳过动态导入、version 固定版本号
+ * @param options 测试注入：depsAvailable 跳过动态导入、version 固定插件版本、dshVersion 固定 DSH 版本
  * @returns 兼容性报告
  */
 export async function buildReport(
   ctx: Ctx,
-  options?: { depsAvailable?: boolean; version?: string },
+  options?: { depsAvailable?: boolean; version?: string; dshVersion?: string },
 ): Promise<CompatReport> {
   const deps = options?.depsAvailable ?? (await loadSettingsDeps()) !== null
+  const dshVersion = options?.dshVersion ?? detectDshVersion()
   const external = detectExternal(ctx, deps)
   const guards = detectGuards(ctx)
+  const adapters = versionAdapters(dshVersion)
   const warnings: string[] = []
   if (!deps) warnings.push('未安装 @deepseek-ai/dsh-settings：文件打开工具设置持久化不可用（降级为配置值）')
+  const strategy = settingsInstallStrategy()
+  if (strategy === 'none') warnings.push('设置 section 安装不可用：' + settingsInstallNote())
+  const parsed = parseDshVersion(dshVersion)
+  const testedMax = parseDshVersion(TESTED_DSH_MAX)
+  if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) {
+    warnings.push('DSH ' + dshVersion + ' 高于已实测版本（' + TESTED_DSH_MAX + '）：设置 API 按能力探测运行，异常时请回报适配矩阵')
+  }
   for (const guard of guards) {
     if (!guard.active && guard.note) warnings.push(guard.note)
   }
-  return { pluginVersion: options?.version ?? pluginVersionOf(), external, guards, warnings, devForm: readDevForm() }
+  return {
+    pluginVersion: options?.version ?? pluginVersionOf(),
+    external,
+    guards,
+    adapters,
+    warnings,
+    devForm: readDevForm(),
+    dshVersion,
+  }
 }

package/src/dshVersion.ts

@@ -0,0 +1,121 @@
+/**
+ * dsh-vscode-mode host — DSH 核心版本探测与区间匹配（版本适配机制的地基）。
+ * 约定：以运行时可解析的 @deepseek-ai/dsh-settings 包版本代表 DSH 核心版本——
+ * 核心包发布锁步同版（rc.2 / alpha.2 全树同版实证），且该包是插件动态依赖面、
+ * exports 已放行 ./package.json。解析失败按候选降级（dsh-web-app / dsh-base / dsh），
+ * 全部失败返回空串（报告显示"未探测"，功能按能力探测运行）。
+ * 纯函数（parse / compare / inRange / familyLabel）可在 node 环境单测。
+ * 作者 ddj 2026-09-02
+ */
+import { readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+
+/** 归一化版本：主/次/补丁 + 预发布标识数组（0.1.2-alpha.2 → pre=['alpha','2']）。 */
+export interface DshVersion {
+  major: number
+  minor: number
+  patch: number
+  pre: string[]
+}
+
+const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/
+
+/** 解析版本串；非法返回 null（不抛错）。 */
+export function parseDshVersion(input: string): DshVersion | null {
+  const match = VERSION_RE.exec(input.trim())
+  if (!match) return null
+  return {
+    major: Number(match[1]),
+    minor: Number(match[2]),
+    patch: Number(match[3]),
+    pre: match[4] ? match[4].split('.') : [],
+  }
+}
+
+/** 预发布标识比较：纯数字按值；数字段 < 字母段；字母按字典序（semver 规则）。 */
+function comparePreId(a: string, b: string): number {
+  const numericA = /^\d+$/.test(a)
+  const numericB = /^\d+$/.test(b)
+  if (numericA && numericB) return Number(a) - Number(b)
+  if (numericA !== numericB) return numericA ? -1 : 1
+  return a < b ? -1 : a > b ? 1 : 0
+}
+
+/** 比较两个已解析版本：a<b → -1；相等 → 0；a>b → 1。 */
+export function compareDshVersions(a: DshVersion, b: DshVersion): number {
+  for (const key of ['major', 'minor', 'patch'] as const) {
+    if (a[key] !== b[key]) return a[key] < b[key] ? -1 : 1
+  }
+  const samePre = a.pre.length === b.pre.length && a.pre.every((part, index) => part === b.pre[index])
+  if (samePre) return 0
+  if (a.pre.length === 0) return 1
+  if (b.pre.length === 0) return -1
+  const length = Math.max(a.pre.length, b.pre.length)
+  for (let i = 0; i < length; i++) {
+    const left = a.pre[i]
+    const right = b.pre[i]
+    if (left === undefined) return -1
+    if (right === undefined) return 1
+    const cmp = comparePreId(left, right)
+    if (cmp !== 0) return cmp
+  }
+  return 0
+}
+
+/** 版本区间（含端点）：from/to 为空表示该侧不设界。 */
+export interface DshRange {
+  from?: string
+  to?: string
+}
+
+/** 版本是否落在区间内（入参解析失败一律不命中）。 */
+export function inDshRange(version: DshVersion | null | undefined, range: DshRange): boolean {
+  if (!version) return false
+  if (range.from) {
+    const lower = parseDshVersion(range.from)
+    if (!lower || compareDshVersions(version, lower) < 0) return false
+  }
+  if (range.to) {
+    const upper = parseDshVersion(range.to)
+    if (!upper || compareDshVersions(version, upper) > 0) return false
+  }
+  return true
+}
+
+/** 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。 */
+export function familyLabel(input: string): string {
+  const version = parseDshVersion(input)
+  if (!version) return '未知'
+  if (inDshRange(version, { from: '0.1.2-alpha.1' })) return '0.1.2-alpha 及更新（设置 API=settings.installSection）'
+  return '0.1.0/0.1.1 rc 线（设置 API=installSettingsSection）'
+}
+
+/** 探测候选：按与插件运行环境相关性排序，逐个尝试解析 package.json。 */
+const VERSION_CANDIDATES = [
+  '@deepseek-ai/dsh-settings/package.json',
+  '@deepseek-ai/dsh-web-app/package.json',
+  '@deepseek-ai/dsh-base/package.json',
+  '@deepseek-ai/dsh/package.json',
+]
+
+let detectedVersion: string | undefined
+
+/** 探测运行中 DSH 核心版本（模块级缓存；失败空串，不抛错）。 */
+export function detectDshVersion(): string {
+  if (detectedVersion !== undefined) return detectedVersion
+  detectedVersion = ''
+  const require = createRequire(import.meta.url)
+  for (const specifier of VERSION_CANDIDATES) {
+    try {
+      const file = require.resolve(specifier)
+      const pkg = JSON.parse(readFileSync(file, 'utf8')) as { version?: unknown }
+      if (typeof pkg.version === 'string' && parseDshVersion(pkg.version) !== null) {
+        detectedVersion = pkg.version
+        break
+      }
+    } catch {
+      /* exports 未放行或包缺失：尝试下一个候选 */
+    }
+  }
+  return detectedVersion
+}

package/src/fileOpenSettings.ts

@@ -1,8 +1,11 @@
 /**
  * dsh-vscode-mode host — 文件链接打开工具 + 快捷键的持久化设置。
- * 依赖守卫：@deepseek-ai/dsh-settings / schemastery 以动态加载引入，
- * 缺失时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见）。
- * 作者 ddj 2026年08月24号 / 2026年08月26号
+ * 依赖守卫：schemastery 动态加载；@deepseek-ai/dsh-settings 仅作 legacy 探测——
+ * rc 线导出 installSettingsSection free function，0.1.2-alpha 起移除（改由 settings
+ * 服务的 installSection 方法承载，见 runSettingsInstall 三策略）。
+ * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
+ * 全程 try/catch，不产生未捕获 rejection。
+ * 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号
  */
 import type { Ctx } from './store.js'
 import { KEYBINDING_DEFAULTS } from './shared/keybindings.js'
@@ -20,7 +23,7 @@ type SettingsProvider = {
 
 /** 动态依赖的装载结果（宽松类型：dsh-settings 无本地类型声明）。 */
 export interface SettingsDeps {
-  installSettingsSection: (ctx: Ctx, ns: string, schema: unknown, entry: object, hooks: object) => void
+  installSettingsSection?: (ctx: Ctx, ns: string, schema: unknown, entry: object, hooks: object) => void
   z: {
     object: (shape: Record<string, unknown>) => { default: (value: Record<string, unknown>) => unknown }
     string: () => { default: (value: string) => unknown }
@@ -33,19 +36,9 @@ export type SettingsDepsLoader = () => Promise<SettingsDeps | null>
 let depsPromise: Promise<SettingsDeps | null> | undefined
 
 /**
- * 按命令目录构建 keybindings 显式键形状（每键独立默认值）。
- * @author ddj 2026年08月26号
- * @param z schemastery 命名空间
- * @returns keybindings 字段形状
- */
-function keybindingsShape(z: SettingsDeps['z']): Record<string, unknown> {
-  const shape: Record<string, unknown> = {}
-  for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord)
-  return shape
-}
-
-/**
- * 动态加载设置依赖（模块级缓存；任一缺失返回 null 而非抛错）。
+ * 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
+ * installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
+ * 属性探测得到 undefined，不抛错）。
  * @author ddj 2026年08月24号
  * @returns 设置依赖或 null
  */
@@ -53,14 +46,132 @@ export function loadSettingsDeps(): Promise<SettingsDeps | null> {
   if (!depsPromise) {
     depsPromise = Promise.all([import('@deepseek-ai/dsh-settings'), import('schemastery')])
       .then(([dshSettings, schemastery]) => ({
-        installSettingsSection: (dshSettings as { installSettingsSection: SettingsDeps['installSettingsSection'] }).installSettingsSection,
-        z: (schemastery as { default: SettingsDeps['z'] }).default,
+        // dsh-settings 类型声明随版本变化（rc.8 有 d.ts、alpha 已移除导出），统一经 unknown 松绑
+        installSettingsSection: (dshSettings as unknown as { installSettingsSection?: SettingsDeps['installSettingsSection'] }).installSettingsSection,
+        z: (schemastery as unknown as { default: SettingsDeps['z'] }).default,
       }))
       .catch(() => null)
   }
   return depsPromise
 }
 
+/** 设置 section 安装策略（版本适配机制的观测值）。 */
+export type SettingsInstallStrategy = 'legacy' | 'service' | 'none' | 'unknown'
+
+const INSTALL_UNMOUNTED = '设置 section 尚未装配'
+const INSTALL_LEGACY = 'rc 线：dsh-settings.installSettingsSection'
+const INSTALL_SERVICE = '0.1.2-alpha 线：settings 服务 installSection'
+const INSTALL_NONE = '两路均不可用：设置持久化降级为配置值'
+
+interface ObservedInstall { strategy: SettingsInstallStrategy; note: string }
+let observedInstall: ObservedInstall = { strategy: 'unknown', note: INSTALL_UNMOUNTED }
+
+/** 记录最近一次安装策略（供兼容报告展示；失败路径也记录，便于诊断）。 */
+function recordInstall(strategy: SettingsInstallStrategy, note: string): SettingsInstallStrategy {
+  observedInstall = { strategy, note }
+  return strategy
+}
+
+/** 读取观测到的安装策略（供报告；测试可用 reset 复位）。 */
+export function settingsInstallStrategy(): SettingsInstallStrategy {
+  return observedInstall.strategy
+}
+
+/** 读取观测到的安装策略说明文案。 */
+export function settingsInstallNote(): string {
+  return observedInstall.note
+}
+
+/** 复位安装策略观测（测试隔离用）。 */
+export function resetSettingsInstallObserved(): void {
+  observedInstall = { strategy: 'unknown', note: INSTALL_UNMOUNTED }
+}
+
+/**
+ * 设置 section 版本自适应安装（核心策略分派）。
+ * legacy：dsh-settings 仍导出 installSettingsSection（rc 线）→ 原样调用，行为与旧版一致。
+ * service：该导出已移除（0.1.2-alpha 起）→ 经 ctx.inject(['settings']) 走服务方法
+ *          provider.installSection(owner, ns, schema, entry, hooks)（等义封装，含
+ *          base 层与 fiber 卸载回退）。回调内方法缺失再降级记录 none。
+ * none：两条路由都不存在 → 仅记录并告警，调用方按配置值运行。
+ * 全程不抛错、不产生未捕获 rejection。
+ * @author ddj 2026年09月02号
+ * @param ctx DSH host 上下文（inject 可选探测）
+ * @param ns 设置命名空间
+ * @param schema schemastery schema
+ * @param entry 初始设置值（作为 base 层）
+ * @param hooks 设置源绑定与变更回调
+ * @param loader 依赖装载器（测试注入）
+ * @returns 采用/观测到的策略
+ */
+export async function runSettingsInstall(
+  ctx: Ctx,
+  ns: string,
+  schema: unknown,
+  entry: object,
+  hooks: { setSource: (source: () => unknown) => void; onChange: () => void; validate?: unknown },
+  loader: SettingsDepsLoader = loadSettingsDeps,
+): Promise<SettingsInstallStrategy> {
+  let deps: SettingsDeps | null = null
+  try {
+    deps = await loader()
+  } catch {
+    /* 装载失败按缺失处理 */
+  }
+  if (!deps) {
+    console.warn('[dsh-vscode-mode] 设置依赖不可用，section ' + ns + ' 未安装（配置回退）')
+    return recordInstall('none', INSTALL_NONE)
+  }
+  const legacy = deps.installSettingsSection
+  if (typeof legacy === 'function') {
+    try {
+      legacy(ctx, ns, schema, entry, hooks)
+      return recordInstall('legacy', INSTALL_LEGACY)
+    } catch (error) {
+      console.warn('[dsh-vscode-mode] legacy 设置安装失败，尝试服务路由：' + String(error))
+    }
+  }
+  const ctxInject = (ctx as unknown as { inject?: (services: string[], callback: (sctx: unknown) => void) => unknown }).inject
+  if (typeof ctxInject !== 'function') return recordInstall('none', INSTALL_NONE)
+  try {
+    ctxInject(['settings'], (sctx: unknown) => {
+      const sc = sctx as { get?: (name: string) => unknown; settings?: unknown }
+      const provider = typeof sc.get === 'function' ? sc.get('settings') : sc.settings
+      const install = (provider as { installSection?: unknown } | undefined)?.installSection
+      if (typeof install !== 'function') {
+        console.warn('[dsh-vscode-mode] settings 服务无 installSection（DSH 版本 API 变化），section ' + ns + ' 降级为配置值')
+        recordInstall('none', INSTALL_NONE)
+        return
+      }
+      try {
+        install.call(provider, ctx, ns, schema, entry, hooks)
+        recordInstall('service', INSTALL_SERVICE)
+      } catch (error) {
+        console.warn('[dsh-vscode-mode] settings.installSection 安装失败（' + String(error) + '），section ' + ns + ' 降级为配置值')
+        recordInstall('none', INSTALL_NONE)
+      }
+    })
+  } catch (error) {
+    console.warn('[dsh-vscode-mode] settings 服务路由不可用（' + String(error) + '）')
+    return recordInstall('none', INSTALL_NONE)
+  }
+  // inject 回调若同步执行（settings 已就绪）会覆写观测值；仍未执行（unknown）时乐观按 service 记录
+  if (observedInstall.strategy !== 'unknown') return observedInstall.strategy
+  return recordInstall('service', '已调度 settings 服务 installSection（等待 settings 就绪）')
+}
+
+/**
+ * 按命令目录构建 keybindings 显式键形状（每键独立默认值）。
+ * @author ddj 2026年08月26号
+ * @param z schemastery 命名空间
+ * @returns keybindings 字段形状
+ */
+function keybindingsShape(z: SettingsDeps['z']): Record<string, unknown> {
+  const shape: Record<string, unknown> = {}
+  for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord)
+  return shape
+}
+
 function normalizeValue(value: unknown): string {
   if (typeof value !== 'string' || value.trim() === '') return FILE_OPEN_DEFAULT
   return value.trim()
@@ -71,8 +182,8 @@ function configValue(config: unknown): string {
 }
 
 /**
- * 安装设置 section（动态依赖；缺失返回 false 不抛错）。
- * @author ddj 2026年08月24号
+ * 安装设置 section（版本自适应；任一策略不可用返回 false 不抛错）。
+ * @author ddj 2026年08月24号 / 2026年09月02号
  * @param ctx DSH host 上下文
  * @param ns 设置命名空间
  * @param entry 初始设置值
@@ -87,14 +198,22 @@ export async function installOpenSettingsSection(
   hooks: { setSource: (source: () => FileOpenSettings) => void; onChange: () => void },
   loader: SettingsDepsLoader = loadSettingsDeps,
 ): Promise<boolean> {
-  const deps = await loader()
+  let deps: SettingsDeps | null = null
+  try {
+    deps = await loader()
+  } catch {
+    /* 装载失败按缺失处理 */
+  }
   if (!deps) return false
   const schema = deps.z.object({
     fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT),
     keybindings: deps.z.object(keybindingsShape(deps.z)).default({ ...KEYBINDING_DEFAULTS }),
   })
-  deps.installSettingsSection(ctx, ns, schema, entry, hooks)
-  return true
+  const strategy = await runSettingsInstall(ctx, ns, schema, entry, {
+    setSource: (source) => hooks.setSource(source as () => FileOpenSettings),
+    onChange: hooks.onChange,
+  }, loader)
+  return strategy === 'legacy' || strategy === 'service'
 }
 
 /**

package/src/host-deps.d.ts

@@ -3,12 +3,12 @@ declare module 'schemastery' {
   export default schema
 }
 
-declare module '@deepseek-ai/dsh-settings' {
-  export function installSettingsSection(...args: any[]): void
-  export function settingsNamespace(value: string): string
-}
-
 declare module '@deepseek-ai/schemastery' {
   const schema: any
   export default schema
 }
+
+// @deepseek-ai/dsh-settings 不在此声明：rc 线导出 installSettingsSection /
+// settingsNamespace，0.1.2-alpha 起移除（改由 settings 服务 installSection 方法承载）。
+// fileOpenSettings.ts 以动态导入 + 属性探测方式访问，见 SettingsDeps.installSettingsSection。
+

package/src/index.ts

@@ -92,7 +92,8 @@ async function logCompatSummary(ctx: Ctx, warnings: string[]): Promise<void> {
     for (const warning of warnings) report.warnings.push(warning)
     const logger = ctx.logger
     if (!logger?.info) return
-    const head = '[' + PLUGIN_NAME + '] 兼容性：' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏'
+    const dsh = report.dshVersion ? 'DSH ' + report.dshVersion : 'DSH 未探测'
+    const head = '[' + PLUGIN_NAME + '] 兼容性：' + dsh + ' · ' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏 / ' + (report.adapters?.length ?? 0) + ' 项版本适配'
     if (report.warnings.length) {
       logger.warn?.(head + '，警告 ' + report.warnings.length + ' 条：' + report.warnings.join('；'))
     } else {

package/src/lsp/client.ts

@@ -5,7 +5,7 @@
  * 作者 ddj 2026-08-27
  */
 import { createFrameParser, encodeMessage, requestMessage, notifyMessage } from './jsonrpc.js'
-import type { LspServerCapabilities } from '../shared/lsp.js'
+import { LSP_SEMANTIC_TOKEN_TYPES, LSP_SEMANTIC_TOKEN_MODIFIERS, type LspServerCapabilities } from '../shared/lsp.js'
 
 export interface LspClientEvents {
   onReady?: (capabilities: LspServerCapabilities) => void
@@ -54,7 +54,16 @@ export function createLspClient(
   let nextId = 1
   let alive = transport.alive
   const pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> }>()
-  let serverCapabilities: LspServerCapabilities = { definition: false, references: false, documentSymbol: false, workspaceSymbol: false, hover: false }
+  let serverCapabilities: LspServerCapabilities = {
+    definition: false,
+    references: false,
+    documentSymbol: false,
+    workspaceSymbol: false,
+    hover: false,
+    semanticTokens: false,
+    semanticTokenTypes: [],
+    semanticTokenModifiers: [],
+  }
 
   const log = (line: string): void => events.onLog?.(line)
   const parser = createFrameParser()
@@ -153,6 +162,9 @@ export function createLspClient(
           documentSymbolProvider?: unknown
           workspaceSymbolProvider?: unknown
           hoverProvider?: unknown
+          semanticTokensProvider?: {
+            legend?: { tokenTypes?: unknown; tokenModifiers?: unknown }
+          }
         }
       }>('initialize', {
         processId: process.pid,
@@ -170,16 +182,31 @@ export function createLspClient(
             references: { dynamicRegistration: false },
             documentSymbol: { dynamicRegistration: false },
             hover: { dynamicRegistration: false },
+            semanticTokens: {
+              dynamicRegistration: false,
+              requests: { range: false, full: { delta: false } },
+              tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
+              tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS],
+              formats: ['relative'],
+            },
           },
         },
       })
       const caps = init?.capabilities ?? {}
+      const legend = caps.semanticTokensProvider?.legend
       serverCapabilities = {
         definition: Boolean(caps.definitionProvider),
         references: Boolean(caps.referencesProvider),
         documentSymbol: Boolean(caps.documentSymbolProvider),
         workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
         hover: Boolean(caps.hoverProvider),
+        semanticTokens: Boolean(caps.semanticTokensProvider),
+        semanticTokenTypes: Array.isArray(legend?.tokenTypes)
+          ? legend.tokenTypes.filter((item): item is string => typeof item === 'string')
+          : [...LSP_SEMANTIC_TOKEN_TYPES],
+        semanticTokenModifiers: Array.isArray(legend?.tokenModifiers)
+          ? legend.tokenModifiers.filter((item): item is string => typeof item === 'string')
+          : [...LSP_SEMANTIC_TOKEN_MODIFIERS],
       }
       client.notify('initialized', {})
       events.onReady?.(serverCapabilities)

package/src/lsp/manager.ts

@@ -25,6 +25,10 @@ export interface LspManager {
   release(root: string, languageId: string): void
   /** 释放工作区下全部语言（session/disposed 用）。 */
   releaseRoot(root: string): void
+  /** 重置单个工作区语言 server（重新检测 provider 用）。 */
+  reset(root: string, languageId: string): void
+  /** 重置全部工作区的指定语言 server。 */
+  resetLanguage(languageId: string): void
   /** 状态快照。 */
   statusAll(): LspServerStatus[]
   /** 查询已注册的工作区+语言服务器，不增加引用计数。 */
@@ -110,6 +114,17 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
       }
     },
 
+    reset(root: string, languageId: string): void {
+      const entry = entries.get(keyOf(root, languageId))
+      if (entry) dropEntry(entry)
+    },
+
+    resetLanguage(languageId: string): void {
+      for (const entry of [...entries.values()]) {
+        if (entry.server.languageId === languageId) dropEntry(entry)
+      }
+    },
+
     statusAll(): LspServerStatus[] {
       return [...entries.values()].map((entry) => entry.server.status())
     },