dsh-vscode-mode 0.6.0 → 0.8.0

package/src/client/ui/PromptDialog.ts

@@ -0,0 +1,63 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 名称输入弹窗（新建文件/新建文件夹/重命名共用）。
+ * 复用 ModalShell（.vsm-mcp-dialog 视觉 + data-edrv-view 作用域 + Esc/遮罩关闭）；
+ * 确认返回输入文本（首尾空白已去），取消/Esc/遮罩/空输入返回 null。
+ * 重命名时默认选中主名（不含扩展名），与 VS Code 行为一致。
+ * 作者 ddj 2026年09月22号
+ */
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { ModalShell } from './ModalShell.js'
+
+/** 输入弹窗卡片（ModalShell 内容）。 */
+function PromptCard({ title, initial, done }) {
+  const inputRef = React.useRef(null)
+  React.useEffect(() => {
+    const el = inputRef.current
+    if (!el) return
+    el.focus()
+    const dot = String(initial).lastIndexOf('.')
+    el.setSelectionRange(0, dot > 0 ? dot : String(initial).length)
+  }, [])
+  const submit = () => done(String(inputRef.current?.value ?? '').trim())
+  return React.createElement(React.Fragment, null,
+    React.createElement('h3', null, title),
+    React.createElement('label', null, '名称',
+      React.createElement('input', {
+        ref: inputRef,
+        defaultValue: initial,
+        onKeyDown: (event) => {
+          if (event.key !== 'Enter') return
+          event.preventDefault()
+          submit()
+        },
+      })),
+    React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+      React.createElement('button', { onClick: () => done(null) }, '取消'),
+      React.createElement('button', { className: 'vsm-primary', onClick: submit }, '确定')))
+}
+
+/**
+ * 弹出名称输入弹窗。
+ * @author ddj 2026年09月22号
+ * @param title 弹窗标题
+ * @param initial 初始名称（重命名预填原名；新建为空串）
+ * @returns 用户输入（已去首尾空白）；取消/空输入返回 null
+ */
+export function promptName(title, initial) {
+  return new Promise((resolve) => {
+    const host = document.createElement('div')
+    document.body.appendChild(host)
+    const root = createRoot(host)
+    const done = (value) => {
+      root.unmount()
+      host.remove()
+      resolve(value ? value : null)
+    }
+    root.render(React.createElement(ModalShell, {
+      onClose: () => done(null),
+      width: 'min(420px, calc(100vw - 40px))',
+    }, React.createElement(PromptCard, { title, initial: String(initial ?? ''), done })))
+  })
+}

package/src/client/ui/SideEditorTab.ts

@@ -44,6 +44,7 @@ export function SideEditorTab(props) {
     sidebarPanels: props?.sidebarPanels,
     outlineSources: props?.outlineSources,
     fileMenuItems: props?.fileMenuItems,
+    fileOpeners: props?.fileOpeners,
     sessions: props?.sessions,
   })
 }

package/src/client/ui/commandCatalog.ts

@@ -80,6 +80,19 @@ function prevEditorRowDef(): CommandDef {
   }
 }
 
+/**
+ * 转到行（转发 Monaco 原生 gotoLine widget；补命令栏与快捷键设置页入口）。
+ * @author ddj 2026年09月22号
+ * @returns 命令定义
+ */
+function gotoLineDef(): CommandDef {
+  return {
+    id: 'edrv.goToLine', label: '转到行', category: '导航', order: 45,
+    keybinding: 'Ctrl+G', available: needsModel,
+    run: () => emit('goToLine'),
+  }
+}
+
 /**
  * 添加选中内容为引用（把当前选区追加进对话输入框；无选区则状态栏提示）。
  * 有活动编辑器模型才可用，保证对话框内按 Ctrl+U 不被本命令吞掉。
@@ -317,6 +330,7 @@ function debugPaletteDefs(): CommandDef[] {
 export const BRIDGE_COMMANDS: readonly CommandDef[] = [
   nextEditorRowDef(),
   prevEditorRowDef(),
+  gotoLineDef(),
   addSelectionRefDef(),
   closeTabDef(),
   ...debugPaletteDefs(),

package/src/client/ui/icons.ts

@@ -0,0 +1,72 @@
+/**
+ * dsh-vscode-mode client — UI 原语图标跨版本出口（消费方导出名保持 ≤0.1.6 旧名）。
+ * 背景：DSH 0.1.7 图标命名重构——`Icon<Name>16`（0.1.6 及更旧）→
+ * `Icon<Name>Regular/Medium`（0.1.7+，size 参数化 + 双笔画档），旧名在 0.1.7
+ * 全树已不存在（整树 grep 实证）。解析策略：namespace import 属性探测，旧名优先
+ * （现网 0.1.6）→ 新名次之（0.1.7+）→ 皆缺走通用占位（第三态不炸渲染）；
+ * 打包期 external 不校验成员存在性，两代运行时均稳（能力探测，不做版本判定）。
+ * 调用点零语义变化：导出名与旧垫片一致，仅改 import 来源。
+ * @author ddj 2026年09月22号
+ */
+import React from 'react'
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+import type { EdrvIconProps } from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** 图标组件形状（与垫片 EdrvIconProps 兼容）。 */
+type IconComponent = (props: EdrvIconProps) => unknown
+
+/**
+ * 通用占位图标（两代皆缺的第三态兜底：空态方框，不抛错不白屏）。
+ * @author ddj 2026年09月22号
+ * @param props 图标 props（size/className 透传）
+ * @returns React 元素
+ */
+function fallbackIcon(props: EdrvIconProps): unknown {
+  return React.createElement('svg', {
+    width: props.size ?? 16,
+    height: props.size ?? 16,
+    viewBox: '0 0 16 16',
+    className: props.className,
+    'aria-hidden': true,
+    focusable: false,
+  }, React.createElement('rect', {
+    x: 3.5, y: 3.5, width: 9, height: 9, rx: 2,
+    fill: 'none', stroke: 'currentColor', strokeWidth: 1.2, opacity: 0.45,
+  }))
+}
+
+/**
+ * 按候选名序列解析图标组件（首个存在的函数命中；皆缺返回占位）。
+ * @author ddj 2026年09月22号
+ * @param names 候选导出名（旧名在前、新名在后）
+ * @returns 图标组件
+ */
+function iconOf(...names: string[]): IconComponent {
+  const table = primitives as unknown as Record<string, unknown>
+  for (const name of names) {
+    const hit = table[name]
+    if (typeof hit === 'function') return hit as IconComponent
+  }
+  return fallbackIcon
+}
+
+// 两代语义等价的图标对（旧名 → 0.1.7 Regular 档；Medium 档不用于本插件 16px 场景）
+/** 目录闭合图标（官方文件树同款）。 */
+export const IconFolderClose16 = iconOf('IconFolderClose16', 'IconFolderCloseRegular')
+/** 目录展开图标（官方文件树同款）。 */
+export const IconFolderOpen16 = iconOf('IconFolderOpen16', 'IconFolderOpenRegular')
+/** 目录轮廓图标（活动栏「文件管理」）。 */
+export const IconFolderOpenOutline16 = iconOf('IconFolderOpenOutline16', 'IconFolderOpenOutlineRegular')
+/** 刷新图标（面板工具条）。 */
+export const IconRefreshOutline16 = iconOf('IconRefreshOutline16', 'IconRefreshOutlineRegular')
+/** 搜索图标（活动栏「搜索」）。 */
+export const IconSearchOutline16 = iconOf('IconSearchOutline16', 'IconSearchOutlineRegular')
+/** 列表+笔图标（活动栏「规则」）。 */
+export const IconListPenOutline16 = iconOf('IconListPenOutline16', 'IconListPenOutlineRegular')
+/** 代码图标（活动栏「大纲」）。 */
+export const IconCodeOutline16 = iconOf('IconCodeOutline16', 'IconCodeOutlineRegular')
+/** 分支图标（SVN 面板）。 */
+export const IconBranchOutline16 = iconOf('IconBranchOutline16', 'IconBranchOutlineRegular')
+
+// 两代同名存活的原语：直通再导出（0.1.6/0.1.7 实证均在）
+export { FileTypeIcon, classifyFileType } from '@deepseek-ai/dsh-client-ui-primitives'

package/src/compat.ts

@@ -133,7 +133,7 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
 }
 
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = '0.1.6-alpha.2'
+const TESTED_DSH_MAX = '0.1.7-alpha.1'
 
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {
@@ -149,7 +149,7 @@ export function versionAdapters(dshVersion: string): CompatAdapter[] {
   const strategy = settingsInstallStrategy()
   adapters.push({
     name: '设置 section 安装（版本适配）',
-    active: strategy === 'legacy' || strategy === 'service',
+    active: strategy === 'legacy' || strategy === 'service' || strategy === 'forms',
     note: settingsInstallNote(),
   })
   return adapters

package/src/dshVersion.ts

@@ -85,13 +85,14 @@ export function inDshRange(version: DshVersion | null | undefined, range: DshRan
 /**
  * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
  * 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
- * @author ddj 2026年09月02号 / 2026年09月18号
+ * @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号
  * @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.7-alpha.1' })) return '0.1.7-alpha.1 及更新（设置=profile Config + configForms 客户端面 + 会话 V4）'
   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）'

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号
  */
 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'
@@ -170,11 +172,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 +204,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 +295,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,6 +335,101 @@ 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 均通过）。
+ * @author ddj 2026年09月22号
+ * @param z schemastery 命名空间（静态 import 或动态加载均可）
+ * @returns schemastery object schema
+ */
+export function buildSettingsSchema(z: SettingsDeps['z']): unknown {
+  return z.object({
+    fileOpenTool: z.string().default(FILE_OPEN_DEFAULT),
+    keybindings: z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS }),
+    sidebarMinWidth: z.number().default(300),
+    // 页签数量上限（0 = 不限制；超限时淘汰最久未使用的页签，固定页签除外）
+    maxOpenEditors: z.number().default(EDITOR_LIMIT_DEFAULT),
+    integrationBaseUrl: z.string().default(INTEGRATION_BASE_DEFAULT),
+    // AI 内联补全（默认关；provider/model 空 = 自动路由；effort 空 = 跟随模型默认）
+    aiInline: z.boolean().default(AI_CONFIG_DEFAULT.enabled),
+    aiProvider: z.string().default(AI_CONFIG_DEFAULT.provider),
+    aiModel: z.string().default(AI_CONFIG_DEFAULT.model),
+    aiEffort: z.string().default(AI_CONFIG_DEFAULT.effort),
+    // SVN 能力：svn CLI 覆盖（空 = PATH）与 TortoiseSVN 目录（Windows 过渡增强）
+    svnPath: z.string().default(''),
+    tortoisePath: z.string().default(TORTOISE_DIR_DEFAULT),
+    // 原生打开范围（逗号分隔后缀；默认 = 让位清单并集，csv/tsv 决策见 shared/nativeOpen.ts）
+    nativeOpenExts: z.string().default(DEFAULT_NATIVE_CSV),
+  })
+}
+
 function normalizeValue(value: unknown): string {
   if (typeof value !== 'string' || value.trim() === '') return FILE_OPEN_DEFAULT
   return value.trim()
@@ -337,27 +481,12 @@ 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 未就绪时回退默认）。 */
@@ -385,8 +514,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 +522,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 +536,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, {
@@ -438,31 +565,27 @@ 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)
+      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,18 @@ 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 行为一致，校验必过）。
+ * 运行时解析：@deepseek-ai/schemastery 经插件自身 node_modules（link/dev/npm 安装
+ * 三形态均在 peer/dev 依赖面内，先于宿主树命中）。
+ * @author ddj 2026年09月22号
+ */
+export const Config = buildSettingsSchema(z as unknown as SettingsDeps['z'])
+
 /**
  * 装配插件：挂事件监听、注册路由、安装兼容层。
  * @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 }