dsh-vscode-mode 0.1.52 → 0.1.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",
@@ -36,6 +36,7 @@
     "lib",
     "assets",
     "src",
+    "unity",
     "cordis.patch.yml"
   ],
   "license": "BSD-3-Clause",

package/src/client/chooseDialog.ts

@@ -0,0 +1,70 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 工作区选择弹窗（深链打开规则 1）。
+ * 复用与「添加 MCP」一致的 vsm-mcp-modal / vsm-mcp-dialog 模态（页面居中卡片 + 遮罩 + 主题
+ * token），React portal 挂 body；Esc / 遮罩点击 / 取消 → null（中止流程不改任何状态）。
+ * 作者 ddj 2026-09-07
+ */
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+
+/** 用户选择：使用最近的工作区 / 新建工作区 / null=中止。 */
+export type WorkspaceChoice = 'recent' | 'create' | null
+
+/** 弹窗组件属性。 */
+interface ChoiceModalProps {
+  /** 匹配到的工作区标题。 */
+  title: string
+  /** 触发打开的文件夹路径。 */
+  folder: string
+  /** 选择回调（首次调用即卸载）。 */
+  done: (choice: WorkspaceChoice) => void
+}
+
+/** 选择弹窗（vsm-mcp-modal 遮罩 + vsm-mcp-dialog 卡片，Esc/遮罩点击取消）。 */
+function ChoiceModal({ title, folder, done }: ChoiceModalProps) {
+  React.useEffect(() => {
+    const onKey = (event) => {
+      if (event.key === 'Escape') done(null)
+    }
+    window.addEventListener('keydown', onKey)
+    return () => window.removeEventListener('keydown', onKey)
+  }, [])
+  return React.createElement('div', {
+    className: 'vsm-mcp-modal',
+    onMouseDown: (event) => {
+      if (event.target === event.currentTarget) done(null)
+    },
+  },
+    React.createElement('div', { className: 'vsm-mcp-dialog' },
+      React.createElement('h3', null, '在 DSH 中打开'),
+      React.createElement('label', null, '文件夹 ' + folder + ' 位于已注册的工作区「' + title + '」内，选择打开方式：'),
+      React.createElement('div', { className: 'vsm-mcp-dialog-actions' },
+        React.createElement('button', { onClick: () => done(null) }, '取消'),
+        React.createElement('button', { onClick: () => done('create') }, '新建工作区'),
+        React.createElement('button', { className: 'vsm-primary', onClick: () => done('recent') }, '使用最近的工作区'),
+      ),
+    ),
+  )
+}
+
+/**
+ * 弹出工作区选择弹窗（深链打开规则 1）。
+ * @author ddj 2026年09月07号
+ * @param title 匹配到的工作区标题
+ * @param folder 文件夹路径
+ * @returns 用户选择；null = 取消/中止
+ */
+export function chooseWorkspace(title: string, folder: string): Promise<WorkspaceChoice> {
+  return new Promise((resolve) => {
+    const host = document.createElement('div')
+    document.body.appendChild(host)
+    const root = createRoot(host)
+    const done = (choice: WorkspaceChoice) => {
+      root.unmount()
+      host.remove()
+      resolve(choice)
+    }
+    root.render(React.createElement(ChoiceModal, { title, folder, done }))
+  })
+}

package/src/client/compat.ts

@@ -92,3 +92,34 @@ export function patchMethod<T extends object, K extends keyof T>(
     if (owner[key] === patched) owner[key] = original
   }
 }
+
+/** patchAccessor 的包装实现形状（original 为补丁前的实时实现）。 */
+export type PatchWrapper = (original: (...args: never[]) => unknown, ...args: never[]) => unknown
+
+/**
+ * accessor 感知的链式补丁：DSH 0.1.3+ 的 remote 命名空间方法（如
+ * remote.session.openWorkspacePath）是 getter-only accessor（Object.defineProperty
+ * 仅定义 get，直接赋值在严格模式下抛 TypeError），须整体替换属性描述符。
+ * 新 getter 每次访问现场调用原 getter 取最新一次性函数作 original，天然跟随
+ * DSH 内部 methods 表变化；data 属性降级走 patchMethod；属性缺失返回 null。
+ * @author ddj 2026年09月08号
+ * @param owner 目标对象
+ * @param key 属性名
+ * @param wrapper 包装实现（original 为补丁前的实时实现）
+ * @returns 恢复函数（幂等、带归属校验）；属性缺失时返回 null
+ */
+export function patchAccessor(owner: object, key: string, wrapper: PatchWrapper): (() => void) | null {
+  const descriptor = Object.getOwnPropertyDescriptor(owner, key)
+  if (!descriptor) return null
+  if (typeof descriptor.get !== 'function') return patchMethod(owner, key as never, wrapper as never)
+  const rawGet = descriptor.get as (this: object) => unknown
+  const patchedGet = function (): unknown {
+    const original = (...args: never[]) => (rawGet.call(owner) as (...args: never[]) => unknown)(...args)
+    return (...args: never[]) => wrapper(original, ...args)
+  }
+  Object.defineProperty(owner, key, { configurable: true, enumerable: descriptor.enumerable, get: patchedGet })
+  return () => {
+    const current = Object.getOwnPropertyDescriptor(owner, key)
+    if (current?.get === patchedGet) Object.defineProperty(owner, key, descriptor)
+  }
+}

package/src/client/externalOpen.ts

@@ -0,0 +1,130 @@
+/**
+ * dsh-vscode-mode client — 外部深链落地（Windows 右键菜单 / Unity 外部编辑器）。
+ * 启动时解析 location.search 的 edrvOpen 深链：跨源 referrer 守卫防外部网页诱导；
+ * 处理完剥离 URL 参数防刷新重开；执行委托 openFlow 打开规则引擎（工作区/对话智能路由）。
+ * 另挂 3s 移交轮询（兼活跃心跳）：launcher 投递的打开请求由已打开页面就地执行，避免重复开新页。
+ * 作者 ddj 2026-09-07 / 2026-09-08
+ */
+import { EDRV_PARAM_KEYS, parseOpenParams } from '../shared/externalOpen.js'
+import { openDeepLink } from './openFlow.js'
+import { rpc } from './rpc.js'
+
+/** toast 自隐时长。 */
+const TOAST_MS = 5000
+/** 深链移交轮询周期（兼活跃心跳）。 */
+const HANDOFF_POLL_MS = 3000
+
+/** 深链装配选项（全部可注入便于测试；缺省读浏览器全局）。 */
+export interface ExtOpenOptions {
+  /** 查询串（缺省 location.search）。 */
+  search?: string
+  /** referrer（缺省 document.referrer）。 */
+  referrer?: string
+  /** 当前源（缺省 location.origin）。 */
+  origin?: string
+}
+
+/**
+ * 装配外部深链：深链参数缺失时仅保持移交轮询（零额外开销）。
+ * @author ddj 2026年09月07号
+ * @param ctx 客户端根上下文（sessions/workspaces 服务）
+ * @param options 可注入选项
+ */
+export function setupExtOpen(ctx: unknown, options: ExtOpenOptions = {}): void {
+  startPresencePoll(ctx)
+  const search = options.search ?? (typeof location !== 'undefined' ? location.search : '')
+  const params = parseOpenParams(search)
+  if (!params) return
+  const referrer = options.referrer ?? (typeof document !== 'undefined' ? document.referrer : '')
+  const origin = options.origin ?? (typeof location !== 'undefined' ? location.origin : '')
+  if (!referrerAllowed(referrer, origin)) {
+    console.warn('[dsh-vscode-mode] 已忽略跨源深链请求（referrer=' + referrer + '）')
+    return
+  }
+  stripCurrentUrl()
+  void openDeepLink(ctx, params).catch((error) => {
+    console.warn('[dsh-vscode-mode] 深链打开失败：' + String(error))
+    toastDom('深链打开失败：' + String((error as Error)?.message ?? error))
+  })
+}
+
+/**
+ * 深链移交轮询：每 3s 向 host 领取待打开请求（兼活跃心跳，launcher 据此决定是否开新页）。
+ * 页面级单例（window 标记防 HMR 重复）；领取到即执行打开规则。
+ * @author ddj 2026年09月08号
+ * @param ctx 客户端根上下文
+ */
+function startPresencePoll(ctx: unknown): void {
+  if (typeof window === 'undefined') return
+  const marker = window as { __edrvExtPoll?: boolean }
+  if (marker.__edrvExtPoll) return
+  marker.__edrvExtPoll = true
+  let executing = false
+  window.setInterval(() => {
+    if (executing) return
+    executing = true
+    void rpc('edrv.external.pending', {})
+      .then(async (result) => {
+        if (!result.ok || !result.open) return
+        await openDeepLink(ctx, { paths: result.open.paths, line: result.open.line, column: result.open.column })
+      })
+      .catch(() => { /* 旧版 host 无此方法/离线：忽略 */ })
+      .finally(() => { executing = false })
+  }, HANDOFF_POLL_MS)
+}
+
+/**
+ * 跨源守卫：referrer 为空（launcher/Unity 直开）或同源 → 允许。
+ * @author ddj 2026年09月07号
+ * @param referrer 文档 referrer
+ * @param origin 当前页面源
+ * @returns 是否允许处理深链
+ */
+export function referrerAllowed(referrer: string, origin: string): boolean {
+  if (!referrer) return true
+  try {
+    return new URL(referrer).origin === origin
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 剥离 URL 中的深链参数（保留其余参数与 hash，防刷新重开）。
+ * @author ddj 2026年09月07号
+ * @param href 完整 URL
+ * @returns 清理后的 URL（pathname+search+hash）
+ */
+export function stripOpenHref(href: string): string {
+  const url = new URL(href)
+  for (const key of EDRV_PARAM_KEYS) url.searchParams.delete(key)
+  return url.pathname + url.search + url.hash
+}
+
+/** 清理当前页面 URL（best-effort，失败不阻塞打开）。 */
+function stripCurrentUrl(): void {
+  try {
+    if (typeof location === 'undefined' || typeof history === 'undefined') return
+    const next = stripOpenHref(location.href)
+    if (next !== location.pathname + location.search + location.hash) history.replaceState(null, '', next)
+  } catch { /* 清理失败忽略 */ }
+}
+
+/**
+ * 轻量 toast（编辑器未挂载也能提示；5s 自隐；openFlow 通知与错误呈现共用）。
+ * @author ddj 2026年09月07号
+ * @param text 提示文本
+ */
+export function toastDom(text: string): void {
+  if (typeof document === 'undefined') return
+  const toast = document.createElement('div')
+  toast.textContent = text
+  toast.setAttribute('style', [
+    'position:fixed', 'left:50%', 'bottom:28px', 'transform:translateX(-50%)',
+    'z-index:99999', 'padding:8px 14px', 'border-radius:8px', 'max-width:80vw',
+    'background:#2a2a2a', 'color:#ddd', 'border:1px solid #444', 'font-size:12px',
+    'box-shadow:0 4px 16px rgba(0,0,0,.35)',
+  ].join(';'))
+  document.body?.appendChild(toast)
+  setTimeout(() => toast.remove(), TOAST_MS)
+}

package/src/client/imagePreview.ts

@@ -0,0 +1,45 @@
+/**
+ * dsh-vscode-mode client — 图片文件判定与 data URL 组装（编辑区图片预览面板用）。
+ * 纯函数、无 DOM 依赖，便于单测；MIME 表收敛在 shared/rpc.ts（host base64 响应同源）。
+ * @author ddj 2026年09月08号
+ */
+import { IMAGE_MIME } from '../shared/rpc.js'
+
+/** 可预览的图片扩展名集合（小写、无点）。 */
+const IMAGE_EXT_SET: Set<string> = new Set(Object.keys(IMAGE_MIME))
+
+/**
+ * 判断路径是否为可预览的图片文件（取 basename 扩展名，大小写不敏感）。
+ * @author ddj 2026年09月08号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否图片文件
+ */
+export function isImagePath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot <= 0) return false
+  return IMAGE_EXT_SET.has(base.slice(dot + 1).toLowerCase())
+}
+
+/**
+ * 判断路径是否为 SVG 文件（唯一提供「以文本打开」切换的图片格式）。
+ * @author ddj 2026年09月08号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否 SVG
+ */
+export function isSvgPath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  return dot > 0 && base.slice(dot + 1).toLowerCase() === 'svg'
+}
+
+/**
+ * base64 文本 → 可直接赋给 `<img src>` 的 data URL。
+ * @author ddj 2026年09月08号
+ * @param base64 base64 文本（不含 data: 前缀）
+ * @param mime MIME 类型（host edrv.read base64 响应携带）
+ * @returns data URL 字符串
+ */
+export function dataUrlOf(base64: string, mime: string): string {
+  return 'data:' + (mime || 'application/octet-stream') + ';base64,' + base64
+}

package/src/client/index.ts

@@ -25,6 +25,8 @@ import { loadMonaco } from './monaco/loader.js'
 import { createFileOpenerRegistry, scanSidebar, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
+import { patchRemoteOpen, probeRemoteOpen } from './remoteOpenRouter.js'
+import { setupExtOpen } from './externalOpen.js'
 import { SettingsContext } from './settingsContext.js'
 import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
 import { detectSidebarService, installSideEditor, setEnsureSideEditor, SIDEBAR_INSTALL_CMD } from './sidebarBridge.js'
@@ -62,6 +64,9 @@ export function apply(ctx: any): void {
   const workspaces = ctx.get('workspaces')
   const sessions = ctx.get('sessions')
 
+  // 外部深链落地：Windows 右键菜单 / Unity 外部编辑器 → 浏览器 URL 参数 → 打开规则路由
+  setupExtOpen(ctx)
+
   // Monaco 加载时机：不再 DSH 启动即预热，改为进入会话界面（sessions.list.current 出现）后再后台加载，
   // 用户点开「文件编辑」页签即用；空闲时仍由 EditorView 挂载兜底加载。
   // 模块级 promise 去重，重复触发只首次真正加载；requestIdleCallback 让出会话首屏带宽，缺省回退延时调度；
@@ -94,6 +99,17 @@ export function apply(ctx: any): void {
   const binder = pickSettingsBinder(ctx)
   const settings = binder.scope
   let selected = autoValue('auto')
+  /** 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）是否已安装（compatSummary 展示用）。 */
+  let remoteOpenInstalled = false
+  /** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter）。 */
+  const routeLogger = (message: string): void => console.warn('[dsh-vscode-mode] ' + message)
+  /** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
+  const openContext = (): FileOpenContext => {
+    const current = sessions?.list?.getSnapshot?.()
+    const sessionId = current?.current
+    const summary = sessionId ? current?.byId?.[sessionId] : undefined
+    return { sessionId, cwd: summary?.cwd } as FileOpenContext
+  }
   /** 可选探测 betterSidebar 服务（不进 inject：缺失会让插件停靠等待，杀死回退路径）。 */
   let sideService = detectSidebarService(ctx)
   /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
@@ -102,7 +118,8 @@ export function apply(ctx: any): void {
   /** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
   const compatSummary = (): CompatAdapter[] => [
     { name: '设置桥', active: settings !== undefined, note: settings !== undefined ? '使用 ' + binder.service + ' 桥' : '未绑定设置服务（fileOpenTool 持久化不可用）' },
-    { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开' },
+    { name: '文件打开路由（workspaces.openPath）', active: Boolean(workspaces?.openPath), note: 'vscode 打开器优先，失败回退系统打开（0.1.2 及更早 DSH 的对话文件链接主路径）' },
+    { name: '会话文件链接路由（remote.session.openWorkspacePath）', active: remoteOpenInstalled, note: '0.1.3+ 对话文件引用/产物打开优先走插件打开器，失败回退系统打开' },
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
     { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（对话+编辑同屏）' : '未检测到；安装 dsh-better-sidebar 后刷新启用侧边栏形态（' + SIDEBAR_INSTALL_CMD + '）' },
   ]
@@ -169,15 +186,40 @@ export function apply(ctx: any): void {
       workspaces,
       registry,
       selected: () => selected,
-      context: () => {
-        const current = sessions?.list?.getSnapshot?.()
-        const sessionId = current?.current
-        const summary = sessionId ? current?.byId?.[sessionId] : undefined
-        return { sessionId, cwd: summary?.cwd } as FileOpenContext
-      },
-      logger: (message: string) => console.warn('[dsh-vscode-mode] ' + message),
+      context: openContext,
+      logger: routeLogger,
     }), 'vscode-mode: file link routing')
   }
+  // 0.1.3+ 会话文件链接主路径：dsh-client-ui-chat 的 openFile 直接调
+  // remote.session.openWorkspacePath（session/openWorkspacePath RPC），绕开
+  // workspaces.openPath；该 namespace 由 api-remotes 在 loader.await 后挂载，
+  // 晚于本插件 apply，且旧版 DSH 可能整段不存在——不加 inject（避免旧版停等
+  // 永不激活），改为定时探测有界重试（与侧栏服务探测同款节奏）。
+  let remoteRetries = 0
+  const retryRemoteOpen = (): void => {
+    if (remoteOpenInstalled || remoteRetries >= 15) {
+      if (!remoteOpenInstalled) console.warn('[dsh-vscode-mode] 未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装')
+      return
+    }
+    remoteRetries += 1
+    schedule(() => {
+      if (remoteOpenInstalled) return
+      const service = probeRemoteOpen(ctx)
+      if (!service) {
+        retryRemoteOpen()
+        return
+      }
+      const disposer = patchRemoteOpen(service, { registry, selected: () => selected, context: openContext, logger: routeLogger })
+      if (!disposer) {
+        console.warn('[dsh-vscode-mode] remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装')
+        return
+      }
+      remoteOpenInstalled = true
+      ctx.effect(() => disposer, 'vscode-mode: remote file link routing')
+      console.info('[dsh-vscode-mode] 已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）')
+    }, 2000)
+  }
+  retryRemoteOpen()
 
   // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态可用时编辑器住 betterSidebar Tab，
   // 本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。