dsh-vscode-mode 0.5.1 → 0.5.3

package/src/fileOpenSettings.ts

@@ -11,6 +11,7 @@ import { createRequire } from 'node:module'
 import { pathToFileURL } from 'node:url'
 import type { Ctx } from './store.js'
 import { KEYBINDING_DEFAULTS } from './shared/keybindings.js'
+import { EDITOR_LIMIT_DEFAULT } from './shared/editorLimit.js'
 import { INTEGRATION_BASE_DEFAULT } from './shared/integration.js'
 import { TORTOISE_DIR_DEFAULT } from './shared/svn.js'
 import type { AiConfigPatch, AiConfigView } from './shared/ai.js'
@@ -73,20 +74,96 @@ async function hostImport(specifier: string): Promise<unknown> {
 }
 
 /**
- * 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
- * installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
- * 属性探测得到 undefined，不抛错）。
- * @author ddj 2026年08月24号 / 2026年09月15号
+ * schema 库候选名（新名在前）。
+ * DSH 官方自 0.1.5 起把 vendored 包改名为 @deepseek-ai/schemastery 并全树改用新名，
+ * 安装树里**没有**裸 schemastery；裸名保留给 rc 线（其 dsh-settings 仍 peers 旧名），
+ * 也让开发形态（插件 node_modules 有 devDependency 副本）继续可用。
+ */
+const SCHEMA_SPECIFIERS = ['@deepseek-ai/schemastery', 'schemastery'] as const
+
+/** 设置持久化包名（installSettingsSection 仅 rc 线提供，alpha 线缺失属正常）。 */
+const SETTINGS_SPECIFIER = '@deepseek-ai/dsh-settings'
+
+/**
+ * 逐个尝试候选名，返回首个加载成功的模块及其包名（全失败返回 null，不抛错）。
+ * @author ddj 2026年09月18号
+ * @param specifiers 候选包名（按优先级）
+ * @param importFn 加载函数（测试注入）
+ * @returns 命中的模块与包名；全失败返回 null
+ */
+async function firstImport(
+  specifiers: readonly string[],
+  importFn: (specifier: string) => Promise<unknown> = hostImport,
+): Promise<{ specifier: string; module: unknown } | null> {
+  for (const specifier of specifiers) {
+    try {
+      return { specifier, module: await importFn(specifier) }
+    } catch {
+      /* 该候选不可解析：尝试下一个 */
+    }
+  }
+  return null
+}
+
+/**
+ * 抹平 schema 库的 ESM/CJS 互操作形态取默认导出。
+ * 三种实测形态：真 ESM（`default` 即 z）、CJS 经 import()（`default` 与
+ * `module.exports` 同为 z）、双层包装（`default.default` 才是 z）。
+ * @author ddj 2026年09月18号
+ * @param module 加载到的模块命名空间（可空）
+ * @returns 具备 object/string 等构造器的 z；取不到返回 null
+ */
+export function pickSchema(module: unknown): SettingsDeps['z'] | null {
+  const layers = [module, (module as { default?: unknown } | null)?.default, (module as Record<string, unknown> | null)?.['module.exports']]
+  for (const layer of layers) {
+    const z = ((layer as { default?: unknown } | null)?.default ?? layer) as SettingsDeps['z'] | undefined
+    if (z && typeof z.object === 'function' && typeof z.string === 'function') return z
+  }
+  return null
+}
+
+/** 实际命中的 schema 库名（供兼容性报告展示；未命中为空串）。 */
+let schemaLib = ''
+
+/**
+ * 读取实际命中的 schema 库名（报告文案用）。
+ * @author ddj 2026年09月18号
+ * @returns 包名；未解析到为空串
+ */
+export function schemaLibName(): string {
+  return schemaLib
+}
+
+/** 复位依赖缓存与命中库名（测试隔离用）。 */
+export function resetSettingsDeps(): void {
+  depsPromise = undefined
+  schemaLib = ''
+}
+
+/**
+ * 动态加载设置依赖（模块级缓存；schema 库缺失返回 null 而非抛错）。
+ * ⚠️ 两个依赖**独立解析**：@deepseek-ai/dsh-settings 仅 rc 线跑 legacy 策略时需要，
+ * alpha 线走 settings 服务 installSection 用不到它；原先 Promise.all 让该包缺失
+ * 拖垮整体 → 用户端（npm 安装）settings section 永不装配。
+ * 同理，schema 库按候选链解析（安装树只有新名 @deepseek-ai/schemastery）。
+ * @author ddj 2026年08月24号 / 2026年09月15号 / 2026年09月18号
+ * @param importFn 加载函数（测试注入；缺省宿主锚点动态导入）
  * @returns 设置依赖或 null
  */
-export function loadSettingsDeps(): Promise<SettingsDeps | null> {
+export function loadSettingsDeps(importFn: (specifier: string) => Promise<unknown> = hostImport): Promise<SettingsDeps | null> {
   if (!depsPromise) {
-    depsPromise = Promise.all([hostImport('@deepseek-ai/dsh-settings'), hostImport('schemastery')])
-      .then(([dshSettings, schemastery]) => ({
+    depsPromise = Promise.all([firstImport([SETTINGS_SPECIFIER], importFn), firstImport(SCHEMA_SPECIFIERS, importFn)])
+      .then(([settingsHit, schemaHit]) => {
+        const z = pickSchema(schemaHit?.module)
+        if (!z) {
+          schemaLib = ''
+          return null
+        }
+        schemaLib = schemaHit?.specifier ?? ''
         // 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,
-      }))
+        const installSettingsSection = (settingsHit?.module as unknown as { installSettingsSection?: SettingsDeps['installSettingsSection'] } | undefined)?.installSettingsSection
+        return { installSettingsSection, z }
+      })
       .catch(() => null)
   }
   return depsPromise
@@ -264,6 +341,8 @@ export async function installOpenSettingsSection(
     fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT),
     keybindings: deps.z.object(keybindingsShape(deps.z)).default({ ...KEYBINDING_DEFAULTS }),
     sidebarMinWidth: deps.z.number().default(300),
+    // 页签数量上限（0 = 不限制；超限时淘汰最久未使用的页签，固定页签除外）
+    maxOpenEditors: deps.z.number().default(EDITOR_LIMIT_DEFAULT),
     integrationBaseUrl: deps.z.string().default(INTEGRATION_BASE_DEFAULT),
     // AI 内联补全（默认关；provider/model 空 = 自动路由；effort 空 = 跟随模型默认）
     aiInline: deps.z.boolean().default(AI_CONFIG_DEFAULT.enabled),

package/src/lsp/extmgr.ts

@@ -5,9 +5,9 @@
  * 已装扩展作为 LSP provider 的"扩展源"（kind=extension），见 providers.ts。
  * 作者 ddj 2026-08-27
  */
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
+import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import { basename, dirname, join } from 'node:path'
-import { unzip } from './zip.js'
+import { unzip, type ZipEntry } from './zip.js'
 import { dshHome, PLUGIN_ID } from '../paths.js'
 
 /** 单个已装扩展信息（edrv.lsp.ext.list 载荷元素）。 */
@@ -57,9 +57,61 @@ export function vsixManifest(vsix: Buffer): Record<string, unknown> {
   throw new Error('VSIX 缺少 extension/package.json')
 }
 
+/**
+ * 判定解包路径是否为可执行入口（无 mode 时的启发式兜底）。
+ * 只认确定语义：`bin/` 段下的文件、语言服务器/运行时常见可执行名、`.sh` 脚本。
+ * @author ddj 2026年09月18号
+ * @param rel 相对路径（/ 分隔）
+ * @returns 是否应补执行位
+ */
+export function looksExec(rel: string): boolean {
+  const path = String(rel ?? '').replace(/\\/g, '/')
+  if (!path) return false
+  if (path.split('/').includes('bin')) return true
+  if (/\.(sh|bash|zsh)$/i.test(path)) return true
+  const name = path.split('/').pop() ?? ''
+  const base = name.replace(/\.exe$/i, '')
+  return ['lua-language-server', 'emmylua_ls', 'OmniSharp', 'dotnet', 'node'].includes(base)
+}
+
+/**
+ * 计算解包后要施加的权限位（纯函数，可单测）。
+ * 优先信任归档自带的 Unix mode 中的执行位（VS Code 自身解 VSIX 即此口径）；
+ * 归档无 mode（Windows 打包的 VSIX）时按路径启发式补 0o755；
+ * 其余保持 undefined（交给 umask 默认，不越权改动）。
+ * @author ddj 2026年09月18号
+ * @param entry 解压条目
+ * @returns 目标权限位；无需处理返回 undefined
+ */
+export function execModeOf(entry: ZipEntry): number | undefined {
+  if (entry.isDirectory) return undefined
+  const mode = entry.mode
+  if (mode !== undefined && (mode & 0o111) !== 0) return mode
+  return looksExec(entry.path) ? 0o755 : undefined
+}
+
+/**
+ * 落盘后补可执行位（POSIX 专属；Windows 无此概念，直接跳过）。
+ * 必须 best-effort：只读文件系统/无权限时不能拖垮整个扩展安装。
+ * @author ddj 2026年09月18号
+ * @param target 落盘绝对路径
+ * @param entry 解压条目
+ * @param platform 目标平台（测试注入）
+ */
+export function applyExecBit(target: string, entry: ZipEntry, platform: NodeJS.Platform = process.platform): void {
+  if (platform === 'win32') return
+  const mode = execModeOf(entry)
+  if (mode === undefined) return
+  try {
+    chmodSync(target, mode)
+  } catch (error) {
+    /* 权限补不上不阻塞安装（后续 spawn 会给出真实错误） */
+  }
+}
+
 /**
  * 解包 VSIX 到目录（仅取 extension/ 子树，剥前缀；返回清单）。
- * @author ddj 2026年08月27号
+ * @author ddj 2026年08月27号 / 2026年09月18号
  * @param vsix vsix 字节
  * @param dest 目标目录（已存在则先清空）
  * @returns 清单对象
@@ -80,6 +132,7 @@ export function unpackVsix(vsix: Buffer, dest: string): Record<string, unknown>
     }
     mkdirSync(dirname(target), { recursive: true })
     writeFileSync(target, entry.data)
+    applyExecBit(target, entry)
     if (rel === 'package.json') manifest = JSON.parse(entry.data.toString('utf8')) as Record<string, unknown>
   }
   if (!manifest) throw new Error('VSIX 解包后缺少 package.json')

package/src/lsp/zip.ts

@@ -6,11 +6,13 @@
  */
 import { inflateRawSync } from 'node:zlib'
 
-/** 单条解压结果：相对路径 + 内容（目录条目 path 以 / 结尾）。 */
+/** 单条解压结果：相对路径 + 内容（目录条目 path 以 / 结尾）+ Unix 权限位（可缺失）。 */
 export interface ZipEntry {
   path: string
   data: Buffer
   isDirectory: boolean
+  /** Unix 权限位（中央目录 external attributes 高 16 位；0 或非 Unix 归档时缺失）。 */
+  mode?: number
 }
 
 const EOCD_SIG = 0x06054b50
@@ -19,16 +21,16 @@ const LHDR_SIG = 0x04034b50
 
 /**
  * 解析 ZIP 缓冲区 → 条目列表（不解压内容，仅元数据）。
- * @author ddj 2026年08月27号
+ * @author ddj 2026年08月27号 / 2026年09月18号
  * @param buf zip 字节
- * @returns 条目元数据
+ * @returns 条目元数据（含 Unix mode，见 modeOf）
  */
-export function zipEntries(buf: Buffer): { name: string; method: number; compressed: number; uncompressed: number; localOffset: number }[] {
+export function zipEntries(buf: Buffer): { name: string; method: number; compressed: number; uncompressed: number; localOffset: number; mode?: number }[] {
   const eocd = findEocd(buf)
   if (eocd < 0) throw new Error('不是有效的 ZIP 文件（找不到 EOCD）')
   const total = buf.readUInt16LE(eocd + 10)
   let offset = buf.readUInt32LE(eocd + 16)
-  const out: { name: string; method: number; compressed: number; uncompressed: number; localOffset: number }[] = []
+  const out: { name: string; method: number; compressed: number; uncompressed: number; localOffset: number; mode?: number }[] = []
   for (let i = 0; i < total; i++) {
     if (buf.readUInt32LE(offset) !== CDIR_SIG) throw new Error('ZIP 中央目录损坏')
     const method = buf.readUInt16LE(offset + 10)
@@ -39,17 +41,31 @@ export function zipEntries(buf: Buffer): { name: string; method: number; compres
     const commentLen = buf.readUInt16LE(offset + 32)
     const localOffset = buf.readUInt32LE(offset + 42)
     const name = buf.subarray(offset + 46, offset + 46 + nameLen).toString('utf8')
-    out.push({ name, method, compressed, uncompressed, localOffset })
+    const mode = modeOf(buf.readUInt32LE(offset + 38))
+    out.push({ name, method, compressed, uncompressed, localOffset, ...(mode === undefined ? {} : { mode }) })
     offset += 46 + nameLen + extraLen + commentLen
   }
   return out
 }
 
+/**
+ * 中央目录 external attributes → Unix 权限位。
+ * ZIP 把 Unix mode 放在 `st_mode << 16`（含 S_IFREG 等类型位），低 16 位仅 DOS 属性；
+ * 故必须右移 16 再取低 9 位权限。非 Unix 归档（Windows 打包）该字段为 0 或纯 DOS 位。
+ * @author ddj 2026年09月18号
+ * @param attributes 中央目录 offset+38 的 4 字节
+ * @returns 0o000~0o777 权限位；无有效 mode 返回 undefined
+ */
+export function modeOf(attributes: number): number | undefined {
+  const mode = (attributes >>> 16) & 0o777
+  return mode === 0 ? undefined : mode
+}
+
 /**
  * 解压 ZIP → 条目列表（目录条目含尾部 /）。
- * @author ddj 2026年08月27号
+ * @author ddj 2026年08月27号 / 2026年09月18号
  * @param buf zip 字节
- * @returns 条目（含内容）
+ * @returns 条目（含内容与可选 mode）
  */
 export function unzip(buf: Buffer): ZipEntry[] {
   const metas = zipEntries(buf)
@@ -66,7 +82,7 @@ export function unzip(buf: Buffer): ZipEntry[] {
       const raw = buf.subarray(dataStart, dataStart + meta.compressed)
       data = meta.method === 8 ? Buffer.from(inflateRawSync(raw)) : meta.method === 0 ? Buffer.from(raw) : Buffer.alloc(0)
     }
-    out.push({ path: meta.name, data, isDirectory: isDir })
+    out.push({ path: meta.name, data, isDirectory: isDir, ...(meta.mode === undefined ? {} : { mode: meta.mode }) })
   }
   return out
 }

package/src/revert.ts

@@ -11,9 +11,26 @@ import { applyLocations, locateHunks, preciseHunk } from './shared/diff.js'
 /** 回滚结果；stale=true 表示该 hunk 的新文本已不在文件中（无可回滚内容，不算失败）。 */
 export type Result = { ok: true } | { ok: false; error: string; stale?: boolean }
 
+/**
+ * 删除单文件的 argv（纯函数，platform 可注入便于单测）。
+ * Windows 走 PowerShell Remove-Item；其余平台走 /bin/rm。
+ * 原先无条件先发 powershell：macOS/Linux 上必然 spawn 失败后才回落，
+ * 每删一个文件多一次无谓 spawn 与失败噪声。
+ * @author ddj 2026年09月18号
+ * @param absPath 绝对路径
+ * @param platform 目标平台（缺省当前进程平台）
+ * @returns 删除命令 argv
+ */
+export function removeFileArgv(absPath: string, platform: NodeJS.Platform = process.platform): string[] {
+  if (platform === 'win32') {
+    return ['powershell', '-NoProfile', '-NonInteractive', '-Command', 'Remove-Item -LiteralPath "' + absPath + '" -Force']
+  }
+  return ['/bin/rm', '-f', '--', absPath]
+}
+
 /**
  * 删除新建文件（拒绝创建时）：subprocess 删除，路径先经 fs.contains 校验工作区边界。
- * @author ddj 2026年08月20号
+ * @author ddj 2026年08月20号 / 2026年09月18号
  * @returns 成功或失败原因
  */
 export async function deleteCreated(ctx: Ctx, session: Session, record: DiffRecord): Promise<Result> {
@@ -40,15 +57,10 @@ export async function deleteCreated(ctx: Ctx, session: Session, record: DiffReco
     }
   }
   try {
-    await attempt(['powershell', '-NoProfile', '-NonInteractive', '-Command', 'Remove-Item -LiteralPath "' + p + '" -Force'])
+    await attempt(removeFileArgv(p))
     return { ok: true }
   } catch (error) {
-    try {
-      await attempt(['/bin/rm', '-f', '--', p])
-      return { ok: true }
-    } catch (error2) {
-      return { ok: false, error: '删除失败（文件仍存在）：' + String(error) + ' / ' + String(error2) }
-    }
+    return { ok: false, error: '删除失败（文件仍存在）：' + String(error) }
   }
 }
 

package/src/shared/editorLimit.ts

@@ -0,0 +1,46 @@
+/**
+ * dsh-vscode-mode shared — 编辑器页签数量上限的常量与归一化（host 与 client 双面契约）。
+ *
+ * 纯数据模块：host（settings schema 默认值）与 client（淘汰判定）共用，禁止 import
+ * 浏览器 API 或 Node API。
+ *
+ * ⚠️ 与 sidebarMinWidth 的关键差异：**0 是合法值**，语义为「不限制页签数量」，
+ * 因此归一化时不能像 normalizeSidebarMinWidth 那样把 0 当作非法输入回退默认值。
+ *
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 页签数量上限默认值（对齐 VS Code workbench.editor.limit 默认 10）。 */
+export const EDITOR_LIMIT_DEFAULT = 10
+/** 上限允许下界：0 = 不限制（关闭上限功能）。 */
+export const EDITOR_LIMIT_FLOOR = 0
+/** 上限允许上界（防呆：远超屏幕可容纳数量的上限无意义）。 */
+export const EDITOR_LIMIT_CEIL = 50
+
+/**
+ * 归一化页签数量上限。
+ *
+ * 规则：`0` 合法保留（不限制）；非数字/非有限/负数 → 回退默认；其余取整后夹到
+ * `[EDITOR_LIMIT_FLOOR, EDITOR_LIMIT_CEIL]`。
+ * 数字字符串（设置文档/输入框可能给字符串）按数字解析，与 sidebarMin 口径一致。
+ *
+ * ⚠️ 只接受「真数字」与「非空数字字符串」：不得用裸 `Number(value)` 判值——
+ * `Number(null)`、`Number([])`、`Number(false)`、`Number('')` 全是 0，会被误判成
+ * 「不限制」；而缺失/损坏的设置必须回退默认（否则一个坏值就永久关掉上限）。
+ *
+ * @author ddj 2026年09月18号
+ * @param value 原始值（设置文档或输入框来的任意 JSON 值）
+ * @returns 合法上限（0 = 不限制）
+ */
+export function normalizeMaxOpenEditors(value: unknown): number {
+  let n: number
+  if (typeof value === 'number') {
+    n = value
+  } else if (typeof value === 'string' && value.trim() !== '') {
+    n = Number(value)
+  } else {
+    return EDITOR_LIMIT_DEFAULT
+  }
+  if (!Number.isFinite(n) || n < 0) return EDITOR_LIMIT_DEFAULT
+  return Math.max(EDITOR_LIMIT_FLOOR, Math.min(EDITOR_LIMIT_CEIL, Math.round(n)))
+}

package/src/shared/keybindings.ts

@@ -14,6 +14,9 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   'edrv.quickOpen': 'Ctrl+P',
   'edrv.toggleSidebar': 'Ctrl+B',
   'edrv.searchInFiles': 'Ctrl+Shift+F',
+  // Markdown 预览切换：VS Code 同款 (Ctrl+K V 为分栏，此处取单键 Ctrl+Shift+V)。
+  // 仅当活动文件是 .md 时才吞键，其余情况放行给浏览器/输入框（保留「粘贴为纯文本」语义）。
+  'edrv.toggleMarkdownPreview': 'Ctrl+Shift+V',
   'edrv.navigateBack': 'Alt+ArrowLeft|Ctrl+Alt+-',
   'edrv.navigateForward': 'Alt+ArrowRight|Ctrl+Shift+-',
   // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）