dsh-vscode-mode 0.1.42 → 0.1.44

package/src/fileOpenSettings.ts

@@ -1,8 +1,11 @@
 /**
  * dsh-vscode-mode host — 文件链接打开工具 + 快捷键的持久化设置。
- * 依赖守卫：@deepseek-ai/dsh-settings / schemastery 以动态加载引入，
- * 缺失时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见）。
- * 作者 ddj 2026年08月24号 / 2026年08月26号
+ * 依赖守卫：schemastery 动态加载；@deepseek-ai/dsh-settings 仅作 legacy 探测——
+ * rc 线导出 installSettingsSection free function，0.1.2-alpha 起移除（改由 settings
+ * 服务的 installSection 方法承载，见 runSettingsInstall 三策略）。
+ * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
+ * 全程 try/catch，不产生未捕获 rejection。
+ * 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号
  */
 import type { Ctx } from './store.js'
 import { KEYBINDING_DEFAULTS } from './shared/keybindings.js'
@@ -20,7 +23,7 @@ type SettingsProvider = {
 
 /** 动态依赖的装载结果（宽松类型：dsh-settings 无本地类型声明）。 */
 export interface SettingsDeps {
-  installSettingsSection: (ctx: Ctx, ns: string, schema: unknown, entry: object, hooks: object) => void
+  installSettingsSection?: (ctx: Ctx, ns: string, schema: unknown, entry: object, hooks: object) => void
   z: {
     object: (shape: Record<string, unknown>) => { default: (value: Record<string, unknown>) => unknown }
     string: () => { default: (value: string) => unknown }
@@ -33,19 +36,9 @@ export type SettingsDepsLoader = () => Promise<SettingsDeps | null>
 let depsPromise: Promise<SettingsDeps | null> | undefined
 
 /**
- * 按命令目录构建 keybindings 显式键形状（每键独立默认值）。
- * @author ddj 2026年08月26号
- * @param z schemastery 命名空间
- * @returns keybindings 字段形状
- */
-function keybindingsShape(z: SettingsDeps['z']): Record<string, unknown> {
-  const shape: Record<string, unknown> = {}
-  for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord)
-  return shape
-}
-
-/**
- * 动态加载设置依赖（模块级缓存；任一缺失返回 null 而非抛错）。
+ * 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
+ * installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
+ * 属性探测得到 undefined，不抛错）。
  * @author ddj 2026年08月24号
  * @returns 设置依赖或 null
  */
@@ -53,14 +46,132 @@ export function loadSettingsDeps(): Promise<SettingsDeps | null> {
   if (!depsPromise) {
     depsPromise = Promise.all([import('@deepseek-ai/dsh-settings'), import('schemastery')])
       .then(([dshSettings, schemastery]) => ({
-        installSettingsSection: (dshSettings as { installSettingsSection: SettingsDeps['installSettingsSection'] }).installSettingsSection,
-        z: (schemastery as { default: SettingsDeps['z'] }).default,
+        // 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,
       }))
       .catch(() => null)
   }
   return depsPromise
 }
 
+/** 设置 section 安装策略（版本适配机制的观测值）。 */
+export type SettingsInstallStrategy = 'legacy' | 'service' | 'none' | 'unknown'
+
+const INSTALL_UNMOUNTED = '设置 section 尚未装配'
+const INSTALL_LEGACY = 'rc 线：dsh-settings.installSettingsSection'
+const INSTALL_SERVICE = '0.1.2-alpha 线：settings 服务 installSection'
+const INSTALL_NONE = '两路均不可用：设置持久化降级为配置值'
+
+interface ObservedInstall { strategy: SettingsInstallStrategy; note: string }
+let observedInstall: ObservedInstall = { strategy: 'unknown', note: INSTALL_UNMOUNTED }
+
+/** 记录最近一次安装策略（供兼容报告展示；失败路径也记录，便于诊断）。 */
+function recordInstall(strategy: SettingsInstallStrategy, note: string): SettingsInstallStrategy {
+  observedInstall = { strategy, note }
+  return strategy
+}
+
+/** 读取观测到的安装策略（供报告；测试可用 reset 复位）。 */
+export function settingsInstallStrategy(): SettingsInstallStrategy {
+  return observedInstall.strategy
+}
+
+/** 读取观测到的安装策略说明文案。 */
+export function settingsInstallNote(): string {
+  return observedInstall.note
+}
+
+/** 复位安装策略观测（测试隔离用）。 */
+export function resetSettingsInstallObserved(): void {
+  observedInstall = { strategy: 'unknown', note: INSTALL_UNMOUNTED }
+}
+
+/**
+ * 设置 section 版本自适应安装（核心策略分派）。
+ * legacy：dsh-settings 仍导出 installSettingsSection（rc 线）→ 原样调用，行为与旧版一致。
+ * service：该导出已移除（0.1.2-alpha 起）→ 经 ctx.inject(['settings']) 走服务方法
+ *          provider.installSection(owner, ns, schema, entry, hooks)（等义封装，含
+ *          base 层与 fiber 卸载回退）。回调内方法缺失再降级记录 none。
+ * none：两条路由都不存在 → 仅记录并告警，调用方按配置值运行。
+ * 全程不抛错、不产生未捕获 rejection。
+ * @author ddj 2026年09月02号
+ * @param ctx DSH host 上下文（inject 可选探测）
+ * @param ns 设置命名空间
+ * @param schema schemastery schema
+ * @param entry 初始设置值（作为 base 层）
+ * @param hooks 设置源绑定与变更回调
+ * @param loader 依赖装载器（测试注入）
+ * @returns 采用/观测到的策略
+ */
+export async function runSettingsInstall(
+  ctx: Ctx,
+  ns: string,
+  schema: unknown,
+  entry: object,
+  hooks: { setSource: (source: () => unknown) => void; onChange: () => void; validate?: unknown },
+  loader: SettingsDepsLoader = loadSettingsDeps,
+): Promise<SettingsInstallStrategy> {
+  let deps: SettingsDeps | null = null
+  try {
+    deps = await loader()
+  } catch {
+    /* 装载失败按缺失处理 */
+  }
+  if (!deps) {
+    console.warn('[dsh-vscode-mode] 设置依赖不可用，section ' + ns + ' 未安装（配置回退）')
+    return recordInstall('none', INSTALL_NONE)
+  }
+  const legacy = deps.installSettingsSection
+  if (typeof legacy === 'function') {
+    try {
+      legacy(ctx, ns, schema, entry, hooks)
+      return recordInstall('legacy', INSTALL_LEGACY)
+    } catch (error) {
+      console.warn('[dsh-vscode-mode] legacy 设置安装失败，尝试服务路由：' + String(error))
+    }
+  }
+  const ctxInject = (ctx as unknown as { inject?: (services: string[], callback: (sctx: unknown) => void) => unknown }).inject
+  if (typeof ctxInject !== 'function') return recordInstall('none', INSTALL_NONE)
+  try {
+    ctxInject(['settings'], (sctx: unknown) => {
+      const sc = sctx as { get?: (name: string) => unknown; settings?: unknown }
+      const provider = typeof sc.get === 'function' ? sc.get('settings') : sc.settings
+      const install = (provider as { installSection?: unknown } | undefined)?.installSection
+      if (typeof install !== 'function') {
+        console.warn('[dsh-vscode-mode] settings 服务无 installSection（DSH 版本 API 变化），section ' + ns + ' 降级为配置值')
+        recordInstall('none', INSTALL_NONE)
+        return
+      }
+      try {
+        install.call(provider, ctx, ns, schema, entry, hooks)
+        recordInstall('service', INSTALL_SERVICE)
+      } catch (error) {
+        console.warn('[dsh-vscode-mode] settings.installSection 安装失败（' + String(error) + '），section ' + ns + ' 降级为配置值')
+        recordInstall('none', INSTALL_NONE)
+      }
+    })
+  } catch (error) {
+    console.warn('[dsh-vscode-mode] settings 服务路由不可用（' + String(error) + '）')
+    return recordInstall('none', INSTALL_NONE)
+  }
+  // inject 回调若同步执行（settings 已就绪）会覆写观测值；仍未执行（unknown）时乐观按 service 记录
+  if (observedInstall.strategy !== 'unknown') return observedInstall.strategy
+  return recordInstall('service', '已调度 settings 服务 installSection（等待 settings 就绪）')
+}
+
+/**
+ * 按命令目录构建 keybindings 显式键形状（每键独立默认值）。
+ * @author ddj 2026年08月26号
+ * @param z schemastery 命名空间
+ * @returns keybindings 字段形状
+ */
+function keybindingsShape(z: SettingsDeps['z']): Record<string, unknown> {
+  const shape: Record<string, unknown> = {}
+  for (const [id, chord] of Object.entries(KEYBINDING_DEFAULTS)) shape[id] = z.string().default(chord)
+  return shape
+}
+
 function normalizeValue(value: unknown): string {
   if (typeof value !== 'string' || value.trim() === '') return FILE_OPEN_DEFAULT
   return value.trim()
@@ -71,8 +182,8 @@ function configValue(config: unknown): string {
 }
 
 /**
- * 安装设置 section（动态依赖；缺失返回 false 不抛错）。
- * @author ddj 2026年08月24号
+ * 安装设置 section（版本自适应；任一策略不可用返回 false 不抛错）。
+ * @author ddj 2026年08月24号 / 2026年09月02号
  * @param ctx DSH host 上下文
  * @param ns 设置命名空间
  * @param entry 初始设置值
@@ -87,14 +198,22 @@ export async function installOpenSettingsSection(
   hooks: { setSource: (source: () => FileOpenSettings) => void; onChange: () => void },
   loader: SettingsDepsLoader = loadSettingsDeps,
 ): Promise<boolean> {
-  const deps = await loader()
+  let deps: SettingsDeps | null = null
+  try {
+    deps = await loader()
+  } catch {
+    /* 装载失败按缺失处理 */
+  }
   if (!deps) return false
   const schema = deps.z.object({
     fileOpenTool: deps.z.string().default(FILE_OPEN_DEFAULT),
     keybindings: deps.z.object(keybindingsShape(deps.z)).default({ ...KEYBINDING_DEFAULTS }),
   })
-  deps.installSettingsSection(ctx, ns, schema, entry, hooks)
-  return true
+  const strategy = await runSettingsInstall(ctx, ns, schema, entry, {
+    setSource: (source) => hooks.setSource(source as () => FileOpenSettings),
+    onChange: hooks.onChange,
+  }, loader)
+  return strategy === 'legacy' || strategy === 'service'
 }
 
 /**

package/src/host-deps.d.ts

@@ -3,12 +3,12 @@ declare module 'schemastery' {
   export default schema
 }
 
-declare module '@deepseek-ai/dsh-settings' {
-  export function installSettingsSection(...args: any[]): void
-  export function settingsNamespace(value: string): string
-}
-
 declare module '@deepseek-ai/schemastery' {
   const schema: any
   export default schema
 }
+
+// @deepseek-ai/dsh-settings 不在此声明：rc 线导出 installSettingsSection /
+// settingsNamespace，0.1.2-alpha 起移除（改由 settings 服务 installSection 方法承载）。
+// fileOpenSettings.ts 以动态导入 + 属性探测方式访问，见 SettingsDeps.installSettingsSection。
+

package/src/index.ts

@@ -92,7 +92,8 @@ async function logCompatSummary(ctx: Ctx, warnings: string[]): Promise<void> {
     for (const warning of warnings) report.warnings.push(warning)
     const logger = ctx.logger
     if (!logger?.info) return
-    const head = '[' + PLUGIN_NAME + '] 兼容性：' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏'
+    const dsh = report.dshVersion ? 'DSH ' + report.dshVersion : 'DSH 未探测'
+    const head = '[' + PLUGIN_NAME + '] 兼容性：' + dsh + ' · ' + report.external.length + ' 项外部适配 / ' + report.guards.length + ' 项护栏 / ' + (report.adapters?.length ?? 0) + ' 项版本适配'
     if (report.warnings.length) {
       logger.warn?.(head + '，警告 ' + report.warnings.length + ' 条：' + report.warnings.join('；'))
     } else {

package/src/lsp/settings.ts

@@ -1,11 +1,12 @@
 /**
- * dsh-vscode-mode host — LSP 配置设置 section 安装（动态依赖，缺失不抛错）。
+ * dsh-vscode-mode host — LSP 配置设置 section 安装（版本自适应；缺失/失败不抛错）。
  * ns：dsh-vscode-mode.languageServers；每语言 { enabled, command, path }。
- * 作者 ddj 2026-08-27
+ * 安装策略分派见 fileOpenSettings.runSettingsInstall（rc 线 legacy / alpha 线服务方法）。
+ * 作者 ddj 2026-08-27 / 2026-09-02
  */
 import type { Ctx } from '../store.js'
 import { LSP_LANGUAGES, LSP_SETTINGS_NS, type LspConfig } from './config.js'
-import { loadSettingsDeps, type SettingsDeps } from '../fileOpenSettings.js'
+import { loadSettingsDeps, runSettingsInstall, type SettingsDeps } from '../fileOpenSettings.js'
 
 /**
  * 安装 LSP 设置 section。
@@ -15,7 +16,12 @@ import { loadSettingsDeps, type SettingsDeps } from '../fileOpenSettings.js'
  * @returns 是否成功安装
  */
 export async function installLspSettingsSection(ctx: Ctx, entry: LspConfig): Promise<boolean> {
-  const deps = await loadSettingsDeps()
+  let deps: SettingsDeps | null = null
+  try {
+    deps = await loadSettingsDeps()
+  } catch {
+    /* 装载失败按缺失处理 */
+  }
   if (!deps) return false
   try {
     // schemastery 无 .optional()，对象字段默认即可选；.default 必给避免 undefined 覆盖
@@ -29,11 +35,11 @@ export async function installLspSettingsSection(ctx: Ctx, entry: LspConfig): Pro
       }).default({})
     }
     const schema = z.object(langShape).default({})
-    deps.installSettingsSection(ctx, LSP_SETTINGS_NS, schema, entry, {
+    const strategy = await runSettingsInstall(ctx, LSP_SETTINGS_NS, schema, entry, {
       setSource: () => {},
       onChange: () => {},
     })
-    return true
+    return strategy === 'legacy' || strategy === 'service'
   } catch (error) {
     // 设置 section 安装失败不致命：降级为无设置 UI，LSP 核心功能不受影响
     console.error('[dsh-vscode-mode] LSP 设置 section 安装失败：' + String(error))

package/src/shared/compat.ts

@@ -1,10 +1,10 @@
 /**
  * dsh-vscode-mode 兼容层双面契约 — 与其他插件 / DSH 版本的探测与自诊断报告。
  * Purity rule: no node/react imports (same as types.ts / rpc.ts)。
- * 作者 ddj 2026-08-24
+ * 作者 ddj 2026-08-24 / 2026-09-02
  */
 
-/** 单项适配状态：外部插件/服务或护栏项，active 表示健康/生效。 */
+/** 单项适配状态：外部插件/服务、护栏或版本适配项，active 表示健康/生效。 */
 export interface CompatAdapter {
   name: string
   active: boolean
@@ -17,11 +17,17 @@ export interface DevFormInfo {
   path?: string
 }
 
-/** 兼容性报告：host 侧构建（RPC edrv.compat 返回），client 侧补充本地适配项后展示。 */
+/**
+ * 兼容性报告：host 侧构建（RPC edrv.compat 返回），client 侧补充本地适配项后展示。
+ * dshVersion = 运行中 DSH 核心版本（未探测到为空串）；adapters = 版本适配机制状态行
+ * （旧客户端忽略未知字段，安全前向兼容）。
+ */
 export interface CompatReport {
   pluginVersion: string
   external: CompatAdapter[]
   guards: CompatAdapter[]
   warnings: string[]
   devForm?: DevFormInfo
+  dshVersion?: string
+  adapters?: CompatAdapter[]
 }