dsh-vscode-mode 0.22.0 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [

package/src/client/index.ts

@@ -15,6 +15,7 @@
  */
 import React from 'react'
 import './styles/editor.css'
+import './styles/quickmenu.css'
 import { EditorView } from './ui/EditorView.js'
 import { DiffBadge } from './ui/DiffBadge.js'
 import { PerfSizeBadge } from './ui/PerfSizeBadge.js'
@@ -43,6 +44,12 @@ import { SideEditorTab } from './ui/SideEditorTab.js'
 import { OfficialSideTab } from './ui/OfficialSideTab.js'
 import { createClaimRouter } from './ui/ClaimRouter.js'
 import { createAddToConversation } from './addToConversation.js'
+import { createMenuStore } from './quickMenuStore.js'
+import { QuickMenuLauncher } from './ui/QuickMenuLauncher.js'
+import type { QuickMenuHost, QuickSendResult } from './quickMenuHost.js'
+import type { RuleListSnapshot } from '../shared/quickMenu.js'
+import type { SkillCatalog } from '../shared/skillCatalog.js'
+import { toastDom } from './externalOpen.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
 import { createSearchPanel } from './sidebar/panels/index.js'
@@ -285,6 +292,144 @@ export async function apply(ctx: any): Promise<void> {
   /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
   const addToConversation = createAddToConversation(ctx)
 
+  /**
+   * 读取规则列表（rules.list；失败抛错，由快捷菜单按「未校验」降级）。
+   * @author ddj 2026年10月30号
+   * @returns 用户规则 + 项目规则
+   */
+  const loadRules = async (): Promise<RuleListSnapshot> => {
+    const result = await rpc('rules.list', {})
+    if (!result.ok) throw new Error(result.error)
+    return { user: result.user, projects: result.projects }
+  }
+
+  /**
+   * 会话技能枚举服务（remote.skills 动态注入；旧版 DSH 无该服务时保持 null = 「未校验」）。
+   * @author ddj 2026年10月30号
+   */
+  let skillEnumerator: { list?: (req: { sessionId: string }) => Promise<{ skills?: Array<{ name?: string }> }> } | null = null
+
+  /**
+   * 读取会话可见技能名（服务不可用时返回 null，界面按「未校验」处理）。
+   * @author ddj 2026年10月30号
+   * @param sessionId 会话 id
+   * @returns 技能名清单或 null
+   */
+  const loadSkillNames = async (sessionId: string): Promise<string[] | null> => {
+    const list = skillEnumerator?.list
+    if (typeof list !== 'function') return null
+    const result = await list.call(skillEnumerator, { sessionId })
+    // remote 命名空间返回 Typert 信封 { ok, value }，旧版也可能直接给裸值，两种都吃。
+    const payload = (result as { value?: { skills?: Array<{ name?: string }> } }).value ?? (result as { skills?: Array<{ name?: string }> })
+    const names = (payload?.skills ?? []).map((entry) => entry.name).filter((name): name is string => typeof name === 'string')
+    return names
+  }
+
+  /**
+   * 读取技能候选（全局技能 + 当前工作区技能；只读枚举，失败返回 null）。
+   * @author ddj 2026年10月30号
+   * @param cwd 目标工作区（缺省取当前会话作用域）
+   * @returns 技能候选快照；host 无该 RPC 或读取失败时为 null
+   */
+  const loadSkillCatalog = async (cwd?: string): Promise<SkillCatalog | null> => {
+    const target = cwd ?? readSessionScope(ctx).cwd
+    try {
+      const result = await rpc('skills.list', target ? { cwd: target } : {})
+      if (!result.ok) return null
+      return {
+        user: result.user,
+        project: result.project,
+        ...(result.projectRoot ? { projectRoot: result.projectRoot } : {}),
+      }
+    } catch {
+      return null
+    }
+  }
+
+  /**
+   * 确保存在可写入的会话（无会话时新建独立会话）。
+   * @author ddj 2026年10月30号
+   * @returns 会话 id 或错误文案
+   */
+  const ensureSession = async (): Promise<{ id: string } | { error: string }> => {
+    const scope = readSessionScope(ctx)
+    if (scope.sessionId) return { id: scope.sessionId }
+    const draft = await addToConversation.startDraftSession(scope.cwd)
+    if (!draft.ok || !draft.id) return { error: '当前没有可用会话，新建会话也失败了' }
+    return { id: draft.id }
+  }
+
+  /**
+   * 发送快捷菜单文本（优先发到当前会话，会话忙碌时如实回报）。
+   * @author ddj 2026年10月30号
+   * @param text 合成后的消息文本
+   * @returns 是否发送成功
+   */
+  const sendQuickText = async (text: string): Promise<QuickSendResult> => {
+    const session = await ensureSession()
+    if ('error' in session) return { ok: false, message: session.error }
+    const sent = await addToConversation.sendTask(session.id, text)
+    return sent ? { ok: true } : { ok: false, message: '发送被拒绝（会话可能正忙，稍后再点）' }
+  }
+
+  /**
+   * 只把快捷菜单文本填入输入框。
+   * @author ddj 2026年10月30号
+   * @param text 合成后的消息文本
+   * @returns 是否填入成功
+   */
+  const fillQuickText = async (text: string): Promise<QuickSendResult> => {
+    const session = await ensureSession()
+    if ('error' in session) return { ok: false, message: session.error }
+    const outcome = await addToConversation.appendText(session.id, text)
+    if (outcome === 'ok' || outcome === 'busy') return { ok: true }
+    return { ok: false, message: '写入输入框失败（' + outcome + '），请重试' }
+  }
+
+  /** 快捷菜单宿主桥接：菜单组件不直接摸 ctx，规则/技能/发送/工作区都从这里注入。 */
+  const quickMenuHost: QuickMenuHost = {
+    store: createMenuStore({
+      rules: loadRules,
+      skills: loadSkillNames,
+      scope: () => {
+        const scope = readSessionScope(ctx)
+        return { sessionId: scope.sessionId, cwd: scope.cwd }
+      },
+    }),
+    scope: () => {
+      const scope = readSessionScope(ctx)
+      return { sessionId: scope.sessionId, cwd: scope.cwd }
+    },
+    send: sendQuickText,
+    fill: fillQuickText,
+    rules: loadRules,
+    skills: async () => {
+      const scope = readSessionScope(ctx)
+      return scope.sessionId ? loadSkillNames(scope.sessionId) : null
+    },
+    skillCatalog: loadSkillCatalog,
+    readRule: async (binding) => {
+      const result = await rpc('rules.read', {
+        scope: binding.scope,
+        file: binding.file,
+        ...(binding.workspacePath ? { workspacePath: binding.workspacePath } : {}),
+        ...(binding.origin ? { origin: binding.origin } : {}),
+      })
+      if (!result.ok) throw new Error(result.error)
+      return result.content
+    },
+    workspaces: () => (workspaces?.list.getSnapshot().items ?? []).map((item: { path: string; title: string }) => ({ path: item.path, title: item.title })),
+    notify: (message: string) => { toastDom(message) },
+  }
+
+  // 技能枚举是可选服务：按需动态注入，缺失时不影响悬浮按钮与其余功能（旧版 DSH 自然降级）。
+  if (typeof ctx.inject === 'function') {
+    ctx.inject(['remote.skills'], (scope: { remote?: { skills?: typeof skillEnumerator } }) => {
+      skillEnumerator = scope.remote?.skills ?? null
+      void quickMenuHost.store.refreshBindings(true)
+    })
+  }
+
   /**
    * Build applicable client diagnostics from live installation state.
    * @private @author ddj 2026年10月13号
@@ -696,6 +841,27 @@ export async function apply(ctx: any): Promise<void> {
     order: 40,
   }, (props: unknown) => React.createElement(PluginDetailSection, Object.assign({}, props)))
 
+  // 快捷菜单悬浮按钮：挂在 shell.overlay（全框浮层，层本身 click-through，条目自己接管指针）。
+  // 旧版 DSH 没有该槽时 slots.inject 会一直等待而不报错——按钮自然不出现即为「不支持」，
+  // 因此这里不做版本号判断，只按能力探测。
+  ctx.effect(() => {
+    const dispose = registerSlotSafely(ctx, {
+      name: 'shell.overlay',
+      id: 'edrv-quick-menu',
+      order: 120,
+      label: '快捷菜单',
+    }, () => React.createElement(QuickMenuLauncher, { host: quickMenuHost }))
+    return () => {
+      dispose?.()
+      void quickMenuHost.store.flushLauncher()
+    }
+  }, 'vscode-mode: quick menu launcher')
+
+  // 切换会话/工作区后重算绑定状态（规则与技能都跟会话可见性有关）
+  ctx.effect(() => subscribeScope(ctx, () => {
+    void quickMenuHost.store.refreshBindings(true)
+  }), 'vscode-mode: quick menu scope refresh')
+
   // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
   // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。

package/src/client/quickMenuHost.ts

@@ -0,0 +1,46 @@
+/**
+ * dsh-vscode-mode client — 快捷菜单与宿主能力的桥接契约。
+ *
+ * 菜单组件不直接依赖 ctx：规则/技能/工作区列表与「发送到对话」都由 client 入口注入，
+ * 这样菜单可以在无会话、无远程服务时优雅降级（返回 null 或空列表）。
+ * 作者 ddj 2026年10月30号
+ */
+import type { QuickMenuStore, QuickMenuScope } from './quickMenuStore.js'
+import type { RuleBinding, RuleListSnapshot } from '../shared/quickMenu.js'
+import type { SkillCatalog } from '../shared/skillCatalog.js'
+
+/** 宿主提供的发送结果。 */
+export interface QuickSendResult {
+  ok: boolean
+  /** 失败/跳过的说明（直接给用户看）。 */
+  message?: string
+}
+
+/** 工作区精简视图（限定工作区选择用）。 */
+export interface QuickWorkspace {
+  path: string
+  title: string
+}
+
+/** 菜单组件可用的宿主能力。 */
+export interface QuickMenuHost {
+  store: QuickMenuStore
+  /** 当前会话与工作区（每次调用取最新值）。 */
+  scope(): QuickMenuScope
+  /** 发送文本到当前会话（内部负责新建会话兜底）。 */
+  send(text: string): Promise<QuickSendResult>
+  /** 只把文本填入当前输入框（不发送）。 */
+  fill(text: string): Promise<QuickSendResult>
+  /** 规则列表（rules.list）。 */
+  rules(): Promise<RuleListSnapshot>
+  /** 当前会话可见技能名；无会话返回 null（供 validateSkill 判定，与候选列表分开）。 */
+  skills(): Promise<string[] | null>
+  /** 技能候选（全局技能 + 当前工作区技能）；枚举失败返回 null。 */
+  skillCatalog(cwd?: string): Promise<SkillCatalog | null>
+  /** 读取一条规则的正文（内联注入用）。 */
+  readRule(binding: RuleBinding): Promise<string>
+  /** 已注册工作区列表。 */
+  workspaces(): QuickWorkspace[]
+  /** 轻提示。 */
+  notify(text: string): void
+}

package/src/client/quickMenuStore.ts

@@ -0,0 +1,260 @@
+/**
+ * dsh-vscode-mode client — 快捷菜单 store（文档 + 绑定快照 + 坐标防抖）。
+ *
+ * 为什么客户端要 store：菜单在多列里同时展示，多列共享同一份文档与绑定校验结果；
+ * 用外部 store + useSyncExternalStore，避免把整棵树塞进一个组件的 state。
+ * 写入一律「先改内存 → 整体提交 → host 归一后回传」；冲突（其他窗口改过）时重拉，
+ * 不拿本地旧版本覆盖磁盘。
+ * 作者 ddj 2026年10月30号
+ */
+import { defaultDoc, descendantIds, newQuickId, normalizeDoc } from '../shared/quickMenu.js'
+import type { QuickMenuDoc, QuickMenuItem, RuleListSnapshot, ValidateContext } from '../shared/quickMenu.js'
+import { rpc } from './rpc.js'
+
+/** 菜单加载状态。 */
+export interface QuickMenuSnapshot {
+  status: 'idle' | 'loading' | 'ready' | 'error'
+  /** 当前文档（loading/error 时为默认或上次成功的文档）。 */
+  doc: QuickMenuDoc
+  /** 读取/保存失败文案。 */
+  error?: string
+  /** host 读取告警（配置损坏已重置等）。 */
+  warning?: string
+}
+
+/** 当前会话与工作区快照。 */
+export interface QuickMenuScope {
+  sessionId?: string
+  cwd?: string
+}
+
+/** 外部数据加载器（由 client 入口注入，避免 store 依赖 ctx 细节）。 */
+export interface QuickMenuLoaders {
+  /** 读取规则列表（rules.list）。 */
+  rules(): Promise<RuleListSnapshot>
+  /** 读取会话可见技能名；无法枚举时返回 null。 */
+  skills(sessionId: string): Promise<string[] | null>
+  /** 当前会话与工作区（每次调用取最新值）。 */
+  scope(): QuickMenuScope
+}
+
+/** 一次写操作结果。 */
+export interface QuickMenuMutation {
+  ok: boolean
+  error?: string
+}
+
+/** store 对外能力。 */
+export interface QuickMenuStore {
+  subscribe(listener: () => void): () => void
+  /** 版本号（useSyncExternalStore 的快照值）。 */
+  getVersion(): number
+  getState(): QuickMenuSnapshot
+  /** 当前校验上下文（绑定失效判定用）。 */
+  getContext(): ValidateContext
+  load(force?: boolean): Promise<void>
+  save(doc: QuickMenuDoc): Promise<QuickMenuMutation>
+  createItem(draft: QuickMenuItem): Promise<QuickMenuMutation>
+  updateItem(next: QuickMenuItem): Promise<QuickMenuMutation>
+  removeItem(id: string): Promise<QuickMenuMutation>
+  /** 记录悬浮按钮坐标（500ms 防抖落盘）。 */
+  patchLauncher(x: number | null, y: number | null): void
+  /** 立即落盘待写坐标（松手/卸载时调用）。 */
+  flushLauncher(): Promise<void>
+  refreshBindings(force?: boolean): Promise<void>
+  /** 悬浮按钮是否已挂载（= 当前 DSH 具备 shell.overlay）。 */
+  markMounted(mounted: boolean): void
+  isMounted(): boolean
+  /** 生成新项 id。 */
+  nextId(type: 'group' | 'button'): string
+}
+
+/** 绑定快照有效期（菜单打开/聚焦时刷新，期间复用）。 */
+const BINDINGS_TTL_MS = 60_000
+/** 坐标落盘防抖。 */
+const LAUNCHER_DEBOUNCE_MS = 500
+
+/**
+ * 创建快捷菜单 store。
+ * @author ddj 2026年10月30号
+ * @param loaders 外部数据加载器
+ * @returns store 实例
+ */
+export function createMenuStore(loaders: QuickMenuLoaders): QuickMenuStore {
+  let state: QuickMenuSnapshot = { status: 'idle', doc: defaultDoc() }
+  let version = 0
+  let mounted = false
+  const listeners = new Set<() => void>()
+  /** 绑定快照（cwd/sessionId 变化或超期即重拉）。 */
+  let bindings: { at: number; cwd?: string; sessionId?: string; rules?: RuleListSnapshot; skillNames?: string[] | null } = { at: 0 }
+  /** 待落盘坐标与定时器。 */
+  let pending: { x: number | null; y: number | null } | null = null
+  let timer: ReturnType<typeof setTimeout> | null = null
+
+  /**
+   * 写入状态并通知订阅者。
+   * @author ddj 2026年10月30号
+   * @param next 新状态
+   */
+  function publish(next: QuickMenuSnapshot): void {
+    state = next
+    version += 1
+    for (const listener of listeners) listener()
+  }
+
+  /**
+   * 合并补丁到当前状态。
+   * @author ddj 2026年10月30号
+   * @param patch 局部更新
+   */
+  function patch(patchState: Partial<QuickMenuSnapshot>): void {
+    publish({ ...state, ...patchState })
+  }
+
+  /**
+   * 读取规则与技能快照（失败保留旧值，不打断菜单）。
+   * @author ddj 2026年10月30号
+   * @param force 是否强制重拉
+   */
+  async function refreshBindings(force = false): Promise<void> {
+    const scope = loaders.scope()
+    const fresh = !force && Date.now() - bindings.at < BINDINGS_TTL_MS
+    if (fresh && bindings.cwd === scope.cwd && bindings.sessionId === scope.sessionId) return
+    bindings = { ...bindings, at: Date.now(), cwd: scope.cwd, sessionId: scope.sessionId }
+    try {
+      bindings.rules = await loaders.rules()
+    } catch {
+      // 规则服务不可用：保持 undefined（界面显示「未校验」，不误报失效）
+      bindings.rules = undefined
+    }
+    try {
+      bindings.skillNames = scope.sessionId ? await loaders.skills(scope.sessionId) : null
+    } catch {
+      bindings.skillNames = null
+    }
+    version += 1
+    for (const listener of listeners) listener()
+  }
+
+  /**
+   * 拉取文档（并顺带刷新绑定快照）。
+   * @author ddj 2026年10月30号
+   * @param force 是否强制重拉
+   */
+  async function load(force = false): Promise<void> {
+    if (state.status === 'loading') return
+    patch({ status: 'loading' })
+    try {
+      const result = await rpc('quickMenu.get', {})
+      if (result.ok) patch({ status: 'ready', doc: result.doc, warning: result.warning, error: undefined })
+      else patch({ status: 'error', error: result.error })
+    } catch (error) {
+      patch({ status: 'error', error: '读取快捷菜单失败：' + String(error) })
+    }
+    await refreshBindings(force)
+  }
+
+  /**
+   * 提交整份文档（host 归一后回传，冲突时重拉）。
+   * @author ddj 2026年10月30号
+   * @param doc 待提交文档
+   * @returns 写结果
+   */
+  async function save(doc: QuickMenuDoc): Promise<QuickMenuMutation> {
+    try {
+      const result = await rpc('quickMenu.save', { doc, baseRevision: state.doc.revision })
+      if (result.ok) {
+        patch({ status: 'ready', doc: result.doc, error: undefined, warning: undefined })
+        return { ok: true }
+      }
+      await load(true)
+      return { ok: false, error: result.error }
+    } catch (error) {
+      return { ok: false, error: '保存快捷菜单失败：' + String(error) }
+    }
+  }
+
+  /**
+   * 新增或替换一项（按 id 去重）。
+   * @author ddj 2026年10月30号
+   * @param draft 菜单项
+   * @returns 写结果
+   */
+  async function upsert(draft: QuickMenuItem): Promise<QuickMenuMutation> {
+    const items = state.doc.items.filter((item) => item.id !== draft.id)
+    items.push(draft)
+    return save(normalizeDoc({ ...state.doc, items }))
+  }
+
+  /**
+   * 删除一项及其全部子项。
+   * @author ddj 2026年10月30号
+   * @param id 项 id
+   * @returns 写结果
+   */
+  async function removeItem(id: string): Promise<QuickMenuMutation> {
+    const doomed = descendantIds(state.doc, id)
+    const items = state.doc.items.filter((item) => !doomed.includes(item.id))
+    return save(normalizeDoc({ ...state.doc, items }))
+  }
+
+  /**
+   * 定时把待写坐标落盘。
+   * @author ddj 2026年10月30号
+   */
+  async function flushLauncher(): Promise<void> {
+    if (timer !== null) {
+      clearTimeout(timer)
+      timer = null
+    }
+    const target = pending
+    pending = null
+    if (!target) return
+    try {
+      const result = await rpc('quickMenu.launcher', target)
+      if (result.ok) patch({ doc: result.doc })
+    } catch {
+      // 位置保存失败无碍主流程：下次拖动会重试
+    }
+  }
+
+  /**
+   * 记录坐标并防抖落盘。
+   * @author ddj 2026年10月30号
+   * @param x 横坐标
+   * @param y 纵坐标
+   */
+  function patchLauncher(x: number | null, y: number | null): void {
+    pending = { x, y }
+    if (timer !== null) clearTimeout(timer)
+    timer = setTimeout(() => { void flushLauncher() }, LAUNCHER_DEBOUNCE_MS)
+  }
+
+  return {
+    subscribe(listener: () => void): () => void {
+      listeners.add(listener)
+      return () => { listeners.delete(listener) }
+    },
+    getVersion(): number { return version },
+    getState(): QuickMenuSnapshot { return state },
+    getContext(): ValidateContext {
+      const scope = loaders.scope()
+      return { cwd: scope.cwd, rules: bindings.rules, skillNames: bindings.skillNames ?? null }
+    },
+    load,
+    save,
+    createItem: upsert,
+    updateItem: upsert,
+    removeItem,
+    patchLauncher,
+    flushLauncher,
+    refreshBindings,
+    markMounted(value: boolean): void {
+      mounted = value
+      version += 1
+      for (const listener of listeners) listener()
+    },
+    isMounted(): boolean { return mounted },
+    nextId(type: 'group' | 'button'): string { return newQuickId(type) },
+  }
+}

package/src/client/state/diffSummary.ts

@@ -1,5 +1,6 @@
 /** Source-aware metadata projection; official patches never become legacy hunks. @author ddj 2026年10月26号 */
 import { PENDING_PREFIX } from '../../shared/pendingReview.js'
+import { pathKeyFor } from '../../shared/pathKey.js'
 import type { ReviewPage } from '../../shared/review.js'
 import type { RecordView } from '../../shared/types.js'
 import type { FileSummary, Summary } from './records.js'
@@ -14,11 +15,15 @@ export interface DiffFile extends FileSummary {
 }
 export interface DiffSummary extends Summary { files: DiffFile[]; pendingFiles: DiffFile[] }
 
-/** @public @author ddj 2026年10月26号 @param path Functional local or remote identity. @returns Comparison key without rewriting remote case. */
+/**
+ * @public
+ * @author ddj 2026年10月26号
+ * @description: 客户端路径比较口径：浏览器里没有宿主平台信息，非盘符路径不折叠大小写。
+ * @param path 文件身份或相对路径
+ * @returns 比较键
+ */
 export function diffPathKey(path: string): string {
-  if (/^[a-z]+:\/\//i.test(path)) return path
-  const normalized = path.replace(/\\/g, '/')
-  return /^[a-z]:\//i.test(normalized) ? normalized.toLowerCase() : normalized
+  return pathKeyFor(path, false)
 }
 
 /** @public @author ddj 2026年10月26号 @param path Current editor file. @param page Authoritative metadata, including decided paths. @returns Whether legacy actions must be hidden for this file. */