dsh-vscode-mode 0.1.63 → 0.3.0

package/src/client/ui/commandCatalog.ts

@@ -0,0 +1,204 @@
+/**
+ * dsh-vscode-mode client — 编辑器指令目录（纯元数据）。
+ * 「一条命令 = 一条注册数据」：命令栏、快捷键设置页、快捷键监听与 Monaco 右键菜单
+ * 全部从本表读取；新增一条能力只需在 EDITOR_COMMANDS 追加一项（可选 keybinding）。
+ * run 只派发 `edrv.command.*` 窗口事件，不直接触碰 React/Monaco（`edrv.command.` 前缀
+ * 与既有 `edrv:` 刷新/主题事件分属不同命名空间，互不干扰）。
+ * 作者 ddj 2026年09月10号
+ */
+import { hasEditorModel } from '../editorModelState.js'
+
+/** 一条编辑器指令（展示 + 执行 + 可用性）。 */
+export interface CommandDef {
+  /** 稳定命令 id（`edrv.` 前缀；第三方注册请避让该前缀）。 */
+  id: string
+  /** 命令栏与设置页展示名。 */
+  label: string
+  /** 命令栏分组名。 */
+  category: string
+  /** 组内排序（小者优先）。 */
+  order?: number
+  /** 默认键位弦（可选；可含 `|` 多候选）。声明后由快捷键设置页展示与录制。 */
+  keybinding?: string
+  /** 运行体：派发窗口事件或直接执行。 */
+  run: () => void
+  /** 可用性判定（缺省视为始终可用；返回 false 时命令栏隐藏且 run 被拒）。 */
+  available?: () => boolean
+}
+
+/**
+ * 派发编辑器命令事件（`edrv.command.<action>`）。
+ * 无 window 的运行环境（纯 Node 单测）静默跳过，命令本身不因此失败。
+ * @author ddj 2026年09月10号
+ * @param action 动作名（不含前缀）
+ */
+function emit(action: string): void {
+  if (typeof window === 'undefined') return
+  window.dispatchEvent(new CustomEvent('edrv.command.' + action))
+}
+
+/** 编辑器命令事件名前缀（EditorView / QuickOpen / 第三方据此监听）。 */
+export const COMMAND_EVENT_PREFIX = 'edrv.command.'
+
+/** 需要活动编辑器模型才可用的命令（命令栏隐藏并拒绝执行）。 */
+function needsModel(): boolean {
+  return hasEditorModel()
+}
+
+/** 面板区显隐切换始终可用（未挂载编辑器时 run 为空操作）。 */
+function alwaysAvailable(): boolean {
+  return true
+}
+
+/**
+ * 光标整行下移（编辑行导航）。
+ * @author ddj 2026年09月10号
+ * @returns 命令定义
+ */
+function nextEditorRowDef(): CommandDef {
+  return {
+    id: 'edrv.nextEditorRow', label: '下一编辑行（光标整行下移）', category: '导航', order: 50,
+    keybinding: 'Ctrl+Alt+ArrowDown', available: needsModel,
+    run: () => emit('nextEditorRow'),
+  }
+}
+
+/**
+ * 光标整行上移（编辑行导航）。
+ * @author ddj 2026年09月10号
+ * @returns 命令定义
+ */
+function prevEditorRowDef(): CommandDef {
+  return {
+    id: 'edrv.prevEditorRow', label: '上一编辑行（光标整行上移）', category: '导航', order: 60,
+    keybinding: 'Ctrl+Alt+ArrowUp', available: needsModel,
+    run: () => emit('prevEditorRow'),
+  }
+}
+
+/**
+ * 添加选中内容为引用（把当前选区追加进对话输入框；无选区则状态栏提示）。
+ * 有活动编辑器模型才可用，保证对话框内按 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 监听（历史实现），
+ * 故不进 BRIDGE_COMMANDS，避免同一按键双执行。
+ * @author ddj 2026年09月10号
+ */
+export const EDITOR_COMMANDS: readonly CommandDef[] = [
+  {
+    id: 'edrv.save', label: '保存文件', category: '文件', order: 10,
+    keybinding: 'Ctrl+S', available: needsModel,
+    run: () => emit('save'),
+  },
+  {
+    id: 'edrv.quickOpen', label: '快速打开文件', category: '文件', order: 20,
+    keybinding: 'Ctrl+P', available: alwaysAvailable,
+    run: () => emit('quickOpen'),
+  },
+  {
+    id: 'edrv.toggleSidebar', label: '切换侧边栏', category: '视图', order: 10,
+    keybinding: 'Ctrl+B', available: alwaysAvailable,
+    run: () => emit('toggleSidebar'),
+  },
+  {
+    id: 'edrv.searchInFiles', label: '在工作区中搜索', category: '视图', order: 20,
+    keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
+    run: () => emit('searchInFiles'),
+  },
+  {
+    id: 'edrv.navigateBack', label: '后退（导航历史）', category: '导航', order: 10,
+    keybinding: 'Alt+ArrowLeft|Ctrl+Alt+-', available: needsModel,
+    run: () => emit('navigateBack'),
+  },
+  {
+    id: 'edrv.navigateForward', label: '前进（导航历史）', category: '导航', order: 20,
+    keybinding: 'Alt+ArrowRight|Ctrl+Shift+-', available: needsModel,
+    run: () => emit('navigateForward'),
+  },
+  {
+    id: 'edrv.nextTab', label: '下一个页签', category: '导航', order: 30,
+    keybinding: 'Ctrl+Alt+ArrowRight|Ctrl+PageDown', available: needsModel,
+    run: () => emit('nextTab'),
+  },
+  {
+    id: 'edrv.prevTab', label: '上一个页签', category: '导航', order: 40,
+    keybinding: 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp', available: needsModel,
+    run: () => emit('prevTab'),
+  },
+  {
+    id: 'edrv.goToDefinition', label: '转到定义', category: '语言智能', order: 10,
+    available: needsModel,
+    run: () => emit('goToDefinition'),
+  },
+  {
+    id: 'edrv.findReferences', label: '查找所有引用', category: '语言智能', order: 20,
+    available: needsModel,
+    run: () => emit('findReferences'),
+  },
+  {
+    id: 'edrv.triggerAi', label: '触发 AI 内联补全', category: '语言智能', order: 30,
+    available: needsModel,
+    run: () => emit('triggerAi'),
+  },
+  {
+    id: 'edrv.openInExplorer', label: '在文件浏览器中打开', category: '文件', order: 30,
+    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'),
+  },
+]
+
+/**
+ * 桥接派发指令（无原生监听，键位由 commandBridge 统一 capture 处理）。
+ * 新增「只填目录、不写监听」的编辑器指令一律放这里：键位、命令栏、设置页自动可用。
+ * @author ddj 2026年09月10号
+ */
+export const BRIDGE_COMMANDS: readonly CommandDef[] = [
+  nextEditorRowDef(),
+  prevEditorRowDef(),
+  addSelectionRefDef(),
+]
+
+/**
+ * 命令栏自身的命令（避免循环依赖，由 commandBridge 注入 run 后注册）。
+ * @author ddj 2026年09月10号
+ * @param run 打开命令栏
+ * @returns 命令定义
+ */
+export function showCommandsDef(run: () => void): CommandDef {
+  return {
+    id: 'edrv.showCommands', label: '显示所有命令', category: '视图', order: 1,
+    keybinding: 'Ctrl+Shift+P|F1', available: alwaysAvailable, run,
+  }
+}
+
+/**
+ * 需要全局键位派发的指令（桥接类 + 命令栏自身；不含 EditorView/QuickOpen 原生监听的那些）。
+ * @author ddj 2026年09月10号
+ * @param showCommands 命令栏命令定义
+ * @returns 派发集合
+ */
+export function dispatchedCommands(showCommands: CommandDef): readonly CommandDef[] {
+  return [...BRIDGE_COMMANDS, showCommands]
+}

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

@@ -3,7 +3,9 @@
  * 纯数据模块：host（settings schema 默认值）与 client（执行匹配/设置页）共用。
  * 键位格式：修饰符 + 主键，`+` 连接，如 `Ctrl+Shift+F`；空串 = 未绑定；
  * `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
- * 作者 ddj 2026年08月26号
+ * 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
+ * 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
+ * 作者 ddj 2026年08月26号 / 2026年09月10号
  */
 
 /** 命令 id → 默认键位（可为多候选）。命令目录以此为准，新增命令只需加一项。 */
@@ -17,6 +19,12 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
   'edrv.nextTab': 'Ctrl+Alt+ArrowRight|Ctrl+PageDown',
   'edrv.prevTab': 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp',
+  // 命令栏（Ctrl+Shift+P 主候选；F1 为 VS Code 同款第二候选）与编辑行导航
+  'edrv.showCommands': 'Ctrl+Shift+P|F1',
+  'edrv.nextEditorRow': 'Ctrl+Alt+ArrowDown',
+  'edrv.prevEditorRow': 'Ctrl+Alt+ArrowUp',
+  // 添加选中内容为引用：把当前选区追加进对话输入框（Ctrl+U，VS Code 同款）
+  'edrv.addSelectionRef': 'Ctrl+U',
 }
 
 /**

package/src/shared/rpc.ts

@@ -16,6 +16,7 @@ import type { MpcConfig, MpcProject, MpcProjectSaveInput, MpcServer } from './mc
 import type { CompatReport, DevFormInfo } from './compat.js'
 import type { ShellIntegrationStatus, UnityListPayload, UnityProjectEntry } from './integration.js'
 import type { RuleInfo, RuleProject, RuleRefInput, RuleSaveInput } from './rules.js'
+import type { SnippetEntry, SnippetInfo, SnippetProject, SnippetRefInput, SnippetSaveInput } from './snippets.js'
 import type { LspEnvInstallState, LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspSemanticTokens, LspServerStatus, LspSymbol } from './lsp.js'
 import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiInlineResult } from './ai.js'
 
@@ -236,6 +237,11 @@ export interface RpcRequestMap {
   'rules.save': RuleSaveInput
   'rules.remove': RuleRefInput
   'rules.toggle': RuleRefInput & { enabled: boolean }
+  'snippets.list': {}
+  'snippets.read': SnippetRefInput
+  'snippets.save': SnippetSaveInput
+  'snippets.remove': SnippetRefInput
+  'snippets.entries': { sessionId?: string }
 }
 
 export type RpcMethod = keyof RpcRequestMap
@@ -324,6 +330,11 @@ export interface RpcOkMap {
   'rules.save': { rule: RuleInfo }
   'rules.remove': object
   'rules.toggle': { rule: RuleInfo }
+  'snippets.list': { user: SnippetInfo[]; projects: SnippetProject[] }
+  'snippets.read': { content: string }
+  'snippets.save': { file: SnippetInfo }
+  'snippets.remove': object
+  'snippets.entries': { entries: SnippetEntry[] }
 }
 
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */

package/src/shared/snippets.ts

@@ -0,0 +1,156 @@
+/**
+ * dsh-vscode-mode 代码片段共享数据契约（VS Code 兼容 .code-snippets 文件）。
+ * 纯类型模块：禁 node/react 导入（与 shared/rules.ts 同约束）。
+ * 文件格式与 VS Code 一致：顶层对象 { "<片段名>": { prefix, body, description?, scope? } }，
+ * body 可为字符串或字符串数组（数组按行拼接）；scope 为语言 id 或语言 id 数组。
+ * 作者 ddj 2026年09月10号
+ */
+
+/** 片段作用域：全局片段（~/.dsh/snippets）或项目片段（<工作区>/.dsh/snippets）。 */
+export type SnippetScope = 'user' | 'project'
+
+/** 一个 .code-snippets 文件的元信息（列表行展示 + 补全索引所需的最小集）。 */
+export interface SnippetInfo {
+  scope: SnippetScope
+  /** 文件名（含 .code-snippets 后缀，不含路径）。 */
+  file: string
+  /** 绝对路径（host 解析，供展示与在编辑界面打开）。 */
+  absPath: string
+  /** 相对提示（用户层 snippets/ 或项目层 .dsh/snippets/）。 */
+  relHint: string
+  /** 由文件名推导的语言 id（`global`/无法识别为空串 = 全语言生效）。 */
+  language: string
+  /** 文件内片段条目数（解析失败为 0）。 */
+  count: number
+  /** 文件字节数（列表排序/超大提示用）。 */
+  size: number
+  /** 修改时间毫秒。 */
+  mtime: number
+  /** JSON 解析失败文案（仅 UI 提示，不影响其他文件）。 */
+  error?: string
+}
+
+/** 一个工作区的项目片段聚合（snippets.list 的 projects 项）。 */
+export interface SnippetProject {
+  workspacePath: string
+  title: string
+  files: SnippetInfo[]
+  /** 工作区目录不存在或无片段目录时为 true（UI 显示空态而非报错）。 */
+  missingDir?: boolean
+}
+
+/** 片段文件读取/删除入参公共字段。 */
+export interface SnippetRefInput {
+  scope: SnippetScope
+  /** project 必填：目标工作区绝对路径（须为 DSH 已注册 workspace）。 */
+  workspacePath?: string
+  file: string
+}
+
+/** 片段文件保存入参：content 为完整 JSON 文本（host 原样写盘）。 */
+export interface SnippetSaveInput {
+  scope: SnippetScope
+  workspacePath?: string
+  file: string
+  content: string
+}
+
+/** 一条已展开的片段条目（补全 provider 与插入命令共用）。 */
+export interface SnippetEntry {
+  /** 片段名（对象键，补全候选的 label）。 */
+  key: string
+  /** 触发前缀（VS Code prefix；空串表示仅靠描述/手动插入）。 */
+  prefix: string
+  /** 展开正文（已按数组形式拼接为含换行的字符串）。 */
+  body: string
+  /** 片段描述（补全候选的说明，缺省为空串）。 */
+  description: string
+  scope: SnippetScope
+  /** 来源文件名（补全候选 detail 展示）。 */
+  file: string
+  /** 生效语言 id（空串 = 全语言）。 */
+  language: string
+}
+
+// --region 文件名与模板（纯函数：host 与 client 共用，避免两处漂移）
+/** 全语言生效的文件名（无语言前缀）。 */
+export const SNIPPET_GLOBAL_FILE = 'global.code-snippets'
+/** 片段文件后缀。 */
+export const SNIPPET_EXT = '.code-snippets'
+
+/**
+ * 语言 id → 默认片段文件名（空语言回退 global）。
+ * @author ddj 2026年09月10号
+ * @param language 语言 id
+ * @returns 文件名（如 `lua.code-snippets`）
+ */
+export function snippetFileNameFor(language: string): string {
+  const lang = String(language ?? '').trim().toLowerCase()
+  return (lang || 'global') + SNIPPET_EXT
+}
+
+/**
+ * 归一化新建文件名：用户输入可为裸语言名（补后缀）或完整文件名；空输入为空串。
+ * @author ddj 2026年09月10号
+ * @param raw 用户输入
+ * @returns 归一化后的文件名
+ */
+export function normalizeSnippetFileName(raw: string): string {
+  const text = String(raw ?? '').trim()
+  if (!text) return ''
+  return text.toLowerCase().endsWith(SNIPPET_EXT) ? text : text + SNIPPET_EXT
+}
+
+/**
+ * 新建片段文件模板（一条示例，改 body 即可用）。
+ * @author ddj 2026年09月10号
+ * @param language 目标语言 id（空串 = 全局）
+ * @returns JSON 文本（带尾换行）
+ */
+export function snippetFileTemplate(language: string): string {
+  const lang = String(language ?? '').trim().toLowerCase()
+  const sample = (lang || 'global') + ' 示例片段'
+  return JSON.stringify({
+    [sample]: {
+      prefix: 'hello',
+      body: ['// ' + (lang || 'global') + ' 片段示例', '$1'],
+      description: '示例：输入 hello 后 Tab 展开',
+    },
+  }, null, 2) + '\n'
+}
+
+/**
+ * 可绑定语言目录（新建片段时的语言下拉来源；与 client/monaco/loader 的 LANG_BY_EXT
+ * 取值集合保持一致）。此处冗余一份纯数据，使本模块不依赖浏览器端 Monaco
+ * （shared 禁 import client 侧模块）；一致性由 tests/snippetLanguage.test.ts 断言兜底。
+ */
+export const SNIPPET_LANGUAGES: readonly string[] = [
+  'c', 'cpp', 'csharp', 'css', 'dart', 'dockerfile', 'go', 'html', 'ini', 'java',
+  'javascript', 'json', 'jsonc', 'kotlin', 'less', 'lua', 'markdown', 'mdx', 'php',
+  'plaintext', 'powershell', 'python', 'ruby', 'rust', 'scss', 'shell', 'sql',
+  'swift', 'typescript', 'xml', 'yaml',
+]
+
+/** 语言 id → 展示名（仅收录写法与 id 明显不同的；未收录的原样返回）。 */
+const LANGUAGE_LABELS: Record<string, string> = {
+  cpp: 'C++',
+  csharp: 'C#',
+  javascript: 'JavaScript',
+  typescript: 'TypeScript',
+  jsonc: 'JSON with Comments',
+  powershell: 'PowerShell',
+  plaintext: '纯文本',
+}
+
+/**
+ * 语言 id 的人类可读名（用于下拉与「新建 xx 代码片段文件」文案）。
+ * @author ddj 2026年09月10号
+ * @param id 语言 id（空串表示全语言）
+ * @returns 展示名
+ */
+export function languageLabelOf(id: string): string {
+  const key = String(id ?? '').trim().toLowerCase()
+  if (!key) return '全语言'
+  return LANGUAGE_LABELS[key] ?? key
+}
+// --endregion