dsh-vscode-mode 0.5.1 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
@@ -51,6 +51,7 @@
     "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
     "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
+    "@deepseek-ai/schemastery": ">=3.18.0 <4",
     "cordis": ">=4.0.0-rc <5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",

package/src/compat.ts

@@ -10,7 +10,7 @@ import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { entriesOf } from './mcp.js'
-import { loadSettingsDeps, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
+import { loadSettingsDeps, schemaLibName, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
 import { compareDshVersions, detectDshVersion, familyLabel, parseDshVersion } from './dshVersion.js'
 import { SKILL_PREFIXES, skillGroupState } from './skills.js'
@@ -59,7 +59,7 @@ export function detectExternal(ctx: Ctx, depsAvailable: boolean): CompatAdapter[
   const skills = skillGroupState()
   return [
     { name: MCP_PACKAGE, active: mcpCount > 0, note: mcpCount > 0 ? mcpCount + ' 个 MCP 服务条目' : '未检测到 MCP 条目（MCP 管理页显示为空）' },
-    { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装' : '未安装：fileOpenTool 持久化降级为配置值' },
+    { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装（schema: ' + (schemaLibName() || '未知') + '）' : '未安装：fileOpenTool 持久化降级为配置值' },
     { name: 'settings 服务', active: hasSettings, note: hasSettings ? '可读写设置' : '不可用（设置读写走配置回退）' },
     { name: '文件浏览器打开（subprocess 服务）', active: typeof sub?.spawn === 'function', note: typeof sub?.spawn === 'function' ? '可定位/打开 OS 文件浏览器' : '不可用（右键「在文件浏览器中打开」将提示失败）' },
     // 新增项一律追加在末尾：既有下标被 tests/compat.test.ts 断言，不得前插。

package/src/fileOpenSettings.ts

@@ -73,20 +73,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

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