dsh-vscode-mode 0.4.6 → 0.5.0

package/src/client/ui/SvnLogStats.ts

@@ -0,0 +1,243 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — SVN 日志统计窗（P1-10，对应 TortoiseSVN Statistics 三页 D23）。
+ *
+ * 纯前端聚合当前显示的条目（不发额外 RPC）；统计口径 = 传入条目集合，
+ * 即官方「统计覆盖期间 = Log 对话框显示的期间」。内容对齐官方可达子集：
+ * 概要（期间与修订数）· Commits by author（横条 + 饼图 + Others 阈值）·
+ * Commits by date（按日柱状，normal/stacked）+ Authors case insensitive 开关（默认关，与官方一致）。
+ * Esc 交由底层日志弹窗处理（嵌套 ModalShell 同键会连关两层，故统计窗只走 ✕/遮罩关闭）。
+ * 作者 ddj 2026年09月17号
+ */
+import React from 'react'
+import { ModalShell } from './ModalShell.js'
+
+/** stacked 时间线展开的作者上限（其余并入「其他」）。 */
+const STACK_TOP = 5
+/** 作者配色（按占比序循环；饼图与 stacked 分段共用）。 */
+const TONES = ['#4e9a06', '#3465a4', '#c17d11', '#75507b', '#cc0000', '#5c3566', '#ce5c00', '#888a85']
+
+/**
+ * 日期 → 本地日（YYYY-MM-DD；解析失败返回空串，该条不参与期间与按日统计）。
+ * @author ddj 2026年09月17号
+ * @param date ISO8601 字符串
+ * @returns 日文本
+ */
+function dayTextOf(date) {
+  const at = new Date(String(date ?? ''))
+  if (Number.isNaN(at.getTime())) return ''
+  const pad = (n) => String(n).padStart(2, '0')
+  return at.getFullYear() + '-' + pad(at.getMonth() + 1) + '-' + pad(at.getDate())
+}
+
+/**
+ * 聚合统计（P1-10 纯函数，供组件与单测共用）。
+ * @author ddj 2026年09月17号
+ * @param entries 日志条目
+ * @param opts caseInsensitive 作者归并开关（默认 false = 区分大小写，与官方一致）
+ * @returns total 总数 / minDate·maxDate 期间 / authors 作者分布（降序）/ days 按日分布（升序）
+ */
+export function svnLogStatsOf(entries, opts = {}) {
+  const ci = opts.caseInsensitive === true
+  const list = Array.isArray(entries) ? entries : []
+  const authors = new Map()
+  const days = new Map()
+  let min = ''
+  let max = ''
+  for (const entry of list) {
+    const name = entry.author || '（无作者）'
+    const key = ci ? name.toLowerCase() : name
+    const a = authors.get(key) || { name, count: 0 }
+    a.count++
+    authors.set(key, a)
+    const day = dayTextOf(entry.date)
+    if (!day) continue
+    if (!min || day < min) min = day
+    if (!max || day > max) max = day
+    const d = days.get(day) || { count: 0, byKey: new Map() }
+    d.count++
+    d.byKey.set(key, (d.byKey.get(key) || 0) + 1)
+    days.set(day, d)
+  }
+  const authorList = [...authors.entries()]
+    .map(([key, a]) => ({ key, name: a.name, count: a.count }))
+    .sort((x, y) => y.count - x.count || x.key.localeCompare(y.key))
+  const dayList = [...days.entries()]
+    .map(([day, d]) => ({ day, count: d.count, byKey: d.byKey }))
+    .sort((x, y) => x.day.localeCompare(y.day))
+  return { total: list.length, minDate: min, maxDate: max, authors: authorList, days: dayList }
+}
+
+/**
+ * 作者分布按 Others 阈值拆分：占比 ≥ 阈值% 的保留，其余并入「其他」。
+ * @author ddj 2026年09月17号
+ * @param authorList 作者分布（降序）
+ * @param othersPct 阈值（占总数百分比，0 = 不合并）
+ * @param total 总修订数
+ * @returns main 保留项（附 tone 下标）/ otherCount 其他合计
+ */
+function splitAuthors(authorList, othersPct, total) {
+  const main = []
+  let otherCount = 0
+  for (const a of authorList) {
+    if (total > 0 && (a.count / total) * 100 < othersPct) { otherCount += a.count; continue }
+    main.push(a)
+  }
+  return { main, otherCount }
+}
+
+/**
+ * 概要行（总数 / 期间 / 作者数）。
+ * @author ddj 2026年09月17号
+ * @param props.stats 聚合结果
+ * @returns 元素
+ */
+function StatsHead(props) {
+  const { stats } = props
+  const period = stats.minDate ? stats.minDate + ' ~ ' + stats.maxDate : '—'
+  return React.createElement('div', { className: 'edrv-svnlog-stat-line' },
+    React.createElement('span', null, '修订总数：' + stats.total),
+    React.createElement('span', null, '期间：' + period),
+    React.createElement('span', null, '作者数：' + stats.authors.length))
+}
+
+/**
+ * 作者横条（占比条形，Other 合并项垫底）。
+ * @author ddj 2026年09月17号
+ * @param props.stats 聚合结果
+ * @param props.othersPct Others 阈值百分比
+ * @returns 元素
+ */
+function AuthorBars(props) {
+  const { stats, othersPct } = props
+  if (!stats.total) return null
+  const { main, otherCount } = splitAuthors(stats.authors, othersPct, stats.total)
+  const row = (a, tone, name) => React.createElement('div', { key: a.key || name, className: 'edrv-svnlog-stat-row' },
+    React.createElement('span', { className: 'edrv-svnlog-stat-name', title: name }, name),
+    React.createElement('span', { className: 'edrv-svnlog-stat-barwrap' },
+      React.createElement('span', {
+        className: 'edrv-svnlog-stat-bar', style: { width: ((a.count / stats.total) * 100) + '%', background: tone },
+      })),
+    React.createElement('span', { className: 'edrv-svnlog-stat-count' }, String(a.count)))
+  const rows = main.map((a, i) => row(a, TONES[i % TONES.length], a.name))
+  if (otherCount > 0) rows.push(row({ key: '__others__', count: otherCount }, '#888a85', '其他'))
+  return React.createElement('div', { className: 'edrv-svnlog-stat-hist' }, rows)
+}
+
+/**
+ * 作者饼图（conic-gradient；份额低于阈值的并入「其他」灰块）。
+ * @author ddj 2026年09月17号
+ * @param props.stats 聚合结果
+ * @param props.othersPct Others 阈值百分比
+ * @returns 元素
+ */
+function AuthorPie(props) {
+  const { stats, othersPct } = props
+  if (!stats.total) return null
+  const { main, otherCount } = splitAuthors(stats.authors, othersPct, stats.total)
+  const stops = []
+  let at = 0
+  const seg = (share, tone) => {
+    const from = (at / stats.total) * 360
+    at += share
+    const to = (at / stats.total) * 360
+    stops.push(tone + ' ' + from.toFixed(2) + 'deg ' + to.toFixed(2) + 'deg')
+  }
+  for (const [i, a] of main.entries()) seg(a.count, TONES[i % TONES.length])
+  if (otherCount > 0) seg(otherCount, '#888a85')
+  return React.createElement('div', {
+    className: 'edrv-svnlog-stat-pie',
+    style: { background: 'conic-gradient(' + stops.join(',') + ')' },
+    title: main.map((a) => a.name + ' ' + a.count).join('，') + (otherCount ? '，其他 ' + otherCount : ''),
+  })
+}
+
+/**
+ * 按日柱状（normal = 每日总量；stacked = 按作者分段，超出上限并入「其他」）。
+ * @author ddj 2026年09月17号
+ * @param props.stats 聚合结果
+ * @param props.stacked 是否按作者分段
+ * @returns 元素
+ */
+function DayBars(props) {
+  const { stats, stacked } = props
+  if (!stats.days.length) return null
+  const max = Math.max(1, ...stats.days.map((d) => d.count))
+  const topKeys = stats.authors.slice(0, STACK_TOP).map((a) => a.key)
+  const toneOf = (key) => {
+    const at = topKeys.indexOf(key)
+    return at >= 0 ? TONES[at % TONES.length] : '#888a85'
+  }
+  const column = (d) => {
+    const segs = []
+    if (stacked) {
+      const rest = { count: 0 }
+      for (const [key, count] of d.byKey) {
+        if (!topKeys.includes(key)) { rest.count += count; continue }
+        segs.push({ key, count })
+      }
+      if (rest.count > 0) segs.push({ key: '__others__', count: rest.count })
+    } else {
+      segs.push({ key: '__all__', count: d.count })
+    }
+    return React.createElement('div', {
+      key: d.day, className: 'edrv-svnlog-stat-day',
+      title: d.day + '：' + d.count + ' 条',
+    },
+      segs.map((s) => React.createElement('span', {
+        key: s.key, className: 'edrv-svnlog-stat-seg',
+        style: { height: ((s.count / max) * 100) + '%', background: stacked ? toneOf(s.key) : '#3465a4' },
+      })))
+  }
+  return React.createElement('div', { className: 'edrv-svnlog-stat-days' }, stats.days.map(column))
+}
+
+/**
+ * 统计窗（嵌套在日志弹窗之上；z-index 192 落在既有阶梯内）。
+ * @author ddj 2026年09月17号
+ * @param props.entries 参与统计的条目（当前显示列表）
+ * @param props.onClose 关闭回调
+ * @returns 弹窗元素
+ */
+export function SvnLogStats(props) {
+  const { entries, onClose } = props
+  const [ci, setCi] = React.useState(false)
+  const [othersPct, setOthersPct] = React.useState(0)
+  const [stacked, setStacked] = React.useState(false)
+  const stats = React.useMemo(() => svnLogStatsOf(entries, { caseInsensitive: ci }), [entries, ci])
+  return React.createElement(ModalShell, {
+    dialogClass: 'edrv-svnlog-stats',
+    width: 'min(680px, calc(100vw - 40px))',
+    zIndex: 192,
+    closeOnEsc: false,
+    onClose,
+  },
+    React.createElement('div', { className: 'edrv-svnlog-stats-head' },
+      React.createElement('h3', { className: 'edrv-svnlog-title' }, 'Statistics'),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', { className: 'edrv-svn-act', title: '关闭', onClick: onClose }, '✕')),
+    (stats.total === 0
+      ? React.createElement('div', { className: 'edrv-svnlog-stats-body' },
+          React.createElement('div', { className: 'edrv-tree-loading' }, '暂无可统计的条目'))
+      : React.createElement('div', { className: 'edrv-svnlog-stats-body' },
+          React.createElement(StatsHead, { stats }),
+          React.createElement('div', { className: 'edrv-svnlog-stat-block' },
+            React.createElement('div', { className: 'edrv-svnlog-stat-label' },
+              'Commits by author',
+              React.createElement('label', { className: 'edrv-svnlog-check', title: '作者名不区分大小写归并统计' },
+                React.createElement('input', { type: 'checkbox', checked: ci, onChange: (e) => setCi(e.target.checked) }),
+                'Authors case insensitive'),
+              React.createElement('label', { className: 'edrv-svnlog-check', title: '占比低于阈值的作者并入「其他」' },
+                '其他阈值 ' + othersPct + '%',
+                React.createElement('input', { type: 'range', min: 0, max: 50, step: 5, value: othersPct, onChange: (e) => setOthersPct(Number(e.target.value)) }))),
+            React.createElement('div', { className: 'edrv-svnlog-stat-duo' },
+              React.createElement(AuthorBars, { stats, othersPct }),
+              React.createElement(AuthorPie, { stats, othersPct }))),
+          React.createElement('div', { className: 'edrv-svnlog-stat-block' },
+            React.createElement('div', { className: 'edrv-svnlog-stat-label' },
+              'Commits by date',
+              React.createElement('label', { className: 'edrv-svnlog-check', title: '按作者分段堆叠（前 ' + STACK_TOP + ' 位作者，其余并入「其他」）' },
+                React.createElement('input', { type: 'checkbox', checked: stacked, onChange: (e) => setStacked(e.target.checked) }),
+                'stacked')),
+            React.createElement(DayBars, { stats, stacked })))))
+}

package/src/client/ui/commandCatalog.ts

@@ -7,6 +7,9 @@
  * 作者 ddj 2026年09月10号
  */
 import { hasEditorModel, hasOpenTabs } from '../editorModelState.js'
+import { svnCurrentStatus } from '../svnStatus.js'
+import { svnActionOn, svnActionsFor } from '../../shared/svnActions.js'
+import type { SvnActionDef } from '../../shared/svnActions.js'
 
 /** 一条编辑器指令（展示 + 执行 + 可用性）。 */
 export interface CommandDef {
@@ -105,6 +108,68 @@ function closeTabDef(): CommandDef {
   }
 }
 
+/**
+ * 命令栏专用 SVN 动作（从 shared 动作目录生成；F1 收敛后命令栏不再手写动作清单）。
+ *
+ * 为什么这样：P3/P4 每加一个 SVN 动作，命令栏/树菜单/页签菜单三处都要改，
+ * 且显隐条件会在三处各自漂移。现在动作元数据只有一份（shared/svnActions.ts），
+ * 这里只负责「映射成命令定义」，新增动作无需改本文件。
+ *
+ * @author ddj 2026年09月16号
+ * @returns 命令定义数组
+ */
+function svnPaletteDefs(): CommandDef[] {
+  return svnActionsFor('palette').map((action) => ({
+    id: action.commandId ?? ('edrv.svn' + action.id),
+    label: 'SVN ' + action.label,
+    category: 'SVN',
+    order: action.order,
+    available: () => {
+      const status = svnCurrentStatus()
+      const ready = Boolean(status?.managed)
+      const cli = Boolean(status?.svnCli)
+      const tortoise = Boolean(status?.tortoise)
+      // 命令栏作用于「活动文件」：有编辑器模型时按 file 求值（与 svnEditorActions 同口径）。
+      // 若恒用 'editor'，file/directory 类动作（查看日志/加入/还原）会因 targets 不含 editor
+      // 被整体过滤——svnStatus.ts 注释警告过的同款坑（2026-09-18 实测命令栏缺「查看日志」）。
+      const hasModel = hasEditorModel()
+      if (!svnActionOn(action, {
+        managed: ready, svnCli: cli, tortoise, target: hasModel ? 'file' : 'editor',
+        versioned: true, diffable: true,
+      })) return false
+      // 需要活动文件的动作（命令栏语义）额外要求编辑器模型
+      if (action.needsEditorModel && !hasModel) return false
+      return true
+    },
+    run: () => emit(svnEventOf(action)),
+  }))
+}
+
+/**
+ * 动作 → 命令事件后缀（`edrv.command.<后缀>`）。
+ * 与既有事件名保持兼容：update/diff-base/add/revert 沿用历史后缀，新动作按驼峰拼接。
+ * @author ddj 2026年09月16号
+ * @param action 动作定义
+ * @returns 事件后缀
+ */
+function svnEventOf(action: SvnActionDef): string {
+  const legacy: Record<string, string> = {
+    update: 'svnUpdate',
+    'refresh-changes': 'svnRefreshChanges',
+    'diff-base': 'svnDiffBase',
+    add: 'svnAdd',
+    revert: 'svnRevertCli',
+    log: 'svnLog',
+    cleanup: 'svnCleanup',
+    'tortoise-commit': 'svnTortoiseCommit',
+    'tortoise-log': 'svnTortoiseLog',
+    'tortoise-diff': 'svnTortoiseDiff',
+    'tortoise-blame': 'svnTortoiseBlame',
+    'tortoise-revert': 'svnTortoiseRevert',
+  }
+  return legacy[action.id] ?? ('svn' + action.id)
+}
+
 /**
  * 编辑器内置指令目录（顺序 = 快捷键设置页展示顺序）。
  * 前置 8 条的键位由 EditorView / QuickOpen 自行 capture 监听（历史实现），
@@ -132,6 +197,11 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
     keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
     run: () => emit('searchInFiles'),
   },
+  {
+    id: 'edrv.showLogs', label: '查看诊断日志', category: '视图', order: 30,
+    available: alwaysAvailable,
+    run: () => emit('showLogs'),
+  },
   {
     id: 'edrv.navigateBack', label: '后退（导航历史）', category: '导航', order: 10,
     keybinding: 'Alt+ArrowLeft|Ctrl+Alt+-', available: needsModel,
@@ -182,6 +252,8 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
     available: needsModel,
     run: () => emit('insertSnippet'),
   },
+  // SVN（动作清单来自 shared/svnActions.ts：三入口共用一份显隐规则）
+  ...svnPaletteDefs(),
 ]
 
 /**

package/src/debugLog.ts

@@ -1,15 +1,17 @@
 /**
- * dsh-vscode-mode host — 诊断文件通道（client 上报 → 缓冲批量落盘）。
+ * dsh-vscode-mode host — 诊断文件通道（client 上报 → 缓冲批量落盘）+ 日志文件管理。
  * 通道：edrv.debug RPC → 内存缓冲（满/空闲触发）→ 串行读改写
  *       `~/.dsh/dsh-vscode-mode/logs/debug.<cwdHash>.log`（512KB 上限截断保留尾部）。
  * 设计：console 不一定落盘，文件可靠；写失败静默忽略（调试日志不阻塞业务）。
- * 迁移自 src/rpc.ts（enqueueDebug/flushDebug），逻辑一字不改，仅终端回显改走统一日志器。
- * 作者 ddj 2026-09-08
+ * 管理：edrv.dlog.* RPC 用的清单/尾部读取/清空三能力；file 参数一律先过
+ *       isDebugLogName 白名单（纯文件名、无路径分隔），杜绝穿越出日志根。
+ * 作者 ddj 2026-09-08 / 2026-09-17
  */
-import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { mkdir, readFile, readdir, rm, stat, truncate, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
-import { DEBUG_LOG, debugLogFile, pluginLogRoot } from './paths.js'
+import { DEBUG_LOG, dshHome, debugLogFile, pluginLogRoot } from './paths.js'
 import { log } from './log.js'
+import type { LoggerLevel } from './shared/logger.js'
 import type { Ctx } from './store.js'
 
 /** cwd → 内存缓冲：行数组 + 累计字节数 + 待触发 flush 定时器（攒批落盘，避免每条日志全文件读改写）。 */
@@ -24,9 +26,22 @@ const DEBUG_BUF_CAP = 32 * 1024
 const DEBUG_FLUSH_IDLE_MS = 1000
 /** cwd → 已清理旧工作区 debug 日志标记（一次性）。 */
 const debugLegacyCleaned = new Set<string>()
-/** 诊断回显日志器（终端回显统一带 `[dsh-vscode-mode:debug]` 前缀）。 */
+/** 诊断回显日志器（终端回显统一带 `[dsh-vscode-mode:debug]` 前缀，级别跟随上报级别）。 */
 const debugLog = log.child('debug')
 
+/** 诊断日志文件名白名单（cwd hash 命名；请求回传的 file 参数必须整名匹配，防路径穿越）。 */
+const DEBUG_LOG_NAME = /^debug\.[0-9a-f]{16}\.log$/
+
+/**
+ * 文件名是否为合法诊断日志名（白名单整名匹配，杜绝路径穿越）。
+ * @author ddj 2026年09月17号
+ * @param name 请求回传的文件名（可为空）
+ * @returns 是否合法
+ */
+export function isDebugLogName(name: string | null | undefined): name is string {
+  return typeof name === 'string' && DEBUG_LOG_NAME.test(name)
+}
+
 /**
  * 批量落盘一条 debug 日志缓冲：读旧文件 → 追加 → 超上限截断保留尾部 → 一次写回。
  * 串行链保证同一 cwd 的读改写不交错丢行；写失败静默忽略（调试日志不阻塞业务）。
@@ -56,16 +71,19 @@ function flushDebug(cwd: string, batch: string[]): Promise<void> {
 }
 
 /**
- * 记录一条 client 上报的诊断日志：入队缓冲批量落盘 + 终端回显（`[dsh-vscode-mode:debug]` 前缀）。
- * @author ddj 2026年09月08号
+ * 记录一条 client 上报的诊断日志：入队缓冲批量落盘 + 终端回显（级别跟随，缺省 debug）。
+ * 落盘行格式 `<iso> [level] text`；级别标记在入队时补齐，flush 侧无感。
+ * @author ddj 2026年09月08号 / 2026年09月17号
  * @param _ctx DSH 上下文（入参保留：诊断通道按 cwd 隔离，当前不需要 ctx，未来过滤用）
  * @param cwd 工作区（日志文件按 cwd hash 隔离）
  * @param text 单条日志文本（不含换行）
+ * @param level 日志级别（缺省 debug；落盘行与终端回显均带此级别）
  */
-export function debugRecord(_ctx: Ctx, cwd: string, text: string): void {
+export function debugRecord(_ctx: Ctx, cwd: string, text: string, level: LoggerLevel = 'debug'): void {
+  const tagged = '[' + level + '] ' + text
   const st = debugBuffers.get(cwd) ?? { lines: [], len: 0, timer: null }
-  st.lines.push(text)
-  st.len += text.length
+  st.lines.push(tagged)
+  st.len += tagged.length
   const flush = () => {
     st.timer = null
     const batch = st.lines
@@ -80,5 +98,56 @@ export function debugRecord(_ctx: Ctx, cwd: string, text: string): void {
     st.timer = setTimeout(flush, DEBUG_FLUSH_IDLE_MS)
   }
   debugBuffers.set(cwd, st)
-  debugLog.error(text)
+  debugLog[level](text)
+}
+
+/**
+ * 清单：日志根下全部诊断日志文件（名字/字节/mtime；非法名跳过），mtime 新的在前。
+ * @author ddj 2026年09月17号
+ * @param home DSH home（测试可注入；缺省按环境解析）
+ * @returns 清单项数组
+ */
+export async function listDebugLogs(home = dshHome()): Promise<{ name: string; bytes: number; mtimeMs: number }[]> {
+  const names = await readdir(pluginLogRoot(home)).catch(() => [] as string[])
+  const items: { name: string; bytes: number; mtimeMs: number }[] = []
+  for (const name of names) {
+    if (!isDebugLogName(name)) continue
+    const info = await stat(join(pluginLogRoot(home), name)).catch(() => null)
+    if (!info?.isFile()) continue
+    items.push({ name, bytes: info.size, mtimeMs: info.mtimeMs })
+  }
+  items.sort((a, b) => b.mtimeMs - a.mtimeMs)
+  return items
+}
+
+/**
+ * 尾部读取一份诊断日志：保留文件尾 maxBytes 字节（缺省 256KB），truncated 标记截头。
+ * 单文件本体受 DEBUG_LOG_CAP=512KB 约束，整读为字符串的成本可接受。
+ * @author ddj 2026年09月17号
+ * @param name 日志文件名（isDebugLogName 白名单校验，非法直接 null）
+ * @param maxBytes 尾部保留字节数（缺省 256KB）
+ * @param home DSH home（测试可注入）
+ * @returns 读取结果；文件不存在或名字非法返回 null
+ */
+export async function readDebugLog(name: string | null | undefined, maxBytes = 256 * 1024, home = dshHome()): Promise<{ name: string; path: string; content: string; size: number; truncated: boolean } | null> {
+  if (!isDebugLogName(name)) return null
+  const target = join(pluginLogRoot(home), name)
+  const info = await stat(target).catch(() => null)
+  if (!info?.isFile()) return null
+  const text = await readFile(target, 'utf8').catch(() => null)
+  if (text === null) return null
+  const cut = Math.max(0, text.length - maxBytes)
+  return { name, path: target, content: cut > 0 ? text.slice(cut) : text, size: info.size, truncated: cut > 0 }
+}
+
+/**
+ * 清空一份诊断日志（truncate 到 0，保留文件本身）。
+ * @author ddj 2026年09月17号
+ * @param name 日志文件名（isDebugLogName 白名单校验）
+ * @param home DSH home（测试可注入）
+ * @returns 是否清空成功（文件不存在视为未成功，文案由调用方给）
+ */
+export async function clearDebugLog(name: string | null | undefined, home = dshHome()): Promise<boolean> {
+  if (!isDebugLogName(name)) return false
+  return await truncate(join(pluginLogRoot(home), name)).then(() => true).catch(() => false)
 }

package/src/fileOpenSettings.ts

@@ -12,12 +12,13 @@ import { pathToFileURL } from 'node:url'
 import type { Ctx } from './store.js'
 import { KEYBINDING_DEFAULTS } from './shared/keybindings.js'
 import { INTEGRATION_BASE_DEFAULT } from './shared/integration.js'
+import { TORTOISE_DIR_DEFAULT } from './shared/svn.js'
 import type { AiConfigPatch, AiConfigView } from './shared/ai.js'
 import { log } from './log.js'
 
 export const FILE_OPEN_SETTINGS_NS = 'dsh-vscode-mode'
 export const FILE_OPEN_DEFAULT = 'auto'
-export interface FileOpenSettings { fileOpenTool: string; integrationBaseUrl: string }
+export interface FileOpenSettings { fileOpenTool: string; integrationBaseUrl: string; svnPath: string; tortoisePath: string }
 export interface FileOpenSettingsState { value: string; revision?: number; update: (value: string, expectedRevision?: number) => Promise<void> }
 
 /** AI 内联补全配置默认值（默认关闭；路由空 = 自动；档位空 = 跟随模型默认）。 */
@@ -223,6 +224,18 @@ function baseValueOf(config: unknown): string {
   return typeof raw === 'string' && raw.trim() ? raw.trim() : INTEGRATION_BASE_DEFAULT
 }
 
+/** 配置/设置里的 svn CLI 覆盖（空 = 从 PATH 解析 'svn'）。 */
+function svnPathValueOf(config: unknown): string {
+  const raw = (config as { svnPath?: unknown } | undefined)?.svnPath
+  return typeof raw === 'string' ? raw.trim() : ''
+}
+
+/** 配置/设置里的 TortoiseSVN 目录（空 = 默认安装目录）。 */
+function tortoiseDirValueOf(config: unknown): string {
+  const raw = (config as { tortoisePath?: unknown } | undefined)?.tortoisePath
+  return typeof raw === 'string' && raw.trim() ? raw.trim() : TORTOISE_DIR_DEFAULT
+}
+
 /**
  * 安装设置 section（版本自适应；任一策略不可用返回 false 不抛错）。
  * @author ddj 2026年08月24号 / 2026年09月02号
@@ -257,6 +270,9 @@ export async function installOpenSettingsSection(
     aiProvider: deps.z.string().default(AI_CONFIG_DEFAULT.provider),
     aiModel: deps.z.string().default(AI_CONFIG_DEFAULT.model),
     aiEffort: deps.z.string().default(AI_CONFIG_DEFAULT.effort),
+    // SVN 能力：svn CLI 覆盖（空 = PATH）与 TortoiseSVN 目录（Windows 过渡增强）
+    svnPath: deps.z.string().default(''),
+    tortoisePath: deps.z.string().default(TORTOISE_DIR_DEFAULT),
   })
   const strategy = await runSettingsInstall(ctx, ns, schema, entry, {
     setSource: (source) => hooks.setSource(source as () => FileOpenSettings),
@@ -284,7 +300,7 @@ function aiValueOf(stored: unknown): { enabled: boolean; provider: string; model
  * @param onChange 设置变化回调
  * @returns 设置状态（fileOpenTool 值 + AI 补全配置读写）
  */
-export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: string) => void): FileOpenSettingsState & { ai: () => AiConfigView; aiUpdate: (patch: AiConfigPatch, expectedRevision?: number) => Promise<AiConfigView> } {
+export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: string) => void): FileOpenSettingsState & { ai: () => AiConfigView; aiUpdate: (patch: AiConfigPatch, expectedRevision?: number) => Promise<AiConfigView>; svn: () => { svnPath: string; tortoisePath: string } } {
   let current = configValue(config)
   let revision: number | undefined
   let provider: SettingsProvider | undefined
@@ -304,10 +320,29 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
     aiCurrent = stored !== undefined ? aiValueOf(stored) : aiCurrent
   }
 
-  void installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, { fileOpenTool: current, integrationBaseUrl: baseValueOf(config) }, {
+  /** SVN 路径当前值（settings 未就绪回退配置值）。 */
+  let svnCurrent: { svnPath: string; tortoisePath: string } = {
+    svnPath: svnPathValueOf(config),
+    tortoisePath: tortoiseDirValueOf(config),
+  }
+  const svnSync = (stored: unknown): void => {
+    svnCurrent = { svnPath: svnPathValueOf(stored), tortoisePath: tortoiseDirValueOf(stored) }
+  }
+  /** 读取 settings 存储值（describe 未就绪返回 undefined）。 */
+  const storedValue = (): unknown => {
+    return provider?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === FILE_OPEN_SETTINGS_NS)?.value
+  }
+
+  void installOpenSettingsSection(ctx, FILE_OPEN_SETTINGS_NS, {
+    fileOpenTool: current,
+    integrationBaseUrl: baseValueOf(config),
+    svnPath: svnCurrent.svnPath,
+    tortoisePath: svnCurrent.tortoisePath,
+  }, {
     setSource: (source) => {
       notify(source().fileOpenTool)
       aiCurrent = aiValueOf(source())
+      svnSync(source())
       syncRevision()
     },
     onChange: settingsChange,
@@ -315,6 +350,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
   ctx.inject?.(['settings'], (settingsCtx: Ctx) => {
     provider = settingsCtx.get('settings')
     aiSync()
+    svnSync(storedValue())
     syncRevision()
   })
 
@@ -331,6 +367,7 @@ export function setupOpenSettings(ctx: Ctx, config: unknown, onChange: (value: s
       syncRevision()
     },
     ai: () => aiCurrent,
+    svn: () => svnCurrent,
     aiUpdate: async (patch: AiConfigPatch, expectedRevision?: number): Promise<AiConfigView> => {
       if (!provider?.update) {
         // settings 不可用：内存态生效（重启回落默认），保持与 fileOpenTool 的降级语义一致

package/src/index.ts

@@ -26,6 +26,7 @@ import { createLspRpc } from './lsp/rpc.js'
 import { disposeAllServers, hookExitReclaim } from './lsp/transport.js'
 import { createAiRpc } from './ai/rpc.js'
 import { createFileVersions } from './fileVersions.js'
+import { createSvnRpc } from './svn.js'
 import { installRulesSection } from './rules.js'
 import { installSkillGroup } from './skills.js'
 import type { RpcHandlerMap } from './shared/rpc.js'
@@ -66,6 +67,9 @@ export function apply(ctx: Ctx, config?: unknown): void {
   /** AI 内联补全 RPC（settings 状态桥接 + llm 惰性获取）。 */
   const aiRpc = createAiRpc({ ctx, settings: openSettings })
   const aiHandlers: Partial<RpcHandlerMap> = aiRpc.handlers
+  /** SVN RPC（检测/更新/Tortoise 发射；settings 提供 svnPath/tortoisePath）。 */
+  const svnRpc = createSvnRpc({ ctx, settings: openSettings })
+  const svnHandlers: Partial<RpcHandlerMap> = svnRpc.handlers as Partial<RpcHandlerMap>
   /** 文件磁盘新鲜度观察器（客户端轮询 edrv.versions；变化时顺带失效目录树缓存）。 */
   const fileVersions = createFileVersions(ctx)
 
@@ -86,7 +90,7 @@ export function apply(ctx: Ctx, config?: unknown): void {
     if (typeof sid === 'string') lspRpc.disposeSession(sid)
   })
 
-  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions), (warning) => warnings.push(warning))
+  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions, svnHandlers), (warning) => warnings.push(warning))
   installIsolation(ctx)
   // 系统集成生命周期：启动自动恢复右键菜单注册（marker 存在时）；插件卸载/reload 清理注册痕迹
   ctx.effect(() => shellMenuLifecycle(ctx))