dsh-vscode-mode 0.2.0 → 0.3.0

package/src/client/ui/EditorView.ts

@@ -10,7 +10,7 @@
 import React from 'react'
 import { dbg, rpc } from '../rpc.js'
 import { emitRefresh } from '../events.js'
-import { langOf, loadMonaco } from '../monaco/loader.js'
+import { langOf, loadMonaco, snippetLanguageOf } from '../monaco/loader.js'
 import { dataUrlOf, isImagePath, isSvgPath } from '../imagePreview.js'
 import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
 import { createPdfPanel } from '../pdf/pdfPanel.js'
@@ -20,6 +20,7 @@ import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
 import { QuickOpen } from './QuickOpen.js'
 import { CommandPalette } from './CommandPalette.js'
+import { closeCommandPalette } from '../commandPaletteStore.js'
 import { DiffLauncher } from './DiffLauncher.js'
 import { SidebarView } from '../sidebar/SidebarView.js'
 import { clearDiffDock, publishDiffDock } from '../diffDockStore.js'
@@ -39,6 +40,27 @@ import { bindLspEditor, runGoToDefinition, runFindReferences, hideReferencesOver
 import { bindLspUnderline } from '../monaco/lsp/underline.js'
 import { onLspProgress, refreshStatus } from '../monaco/lsp/index.js'
 import { setupAiInline, trackAiEditor, aiInlineEnabled } from '../ai/inlineProvider.js'
+import { SnippetsPicker } from './SnippetsPicker.js'
+import { invalidateSnippets, setSnippetsSession, setupSnippets } from '../snippets/provider.js'
+
+/**
+ * 从 Monaco 语言目录取可选语言 id 列表（代码片段新建时的语言下拉来源）。
+ * 旧版 Monaco / 目录不可读时返回 undefined，由调用方回落 shared 的内置常量。
+ * @author ddj 2026年09月10号
+ * @param monaco window.monaco（可能未加载）
+ * @returns 语言 id 数组或 undefined
+ */
+function snippetLanguageIds(monaco) {
+  try {
+    const languages = monaco?.languages?.getLanguages?.()
+    if (!Array.isArray(languages) || !languages.length) return undefined
+    return languages
+      .map((item) => (item && typeof item.id === 'string' ? item.id : ''))
+      .filter(Boolean)
+  } catch (error) {
+    return undefined
+  }
+}
 
 /**
  * 中央编辑区：文件页签（脏点/关闭/打开路径）+ Ctrl+P 搜索 + Monaco 编辑器 +
@@ -148,6 +170,7 @@ export function EditorView(props) {
   const hoverPanelRef = React.useRef(false) // 鼠标是否已进入 Keep/Undo 浮层
   const batchBusyRef = React.useRef(false) // 批量 Keep All/Undo All 防重入
   const menuHandlersRef = React.useRef(null) // 右键菜单动作的最新闭包（Monaco addAction 空依赖回调读取）
+  const [snippetPicker, setSnippetPicker] = React.useState(null) // 'configure' | 'insert' | null（代码片段浮层）
   const doSaveRef = React.useRef(null) // 保存动作的最新闭包（窗口级保存监听读取）
   const onEditRef = React.useRef(null) // 编辑置脏的最新闭包（Monaco 内容变化监听经 ref 调用，防首帧 active=null 陈旧闭包）
   const saveViewStateRef = React.useRef(null) // 视图状态保存的最新闭包（卸载清理读取，避免过期 active）
@@ -569,6 +592,16 @@ export function EditorView(props) {
     }
   }, [])
 
+  // 代码片段：会话切换让补全按当前工作区叠加项目片段；配置文件保存后失效缓存即时生效
+  React.useEffect(() => {
+    setSnippetsSession(sessionId)
+  }, [sessionId])
+  React.useEffect(() => {
+    const onChanged = () => invalidateSnippets()
+    window.addEventListener('edrv:snippets-changed', onChanged)
+    return () => window.removeEventListener('edrv:snippets-changed', onChanged)
+  }, [])
+
   React.useEffect(() => {
     const onOpen = (e) => {
       const p = e?.detail?.path
@@ -851,6 +884,24 @@ export function EditorView(props) {
         if (!path) { setStatus('无活动文件'); return }
         menuHandlersRef.current?.openInExplorer?.(path)
       }],
+      // 代码片段：配置（选择器）与插入（当前语言条目）；选区引用（Ctrl+U）。
+      // 打开前先关命令栏：命令栏是「执行一条命令」的一次性入口，执行完即关，
+      // 否则会残留一个已打开（可能被浮窗遮住）的命令栏，使后续 Ctrl+Shift+P 看似失效。
+      ['edrv.command.configureSnippets', () => { closeCommandPalette(); setSnippetPicker('configure') }],
+      ['edrv.command.insertSnippet', () => { closeCommandPalette(); setSnippetPicker('insert') }],
+      ['edrv.command.addSelectionRef', () => {
+        const ed = editorRef.current
+        const sel = ed?.getSelection?.()
+        const path = activeRef.current
+        if (!path) { setStatus('无活动文件'); return }
+        if (!sel || (sel.startLineNumber === sel.endLineNumber && sel.startColumn === sel.endColumn)) {
+          setStatus('请先选中内容再添加引用')
+          return
+        }
+        const range = { startLine: sel.startLineNumber, endLine: sel.endLineNumber }
+        if (!addToConversation) { setStatus('添加到对话不可用'); return }
+        addToConversation.appendReference(sessionId, path, range).then((o) => setStatus(statusOfAdd(o, '已添加选中内容为引用')))
+      }],
     ]
     const byName = new Map(handlers)
     const onCommand = (event) => {
@@ -942,6 +993,8 @@ export function EditorView(props) {
       setMonaco(m)
       // AI 内联补全 provider 注册 + 开关初始化（幂等）
       setupAiInline(m)
+      // 代码片段补全 provider 注册（幂等；条目按会话工作区懒加载）
+      setupSnippets(m)
     }).catch((e) => {
       if (alive) {
         setMonacoErr(String(e?.message ?? e))
@@ -1017,6 +1070,8 @@ export function EditorView(props) {
         setDirtyMap((d) => Object.assign({}, d, { [active]: false }))
         refreshRecords()
         emitRefresh()
+        // 片段配置文件保存后失效补全缓存（下次补全即读到新片段）
+        if (/\.code-snippets$/i.test(active)) window.dispatchEvent(new CustomEvent('edrv:snippets-changed'))
       } else { setStatus('保存失败'); setError(res?.error ? String(res.error) : '保存失败') }
     }).catch((e) => { setStatus('保存失败'); setError('保存异常:' + String(e)) })
   }
@@ -1563,6 +1618,26 @@ export function EditorView(props) {
   // 供 Monaco 原生右键菜单 addAction 读取的最新动作闭包（空依赖回调不随渲染重建）
   menuHandlersRef.current = { addRefToChat, openInExplorer }
 
+  /**
+   * 在光标处按片段语法展开插入（Monaco 原生 snippet 控制器解析 ${1:占位} 与 $TM_* 变量）。
+   * @author ddj 2026年09月10号
+   * @param entry 片段条目
+   */
+  const insertSnippetAtCursor = (entry) => {
+    const ed = editorRef.current
+    if (!ed || !entry) { setStatus('无活动编辑器'); return }
+    try {
+      ed.focus()
+      const controller = ed.getContribution?.('snippetController2')
+      if (controller?.insert) controller.insert(String(entry.body ?? ''))
+      else ed.executeEdits('edrv-snippet', [{ range: ed.getSelection(), text: String(entry.body ?? '') }])
+      setStatus('已插入代码片段：' + (entry.prefix || entry.key))
+    } catch (error) {
+      setStatus('插入代码片段失败')
+      setError('插入代码片段失败：' + String(error))
+    }
+  }
+
   const openFile = (path, focusDiff) => {
     if (!path) return
     recordNav()
@@ -1847,6 +1922,23 @@ export function EditorView(props) {
         React.createElement('button', { className: 'edrv-ctxmenu-item edrv-ctxmenu-danger', onClick: () => { closeTab(tabMenu.path); dismissMenus() } }, '关闭标签页'))
     : null
 
+  // 代码片段浮层（命令栏「代码片段：配置代码片段」/「插入代码片段」）：portal 到 body，随会话注入 cwd/语言
+  const snippetPickerEl = snippetPicker
+    ? React.createElement(SnippetsPicker, {
+        mode: snippetPicker,
+        sessionId,
+        cwd: cwd ?? null,
+        // 片段文件本身的语言要按 `<语言>.code-snippets` 命名约定推导（不能用 langOf：
+        // 那会把 .code-snippets 当成 json 源文件，默认名会错成 json.code-snippets）
+        language: active ? snippetLanguageOf(active) : '',
+        languages: snippetLanguageIds(monacoRef.current),
+        // 显式给 line=1：走 openFileAt 的直接定位分支（并清掉 pendingFocus，不残留跳转意图）
+        onOpenFile: (absPath) => { openFileAt(absPath, 1); setStatus('已打开代码片段文件') },
+        onInsert: insertSnippetAtCursor,
+        onClose: () => setSnippetPicker(null),
+      })
+    : null
+
   const sidebarPanels = props.sidebarPanels
   const sidebarCtx = {
     sessionId,
@@ -1921,11 +2013,13 @@ export function EditorView(props) {
         editorRow,
         menuBackdrop,
         tabMenuEl,
-        paletteEl)
+        paletteEl,
+        snippetPickerEl)
     : React.createElement('div', { ref: viewRootRef, 'data-edrv-view': '1', style: Object.assign({}, baseStyle, { height: 'var(--edrv-editor-height, 100%)', maxHeight: 'var(--edrv-editor-height, 100%)' }) },
         editorRow,
         menuBackdrop,
         tabMenuEl,
-        paletteEl)
+        paletteEl,
+        snippetPickerEl)
   return rootEl
 }

package/src/client/ui/SnippetsPicker.ts

@@ -0,0 +1,296 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 代码片段选择器（VS Code「Configure Snippets」形态）。
+ *
+ * 形态：**居中浮窗 + 二级弹窗**，复用插件原生模态样式（mcp.css 的 .vsm-mcp-dialog，
+ * 与「添加 MCP」「工作区选择」同源），不自造视觉。
+ * - 一级弹窗 mode='configure'：按语言分组的现有片段文件列表（全局 + 当前工作区项目），
+ *   点击在文件编辑界面打开；底部按「当前文件语言」新建，或新建全语言片段。
+ * - 二级弹窗：新建片段文件表单（语言下拉 + 文件名），语言决定默认文件名与写入的绑定语义。
+ * - 一级弹窗 mode='insert'：当前语言生效条目列表，点击在光标处按片段语法展开。
+ *
+ * ⚠️ 浮层经 createPortal 挂 body，根节点必须带 `data-edrv-view`（与 CommandPalette /
+ * ContextMenu 一致）：editor.css 的浮层样式全部以 `[data-edrv-view]` 作用域限定，
+ * 漏挂会导致样式整块失效、内容以裸流形式铺在页面底部。
+ * 作者 ddj 2026年09月10号
+ */
+import React from 'react'
+import { createPortal } from 'react-dom'
+import { rpc } from '../rpc.js'
+import { invalidateSnippets, listSnippetsFor } from '../snippets/provider.js'
+import {
+  SNIPPET_LANGUAGES, languageLabelOf, normalizeSnippetFileName, snippetFileTemplate, snippetFileNameFor,
+} from '../../shared/snippets.js'
+// 显式声明对原生模态样式的依赖（.vsm-mcp-dialog / .vsm-primary）：
+// 「添加 MCP」页当前也会引入它，但本组件不应依赖那一处的引入顺序。
+import '../styles/mcp.css'
+
+/** 片段文件行的第二行摘要：语言 + 条目数 + 相对路径。 */
+export function fileMeta(info) {
+  return languageLabelOf(info.language) + ' · ' + info.count + ' 条 · [' + info.relHint + info.file + ']'
+}
+
+/**
+ * 语言下拉选项：全语言 + 语言目录（去重、保持目录序）。
+ * @author ddj 2026年09月10号
+ * @param languages 语言 id 目录（缺省用 shared 常量）
+ * @returns 选项数组（{ id, label }）
+ */
+export function languageOptions(languages) {
+  const ids = Array.isArray(languages) && languages.length ? languages : SNIPPET_LANGUAGES
+  const seen = new Set()
+  const out = [{ id: '', label: '全语言（所有文件生效）' }]
+  for (const raw of ids) {
+    const id = String(raw ?? '').trim().toLowerCase()
+    if (!id || seen.has(id)) continue
+    seen.add(id)
+    out.push({ id, label: languageLabelOf(id) })
+  }
+  return out
+}
+
+/**
+ * 片段选择器（浮窗 / 二级弹窗）。
+ * @param props.mode 'configure'（管理文件）| 'insert'（插入条目）
+ * @param props.sessionId 会话 id
+ * @param props.cwd 当前会话工作区（项目片段分组与新建用）
+ * @param props.language 当前编辑器文件绑定的语言 id（新建默认语言 / 插入过滤）
+ * @param props.languages 可选语言目录（来自 monaco.languages.getLanguages；缺省用内置常量）
+ * @param props.onOpenFile 在编辑界面打开片段文件回调(absPath)
+ * @param props.onInsert 插入片段回调(entry)
+ * @param props.onClose 关闭回调
+ * @returns 浮层 React 元素
+ */
+export function SnippetsPicker(props) {
+  const mode = props?.mode === 'insert' ? 'insert' : 'configure'
+  const sessionId = props?.sessionId
+  const cwd = props?.cwd
+  const currentLanguage = String(props?.language ?? '').trim().toLowerCase()
+  const options = React.useMemo(() => languageOptions(props?.languages), [props?.languages])
+  const onOpenFile = props?.onOpenFile
+  const onInsert = props?.onInsert
+  const onClose = props?.onClose
+
+  const [data, setData] = React.useState(null)
+  const [entries, setEntries] = React.useState(null)
+  const [error, setError] = React.useState('')
+  const [busy, setBusy] = React.useState(false)
+  // 二级弹窗草稿：null=未打开；否则 { scope, language, fileName, edited }
+  const [draft, setDraft] = React.useState(null)
+  const aliveRef = React.useRef(true)
+
+  const isInsert = mode === 'insert'
+
+  /** 拉取数据：管理模式取文件列表，插入模式取当前语言条目。 */
+  const load = React.useCallback(() => {
+    if (isInsert) {
+      listSnippetsFor(currentLanguage).then((list) => {
+        if (!aliveRef.current) return
+        setEntries(list)
+        setError('')
+      }).catch((e) => { if (aliveRef.current) setError('读取代码片段失败：' + String(e)) })
+      return
+    }
+    rpc('snippets.list', {}).then((res) => {
+      if (!aliveRef.current) return
+      if (res && res.ok) { setData(res); setError('') }
+      else setError(res?.error ?? '读取代码片段失败')
+    }).catch((e) => { if (aliveRef.current) setError('读取代码片段失败：' + String(e)) })
+  }, [isInsert, currentLanguage])
+
+  React.useEffect(() => {
+    aliveRef.current = true
+    load()
+    return () => { aliveRef.current = false }
+  }, [load])
+
+  // Esc：二级弹窗优先关闭（二级 → 一级），避免一次按键直接退出整个流程
+  React.useEffect(() => {
+    const onKey = (event) => {
+      if (event.key !== 'Escape') return
+      if (draft) closeDraft()
+      else onClose?.()
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, true)
+  }, [draft, onClose])
+
+  /** 打开二级弹窗（按 scope + 语言新建）。 */
+  const openDraft = (scope, language) => {
+    setDraft({ scope, language, fileName: snippetFileNameFor(language), edited: false })
+    setError('')
+  }
+
+  /** 关闭二级弹窗（回到一级浮窗）。 */
+  const closeDraft = () => {
+    setDraft(null)
+    setError('')
+  }
+
+  /** 改语言：文件名未手改过则跟随语言联动（手改过则尊重用户输入）。 */
+  const pickLanguage = (language) => {
+    setDraft((prev) => (prev ? { ...prev, language, fileName: prev.edited ? prev.fileName : snippetFileNameFor(language) } : prev))
+  }
+
+  /** 改文件名：标记为手改，之后不再被语言联动覆盖。 */
+  const editFileName = (value) => {
+    setDraft((prev) => (prev ? { ...prev, fileName: value, edited: true } : prev))
+  }
+
+  /**
+   * 创建并打开片段文件（二级弹窗提交）。
+   * @author ddj 2026年09月10号
+   */
+  const createFile = () => {
+    if (!draft) return
+    const name = normalizeSnippetFileName(draft.fileName)
+    if (!name) { setError('文件名不能为空'); return }
+    if (draft.scope === 'project' && !cwd) { setError('当前会话没有工作区，无法新建项目片段'); return }
+    setBusy(true)
+    setError('')
+    rpc('snippets.save', {
+      scope: draft.scope,
+      workspacePath: draft.scope === 'project' ? cwd : undefined,
+      file: name,
+      content: snippetFileTemplate(draft.language),
+    }).then((res) => {
+      if (!aliveRef.current) return
+      if (!res || !res.ok) { setError(res?.error ?? '新建失败'); return }
+      invalidateSnippets()
+      closeDraft()
+      onOpenFile?.(res.file.absPath)
+      onClose?.()
+    }).catch((e) => { if (aliveRef.current) setError('新建失败：' + String(e)) })
+      .finally(() => { if (aliveRef.current) setBusy(false) })
+  }
+
+  /** 打开片段文件（在编辑界面打开，浮窗关闭）。 */
+  const openFile = (info) => {
+    onOpenFile?.(info.absPath)
+    onClose?.()
+  }
+
+  /** 删除片段文件（confirm 后走 snippets.remove）。 */
+  const removeFile = (info) => {
+    if (!window.confirm('删除代码片段文件 ' + info.file + '？（不可恢复）')) return
+    rpc('snippets.remove', { scope: info.scope, workspacePath: info.scope === 'project' ? cwd : undefined, file: info.file })
+      .then((res) => {
+        if (!aliveRef.current) return
+        if (!res || !res.ok) { setError(res?.error ?? '删除失败'); return }
+        invalidateSnippets()
+        load()
+      }).catch((e) => { if (aliveRef.current) setError('删除失败：' + String(e)) })
+  }
+
+  /** 一级浮窗主体：列表 / 空态 / 错误。 */
+  const renderBody = () => {
+    if (error && !draft) return React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error)
+    if (isInsert) {
+      const list = entries ?? []
+      if (!list.length) {
+        return React.createElement('div', { className: 'vsm-mcp-empty' },
+          entries === null ? '正在读取代码片段…' : '当前文件没有可用代码片段，可用「代码片段：配置代码片段」新建')
+      }
+      return React.createElement('div', { className: 'edrv-snip-list' }, list.map((entry) => React.createElement('button', {
+        key: entry.scope + ':' + entry.file + ':' + entry.key,
+        className: 'edrv-snip-row',
+        onClick: () => { onInsert?.(entry); onClose?.() },
+      },
+        React.createElement('span', { className: 'edrv-snip-row-main' },
+          React.createElement('span', { className: 'edrv-snip-label' }, entry.prefix || entry.key),
+          React.createElement('span', { className: 'edrv-snip-desc' }, entry.description || entry.key)),
+        React.createElement('span', { className: 'edrv-snip-src' }, entry.file))))
+    }
+    if (!data) return React.createElement('div', { className: 'vsm-mcp-empty' }, '正在读取代码片段…')
+    const project = (data.projects ?? []).find((item) => item.workspacePath === cwd) ?? null
+    /** 行按语言再按文件名排序，同语言片段聚在一起（便于按文件类型找片段）。 */
+    const sortByLanguage = (list) => [...list].sort((a, b) =>
+      String(a.language).localeCompare(String(b.language)) || String(a.file).localeCompare(String(b.file)))
+    const rows = (list) => sortByLanguage(list).map((info) => React.createElement('div', { key: info.scope + ':' + info.file, className: 'edrv-snip-row' },
+      React.createElement('button', { className: 'edrv-snip-row-main', title: info.absPath, onClick: () => openFile(info) },
+        React.createElement('span', { className: 'edrv-snip-label' }, info.file),
+        React.createElement('span', { className: 'edrv-snip-desc' }, fileMeta(info))),
+      info.error ? React.createElement('span', { className: 'vsm-mcp-chip edrv-snip-warn' }, 'JSON 解析失败') : null,
+      React.createElement('button', { className: 'edrv-snip-act edrv-snip-danger', title: '删除', onClick: () => removeFile(info) }, '⌫')))
+    const globalRows = rows(data.user ?? [])
+    const projectRows = project ? rows(project.files ?? []) : []
+    return React.createElement('div', { className: 'edrv-snip-list' },
+      React.createElement('div', { className: 'edrv-snip-group' }, '全局代码片段（~/.dsh/snippets/）'),
+      globalRows.length ? globalRows : React.createElement('div', { className: 'edrv-snip-empty' }, '还没有全局代码片段'),
+      React.createElement('div', { className: 'edrv-snip-group' }, '项目代码片段' + (cwd ? '（' + cwd + '）' : '')),
+      projectRows.length
+        ? projectRows
+        : React.createElement('div', { className: 'edrv-snip-empty' }, cwd ? '当前项目没有代码片段' : '当前会话没有工作区'))
+  }
+
+  /** 当前文件语言提示行（让「片段绑定到哪种文件」一目了然）。 */
+  const languageBar = React.createElement('div', { className: 'edrv-snip-langbar' },
+    currentLanguage
+      ? React.createElement(React.Fragment, null,
+          '当前文件语言：',
+          React.createElement('b', null, languageLabelOf(currentLanguage)),
+          '（' + currentLanguage + '）')
+      : '当前没有打开文件：可新建全语言片段，或先打开文件再新建对应语言的片段')
+
+  const dialog = React.createElement('div', { className: 'edrv-snip-mask', onClick: () => onClose?.() },
+    React.createElement('div', { className: 'vsm-mcp-dialog edrv-snip-dialog', onClick: (event) => event.stopPropagation() },
+      React.createElement('h3', null, isInsert ? '插入代码片段' : '代码片段：配置代码片段'),
+      React.createElement('p', { className: 'edrv-snip-hint' }, isInsert
+        ? '仅列出对当前文件语言生效的片段（选定后在光标处展开，支持 ${1:占位} 与 $TM_FILENAME 等变量）。'
+        : '代码片段按语言绑定：`<语言>.code-snippets` 只对该类文件生效，`global.code-snippets` 对所有文件生效。选中文件即在编辑界面打开。'),
+      isInsert ? null : languageBar,
+      renderBody(),
+      isInsert
+        ? null
+        : React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+            React.createElement('button', {
+              disabled: busy,
+              onClick: () => openDraft('user', ''),
+            }, '新建全语言片段…'),
+            React.createElement('button', {
+              className: 'vsm-primary',
+              disabled: busy || !currentLanguage,
+              title: currentLanguage ? '' : '请先打开一个文件，或改用「新建全语言片段…」',
+              onClick: () => openDraft('user', currentLanguage),
+            }, currentLanguage ? '新建 ' + languageLabelOf(currentLanguage) + ' 片段文件…' : '新建当前语言片段…'),
+            React.createElement('button', {
+              disabled: busy || !cwd,
+              title: cwd ? '' : '当前会话没有工作区',
+              onClick: () => openDraft('project', currentLanguage),
+            }, '新建项目片段文件…'))))
+
+  // 二级弹窗：新建片段文件（语言 + 文件名；叠在一级浮窗之上的独立遮罩）
+  const createDialog = draft
+    ? React.createElement('div', { className: 'edrv-snip-mask edrv-snip-mask-top', onClick: closeDraft },
+        React.createElement('div', { className: 'vsm-mcp-dialog edrv-snip-dialog', onClick: (event) => event.stopPropagation() },
+          React.createElement('h3', null, draft.scope === 'project' ? '新建项目代码片段文件' : '新建全局代码片段文件'),
+          React.createElement('label', null, '生效语言',
+            React.createElement('select', {
+              value: draft.language,
+              disabled: busy,
+              onChange: (event) => { pickLanguage(event.target.value); setError('') },
+            }, options.map((item) => React.createElement('option', { key: 'lang-' + item.id, value: item.id }, item.label)))),
+          React.createElement('label', null, '文件名',
+            React.createElement('input', {
+              autoFocus: true,
+              spellCheck: false,
+              value: draft.fileName,
+              placeholder: snippetFileNameFor(draft.language),
+              onChange: (event) => { editFileName(event.target.value); setError('') },
+              onKeyDown: (event) => { if (event.key === 'Enter') createFile() },
+            })),
+          React.createElement('div', { className: 'edrv-snip-hint' },
+            (draft.scope === 'project' ? '将写入 ' + (cwd ?? '') + '/.dsh/snippets/' : '将写入 ~/.dsh/snippets/')
+            + normalizeSnippetFileName(draft.fileName)
+            + (draft.language
+                ? '（仅对 ' + languageLabelOf(draft.language) + ' 文件生效）'
+                : '（对所有文件生效）')),
+          error ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error) : null,
+          React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+            React.createElement('button', { disabled: busy, onClick: closeDraft }, '取消'),
+            React.createElement('button', { className: 'vsm-primary', disabled: busy, onClick: createFile }, busy ? '创建中…' : '创建并打开'))))
+    : null
+
+  // 根节点必须带 data-edrv-view：editor.css 浮层样式均以此为作用域前缀
+  return createPortal(React.createElement('div', { 'data-edrv-view': '1' }, dialog, createDialog), document.body)
+}

package/src/client/ui/commandCatalog.ts

@@ -76,6 +76,20 @@ function prevEditorRowDef(): CommandDef {
   }
 }
 
+/**
+ * 添加选中内容为引用（把当前选区追加进对话输入框；无选区则状态栏提示）。
+ * 有活动编辑器模型才可用，保证对话框内按 Ctrl+U 不被本命令吞掉。
+ * @author ddj 2026年09月10号
+ * @returns 命令定义
+ */
+function addSelectionRefDef(): CommandDef {
+  return {
+    id: 'edrv.addSelectionRef', label: '添加选中内容为引用', category: '编辑', order: 10,
+    keybinding: 'Ctrl+U', available: needsModel,
+    run: () => emit('addSelectionRef'),
+  }
+}
+
 /**
  * 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
  * 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
@@ -143,6 +157,16 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
     available: needsModel,
     run: () => emit('openInExplorer'),
   },
+  {
+    id: 'edrv.configureSnippets', label: '代码片段：配置代码片段', category: '代码片段', order: 10,
+    available: alwaysAvailable,
+    run: () => emit('configureSnippets'),
+  },
+  {
+    id: 'edrv.insertSnippet', label: '插入代码片段', category: '代码片段', order: 20,
+    available: needsModel,
+    run: () => emit('insertSnippet'),
+  },
 ]
 
 /**
@@ -153,6 +177,7 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
 export const BRIDGE_COMMANDS: readonly CommandDef[] = [
   nextEditorRowDef(),
   prevEditorRowDef(),
+  addSelectionRefDef(),
 ]
 
 /**

package/src/rpc.ts

@@ -31,6 +31,7 @@ import type { ContentSearcher } from './search/content.js'
 import { newContentSearcher } from './search/content.js'
 import { restoreFile, revertCall, revertHunk } from './revert.js'
 import { rulesList, rulesRead, rulesRemove, rulesSave, rulesToggle } from './rules.js'
+import { isSnippetFilePath, snippetsEntries, snippetsList, snippetsRead, snippetsRemove, snippetsSave } from './snippets.js'
 import { listMcp, refreshMcp, removeMcp, saveMcp, toggleMcp } from './mcp.js'
 import { listProjects, projectRefresh, projectRemove, projectSave, projectToggle } from './mcpProject.js'
 import { normalizeFileOpenTool, FILE_OPEN_DEFAULT, FILE_OPEN_SETTINGS_NS } from './fileOpenSettings.js'
@@ -86,6 +87,24 @@ async function requireSession(ctx: Ctx, sessionId: string | undefined): Promise<
   return { session, cwd }
 }
 
+/** 片段文件保存时的沙箱策略：用户显式 GUI 写操作，放开到 danger-full-access（镜像 rules.fullPolicy）。 */
+function snippetPolicy(ctx: Ctx): unknown {
+  const svc = ctx.get('sandboxPolicy')
+  if (!svc || typeof svc.resolve !== 'function') return undefined
+  return svc.resolve({ mode: 'danger-full-access' })
+}
+
+/**
+ * 片段文件路径解析：命中全局片段目录（~/.dsh/snippets）返回归一化绝对路径，否则 null。
+ * 全局片段位于工作区之外，edrv.read / edrv.save 需绕开 resolveTarget 的 cwd 语义直读直写。
+ * @author ddj 2026年09月10号
+ * @param path 客户端请求路径（绝对路径）
+ * @returns 归一化后的绝对路径或 null
+ */
+function snippetTargetOf(path: string): string | null {
+  return isSnippetFilePath(path) ? path.replace(/\\/g, '/') : null
+}
+
 /**
  * 手动保存收尾（edrv.save / edrv.saveBinary 共用）：目录树失效 + 该路径 pending
  * 文本差异记录标记 superseded 并归档（旧文本 diff 不得再应用到新内容上）。
@@ -258,6 +277,16 @@ export function buildHandlers(
       return { ok: true, results }
     },
     'edrv.read': async (args) => {
+      // 全局片段文件（~/.dsh/snippets/*.code-snippets）在工作区之外：直读，不走会话 cwd 解析
+      const snippetTarget = snippetTargetOf(args.path)
+      if (snippetTarget && args.encoding !== 'base64') {
+        try {
+          const content = await readFile(snippetTarget, 'utf8')
+          return { ok: true, content, size: content.length }
+        } catch (error) {
+          return { ok: false, error: '读取片段文件失败：' + String(error), resolvedPath: snippetTarget }
+        }
+      }
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
       const fs = ctx.get('fs')
@@ -309,6 +338,16 @@ export function buildHandlers(
       }
     },
     'edrv.save': async (args) => {
+      // 全局片段文件：直写（工作区外），且不进差异审查（片段变更不是 agent 编辑产物）
+      const snippetTarget = snippetTargetOf(args.path)
+      if (snippetTarget) {
+        try {
+          await writeFile(snippetTarget, args.content, 'utf8')
+          return { ok: true }
+        } catch (error) {
+          return { ok: false, error: '保存片段文件失败：' + String(error) }
+        }
+      }
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
       const fs = ctx.get('fs')
@@ -770,6 +809,45 @@ export function buildHandlers(
         return { ok: false, error: '切换规则失败：' + String(error) }
       }
     },
+    'snippets.list': async () => {
+      try {
+        return { ok: true, ...(await snippetsList(ctx)) }
+      } catch (error) {
+        return { ok: false, error: '读取代码片段失败：' + String(error) }
+      }
+    },
+    'snippets.read': async (args) => {
+      try {
+        return { ok: true, content: await snippetsRead(ctx, args) }
+      } catch (error) {
+        return { ok: false, error: '读取代码片段失败：' + String(error) }
+      }
+    },
+    'snippets.save': async (args) => {
+      try {
+        return { ok: true, file: await snippetsSave(ctx, args) }
+      } catch (error) {
+        return { ok: false, error: '保存代码片段失败：' + String(error) }
+      }
+    },
+    'snippets.remove': async (args) => {
+      try {
+        await snippetsRemove(ctx, args)
+        return { ok: true }
+      } catch (error) {
+        return { ok: false, error: '删除代码片段失败：' + String(error) }
+      }
+    },
+    'snippets.entries': async (args) => {
+      try {
+        // 当前会话工作区用于叠加项目片段；会话缺失时仅返回全局片段（不报错，补全仍可用）
+        const sc = await requireSession(ctx, args.sessionId)
+        const cwd = 'err' in sc ? undefined : sc.cwd
+        return { ok: true, ...(await snippetsEntries(ctx, cwd)) }
+      } catch (error) {
+        return { ok: false, error: '读取代码片段条目失败：' + String(error) }
+      }
+    },
   }
 }
 

package/src/shared/keybindings.ts

@@ -23,6 +23,8 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   'edrv.showCommands': 'Ctrl+Shift+P|F1',
   'edrv.nextEditorRow': 'Ctrl+Alt+ArrowDown',
   'edrv.prevEditorRow': 'Ctrl+Alt+ArrowUp',
+  // 添加选中内容为引用：把当前选区追加进对话输入框（Ctrl+U，VS Code 同款）
+  'edrv.addSelectionRef': 'Ctrl+U',
 }
 
 /**