dsh-vscode-mode 0.25.0 → 0.26.0

package/package.json

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

@@ -16,6 +16,8 @@
 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'
@@ -41,6 +43,8 @@ export interface DownloadOpts {
   signal?: AbortSignal
   /** 每完成一个文件回调一次（done 含成功与失败）。 */
   onProgress?: (done: number, total: number, path: string) => void
+  /** 落盘去处；缺省按浏览器默认下载目录（`<a download>`）。 */
+  sink?: SaveSink
 }
 
 // --endregion
@@ -85,16 +89,20 @@ export async function fetchDownload(path: string, sessionId?: string): Promise<{
 }
 
 /**
- * 下载单个文件并交给浏览器落盘。
+ * 下载单个文件并落盘（所选目录则按相对路径写入，否则交给浏览器 `<a download>`）。
  * @author ddj 2026年11月03号
  * @param path 工作区相对路径
- * @param opts 会话 / 取消选项
+ * @param opts 会话 / 取消 / 落盘选项
  * @returns 路径与字节数
- * @throws 读取失败透传主机错误
+ * @throws 读取失败透传主机错误；目录写入失败透传底层错误
  */
 export async function downloadOne(path: string, opts: DownloadOpts = {}): Promise<DownloadedFile> {
   const file = await fetchDownload(path, opts.sessionId)
-  downloadBytes(file.bytes, baseNameOf(path) || 'download', file.mime)
+  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 }
 }
 
@@ -148,22 +156,44 @@ export async function downloadTarget(target: TreeMenuTarget, ctx?: SidebarCtx):
 }
 
 /**
- * 批量下载并统一反馈（开始一条、结束一条，避免逐文件刷屏）。
+ * 批量下载并统一反馈（先选保存目录，再逐文件落盘；开始一条、结束一条，避免逐文件刷屏）。
  * @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 })
+    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号

package/src/client/downloadSink.ts

@@ -0,0 +1,162 @@
+/**
+ * dsh-vscode-mode client — 下载落盘位置（目录选择器）。
+ *
+ * 浏览器原生 `<a download>` 由浏览器决定保存位置，页面拿不到路径；本模块用
+ * File System Access API 的 `showDirectoryPicker` 让用户在点「下载」时选一次目标文件夹，
+ * 之后把文件按工作区相对路径逐个写进去（文件夹下载自动建子目录，仍不打包）。
+ *
+ * 约束：
+ * - 选择器必须在用户手势的同步栈里调用，故入口函数都把 `pickSaveSink()` 放在第一个 await；
+ * - 需要安全上下文（https / localhost）与 Chromium 系浏览器，Firefox / Safari / 局域网 http
+ *   一律回落到浏览器默认下载目录，并在界面上说明原因，不静默改语义；
+ * - 用户取消选择（AbortError）与「不可用」区分开：前者终止整批，后者继续下载。
+ * 作者 ddj 2026年11月03号
+ */
+
+// --region 类型
+
+/** 落盘去处：写入用户所选目录，或回落到浏览器默认下载目录。 */
+export type SaveSink =
+  | { kind: 'dir'; dir: SinkDir }
+  | { kind: 'browser'; reason: SaveFallback }
+
+/** 回落到浏览器下载的原因（调用方据此给出提示文案）。 */
+export type SaveFallback = 'unsupported' | 'insecure' | 'denied'
+
+/** 可写文件的句柄（File System Access API 的子集）。 */
+export interface SinkWritable {
+  write(data: Uint8Array): Promise<void>
+  close(): Promise<void>
+}
+
+/** 文件句柄（仅用到创建可写流）。 */
+export interface SinkFileHandle {
+  createWritable(): Promise<SinkWritable>
+}
+
+/** 目录句柄（仅用到列目录与建子目录/文件）。 */
+export interface SinkDir {
+  name: string
+  getDirectoryHandle(name: string, opts?: { create?: boolean }): Promise<SinkDir>
+  getFileHandle(name: string, opts?: { create?: boolean }): Promise<SinkFileHandle>
+  queryPermission?(opts: { mode: 'readwrite' }): Promise<string>
+  requestPermission?(opts: { mode: 'readwrite' }): Promise<string>
+}
+
+/** `window.showDirectoryPicker` 的最小签名。 */
+type DirPicker = (opts?: { id?: string; mode?: string; startIn?: string }) => Promise<SinkDir>
+
+// --endregion
+
+// --region 选择器
+
+/**
+ * 当前浏览器/上下文是否可能弹出目录选择器（安全上下文 + API 存在）。
+ * @author ddj 2026年11月03号
+ * @returns 可用为 true；不安全上下文或缺 API 为 false
+ */
+export function canPickDirectory(): boolean {
+  return pickerOf() !== undefined
+}
+
+/**
+ * 让用户选择保存目录。
+ * @author ddj 2026年11月03号
+ * @returns 所选目录 / 回落原因 / 'cancelled'（用户取消，整批终止）
+ * @sideEffects 弹出系统目录选择器，成功后可能触发一次写权限请求
+ */
+export async function pickSaveSink(): Promise<SaveSink | 'cancelled'> {
+  const win = globalThis as { isSecureContext?: boolean; showDirectoryPicker?: DirPicker }
+  if (win.isSecureContext === false) return { kind: 'browser', reason: 'insecure' }
+
+  const picker = pickerOf()
+  if (!picker) return { kind: 'browser', reason: 'unsupported' }
+
+  let dir: SinkDir
+  try {
+    dir = await picker({ id: 'vsm-download', mode: 'readwrite', startIn: 'downloads' })
+  } catch (error) {
+    return isAbort(error) ? 'cancelled' : { kind: 'browser', reason: 'denied' }
+  }
+
+  return (await ensureWritable(dir)) ? { kind: 'dir', dir } : { kind: 'browser', reason: 'denied' }
+}
+
+/**
+ * 取回 `showDirectoryPicker`（不安全上下文视为没有）。
+ * @author ddj 2026年11月03号
+ * @returns 绑定到 globalThis 的选目录函数；不可用为 undefined
+ */
+function pickerOf(): DirPicker | undefined {
+  const win = globalThis as { isSecureContext?: boolean; showDirectoryPicker?: DirPicker }
+  if (win.isSecureContext === false) return undefined
+  return typeof win.showDirectoryPicker === 'function' ? win.showDirectoryPicker.bind(win) : undefined
+}
+
+/**
+ * 确认目录可写（部分浏览器选择后仍需显式请求一次 readwrite 权限）。
+ * @author ddj 2026年11月03号
+ * @param dir 目录句柄
+ * @returns 已获得写权限为 true
+ * @throws 权限查询本身抛错时向上透传（由调用方按回落处理）
+ */
+async function ensureWritable(dir: SinkDir): Promise<boolean> {
+  if (!dir.queryPermission) return true
+  if ((await dir.queryPermission({ mode: 'readwrite' })) === 'granted') return true
+  if (!dir.requestPermission) return false
+  return (await dir.requestPermission({ mode: 'readwrite' })) === 'granted'
+}
+
+// --endregion
+
+// --region 写入
+
+/**
+ * 把字节写到所选目录下的相对路径处（自动逐级建子目录）。
+ * @author ddj 2026年11月03号
+ * @param dir 目标目录句柄
+ * @param relPath 工作区相对路径（分隔符 `/`；越界段 `..` 会被丢弃）
+ * @param bytes 原始字节
+ * @sideEffects 在用户所选目录内创建目录与文件并覆盖同名文件
+ * @throws 磁盘写入失败或文件名非法时透传底层错误
+ */
+export async function writeFileToDir(dir: SinkDir, relPath: string, bytes: Uint8Array): Promise<void> {
+  const parts = pathSegments(relPath)
+  const fileName = parts.pop() ?? 'download'
+
+  let parent = dir
+  for (const part of parts) parent = await parent.getDirectoryHandle(part, { create: true })
+
+  const handle = await parent.getFileHandle(fileName, { create: true })
+  const writable = await handle.createWritable()
+  try {
+    await writable.write(bytes)
+  } finally {
+    await writable.close()
+  }
+}
+
+/**
+ * 相对路径切段（过滤空段、`.` 与越界 `..`，兼容反斜杠）。
+ * @author ddj 2026年11月03号
+ * @param relPath 工作区相对路径
+ * @returns 安全的路径段（末段为文件名）
+ */
+function pathSegments(relPath: string): string[] {
+  return relPath
+    .split(/[\\/]+/)
+    .map((part) => part.trim())
+    .filter((part) => part !== '' && part !== '.' && part !== '..')
+}
+
+/**
+ * 判断是否用户取消（AbortError），不依赖 DOMException 构造函数的存在。
+ * @author ddj 2026年11月03号
+ * @param error 捕获值
+ * @returns 取消为 true
+ */
+function isAbort(error: unknown): boolean {
+  return typeof error === 'object' && error !== null && (error as { name?: string }).name === 'AbortError'
+}
+
+// --endregion

package/src/client/reviewBar.ts

@@ -126,6 +126,9 @@ export const SIDECAR_KEEP_TITLE = '标记这些历史改动为已看过：只改
 /** 非官方 Undo 的作用域说明：走原有回滚校验写回磁盘，但不影响官方记录。 */
 export const SIDECAR_UNDO_TITLE = '撤销这些历史改动（写回受回滚校验保护）：只影响这份历史记录，不影响官方审查。'
 
+/** 非官方 Keep 之后的完成态：该通道 Keep 不写盘，不能沿用「已采纳」这种会让人以为改过文件的措辞。 */
+export const SIDECAR_KEEP_DONE = '已标记为看过（未改动文件）'
+
 /** 当前端没有该会话时，差异栏里给中性说明而不是红色报错。 */
 export const SESSION_DOWN_NOTICE = '这个会话没在当前端激活，官方审查数据暂时读不到；下面的历史改动仍可查看、Keep、Undo。'
 

package/src/client/reviewBatch.ts

@@ -30,7 +30,15 @@ export async function loadPending(port: Pick<BatchPort, 'snapshot'>): Promise<Re
   return page.items
 }
 
-/** @public @author ddj 2026年10月27号 @param port Guarded existing per-file decision adapter. @param reject Undo instead of Keep. @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback. */
+/**
+ * @public
+ * @author ddj 2026年10月27号
+ * @description: 逐条决策引擎，现仅供 Undo All 使用（Keep 已改走 `reviewKeepAll.ts` 的宿主批量通道）；
+ * 保留 reject 形态以便对照既有契约与测试。
+ * @param port Guarded existing per-file decision adapter.
+ * @param reject Undo instead of Keep.
+ * @returns Precise partial result; Undo stops at first conflict, never claims atomic multi-file rollback.
+ */
 export async function runReviewBatch(port: BatchPort, reject: boolean): Promise<BatchResult> {
   const result: BatchResult = { completed: 0, total: 0, paths: [], error: '' }
   try {

package/src/client/reviewKeepAll.ts

@@ -0,0 +1,72 @@
+/**
+ * 批量 Keep：一次完整快照 + 一次批量 RPC，单条基线问题只跳过自己，不再整批中止。
+ * Undo 仍走 reviewBatch.ts 的逐条通道（写盘要逐项校验并在冲突处停止）。
+ * @author ddj 2026年11月03号
+ */
+import type { KeepAllItem, KeepAllResult, ReviewItem, ReviewPage, ReviewResult } from '../shared/review.js'
+import { loadPending } from './reviewBatch.js'
+
+/** 批量 Keep 的 RPC 适配器；guard 在取快照前后各校验一次会话寿命。 */
+export interface KeepAllPort {
+  snapshot: () => Promise<ReviewPage>
+  keepAll: (items: KeepAllItem[], batchId: string) => Promise<ReviewResult<{ result: KeepAllResult }>>
+  guard: () => void
+}
+
+/**
+ * @private
+ * @author ddj 2026年11月03号
+ * @description: 取一次完整待审快照；完整性校验失败时重取一次，避免瞬时漂移被当成不可恢复错误。
+ * @param port 已鉴权的 RPC 适配器
+ * @returns 冻结的批量目标
+ * @throws 两次都取不到一致快照时抛出原始原因
+ */
+async function snapshotOnce(port: KeepAllPort): Promise<KeepAllItem[]> {
+  try {
+    return toItems(await loadPending(port))
+  } catch {
+    // 分页期间数量漂移多为瞬时：guard 仍有效就重新取一次，仍不一致才放弃
+    port.guard()
+    return toItems(await loadPending(port))
+  }
+}
+
+/**
+ * @private
+ * @author ddj 2026年11月03号
+ * @description: 把快照条目裁成批量目标，只带 host 需要的身份与版本线索。
+ * @param items 完整待审集
+ * @returns 批量目标
+ */
+function toItems(items: ReviewItem[]): KeepAllItem[] {
+  return items.map((item) => ({ id: item.id, display: item.display, seq: item.seq, revision: item.revision }))
+}
+
+/**
+ * @public
+ * @author ddj 2026年11月03号
+ * @description: 批量保留全部待审记录（Keep 不改写磁盘）。一次往返完成，跳过项只进 skipped，
+ * 段级异常才写 error；guard 失效时保留已完成计数交给调用方呈现。
+ * @param port 已鉴权的 RPC 适配器
+ * @returns 与 BatchResult 同构的批量结果（含跳过明细）
+ */
+export async function runKeepAll(port: KeepAllPort): Promise<KeepAllResult> {
+  const result: KeepAllResult = { completed: 0, total: 0, paths: [], skipped: [], error: '' }
+  try {
+    port.guard()
+    const items = await snapshotOnce(port)
+    result.total = items.length
+    if (!items.length) return result
+
+    port.guard()
+    const reply = await port.keepAll(items, crypto.randomUUID())
+    if (!reply.ok) {
+      result.error = reply.error
+      return result
+    }
+    return reply.result
+  } catch (cause) {
+    result.error = cause instanceof Error ? cause.message : String(cause)
+    return result
+  }
+}

package/src/client/state/diffSummary.ts

@@ -32,6 +32,39 @@ export function officialPath(path: string, page: ReviewPage | null): boolean {
   return !!page?.overview?.coveredPaths.some((candidate) => diffPathKey(candidate) === key)
 }
 
+/**
+ * @author ddj 2026年11月3号
+ * @description: 本页待审条目占用的路径键：路径本身与其身份各一份。
+ * @param page 审查页
+ * @returns 待审覆盖的路径键集合
+ */
+function pendingCoverKeys(page: ReviewPage | null): Set<string> {
+  const keys = new Set<string>()
+  for (const item of page?.items ?? []) {
+    if (!item.id.startsWith(PENDING_PREFIX)) continue
+    // 待审条目的 path 取自写入时的原始写法（agent 常用工作区相对路径），官方导航用的却是绝对身份：
+    // 只按 path 建覆盖集时，同一文件的官方汇总行不会被压掉，差异栏把 3 个文件算成 6 条。
+    // 身份（id 去掉待审前缀）与官方 identity 同源，必须一起入集。
+    keys.add(diffPathKey(item.currentPath || item.path))
+    keys.add(diffPathKey(item.id.slice(PENDING_PREFIX.length)))
+  }
+  return keys
+}
+
+/**
+ * @public
+ * @author ddj 2026年11月3号
+ * @description: 取本页"已有权威通道在管"的路径键：官方汇总覆盖集 + 待审条目。
+ * 编辑器与差异汇总必须同口径，否则同一改动在列表里被压掉、在编辑器里却仍然画得出来并可以点。
+ * @param page 审查页
+ * @returns 路径比较键集合
+ */
+export function coveredPathKeys(page: ReviewPage | null): Set<string> {
+  const keys = pendingCoverKeys(page)
+  for (const path of page?.overview?.coveredPaths ?? []) keys.add(diffPathKey(path))
+  return keys
+}
+
 /**
  * @author ddj 2026年10月30号
  * @description: 取出本页待审条目（id 带待审前缀）并折算成文件行。
@@ -40,15 +73,9 @@ export function officialPath(path: string, page: ReviewPage | null): boolean {
  */
 function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Set<string> } {
   const rows: DiffFile[] = []
-  const covered = new Set<string>()
   for (const item of page?.items ?? []) {
     if (!item.id.startsWith(PENDING_PREFIX)) continue
     const path = item.currentPath || item.path
-    // 待审条目的 path 取自写入时的原始写法（agent 常用工作区相对路径），官方导航用的却是绝对身份：
-    // 只按 path 建覆盖集时，同一文件的官方汇总行不会被压掉，差异栏把 3 个文件算成 6 条。
-    // 身份（id 去掉待审前缀）与官方 identity 同源，必须一起入集。
-    covered.add(diffPathKey(path))
-    covered.add(diffPathKey(item.id.slice(PENDING_PREFIX.length)))
     rows.push({
       path,
       label: item.display || path,
@@ -59,7 +86,7 @@ function pendingRowsOf(page: ReviewPage | null): { rows: DiffFile[]; covered: Se
       sourceKind: 'pending',
     })
   }
-  return { rows, covered }
+  return { rows, covered: pendingCoverKeys(page) }
 }
 
 /** @public @author ddj 2026年10月26号 @param records Tool-call history. @param page Official file navigation, never only its first 50 rows. @returns Pending first, then official; legacy paths remain explicitly labelled. */

package/src/client/ui/DownloadPicker.ts

@@ -114,6 +114,7 @@ export function DownloadPicker(props: DownloadPickerProps): React.ReactElement {
   },
     React.createElement('h3', null, '下载到本机'),
     React.createElement('div', { className: 'edrv-dl-sub' }, root ? '/' + root : '工作区根目录'),
+    React.createElement('div', { className: 'edrv-dl-hint' }, '点下载后会先选择保存文件夹，文件按相对路径写入'),
     renderTree({ state, root, rows, empty, loadDir, renderRow, onToggleDir, onToggleFile }),
     renderFoot({
       picked,
@@ -182,7 +183,7 @@ function renderFoot(opts: FootOpts): React.ReactElement {
       className: 'edrv-dl-go',
       disabled: !picked.length,
       onClick: () => onConfirm(picked),
-    }, '下载 ' + picked.length + ' 个文件'),
+    }, '选择位置并下载 ' + picked.length + ' 个文件'),
   )
 }