dsh-vscode-mode 0.7.0 → 0.9.0

package/src/fileOpenSettings.ts

@@ -2,10 +2,11 @@
  * dsh-vscode-mode host — 文件链接打开工具 + 快捷键的持久化设置。
  * 依赖守卫：schemastery 动态加载；@deepseek-ai/dsh-settings 仅作 legacy 探测——
  * rc 线导出 installSettingsSection free function，0.1.2-alpha 起移除（改由 settings
- * 服务的 installSection 方法承载，见 runSettingsInstall 三策略）。
+ * 服务的 installSection 方法承载），0.1.7 再移除 installSection（设置并入 profile
+ * 插件 Config schema，见 runSettingsInstall 四策略：legacy/service/forms/none）。
  * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
  * 全程 try/catch，不产生未捕获 rejection。
- * 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号
+ * 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号 / 2026年09月22号 / 2026年09月23号
  */
 import { createRequire } from 'node:module'
 import { pathToFileURL } from 'node:url'
@@ -15,6 +16,7 @@ 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'
+import { DEFAULT_NATIVE_CSV } from './shared/nativeOpen.js'
 import { log } from './log.js'
 
 export const FILE_OPEN_SETTINGS_NS = 'dsh-vscode-mode'
@@ -22,12 +24,15 @@ export const FILE_OPEN_DEFAULT = 'auto'
 export interface FileOpenSettings { fileOpenTool: string; integrationBaseUrl: string; svnPath: string; tortoisePath: string }
 export interface FileOpenSettingsState { value: string; revision?: number; update: (value: string, expectedRevision?: number) => Promise<void> }
 
-/** AI 内联补全配置默认值（默认关闭；路由空 = 自动；档位空 = 跟随模型默认）。 */
-export const AI_CONFIG_DEFAULT: { enabled: boolean; provider: string; model: string; effort: string } = {
+/** AI 配置默认值（补全默认关；路由空 = 自动；档位空 = 跟随模型默认；任务模型空 = 跟随补全配置）。 */
+export const AI_CONFIG_DEFAULT: { enabled: boolean; provider: string; model: string; effort: string; taskProvider: string; taskModel: string; taskEffort: string } = {
   enabled: false,
   provider: '',
   model: '',
   effort: '',
+  taskProvider: '',
+  taskModel: '',
+  taskEffort: '',
 }
 
 type SettingsProvider = {
@@ -170,11 +175,12 @@ export function loadSettingsDeps(importFn: (specifier: string) => Promise<unknow
 }
 
 /** 设置 section 安装策略（版本适配机制的观测值）。 */
-export type SettingsInstallStrategy = 'legacy' | 'service' | 'none' | 'unknown'
+export type SettingsInstallStrategy = 'legacy' | 'service' | 'forms' | 'none' | 'unknown'
 
 const INSTALL_UNMOUNTED = '设置 section 尚未装配'
 const INSTALL_LEGACY = 'rc 线：dsh-settings.installSettingsSection'
 const INSTALL_SERVICE = '0.1.2-alpha 线：settings 服务 installSection'
+const INSTALL_FORMS = '0.1.7 线：设置并入插件 Config schema（SettingsForms）'
 const INSTALL_NONE = '两路均不可用：设置持久化降级为配置值'
 
 interface ObservedInstall { strategy: SettingsInstallStrategy; note: string }
@@ -201,15 +207,54 @@ export function resetSettingsInstallObserved(): void {
   observedInstall = { strategy: 'unknown', note: INSTALL_UNMOUNTED }
 }
 
+/**
+ * 判定设置写冲突错误（0.1.7 SettingsConflictError：code 常量 / 构造器名双通道）。
+ * @author ddj 2026年09月22号
+ * @param error 捕获到的错误
+ * @returns 是否为 revision 冲突
+ */
+function isConflictError(error: unknown): boolean {
+  if (!error || typeof error !== 'object') return false
+  const e = error as { code?: unknown; name?: unknown }
+  return e.code === 'SETTINGS_CONFLICT' || e.name === 'SettingsConflictError'
+}
+
+/**
+ * 0.1.7 forms 策略：订阅 settings/document-updated 事件，目标 namespace 变化时
+ * 把 describe 最新值推给 hooks（setSource + onChange），替代旧 installSection 的
+ * 变更回调；disposer 经 ctx.effect 随插件 fiber 卸载（热重载不泄漏）。
+ * @author ddj 2026年09月22号
+ * @param ctx DSH host 上下文
+ * @param provider settings 服务（SettingsForms）
+ * @param ns 目标设置命名空间
+ * @param hooks 设置源绑定与变更回调
+ */
+function watchDocUpdates(ctx: Ctx, provider: SettingsProvider, ns: string, hooks: { setSource: (source: () => unknown) => void; onChange: () => void }): void {
+  try {
+    const bus = ctx as { on?: (name: string, handler: (updatedNs: unknown, revision: unknown) => void) => unknown; effect?: (fn: () => unknown) => unknown }
+    if (typeof bus.on !== 'function') return
+    const off = bus.on('settings/document-updated', (updatedNs: unknown) => {
+      if (updatedNs !== ns) return
+      hooks.setSource(() => readSectionValue(provider, ns))
+      hooks.onChange()
+    })
+    if (typeof bus.effect === 'function' && typeof off === 'function') bus.effect(() => off)
+  } catch (error) {
+    log.warn('settings/document-updated 订阅失败：' + String(error))
+  }
+}
+
 /**
  * 设置 section 版本自适应安装（核心策略分派）。
  * legacy：dsh-settings 仍导出 installSettingsSection（rc 线）→ 原样调用，行为与旧版一致。
  * service：该导出已移除（0.1.2-alpha 起）→ 经 ctx.inject(['settings']) 走服务方法
  *          provider.installSection(owner, ns, schema, entry, hooks)（等义封装，含
- *          base 层与 fiber 卸载回退）。回调内方法缺失再降级记录 none。
+ *          base 层与 fiber 卸载回退）。
+ * forms：0.1.7 起 installSection 移除，设置并入 profile 插件 Config（SettingsForms
+ *          的 describe+update 在场即成立）→ 不装 section，改订阅 document-updated。
  * none：两条路由都不存在 → 仅记录并告警，调用方按配置值运行。
  * 全程不抛错、不产生未捕获 rejection。
- * @author ddj 2026年09月02号
+ * @author ddj 2026年09月02号（2026年09月22号 增补 forms 策略）
  * @param ctx DSH host 上下文（inject 可选探测）
  * @param ns 设置命名空间
  * @param schema schemastery schema
@@ -253,6 +298,13 @@ export async function runSettingsInstall(
       const provider = typeof sc.get === 'function' ? sc.get('settings') : sc.settings
       const install = (provider as { installSection?: unknown } | undefined)?.installSection
       if (typeof install !== 'function') {
+        // 0.1.7：installSection 已移除；SettingsForms（describe+update）在场走 forms 策略
+        const forms = provider as SettingsProvider | undefined
+        if (typeof forms?.describe === 'function' && typeof forms?.update === 'function') {
+          recordInstall('forms', INSTALL_FORMS)
+          watchDocUpdates(ctx, forms, ns, hooks)
+          return
+        }
         log.warn('settings 服务无 installSection（DSH 版本 API 变化），section ' + ns + ' 降级为配置值')
         recordInstall('none', INSTALL_NONE)
         return
@@ -286,30 +338,214 @@ function keybindingsShape(z: SettingsDeps['z']): Record<string, unknown> {
   return shape
 }
 
+/**
+ * 设置节 describe 项的形状校验：value 须为普通对象。
+ * ns 在两代语义不同（旧=自装 section 名，0.1.7=profile entry id），同名撞车时
+ * 以形状兜底防误命中非设置数据；0.1.7 下本插件 entry 的 Config 值与旧 section
+ * 值同为设置键对象，两形状天然兼容。
+ * @author ddj 2026年09月22号
+ * @param value describe 项的 value 字段
+ * @returns 是否具备设置节形状
+ */
+function isSectionShaped(value: unknown): boolean {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+/** describe 项最小形状（读写工具共用）。 */
+export interface SectionDescriptor { ns?: string; value?: unknown; revision?: number }
+
+/**
+ * 按 ns + 形状校验查找设置节（host 读路径统一入口）。
+ * @author ddj 2026年09月22号
+ * @param provider settings 服务（可空）
+ * @param ns 设置命名空间
+ * @returns 命中的 describe 项；未命中返回 undefined
+ */
+export function sectionOf(provider: SettingsProvider | undefined, ns: string): SectionDescriptor | undefined {
+  const items = provider?.describe?.({ redactSecrets: true })
+  if (!items) return undefined
+  return items.find((item) => item.ns === ns && isSectionShaped(item.value))
+}
+
+/** 读设置节存储值（未就绪/形状不符返回 undefined）。 */
+function readSectionValue(provider: SettingsProvider | undefined, ns: string): unknown {
+  return sectionOf(provider, ns)?.value
+}
+
+/** 设置写入结果（ok=false 时带原因；conflict=true 表示经冲突重试后成功）。 */
+export interface SectionWriteResult { ok: boolean; conflict?: boolean; error?: string }
+
+/**
+ * 带冲突自愈的设置写入：0.1.7 SettingsConflictError（revision 拒写）时重读
+ * revision 重试一次；其余错误与服务缺失一律结构化返回，绝不抛未捕获异常。
+ * @author ddj 2026年09月22号
+ * @param provider settings 服务（可空）
+ * @param ns 设置命名空间
+ * @param patch 写入字段
+ * @param expectedRevision 读侧携带的 revision（缺省用 describe 最新值）
+ * @returns 写入结果
+ */
+export async function updateSection(provider: SettingsProvider | undefined, ns: string, patch: object, expectedRevision?: number): Promise<SectionWriteResult> {
+  if (!provider?.update) return { ok: false, error: 'settings 服务无 update' }
+  const first = expectedRevision ?? sectionOf(provider, ns)?.revision
+  try {
+    await provider.update(ns, patch, first)
+    return { ok: true }
+  } catch (error) {
+    if (!isConflictError(error)) return { ok: false, error: String(error) }
+  }
+  const fresh = sectionOf(provider, ns)?.revision
+  try {
+    await provider.update(ns, patch, fresh)
+    return { ok: true, conflict: true }
+  } catch (error) {
+    return { ok: false, conflict: true, error: String(error) }
+  }
+}
+
+/**
+ * 构建设置 section schema（install 路径与插件 Config 声明共用，保证两代形状同源）。
+ * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
+ * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
+ * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
+ * options.volatile：DSH 0.1.7 线的 Config 导出专用——SettingsForms.describe 只下发
+ * 含 volatile 字段的 entry（volatileForm 门槛），不标记则 ns 永不出现在 describe、
+ * client configForms 恒 unavailable；且字段须位于固定 object 路径（keybindings 整个
+ * object 标记、子键不标）。section 安装路径（legacy/service）**不标**：rc/0.1.6 的
+ * register→resolve 无该门槛，标了反而让 scope.get() 返回引用污染读取。
+ * 标记经 markVolatile 能力守卫：z 无 .volatile()（旧 schemastery）或调用抛错时保持
+ * 原字段并记录观测态，模块加载绝不抛错（降级=维持现状，兼容性报告可见）。
+ * @author ddj 2026年09月22号（2026年09月23号 增补 options.volatile 与观测）
+ * @param z schemastery 命名空间（静态 import 或动态加载均可）
+ * @param options volatile：是否按 0.1.7 Config 语义标记字段
+ * @returns schemastery object schema
+ */
+export function buildSettingsSchema(z: SettingsDeps['z'], options?: { volatile?: boolean }): unknown {
+  const wantVolatile = options?.volatile === true
+  let marked = 0
+  const withVol = (field: unknown): unknown => {
+    if (!wantVolatile) return field
+    const result = markVolatile(field)
+    if (result.marked) marked += 1
+    return result.field
+  }
+  const shape: Record<string, unknown> = {
+    fileOpenTool: withVol(z.string().default(FILE_OPEN_DEFAULT)),
+    keybindings: withVol(z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS })),
+    sidebarMinWidth: withVol(z.number().default(300)),
+    // 页签数量上限（0 = 不限制；超限时淘汰最久未使用的页签，固定页签除外）
+    maxOpenEditors: withVol(z.number().default(EDITOR_LIMIT_DEFAULT)),
+    integrationBaseUrl: withVol(z.string().default(INTEGRATION_BASE_DEFAULT)),
+    // AI 内联补全（默认关；provider/model 空 = 自动路由；effort 空 = 跟随模型默认）
+    aiInline: withVol(z.boolean().default(AI_CONFIG_DEFAULT.enabled)),
+    aiProvider: withVol(z.string().default(AI_CONFIG_DEFAULT.provider)),
+    aiModel: withVol(z.string().default(AI_CONFIG_DEFAULT.model)),
+    aiEffort: withVol(z.string().default(AI_CONFIG_DEFAULT.effort)),
+    // AI 任务模型（非补全场景如 AI 智能整理；空 = 跟随补全配置）
+    aiTaskProvider: withVol(z.string().default(AI_CONFIG_DEFAULT.taskProvider)),
+    aiTaskModel: withVol(z.string().default(AI_CONFIG_DEFAULT.taskModel)),
+    aiTaskEffort: withVol(z.string().default(AI_CONFIG_DEFAULT.taskEffort)),
+    // SVN 能力：svn CLI 覆盖（空 = PATH）与 TortoiseSVN 目录（Windows 过渡增强）
+    svnPath: withVol(z.string().default('')),
+    tortoisePath: withVol(z.string().default(TORTOISE_DIR_DEFAULT)),
+    // 原生打开范围（逗号分隔后缀；默认 = 让位清单并集，csv/tsv 决策见 shared/nativeOpen.ts）
+    nativeOpenExts: withVol(z.string().default(DEFAULT_NATIVE_CSV)),
+  }
+  if (wantVolatile) configVolatile = { requested: true, marked, total: Object.keys(shape).length }
+  return z.object(shape)
+}
+
+/** Config volatile 标记观测（构建期记录；兼容报告读取，测试可复位）。 */
+export interface ConfigVolatileState { requested: boolean; marked: number; total: number }
+
+let configVolatile: ConfigVolatileState = { requested: false, marked: 0, total: 0 }
+
+/**
+ * 读取 Config volatile 标记观测（0.1.7 设置页可用性的构建期判据）。
+ * @author ddj 2026年09月23号
+ * @returns 观测态（requested=是否按 Config 语义构建；marked/total=成功标记字段数）
+ */
+export function configVolatileState(): ConfigVolatileState {
+  return configVolatile
+}
+
+/**
+ * 复位 volatile 标记观测（测试隔离用）。
+ * @author ddj 2026年09月23号
+ */
+export function resetConfigVolatileState(): void {
+  configVolatile = { requested: false, marked: 0, total: 0 }
+}
+
+/**
+ * 为已完成 default 链的 schema 字段追加 volatile 标记（能力守卫）。
+ * @author ddj 2026年09月23号
+ * @param field schema 字段（两代 schemastery 兼容面，可能没有 volatile 方法）
+ * @returns 处理后字段与是否成功标记
+ */
+function markVolatile(field: unknown): { field: unknown; marked: boolean } {
+  const target = field as { volatile?: () => unknown } | null | undefined
+  if (!target || typeof target.volatile !== 'function') return { field, marked: false }
+  try {
+    return { field: target.volatile(), marked: true }
+  } catch {
+    return { field, marked: false }
+  }
+}
+
+/** cosmokit volatile 引用写协议符号（Symbol.for 跨拷贝一致，同 cosmokit.isVolatile 判据）。 */
+const VOLATILE_WRITE = Symbol.for('cosmokit.volatile.write')
+
+/**
+ * 解引用 0.1.7 volatile 配置引用（普通值直传）。
+ * cordis resolveConfig 会把 .volatile() 字段解析成稳定引用，直接读会得到引用对象；
+ * 不解引用则配置回退值全部落入默认值分支。
+ * @author ddj 2026年09月23号
+ * @param value 配置字段原始值
+ * @returns 引用的当前快照，或原值
+ */
+export function unref(value: unknown): unknown {
+  if (value !== null && typeof value === 'object' && VOLATILE_WRITE in (value as object)) {
+    return (value as { get: () => unknown }).get()
+  }
+  return value
+}
+
+/**
+ * 读插件组合配置字段并解引用（配置读取唯一入口）。
+ * @author ddj 2026年09月23号
+ * @param config 插件组合配置（apply 收到的 Config 值）
+ * @param key 字段名
+ * @returns 字段值（引用已解包；缺失为 undefined）
+ */
+export function configField(config: unknown, key: string): unknown {
+  return unref((config as Record<string, unknown> | null | undefined)?.[key])
+}
+
 function normalizeValue(value: unknown): string {
   if (typeof value !== 'string' || value.trim() === '') return FILE_OPEN_DEFAULT
   return value.trim()
 }
 
 function configValue(config: unknown): string {
-  return normalizeValue((config as { fileOpenTool?: unknown } | undefined)?.fileOpenTool)
+  return normalizeValue(configField(config, 'fileOpenTool'))
 }
 
 /** 配置/设置里的深链基址（缺省/非法回退默认值）。 */
 function baseValueOf(config: unknown): string {
-  const raw = (config as { integrationBaseUrl?: unknown } | undefined)?.integrationBaseUrl
+  const raw = configField(config, 'integrationBaseUrl')
   return typeof raw === 'string' && raw.trim() ? raw.trim() : INTEGRATION_BASE_DEFAULT
 }
 
 /** 配置/设置里的 svn CLI 覆盖（空 = 从 PATH 解析 'svn'）。 */
 function svnPathValueOf(config: unknown): string {
-  const raw = (config as { svnPath?: unknown } | undefined)?.svnPath
+  const raw = configField(config, 'svnPath')
   return typeof raw === 'string' ? raw.trim() : ''
 }
 
 /** 配置/设置里的 TortoiseSVN 目录（空 = 默认安装目录）。 */
 function tortoiseDirValueOf(config: unknown): string {
-  const raw = (config as { tortoisePath?: unknown } | undefined)?.tortoisePath
+  const raw = configField(config, 'tortoisePath')
   return typeof raw === 'string' && raw.trim() ? raw.trim() : TORTOISE_DIR_DEFAULT
 }
 
@@ -337,37 +573,25 @@ export async function installOpenSettingsSection(
     /* 装载失败按缺失处理 */
   }
   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 }),
-    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),
-    aiProvider: deps.z.string().default(AI_CONFIG_DEFAULT.provider),
-    aiModel: deps.z.string().default(AI_CONFIG_DEFAULT.model),
-    aiEffort: deps.z.string().default(AI_CONFIG_DEFAULT.effort),
-    // SVN 能力：svn CLI 覆盖（空 = PATH）与 TortoiseSVN 目录（Windows 过渡增强）
-    svnPath: deps.z.string().default(''),
-    tortoisePath: deps.z.string().default(TORTOISE_DIR_DEFAULT),
-  })
+  const schema = buildSettingsSchema(deps.z)
   const strategy = await runSettingsInstall(ctx, ns, schema, entry, {
     setSource: (source) => hooks.setSource(source as () => FileOpenSettings),
     onChange: hooks.onChange,
   }, loader)
-  return strategy === 'legacy' || strategy === 'service'
+  return strategy === 'legacy' || strategy === 'service' || strategy === 'forms'
 }
 
 /** AI 配置脏值读取（settings 未就绪时回退默认）。 */
-function aiValueOf(stored: unknown): { enabled: boolean; provider: string; model: string; effort: string } {
+function aiValueOf(stored: unknown): { enabled: boolean; provider: string; model: string; effort: string; taskProvider: string; taskModel: string; taskEffort: string } {
   const raw = (stored ?? {}) as Record<string, unknown>
   return {
     enabled: raw.aiInline === true,
     provider: typeof raw.aiProvider === 'string' ? raw.aiProvider : AI_CONFIG_DEFAULT.provider,
     model: typeof raw.aiModel === 'string' ? raw.aiModel : AI_CONFIG_DEFAULT.model,
     effort: typeof raw.aiEffort === 'string' ? raw.aiEffort : AI_CONFIG_DEFAULT.effort,
+    taskProvider: typeof raw.aiTaskProvider === 'string' ? raw.aiTaskProvider : AI_CONFIG_DEFAULT.taskProvider,
+    taskModel: typeof raw.aiTaskModel === 'string' ? raw.aiTaskModel : AI_CONFIG_DEFAULT.taskModel,
+    taskEffort: typeof raw.aiTaskEffort === 'string' ? raw.aiTaskEffort : AI_CONFIG_DEFAULT.taskEffort,
   }
 }
 
@@ -385,8 +609,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   let provider: SettingsProvider | undefined
   const notify = (value: unknown): void => { current = normalizeValue(value); onChange(current) }
   const syncRevision = (): void => {
-    const descriptor = provider?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
-    revision = descriptor?.revision
+    revision = sectionOf(provider, FILE_OPEN_SETTINGS_NS)?.revision
   }
   const setSource = (source: () => FileOpenSettings): void => notify(source().fileOpenTool)
   const settingsChange = (): void => syncRevision()
@@ -394,8 +617,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   /** AI 配置当前值（settings 未就绪回退默认）。 */
   let aiCurrent: AiConfigView = { ...AI_CONFIG_DEFAULT }
   const aiSync = (): void => {
-    const descriptor = provider?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)
-    const stored = descriptor?.value
+    const stored = readSectionValue(provider, FILE_OPEN_SETTINGS_NS)
     aiCurrent = stored !== undefined ? aiValueOf(stored) : aiCurrent
   }
 
@@ -409,7 +631,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   }
   /** 读取 settings 存储值（describe 未就绪返回 undefined）。 */
   const storedValue = (): unknown => {
-    return provider?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)?.value
+    return readSectionValue(provider, FILE_OPEN_SETTINGS_NS)
   }
 
   void installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, {
@@ -428,8 +650,12 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   })
   ctx.inject?.(['settings'], (settingsCtx: Ctx) => {
     provider = settingsCtx.get('settings')
-    aiSync()
-    svnSync(storedValue())
+    // 初值直读：settings/document-updated 首事件可能先于本订阅建立，只靠事件会漏初值
+    const stored = storedValue()
+    const section = stored as { fileOpenTool?: unknown } | undefined
+    if (section?.fileOpenTool !== undefined) notify(section.fileOpenTool)
+    aiCurrent = stored !== undefined ? aiValueOf(stored) : aiCurrent
+    svnSync(stored)
     syncRevision()
   })
 
@@ -438,31 +664,30 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
     get revision() { return revision },
     update: async (value: string, expectedRevision?: number): Promise<void> => {
       const next = normalizeValue(value)
-      if (!provider?.update) { notify(next); return }
-      await provider.update(FILE_OPEN_SETTINGS_NS, { fileOpenTool: next }, expectedRevision)
-      const descriptor = provider.describe?.({ redactSecrets: true })?.find((item: { ns?: string; value?: unknown }) => item.ns === FILE_OPEN_SETTINGS_NS)
-      const stored = descriptor?.value as { fileOpenTool?: unknown } | undefined
+      const result = await updateSection(provider, FILE_OPEN_SETTINGS_NS, { fileOpenTool: next }, expectedRevision)
+      if (!result.ok) log.warn('fileOpenTool 设置写入失败：' + (result.error ?? '未知原因'))
+      const stored = readSectionValue(provider, FILE_OPEN_SETTINGS_NS) as { fileOpenTool?: unknown } | undefined
       notify(stored?.fileOpenTool ?? next)
       syncRevision()
     },
     ai: () => aiCurrent,
     svn: () => svnCurrent,
     aiUpdate: async (patch: AiConfigPatch, expectedRevision?: number): Promise<AiConfigView> => {
-      if (!provider?.update) {
-        // settings 不可用：内存态生效（重启回落默认），保持与 fileOpenTool 的降级语义一致
-        if (patch.enabled !== undefined) aiCurrent.enabled = patch.enabled
-        if (patch.provider !== undefined) aiCurrent.provider = patch.provider
-        if (patch.model !== undefined) aiCurrent.model = patch.model
-        if (patch.effort !== undefined) aiCurrent.effort = patch.effort
-        return aiCurrent
-      }
       const stored = { ...aiCurrent }
       const body: Record<string, unknown> = {}
       if (patch.enabled !== undefined) { stored.enabled = patch.enabled; body.aiInline = patch.enabled }
       if (patch.provider !== undefined) { stored.provider = patch.provider; body.aiProvider = patch.provider }
       if (patch.model !== undefined) { stored.model = patch.model; body.aiModel = patch.model }
       if (patch.effort !== undefined) { stored.effort = patch.effort; body.aiEffort = patch.effort }
-      await provider.update(FILE_OPEN_SETTINGS_NS, body, expectedRevision)
+      if (patch.taskProvider !== undefined) { stored.taskProvider = patch.taskProvider; body.aiTaskProvider = patch.taskProvider }
+      if (patch.taskModel !== undefined) { stored.taskModel = patch.taskModel; body.aiTaskModel = patch.taskModel }
+      if (patch.taskEffort !== undefined) { stored.taskEffort = patch.taskEffort; body.aiTaskEffort = patch.taskEffort }
+      const result = await updateSection(provider, FILE_OPEN_SETTINGS_NS, body, expectedRevision)
+      if (!result.ok) {
+        // settings 不可用/写入失败：内存态生效（重启回落默认），与 fileOpenTool 降级语义一致
+        aiCurrent = stored
+        return aiCurrent
+      }
       aiSync()
       return aiCurrent
     },

package/src/index.ts

@@ -14,7 +14,9 @@ import { newSearcher } from './search/orchestrator.js'
 import { newContentSearcher } from './search/content.js'
 import { installIsolation } from './mcpIsolation.js'
 import { cwdOf } from './registry.js'
-import { setupOpenSettings } from './fileOpenSettings.js'
+import { setupOpenSettings, buildSettingsSchema } from './fileOpenSettings.js'
+import type { SettingsDeps } from './fileOpenSettings.js'
+import z from '@deepseek-ai/schemastery'
 import { shellMenuLifecycle } from './integrate.js'
 import { disposeIndex } from './treeIndex.js'
 import { sweepTreeCache } from './paths.js'
@@ -36,6 +38,21 @@ import type { Ctx } from './store.js'
 export const name = "dsh-vscode-mode"
 export const inject = ['sessions', 'fs', 'webServer', 'loader', 'tools', 'workspaceRegistry', 'agents']
 
+/**
+ * 插件 Config schema（cordis 从 module 导出读 `plugin.Config` 做启动校验；
+ * DSH 0.1.7 起设置页按此 schema 自动生成表单，设置值 = profile 插件配置）。
+ * 字段集与 installOpenSettingsSection 的 section schema 同源（buildSettingsSchema），
+ * 全字段带默认值——undefined/空配置经 schemastery 校验自动填充（rc/alpha 两代
+ * cordis 均读该导出，实测 4.0.0-rc.8 与 0.1.7 行为一致，校验必过）。
+ * volatile: true —— 0.1.7 的 SettingsForms.describe 只下发含 volatile 字段的 entry
+ * （volatileForm 门槛），漏标则 ns 不出现 → client configForms 恒 unavailable →
+ * 设置页「设置服务暂不可用」；同时 volatile 字段由 Loader 就地提交免重载。
+ * 运行时解析：@deepseek-ai/schemastery 经插件自身 dependencies（link/dev/npm 安装
+ * 三形态一致，钉 ~3.18.4 —— 3.18.1 起才有 .volatile()，低版本经 markVolatile 守卫降级）。
+ * @author ddj 2026年09月22号（2026年09月23号 增补 volatile 标记）
+ */
+export const Config = buildSettingsSchema(z as unknown as SettingsDeps['z'], { volatile: true })
+
 /**
  * 装配插件：挂事件监听、注册路由、安装兼容层。
  * @author ddj 2026年08月20号

package/src/lsp/client.ts

@@ -62,6 +62,9 @@ export function createLspClient(
     workspaceSymbol: false,
     hover: false,
     semanticTokens: false,
+    completion: false,
+    completionResolve: false,
+    signatureHelp: false,
     semanticTokenTypes: [],
     semanticTokenModifiers: [],
   }
@@ -164,6 +167,8 @@ export function createLspClient(
           documentSymbolProvider?: unknown
           workspaceSymbolProvider?: unknown
           hoverProvider?: unknown
+          completionProvider?: { resolveProvider?: unknown; triggerCharacters?: unknown }
+          signatureHelpProvider?: { triggerCharacters?: unknown; retriggerCharacters?: unknown }
           semanticTokensProvider?: {
             legend?: { tokenTypes?: unknown; tokenModifiers?: unknown }
           }
@@ -185,6 +190,22 @@ export function createLspClient(
             references: { dynamicRegistration: false },
             documentSymbol: { dynamicRegistration: false },
             hover: { dynamicRegistration: false },
+            // 补全能力声明：snippetSupport 让服务器回 InsertAsSnippet 片段；
+            // resolveSupport.properties 声明我方支持 completionItem/resolve 惰性补全
+            // （EmmyLua 据此把 documentation 挪到 resolve 阶段，列表载荷显著变小）。
+            completion: {
+              dynamicRegistration: false,
+              contextSupport: true,
+              completionItem: {
+                snippetSupport: true,
+                documentationFormat: ['markdown', 'plaintext'],
+                resolveSupport: { properties: ['documentation', 'detail', 'additionalTextEdits'] },
+              },
+            },
+            signatureHelp: {
+              dynamicRegistration: false,
+              signatureInformation: { documentationFormat: ['markdown', 'plaintext'] },
+            },
             semanticTokens: {
               dynamicRegistration: false,
               requests: { range: false, full: { delta: false } },
@@ -205,6 +226,9 @@ export function createLspClient(
         workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
         hover: Boolean(caps.hoverProvider),
         semanticTokens: Boolean(caps.semanticTokensProvider),
+        completion: Boolean(caps.completionProvider),
+        completionResolve: Boolean(caps.completionProvider?.resolveProvider),
+        signatureHelp: Boolean(caps.signatureHelpProvider),
         semanticTokenTypes: Array.isArray(legend?.tokenTypes)
           ? legend.tokenTypes.filter((item): item is string => typeof item === 'string')
           : [...LSP_SEMANTIC_TOKEN_TYPES],

package/src/lsp/rpc.ts

@@ -436,6 +436,63 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       }
     },
 
+    'edrv.lsp.completion': async (args) => {
+      const lang = langOfPath(args.path)
+      if (!lang) return { ok: true, completions: undefined }
+      const sc = await rootOf(args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      try {
+        const server = serverOf(sc.root, lang)
+        if (!server) return { ok: true, completions: undefined }
+        const completions = await server.completion(
+          wsPath(sc.root, args.path),
+          args.position.line,
+          args.position.character,
+          args.context,
+        )
+        if (!completions) return { ok: true, completions: undefined }
+        const truncated = completions.items.length > 500
+        return {
+          ok: true,
+          completions: truncated ? { ...completions, items: completions.items.slice(0, 500), truncated: true } : completions,
+        }
+      } catch (error) {
+        return { ok: false, error: 'LSP 补全查询失败：' + String(error) }
+      }
+    },
+
+    'edrv.lsp.resolveCompletion': async (args) => {
+      const lang = langOfPath(args.path)
+      if (!lang) return { ok: true, item: undefined }
+      const sc = await rootOf(args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      try {
+        const server = serverOf(sc.root, lang)
+        if (!server) return { ok: true, item: args.item }
+        const item = await server.resolveCompletion(wsPath(sc.root, args.path), args.item)
+        return { ok: true, item: item ?? undefined }
+      } catch (error) {
+        return { ok: false, error: 'LSP 补全解析失败：' + String(error) }
+      }
+    },
+
+    'edrv.lsp.signatureHelp': async (args) => {
+      const lang = langOfPath(args.path)
+      if (!lang) return { ok: true, signatureHelp: undefined }
+      const sc = await rootOf(args.sessionId)
+      if ('err' in sc) return { ok: false, error: sc.err }
+      try {
+        const server = serverOf(sc.root, lang)
+        if (!server) return { ok: true, signatureHelp: undefined }
+        return {
+          ok: true,
+          signatureHelp: (await server.signatureHelp(wsPath(sc.root, args.path), args.position.line, args.position.character)) ?? undefined,
+        }
+      } catch (error) {
+        return { ok: false, error: 'LSP 签名帮助查询失败：' + String(error) }
+      }
+    },
+
     'edrv.lsp.semanticTokens': async (args) => {
       const lang = langOfPath(args.path)
       if (!lang) return { ok: true, tokens: undefined }