dsh-vscode-mode 0.24.0 → 0.25.1

package/lib/client.js.map

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/lib/client.js.map
-size: 35705679 bytes
-sha256: 99ccafcfabf9448fefe75878b567b71a795cb2d17af9ac3077189a81c6a0eb09
+size: 35757528 bytes
+sha256: 0d31913373f82b945772a46dce1f7840a2e71d3cf643543434c05dfef727fd81

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "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/downloadFile.ts

@@ -0,0 +1,238 @@
+/**
+ * dsh-vscode-mode client — 资源管理器「下载到本机」下载原语。
+ *
+ * 远程访问时工作区在远端机器上，浏览器拿不到本地落盘入口：本模块把
+ * 「相对路径 → 主机字节 → 浏览器下载」串成一条链，供右键菜单调用。
+ *
+ * 读取走 shared 的 readBinaryPreview：本机走 edrv.readBinary 原始字节，远程代理
+ * 会剥掉 x-edrv-* 响应头、自动回退 edrv.read 的 base64 分支（功能不降级，体积 +33%）。
+ *
+ * 约束：
+ * - 不打包、不新增主机 RPC；勾选多个文件时逐个下载原文件（串行，避免并发大文件
+ *   打爆 RPC 内存，也贴合「不打包」的产品决策）。
+ * - 单个文件失败不整批中断：失败条目记入结果，由调用方统一提示。
+ * 作者 ddj 2026年11月03号
+ */
+import { readBinaryPreview } from '../shared/rpc.js'
+import { baseNameOf } from '../shared/fsNames.js'
+import { rpc } from './rpc.js'
+import type { SaveFallback, SaveSink } from './downloadSink.js'
+import { pickSaveSink, writeFileToDir } from './downloadSink.js'
+import type { TreeMenuTarget } from './sidebar/contextMenu.js'
+import type { SidebarCtx } from './sidebar/types.js'
+import { openDownloader } from './ui/DownloadPicker.js'
+
+// --region 类型
+
+/** 单个文件的下载结果（字节数供提示用）。 */
+export interface DownloadedFile {
+  path: string
+  size: number
+}
+
+/** 批量下载结果：成功路径保持入参顺序，失败保留主机原文。 */
+export interface DownloadBatch {
+  ok: string[]
+  failed: Array<{ path: string; message: string }>
+}
+
+/** 批量下载选项。 */
+export interface DownloadOpts {
+  sessionId?: string
+  /** 取消信号：只在下个文件开始前检查（不中断进行中的请求）。 */
+  signal?: AbortSignal
+  /** 每完成一个文件回调一次（done 含成功与失败）。 */
+  onProgress?: (done: number, total: number, path: string) => void
+  /** 落盘去处；缺省按浏览器默认下载目录（`<a download>`）。 */
+  sink?: SaveSink
+}
+
+// --endregion
+
+// --region 单文件
+
+/**
+ * 触发浏览器下载（Blob + 隐藏 <a download>），与 Excel 导出同一落盘范式。
+ * @author ddj 2026年11月03号
+ * @param bytes 原始字节
+ * @param fileName 保存文件名（浏览器重名时自动加序号）
+ * @param mime MIME 类型；空值退化为 application/octet-stream
+ * @sideEffects 创建并点击一个游离 <a> 节点，60 秒后释放 objectURL
+ */
+export function downloadBytes(bytes: Uint8Array, fileName: string, mime: string): void {
+  const type = mime || 'application/octet-stream'
+  const url = URL.createObjectURL(new Blob([bytes as BlobPart], { type }))
+  const anchor = document.createElement('a')
+
+  anchor.href = url
+  anchor.download = fileName
+  anchor.rel = 'noopener'
+  anchor.click()
+
+  setTimeout(() => URL.revokeObjectURL(url), 60000)
+}
+
+/**
+ * 读取单个文件的原始字节（二进制通道优先，base64 回退）。
+ * @author ddj 2026年11月03号
+ * @param path 工作区相对路径
+ * @param sessionId 会话 id（工作区解析用）
+ * @returns 字节 + MIME + 字节数（MIME 缺失按路径推断）
+ * @throws 主机拒绝或读取失败时抛出主机错误原文（如「文件过大（>32MB）…」）
+ */
+export async function fetchDownload(path: string, sessionId?: string): Promise<{ bytes: Uint8Array; mime: string; size: number }> {
+  const args = sessionId ? { sessionId, path } : { path }
+  const out = await readBinaryPreview(rpc, args)
+  if (!out.ok) throw new Error(out.error)
+  if (out.via === 'binary') return { bytes: out.bytes, mime: out.mime, size: out.size }
+  return { bytes: decodeBase64(out.content), mime: out.mime || 'application/octet-stream', size: out.size }
+}
+
+/**
+ * 下载单个文件并落盘（所选目录则按相对路径写入，否则交给浏览器 `<a download>`）。
+ * @author ddj 2026年11月03号
+ * @param path 工作区相对路径
+ * @param opts 会话 / 取消 / 落盘选项
+ * @returns 路径与字节数
+ * @throws 读取失败透传主机错误；目录写入失败透传底层错误
+ */
+export async function downloadOne(path: string, opts: DownloadOpts = {}): Promise<DownloadedFile> {
+  const file = await fetchDownload(path, opts.sessionId)
+  if (opts.sink?.kind === 'dir') {
+    await writeFileToDir(opts.sink.dir, path, file.bytes)
+  } else {
+    downloadBytes(file.bytes, baseNameOf(path) || 'download', file.mime)
+  }
+  return { path, size: file.size }
+}
+
+// --endregion
+
+// --region 批量与入口
+
+/**
+ * 串行下载多个文件（逐个原文件，不打包）。
+ * @author ddj 2026年11月03号
+ * @param paths 工作区相对路径列表（按用户勾选顺序）
+ * @param opts 会话 / 取消 / 进度选项
+ * @returns 成功与失败清单；单项失败不中断后续
+ */
+export async function downloadMany(paths: string[], opts: DownloadOpts = {}): Promise<DownloadBatch> {
+  const ok: string[] = []
+  const failed: Array<{ path: string; message: string }> = []
+
+  for (const path of paths) {
+    if (opts.signal?.aborted) break
+    try {
+      await downloadOne(path, opts)
+      ok.push(path)
+    } catch (error) {
+      failed.push({ path, message: textOfError(error) })
+    }
+    opts.onProgress?.(ok.length + failed.length, paths.length, path)
+  }
+
+  return { ok, failed }
+}
+
+/**
+ * 右键菜单入口：文件直下，文件夹 / 工作区根打开勾选弹窗。
+ * @author ddj 2026年11月03号
+ * @param target 右键目标（根空白区为 path='' 的 directory）
+ * @param ctx 面板上下文（会话 id 与状态栏反馈）
+ * @sideEffects 触发浏览器下载或挂载弹窗；错误经 ctx.notify 透出
+ */
+export async function downloadTarget(target: TreeMenuTarget, ctx?: SidebarCtx): Promise<void> {
+  if (target.type === 'file') {
+    await runBatch([target.path], ctx)
+    return
+  }
+
+  openDownloader({
+    root: target.path,
+    sessionId: ctx?.sessionId,
+    onConfirm: (paths: string[]) => { void runBatch(paths, ctx) },
+  })
+}
+
+/**
+ * 批量下载并统一反馈（先选保存目录，再逐文件落盘；开始一条、结束一条，避免逐文件刷屏）。
+ * @author ddj 2026年11月03号
+ * @param paths 勾选路径
+ * @param ctx 面板上下文
+ * @sideEffects 弹出目录选择器；用户取消则整批中止
+ */
+async function runBatch(paths: string[], ctx?: SidebarCtx): Promise<void> {
+  if (!paths.length) return
+
+  // 选择器必须在用户手势的同步栈里触发，故放在第一个 await 之前。
+  const sink = await pickSaveSink()
+  if (sink === 'cancelled') {
+    ctx?.notify?.('已取消下载')
+    return
+  }
+  if (sink.kind === 'browser') ctx?.notify?.(fallbackText(sink.reason))
+  if (paths.length > 1) ctx?.notify?.('正在下载 ' + paths.length + ' 个文件…')
+
+  try {
+    const out = await downloadMany(paths, { sessionId: ctx?.sessionId, sink })
+    ctx?.notify?.(batchText(out))
+  } catch (error) {
+    ctx?.notify?.('下载失败：' + textOfError(error))
+  }
+}
+
+/**
+ * 目录选择不可用时的提示文案（说明文件去了浏览器默认下载目录）。
+ * @author ddj 2026年11月03号
+ * @param reason 回落原因
+ * @returns 单行提示文案
+ */
+function fallbackText(reason: SaveFallback): string {
+  if (reason === 'unsupported') return '浏览器不支持选择保存目录，已保存到默认下载目录'
+  if (reason === 'insecure') return '当前页面不是安全上下文（需 https 或 localhost），已保存到默认下载目录'
+  return '未获得目录写入权限，已保存到默认下载目录'
+}
+
+/**
+ * 批量结果口播文案。
+ * @author ddj 2026年11月03号
+ * @param out 批量结果
+ * @returns 单行提示文案
+ */
+function batchText(out: DownloadBatch): string {
+  if (!out.failed.length) return '已下载 ' + out.ok.length + ' 个文件'
+  const first = out.failed[0]
+  const tail = '（' + first.path + '：' + first.message + '）'
+  if (!out.ok.length) return '下载失败：' + first.message + tail
+  return '已下载 ' + out.ok.length + ' 个，失败 ' + out.failed.length + ' 个' + tail
+}
+
+// --endregion
+
+// --region 工具
+
+/**
+ * base64 → 字节（回退通道解码；逐字节写入避免大文件二次拷贝放大）。
+ * @author ddj 2026年11月03号
+ * @param text base64 文本
+ * @returns 原始字节
+ */
+function decodeBase64(text: string): Uint8Array {
+  const binary = atob(text)
+  const bytes = new Uint8Array(binary.length)
+  for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index)
+  return bytes
+}
+
+/**
+ * 错误可读文案（Error.message 优先，其余 String 化）。
+ * @author ddj 2026年11月03号
+ * @param error 捕获值
+ * @returns 提示文案
+ */
+function textOfError(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+// --endregion

package/src/client/downloadPickerModel.ts

@@ -0,0 +1,335 @@
+/**
+ * dsh-vscode-mode client — 「下载到本机」弹窗的目录树与勾选模型（纯逻辑）。
+ *
+ * 与 React 解耦：组件只读 rowList 渲染、只调这里的函数改状态，因此本文件可在
+ * node 环境单测（vitest 无可视 DOM）。状态全部不可变返回，便于 React 直接替换。
+ *
+ * 设计决策（产品已确认「目录树 + 勾选、不打包」）：
+ * - 目录节点只负责展开，不带勾选框；勾选粒度是文件（避免「半选目录」的语义歧义）。
+ * - 懒加载：一次只 listDir 一层；「全选」只作用于已加载文件，不对未展开目录做
+ *   隐式整树拉取（否则 node_modules 级目录会把弹窗一次性拉爆）。
+ * 作者 ddj 2026年11月03号
+ */
+import type { TreeEntry } from '../shared/rpc.js'
+
+/** 单文件下载上限，与主机二进制读取上限（BINARY_READ_CAP）保持一致。 */
+export const DL_SIZE_CAP = 32 * 1024 * 1024
+
+/** 树节点：只保留文件与目录（主机的 'other' 不进弹窗）。 */
+export interface DlNode {
+  name: string
+  path: string
+  kind: 'file' | 'directory'
+  /** 主机的可选大小；缺失时界面不显示体积，也不做上限预判。 */
+  size?: number
+}
+
+/** 弹窗状态：目录树 + 展开态 + 加载态 + 勾选集合。 */
+export interface DlState {
+  /** 弹窗根（工作区相对路径；'' = 工作区根目录）。 */
+  root: string
+  nodes: Map<string, DlNode>
+  /** 目录路径 → 已加载子项（按目录优先 + 名称排序）。 */
+  children: Map<string, string[]>
+  expanded: Set<string>
+  loading: Set<string>
+  selected: Set<string>
+  /** 目录路径 → 该层加载失败的主机原文。 */
+  errors: Map<string, string>
+}
+
+/** 一行渲染数据（深度优先铺平当前可见节点）。 */
+export interface DlRow {
+  path: string
+  name: string
+  kind: 'file' | 'directory'
+  depth: number
+  expanded: boolean
+  checked: boolean
+  size?: number
+  loading: boolean
+  error?: string
+}
+
+/**
+ * 初始状态：根目录默认展开，等待首层 listDir 填充。
+ * @author ddj 2026年11月03号
+ * @param root 弹窗根（工作区相对路径，'' = 工作区根）
+ * @returns 空树状态
+ */
+export function createDlState(root: string): DlState {
+  return {
+    root,
+    nodes: new Map(),
+    children: new Map(),
+    expanded: new Set([root]),
+    loading: new Set(),
+    selected: new Set(),
+    errors: new Map(),
+  }
+}
+
+/**
+ * 合并某目录的 listDir 结果（替换该层子项，清理本次已不存在的旧子项）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径（'' = 工作区根）
+ * @param entries 主机返回的目录项
+ * @returns 新状态（loading / errors 中的该目录项被清除）
+ */
+export function mergeChildren(state: DlState, dirPath: string, entries: TreeEntry[]): DlState {
+  const nodes = new Map(state.nodes)
+  const children = new Map(state.children)
+  const expanded = new Set(state.expanded)
+  const loading = new Set(state.loading)
+  const selected = new Set(state.selected)
+  const errors = new Map(state.errors)
+  const previous = children.get(dirPath) ?? []
+  const nextPaths: string[] = []
+
+  for (const entry of entries) {
+    if (entry.type === 'other') continue
+    const kind: DlNode['kind'] = entry.type === 'directory' ? 'directory' : 'file'
+    nodes.set(entry.path, { name: entry.name, path: entry.path, kind, size: entry.size })
+    nextPaths.push(entry.path)
+  }
+  nextPaths.sort((left, right) => compareNodes(nodes, left, right))
+  children.set(dirPath, nextPaths)
+  loading.delete(dirPath)
+  errors.delete(dirPath)
+
+  // 本次列表里消失的旧子项整支清理：残留节点会让勾选命中幽灵路径，也会让弹窗显示已删文件。
+  for (const stale of previous) {
+    if (nextPaths.includes(stale)) continue
+    nodes.delete(stale)
+    selected.delete(stale)
+    children.delete(stale)
+    expanded.delete(stale)
+  }
+
+  return { root: state.root, nodes, children, expanded, loading, selected, errors }
+}
+
+/**
+ * 标记某目录正在加载（展开时先出「加载中…」行）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function markLoading(state: DlState, dirPath: string): DlState {
+  const loading = new Set(state.loading)
+  loading.add(dirPath)
+  return { ...state, loading }
+}
+
+/**
+ * 标记某目录加载失败（保留错误原文供重试行显示）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @param message 主机错误原文
+ * @returns 新状态
+ */
+export function markError(state: DlState, dirPath: string, message: string): DlState {
+  const loading = new Set(state.loading)
+  const errors = new Map(state.errors)
+  loading.delete(dirPath)
+  errors.set(dirPath, message)
+  return { ...state, loading, errors }
+}
+
+/**
+ * 展开目录（不改 children，加载由调用方按 needLoad 判定）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function expandDir(state: DlState, dirPath: string): DlState {
+  const expanded = new Set(state.expanded)
+  expanded.add(dirPath)
+  return { ...state, expanded }
+}
+
+/**
+ * 收起目录。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 新状态
+ */
+export function collapseDir(state: DlState, dirPath: string): DlState {
+  const expanded = new Set(state.expanded)
+  expanded.delete(dirPath)
+  return { ...state, expanded }
+}
+
+/**
+ * 目录是否已展开。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 是否展开
+ */
+export function isExpanded(state: DlState, dirPath: string): boolean {
+  return state.expanded.has(dirPath)
+}
+
+/**
+ * 某目录是否已拉取过子项（决定展开时要不要发 listDir）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 目录路径
+ * @returns 是否已加载
+ */
+export function hasLoaded(state: DlState, dirPath: string): boolean {
+  return state.children.has(dirPath)
+}
+
+/**
+ * 切换文件勾选（超过上限的文件不可勾选；目录与未知路径忽略）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param path 文件路径
+ * @returns 新状态
+ */
+export function toggleFile(state: DlState, path: string): DlState {
+  const node = state.nodes.get(path)
+  if (!node || node.kind !== 'file') return state
+  if (isOversized(node.size)) return state
+  const selected = new Set(state.selected)
+  if (selected.has(path)) selected.delete(path)
+  else selected.add(path)
+  return { ...state, selected }
+}
+
+/**
+ * 全选已加载文件（不含超限文件）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 新状态
+ */
+export function selectLoaded(state: DlState): DlState {
+  const selected = new Set<string>()
+  for (const path of loadedFiles(state)) {
+    const node = state.nodes.get(path)
+    if (node && !isOversized(node.size)) selected.add(path)
+  }
+  return { ...state, selected }
+}
+
+/**
+ * 清空勾选。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 新状态
+ */
+export function clearSelected(state: DlState): DlState {
+  return { ...state, selected: new Set<string>() }
+}
+
+/**
+ * 已勾选文件（按路径排序，保证下载顺序稳定可测）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 路径列表
+ */
+export function selectedFiles(state: DlState): string[] {
+  return Array.from(state.selected).sort()
+}
+
+/**
+ * 已加载的文件路径（全选的作用域就是它）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 路径列表
+ */
+export function loadedFiles(state: DlState): string[] {
+  const out: string[] = []
+  for (const node of state.nodes.values()) {
+    if (node.kind === 'file') out.push(node.path)
+  }
+  return out.sort()
+}
+
+/**
+ * 当前可见行（深度优先；只展开已展开目录）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @returns 渲染行列表
+ */
+export function rowList(state: DlState): DlRow[] {
+  const rows: DlRow[] = []
+  appendRows(state, state.root, 0, rows)
+  return rows
+}
+
+/**
+ * 递归铺平子项（仅内部使用；深度受限于用户实际展开层数）。
+ * @author ddj 2026年11月03号
+ * @param state 当前状态
+ * @param dirPath 当前目录
+ * @param depth 缩进层级
+ * @param rows 输出累积
+ */
+function appendRows(state: DlState, dirPath: string, depth: number, rows: DlRow[]): void {
+  if (!state.expanded.has(dirPath)) return
+  const childPaths = state.children.get(dirPath) ?? []
+  for (const path of childPaths) {
+    const node = state.nodes.get(path)
+    if (!node) continue
+    const expanded = node.kind === 'directory' && state.expanded.has(path)
+    rows.push({
+      path,
+      name: node.name,
+      kind: node.kind,
+      depth,
+      expanded,
+      checked: state.selected.has(path),
+      size: node.size,
+      loading: state.loading.has(path),
+      error: state.errors.get(path),
+    })
+    if (node.kind === 'directory') appendRows(state, path, depth + 1, rows)
+  }
+}
+
+/**
+ * 体积可读文案（列表右侧提示用）。
+ * @author ddj 2026年11月03号
+ * @param size 字节数
+ * @returns 如 `512 B` / `12 KB` / `3.4 MB`
+ */
+export function formatSize(size: number): string {
+  if (!Number.isFinite(size) || size < 0) return ''
+  if (size < 1024) return size + ' B'
+  if (size < 1024 * 1024) return Math.round(size / 1024) + ' KB'
+  return (size / (1024 * 1024)).toFixed(1) + ' MB'
+}
+
+/**
+ * 体积是否超过单文件上限（主机 >32MB 会直接拒绝，界面提前拦一层）。
+ * @author ddj 2026年11月03号
+ * @param size 字节数（主机未提供体积时为 undefined ⇒ 不预判）
+ * @returns 是否超限
+ */
+export function isOversized(size: number | undefined): boolean {
+  return typeof size === 'number' && size > DL_SIZE_CAP
+}
+
+/**
+ * 目录优先 + 名称排序的比较器（与资源管理器视觉一致）。
+ * @author ddj 2026年11月03号
+ * @param nodes 节点表
+ * @param left 左路径
+ * @param right 右路径
+ * @returns 比较结果
+ */
+function compareNodes(nodes: Map<string, DlNode>, left: string, right: string): number {
+  const one = nodes.get(left)
+  const two = nodes.get(right)
+  if (!one || !two) return 0
+  if (one.kind !== two.kind) return one.kind === 'directory' ? -1 : 1
+  return one.name.localeCompare(two.name)
+}