dsh-vscode-mode 0.7.0 → 0.8.0

package/src/shared/lsp.ts

@@ -125,6 +125,82 @@ export function decodeSemanticTokens(
   return out
 }
 
+/**
+ * LSP CompletionItemKind（协议 1-based）→ Monaco CompletionItemKind 枚举名（0-based）。
+ *
+ * 为什么按**名称**而不是编号直传：两侧枚举编号并不一致 —— LSP 2=Method，而 Monaco
+ * 0=Method。若把协议编号当 Monaco 编号塞回去，草稿纸上的「只差一位」会变成全表错位
+ * （属性显示成方法图标等）。用名称映射让两侧各自的编号在各自类型系统里解析，杜绝硬编码。
+ * 索引 i 对应 LSP kind i（索引 0 占位，协议从 1 起）。
+ * @author ddj 2026年09月22号
+ */
+export const LSP_COMPLETION_KIND_NAMES = [
+  '', 'Text', 'Method', 'Function', 'Constructor', 'Field', 'Variable', 'Class',
+  'Interface', 'Module', 'Property', 'Unit', 'Value', 'Enum', 'Keyword', 'Snippet',
+  'Color', 'File', 'Reference', 'Folder', 'EnumMember', 'Constant', 'Struct',
+  'Event', 'Operator', 'TypeParameter',
+] as const
+
+/** LSP InsertTextFormat：1=PlainText，2=Snippet。 */
+export const LSP_INSERT_TEXT_FORMAT_SNIPPET = 2
+
+/**
+ * LSP 补全项文本编辑范围（单 range 或 insert/replace 双 range 形态）。
+ * 两种形态由服务器任选，必须都能解析：只认一种会让另一家服务器的补全落点错位。
+ */
+export interface LspCompletionTextEdit {
+  range?: LspRange
+  insert?: LspRange
+  replace?: LspRange
+  newText: string
+}
+
+/** 归一化后的补全项（host 归一化；client 映射为 Monaco suggestion）。 */
+export interface LspCompletionItem {
+  label: string
+  kind?: number            // LSP CompletionItemKind 原始编号（client 经名称表转 Monaco）
+  detail?: string
+  documentation?: string
+  insertText?: string
+  insertTextFormat?: number
+  textEdit?: LspCompletionTextEdit
+  additionalTextEdits?: Array<{ range: LspRange; newText: string }>
+  sortText?: string
+  filterText?: string
+  preselect?: boolean
+  commitCharacters?: string[]
+  deprecated?: boolean
+  data?: unknown           // 原样透传，completionItem/resolve 需回传
+}
+
+/** 归一化后的补全列表（incomplete：服务器要求按已输入内容重查）。 */
+export interface LspCompletionList {
+  items: LspCompletionItem[]
+  incomplete: boolean
+  truncated?: boolean
+}
+
+/** 签名帮助中的单个参数（label 可为字符串或 [start, end] 元组，原样透传）。 */
+export interface LspParameterInformation {
+  label: string | [number, number]
+  documentation?: string
+}
+
+/** 归一化后的单个签名。 */
+export interface LspSignatureInformation {
+  label: string
+  documentation?: string
+  parameters: LspParameterInformation[]
+  activeParameter?: number
+}
+
+/** 归一化后的签名帮助结果。 */
+export interface LspSignatureHelp {
+  signatures: LspSignatureInformation[]
+  activeSignature: number
+  activeParameter: number
+}
+
 /** LSP 服务器能力子集：本插件会用到的方法。 */
 export interface LspServerCapabilities {
   definition: boolean
@@ -134,6 +210,9 @@ export interface LspServerCapabilities {
   workspaceSymbol: boolean
   hover: boolean
   semanticTokens: boolean
+  completion: boolean
+  completionResolve: boolean
+  signatureHelp: boolean
   semanticTokenTypes?: string[]
   semanticTokenModifiers?: string[]
 }

package/src/shared/nativeOpen.ts

@@ -0,0 +1,91 @@
+/**
+ * dsh-vscode-mode shared — 原生打开范围判定（host/client 双面契约）。
+ * 背景：DSH 文件预览双形态——本插件认领 `dsh-resource://file/**` 进 Monaco 编辑，
+ * 官方渲染器（Office 预览/不可预览提示/表格预览）看认领让位。本模块承载「原生打开」
+ * 范围的单一事实源：默认集 = 让位清单（插件本来就不认领的后缀），用户可经设置
+ * `nativeOpenExts`（逗号分隔）增删；host 的 Config schema 默认值与 client 的
+ * 文件树点击判定 / claim 认领判定共用，保证三处永不同源漂移。
+ * 决策沿袭（不因本模块迁移而变）：CSV/TSV **不在**默认集——官方 0.1.7 有表格预览，
+ * 但编辑器可编辑性优先，仅用户显式加入 nativeOpenExts 才让位（同 avif 例外先例）。
+ * 作者 ddj 2026年09月22号
+ */
+
+/**
+ * Office 文档后缀：官方 `dsh-client-ui-sidebar-documentpreview` 的 Office 渲染器
+ * 声明 `doc/docx/xls/xlsx/ppt/pptx`（0.1.6 起侧栏 Office 预览；0.1.7 扩展表格 CSV/TSV
+ * 只读预览——本清单刻意不含 csv/tsv，见文件头决策）。本插件让位官方（不认领），
+ * 否则会把这些文件路由进 Monaco 而丢掉官方预览。
+ */
+export const OFFICE_EXT: readonly string[] = ['doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'odt', 'ods', 'odp', 'pages', 'numbers']
+
+/**
+ * 官方「不可预览二进制容器」清单（`UNVIEWABLE_BINARY_EXTENSIONS`，逐项取自
+ * `dsh-client-ui-sidebar-documentpreview/lib/client.js`）。这些后缀官方会给出
+ * 「无法预览」提示；本插件让位官方，避免把二进制当文本读成乱码。
+ *
+ * ⚠️ 刻意例外：官方清单含 `avif`，但本插件图片预览支持 avif（浏览器原生解码），
+ * 故从本表**移除** `avif` —— 保留本插件的图片预览优于官方的「不可预览」。
+ * @author ddj 2026年09月18号
+ */
+export const BLIND_EXT: readonly string[] = [
+  // 媒体
+  'mp4', 'mov', 'avi', 'mkv', 'webm', 'flv', 'wmv', 'm4v', 'mp3', 'wav', 'flac', 'ogg', 'm4a', 'aac', 'wma', 'opus',
+  // 归档
+  'zip', 'gz', 'tgz', 'bz2', 'xz', 'zst', '7z', 'rar', 'tar', 'jar',
+  // 可执行与库
+  'exe', 'dll', 'so', 'dylib', 'bin', 'o', 'class', 'pyc', 'wasm',
+  // 字体
+  'ttf', 'otf', 'woff', 'woff2', 'eot',
+  // 磁盘映像
+  'dmg', 'iso', 'img',
+  // 数据库与设计文件
+  'sqlite', 'db', 'psd', 'ai', 'sketch', 'tiff', 'tif', 'heic', 'heif',
+]
+
+/** 原生打开默认后缀集 = 让位清单并集（两清单元素天然互斥，直接拼接）。 */
+export const DEFAULT_NATIVE_EXT: readonly string[] = [...OFFICE_EXT, ...BLIND_EXT]
+
+/** 默认范围的设置序列（逗号分隔；Config schema 默认值与设置页回显同源）。 */
+export const DEFAULT_NATIVE_CSV: string = DEFAULT_NATIVE_EXT.join(',')
+
+/**
+ * 取 path 的 basename 后缀（小写、无点）；无后缀/隐藏文件返回 ''。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 小写后缀或 ''
+ */
+export function suffixOf(path: unknown): string {
+  const base = String(path ?? '').replace(/\\/g, '/').split('/').pop() ?? ''
+  const dot = base.lastIndexOf('.')
+  return dot > 0 ? base.slice(dot + 1).toLowerCase() : ''
+}
+
+/**
+ * 解析设置串为后缀集合：逗号分隔、去空白、去前导点、小写；空段丢弃。
+ * 解析失败/空串 → 空集合（= 不追加任何原生打开范围，让位仍走 deferToOfficial）。
+ * @author ddj 2026年09月22号
+ * @param csv 逗号分隔后缀串
+ * @returns 后缀集合
+ */
+export function parseExtCsv(csv: unknown): Set<string> {
+  const out = new Set<string>()
+  if (typeof csv !== 'string') return out
+  for (const raw of csv.split(',')) {
+    const item = raw.trim().replace(/^\./, '').toLowerCase()
+    if (item) out.add(item)
+  }
+  return out
+}
+
+/**
+ * 该路径是否命中「原生打开」范围（仅看用户配置集合；默认集语义由调用方
+ * 与 deferToOfficial 取并，保持两判定各司其职）。
+ * @author ddj 2026年09月22号
+ * @param path 文件路径
+ * @param exts 已解析的后缀集合（parseExtCsv 产物）
+ * @returns 是否命中
+ */
+export function inNativeOpen(path: unknown, exts: ReadonlySet<string>): boolean {
+  const ext = suffixOf(path)
+  return ext !== '' && exts.has(ext)
+}

package/src/shared/rpc.ts

@@ -17,7 +17,7 @@ import type { CompatReport, DevFormInfo } from './compat.js'
 import type { ShellIntegrationStatus, UnityListPayload, UnityProjectEntry } from './integration.js'
 import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules.js'
 import type { SnippetEntry, SnippetInfo, SnippetProject, SnippetRefInput, SnippetSaveInput } from './snippets.js'
-import type { LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSymbol } from './lsp.js'
+import type { LspCompletionItem, LspCompletionList, LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSignatureHelp, LspSymbol } from './lsp.js'
 import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
 import type { SvnAction, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdateResult } from './svn.js'
 import type { DapAction, DapAdapterInfo, DapBreakpointAck, DapBreakpointInput, DapConfigSnippet, DapConfigSource, DapDebugConfig, DapFrameView, DapPhase, DapPollResult, DapProcessInfo, DapScopeView, DapVariableView } from './dap.js'
@@ -73,6 +73,139 @@ export function binaryMimeOf(path: string): string {
   return imageMimeOf(path)
 }
 
+// --region 二进制预览通道（edrv.readBinary：响应侧原始字节，省 ~33% base64 编码开销）
+
+/** 二进制读成功响应头（octet-stream 携带元数据；同源请求可直接读取自定义头）。 */
+export const BINARY_READ_HEADERS = {
+  mime: 'x-edrv-mime',
+  size: 'x-edrv-size',
+  version: 'x-edrv-version',
+} as const
+
+/** edrv.readBinary 成功载荷（host Uint8Array 信封；routes 接线后以 octet-stream 原样直出）。 */
+export interface BinaryReadPayload {
+  bytes: Uint8Array
+  mime: string
+  size: number
+  version: string
+}
+
+/** 普通 JSON RPC 调用签名（回退通道复用；shared 不反向依赖 client 包装）。 */
+export type RpcJsonCall = <M extends RpcMethod>(method: M, args: RpcRequestMap[M]) => Promise<RpcResult<M>>
+
+/** 二进制预览读取统一结果：binary=新通道原始字节，base64=回退通道，probed=本次尝试过新通道。 */
+export type PreviewRead =
+  | ({ ok: true; via: 'binary' } & BinaryReadPayload)
+  | { ok: true; via: 'base64'; content: string; size: number; encoding?: 'base64'; mime?: string; version?: string; probed?: boolean }
+  | { ok: false; error: string; resolvedPath?: string; probed?: boolean }
+
+/** 通道探测状态：unknown=按次尝试；unwired=host 有 handler 但 routes 仍强制 JSON（本页不再尝试）。 */
+let binaryTransport: 'unknown' | 'unwired' = 'unknown'
+
+/**
+ * 二进制预览读取（edrv.readBinary，失败自动回退 edrv.read base64 现有路径）。
+ * 降级链：非 200 / 非 octet-stream / 元数据头缺失或长度不符 / 网络错 / host 未接线
+ * 把信封 JSON 化 → 一律立即回退 base64 路径，功能不降级；
+ * 其中「信封被 JSON 化」判定为未接线，探测一次后本页生命周期内不再尝试新通道
+ * （避免每次读图都付一次无效往返与大响应序列化）；其余失败不关停通道（瞬时故障可自愈）。
+ * @author ddj 2026年09月22号
+ * @param rpcJson 类型化 JSON RPC 调用（调用方传入 client rpc 包装）
+ * @param args edrv.readBinary 请求参数
+ * @returns 统一读取结果（via 标记实际通道；probed 供调用方做一次性回退日志）
+ */
+export async function readBinaryPreview(
+  rpcJson: RpcJsonCall,
+  args: RpcRequestMap['edrv.readBinary'],
+): Promise<PreviewRead> {
+  const attempted = binaryTransport !== 'unwired'
+  if (attempted) {
+    const direct = await tryBinaryRead(args)
+    if (direct) return direct
+  }
+  return fallbackRead(rpcJson, args, attempted)
+}
+
+/**
+ * 新通道单次尝试：响应完全符合约定才返回二进制结果，否则返回 null 触发回退。
+ * @author ddj 2026年09月22号
+ * @param args edrv.readBinary 请求参数
+ * @returns 二进制读取结果或 null（null=回退 base64）
+ */
+async function tryBinaryRead(args: RpcRequestMap['edrv.readBinary']): Promise<PreviewRead | null> {
+  try {
+    const res = await fetch(RPC_PATH, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ method: 'edrv.readBinary', args }),
+    })
+    if (!res.ok) return null
+    const type = res.headers.get('content-type') ?? ''
+    if (!type.includes('application/octet-stream')) return noteJsonBody(res)
+    const size = Number(res.headers.get(BINARY_READ_HEADERS.size))
+    const bytes = new Uint8Array(await res.arrayBuffer())
+    // 元数据头长度必须与实际字节数一致，否则视为非本插件响应（防御中间层/代理）
+    if (!Number.isFinite(size) || size !== bytes.byteLength) return null
+    return {
+      ok: true,
+      via: 'binary',
+      bytes,
+      mime: res.headers.get(BINARY_READ_HEADERS.mime) || binaryMimeOf(args.path),
+      size: bytes.byteLength,
+      version: res.headers.get(BINARY_READ_HEADERS.version) || '',
+    }
+  } catch (error) {
+    return null // 网络错按瞬时故障处理：回退但不关停通道
+  }
+}
+
+/**
+ * 非 octet-stream 响应体判定：host 已有 edrv.readBinary 但 routes 尚未接线时，
+ * 二进制信封会被 JSON 序列化成 {bytes:{0:..}} 普通对象——识别到该形态即标记
+ * 「未接线」（本页不再尝试）；其余 JSON（错误响应/未知方法）仅本次回退不关停。
+ * @author ddj 2026年09月22号
+ * @param res JSON 形态的响应
+ * @returns 恒为 null（统一由调用方回退）
+ */
+async function noteJsonBody(res: Response): Promise<null> {
+  try {
+    const body = (await res.json()) as { ok?: unknown; binary?: { bytes?: unknown } } | null
+    if (body && body.ok === true && body.binary && typeof body.binary === 'object' && body.binary.bytes != null) {
+      binaryTransport = 'unwired'
+    }
+  } catch (error) {
+    /* 非 JSON（代理页/空体）：不判定，仅本次回退 */
+  }
+  return null
+}
+
+/**
+ * base64 回退读取（现有 edrv.read JSON 通道，载荷形状与历史实现一致）。
+ * @author ddj 2026年09月22号
+ * @param rpcJson 类型化 JSON RPC 调用
+ * @param args 请求参数
+ * @param attempted 本次是否尝试过新通道（回带给调用方做一次性日志）
+ * @returns 统一读取结果（调用失败转错误结果，不向上抛）
+ */
+async function fallbackRead(
+  rpcJson: RpcJsonCall,
+  args: RpcRequestMap['edrv.readBinary'],
+  attempted: boolean,
+): Promise<PreviewRead> {
+  const probed = attempted ? { probed: true } : {}
+  try {
+    const res = await rpcJson('edrv.read', { sessionId: args.sessionId, path: args.path, encoding: 'base64' })
+    if (!res.ok) {
+      const legacy = res as { ok: false; error: string; resolvedPath?: string }
+      return { ok: false, error: legacy.error, ...probed, ...(legacy.resolvedPath !== undefined ? { resolvedPath: legacy.resolvedPath } : {}) }
+    }
+    if (res.encoding !== 'base64') return { ok: false, error: '读取失败', ...probed }
+    return { ok: true, via: 'base64', content: res.content, size: res.size, encoding: res.encoding, mime: res.mime, version: res.version, ...probed }
+  } catch (error) {
+    return { ok: false, error: 'read异常:' + String(error), ...probed }
+  }
+}
+// --endregion
+
 /** 决策作用域：call=整条记录，hunk=单个差异块。 */
 export type RpcScope = 'call' | 'hunk'
 
@@ -101,6 +234,10 @@ export interface PerfSession {
   bytes: number
   mtime: number
   active: boolean
+  /** 官方侧栏已归档（0.1.7+ workspaceRegistry.archivedSessionIds 持久位；旧 host 不回传 → undefined，按 false 渲染）。 */
+  archived?: boolean
+  /** 官方侧栏已置顶（0.1.7+ workspaceRegistry.pinnedSessionIds 持久位；旧 host 不回传 → undefined，按 false 渲染）。 */
+  pinned?: boolean
 }
 
 /** 一个工作区的会话聚合（edrv.perf.inventory）。 */
@@ -200,6 +337,7 @@ export interface RpcRequestMap {
   'edrv.reject': { sessionId?: string; callId: string; scope?: RpcScope; hunkIndex?: number }
   'edrv.decideBatch': { sessionId?: string; items: DecideItem[] }
   'edrv.read': { sessionId?: string; path: string; encoding?: 'base64' }
+  'edrv.readBinary': { sessionId?: string; path: string }
   'edrv.versions': { sessionId?: string; paths: string[] }
   'edrv.original': { sessionId?: string; path: string }
   'edrv.save': { sessionId?: string; path: string; content: string; rev?: string }
@@ -258,6 +396,9 @@ export interface RpcRequestMap {
   'edrv.lsp.workspaceSymbol': { sessionId?: string; query: string }
   'edrv.lsp.hover': { sessionId?: string; path: string; position: LspPosition }
   'edrv.lsp.semanticTokens': { sessionId?: string; path: string }
+  'edrv.lsp.completion': { sessionId?: string; path: string; position: LspPosition; context?: { triggerKind?: number; triggerCharacter?: string } }
+  'edrv.lsp.resolveCompletion': { sessionId?: string; path: string; item: LspCompletionItem }
+  'edrv.lsp.signatureHelp': { sessionId?: string; path: string; position: LspPosition }
   'edrv.lsp.redetect': { languageId: string }
   'edrv.lsp.envInstall': { languageId: string; id: string }
   'edrv.lsp.envState': {}
@@ -335,6 +476,7 @@ export interface RpcOkMap {
   'edrv.reject': { record: RecordView }
   'edrv.decideBatch': { results: DecideResult[] }
   'edrv.read': { content: string; size: number; encoding?: 'base64'; mime?: string; version?: string }
+  'edrv.readBinary': { binary: BinaryReadPayload }
   'edrv.versions': { items: FileVersionItem[] }
   'edrv.original': { content: string; size: number; stale: StaleHunk[]; fallback: boolean }
   'edrv.save': { rev?: string; conflict?: boolean }
@@ -393,6 +535,9 @@ export interface RpcOkMap {
   'edrv.lsp.workspaceSymbol': { symbols: LspSymbol[]; truncated?: boolean }
   'edrv.lsp.hover': { hover?: LspHover }
   'edrv.lsp.semanticTokens': { tokens?: LspSemanticTokens }
+  'edrv.lsp.completion': { completions?: LspCompletionList }
+  'edrv.lsp.resolveCompletion': { item?: LspCompletionItem }
+  'edrv.lsp.signatureHelp': { signatureHelp?: LspSignatureHelp }
   'edrv.lsp.redetect': { servers: LspServerStatus[] }
   'edrv.lsp.envInstall': { started: boolean }
   'edrv.lsp.envState': { states: LspEnvInstallState[] }