dsh-vscode-mode 0.4.6 → 0.5.0

package/src/client/svnStatus.ts

@@ -0,0 +1,363 @@
+/**
+ * dsh-vscode-mode client — SVN 能力状态层与动作执行。
+ *
+ * 数据源（status/changes）统一经 svnStore 工厂创建：scope 缓存 + 在途去重 + 事件广播 +
+ * 「失败不写缓存」语义由工厂单点保证，本模块只负责各自的 select 与消费侧投影。
+ * 状态：ensureSvnStatus → `edrv:svn-status`（命令/菜单显隐数据源）。
+ * 变更（P2）：ensureSvnChanges → `edrv:svn-changes`（面板列表 + 文件树徽标查表）。
+ * 动作：svnUpdate / svnTortoise / svnRevert / svnAdd / svnDiffBase 统一执行与反馈文案。
+ * 作者 ddj 2026年09月16号
+ */
+import type { SvnAction, SvnChangeEntry, SvnItemStatus, SvnStatusPayload, SvnUpdateEntry } from '../shared/svn.js'
+import { SVN_TORTOISE_LABELS, SVN_UPDATE_LABEL } from '../shared/svn.js'
+import { svnActionOn, svnActionsFor } from '../shared/svnActions.js'
+import type { SvnActionContext } from '../shared/svnActions.js'
+import { createSvnStore } from './svnStore.js'
+import { rpc } from './rpc.js'
+
+/** SVN 能力状态数据源（未加载 = null，菜单/命令随之隐藏）。 */
+const statusStore = createSvnStore<'svn.status', SvnStatusPayload>({
+  method: 'svn.status',
+  event: 'edrv:svn-status',
+  select: (res) => ({ value: res as unknown as SvnStatusPayload }),
+})
+
+/** 工作副本变更数据源（未加载 = null；已加载无变更 = 空数组）。 */
+const changesStore = createSvnStore<'svn.changes', SvnChangeEntry[]>({
+  method: 'svn.changes',
+  event: 'edrv:svn-changes',
+  select: (res) => ({
+    value: Array.isArray(res.entries) ? (res.entries as SvnChangeEntry[]) : [],
+    meta: { truncated: res.truncated === true, wcRoot: res.wcRoot },
+  }),
+})
+
+/**
+ * 拉取（或命中缓存的）SVN 状态：成功后写缓存并广播。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id（缺省时 host 按唯一活跃会话解析）
+ * @param scope 状态作用域（工作区优先；无 scope 不拉取）
+ * @param force 跳过客户端与 host 缓存强制重测
+ */
+export function ensureSvnStatus(sessionId: string | undefined, scope: string | null | undefined, force = false): void {
+  statusStore.ensure(sessionId, scope, force)
+}
+
+/** 读取指定 scope 的状态（未加载返回 null）。 */
+export function getSvnStatus(scope: string | null | undefined): SvnStatusPayload | null {
+  return statusStore.get(scope)
+}
+
+/** 命令面板可用性：最近一次加载判定「受管理且 svn CLI 可用」。 */
+export function svnFeatureReady(): boolean {
+  const latest = statusStore.latest()
+  return Boolean(latest?.managed && latest.svnCli)
+}
+
+/** 最近一次加载的 SVN 能力状态（动作目录求值用；未加载返回 null）。 */
+export function svnCurrentStatus(): SvnStatusPayload | null {
+  return statusStore.latest()
+}
+
+/** 命令面板可用性：最近一次加载判定「受管理且 TortoiseProc 可用」。 */
+export function tortoiseUsable(): boolean {
+  const latest = statusStore.latest()
+  return Boolean(latest?.managed && latest.tortoise)
+}
+
+/**
+ * 强制重测（工作区「刷新」按钮/设置变更后）：清缓存并 force 拉取。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param scope 状态作用域
+ */
+export function refreshSvnStatus(sessionId: string | undefined, scope: string | null | undefined): void {
+  statusStore.refresh(sessionId, scope)
+}
+
+/**
+ * 拉取（或命中缓存的）工作副本变更：成功后写缓存并广播 `edrv:svn-changes`。
+ * 未受管理/CLI 不可用时保持「未加载」语义（不写空数组，避免把「未知」当「无变更」）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param scope 状态作用域
+ * @param force 跳过 host 端 TTL 强制重查
+ */
+export function ensureSvnChanges(sessionId: string | undefined, scope: string | null | undefined, force = false): void {
+  changesStore.ensure(sessionId, scope, force)
+}
+
+/**
+ * 读取指定 scope 的变更清单（未加载返回 null；已加载但无变更返回空数组）。
+ * @author ddj 2026年09月16号
+ * @param scope 状态作用域
+ * @returns 变更清单或 null
+ */
+export function getSvnChanges(scope: string | null | undefined): SvnChangeEntry[] | null {
+  return changesStore.get(scope)
+}
+
+/**
+ * 变更清单是否被条目上限截断（面板提示用）。
+ * @author ddj 2026年09月16号
+ * @param scope 状态作用域
+ * @returns 是否截断
+ */
+export function svnChangesCapped(scope: string | null | undefined): boolean {
+  return changesStore.meta(scope).truncated === true
+}
+
+/**
+ * 路径 → 变更条目映射（文件树徽标 O(1) 查表；未加载返回空表）。
+ * 同一路径出现多条时保留首条（svn status 对单路径只报一条）。
+ * @author ddj 2026年09月16号
+ * @param scope 状态作用域
+ * @returns 相对路径（`/` 分隔）→ 条目
+ */
+export function svnChangeMapOf(scope: string | null | undefined): Record<string, SvnChangeEntry> {
+  const entries = getSvnChanges(scope)
+  if (!entries) return {}
+  const map: Record<string, SvnChangeEntry> = {}
+  for (const entry of entries) {
+    if (!(entry.path in map)) map[entry.path] = entry
+  }
+  return map
+}
+
+/**
+ * 强制刷新变更（面板 ⟳ / 提交后 / update 后）：清缓存并 force 重查。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param scope 状态作用域
+ */
+export function refreshSvnChanges(sessionId: string | undefined, scope: string | null | undefined): void {
+  changesStore.refresh(sessionId, scope)
+}
+
+/**
+ * 丢弃变更缓存（工作副本被外部改动后强制下次重查）。
+ * @author ddj 2026年09月16号
+ * @param scope 状态作用域（缺省清空全部）
+ */
+export function clearSvnChanges(scope?: string | null): void {
+  changesStore.clear(scope)
+}
+
+/** 命令面板可用性：最近一次加载判定「受管理且 svn CLI 可用且存在变更」。 */
+export function svnChangesReady(): boolean {
+  const latest = statusStore.latest()
+  const entries = changesStore.latest()
+  return Boolean(latest?.managed && latest.svnCli && entries && entries.length > 0)
+}
+
+/** 动作执行统一结果（message 已可直接落状态栏/notify）。 */
+export interface SvnActionOutcome {
+  ok: boolean
+  message: string
+  /** update 的条目级明细（仅 svnUpdate 填充）。 */
+  entries?: SvnUpdateEntry[]
+  /** update 的冲突路径清单（仅 svnUpdate 填充）。 */
+  conflicts?: string[]
+}
+
+/**
+ * 执行 svn update（CLI，全平台；path 工作区相对，'' = 工作区根）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param path 目标相对路径
+ * @returns 执行结果与反馈文案
+ */
+export async function svnUpdate(sessionId: string | undefined, path: string): Promise<SvnActionOutcome> {
+  try {
+    const res = await rpc('svn.update', { sessionId, path })
+    if (!res.ok) return { ok: false, message: 'SVN 更新失败：' + res.error }
+    const conflicts = res.conflicts.length ? '；冲突：' + res.conflicts.join('、') : ''
+    // P3：附带条目级明细，供编辑区结果条逐条展示（冲突高亮）
+    return { ok: true, message: 'SVN 更新：' + res.summary + conflicts, entries: res.entries ?? [], conflicts: res.conflicts ?? [] }
+  } catch (error) {
+    return { ok: false, message: 'SVN 更新失败：' + String(error) }
+  }
+}
+
+/**
+ * 发射 TortoiseSVN 对话框（Windows 过渡增强）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param action Tortoise 动作
+ * @param path 目标相对路径（文件/目录）
+ * @returns 执行结果与反馈文案
+ */
+export async function svnTortoise(sessionId: string | undefined, action: SvnAction, path: string): Promise<SvnActionOutcome> {
+  try {
+    const res = await rpc('svn.tortoise', { sessionId, action, path })
+    if (!res.ok) return { ok: false, message: 'TortoiseSVN 启动失败：' + res.error }
+    return { ok: true, message: '已打开：' + SVN_TORTOISE_LABELS[action] }
+  } catch (error) {
+    return { ok: false, message: 'TortoiseSVN 启动失败：' + String(error) }
+  }
+}
+
+/**
+ * 基线差异结果（左侧 BASE 可为 null：added/未提交条目没有 pristine）。
+ * reason 为 'no-pristine' 时属正常业务分支，调用方应提示而非报错。
+ */
+export interface SvnDiffBaseOutcome {
+  ok: boolean
+  /** 左侧（BASE 版本）内容；null = 无 pristine。 */
+  base: string | null
+  /** 右侧（工作区磁盘内容）。 */
+  working: string
+  /** 无 BASE 时的原因（'no-pristine' | 'cat-failed'）。 */
+  reason?: string
+  /** 失败提示文案（ok=false，或 ok=true 时的补充说明）。 */
+  message: string
+}
+
+/**
+ * 读取基线差异（BASE 左 / 工作区右）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param path 工作区相对路径
+ * @returns 双侧内容或错误文案
+ */
+export async function svnDiffBase(sessionId: string | undefined, path: string): Promise<SvnDiffBaseOutcome> {
+  try {
+    const res = await rpc('svn.diffBase', { sessionId, path })
+    if (!res.ok) return { ok: false, base: null, working: '', message: '读取基线失败：' + res.error }
+    if (res.base === null) {
+      const message = res.reason === 'no-pristine'
+        ? '该文件尚无基线版本（未提交的新增文件）'
+        : '读取基线失败' + (res.error ? '：' + res.error : '')
+      return { ok: true, base: null, working: res.working, message }
+    }
+    return { ok: true, base: res.base, working: res.working, message: '已打开基线差异' }
+  } catch (error) {
+    return { ok: false, base: null, working: '', message: '读取基线失败：' + String(error) }
+  }
+}
+
+/**
+ * 批量还原（`svn revert -R`，CLI 全平台；新增文件不会被删除）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param paths 工作区相对路径列表
+ * @returns 执行结果与反馈文案
+ */
+export async function svnRevert(sessionId: string | undefined, paths: string[]): Promise<SvnActionOutcome> {
+  try {
+    const res = await rpc('svn.revert', { sessionId, paths })
+    if (!res.ok) return { ok: false, message: 'SVN 还原失败：' + res.error }
+    return { ok: true, message: 'SVN 还原：' + res.summary }
+  } catch (error) {
+    return { ok: false, message: 'SVN 还原失败：' + String(error) }
+  }
+}
+
+/**
+ * 批量加入版本控制（`svn add`）。
+ * @author ddj 2026年09月16号
+ * @param sessionId 会话 id
+ * @param paths 工作区相对路径列表
+ * @returns 执行结果与反馈文案
+ */
+export async function svnAdd(sessionId: string | undefined, paths: string[]): Promise<SvnActionOutcome> {
+  try {
+    const res = await rpc('svn.add', { sessionId, paths })
+    if (!res.ok) return { ok: false, message: '加入版本控制失败：' + res.error }
+    return { ok: true, message: '加入版本控制：' + res.summary }
+  } catch (error) {
+    return { ok: false, message: '加入版本控制失败：' + String(error) }
+  }
+}
+
+/**
+ * Monaco 右键菜单 SVN 动作条目（编辑区动态注册用）。
+ *
+ * 与树/页签菜单同源：条目来自 shared 动作目录（surface='tab'），显隐规则经 svnActionOn
+ * 求值（含「自研替换时间线」的能力覆盖判定），故不会再出现「编辑区右键只有 Tortoise 项」
+ * 或「自研项漏挂某入口」的不一致。
+ */
+export interface SvnEditorAction {
+  /** Monaco action id（稳定前缀 `edrv.svnEditor*`，与命令栏 id 不同通道）。 */
+  id: string
+  /** 菜单展示文案。 */
+  label: string
+  /** 动作类别：update = 工作区更新（全平台）、cli = 其他自研 CLI 动作、tortoise = 官方对话框。 */
+  kind: 'update' | 'cli' | 'tortoise'
+  /** 直接执行的自研动作 id（kind = cli/update 时）。 */
+  actionId?: string
+  /** kind = tortoise 时的 Tortoise 动作。 */
+  tortoiseAction?: SvnAction
+}
+
+/** 动作 id → Monaco action id 后缀（保持历史 id 稳定：既有 id 不因重构而变）。 */
+const EDITOR_ACTION_ID: Record<string, string> = {
+  update: 'Update',
+  'diff-base': 'Diff',
+  add: 'Add',
+  'revert-cli': 'Revert',
+  log: 'Log',
+  'tortoise-commit': 'Commit',
+  'tortoise-log': 'TortoiseLog',
+  'tortoise-diff': 'TortoiseDiff',
+  'tortoise-blame': 'Blame',
+  'tortoise-revert': 'TortoiseRevert',
+}
+
+/**
+ * 按状态推导编辑区右键 SVN 动作表（纯函数；未检出/未受管理返回空 = 整组隐藏）。
+ *
+ * 复用 surface='tab' 的动作集合（页签与编辑区都针对「当前文件」这一语义），
+ * 并注入活动文件的版本控制状态供状态门禁求值。被自研能力覆盖的 Tortoise 项
+ * （差异/还原/日志）按时间线自动隐藏，留提交与追溯。
+ *
+ * @author ddj 2026年09月16号
+ * @param status SVN 能力状态（未加载传 null）
+ * @param target 活动文件的版本控制信息（缺省按「受版本控制、可比较」处理）
+ * @returns 动作描述表
+ */
+export function svnEditorActions(
+  status: SvnStatusPayload | null,
+  target?: { versioned?: boolean; status?: SvnItemStatus; diffable?: boolean },
+): SvnEditorAction[] {
+  if (!status?.managed) return []
+  const ctx: SvnActionContext = {
+    managed: status.managed,
+    svnCli: status.svnCli,
+    tortoise: status.tortoise,
+    svnFeatures: status.svnFeatures,
+    // 编辑区展示的是**一个文件**，故按 target='file' 求值：这样「比较/加入/还原/日志」
+    // 等面向文件的门禁（targets: file/directory）才会命中。若按 'editor' 求值，这些动作
+    // 会因目标类型不匹配而整体消失——P1 动作矩阵里编辑区右键本应有更新/提交/日志/差异/追溯/还原。
+    target: 'file',
+    versioned: target?.versioned ?? true,
+    status: target?.status,
+    diffable: target?.diffable ?? true,
+  }
+  const actions: SvnEditorAction[] = []
+  for (const def of svnActionsFor('tab')) {
+    if (!svnActionOn(def, ctx)) continue
+    const id = 'edrv.svnEditor' + (EDITOR_ACTION_ID[def.id] ?? def.id)
+    if ((def.capability ?? 'cli') === 'tortoise') {
+      actions.push({
+        id,
+        label: def.label,
+        kind: 'tortoise',
+        tortoiseAction: tortoiseActionOf(def.id),
+      })
+    } else {
+      actions.push({ id, label: def.label, kind: def.id === 'update' ? 'update' : 'cli', actionId: def.id })
+    }
+  }
+  return actions
+}
+
+/**
+ * Tortoise 动作 id（`tortoise-<action>`）→ SvnAction。
+ * @author ddj 2026年09月16号
+ * @param id 动作 id
+ * @returns Tortoise 动作名
+ */
+function tortoiseActionOf(id: string): SvnAction {
+  return id.replace(/^tortoise-/, '') as SvnAction
+}

package/src/client/svnStore.ts

@@ -0,0 +1,150 @@
+/**
+ * dsh-vscode-mode client — SVN 数据源通用缓存层（scope 缓存 + 在途去重 + 事件广播）。
+ *
+ * 为什么抽工厂：status/changes 两套实现完全同形（cache/inFlight/latest/emit 四件套），
+ * P3 的 log 与 P4 的 commitPlan 还要再来两遍。重复的不只是十几行样板，更关键的是
+ * 「未加载(null) vs 已加载但为空([])」与「失败不写缓存」这两条语义——各写一遍必然漂移。
+ *
+ * 语义约定（所有 SVN 数据源一致）：
+ * - `get` 未加载返回 null（调用方据此显示「读取中」而非「空」）
+ * - 失败（ok:false / 抛错）**不写缓存**，保持「未加载」，避免把「未知」当「无数据」
+ * - 在途请求按 key 去重：同一 key 并发只看一次 RPC
+ * - `force` 绕过客户端缓存（host 侧 TTL 由 force 参数继续透传）
+ * 作者 ddj 2026年09月16号
+ */
+import type { RpcMethod, RpcRequestMap, RpcResult } from '../shared/rpc.js'
+import { rpc } from './rpc.js'
+
+/**
+ * 轻量诊断 trace（dsh-debug 埋点协议）：写入 window.__DSH_DEBUG_LOG__（环形 500 条），
+ * 浏览器端 readback 定位 RPC/事件链路问题；异常静默，绝不干扰主流程。
+ * @author ddj 2026年09月18号
+ * @param event 事件名（建议 `模块.动作`）
+ * @param data 附加诊断数据（不含敏感信息）
+ */
+export function dshTrace(event: string, data?: unknown): void {
+  try {
+    if (typeof window === 'undefined') return
+    const w = window as unknown as { __DSH_DEBUG_LOG__?: Array<Record<string, unknown>> }
+    const buf = (w.__DSH_DEBUG_LOG__ = w.__DSH_DEBUG_LOG__ || [])
+    buf.push({ t: Date.now(), plugin: 'dsh-vscode-mode', event, data })
+    if (buf.length > 500) buf.splice(0, buf.length - 500)
+  } catch { /* 诊断不干扰主流程 */ }
+}
+
+/** 一个数据源的最小配置。 */
+export interface SvnStoreConfig<M extends RpcMethod, T> {
+  /** 对应的 RPC 方法名。 */
+  method: M
+  /**
+   * 请求参数（除 sessionId/force 外的固定部分按 key 计算）。
+   * @param key 缓存键（scope 或 `scope::目标` 复合键）
+   */
+  args?: (key: string) => Omit<RpcRequestMap[M], 'sessionId' | 'force'>
+  /**
+   * 从成功载荷中抽出要缓存的数据与附带标记。
+   * @param res 成功响应
+   */
+  select: (res: ({ ok: true } & Record<string, unknown>)) => { value: T; meta?: Record<string, unknown> }
+  /** 广播事件名（`edrv:svn-*`）；缺省不广播。 */
+  event?: string
+}
+
+/** 数据源实例（供渲染层读取与命令判定）。 */
+export interface SvnStore<M extends RpcMethod, T> {
+  /**
+   * 拉取（命中缓存或已在途则跳过）。
+   * @param extra 调用期动态参数（如「加载更多」的 limit；覆盖 args 的同名字段，P1-8）
+   */
+  ensure: (sessionId: string | undefined, key: string | null | undefined, force?: boolean, extra?: Record<string, unknown>) => void
+  /** 读缓存（未加载返回 null）。 */
+  get: (key: string | null | undefined) => T | null
+  /** 附带标记（如 truncated）。 */
+  meta: (key: string | null | undefined) => Record<string, unknown>
+  /** 最近一次加载的值（跨 key 镜像；命令可用性判定用）。 */
+  latest: () => T | null
+  /** 清缓存并强制重取。 */
+  refresh: (sessionId: string | undefined, key: string | null | undefined, extra?: Record<string, unknown>) => void
+  /** 丢弃缓存（不重取）。 */
+  clear: (key?: string | null) => void
+  /** 用现成数据直接写入（动作后本地乐观更新/就地改值）。 */
+  put: (key: string, value: T, meta?: Record<string, unknown>) => void
+}
+
+/**
+ * 创建 SVN 数据源缓存实例。
+ * @author ddj 2026年09月16号
+ * @param config 数据源配置
+ * @returns 数据源实例
+ */
+export function createSvnStore<M extends RpcMethod, T>(config: SvnStoreConfig<M, T>): SvnStore<M, T> {
+  const cache = new Map<string, T>()
+  const metas = new Map<string, Record<string, unknown>>()
+  const inFlight = new Map<string, Promise<void>>()
+  let latestValue: T | null = null
+
+  const emit = (key: string): void => {
+    if (!config.event || typeof window === 'undefined') return
+    window.dispatchEvent(new CustomEvent(config.event, { detail: { scope: key, key } }))
+  }
+
+  const ensure = (sessionId: string | undefined, key: string | null | undefined, force = false, extra?: Record<string, unknown>): void => {
+    if (!key || inFlight.has(key)) return
+    if (!force && cache.has(key)) return
+    const fixed = config.args ? config.args(key) : {}
+    const task = rpc(config.method, { ...fixed, ...extra, sessionId, force: force || undefined } as RpcRequestMap[M])
+      .then((res) => {
+        if (!res.ok) {
+          dshTrace('svnStore.rpcError', { method: config.method, key, error: (res as { error?: string }).error })
+          return
+        }
+        const picked = config.select(res as { ok: true } & Record<string, unknown>)
+        cache.set(key, picked.value)
+        if (picked.meta) metas.set(key, picked.meta)
+        latestValue = picked.value
+        emit(key)
+      })
+      .catch((err) => {
+        // 拉取失败保持旧值；未加载过即保持「未加载」（诊断 trace 供 dsh-debug 读回定位）
+        dshTrace('svnStore.fetchError', { method: config.method, key, error: String(err) })
+      })
+      .finally(() => {
+        inFlight.delete(key)
+      })
+    inFlight.set(key, task as Promise<void>)
+  }
+
+  const refresh = (sessionId: string | undefined, key: string | null | undefined, extra?: Record<string, unknown>): void => {
+    if (!key) return
+    cache.delete(key)
+    ensure(sessionId, key, true, extra)
+  }
+
+  return {
+    ensure,
+    get: (key) => (key ? cache.get(key) ?? null : null),
+    meta: (key) => (key ? metas.get(key) ?? {} : {}),
+    latest: () => latestValue,
+    refresh,
+    clear: (key) => {
+      if (key) { cache.delete(key); metas.delete(key) }
+      else { cache.clear(); metas.clear() }
+    },
+    put: (key, value, meta) => {
+      cache.set(key, value)
+      if (meta) metas.set(key, meta)
+      latestValue = value
+      emit(key)
+    },
+  }
+}
+
+/** 复合缓存键（同一数据源按多个维度缓存，如日志按 target 区分）。 */
+export function svnStoreKey(scope: string, target?: string | null): string {
+  return target ? scope + '\u0000' + target : scope
+}
+
+/** 类型守卫：成功响应（便于 select 里安全取字段）。 */
+export function isOkResult<M extends RpcMethod>(res: RpcResult<M>): res is { ok: true } & Record<string, unknown> {
+  return Boolean(res && (res as { ok?: unknown }).ok === true)
+}

package/src/client/tabMenu.ts

@@ -13,6 +13,10 @@
  * 作者 ddj 2026年09月11号
  */
 import { closeAll, closeOthers, closeRight, closeSaved, isTreeRevealable, type TabLike } from './tabActions.js'
+import { isSvnDiffable } from '../shared/svn.js'
+import type { SvnFeature, SvnItemStatus } from '../shared/svn.js'
+import { svnActionOn, svnActionsFor } from '../shared/svnActions.js'
+import type { SvnActionContext } from '../shared/svnActions.js'
 
 /** 菜单构建输入（EditorView 每次打开菜单时按最新状态快照传入）。 */
 export interface TabMenuState {
@@ -30,6 +34,14 @@ export interface TabMenuState {
   hasSession: boolean
   /** 「添加到对话」动作集是否可用。 */
   canAddToConversation: boolean
+  /** SVN 能力可用（受管理且 svn CLI 可用；SVN 更新项显隐）。 */
+  svnReady?: boolean
+  /** TortoiseProc 可用（Windows 过渡增强组显隐）。 */
+  tortoiseReady?: boolean
+  /** 已由自研界面提供等价能力的功能集合（落实「自研替换时间线」；缺省不隐藏任何 Tortoise 项）。 */
+  svnFeatures?: readonly SvnFeature[]
+  /** 右键目标文件的 SVN 状态（未在变更清单里为 undefined；决定 CLI 三项显隐）。 */
+  svnStatusOfTarget?: SvnItemStatus
   /** 「关闭」项的键位提示（缺省无提示；由调用方读 chordOf 注入）。 */
   closeChord?: string | null
 }
@@ -52,6 +64,44 @@ export const CLOSE_MENU_IDS = ['close', 'close-others', 'close-right', 'close-sa
 /** 本架构不支持的条目 id（参考图有、浏览器单编辑器实例无法实现）——显式登记以防误加。 */
 export const UNSUPPORTED_MENU_IDS = ['split-right', 'split-move', 'move-new-window', 'copy-new-window'] as const
 
+/**
+ * 构建 SVN 组条目（动作清单来自 shared/svnActions.ts，与树菜单/命令栏同一份规则）。
+ *
+ * 收敛收益：此前 CLI 三项的状态矩阵在本文件与 sidebar/menuItems 各写一份，
+ * 极易漂移（P2 实测两处表述已略有差异）。现在只做「元数据 → 菜单条目」映射。
+ * @author ddj 2026年09月16号
+ * @param state 菜单状态快照
+ * @returns SVN 组条目（可为空数组）
+ */
+function svnEntriesOf(state: TabMenuState): TabMenuEntry[] {
+  if (state.svnReady !== true && state.tortoiseReady !== true) return []
+  const status = state.svnStatusOfTarget
+  const context: SvnActionContext = {
+    managed: true,
+    svnCli: state.svnReady === true,
+    tortoise: state.tortoiseReady === true,
+    // 自研能力集合：驱动「自研替换时间线」（隐藏已被自研覆盖的 Tortoise 项）
+    svnFeatures: state.svnFeatures,
+    target: 'file',
+    versioned: status !== 'unversioned' && status !== 'ignored',
+    status,
+    diffable: isSvnDiffable(state.path, status),
+  }
+  const entries: TabMenuEntry[] = []
+  for (const action of svnActionsFor('tab')) {
+    if (!svnActionOn(action, context)) continue
+    entries.push({
+      id: 'svn-' + action.id,
+      label: action.label,
+      danger: action.danger === true,
+      // 分隔线属入口级外观：页签菜单的 SVN 组恒以分隔线起头（挂在前一组「固定」之后），
+      // 故由本入口决定，不放进共享元数据（否则会连带改动树菜单的分组外观）
+      separator: entries.length === 0,
+    })
+  }
+  return entries
+}
+
 /**
  * 构建页签右键菜单条目。
  * @author ddj 2026年09月11号
@@ -82,6 +132,7 @@ export function buildTabMenu(state: TabMenuState): TabMenuEntry[] {
       label: pinned ? '取消固定' : '固定',
       separator: true,
     },
+    ...svnEntriesOf(state),
   ]
 }