dsh-vscode-mode 0.6.0 → 0.8.0

package/src/rpc.ts

@@ -20,8 +20,8 @@ import {
   resolveTarget,
   saveBucket,
 } from './store.js'
-import { mkdir, readFile, rm, stat, writeFile, readdir } from 'node:fs/promises'
-import { basename, join } from 'node:path'
+import { cp, mkdir, readFile, rename, rm, stat, writeFile, readdir } from 'node:fs/promises'
+import { basename, dirname, join } from 'node:path'
 import { archiveEntryFor, markDecision, recordResolved, reconstructOriginal } from './model.js'
 import type { Registry } from './registry.js'
 import { bucketOf, cwdOf, sessionOf } from './registry.js'
@@ -34,7 +34,7 @@ import { rulesList, rulesRead, rulesRemove, rulesSave, rulesToggle } from './rul
 import { isSnippetFilePath, snippetsEntries, snippetsList, snippetsRead, snippetsRemove, snippetsSave } from './snippets.js'
 import { listMcp, refreshMcp, removeMcp, saveMcp, toggleMcp } from './mcp.js'
 import { listProjects, projectRefresh, projectRemove, projectSave, projectToggle } from './mcpProject.js'
-import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from './fileOpenSettings.js'
+import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS, sectionOf, updateSection } from './fileOpenSettings.js'
 import { INTEGRATION_BASE_DEFAULT } from './shared/integration.js'
 import { shellMenuRegister, shellMenuRemove, shellMenuStatus } from './integrate.js'
 import { unityAdd, unityInstall, unityList, unityRemove } from './unityBridge.js'
@@ -42,11 +42,12 @@ import { handoffOpen, pendingState, pollPending } from './externalHandoff.js'
 import { buildReport } from './compat.js'
 import { findProfileDir, readDevForm, setDevForm } from './devForm.js'
 import { normalizeRel } from './tree.js'
+import { baseNameOf, checkNewName, checkRenameName, isSubPath, joinRelPath, parentRelOf } from './shared/fsNames.js'
 import { invalidateIndex, listDirCached } from './treeIndex.js'
 import { revealInExplorer } from './reveal.js'
 import { dshHome, debugLogFile, pluginLogRoot } from './paths.js'
 import { clearDebugLog, debugRecord, isDebugLogName, listDebugLogs, readDebugLog } from './debugLog.js'
-import { markActiveSessions, moveOutSessions, planMoveOut, purgeArchive, restoreSession, scanSessionInventory, sessionsArchiveRoot, sessionSizeOf, sidecarSummaryOf } from './perf.js'
+import { markActiveSessions, markOfficialFlags, moveOutSessions, planMoveOut, purgeArchive, restoreSession, scanSessionInventory, sessionsArchiveRoot, sessionSizeOf, sidecarSummaryOf, unarchiveOfficial } from './perf.js'
 import { patchHasPerfConfig, patchInsertPerfConfig, patchRemovePerfConfig, perfConfigBlock } from './perfPatch.js'
 import type { FileVersions } from './fileVersions.js'
 
@@ -106,6 +107,57 @@ function snippetTargetOf(path: string): string | null {
   return isSnippetFilePath(path) ? path.replace(/\\/g, '/') : null
 }
 
+/** readTargetOf 成功形态：解析后的目标路径、stat 信息与 fs 服务句柄。 */
+interface ReadTargetOk {
+  target: string
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  fs: any
+  info: { version?: unknown; size?: number }
+}
+
+/**
+ * 二进制/文本读取共用前置（edrv.read 与 edrv.readBinary）：解析路径 + debugRecord +
+ * stat + 文件类型校验 + 32MB 二进制上限，保证两条读通道的错误口径完全一致。
+ * @author ddj 2026年09月22号
+ * @param ctx DSH 上下文
+ * @param sc requireSession 成功结果（session + cwd）
+ * @param path 客户端请求路径
+ * @returns 成功返回解析目标与 stat；失败返回错误文案（文件不存在时附 resolvedPath）
+ */
+async function readTargetOf(
+  ctx: Ctx,
+  sc: { session: Session; cwd: string },
+  path: string,
+): Promise<ReadTargetOk | { err: string; resolvedPath?: string }> {
+  const fs = ctx.get('fs')
+  if (!fs) return { err: '缺少 fs' }
+  try {
+    const target = await resolveTarget(ctx, sc.session, path)
+    debugRecord(ctx, sc.cwd, '[DEBUG path.resolve] input=' + String(path ?? '') + ' resolved=' + fs.processPath(target), 'debug')
+    const info = await fs.stat(target)
+    if (!info || info.type !== 'file') {
+      // 带上解析后的真实路径：跳转失败时可直接看出是路径解析错还是目标本身不存在
+      return { err: '文件不存在', resolvedPath: fs.processPath(target) }
+    }
+    if ((info.size ?? 0) > BINARY_READ_CAP) return { err: '文件过大（>32MB），不支持整文件预览' }
+    return { target, fs, info }
+  } catch (error) {
+    return { err: '读取失败：' + String(error) }
+  }
+}
+
+/**
+ * readTargetOf 失败结果 → RPC 错误载荷（文件不存在时保留 resolvedPath 供诊断）。
+ * @author ddj 2026年09月22号
+ * @param prep readTargetOf 的失败分支
+ * @returns { ok:false } 形态载荷
+ */
+function targetErrOf(prep: { err: string; resolvedPath?: string }): { ok: false; error: string; resolvedPath?: string } {
+  return prep.resolvedPath !== undefined
+    ? { ok: false, error: prep.err, resolvedPath: prep.resolvedPath }
+    : { ok: false, error: prep.err }
+}
+
 /**
  * 本地文件系统版本令牌（mtime+size）：与 ctx.fs 的不透明版本串用途相同，
  * 仅供全局片段文件（走 node:fs 直读、不经 ctx.fs）在 edrv.read 时回带。
@@ -240,12 +292,111 @@ async function latestPatchBackup(patchPath: string): Promise<string | undefined>
 /** 读取设置中的深链基址（缺省/非法回退默认 3080）。 */
 async function integrationBaseUrlOf(ctx: Ctx): Promise<string> {
   const settings = ctx.get('settings')
-  const descriptor = settings?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
-  const value = descriptor?.value as { integrationBaseUrl?: unknown } | undefined
+  const value = sectionOf(settings, FILE_OPEN_SETTINGS_NS)?.value as { integrationBaseUrl?: unknown } | undefined
   const raw = typeof value?.integrationBaseUrl === 'string' ? value.integrationBaseUrl.trim() : ''
   return raw || INTEGRATION_BASE_DEFAULT
 }
 
+// --region 文件操作（edrv.fs.*：资源管理器右键的新建/重命名/删除/复制/移动）
+
+/**
+ * 文件操作目标解析：工作区相对路径 → 绝对路径，并做工作区边界检查。
+ * edrv.fs.* 各方法共用（对齐 edrv.saveBinary 的 contains 护栏口径）。
+ * @author ddj 2026年09月22号
+ * @param ctx DSH 上下文
+ * @param session 当前会话
+ * @param rel 工作区相对路径
+ * @returns 绝对路径；缺 fs/越界/解析失败返回错误文案
+ */
+async function fsOpsTarget(ctx: Ctx, session: Session, rel: string): Promise<{ abs: string } | { err: string }> {
+  const fs = ctx.get('fs')
+  if (!fs) return { err: '缺少 fs' }
+  try {
+    const target = await resolveTarget(ctx, session, rel)
+    const rootTarget = await fs.resolve(policyOf(ctx, session)?.workspaceRoot ?? '.', {})
+    if (!fs.contains(rootTarget, target)) return { err: '拒绝操作：目标不在会话工作区内' }
+    return { abs: fs.processPath(target) }
+  } catch (error) {
+    return { err: '路径解析失败：' + String(error) }
+  }
+}
+
+/**
+ * 取异常的系统错误码（EEXIST/EXDEV 等分支判定用）。
+ * @author ddj 2026年09月22号
+ * @param error 捕获到的异常
+ * @returns 错误码；取不到返回空串
+ */
+function fsErrCode(error: unknown): string {
+  const code = (error as { code?: unknown } | null)?.code
+  return typeof code === 'string' ? code : ''
+}
+
+/**
+ * 复制/移动共用核心（edrv.fsCopy / edrv.fsMove）：目标目录存在 + 同名拒绝覆盖 +
+ * 「不能以自身或其子目录为目标」护栏；move 跨设备（EXDEV）回退「递归复制 + 删除源」。
+ * @author ddj 2026年09月22号
+ * @param ctx DSH 上下文
+ * @param sc requireSession 成功结果（session + cwd）
+ * @param args 请求载荷（from / toDir 均为工作区相对路径）
+ * @param mode copy = 复制；move = 移动
+ * @returns 成功返回 from/to 相对路径；失败返回错误文案
+ */
+async function fsTransfer(
+  ctx: Ctx,
+  sc: { session: Session; cwd: string },
+  args: { from: string; toDir: string },
+  mode: 'copy' | 'move',
+): Promise<{ from: string; to: string } | { err: string }> {
+  const fromRel = normalizeRel(args.from)
+  const toDirRel = normalizeRel(args.toDir)
+  if (fromRel === null || fromRel === '' || toDirRel === null) return { err: '路径不合法' }
+  if (isSubPath(fromRel, toDirRel)) return { err: '不能以自身或其子目录为目标' }
+  const src = await fsOpsTarget(ctx, sc.session, fromRel)
+  if ('err' in src) return src
+  const dir = await fsOpsTarget(ctx, sc.session, toDirRel)
+  if ('err' in dir) return dir
+  const dirInfo = await stat(dir.abs).catch(() => null)
+  if (!dirInfo || !dirInfo.isDirectory()) return { err: '目标目录不存在' }
+  const toRel = joinRelPath(toDirRel, baseNameOf(fromRel))
+  const dst = await fsOpsTarget(ctx, sc.session, toRel)
+  if ('err' in dst) return dst
+  const srcInfo = await stat(src.abs).catch(() => null)
+  if (!srcInfo) return { err: '源不存在' }
+  if (await stat(dst.abs).catch(() => null)) return { err: '目标目录已存在同名文件或目录' }
+  try {
+    await transferEntry(src.abs, dst.abs, mode)
+  } catch (error) {
+    return { err: (mode === 'copy' ? '复制失败：' : '移动失败：') + String(error) }
+  }
+  invalidateIndex(ctx, sc.cwd, fromRel)
+  invalidateIndex(ctx, sc.cwd, toRel)
+  return { from: fromRel, to: toRel }
+}
+
+/**
+ * 单条目复制/移动落盘（文件/目录通用；move 跨设备回退复制+删除源）。
+ * @author ddj 2026年09月22号
+ * @param absFrom 源绝对路径
+ * @param absTo 目标绝对路径
+ * @param mode copy = 复制；move = 移动
+ */
+async function transferEntry(absFrom: string, absTo: string, mode: 'copy' | 'move'): Promise<void> {
+  if (mode === 'copy') {
+    await cp(absFrom, absTo, { recursive: true, force: false, errorOnExist: true })
+    return
+  }
+  try {
+    await rename(absFrom, absTo)
+  } catch (error) {
+    if (fsErrCode(error) !== 'EXDEV') throw error
+    await cp(absFrom, absTo, { recursive: true, force: false, errorOnExist: true })
+    await rm(absFrom, { recursive: true })
+  }
+}
+
+// --endregion
+
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
 export function buildHandlers(
   ctx: Ctx,
@@ -332,26 +483,36 @@ export function buildHandlers(
       }
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
-      const fs = ctx.get('fs')
-      if (!fs) return { ok: false, error: '缺少 fs' }
+      const prep = await readTargetOf(ctx, sc, args.path)
+      if ('err' in prep) return targetErrOf(prep)
       try {
-        const target = await resolveTarget(ctx, sc.session, args.path)
-         debugRecord(ctx, sc.cwd, '[DEBUG path.resolve] input=' + String(args.path ?? '') + ' resolved=' + fs.processPath(target), 'debug')
-        const info = await fs.stat(target)
-        if (!info || info.type !== 'file') {
-          // 带上解析后的真实路径：跳转失败时可直接看出是路径解析错还是目标本身不存在
-          return { ok: false, error: '文件不存在', resolvedPath: fs.processPath(target) }
-        }
-        if ((info.size ?? 0) > BINARY_READ_CAP) return { ok: false, error: '文件过大（>32MB），不支持整文件预览' }
         if (args.encoding === 'base64') {
-          // 图片/PDF 等二进制预览：readBytes 无解码、无二进制拒绝；超上限已由上方 stat 拦截
-          const bytes = await fs.readBytes(target, undefined, BINARY_READ_CAP)
+          // 图片/PDF 等二进制预览：readBytes 无解码、无二进制拒绝；超上限已由 readTargetOf 拦截
+          const bytes = await prep.fs.readBytes(prep.target, undefined, BINARY_READ_CAP)
           const content = Buffer.from(bytes).toString('base64')
-          return { ok: true, content, size: bytes.byteLength, encoding: 'base64', mime: binaryMimeOf(args.path), version: String(info.version ?? '') }
+          return { ok: true, content, size: bytes.byteLength, encoding: 'base64', mime: binaryMimeOf(args.path), version: String(prep.info.version ?? '') }
+        }
+        if ((prep.info.size ?? 0) > READ_CAP) return { ok: false, error: '文件过大（>8MB），不支持整文件预览' }
+        const content = await prep.fs.readText(prep.target)
+        return { ok: true, content, size: content.length, version: String(prep.info.version ?? '') }
+      } catch (error) {
+        return { ok: false, error: '读取失败：' + String(error) }
+      }
+    },
+    'edrv.readBinary': async (args) => {
+      // 二进制直读通道（图片/PDF 预览）：与 edrv.read base64 分支共用 readTargetOf 前置，
+      // 返回 Uint8Array 信封；routes 接线后以 octet-stream + x-edrv-* 头直出，
+      // 未接线时信封被 JSON 化，由 client 探测到后自动回退 base64 路径（见 shared/rpc readBinaryPreview）。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const prep = await readTargetOf(ctx, sc, args.path)
+      if ('err' in prep) return targetErrOf(prep)
+      try {
+        const bytes = await prep.fs.readBytes(prep.target, undefined, BINARY_READ_CAP)
+        return {
+          ok: true,
+          binary: { bytes, mime: binaryMimeOf(args.path), size: bytes.byteLength, version: String(prep.info.version ?? '') },
         }
-        if ((info.size ?? 0) > READ_CAP) return { ok: false, error: '文件过大（>8MB），不支持整文件预览' }
-        const content = await fs.readText(target)
-        return { ok: true, content, size: content.length, version: String(info.version ?? '') }
       } catch (error) {
         return { ok: false, error: '读取失败：' + String(error) }
       }
@@ -612,6 +773,101 @@ export function buildHandlers(
         return { ok: false, error: '打开失败：' + String(error) }
       }
     },
+    'edrv.fsCreateFile': async (args) => {
+      // 新建文件（资源管理器右键「新建文件…」）：空内容独占创建（同名拒绝），
+      // 名称可含 a/b.c 嵌套段（父目录按需创建）；名称校验与客户端弹窗共用 shared/fsNames。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const bad = checkNewName(args.path)
+      if (bad) return { ok: false, error: bad }
+      const r = await fsOpsTarget(ctx, sc.session, args.path)
+      if ('err' in r) return { ok: false, error: r.err }
+      try {
+        await mkdir(dirname(r.abs), { recursive: true })
+        await writeFile(r.abs, '', { flag: 'wx' })
+      } catch (error) {
+        const code = fsErrCode(error)
+        return { ok: false, error: code === 'EEXIST' ? '已存在同名文件或目录' : '新建文件失败：' + String(error) }
+      }
+      invalidateIndex(ctx, sc.cwd, args.path)
+      return { ok: true, path: args.path }
+    },
+    'edrv.fsCreateDir': async (args) => {
+      // 新建文件夹（资源管理器右键「新建文件夹」）：名称可含嵌套段（父目录按需创建），已存在拒绝。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const bad = checkNewName(args.path)
+      if (bad) return { ok: false, error: bad }
+      const r = await fsOpsTarget(ctx, sc.session, args.path)
+      if ('err' in r) return { ok: false, error: r.err }
+      try {
+        await mkdir(dirname(r.abs), { recursive: true })
+        await mkdir(r.abs)
+      } catch (error) {
+        const code = fsErrCode(error)
+        return { ok: false, error: code === 'EEXIST' ? '已存在同名文件或目录' : '新建文件夹失败：' + String(error) }
+      }
+      invalidateIndex(ctx, sc.cwd, args.path)
+      return { ok: true, path: args.path }
+    },
+    'edrv.fsRename': async (args) => {
+      // 重命名（仅名称段、同父目录内）：目标已存在拒绝；名称未变化按幂等成功返回。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const bad = checkRenameName(args.newName)
+      if (bad) return { ok: false, error: bad }
+      const fromRel = normalizeRel(args.path)
+      if (fromRel === null || fromRel === '') return { ok: false, error: '路径不合法' }
+      const toRel = joinRelPath(parentRelOf(fromRel), args.newName)
+      if (toRel === fromRel) return { ok: true, from: fromRel, to: fromRel }
+      const src = await fsOpsTarget(ctx, sc.session, fromRel)
+      if ('err' in src) return { ok: false, error: src.err }
+      const dst = await fsOpsTarget(ctx, sc.session, toRel)
+      if ('err' in dst) return { ok: false, error: dst.err }
+      if (!(await stat(src.abs).catch(() => null))) return { ok: false, error: '源不存在' }
+      try {
+        await rename(src.abs, dst.abs)
+      } catch (error) {
+        const code = fsErrCode(error)
+        const exists = code === 'EEXIST' || code === 'ENOTEMPTY' || code === 'EPERM'
+        return { ok: false, error: exists ? '已存在同名文件或目录' : '重命名失败：' + String(error) }
+      }
+      invalidateIndex(ctx, sc.cwd, fromRel)
+      invalidateIndex(ctx, sc.cwd, toRel)
+      return { ok: true, from: fromRel, to: toRel }
+    },
+    'edrv.fsDelete': async (args) => {
+      // 删除（文件/文件夹递归；「删除/永久删除」共用）：根拒绝；破坏性由客户端确认框把关。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const rel = normalizeRel(args.path)
+      if (rel === null || rel === '') return { ok: false, error: '路径不合法' }
+      const r = await fsOpsTarget(ctx, sc.session, rel)
+      if ('err' in r) return { ok: false, error: r.err }
+      try {
+        await rm(r.abs, { recursive: true })
+      } catch (error) {
+        return { ok: false, error: '删除失败：' + String(error) }
+      }
+      invalidateIndex(ctx, sc.cwd, rel)
+      return { ok: true, path: rel }
+    },
+    'edrv.fsCopy': async (args) => {
+      // 复制到目标目录（文件/文件夹递归）：同名拒绝覆盖（细节见 fsTransfer）。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const r = await fsTransfer(ctx, sc, args, 'copy')
+      if ('err' in r) return { ok: false, error: r.err }
+      return { ok: true, from: r.from, to: r.to }
+    },
+    'edrv.fsMove': async (args) => {
+      // 移动到目标目录（文件/文件夹）：同名拒绝覆盖（细节见 fsTransfer）。
+      const sc = await requireSession(ctx, args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      const r = await fsTransfer(ctx, sc, args, 'move')
+      if ('err' in r) return { ok: false, error: r.err }
+      return { ok: true, from: r.from, to: r.to }
+    },
     'mcp.list': async () => ({ ok: true, ...listMcp(ctx) }),
     'mcp.save': async (args) => {
       try { return { ok: true, server: await saveMcp(ctx, args.config) } }
@@ -651,22 +907,20 @@ export function buildHandlers(
     },
     'vscode.fileOpenSettingsGet': async () => {
       const settings = ctx.get('settings')
-      const descriptor = settings?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
-      const value = descriptor?.value as { fileOpenTool?: unknown } | undefined
-      return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? FILE_OPEN_DEFAULT), integrationBaseUrl: await integrationBaseUrlOf(ctx), revision: descriptor?.revision }
+      const section = sectionOf(settings, FILE_OPEN_SETTINGS_NS)
+      const value = section?.value as { fileOpenTool?: unknown } | undefined
+      return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool ?? FILE_OPEN_DEFAULT), integrationBaseUrl: await integrationBaseUrlOf(ctx), revision: section?.revision }
     },
     'vscode.fileOpenSettingsUpdate': async (args) => {
       const settings = ctx.get('settings')
-      if (!settings?.update) return { ok: false, error: '设置服务不可用' }
-      try {
-        const patch: Record<string, unknown> = { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) }
-        if (typeof args.integrationBaseUrl === 'string' && args.integrationBaseUrl.trim()) patch.integrationBaseUrl = args.integrationBaseUrl.trim()
-        await settings.update(FILE_OPEN_SETTINGS_NS, patch, args.expectedRevision)
-        const descriptor = settings.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
-        const value = descriptor?.value as { fileOpenTool?: unknown } | undefined
-        return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool), integrationBaseUrl: await integrationBaseUrlOf(ctx), revision: descriptor?.revision }
-      } catch (error) { return { ok: false, error: String(error) }
-      }
+      const patch: Record<string, unknown> = { fileOpenTool: normalizeFileOpenTool(args.fileOpenTool) }
+      if (typeof args.integrationBaseUrl === 'string' && args.integrationBaseUrl.trim()) patch.integrationBaseUrl = args.integrationBaseUrl.trim()
+      // 冲突自愈（0.1.7 SettingsConflictError 重读重试一次）与形状校验读取统一走 fileOpenSettings 工具
+      const result = await updateSection(settings, FILE_OPEN_SETTINGS_NS, patch, args.expectedRevision)
+      if (!result.ok) return { ok: false, error: result.error ?? '设置服务不可用' }
+      const section = sectionOf(settings, FILE_OPEN_SETTINGS_NS)
+      const value = section?.value as { fileOpenTool?: unknown } | undefined
+      return { ok: true, fileOpenTool: normalizeFileOpenTool(value?.fileOpenTool), integrationBaseUrl: await integrationBaseUrlOf(ctx), revision: section?.revision }
     },
     'compat': async () => ({ ok: true, report: await buildReport(ctx) }),
     'vscode.devFormGet': async () => ({ ok: true, devForm: readDevForm() }),
@@ -757,6 +1011,7 @@ export function buildHandlers(
         const inventory = await scanSessionInventory(home, sessionsArchiveRoot(home))
         const active = activeSessionIds(ctx)
         markActiveSessions(inventory.sessions, active)
+        markOfficialFlags(inventory.sessions, ctx)
         return { ok: true, ...inventory, activeIds: [...active] }
       } catch (error) {
         return { ok: false, error: '盘点失败：' + String(error) }
@@ -794,7 +1049,10 @@ export function buildHandlers(
     'edrv.perf.restore': async (args) => {
       try {
         const result = await restoreSession(dshHome(), sessionsArchiveRoot(dshHome()), args.workspaceKey, args.sessionId)
-        return result.ok ? { ok: true, restored: true } : { ok: false, error: result.error ?? '恢复失败' }
+        if (!result.ok) return { ok: false, error: result.error ?? '恢复失败' }
+        // 目录搬回后对齐官方归档标志（best-effort：服务缺失/调用失败不影响恢复结果，见 perf.unarchiveOfficial）
+        await unarchiveOfficial(ctx, args.sessionId)
+        return { ok: true, restored: true }
       } catch (error) {
         return { ok: false, error: '恢复失败：' + String(error) }
       }

package/src/shared/fsNames.ts

@@ -0,0 +1,115 @@
+/**
+ * dsh-vscode-mode shared — 文件操作名称/路径校验（纯函数，可单测）。
+ * 新建/重命名输入护栏（客户端弹窗校验与 host 端二次校验共用一份）：
+ * 空名、绝对路径、盘符、'.'/'..' 路径段、空路径段、控制字符、超长一律拒绝；
+ * 新建允许 a/b.c 嵌套段（对齐 VS Code「新建文件…」输入语义），重命名仅允许单个名称段。
+ * 作者 ddj 2026年09月22号
+ */
+
+/** 单个名称段最大长度（防误贴超长串直接打到文件系统）。 */
+export const NAME_MAX = 255
+
+/**
+ * 路径归一：去首尾空白 + 反斜杠转 '/'（Windows 输入等价处理）。
+ * @author ddj 2026年09月22号
+ * @param raw 原始输入
+ * @returns 归一后的字符串
+ */
+function normPath(raw: unknown): string {
+  return String(raw ?? '').trim().replace(/\\/g, '/')
+}
+
+/**
+ * 单个名称段的通用违规检查（两套校验共用）。
+ * @author ddj 2026年09月22号
+ * @param seg 名称段
+ * @returns 错误文案；null = 通过
+ */
+function checkSegment(seg: string): string | null {
+  if (!seg) return '名称包含空路径段'
+  if (seg === '.' || seg === '..') return '名称不能包含 . 或 .. 路径段'
+  if (seg.length > NAME_MAX) return '名称过长（单段超过 ' + NAME_MAX + ' 字符）'
+  if (/[\0-\x1f]/.test(seg)) return '名称包含非法控制字符'
+  return null
+}
+
+/**
+ * 校验新建文件/文件夹的相对路径（允许 a/b.c 嵌套段）。
+ * @author ddj 2026年09月22号
+ * @param raw 用户输入的名称或相对路径
+ * @returns 错误文案；null = 校验通过
+ */
+export function checkNewName(raw: unknown): string | null {
+  const text = normPath(raw)
+  if (!text) return '名称不能为空'
+  if (text.startsWith('/')) return '名称不能是绝对路径'
+  if (/^[a-zA-Z]:/.test(text)) return '名称不能带盘符'
+  for (const seg of text.split('/')) {
+    const bad = checkSegment(seg)
+    if (bad) return bad
+  }
+  return null
+}
+
+/**
+ * 校验重命名的新名称（仅单个名称段，不接受路径）。
+ * @author ddj 2026年09月22号
+ * @param raw 用户输入的新名称
+ * @returns 错误文案；null = 校验通过
+ */
+export function checkRenameName(raw: unknown): string | null {
+  const text = normPath(raw)
+  if (!text) return '名称不能为空'
+  if (text.includes('/')) return '新名称不能包含路径分隔符'
+  return checkSegment(text)
+}
+
+/**
+ * 拼接工作区相对路径（dir 为空 = 根；name 新建时可含多段）。
+ * @author ddj 2026年09月22号
+ * @param dir 目标目录（工作区相对）
+ * @param name 名称
+ * @returns 拼接后的相对路径
+ */
+export function joinRelPath(dir: string, name: string): string {
+  const base = normPath(dir).replace(/\/+$/, '')
+  const add = normPath(name).replace(/^\/+/, '')
+  return base ? base + '/' + add : add
+}
+
+/**
+ * 取相对路径的父目录（顶层条目返回空串 = 根）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @returns 父目录相对路径
+ */
+export function parentRelOf(path: string): string {
+  const parts = normPath(path).split('/').filter(Boolean)
+  parts.pop()
+  return parts.join('/')
+}
+
+/**
+ * 取相对路径的名称段（末段）。
+ * @author ddj 2026年09月22号
+ * @param path 工作区相对路径
+ * @returns 末段名称
+ */
+export function baseNameOf(path: string): string {
+  const parts = normPath(path).split('/').filter(Boolean)
+  return parts.pop() ?? ''
+}
+
+/**
+ * other 是否为 base 本身或其内部路径（复制/移动「不能以自身或其子目录为目标」护栏）。
+ * @author ddj 2026年09月22号
+ * @param base 基准相对路径（源）
+ * @param other 待判定相对路径（目标目录）
+ * @returns 是否为自身或子路径
+ */
+export function isSubPath(base: string, other: string): boolean {
+  const b = normPath(base).replace(/\/+$/, '')
+  const o = normPath(other).replace(/\/+$/, '')
+  if (!b) return false
+  return o === b || o.startsWith(b + '/')
+}

package/src/shared/keybindings.ts

@@ -22,6 +22,8 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
   'edrv.nextTab': 'Ctrl+Alt+ArrowRight|Ctrl+PageDown',
   'edrv.prevTab': 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp',
+  // 转到行：插件只补键位与命令栏入口，widget 本体转发 Monaco 原生 editor.action.gotoLine（VS Code 同款 Ctrl+G）
+  'edrv.goToLine': 'Ctrl+G',
   // 命令栏（Ctrl+Shift+P 主候选；F1 为 VS Code 同款第二候选）与编辑行导航
   'edrv.showCommands': 'Ctrl+Shift+P|F1',
   'edrv.nextEditorRow': 'Ctrl+Alt+ArrowDown',

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[]
 }