dsh-vscode-mode 0.16.0 → 0.17.0

package/locale/en.json

@@ -1,4 +1,6 @@
 {
-  "title": "VSCodeMode",
-  "description": "VSCode-like coding on DSH: Monaco editor with tabs and QuickOpen, command palette, agent edit review, SVN integration, and LSP smartness."
+  "meta": {
+    "title": "VSCodeMode",
+    "description": "VSCode-like coding on DSH: Monaco editor with tabs and QuickOpen, command palette, agent edit review, SVN integration, and LSP smartness."
+  }
 }

package/locale/zh.json

@@ -1,4 +1,6 @@
 {
-  "title": "VSCodeMode",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（页签/QuickOpen/状态栏）、命令栏、Agent 编辑差异审查、SVN 集成与 LSP 智能。"
+  "meta": {
+    "title": "VSCodeMode",
+    "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（页签/QuickOpen/状态栏）、命令栏、Agent 编辑差异审查、SVN 集成与 LSP 智能。"
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.16.0",
+  "version": "0.17.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": [
@@ -29,7 +29,8 @@
   },
   "type": "module",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.1.0-rc.1 <0.3.0-0"
   },
   "packageManager": "pnpm@11.3.0",
   "main": "./lib/index.js",
@@ -90,6 +91,7 @@
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
     "./package.json": "./package.json"
   },
   "dsh": {

package/src/capture.ts

@@ -16,7 +16,7 @@ import type { Ctx, Session } from './store.js'
 import { READ_CAP, archiveCanceled, loadBucket, saveBucket } from './store.js'
 import { fileMaxBatch, prune } from './model.js'
 import type { Registry } from './registry.js'
-import { cwdOf } from './registry.js'
+import { cwdOfSession } from './registry.js'
 import { findRemoteWs, mirrorTargetOf } from './remoteWorkspace.js'
 import { invalidateIndex } from './treeIndex.js'
 import { log } from './log.js'
@@ -275,7 +275,7 @@ export async function captureToolResult(ctx: Ctx, registry: Registry, exec: any,
   // remote_ssh_write 只依赖参数与 isError（其 result.value 形状不受本插件约束）
   if (exec.name !== 'remote_ssh_write' && !result?.value) return
   try {
-    const cwd = cwdOf(session)
+    const cwd = cwdOfSession(ctx, session)
     if (!cwd) return
     const args = ((exec.arguments || {}) as Record<string, unknown>)
     const record = exec.name === 'remote_ssh_write'

package/src/client/compat.ts

@@ -172,7 +172,8 @@ export interface SlotSpec {
   name: string
   id: string
   order?: number
-  label?: string
+  /** 文案：字符串或 thunk；thunk 在每次读取时重算，语言切换后无需重注册。 */
+  label?: string | (() => string)
   inject?: (sessionId: string) => object
 }
 

package/src/client/index.ts

@@ -20,6 +20,7 @@ import { DiffBadge } from './ui/DiffBadge.js'
 import { PerfSizeBadge } from './ui/PerfSizeBadge.js'
 import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
+import { PluginDetailSection } from './ui/PluginDetailSection.js'
 import { rpc } from './rpc.js'
 import { loadMonaco } from './monaco/loader.js'
 import { observeScheme, schemeOfSnapshot } from './monaco/theme.js'
@@ -60,6 +61,7 @@ import { SHORTCUT_PROFILES, defaultKeybindings, normalizeKeybindings } from '../
 import { sidebarMinApply } from './sidebarMin.js'
 import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
+import { installLocale } from './localeClient.js'
 import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
 import { disposeSnippets } from './snippets/provider.js'
 import { disposeLaunchJson } from './dap/launchSnippetProvider.js'
@@ -123,6 +125,10 @@ function setupCommands(ctx: any): CommandBridge {
 export async function apply(ctx: any): Promise<void> {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
 
+  // UI 壳层文案：注册本插件词典到官方 locale 服务（旧版无该服务时直读中文词典）。
+  // slot label / 编辑 Tab 标题一律写成 thunk，让语言切换后无需重注册即可刷新。
+  const t = installLocale(ctx)
+
   /**
    * 无门控上报界面状态镜像事件（绕过客户端 edrv.debug 开关，直接落 host 诊断日志）。
    * 开关关闭时 dbg 直接 return，「重启后没恢复」这类问题会在客户端侧彻底无痕，故另开一条通路。
@@ -506,7 +512,7 @@ export async function apply(ctx: any): Promise<void> {
       name: 'conversation.view',
       id: 'edrv-editor',
       order: 5,
-      label: '文件编辑',
+      label: () => t('slot.fileEditor'),
       inject: (sessionId: string) => ({ sessionId }),
     }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })))
   }
@@ -530,9 +536,10 @@ export async function apply(ctx: any): Promise<void> {
       service: official.service,
       slots: ctx.slots,
       renderTab: officialRenderTab,
+      title: () => t('slot.fileEditor'),
       guide: {
-        title: () => OFFICIAL_TAB_TITLE,
-        description: () => 'Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）',
+        title: () => t('guide.title'),
+        description: () => t('guide.description'),
       },
     })
     if (outcome === null) {
@@ -632,16 +639,16 @@ export async function apply(ctx: any): Promise<void> {
     name: 'conversation.input.dock',
     id: 'edrv-diff-dock',
     order: 30,
-    label: '差异',
+    label: () => t('slot.diff'),
     inject: (sessionId: string) => ({ sessionId }),
   }, (props: unknown) => React.createElement(ConversationDiffDock, Object.assign({}, props)))
 
   // header 差异角标：仅当前工作区存在差异时渲染
-  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: '差异' },
+  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: () => t('slot.diff') },
     (props: unknown) => React.createElement(DiffBadge, Object.assign({}, props)))
 
   // header 会话体积指示器：当前会话持久化体积，超阈值提示新开会话（性能优化）
-  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-perf-size', order: 89, label: '会话体积' },
+  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-perf-size', order: 89, label: () => t('slot.sessionSize') },
     (props: unknown) => React.createElement(PerfSizeBadge, Object.assign({}, props, { sessions })))
 
   // 设置页中的 VSCodeMode 专属页签，MCP 管理作为该页签的内部子 Tab。
@@ -649,7 +656,7 @@ export async function apply(ctx: any): Promise<void> {
     name: 'settings.section',
     id: 'vscode-mode',
     order: 30,
-    label: 'VSCodeMode',
+    label: () => t('slot.settings'),
   }, () => React.createElement(SettingsContext.Provider, { value: bridge.scope() }, React.createElement(McpSettings, {
     openerRegistry: registry,
     compatSummary,
@@ -658,6 +665,14 @@ export async function apply(ctx: any): Promise<void> {
     getShortcuts: () => detectShortcuts(ctx),
   })))
 
+  // 官方插件管理器详情页的只读状态段（DSH 0.2.1 新增扩展位）：非本插件页返回 null。
+  // 该 slot 在旧版 DSH 不存在，slots.inject 会一直等待（不报错），故无需版本判断。
+  registerSlotSafely(ctx, {
+    name: 'plugins.detail.section',
+    id: 'edrv-plugin-status',
+    order: 40,
+  }, (props: unknown) => React.createElement(PluginDetailSection, Object.assign({}, props)))
+
   // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
   // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。

package/src/client/localeClient.ts

@@ -0,0 +1,97 @@
+/**
+ * dsh-vscode-mode client — UI 壳层文案的 locale 接入。
+ * 此前 `locale` 写在 inject 里却零调用，界面文案全为硬编码中文；
+ * 这里只覆盖壳层（slot label、编辑 Tab 标题、侧栏引导），编辑器内部大段文案不动。
+ * 所有对外函数都对 locale 服务做可选探测：旧版 DSH 无该服务时回落中文词典。
+ * 作者 ddj 2026年10月19号
+ */
+
+/** locale 命名空间（与包名一致，避免与其他插件串词条）。 */
+export const LOCALE_NS = 'dsh-vscode-mode'
+
+/** 支持的语言；zh 为缺省回退语言。 */
+export const LOCALE_FALLBACK = 'zh'
+
+/** 壳层文案词典（键名即 slot label / Tab 标题的稳定标识）。 */
+export const LOCALE_DICTS: Record<string, Record<string, string>> = {
+  zh: {
+    'slot.fileEditor': '文件编辑',
+    'slot.diff': '差异',
+    'slot.sessionSize': '会话体积',
+    'slot.settings': 'VSCodeMode',
+    'guide.title': '文件编辑',
+    'guide.description': 'Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）',
+  },
+  en: {
+    'slot.fileEditor': 'File editor',
+    'slot.diff': 'Diff',
+    'slot.sessionSize': 'Session size',
+    'slot.settings': 'VSCodeMode',
+    'guide.title': 'File editor',
+    'guide.description': 'Monaco file editor: chat and editing side by side (diff review, jump, outline)',
+  },
+}
+
+/** locale 服务的最小结构面（结构性探测，不 import 官方类型）。 */
+export interface LocaleLike {
+  register?: (ns: string, dicts: Record<string, Record<string, string>>) => unknown
+  bind?: (ns: string) => (key: string) => string
+}
+
+/** 翻译函数：键 → 当前语言文案（找不到时回落中文，再回落键本身）。 */
+export type Translate = (key: string) => string
+
+/**
+ * 取词条：先当前语言、再中文、最后键本身。
+ * @author ddj 2026年10月19号
+ * @param lang 语言 id
+ * @param key 词条键
+ * @returns 文案
+ */
+function lookup(lang: string, key: string): string {
+  return LOCALE_DICTS[lang]?.[key] ?? LOCALE_DICTS[LOCALE_FALLBACK]?.[key] ?? key
+}
+
+/**
+ * 生成不依赖 locale 服务的直读翻译函数（服务缺失/注册失败时使用）。
+ * @author ddj 2026年10月19号
+ * @param lang 语言 id
+ * @returns 翻译函数
+ */
+export function directTranslate(lang: string = LOCALE_FALLBACK): Translate {
+  return (key: string) => lookup(lang, key)
+}
+
+/**
+ * 注册本插件词典并返回翻译函数。
+ * 服务缺失、重复注册或 bind 抛错都不影响插件其余部分：一律回落直读词典。
+ * @author ddj 2026年10月19号
+ * @param ctx DSH 客户端上下文
+ * @returns 翻译函数（读取时才解析当前语言，可直接放进 slot label thunk）
+ */
+export function installLocale(ctx: { get: (name: string) => unknown }): Translate {
+  let service: LocaleLike | undefined
+  try {
+    service = ctx.get('locale') as LocaleLike | undefined
+  } catch {
+    // 服务缺失或探测抛错：后续一律按未命中处理。
+  }
+
+  // 注册失败（例如同名 ns 已被占）不应连带废掉 bind，故两段各自 try。
+  try {
+    if (service && typeof service.register === 'function') service.register(LOCALE_NS, LOCALE_DICTS)
+  } catch {
+    // 词典未注册成功：仍尝试 bind，最后还有直读词典兜底。
+  }
+
+  try {
+    if (service && typeof service.bind === 'function') {
+      const bound = service.bind(LOCALE_NS)
+      if (typeof bound === 'function') return (key: string) => bound(key)
+    }
+  } catch {
+    // bind 异常按未命中处理。
+  }
+
+  return directTranslate()
+}

package/src/client/officialSidebar.ts

@@ -286,8 +286,11 @@ export function installOfficial(options: {
   slots: SlotsLike
   renderTab: unknown
   guide: { title: () => string; description: () => string }
+  /** Tab 标题 thunk（缺省用内置中文常量；传入后由调用方按当前语言解析）。 */
+  title?: () => string
 }): (() => void) | null {
   const { tabs, service, slots, renderTab, guide } = options
+  const titleOf = typeof options.title === 'function' ? options.title : () => OFFICIAL_TAB_TITLE
   const open = (path: string | null, focusDiff: boolean): boolean => {
     try {
       // 官方语义：打开即展开侧栏；seat 未挂载（无会话画面）时抛错，降级其他打开器
@@ -305,7 +308,7 @@ export function installOfficial(options: {
       id: OFFICIAL_TAB_ID,
       kind: OFFICIAL_TAB_KIND,
       priority: 'extension',
-      title: () => OFFICIAL_TAB_TITLE,
+      title: () => titleOf(),
       guide: [{ order: 20, title: guide.title, description: guide.description }],
     })
   } catch (error) {

package/src/client/state/recordsFeed.ts

@@ -0,0 +1,241 @@
+/**
+ * dsh-vscode-mode client — 会话级差异记录共享订阅。
+ * 原先 DiffBadge / ConversationDiffDock / EditorView 各自 5s 轮询同一个
+ * `edrv.list`，同一会话一轮要打 3 次 RPC。本模块按会话收敛为单一定时器：
+ * 订阅者共享一次拉取，`edrv:refresh` 事件与主动刷新也走同一条通道。
+ * 作者 ddj 2026年10月19号
+ */
+import type { RecordView } from '../../shared/types.js'
+import { rpc } from '../rpc.js'
+
+/** 兜底轮询周期（毫秒）：仅作事件丢失时的兜底，正常由 edrv:refresh 驱动。 */
+export const FEED_INTERVAL_MS = 5000
+
+/** 记录变化回调。 */
+export type RecordsListener = (records: RecordView[]) => void
+
+/** 周期心跳回调（给只关心「该刷新了」的订阅者复用同一定时器）。 */
+export type TickListener = () => void
+
+/** 拉取失败回调。 */
+export type ErrorListener = (message: string) => void
+
+/** 单会话的共享订阅状态。 */
+interface FeedEntry {
+  records: RecordView[] | null
+  listeners: Set<RecordsListener>
+  tickers: Set<TickListener>
+  errorListeners: Set<ErrorListener>
+  timer: ReturnType<typeof setInterval> | null
+  onRefresh: (() => void) | null
+  seq: number
+  inflight: boolean
+}
+
+const feeds = new Map<string, FeedEntry>()
+
+/** 取全局 window（Node 测试环境无 window）。 */
+function win(): (Window & typeof globalThis) | undefined {
+  return typeof window === 'undefined' ? undefined : window
+}
+
+/**
+ * 取或建会话订阅槽位。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @returns 订阅槽位
+ */
+function entryOf(sessionId: string): FeedEntry {
+  let entry = feeds.get(sessionId)
+  if (!entry) {
+    entry = { records: null, listeners: new Set(), tickers: new Set(), errorListeners: new Set(), timer: null, onRefresh: null, seq: 0, inflight: false }
+    feeds.set(sessionId, entry)
+  }
+  return entry
+}
+
+/**
+ * 把最新记录分发给订阅者（快照相等时也分发，交由消费方自行比对）。
+ * @author ddj 2026年10月19号
+ * @param entry 订阅槽位
+ */
+function notifyRecords(entry: FeedEntry): void {
+  const snapshot = entry.records
+  if (!snapshot) return
+  for (const listener of Array.from(entry.listeners)) {
+    try {
+      listener(snapshot)
+    } catch {
+      // 单个订阅者异常不得影响其余订阅者。
+    }
+  }
+}
+
+/**
+ * 拉取一次该会话的差异记录。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param skipStale 是否跳过过期判定（与 edrv.list 参数同名同义）
+ * @returns 拉取完成 Promise
+ */
+export function refreshFeed(sessionId: string, skipStale = false): Promise<void> {
+  const entry = entryOf(sessionId)
+  const current = ++entry.seq
+  entry.inflight = true
+  const payload: { sessionId: string; skipStale?: boolean } = { sessionId }
+  if (skipStale) payload.skipStale = true
+
+  return rpc('edrv.list', payload)
+    .then((res) => {
+      if (current !== entry.seq) return
+      if (!res || !res.ok || !Array.isArray(res.records)) return
+      entry.records = res.records as RecordView[]
+      notifyRecords(entry)
+    })
+    .catch((e) => {
+      // 拉取失败保留上一次快照，等下一轮心跳重试；同时把错误交给关心者（EditorView 报错条）。
+      if (current !== entry.seq) return
+      const message = String(e)
+      for (const listener of Array.from(entry.errorListeners)) {
+        try {
+          listener(message)
+        } catch {
+          // 单个错误订阅者异常不得影响其余订阅者。
+        }
+      }
+    })
+    .finally(() => {
+      if (current === entry.seq) entry.inflight = false
+    })
+}
+
+/**
+ * 确保该会话的定时器与 refresh 事件监听已就绪（首个订阅者到来时启动）。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param entry 订阅槽位
+ */
+function ensureTimer(sessionId: string, entry: FeedEntry): void {
+  if (entry.timer === null) {
+    entry.timer = setInterval(() => {
+      const tickers = Array.from(entry.tickers)
+      for (const tick of tickers) {
+        try {
+          tick()
+        } catch {
+          // 心跳订阅者异常不得中断定时器。
+        }
+      }
+      // 只有存在记录/错误订阅者时才拉取记录；纯心跳订阅者（如体积徽章）不额外制造 RPC。
+      if (entry.listeners.size > 0 || entry.errorListeners.size > 0) void refreshFeed(sessionId)
+    }, FEED_INTERVAL_MS)
+  }
+  if (entry.onRefresh === null) {
+    const handler = () => {
+      void refreshFeed(sessionId)
+    }
+    const target = win()
+    if (target) target.addEventListener('edrv:refresh', handler)
+    entry.onRefresh = handler
+  }
+}
+
+/**
+ * 会话无任何订阅者时释放定时器、事件监听与缓存快照。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param entry 订阅槽位
+ */
+function releaseIfIdle(sessionId: string, entry: FeedEntry): void {
+  if (entry.listeners.size || entry.tickers.size || entry.errorListeners.size) return
+  if (entry.timer !== null) clearInterval(entry.timer)
+  if (entry.onRefresh !== null) {
+    const target = win()
+    if (target) target.removeEventListener('edrv:refresh', entry.onRefresh)
+  }
+  feeds.delete(sessionId)
+}
+
+/**
+ * 订阅会话的差异记录。
+ * 首个订阅者触发一次立即拉取；同会话多订阅者共享一次 RPC。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param listener 记录变化回调
+ * @returns 取消订阅函数
+ */
+export function subscribeRecords(sessionId: string, listener: RecordsListener): () => void {
+  const entry = entryOf(sessionId)
+  entry.listeners.add(listener)
+  ensureTimer(sessionId, entry)
+
+  if (entry.records) listener(entry.records)
+  else if (!entry.inflight) void refreshFeed(sessionId)
+
+  return () => {
+    entry.listeners.delete(listener)
+    releaseIfIdle(sessionId, entry)
+  }
+}
+
+/**
+ * 订阅会话的周期心跳（复用同一定时器，不额外制造定时器）。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param listener 心跳回调
+ * @returns 取消订阅函数
+ */
+export function subscribeTick(sessionId: string, listener: TickListener): () => void {
+  const entry = entryOf(sessionId)
+  entry.tickers.add(listener)
+  ensureTimer(sessionId, entry)
+
+  return () => {
+    entry.tickers.delete(listener)
+    releaseIfIdle(sessionId, entry)
+  }
+}
+
+/**
+ * 订阅会话记录拉取失败（错误提示用；同样复用该会话的共享通道）。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @param listener 失败回调，参数为已字符串化的错误
+ * @returns 取消订阅函数
+ */
+export function subscribeErrors(sessionId: string, listener: ErrorListener): () => void {
+  const entry = entryOf(sessionId)
+  entry.errorListeners.add(listener)
+  ensureTimer(sessionId, entry)
+
+  return () => {
+    entry.errorListeners.delete(listener)
+    releaseIfIdle(sessionId, entry)
+  }
+}
+
+/**
+ * 读取会话的最近一次记录快照。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ * @returns 记录数组或 null（尚未拉到过）
+ */
+export function readRecords(sessionId: string): RecordView[] | null {
+  return feeds.get(sessionId)?.records ?? null
+}
+
+/**
+ * 主动丢弃会话的共享通道（会话销毁或测试复位用）。
+ * @author ddj 2026年10月19号
+ * @param sessionId 会话 id
+ */
+export function disposeFeed(sessionId: string): void {
+  const entry = feeds.get(sessionId)
+  if (!entry) return
+  if (entry.timer !== null) clearInterval(entry.timer)
+  if (entry.onRefresh !== null) {
+    const target = win()
+    if (target) target.removeEventListener('edrv:refresh', entry.onRefresh)
+  }
+  feeds.delete(sessionId)
+}

package/src/client/ui/ConversationDiffDock.ts

@@ -2,12 +2,13 @@
 /**
  * dsh-vscode-mode client — 会话级差异 dock。
  * conversation.input.dock 是唯一实例：普通对话显示摘要，文件编辑页显示完整操作条。
+ * 轮询已收敛到 state/recordsFeed.ts 的会话级共享订阅，本组件不再自建定时器。
  * 作者 ddj 2026-08-26
  */
 import React from 'react'
-import { rpc } from '../rpc.js'
 import { openDiffView } from '../events.js'
 import { summarize } from '../state/records.js'
+import { subscribeRecords } from '../state/recordsFeed.js'
 import { nextDiffPath } from '../diffDock.js'
 import { dockInLayout, readDiffDock, subscribeDiffDock } from '../diffDockStore.js'
 import { DiffBox } from './DiffBox.js'
@@ -25,27 +26,17 @@ export function ConversationDiffDock(props) {
   const sessionId = props?.sessionId
   const [summary, setSummary] = React.useState(null)
   const [, setStoreRevision] = React.useState(0)
-  const seq = React.useRef(0)
-
-  const load = React.useCallback(() => {
-    if (!sessionId) return
-    const current = ++seq.current
-    rpc('edrv.list', { sessionId }).then((res) => {
-      if (current !== seq.current || !res || !res.ok || !Array.isArray(res.records)) return
-      setSummary(summarize(res.records))
-    }).catch(() => {})
-  }, [sessionId])
 
   React.useEffect(() => {
-    load()
-    const timer = setInterval(load, 5000)
-    const onRefresh = () => load()
-    window.addEventListener('edrv:refresh', onRefresh)
-    return () => {
-      clearInterval(timer)
-      window.removeEventListener('edrv:refresh', onRefresh)
+    if (!sessionId) {
+      setSummary(null)
+      return undefined
     }
-  }, [load])
+
+    return subscribeRecords(sessionId, (records) => {
+      setSummary(summarize(records))
+    })
+  }, [sessionId])
 
   React.useEffect(() => {
     if (!sessionId) return undefined

package/src/client/ui/DiffBadge.ts

@@ -1,39 +1,32 @@
 // @ts-nocheck
 /**
  * dsh-vscode-mode client — DiffBadge：header 差异角标（仅工作区有差异时显示）。
- * 迁移自原 src/client/index.ts 的 DiffBadge，语义不改。
+ * 轮询已收敛到 state/recordsFeed.ts 的会话级共享订阅，本组件不再自建定时器。
  * 作者 ddj 2026-08-20
  */
 import React from 'react'
 import { appUrl } from '../../shared/appUrl.js'
-import { rpc } from '../rpc.js'
 import { openEditorView, emitShowLauncher } from '../events.js'
 import { summarize } from '../state/records.js'
+import { subscribeRecords } from '../state/recordsFeed.js'
 
 /**
- * 会话 header 差异角标：5s 轮询 edrv.list，有差异时显示数字徽章，点击打开编辑区并拉起 DiffLauncher。
+ * 会话 header 差异角标：订阅会话差异记录，有差异时显示数字徽章，点击打开编辑区并拉起 DiffLauncher。
  */
 export function DiffBadge(props) {
   const sessionId = props?.sessionId
   const [summary, setSummary] = React.useState(null)
-  const seq = React.useRef(0)
-
-  const load = React.useCallback(() => {
-    if (!sessionId) return
-    const s = ++seq.current
-    rpc('edrv.list', { sessionId }).then((res) => {
-      if (s !== seq.current || !res || !res.ok || !Array.isArray(res.records)) return
-      setSummary(summarize(res.records))
-    }).catch(() => {})
-  }, [sessionId])
 
   React.useEffect(() => {
-    load()
-    const t = setInterval(load, 5000)
-    const onRefresh = () => load()
-    window.addEventListener('edrv:refresh', onRefresh)
-    return () => { clearInterval(t); window.removeEventListener('edrv:refresh', onRefresh) }
-  }, [load])
+    if (!sessionId) {
+      setSummary(null)
+      return undefined
+    }
+
+    return subscribeRecords(sessionId, (records) => {
+      setSummary(summarize(records))
+    })
+  }, [sessionId])
 
   const n = summary?.totalFiles ?? 0
   if (!n) return null