dsh-vscode-mode 0.5.0 → 0.5.2

package/src/client/snippets/provider.ts

@@ -23,6 +23,16 @@ let pending = null
 let registered = false
 let disposer = null
 
+/**
+ * 片段 provider 注销器的全局挂点名。
+ *
+ * 为什么挂 window：`window.monaco` 由 loader 注入后**跨插件重载存活**，而模块级
+ * registered/disposer 会随 bundle 重新求值复位 —— 只判 registered 会在每次重载后
+ * 重复注册补全 provider（同一编辑器出现重复候补）。故注销器落 window 供跨代认领与清理。
+ * @author ddj 2026年09月18号
+ */
+const SNIPPET_GLOBAL = '__edrvSnippetsDisposer__'
+
 /** 当前会话 id（补全按会话工作区叠加项目片段；EditorView 装配时注入）。 */
 let sessionId = null
 
@@ -102,6 +112,12 @@ export function entriesForLanguage(entries, languageId) {
  */
 export function registerSnippetProvider(monaco) {
   if (registered || !monaco?.languages?.registerCompletionItemProvider) return
+  // 跨重载守卫：上一代 bundle 注册的 provider 仍在存活 window.monaco 上（注销器已落 window）
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  if (host && host[SNIPPET_GLOBAL]) {
+    registered = true
+    return
+  }
   const snippetKind = monaco.languages.CompletionItemKind?.Snippet
   const asSnippet = monaco.languages.CompletionItemInsertTextRule?.InsertAsSnippet
   // 缺少片段枚举（精简版 Monaco）时不注册：否则候选项会退化为纯文本插入，误导用户
@@ -135,6 +151,8 @@ export function registerSnippetProvider(monaco) {
       }
     },
   })
+  // 注销器落 window：跨重载认领（见 SNIPPET_GLOBAL 说明）
+  if (host) host[SNIPPET_GLOBAL] = disposer
 }
 
 /**
@@ -147,13 +165,17 @@ export function setupSnippets(monaco) {
 }
 
 /**
- * 卸载：注销 provider（插件热重载/卸载时调用）。
- * @author ddj 2026年09月10号
+ * 卸载：注销 provider 并复位状态（插件热重载/卸载时调用）。
+ * 兼容上一代 bundle 遗留的 window 注销器（模块级 disposer 为空时仍能清干净）。
+ * @author ddj 2026年09月10号 / 2026年09月18号
  */
 export function disposeSnippets() {
-  if (typeof disposer === 'function') {
-    try { disposer.dispose?.() } catch { /* 已注销 */ }
+  const host = /* @__PURE__ */ (typeof window === 'undefined' ? undefined : window)
+  const target = (typeof disposer === 'function' ? disposer : null) ?? (host ? host[SNIPPET_GLOBAL] : null)
+  if (target && typeof target.dispose === 'function') {
+    try { target.dispose() } catch { /* 已注销 */ }
   }
+  if (host) delete host[SNIPPET_GLOBAL]
   disposer = null
   registered = false
   invalidateSnippets()

package/src/client/tabActions.ts

@@ -184,23 +184,48 @@ function isPinned(tab: TabLike): boolean {
 /**
  * 归一化持久化的页签数据：兼容旧版 `string[]`、去重、固定分区。
  * 损坏项（非字符串/非对象/无 path）直接丢弃。
- * @author ddj 2026年09月11号
+ *
+ * G9：传入 cwd 时把每个路径收敛为**页签规范形态**（工作区相对路径），
+ * 以迁移历史持久化数据里残留的绝对路径（见 {@link tabPathOf}）。
+ * @author ddj 2026年09月11号 / 2026年09月18号
  * @param raw localStorage 解析结果（任意形状）
+ * @param cwd 会话工作区目录（可选；给出时同步归一化路径形态）
  * @returns 归一化后的页签数组
  */
-export function normalizeTabs(raw: unknown): TabLike[] {
+export function normalizeTabs(raw: unknown, cwd?: string | null): TabLike[] {
   if (!Array.isArray(raw)) return []
   const seen = new Set<string>()
   const out: TabLike[] = []
   for (const item of raw) {
     const tab = tabOf(item)
-    if (!tab || seen.has(tab.path)) continue
-    seen.add(tab.path)
-    out.push(tab)
+    if (!tab) continue
+    const path = tabPathOf(tab.path, cwd)
+    if (!path || seen.has(path)) continue
+    seen.add(path)
+    out.push(tab.pinned === true ? { path, pinned: true } : { path })
   }
   return pinnedFirst(out)
 }
 
+/**
+ * 页签规范形态 = 工作区相对路径（G9）。
+ *
+ * 为什么需要：差异记录路径取自工具结果 `target.displayPath`（官方恒为绝对拼写），
+ * 而资源管理器树给出的是工作区相对路径。两者进页签后，地址栏形态不一致，且
+ * `insertTab` 按原串去重 → 同一文件可能出两个页签；绝对路径还会被
+ * `isTreeRevealable` 判为不可定位，「在资源管理器视图中显示」对差异入口失效。
+ * 统一经 {@link relativeOf} 收敛后，页签/地址栏/去重/持久化/`sameFile` 口径一致。
+ *
+ * 工作区外文件（全局片段/规则）由 relativeOf 自然回退为原绝对路径，语义不变。
+ * @author ddj 2026年09月18号
+ * @param path 原始路径（绝对或相对，两种分隔符均可）
+ * @param cwd 会话工作区目录（可空；无 cwd 时仅做分隔符归一）
+ * @returns 页签规范路径
+ */
+export function tabPathOf(path: string, cwd?: string | null): string {
+  return relativeOf(path, cwd)
+}
+
 /**
  * 解释单条持久化页签：字符串 = 路径（旧版），对象取 path/pinned。
  * @author ddj 2026年09月11号

package/src/client/ui/AiSettings.ts

@@ -9,6 +9,7 @@
 import React from 'react'
 import { rpc } from '../rpc.js'
 import { setAiInlineEnabled } from '../ai/inlineProvider.js'
+import { isDelistedModel } from '../../shared/ai.js'
 
 /**
  * AI 补全设置卡片（设置页「AI 补全」Tab 主体）。
@@ -79,9 +80,16 @@ export function AiSettings() {
   if (!cfg) return React.createElement('div', { className: 'vsm-mcp-empty' }, error || '正在读取 AI 补全配置…')
 
   const modelValue = cfg.provider && cfg.model ? cfg.provider + '/' + cfg.model : ''
+  // G7：配置指向已从官方默认列表下架的模型（DSH 0.1.6-alpha.2 移除 V4 Flash 系列）。
+  // 仅提示，不擅自改写用户已保存的配置（避免覆盖其意图）；清空即回到自动路由。
+  const delisted = isDelistedModel(cfg.model)
   return React.createElement('section', { className: 'vsm-lsp-card' },
     React.createElement('h3', null, 'AI 自动补全（实验）'),
     React.createElement('p', { className: 'vsm-lsp-note' }, '编辑停顿后由模型生成内联建议（ghost text），Tab 接受，Alt+\\ 手动触发。每次补全是一次模型调用；建议选择非推理模型，且思考强度选「跟随默认」或最低档以获得更快响应。'),
+    (delisted
+      ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' },
+          '当前模型「' + cfg.model + '」已从 DSH 默认模型列表移除（0.1.6-alpha.2 起）。该模型可能不再可用；将「模型」改回「自动」即可使用第一个可用模型（现有配置不会被自动改动）。')
+      : null),
     React.createElement('div', { className: 'vsm-lsp-row' },
       React.createElement('button', { className: cfg.enabled ? 'vsm-primary' : '', disabled: busy, onClick: toggle },
         cfg.enabled ? '已开启（点击关闭）' : '已关闭（点击开启）'),

package/src/client/ui/EditorView.ts

@@ -56,7 +56,7 @@ import { SnippetsPicker } from './SnippetsPicker.js'
 import { invalidateSnippets, setSnippetsSession, setupSnippets } from '../snippets/provider.js'
 import {
   absoluteOf, ancestorDirsOf, applyClose, baseNameOf, closeAll, closeOthers, closeRight, closeSaved,
-  insertTab, isTreeRevealable, normalizeTabs, pickActive, relativeOf, togglePin,
+  insertTab, isTreeRevealable, normalizeTabs, pickActive, relativeOf, tabPathOf, togglePin,
 } from '../tabActions.js'
 import { buildTabMenu } from '../tabMenu.js'
 import { ensureSvnChanges, ensureSvnStatus, getSvnChanges, getSvnStatus, refreshSvnChanges, svnAdd, svnChangeMapOf, svnDiffBase, svnEditorActions, svnRevert, svnTortoise, svnUpdate } from '../svnStatus.js'
@@ -307,6 +307,33 @@ export function EditorView(props) {
     if (select) setActive(path)
   }
 
+  /**
+   * 页签规范路径（G9）：统一收敛为工作区相对路径后再进页签。
+   *
+   * 差异记录路径取自工具结果 `target.displayPath`（官方恒绝对），而资源管理器树给相对路径；
+   * 不归一会导致地址栏形态不一致、同文件出现两个页签（insertTab 按原串去重）、
+   * 且绝对路径被 isTreeRevealable 判为不可定位（「在资源管理器视图中显示」失效）。
+   * 工作区外文件由 relativeOf 回退原绝对路径，语义不变。
+   * @author ddj 2026年09月18号
+   * @param path 原始路径（绝对或相对）
+   * @returns 页签规范路径
+   */
+  const tabPath = (path) => tabPathOf(path, cwd)
+  /**
+   * 打开文件入口的统一收敛（G9）：所有「进页签」路径都经此归一，避免逐点打补丁。
+   * @author ddj 2026年09月18号
+   * @param path 原始路径
+   * @param select 是否设为活动页签
+   * @returns 归一后的路径（空值返回 null）
+   */
+  const addTabNorm = (path, select) => {
+    if (!path) return null
+    const normalized = tabPath(path)
+    if (!normalized) return null
+    addTab(normalized, select)
+    return normalized
+  }
+
   /**
    * 保存当前活动文件的视图状态（光标/滚动/折叠）到工作区作用域缓存。
    * @author ddj 2026年08月28号
@@ -388,7 +415,7 @@ export function EditorView(props) {
     flushSave()
     saveViewState(active)
     navPendingRef.current = entry
-    addTab(entry.path, true)
+    addTabNorm(entry.path, true)
     setFocusRequest((value) => value + 1) // 目标已是活动文件时也触发恢复
   }
 
@@ -832,20 +859,23 @@ export function EditorView(props) {
     const onOpen = (e) => {
       const p = e?.detail?.path
       if (!p) return
+      // G9：入口统一归一为工作区相对路径（差异栏/对话链接/LSP 跳转等都经此事件）
+      const normalized = tabPath(p)
+      if (!normalized) return
       if (e?.detail?.focusDiff === true) {
         recordNav()
-        pendingFocusRef.current = { path: p, region: null }
+        pendingFocusRef.current = { path: normalized, region: null }
         setFocusRequest((value) => value + 1)
-        addTab(p, true)
+        addTab(normalized, true)
         return
       }
       if (e?.detail?.line != null) {
         // LSP/搜索跳转：打开并定位到行列（endLine/endColumn 为目标区间，供落地高亮）
-        openFileAt(p, e?.detail?.line, e?.detail?.column, e?.detail?.endLine, e?.detail?.endColumn)
+        openFileAt(normalized, e?.detail?.line, e?.detail?.column, e?.detail?.endLine, e?.detail?.endColumn)
         return
       }
       recordNav()
-      addTab(p, true)
+      addTab(normalized, true)
     }
     const onShowLauncher = (event) => {
       const tab = event?.detail?.tab
@@ -939,10 +969,13 @@ export function EditorView(props) {
         ?? localStorage.getItem(CACHE_KEY.editorLegacy + String(scope))
       if (raw) {
         const saved = JSON.parse(raw)
-        const restored = normalizeTabs(saved?.tabs)
+        // G9：迁移历史持久化里的绝对路径页签（旧版差异入口写入），并顺带按新形态去重
+        const restored = normalizeTabs(saved?.tabs, cwd)
         if (restored.length) {
           setTabs(restored)
-          setActive(pickActive(restored, saved?.active))
+          // 活动路径同形态归一，否则恢复后匹配不到任何页签（pickActive 回退首个）
+          const wanted = typeof saved?.active === 'string' ? tabPathOf(saved.active, cwd) : saved?.active
+          setActive(pickActive(restored, wanted))
         }
       }
     } catch (e) { /* 损坏忽略 */ }
@@ -2495,8 +2528,9 @@ export function EditorView(props) {
     // 打开文件即离开基线差异审阅态（差异视图是「当前文件」的临时视图）
     setSvnDiff(null)
     recordNav()
-    addTab(path, true)
-    if (focusDiff) pendingFocusRef.current = { path, region: null }
+    // G9：统一归一为页签规范形态（差异栏/启动器/树/命令栏等入口一致）
+    const normalized = addTabNorm(path, true)
+    if (focusDiff && normalized) pendingFocusRef.current = { path: normalized, region: null }
   }
 
   /**
@@ -2512,8 +2546,10 @@ export function EditorView(props) {
   const openFileAt = (path, line, column, endLine, endColumn) => {
     if (!path) return
     recordNav()
-    addTab(path, true)
-    pendingFocusRef.current = { path, region: null, line: line ?? null, column: column ?? 1, endLine: endLine ?? null, endColumn: endColumn ?? null }
+    // G9：同 openFile，先归一再进页签，保证待跳转路径与 active 同形态
+    const normalized = addTabNorm(path, true)
+    if (!normalized) return
+    pendingFocusRef.current = { path: normalized, region: null, line: line ?? null, column: column ?? 1, endLine: endLine ?? null, endColumn: endColumn ?? null }
     setFocusRequest((value) => value + 1)
   }
 
@@ -2683,7 +2719,9 @@ export function EditorView(props) {
       }, '保留本地')))
   }
 
-  const otherFiles = sum.pendingFiles.filter((f) => f.path !== active)
+  // G9：记录路径为绝对、active 为页签规范形态（相对），必须经 sameFile 归一比较，
+  // 否则当前活动文件会被误列入「其他差异文件」。
+  const otherFiles = sum.pendingFiles.filter((f) => !sameFile(f.path, active))
 
   /**
    * 渲染编辑器/文件加载进度面板。

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 断言，不得前插。
@@ -133,7 +133,7 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
 }
 
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = '0.1.6-alpha.1'
+const TESTED_DSH_MAX = '0.1.6-alpha.2'
 
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {

package/src/dshVersion.ts

@@ -82,10 +82,17 @@ export function inDshRange(version: DshVersion | null | undefined, range: DshRan
   return true
 }
 
-/** 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。 */
+/**
+ * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
+ * 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
+ * @author ddj 2026年09月02号 / 2026年09月18号
+ * @param input 版本串（如 '0.1.6-alpha.2'）
+ * @returns 版本线标签
+ */
 export function familyLabel(input: string): string {
   const version = parseDshVersion(input)
   if (!version) return '未知'
+  if (inDshRange(version, { from: '0.1.6-alpha.2' })) return '0.1.6-alpha.2 及更新（会话多实例共存 + 回合改动卡片 + Office 侧栏预览 + 侧栏浏览器）'
   if (inDshRange(version, { from: '0.1.6-alpha.1' })) return '0.1.6-alpha 及更新（MCP SDK v2 + Web 侧边栏终端 + 文件链接默认侧栏预览）'
   if (inDshRange(version, { from: '0.1.5-alpha.1' })) return '0.1.5-alpha 及更新（官方右侧 Sidebar 编辑区 + sidebar.panellist）'
   if (inDshRange(version, { from: '0.1.3-alpha.1' })) return '0.1.3-alpha 及更新（对话文件链接=remote.session.openWorkspacePath）'

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