dsh-vscode-mode 0.8.0 → 0.9.0

package/src/client/ui/SvnAiPlanDialog.ts

@@ -0,0 +1,293 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — AI 智能整理弹窗（11-ai-changelist-triage）。
+ *
+ * 双阶段单弹窗：
+ * - 预览（run = null）：按**整理功能**划分三个分组卡（建议分组 changelist / 建议还原 revert /
+ *   建议忽略 svn:ignore），每段段级全选 + 逐项勾选确认；默认「分组勾选（可逆无副作用）、
+ *   还原/忽略不勾（有副作用）」，未勾选项一律不动。
+ * - 执行（run 非空）：弹窗不关闭，切换为进度视图——阶段徽标 + 步骤计数 + 总进度条 +
+ *   逐步日志（✓/✗，失败红字）；「暂停」在当前 RPC 返回后的步骤边界生效（svn 子进程不可
+ *   安全中断，如实标注「等待当前步骤完成…」），「继续」从断点续跑，「取消剩余」终止未执行
+ *   步骤（已执行不回滚）。
+ * Esc/遮罩仅在预览阶段生效（= 取消零副作用）；执行阶段防误关。
+ * 作者 ddj 2026年09月23号
+ */
+import React from 'react'
+import { ModalShell } from './ModalShell.js'
+
+/**
+ * 预览勾选初值：分组默认全勾（changelist 可逆），还原/忽略默认不勾（有副作用）。
+ * @author ddj 2026年09月23号
+ * @param plan 三段方案
+ * @returns 勾选态（组级 + 逐项）
+ */
+function initPlanSel(plan) {
+  return {
+    groups: (plan.groups || []).map((group) => ({
+      name: group.name,
+      reason: group.reason || '',
+      checked: true,
+      paths: (group.paths || []).map((path) => ({ path, checked: true })),
+    })),
+    reverts: (plan.reverts || []).map((item) => ({ path: item.path, reason: item.reason || '', checked: false })),
+    ignores: (plan.ignores || []).map((item) => ({ path: item.path, reason: item.reason || '', checked: false })),
+  }
+}
+
+/**
+ * 勾选态 → 执行载荷（空段/空组剔除；保持勾选顺序）。
+ * @author ddj 2026年09月23号
+ * @param sel 勾选态
+ * @returns 执行载荷 { groups, reverts, ignores }
+ */
+function selectedOf(sel) {
+  const groups = []
+  for (const group of sel.groups) {
+    const paths = group.paths.filter((p) => p.checked).map((p) => p.path)
+    if (group.checked && paths.length) groups.push({ name: group.name, paths })
+  }
+  return {
+    groups,
+    reverts: sel.reverts.filter((item) => item.checked).map((item) => item.path),
+    ignores: sel.ignores.filter((item) => item.checked).map((item) => item.path),
+  }
+}
+
+/** 执行载荷 → 已选动作总数（「执行所选」禁用判定）。 */
+function selectedCount(selected) {
+  let n = selected.reverts.length + selected.ignores.length
+  for (const group of selected.groups) n += group.paths.length
+  return n
+}
+
+/** 复选框元素（原生 input；仓库 UI 原语无 Checkbox，此处沿用补丁对话框的原生控件口径）。 */
+function checkBoxEl(checked, onToggle, title) {
+  return React.createElement('input', {
+    type: 'checkbox',
+    checked,
+    title,
+    onChange: () => onToggle(),
+    onClick: (event) => event.stopPropagation(),
+  })
+}
+
+/** 段头（全选框 + 标题 + 计数 + 副标题）。 */
+function sectionHeadEl(title, note, allChecked, onToggleAll, countText) {
+  return React.createElement('div', { className: 'edrv-svnplan-sechead' },
+    checkBoxEl(allChecked, onToggleAll, '全选/全不选'),
+    React.createElement('span', { className: 'edrv-svnplan-sectitle' }, title),
+    React.createElement('span', { className: 'edrv-svn-count' }, countText),
+    (note ? React.createElement('span', { className: 'edrv-svnplan-note' }, note) : null))
+}
+
+/**
+ * 阶段一 · 预览确认（按整理功能三分组）。
+ * @author ddj 2026年09月23号
+ * @param sel 勾选态
+ * @param setSel 勾选态更新
+ * @param open 组卡展开集合（组名）
+ * @param toggleOpen 组卡展开切换
+ * @returns 预览主体元素
+ */
+function previewBodyEl(sel, setSel, open, toggleOpen) {
+  /** 通用段更新（reverts/ignores 共用）。 */
+  const patchItems = (key, index, checked) => setSel((old) => ({
+    ...old,
+    [key]: old[key].map((item, i) => (i === index ? { ...item, checked } : item)),
+  }))
+  const toggleItemsAll = (key, checked) => setSel((old) => ({
+    ...old,
+    [key]: old[key].map((item) => ({ ...item, checked })),
+  }))
+  /** 组级/组内更新。 */
+  const patchGroup = (index, patch) => setSel((old) => ({
+    ...old,
+    groups: old.groups.map((group, i) => (i === index ? { ...group, ...patch } : group)),
+  }))
+  const toggleGroupAll = (index, checked) => setSel((old) => ({
+    ...old,
+    groups: old.groups.map((group, i) => (i === index
+      ? { ...group, checked, paths: group.paths.map((p) => ({ ...p, checked })) }
+      : group)),
+  }))
+
+  const groupCards = sel.groups.map((group, index) => {
+    const done = group.paths.filter((p) => p.checked).length
+    const isOpen = open.has(group.name)
+    const fileRows = isOpen
+      ? group.paths.map((item, pi) => React.createElement('div', { key: item.path, className: 'edrv-svnplan-item' },
+          checkBoxEl(item.checked, () => patchGroup(index, {
+            paths: group.paths.map((p, j) => (j === pi ? { ...p, checked: !p.checked } : p)),
+          }), item.path),
+          React.createElement('span', { className: 'edrv-svnplan-path', title: item.path }, item.path)))
+      : null
+    return React.createElement('div', { key: group.name, className: 'edrv-svnplan-card' },
+      React.createElement('div', { className: 'edrv-svnplan-row' },
+        checkBoxEl(group.checked, () => toggleGroupAll(index, !group.checked), '全选该组'),
+        React.createElement('span', {
+          className: 'edrv-svnplan-groupname',
+          title: '点击展开/收起成员',
+          onClick: () => toggleOpen(group.name),
+        }, (isOpen ? '▾ ' : '▸ ') + group.name),
+        React.createElement('span', { className: 'edrv-svn-count' }, done + '/' + group.paths.length + ' 项'),
+        (group.reason ? React.createElement('span', { className: 'edrv-svnplan-reason', title: group.reason }, group.reason) : null)),
+      fileRows)
+  })
+
+  const itemRowsOf = (key) => sel[key].map((item, index) => React.createElement('div', { key: item.path, className: 'edrv-svnplan-item' },
+    checkBoxEl(item.checked, () => patchItems(key, index, !item.checked), item.path),
+    React.createElement('span', { className: 'edrv-svnplan-path', title: item.path }, item.path),
+    (item.reason ? React.createElement('span', { className: 'edrv-svnplan-reason', title: item.reason }, item.reason) : null)))
+
+  // 段级全选：取反当前全选态（checkBoxEl 的 onToggle 不回传状态，须闭包捕获）
+  const groupsAll = sel.groups.length > 0 && sel.groups.every((g) => g.checked && g.paths.every((p) => p.checked))
+  const revertsAll = sel.reverts.length > 0 && sel.reverts.every((i) => i.checked)
+  const ignoresAll = sel.ignores.length > 0 && sel.ignores.every((i) => i.checked)
+
+  return React.createElement(React.Fragment, null,
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议分组（changelist）', '无副作用、可逆', groupsAll,
+        () => setSel((old) => ({
+          ...old,
+          groups: old.groups.map((group) => ({ ...group, checked: !groupsAll, paths: group.paths.map((p) => ({ ...p, checked: !groupsAll })) })),
+        })), sel.groups.length + ' 组'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, groupCards)),
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议还原（revert）', '放弃本地改动，默认不勾', revertsAll,
+        () => toggleItemsAll('reverts', !revertsAll), sel.reverts.length + ' 项'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, itemRowsOf('reverts'))),
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议忽略（svn:ignore）', '将写入 svn:ignore 属性，随提交进仓库，默认不勾', ignoresAll,
+        () => toggleItemsAll('ignores', !ignoresAll), sel.ignores.length + ' 项'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, itemRowsOf('ignores'))))
+}
+
+/**
+ * 阶段二 · 执行进度（阶段徽标 + 计数 + 进度条 + 逐步日志）。
+ * @author ddj 2026年09月23号
+ * @param run 执行状态
+ * @returns 进度主体元素
+ */
+function progressBodyEl(run) {
+  const pct = run.total > 0 ? Math.floor((run.index / run.total) * 100) : 0
+  const statusText = run.status === 'pausing' ? '等待当前步骤完成…（暂停在步骤边界生效）'
+    : run.status === 'paused' ? '已暂停'
+    : run.status === 'cancelling' ? '正在取消剩余步骤…'
+    : run.status === 'done' ? (run.cancelled ? '已取消剩余步骤' : '执行完毕')
+    : '执行中…'
+  const logRows = run.log.map((entry, index) => React.createElement('div', {
+    key: index,
+    className: 'edrv-svnplan-log' + (entry.ok ? '' : ' edrv-svnplan-log-bad'),
+  }, (entry.ok ? '✓ ' : '✗ ') + entry.text))
+  return React.createElement(React.Fragment, null,
+    React.createElement('div', { className: 'edrv-svnplan-stage' },
+      React.createElement('span', { className: 'edrv-svnplan-badge' }, statusText),
+      (run.cur ? React.createElement('span', { className: 'edrv-svnplan-badge edrv-svnplan-badge-cur' }, run.cur) : null),
+      React.createElement('span', { className: 'edrv-svn-count' }, run.index + '/' + run.total + ' 步')),
+    React.createElement('div', { className: 'edrv-svnplan-bar' },
+      React.createElement('div', { className: 'edrv-svnplan-bar-in', style: { width: pct + '%' } })),
+    React.createElement('div', { className: 'edrv-svnplan-logwrap' }, logRows))
+}
+
+/**
+ * AI 智能整理弹窗（预览 + 进度双阶段）。
+ * @author ddj 2026年09月23号
+ * @param props.plan 三段方案（host 已归一）
+ * @param props.meta 分析元信息 { entriesCount, diffIncluded, dropped, model, source? }（source='agent' = 混合通道）
+ * @param props.run 执行状态；null = 预览阶段（shape 见 SvnPanel runPlanSteps）
+ * @param props.onExecute 预览确认（选中载荷 → 启动执行引擎）
+ * @param props.onPause 暂停（步骤边界生效）
+ * @param props.onResume 继续
+ * @param props.onCancelRest 取消剩余
+ * @param props.onClose 关闭（预览 = 取消零副作用；执行阶段按钮仅在结束后可用）
+ * @returns 弹窗元素
+ */
+export function SvnAiPlanDialog(props) {
+  const { plan, meta, run, onExecute, onPause, onResume, onCancelRest, onClose } = props
+  const [sel, setSel] = React.useState(() => initPlanSel(plan))
+  const [open, setOpen] = React.useState(() => new Set())
+  const selected = selectedOf(sel)
+  const count = selectedCount(selected)
+
+  /** 组卡展开切换（纯 UI 态）。 */
+  const toggleOpen = (name) => {
+    const next = new Set(open)
+    if (next.has(name)) next.delete(name)
+    else next.add(name)
+    setOpen(next)
+  }
+
+  const running = run !== null && run.status !== 'done'
+  const header = React.createElement('div', { className: 'edrv-svnplan-head' },
+    React.createElement('h3', { className: 'edrv-svnlog-title' }, 'AI 智能整理 SVN 变更'),
+    // 混合通道来源标注（agent 深度分析 vs 快速通道直调）
+    (meta?.source === 'agent'
+      ? React.createElement('span', { className: 'edrv-svnplan-badge', title: '会话 AI 助手深度分析（codegraph/读文件）产出' }, 'AI 助手深度分析')
+      : null),
+    (meta?.model ? React.createElement('span', { className: 'edrv-svn-count', title: '分析模型' }, meta.model) : null),
+    React.createElement('span', { style: { flex: 1 } }),
+    React.createElement('button', {
+      className: 'edrv-svn-act',
+      title: running ? '执行中不可关闭（可取消剩余）' : '关闭',
+      disabled: running,
+      onClick: onClose,
+    }, '✕'))
+
+  const metaEl = React.createElement('div', { className: 'edrv-svnplan-meta' },
+    React.createElement('span', { className: 'edrv-svn-count' }, '分析条目 ' + (meta?.entriesCount ?? 0) + ' 项'),
+    ((meta?.dropped ?? 0) > 0 ? React.createElement('span', { className: 'edrv-svn-count' }, '已丢弃 AI 无效建议 ' + meta.dropped + ' 项') : null),
+    (meta?.diffIncluded === false
+      ? React.createElement('span', { className: 'edrv-svnplan-note' }, '未含 diff 上下文，分析精度有限')
+      : null))
+
+  let body = null
+  let footer = null
+  if (run === null) {
+    body = previewBodyEl(sel, setSel, open, toggleOpen)
+    footer = React.createElement('div', { className: 'edrv-svnplan-foot' },
+      React.createElement('span', { className: 'edrv-svn-count' }, '已选 ' + count + ' 项'),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', { className: 'edrv-svn-act', title: '不执行任何动作', onClick: onClose }, '取消'),
+      React.createElement('button', {
+        className: 'edrv-svn-act edrv-svnplan-primary',
+        title: '执行全部勾选项（未勾选不动）',
+        disabled: count === 0,
+        onClick: () => onExecute(selected),
+      }, '执行所选（' + count + ' 项）'))
+  } else {
+    body = progressBodyEl(run)
+    footer = React.createElement('div', { className: 'edrv-svnplan-foot' },
+      React.createElement('span', { style: { flex: 1 } }),
+      (run.status === 'done'
+        ? React.createElement('button', {
+            className: 'edrv-svn-act edrv-svnplan-primary',
+            title: '关闭弹窗并刷新变更列表',
+            onClick: onClose,
+          }, '关闭并刷新')
+        : React.createElement(React.Fragment, null,
+            React.createElement('button', {
+              className: 'edrv-svn-act',
+              title: run.status === 'running' || run.status === 'pausing'
+                ? '暂停（当前步骤完成后生效）'
+                : '从断点继续执行',
+              disabled: run.status === 'pausing' || run.status === 'cancelling',
+              onClick: run.status === 'paused' ? onResume : onPause,
+            }, run.status === 'paused' ? '继续' : '暂停'),
+            React.createElement('button', {
+              className: 'edrv-svn-act edrv-svn-act-danger',
+              title: '终止未执行步骤（已执行部分不回滚）',
+              disabled: run.status === 'cancelling',
+              onClick: onCancelRest,
+            }, '取消剩余'))))
+  }
+
+  return React.createElement(ModalShell, {
+    key: 'edrv-svn-plan',
+    dialogClass: 'edrv-svnplan-dialog',
+    width: 'min(680px, calc(100vw - 48px))',
+    closeOnMask: !running,
+    closeOnEsc: !running,
+    onClose,
+  }, header, metaEl, body, footer)
+}

package/src/client/ui/icons.ts

@@ -10,6 +10,7 @@
  */
 import React from 'react'
 import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+import { classifyFileType, FileTypeIcon } from '@deepseek-ai/dsh-client-ui-primitives'
 import type { EdrvIconProps } from '@deepseek-ai/dsh-client-ui-primitives'
 
 /** 图标组件形状（与垫片 EdrvIconProps 兼容）。 */
@@ -70,3 +71,21 @@ export const IconBranchOutline16 = iconOf('IconBranchOutline16', 'IconBranchOutl
 
 // 两代同名存活的原语：直通再导出（0.1.6/0.1.7 实证均在）
 export { FileTypeIcon, classifyFileType } from '@deepseek-ai/dsh-client-ui-primitives'
+
+/**
+ * 文件图标元素（官方 FileTypeIcon + classifyFileType 分类，未知类型为 other）。
+ * 文件树与 SVN 变更行共用（原为 FileExplorer 私有副本，上移共享防两处漂移）。
+ * @author ddj 2026年09月23号
+ * @param name 文件名（含扩展名；目录由调用方走目录图标）
+ * @returns 图标元素；原语缺失或分类异常返回 null
+ */
+export function fileIconEl(name: string): React.ReactElement | null {
+  if (typeof FileTypeIcon !== 'function' || typeof classifyFileType !== 'function') return null
+  try {
+    // FileTypeIcon 签名为 (props) => ReactNode（非 ReactElement），createElement 重载不认——
+    // 纯函数组件直接调用并收窄返回类型（与 FileExplorer 原 createElement 等效）。
+    return FileTypeIcon({ kind: classifyFileType(String(name ?? '')), size: 16, className: 'edrv-tree-icon' }) as React.ReactElement
+  } catch (error) {
+    return null
+  }
+}

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, schemaLibName, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
+import { loadSettingsDeps, schemaLibName, settingsInstallNote, settingsInstallStrategy, configVolatileState } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
 import { compareDshVersions, detectDshVersion, familyLabel, parseDshVersion } from './dshVersion.js'
 import { SKILL_PREFIXES, skillGroupState } from './skills.js'
@@ -133,9 +133,12 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
 }
 
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = '0.1.7-alpha.1'
+const TESTED_DSH_MAX = '0.1.7-alpha.2'
 
-/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
+/** Config volatile 标记起效的版本线（此前设置走 section 安装，与 volatile 无关）。 */
+const CONFIG_VOLATILE_MIN = '0.1.7-alpha.1'
+
+/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略 + Config volatile 标记。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {
   const adapters: CompatAdapter[] = []
   const parsed = parseDshVersion(dshVersion)
@@ -152,12 +155,24 @@ export function versionAdapters(dshVersion: string): CompatAdapter[] {
     active: strategy === 'legacy' || strategy === 'service' || strategy === 'forms',
     note: settingsInstallNote(),
   })
+  // 追加在末尾（既有下标有断言）；仅 Config 按 volatile 语义构建过才展示该行
+  const volatileState = configVolatileState()
+  if (volatileState.requested) {
+    const volatileOk = volatileState.total > 0 && volatileState.marked === volatileState.total
+    adapters.push({
+      name: 'Config volatile 字段（0.1.7 设置页）',
+      active: volatileOk,
+      note: volatileOk
+        ? volatileState.marked + '/' + volatileState.total + ' 已标记（SettingsForms 可下发本插件 ns）'
+        : volatileState.marked + '/' + volatileState.total + ' 已标记：schemastery 依赖过旧无 .volatile()，0.1.7 设置页不可用',
+    })
+  }
   return adapters
 }
 
 /**
  * 构建完整兼容性报告（RPC 与启动日志共用）。
- * @author ddj 2026年08月24号 / 2026年09月02号
+ * @author ddj 2026年08月24号 / 2026年09月02号 / 2026年09月23号
  * @param ctx DSH host 上下文
  * @param options 测试注入：depsAvailable 跳过动态导入、version 固定插件版本、dshVersion 固定 DSH 版本
  * @returns 兼容性报告
@@ -180,6 +195,12 @@ export async function buildReport(
   if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) {
     warnings.push('DSH ' + dshVersion + ' 高于已实测版本（' + TESTED_DSH_MAX + '）：设置 API 按能力探测运行，异常时请回报适配矩阵')
   }
+  // 0.1.7 线上 Config 未完成 volatile 标记 = 设置页不可用（ns 不下发），显式告警而非静默
+  const volatileState = configVolatileState()
+  const volatileMin = parseDshVersion(CONFIG_VOLATILE_MIN)
+  if (volatileState.requested && volatileState.marked < volatileState.total && parsed && volatileMin && compareDshVersions(parsed, volatileMin) >= 0) {
+    warnings.push('插件 Config volatile 标记不完整（' + volatileState.marked + '/' + volatileState.total + '）：@deepseek-ai/schemastery 依赖过旧，0.1.7 设置页不可用（重装插件依赖后重启 DSH）')
+  }
   for (const guard of guards) {
     if (!guard.active && guard.note) warnings.push(guard.note)
   }

package/src/fileOpenSettings.ts

@@ -6,7 +6,7 @@
  * 插件 Config schema，见 runSettingsInstall 四策略：legacy/service/forms/none）。
  * 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
  * 全程 try/catch，不产生未捕获 rejection。
- * 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号 / 2026年09月22号
+ * 作者 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'
@@ -24,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 = {
@@ -405,29 +408,118 @@ export async function updateSection(provider: SettingsProvider | undefined, ns:
  * 字段集 = fileOpenTool/keybindings/sidebarMinWidth/maxOpenEditors/integrationBaseUrl/
  * aiInline/aiProvider/aiModel/aiEffort/svnPath/tortoisePath/nativeOpenExts，全部带默认值
  * （Config 启动校验在 undefined/空配置下自动填充，rc/alpha 两代 cordis 均通过）。
- * @author ddj 2026年09月22号
+ * 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']): unknown {
-  return z.object({
-    fileOpenTool: z.string().default(FILE_OPEN_DEFAULT),
-    keybindings: z.object(keybindingsShape(z)).default({ ...KEYBINDING_DEFAULTS }),
-    sidebarMinWidth: z.number().default(300),
+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: z.number().default(EDITOR_LIMIT_DEFAULT),
-    integrationBaseUrl: z.string().default(INTEGRATION_BASE_DEFAULT),
+    maxOpenEditors: withVol(z.number().default(EDITOR_LIMIT_DEFAULT)),
+    integrationBaseUrl: withVol(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),
+    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: z.string().default(''),
-    tortoisePath: z.string().default(TORTOISE_DIR_DEFAULT),
+    svnPath: withVol(z.string().default('')),
+    tortoisePath: withVol(z.string().default(TORTOISE_DIR_DEFAULT)),
     // 原生打开范围（逗号分隔后缀；默认 = 让位清单并集，csv/tsv 决策见 shared/nativeOpen.ts）
-    nativeOpenExts: z.string().default(DEFAULT_NATIVE_CSV),
-  })
+    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 {
@@ -436,24 +528,24 @@ function normalizeValue(value: unknown): string {
 }
 
 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
 }
 
@@ -490,13 +582,16 @@ export async function installOpenSettingsSection(
 }
 
 /** 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,
   }
 }
 
@@ -555,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()
   })
 
@@ -580,6 +679,9 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
       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 }
+      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 降级语义一致

package/src/index.ts

@@ -44,11 +44,14 @@ export const inject = ['sessions', 'fs', 'webServer', 'loader', 'tools', 'worksp
  * 字段集与 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号
+ * 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'])
+export const Config = buildSettingsSchema(z as unknown as SettingsDeps['z'], { volatile: true })
 
 /**
  * 装配插件：挂事件监听、注册路由、安装兼容层。

package/src/model.ts

@@ -32,7 +32,8 @@ export function normalizeRecord(raw: unknown): DiffRecord | null {
       }
     })
     : []
-  const toolName: DiffRecord['toolName'] = r.toolName === 'write' ? 'write' : 'edit'
+  // 白名单保留已知工具名，未知/缺失回退 'edit'（旧 sidecar 语义不变）
+  const toolName: DiffRecord['toolName'] = r.toolName === 'write' || r.toolName === 'remote_ssh_write' ? r.toolName : 'edit'
   const rawDecisions = r.decisions && typeof r.decisions === 'object' ? r.decisions as Record<string, unknown> : {}
   const call = rawDecisions.call === 'accepted' || rawDecisions.call === 'rejected' ? rawDecisions.call : 'pending'
   const rawPerHunk = Array.isArray(rawDecisions.perHunk) ? rawDecisions.perHunk : []