dsh-vscode-mode 0.4.6 → 0.5.1

package/src/client/rpc.ts

@@ -1,21 +1,40 @@
 /**
  * dsh-vscode-mode client — 类型化 RPC 包装 + 诊断日志。
  * 迁移自原 src/client/index.ts 的 rpc/dbg，语义不改。
- * 作者 ddj 2026-08-20
+ * 诊断开关运行时化：内存缓存 + localStorage 持久（日志弹窗开关即改即生效，免刷新）。
+ * 作者 ddj 2026-08-20 / 2026-09-17
  */
 import { RPC_PATH } from '../shared/rpc.js'
 import type { RpcMethod, RpcRequestMap, RpcResult } from '../shared/rpc.js'
+import type { LoggerLevel } from '../shared/logger.js'
 
-/**
- * 诊断日志开关（默认关）：diff 渲染热路径每条日志 = 1 次 RPC 往返 +
- * host 端 debug 文件全量读改写（上限 512KB），高频渲染下开销可观。
- * 排查问题时在浏览器控制台执行 localStorage.setItem('edrv.debug','1') 后刷新开启。
- * @author ddj 2026年08月26号
- */
-const DEBUG = (() => {
+/** 诊断开关内存缓存（localStorage 'edrv.debug' 持久；热路径读内存，零 localStorage 开销）。 */
+let debugEnabled = (() => {
   try { return localStorage.getItem('edrv.debug') === '1' } catch (e) { return false }
 })()
 
+/**
+ * 诊断日志开关当前值。
+ * @author ddj 2026年09月17号
+ * @returns 是否开启
+ */
+export function isDebug(): boolean {
+  return debugEnabled
+}
+
+/**
+ * 设置诊断日志开关（立即生效；localStorage 持久，写失败仅内存生效不抛错）。
+ * @author ddj 2026年09月17号
+ * @param on 是否开启
+ */
+export function setDebugEnabled(on: boolean): void {
+  debugEnabled = on
+  try {
+    if (on) localStorage.setItem('edrv.debug', '1')
+    else localStorage.removeItem('edrv.debug')
+  } catch (e) { /* 无 localStorage 环境：仅内存生效 */ }
+}
+
 /** 同源 RPC 调用（host /edrv/rpc 精确路由）。 */
 export function rpc<M extends RpcMethod>(method: M, args: RpcRequestMap[M]): Promise<RpcResult<M>> {
   return fetch(RPC_PATH, {
@@ -27,13 +46,14 @@ export function rpc<M extends RpcMethod>(method: M, args: RpcRequestMap[M]): Pro
 
 /**
  * 诊断日志：开关关闭时直接返回（零 RPC 零落盘）；开启时走 host edrv.debug 落盘。
- * @author ddj 2026年08月26号
+ * @author ddj 2026年08月26号 / 2026年09月17号
  * @param sessionId 会话 id
  * @param text 日志文本
+ * @param level 日志级别（缺省 debug；落盘行与 host 终端回显均带此级别）
  */
-export function dbg(sessionId: string | undefined, text: string): void {
-  if (!DEBUG) return
+export function dbg(sessionId: string | undefined, text: string, level: LoggerLevel = 'debug'): void {
+  if (!debugEnabled) return
   try {
-    rpc('edrv.debug', { sessionId, text }).catch(() => {})
+    rpc('edrv.debug', { sessionId, text, level }).catch(() => {})
   } catch (e) { /* 日志失败忽略 */ }
 }

package/src/client/sessionScope.ts

@@ -0,0 +1,183 @@
+/**
+ * dsh-vscode-mode client — 会话作用域解析（跨 DSH 版本适配）。
+ *
+ * 背景：DSH 0.1.6-alpha.2 随「客户端 Session 多实例共存」移除了 `sessions.list`
+ * 快照的 `current` / `currentAddress` 字段（alpha.1 及更早仍发布 `current`）。
+ * 官方替代面是 `ctx.uiSession.current`（`HostObservable<StandardSourceBinding>`，
+ * 其 `key` 即当前会话 id；绑定行由官方 ui-session 依 retainInfo.mainView 推出）。
+ *
+ * 本模块把「当前会话」收敛为单一三级取值链，并附可订阅的变更通知：
+ *   1. `uiSession.current.key`（0.1.6-alpha.2+ 权威）
+ *   2. `sessions.list.current`（rc 线 / 0.1.6-alpha.1 及更早）
+ *   3. `sessions.list.byId` 中 `retainedBy.mainView > 0` 的首行（新版兜底，与官方同判据）
+ *   4. 槽位注入的 sessionId（最后兜底）
+ *
+ * 约束：`uiSession` 不进 `inject`（旧版 DSH 无此服务，进 inject 会让插件停等），
+ * 一律 `ctx.get` 可选探测；任一来源缺失/异常都降级，不抛错、不阻断其他两级。
+ * 取值纯逻辑（pickSessionScope 等）可在 node 环境单测。
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 解析出的会话作用域：sessionId 可能缺失；cwd 仅在 list 快照可读时给出。 */
+export interface SessionScope {
+  sessionId?: string
+  cwd?: string
+}
+
+/** 取值链的候选来源（三者都可缺失，缺失即跳过该级）。 */
+export interface ScopeSources {
+  /** `ctx.uiSession.current` 快照（0.1.6-alpha.2+ 权威来源；binding.key = sessionId）。 */
+  uiSession?: unknown
+  /** `ctx.sessions.list` 快照（旧版含 `current`；新版只有 `ids`/`byId`）。 */
+  list?: unknown
+  /** 槽位注入的 sessionId（前几级都拿不到时的最后兜底）。 */
+  fallbackSessionId?: unknown
+}
+
+/** 对象窄化（非对象返回 undefined，供后续安全取字段）。 */
+function asRecord(value: unknown): Record<string, unknown> | undefined {
+  return value && typeof value === 'object' ? (value as Record<string, unknown>) : undefined
+}
+
+/** 非空字符串取值（其他类型一律视为缺失）。 */
+function strOf(value: unknown): string | undefined {
+  return typeof value === 'string' && value ? value : undefined
+}
+
+/**
+ * 从 `uiSession.current` 快照读出 sessionId。
+ * 兼容两种形态：绑定源本身（`{ key }`）与其包裹形态（`{ value: { key } }`）——
+ * 官方 `createBindingSource` 的 `getSnapshot()` 返回绑定值本身，但跨版本包裹层存在差异，
+ * 故两者都尝试。
+ * @author ddj 2026年09月18号
+ * @param snapshot `uiSession.current` 的 `getSnapshot()` 结果（任意形状）
+ * @returns sessionId，或 undefined
+ */
+export function uiSessionIdOf(snapshot: unknown): string | undefined {
+  const binding = asRecord(snapshot)
+  if (!binding) return undefined
+  return strOf(binding.key) ?? strOf(asRecord(binding.value)?.key)
+}
+
+/**
+ * 从 `sessions.list` 快照读出 sessionId。
+ * 先取旧版 `current`；缺失时回退 `byId` 中 `retainedBy.mainView > 0` 的首行
+ * （与官方 ui-session 的 publishMain 同判据，故新版行为与官方视图一致）。
+ * @author ddj 2026年09月18号
+ * @param list `sessions.list` 的 `getSnapshot()` 结果（任意形状）
+ * @returns sessionId，或 undefined
+ */
+export function listSessionId(list: unknown): string | undefined {
+  const snap = asRecord(list)
+  if (!snap) return undefined
+  const current = strOf(snap.current)
+  if (current) return current
+  const byId = asRecord(snap.byId)
+  if (!byId) return undefined
+  for (const [id, row] of Object.entries(byId)) {
+    const mainView = asRecord(asRecord(row)?.retainedBy)?.mainView
+    if (typeof mainView === 'number' && mainView > 0) return id
+  }
+  return undefined
+}
+
+/**
+ * 三级取值链（纯函数）：决定当前会话 id 与其 cwd。
+ * 优先级 uiSession > list.current > list.byId.retainedBy > fallback。
+ * @author ddj 2026年09月18号
+ * @param sources 候选来源集合
+ * @returns 会话作用域（字段缺失即省略该键，不写 undefined 占位）
+ */
+export function pickSessionScope(sources: ScopeSources): SessionScope {
+  const sessionId = uiSessionIdOf(sources.uiSession)
+    ?? listSessionId(sources.list)
+    ?? strOf(sources.fallbackSessionId)
+  if (!sessionId) return {}
+  const byId = asRecord(asRecord(sources.list)?.byId)
+  const cwd = strOf(asRecord(byId?.[sessionId])?.cwd)
+  return cwd ? { sessionId, cwd } : { sessionId }
+}
+
+/** 读 `ctx.get(name)`（缺失/异常返回 undefined，不抛错）。 */
+function safeGet(ctx: { get: (name: string) => unknown }, name: string): unknown {
+  try {
+    return ctx.get(name)
+  } catch {
+    return undefined
+  }
+}
+
+/** 取 `uiSession.current` 快照（服务或订阅面缺失时返回 undefined）。 */
+function uiCurrentSnapshot(ctx: { get: (name: string) => unknown }): unknown {
+  const uiSession = asRecord(safeGet(ctx, 'uiSession'))
+  const current = asRecord(uiSession?.current)
+  const getSnapshot = current?.getSnapshot
+  if (typeof getSnapshot !== 'function') return undefined
+  try {
+    return (getSnapshot as () => unknown).call(current)
+  } catch {
+    return undefined
+  }
+}
+
+/** 取 `sessions.list` 快照（服务缺失时返回 undefined）。 */
+function listSnapshot(ctx: { get: (name: string) => unknown }): unknown {
+  const sessions = asRecord(safeGet(ctx, 'sessions'))
+  const list = asRecord(sessions?.list)
+  const getSnapshot = list?.getSnapshot
+  if (typeof getSnapshot !== 'function') return undefined
+  try {
+    return (getSnapshot as () => unknown).call(list)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 读当前会话作用域（服务面取值 + 三级链）。
+ * @author ddj 2026年09月18号
+ * @param ctx 客户端根上下文（只需 `get`）
+ * @param fallbackSessionId 槽位注入的 sessionId（可选）
+ * @returns 会话作用域
+ */
+export function readSessionScope(ctx: { get: (name: string) => unknown }, fallbackSessionId?: unknown): SessionScope {
+  return pickSessionScope({
+    uiSession: uiCurrentSnapshot(ctx),
+    list: listSnapshot(ctx),
+    fallbackSessionId,
+  })
+}
+
+/**
+ * 订阅会话切换（同时挂 `uiSession.current` 与新/旧 `sessions.list`）。
+ * 旧版无 `uiSession`，新版 `list` 不再变（切会话只动 uiSession），故两条都要挂；
+ * 回调可能因两条源先后触发而重复，调用方按上一次 sessionId 自行去重。
+ * @author ddj 2026年09月18号
+ * @param ctx 客户端根上下文（只需 `get`）
+ * @param listener 变更回调
+ * @returns 取消订阅函数（幂等）
+ */
+export function subscribeScope(ctx: { get: (name: string) => unknown }, listener: () => void): () => void {
+  const disposers: Array<() => void> = []
+  const attach = (owner: unknown): void => {
+    const subscribe = asRecord(owner)?.subscribe
+    if (typeof subscribe !== 'function') return
+    try {
+      const disposer = (subscribe as (fn: () => void) => unknown).call(owner, listener)
+      if (typeof disposer === 'function') disposers.push(disposer as () => void)
+    } catch {
+      /* 订阅面异常：放弃该源，不影响其他源 */
+    }
+  }
+  attach(asRecord(asRecord(safeGet(ctx, 'uiSession'))?.current))
+  attach(asRecord(asRecord(safeGet(ctx, 'sessions'))?.list))
+  return () => {
+    for (const disposer of disposers.splice(0)) {
+      try {
+        disposer()
+      } catch {
+        /* 卸载异常不影响其余清理 */
+      }
+    }
+  }
+}

package/src/client/sidebar/SidebarView.ts

@@ -5,7 +5,8 @@
  * 右侧详情面板区可拖拽调宽/隐藏：visible=false 时仅保留图标列（宽 = 图标列宽），
  * 点击任一图标重新展开面板（onShow），底部按钮在 ◀ 收起 / ▶ 展开间切换。
  * 拖拽调宽下限 = minWidth prop（通用设置 sidebarMinWidth，默认 300），低于下限直接收起面板区。
- * 作者 ddj 2026-08-26 / 2026-09-04
+ * 面板可按 visible(ctx) 声明可用性（如「SVN 变更」仅在受 SVN 管理时出现，非 SVN 工作区零变化）。
+ * 作者 ddj 2026-08-26 / 2026-09-04 / 2026-09-16
  */
 import React from 'react'
 import type { SidebarCtx } from './types.js'
@@ -47,8 +48,11 @@ function railIconEl(icon) {
  * @param props.minWidth 最小宽度（通用设置 sidebarMinWidth；拖拽低于它触发隐藏）
  */
 export function SidebarView(props) {
-  const panels = props.registry?.list?.() ?? []
   const ctx = props.ctx
+  // 按 visible(ctx) 过滤活动栏图标与面板（能力相关面板：SVN 变更仅在受 SVN 管理时出现）
+  const panels = (props.registry?.list?.() ?? []).filter((panel) => (
+    typeof panel.visible !== 'function' || panel.visible(ctx) === true
+  ))
   const activePanel = props.activePanel
   const onActive = props.onActive
   const visible = props.visible !== false

package/src/client/sidebar/menuItems.ts

@@ -1,13 +1,103 @@
 /**
  * dsh-vscode-mode client — 文件管理右键菜单内置项。
  * 内置项：「在文件浏览器中打开」（文件→OS Explorer 定位选中、目录→打开目录）；
- * 「添加引用到对话」（文件/文件夹引用注入当前会话对话输入框）。
+ * 「添加引用到对话」（文件/文件夹引用注入当前会话对话输入框）；
+ * 「SVN 组」——动作清单与显隐规则来自 shared/svnActions.ts（三入口共用一份，不再各写一遍）。
  * 反馈统一走 ctx.notify（由 EditorView 提供，落到编辑区路径栏状态）。
- * 作者 ddj 2026-08-27 / 2026-09-03
+ * 作者 ddj 2026-08-27 / 2026-09-03 / 2026-09-16
  */
+import { isSvnDiffable } from '../../shared/svn.js'
+import type { SvnChangeEntry } from '../../shared/svn.js'
+import { svnActionOn, svnActionsFor } from '../../shared/svnActions.js'
+import type { SvnActionContext, SvnTargetType } from '../../shared/svnActions.js'
+import { runSvnAction } from '../svnActions.js'
+import type { SvnActionRunCtx } from '../svnActions.js'
 import { revealInExplorer } from '../fileReveal.js'
 import { statusOfAdd } from '../addToConversation.js'
 import type { TreeMenuItem } from './contextMenu.js'
+import type { SidebarCtx } from './types.js'
+import type { TreeMenuTarget } from './contextMenu.js'
+
+/** 目标路径对应的变更条目（不在清单里返回 undefined）。 */
+function svnEntryOf(target: TreeMenuTarget, ctx: SidebarCtx): SvnChangeEntry | undefined {
+  if (!target.path) return undefined
+  const map = ctx.svnChangeMap
+  return map ? map[target.path] : undefined
+}
+
+/**
+ * 把树菜单目标投影为动作求值上下文（能力 + 目标类型 + 状态门禁）。
+ * 显隐判定统一交给 shared 的 svnActionOn，避免与页签菜单/命令栏漂移。
+ * @author ddj 2026年09月16号
+ * @param target 右键目标
+ * @param ctx 面板上下文
+ * @returns 求值上下文；无 SVN 状态返回 null
+ */
+function svnContextOf(target: TreeMenuTarget, ctx: SidebarCtx): SvnActionContext | null {
+  const svn = ctx.svn
+  if (!svn) return null
+  const entry = svnEntryOf(target, ctx)
+  const isRoot = target.path === ''
+  const targetType: SvnTargetType = isRoot ? 'root' : (target.type === 'directory' ? 'directory' : 'file')
+  return {
+    managed: svn.managed,
+    svnCli: svn.svnCli,
+    tortoise: svn.tortoise,
+    // 自研能力集合：驱动「自研替换时间线」（隐藏已被自研覆盖的 Tortoise 项）
+    svnFeatures: svn.svnFeatures,
+    target: targetType,
+    // 不在变更清单里视为受版本控制（干净文件）；未版本控制条目显式为 false
+    versioned: entry ? entry.versioned : true,
+    status: entry?.status,
+    diffable: isSvnDiffable(target.path, entry?.status),
+  }
+}
+
+/**
+ * 树菜单动作执行上下文（RPC 与反馈经面板 ctx 注入）。
+ * @author ddj 2026年09月16号
+ * @param target 右键目标
+ * @param ctx 面板上下文
+ * @returns 执行上下文
+ */
+function treeRunCtx(target: TreeMenuTarget, ctx: SidebarCtx): SvnActionRunCtx {
+  return {
+    sessionId: ctx.sessionId,
+    scope: ctx.scope,
+    path: target.path,
+    notify: (message) => ctx.notify?.(message),
+    openSvnDiff: (p) => ctx.openSvnDiff?.(p),
+    openSvnLog: ctx.openSvnLog,
+    refreshChanges: ctx.refreshSvnChanges,
+    // 确认对话框可注入（测试/宿主可替换；缺省走 window.confirm）
+    confirm: ctx.confirm,
+  }
+}
+
+/**
+ * 构造 SVN 组菜单项（动作清单来自 shared/svnActions.ts）。
+ *
+ * 收敛收益：此前每个动作在这里手写一项、页签菜单再手写一遍、命令栏第三遍，
+ * 显隐规则三处漂移（P2 的「加入/还原」状态矩阵就重复过两份）。现在只做映射。
+ * @author ddj 2026年09月16号
+ * @returns SVN 组条目
+ */
+function svnMenuItems(): TreeMenuItem[] {
+  return svnActionsFor('tree').map((action) => ({
+    id: 'svn-' + action.id,
+    label: action.label,
+    order: action.order,
+    danger: action.danger === true,
+    separator: action.separator === true,
+    visible: (target: TreeMenuTarget, ctx: SidebarCtx) => {
+      const context = svnContextOf(target, ctx)
+      return context !== null && svnActionOn(action, context)
+    },
+    run: (target: TreeMenuTarget, ctx: SidebarCtx) => {
+      runSvnAction(action, treeRunCtx(target, ctx))
+    },
+  }))
+}
 
 /**
  * 构造内置右键菜单项列表（后续内置项直接追加）。
@@ -45,5 +135,6 @@ export function createDefaultFileMenuItems(): TreeMenuItem[] {
         })
       },
     },
+    ...svnMenuItems(),
   ]
 }

package/src/client/sidebar/panels/FileExplorer.ts

@@ -6,7 +6,8 @@
  * 保留旧条目强制后台重列（force）；每次用户发起加载后预取 ≤4 个子目录（排除重型
  * 目录、缓存新鲜跳过、不级联）；10s 轻量跟随已展开目录（命中索引，RPC 近零成本）。
  * 差异角标/右键菜单/展开状态持久化行为不变；行图标用官方原语（文件夹图标 + 文件类型图标）。
- * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10
+ * SVN 状态徽标（P2）：行尾方形字母，数据来自 ctx.svnChangeMap（客户端合成，不改 listDir 契约）。
+ * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10 / 2026-09-16
  */
 import React from 'react'
 import { FileTypeIcon, IconFolderClose16, IconFolderOpen16, IconRefreshOutline16, classifyFileType } from '@deepseek-ai/dsh-client-ui-primitives'
@@ -17,6 +18,8 @@ import { explorerLoad, explorerSave } from '../../state/explorerCache.js'
 import { entriesCacheGet, entriesCacheIsFresh, entriesCachePut } from '../../state/explorerEntriesCache.js'
 import { workspaceScopeOf } from '../../state/scopeStore.js'
 import { ancestorDirsOf } from '../../tabActions.js'
+import { refreshSvnChanges, refreshSvnStatus } from '../../svnStatus.js'
+import { SVN_STATUS_TONE, svnBadgeOf, svnBadgeTitle } from '../../../shared/svn.js'
 import type { SidebarCtx } from '../types.js'
 
 const DIR_CAP = 4000
@@ -105,6 +108,7 @@ export function FileExplorer(props) {
   const openFile = ctx?.openFile
   const activePath = ctx?.activePath ?? null
   const pendingByPath = ctx?.pendingByPath ?? {}
+  const svnChangeMap = ctx?.svnChangeMap ?? {}
   const [root, setRoot] = React.useState(null)
   const [dirs, setDirs] = React.useState({}) // rel → 最新条目（本会话内存态）
   const [expanded, setExpanded] = React.useState({})
@@ -264,6 +268,10 @@ export function FileExplorer(props) {
       setExpanded({})
     }
     void loadDir('', { force: true, prefetch: true })
+    // SVN 状态一并强制重测（检出 .svn / 卸载 svn 后可恢复菜单显隐）
+    refreshSvnStatus(sessionId, scope)
+    // 变更清单同样重查（目录重列后徽标要跟上；host 侧 TTL 内会被 force 绕过）
+    refreshSvnChanges(sessionId, scope)
   }
   refreshRef.current = refresh
   reloadDirRef.current = loadDir
@@ -387,6 +395,9 @@ export function FileExplorer(props) {
     const active = !isDir && e.path === activePath
     const contextTarget = Boolean(menu && menuEntries.length && menu.target.path === e.path)
     const dim = e.type === 'other'
+    // SVN 状态徽标：客户端由变更清单合成的查表（未加载/干净/未版本控制被过滤时不出徽标）
+    const svnEntry = svnChangeMap[e.path]
+    const svnLetter = svnEntry ? svnBadgeOf(svnEntry) : ''
     return React.createElement('div', {
       key: e.path,
       className: 'edrv-tree-row'
@@ -409,6 +420,12 @@ export function FileExplorer(props) {
       rowIconEl(e, isDir, isOpen),
       React.createElement('span', { className: 'edrv-tree-name' + (dim ? ' edrv-tree-dim' : '') },
         e.name),
+      (svnLetter
+        ? React.createElement('span', {
+            className: 'edrv-tree-svn edrv-svn-ch-' + (SVN_STATUS_TONE[svnEntry.status] ?? 'plain'),
+            title: 'SVN ' + svnBadgeTitle(svnEntry),
+          }, svnLetter)
+        : null),
       (pending > 0
         ? React.createElement('span', { className: 'edrv-tree-badge' }, String(pending))
         : null))