dsh-vscode-mode 0.1.42 → 0.1.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.42",
+  "version": "0.1.44",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
@@ -85,10 +85,6 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime",
-        "@deepseek-ai/dsh-client-ui-slots"
-      ],
       "platform": "web"
     }
   }

package/src/client/monaco/lsp/providers.ts

@@ -2,16 +2,18 @@
 /**
  * dsh-vscode-mode client — Monaco LSP provider 注册 + 跳转/引用命令。
  * 数据层：Definition/Reference/DocumentSymbol/Hover provider（同一文件内跳转 Monaco 原生可用）。
- * 交互层：edrv.goToDefinition（F12）/ edrv.findReferences（Shift+F12 / 右键），跨文件跳转自研
- * （target 经 openFileAt 打开并定位），引用结果用轻量浮动面板展示（点击跳转）。
+ * 交互层：edrv.goToDefinition（F12）/ edrv.findReferences（Shift+F12 / 右键）/ Ctrl+点击引用导航，
+ * 跨文件跳转自研（target 经 openFileAt 打开并定位），多条引用走 Monaco 原生 References Peek
+ * （左侧代码预览 + 右侧引用列表；registerEditorOpener 接管 edrv:// 点击跳转）。
  * 作者 ddj 2026-08-27
  */
 import {
   pathOfModel, syncDoc, closeDoc, findDefinition, findReferences,
   fetchDocumentSymbols, fetchHover, fetchSemanticTokens,
   targetOpenPath, targetMonoPosition, lspStatusFor, refreshStatus,
+  lspUriToAbs,
 } from './lspClient.js'
-import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES } from '../../../shared/lsp.js'
+import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES, monoToLsp } from '../../../shared/lsp.js'
 
 const LSP_LANGS = ['lua', 'csharp']
 const SEMANTIC_LEGEND = {
@@ -20,7 +22,6 @@ const SEMANTIC_LEGEND = {
 }
 let registered = false
 const disposables = []
-let overlayEl = null
 
 /** 目标文件打开并定位（复用现有 openFileAt 的 edrv:open-editor 事件通道）。 */
 function openAt(path, line, column) {
@@ -72,6 +73,20 @@ export function registerLspProviders(monaco) {
 
   // —— 数据 provider ——
   disposables.push(
+    // 原生跳转（peek 参考文献列表点击 / 原生 go to definition 等）的 edrv:// 打开兜底：
+    // 目标 uri 由本插件自己定义（edrv:// 工作区相对路径），Monaco 无法自行加载，
+    // 必须经事件通道交给 EditorView openFileAt 打开并定位。
+    monaco.editor.registerEditorOpener({
+      openCodeEditor: (source, resource, selectionOrPosition) => {
+        const path = lspUriToAbs(resource)
+        if (!path) return false
+        const start = selectionOrPosition?.getStartPosition?.() ?? selectionOrPosition
+        const line = Math.max(1, start?.lineNumber ?? 1)
+        const column = Math.max(1, start?.column ?? 1)
+        openAt(path, line, column)
+        return true
+      },
+    }),
     monaco.languages.registerDefinitionProvider(LSP_LANGS, {
       provideDefinition: (model, position, token) => {
         const path = pathOfModel(model)
@@ -168,12 +183,108 @@ export async function runGoToDefinition(ed) {
   await goToDefinition(ed, ed.getPosition(), true)
 }
 
-/** Ctrl+鼠标点击定义：使用点击位置查询，避免依赖当前光标位置。 */
-export async function gotoDefinitionAt(ed, position) {
-  await goToDefinition(ed, position)
+/**
+ * Ctrl+鼠标点击：查询其它内容对该项的引用并导航。
+ * 0 条 → 无特殊效果；1 条 → 直接跳转；多条 → 打开 Monaco 原生 References Peek
+ * （左侧代码预览 + 右侧引用列表，点击经 registerEditorOpener 跳转）。
+ * @author ddj 2026年09月02号
+ * @param ed Monaco 编辑器
+ * @param position 点击位置（Monaco 1-based）
+ */
+export async function gotoRefsAt(ed, position) {
+  const model = ed.getModel()
+  const path = pathOfModel(model)
+  if (!path || !position) return
+  const all = await findReferences(path, model.getValue(), position, false)
+  const others = filterOtherRefs(all, path, position)
+  if (!others.length) return
+  if (others.length === 1) {
+    jumpToLocation(others[0])
+    return
+  }
+  // 计数器就绪：光标移到点击处（原生 Peek 按光标词查询），走原生两栏引用视图
+  ed.setPosition(position)
+  await triggerReferencePeek(ed)
+}
+
+/**
+ * 触发 Monaco 原生 References Peek（左侧代码 + 右侧引用列表，原生点击跳转）。
+ * @author ddj 2026年09月02号
+ * @param ed Monaco 编辑器
+ * @returns 是否成功触发（动作缺失时返回 false）
+ */
+export async function triggerReferencePeek(ed) {
+  const action = ed.getAction('editor.action.referenceSearch.trigger')
+  if (!action || typeof action.run !== 'function') return false
+  await action.run()
+  return true
+}
+
+/**
+ * 过滤「其它内容」引用：剔除当前点击处自身（同文件且点击位置落入其 range），并按路径+起点去重。
+ * @author ddj 2026年09月02号
+ * @param locations 引用结果
+ * @param path 当前文档路径
+ * @param position 点击位置（Monaco 1-based）
+ * @returns 过滤后的其它引用
+ */
+function filterOtherRefs(locations, path, position) {
+  const lspPos = monoToLsp(position.lineNumber, position.column)
+  const seen = new Set()
+  const out = []
+  for (const loc of locations) {
+    const rel = targetOpenPath(loc)
+    if (sameFile(rel, path) && posInRange(lspPos, loc.lspRange)) continue
+    const start = loc.lspRange?.start ?? {}
+    const key = String(rel).toLowerCase() + ':' + (start.line ?? 0) + ':' + (start.character ?? 0)
+    if (seen.has(key)) continue
+    seen.add(key)
+    out.push(loc)
+  }
+  return out
+}
+
+/**
+ * 两个路径是否指向同一文件（容忍相对/绝对混合与大小写差异）。
+ * @author ddj 2026年09月02号
+ * @param a 路径 A
+ * @param b 路径 B
+ * @returns 是否同一文件
+ */
+function sameFile(a, b) {
+  if (!a || !b) return false
+  const na = String(a).replace(/\\/g, '/').toLowerCase()
+  const nb = String(b).replace(/\\/g, '/').toLowerCase()
+  if (na === nb) return true
+  const absA = /^[A-Za-z]:\//.test(na) || na.startsWith('/')
+  const absB = /^[A-Za-z]:\//.test(nb) || nb.startsWith('/')
+  // 同为相对/同为绝对但不等 → 不同文件（避免根目录文件误匹配同名子目录文件）
+  if (absA === absB) return false
+  // 一方绝对一方相对：绝对路径以相对路径结尾视为同文件
+  return absA ? na.endsWith('/' + nb) : nb.endsWith('/' + na)
+}
+
+/**
+ * 0-based LSP 位置是否落在 range 内（end 排除；零宽 range 按点匹配）。
+ * @author ddj 2026年09月02号
+ * @param pos LSP 位置（0-based）
+ * @param range LSP range
+ * @returns 是否在范围内
+ */
+function posInRange(pos, range) {
+  const start = range?.start
+  if (!start) return false
+  const end = range?.end ?? start
+  if (start.line === end.line && start.character === end.character) {
+    return pos.line === start.line && pos.character === start.character
+  }
+  if (pos.line < start.line || pos.line > end.line) return false
+  if (pos.line === start.line && pos.character < start.character) return false
+  if (pos.line === end.line && pos.character >= end.character) return false
+  return true
 }
 
-/** 给一个 Monaco 编辑器绑定 Ctrl/Cmd+鼠标定义跳转（幂等）。 */
+/** 给一个 Monaco 编辑器绑定 Ctrl/Cmd+鼠标引用导航（幂等）。 */
 export function bindLspEditor(ed) {
   if (!ed || ed.__edrvLspClick) return
   ed.__edrvLspClick = true
@@ -187,68 +298,24 @@ export function bindLspEditor(ed) {
     if (!native || !position || !isLeftButton || (!ctrl && !meta)) return
     native.preventDefault?.()
     native.stopPropagation?.()
-    void gotoDefinitionAt(ed, position)
+    void gotoRefsAt(ed, position)
   })
   disposables.push(disposable)
 }
 
-/** Shift+F12 / 右键「查找所有引用」：查询引用并展示浮动面板。 */
+/** Shift+F12 / 右键「查找所有引用」：走 Monaco 原生 References Peek（两栏引用视图）。 */
 export async function runFindReferences(ed) {
-  const model = ed.getModel()
-  const path = pathOfModel(model)
   const position = ed.getPosition()
-  if (!path || !position) return
-  const locations = await findReferences(path, model.getValue(), position, false)
-  showReferencesOverlay(ed, path, position, locations)
+  if (!position) return
+  ed.setPosition(position)
+  await triggerReferencePeek(ed)
 }
 
-/** 引用结果浮动面板（轻量 DOM，点击跳转；Esc/失焦关闭）。 */
-function showReferencesOverlay(ed, path, position, locations) {
-  hideReferencesOverlay()
-  if (!locations.length) {
-    setStatus('未找到引用')
-    return
-  }
-  const root = ed.getDomNode()
-  if (!root) return
-  const el = document.createElement('div')
-  el.className = 'edrv-refs'
-  const header = document.createElement('div')
-  header.className = 'edrv-refs-head'
-  header.textContent = '引用 ' + locations.length + ' 处'
-  el.appendChild(header)
-  const list = document.createElement('div')
-  list.className = 'edrv-refs-list'
-  for (const loc of locations) {
-    const row = document.createElement('div')
-    row.className = 'edrv-refs-row'
-    const pos = targetMonoPosition(loc)
-    const rel = targetOpenPath(loc)
-    const name = String(rel).split('/').pop() || rel
-    row.textContent = name + ':' + pos.line + ':' + pos.column
-    row.title = rel + ':' + pos.line
-    row.addEventListener('click', () => {
-      hideReferencesOverlay()
-      jumpToLocation(loc)
-    })
-    list.appendChild(row)
-  }
-  el.appendChild(list)
-  root.appendChild(el)
-  overlayEl = el
-  const onKey = (e) => { if (e.key === 'Escape') hideReferencesOverlay() }
-  window.addEventListener('keydown', onKey)
-  el.addEventListener('click', (e) => { if (e.target === el) hideReferencesOverlay() })
-  el._onKey = onKey
-}
-
-export function hideReferencesOverlay() {
-  if (overlayEl) {
-    window.removeEventListener('keydown', overlayEl._onKey)
-    overlayEl.remove()
-    overlayEl = null
-  }
-}
+/**
+ * 兼容占位（历史导出；自绘引用浮窗已移除，改走 Monaco 原生 Peek）。
+ * @author ddj 2026年09月02号
+ */
+export function hideReferencesOverlay() {}
 
 /** 编辑器状态栏提示（复用 EditorView 的 status 通道）。 */
 function setStatus(text) {

package/src/client/styles/editor.css

@@ -291,11 +291,5 @@
 [data-edrv-view] .edrv-search-toggle.on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.14)); color: var(--dsw-alias-label-primary, #1f2933); border-color: var(--dsw-alias-brand-primary, #0f9d58); }
 [data-edrv-view] .edrv-search-toggle:disabled { opacity: .4; cursor: default; }
 
-/* LSP 引用结果浮动面板（Shift+F12 / 右键「查找所有引用」） */
-[data-edrv-view] .edrv-refs { position: absolute; right: 12px; top: 40px; z-index: 60; width: 360px; max-height: 60%; display: flex; flex-direction: column; border: 1px solid var(--dsw-alias-border-l2, #555); border-radius: 8px; background: var(--dsw-alias-bg-panel, #161b22); box-shadow: 0 6px 24px rgba(0,0,0,.4); overflow: hidden; font-size: 12px; }
-[data-edrv-view] .edrv-refs-head { padding: 6px 10px; font-weight: 600; color: var(--dsw-alias-label-primary, #eee); border-bottom: 1px solid var(--dsw-alias-border-l2, #333); background: var(--dsw-alias-bg-layer-1, transparent); }
-[data-edrv-view] .edrv-refs-list { overflow-y: auto; }
-[data-edrv-view] .edrv-refs-row { padding: 4px 10px; cursor: pointer; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; color: var(--dsw-alias-label-secondary, #c0c8d0); font-family: var(--ds-font-family-code, ui-monospace, monospace); }
-[data-edrv-view] .edrv-refs-row:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.10)); color: var(--dsw-alias-label-primary, #fff); }
 
 

package/src/client/ui/McpSettings.ts

@@ -211,11 +211,15 @@ function CompatSection({ getSummary }) {
   )
   const warnings = report?.warnings ?? []
   const devForm = report?.devForm
+  const versionText = report?.dshVersion
+    ? '（DSH ' + report.dshVersion + ' · 插件 ' + (report?.pluginVersion ?? '') + '）'
+    : report?.pluginVersion ? '（插件版本 ' + report.pluginVersion + '）' : ''
   return React.createElement('section', { className: 'vsm-general-page' },
     React.createElement('h2', null, '兼容性'),
-    React.createElement('p', null, '检测与其他插件 / DSH 版本的适配状态与已知问题。' + (report?.pluginVersion ? '（插件版本 ' + report.pluginVersion + '）' : '')),
+    React.createElement('p', null, '检测与其他插件 / DSH 版本的适配状态与已知问题。' + versionText),
     error && React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error),
     devForm?.enabled && group('开发形态', React.createElement('div', { className: 'vsm-compat-item ok' }, React.createElement('span', { className: 'vsm-compat-name' }, '开发形态开启（工作区链接安装）'), React.createElement('span', { className: 'vsm-compat-note' }, devForm.path))),
+    group('版本适配', renderItems(report?.adapters)),
     group('外部插件与服务', renderItems(report?.external)),
     group('客户端适配', renderItems(getSummary?.() ?? [])),
     group('护栏', renderItems(report?.guards)),

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
+}