dsh-vscode-mode 0.1.17 → 0.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.17",
+  "version": "0.1.20",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 中央编辑器（文件页签/QuickOpen/状态栏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/addToConversation.ts

@@ -0,0 +1,211 @@
+/**
+ * dsh-vscode-mode client — 把文件/选中内容注入会话对话输入框（composer draft）。
+ * 复用 DSH 官方输入门面：ctx.conversation.input.for(sessions.scope(sessionId)) → SessionInput。
+ * 引用 chip：insertReference（reference source，发送时序列化为 @path 文本）；忙态降级为纯文本 setDraft。
+ * 纯函数部分 node 可单测。
+ * 作者 ddj 2026-08-25
+ */
+
+/** 文件引用可选的行区间（选中内容用）。 */
+export interface RefRange {
+  startLine: number
+  endLine: number
+}
+
+/** 引用动作的返回状态。 */
+export type AddOutcome = 'ok' | 'busy' | 'unavailable'
+
+/** DSH reference source 名（dsh-client-ui-reference 注册的 @file/@session 统一源）。 */
+const REF_SOURCE = 'reference'
+
+/**
+ * 生成 DSH @file 语法引用串：cwd 相对化、\ → /、含空白时按 @"path" 语法加引号。
+ * cwd 外/无法相对化的路径回退原路径。
+ * @author ddj 2026年08月25号
+ * @param path 打开的文件路径（相对 cwd 或绝对）
+ * @param cwd 会话工作区目录（可选）
+ * @returns 引用串（如 @src/index.ts 或 @"a b.ts"）
+ */
+export function mentionOf(path: string, cwd: string | undefined): string {
+  const raw = String(path)
+  let rel = raw
+  if (cwd) {
+    const base = String(cwd).replace(/[\\/]+$/, '')
+    const up = raw.replace(/\\/g, '/')
+    const baseUp = base.replace(/\\/g, '/')
+    if (up.startsWith(baseUp + '/')) rel = up.slice(baseUp.length + 1)
+    else if (up === baseUp) rel = ''
+  }
+  rel = rel.replace(/\\/g, '/').replace(/^\.\//, '')
+  if (!rel) rel = raw.replace(/\\/g, '/')
+  if (/[\u0000-\u001f\u007f-\u009f"]/u.test(rel)) return '@' + raw
+  return /\s/u.test(rel) ? `@"${rel}"` : `@${rel}`
+}
+
+/** 引用标签：文件名 + 可选行区间（chip 内展示，不带 @ 前缀）。
+ * @author ddj 2026年08月25号 */
+export function labelOf(path: string, range: RefRange | undefined): string {
+  const base = String(path).split(/[\\/]/).pop() || String(path)
+  if (!range || range.endLine < range.startLine) return base
+  return range.startLine === range.endLine
+    ? `${base} L${range.startLine}`
+    : `${base} L${range.startLine}-${range.endLine}`
+}
+
+/** 引用 ref：引用串 + 可选行区间（序列化直出，agent 据此读取对应片段）。
+ * @author ddj 2026年08月25号 */
+export function refOf(mention: string, range: RefRange | undefined): string {
+  if (!range || range.endLine < range.startLine) return mention
+  return range.startLine === range.endLine
+    ? `${mention} L${range.startLine}`
+    : `${mention} L${range.startLine}-${range.endLine}`
+}
+
+/** 构造 DSH 文件引用插入载荷（source=reference，发送序列化为 mention(+range) 文本）。 */
+export function buildFileRef(
+  path: string,
+  cwd: string | undefined,
+  range?: RefRange,
+): { reference: ReferenceInsertLike; mention: string } {
+  const mention = mentionOf(path, cwd)
+  return {
+    mention,
+    reference: {
+      source: REF_SOURCE,
+      ref: refOf(mention, range),
+      label: labelOf(path, range),
+      appearance: 'file',
+      clipboardText: mention,
+    },
+  }
+}
+
+/** 输入门面最小形状（运行时来自 ctx.conversation.input，避免引入新类型依赖）。 */
+export interface InputLike {
+  state: { getSnapshot: () => { draft: string; draftRev: number } }
+  insertReference: (ref: ReferenceInsertLike, span: TokenSpanLike) => boolean
+  setDraft: (text: string) => void
+  notify: (level: 'info' | 'error', text: string) => void
+}
+
+/** ReferenceInsert 结构形状（与 dsh-client-ui-input-trigger 类型一致）。 */
+export interface ReferenceInsertLike {
+  source: string
+  ref: string
+  label: string
+  appearance?: 'session' | 'file' | 'folder'
+  clipboardText: string
+}
+
+/** TokenSpan 结构形状（start/end 为草稿字符偏移，draftRev 为 CAS 版本）。 */
+export interface TokenSpanLike {
+  start: number
+  end: number
+  draftRev: number
+}
+
+/** ctx 依赖的最小面（sessions.scope + conversation.input）。 */
+export interface CtxLike {
+  get: (name: string) => unknown
+}
+
+/** 注入器产物：给 EditorView 用的动作集合。 */
+export interface AddToConversation {
+  /** 追加文件引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
+  appendReference(sessionId: string | undefined, path: string, range?: RefRange): Promise<AddOutcome>
+}
+
+/**
+ * 解析会话输入门面；缺失时返回 undefined（动作侧守卫降级）。
+ * @author ddj 2026年08月25号
+ * @param ctx 客户端服务上下文
+ * @param sessionId 会话 id
+ * @returns SessionInput 或 undefined
+ */
+export function inputFor(ctx: CtxLike, sessionId: string | undefined): InputLike | undefined {
+  if (!sessionId) return undefined
+  try {
+    const sessions = ctx.get('sessions') as { scope?: (id: string) => unknown } | undefined
+    const conversation = ctx.get('conversation') as { input?: { for: (actx: unknown) => unknown } } | undefined
+    const actx = sessions?.scope?.(sessionId)
+    const shell = actx && conversation?.input?.for?.(actx)
+    return (shell && typeof (shell as InputLike).setDraft === 'function') ? shell as InputLike : undefined
+  } catch {
+    return undefined
+  }
+}
+
+/** 取当前草稿长度与版本；无输入门面时返回 null。
+ * @author ddj 2026年08月25号 */
+function draftCursor(input: InputLike | undefined): { draft: string; draftRev: number } | null {
+  try {
+    const s = input?.state?.getSnapshot?.()
+    if (!s) return null
+    return { draft: String(s.draft ?? ''), draftRev: Number(s.draftRev ?? 0) }
+  } catch {
+    return null
+  }
+}
+
+/** 从 sessions 列表快照读会话工作区目录（与 index.ts 既有读取方式一致）。
+ * @author ddj 2026年08月25号 */
+function cwdOf(ctx: CtxLike, sessionId: string | undefined): string | undefined {
+  if (!sessionId) return undefined
+  try {
+    const sessions = ctx.get('sessions') as
+      | { list?: { getSnapshot?: () => { byId?: Record<string, { cwd?: string }> } } }
+      | undefined
+    return sessions?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd
+  } catch {
+    return undefined
+  }
+}
+
+/** 写入成功后的 composer 内联提示（门面可用时；失败静默）。
+ * @author ddj 2026年08月25号 */
+function notify(input: InputLike, text: string): void {
+  try {
+    input.notify?.('info', text)
+  } catch {
+    /* 提示失败忽略 */
+  }
+}
+
+/** 输入门面插入引用（拦截异常视作未应用，走降级）。
+ * @author ddj 2026年08月25号 */
+function safeInsert(input: InputLike, reference: ReferenceInsertLike, span: TokenSpanLike): boolean {
+  try {
+    return input.insertReference(reference, span) === true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 创建「添加到对话」动作集（apply 阶段构建一次，随 props 传给 EditorView）。
+ * @author ddj 2026年08月25号
+ * @param ctx 客户端服务上下文（sessions + conversation）
+ * @returns 动作集
+ */
+export function createAddToConversation(ctx: CtxLike): AddToConversation {
+  const appendReference: AddToConversation['appendReference'] = async (sessionId, path, range) => {
+    const input = inputFor(ctx, sessionId)
+    if (!input) return 'unavailable'
+    const cur = draftCursor(input)
+    if (!cur) return 'unavailable'
+    const { reference, mention } = buildFileRef(path, cwdOf(ctx, sessionId), range)
+    const span: TokenSpanLike = { start: cur.draft.length, end: cur.draft.length, draftRev: cur.draftRev }
+    const ok = safeInsert(input, reference, span)
+    if (!ok) {
+      // 忙态（adjudicating/submitting）或 CAS 失败：降级纯文本追加，保证动作有落点。
+      const gap = cur.draft.length > 0 && !/\s$/.test(cur.draft) ? ' ' : ''
+      input.setDraft(cur.draft + gap + mention + ' ')
+      notify(input, '已添加文件引用 ' + mention)
+      return 'busy'
+    }
+    notify(input, '已添加文件引用 ' + mention)
+    return 'ok'
+  }
+
+  return { appendReference }
+}

package/src/client/diffDock.ts

@@ -0,0 +1,52 @@
+/**
+ * dsh-vscode-mode client — 对话差异 dock 纯函数。
+ * 只负责差异文件轮转和文案，状态查询仍由组件复用现有 edrv.list/summarize。
+ * 作者 ddj 2026-08-26
+ */
+
+/**
+ * 从稳定差异文件列表中取下一个路径，并返回下一次索引。
+ * @author ddj 2026年08月26号
+ * @param paths 待处理差异文件路径
+ * @param index 当前轮转索引
+ * @returns 下一个路径与归一化后的下一索引
+ */
+export function nextDiffPath(paths: string[], index: number): { path: string | null; index: number } {
+  if (!paths.length) return { path: null, index: 0 }
+  const current = Number.isFinite(index) ? Math.max(0, Math.floor(index)) : 0
+  const at = current % paths.length
+  return { path: paths[at] ?? null, index: (at + 1) % paths.length }
+}
+
+/**
+ * 生成对话差异 dock 的单按钮文案。
+ * @author ddj 2026年08月26号
+ * @param count 待处理差异文件数量
+ * @returns 展示文案
+ */
+export function diffDockText(count: number): string {
+  return '差异 ' + Math.max(0, Math.floor(count)) + ' 个文件 · 查看下一个'
+}
+
+/**
+ * 根据活动文件决定编辑页 dock 形态，加载期间保持 editor 结构稳定。
+ * @author ddj 2026年08月26号
+ * @param activePath 当前活动文件路径
+ * @returns 编辑态或无文件空态
+ */
+export function editorDockMode(activePath: string | null | undefined): 'editor' | 'editor-empty' {
+  return activePath ? 'editor' : 'editor-empty'
+}
+
+/**
+ * 获取切换文件期间稳定展示的文件内差异数量。
+ * @author ddj 2026年08月26号
+ * @param ready 当前文件内容是否已加载完成
+ * @param actualTotal 内容就绪后的精确差异数
+ * @param fallbackTotal 内容加载期间的文件摘要差异数
+ * @returns 非负整数差异数
+ */
+export function displayDiffTotal(ready: boolean, actualTotal: number, fallbackTotal: number): number {
+  const value = ready ? actualTotal : fallbackTotal
+  return Number.isFinite(value) ? Math.max(0, Math.floor(value)) : 0
+}

package/src/client/diffDockStore.ts

@@ -0,0 +1,87 @@
+/**
+ * dsh-vscode-mode client — 会话级差异 dock store。
+ * EditorView 发布当前编辑上下文，conversation.input.dock 唯一读取并渲染。
+ * 作者 ddj 2026年08月26号
+ */
+
+/** 差异 dock 的显示形态。 */
+export type DiffDockMode = 'chat' | 'editor' | 'editor-empty'
+
+/**
+ * 跨 slot 传递的差异 dock 快照。
+ * 操作回调随快照一起更新，避免 dock 持有已卸载编辑器的旧闭包。
+ */
+export interface DiffDockSnapshot {
+  mode: DiffDockMode
+  [key: string]: unknown
+}
+
+type DiffDockListener = () => void
+type DiffDockSource = object
+
+const values = new Map<string, DiffDockSnapshot>()
+const sources = new Map<string, DiffDockSource>()
+const listeners = new Map<string, Set<DiffDockListener>>()
+
+/** 通知指定会话的 dock 订阅者。 */
+function notifyDiff(sessionId: string): void {
+  for (const listener of listeners.get(sessionId) ?? []) listener()
+}
+
+/**
+ * 发布指定会话的最新编辑器差异上下文。
+ * @author ddj 2026年08月26号
+ * @param sessionId 会话 id
+ * @param snapshot 完整 DiffBox 操作上下文
+ * @param source 发布者令牌，用于卸载时防止误清理新实例
+ */
+export function publishDiffDock(sessionId: string, snapshot: DiffDockSnapshot, source?: DiffDockSource): void {
+  values.set(sessionId, snapshot)
+  if (source) sources.set(sessionId, source)
+  else sources.delete(sessionId)
+  notifyDiff(sessionId)
+}
+
+/**
+ * 清除指定会话的差异上下文。
+ * @author ddj 2026年08月26号
+ * @param sessionId 会话 id
+ * @param source 可选发布者令牌；不匹配时忽略清理
+ */
+export function clearDiffDock(sessionId: string, source?: DiffDockSource): void {
+  if (source && sources.get(sessionId) !== source) return
+  values.delete(sessionId)
+  sources.delete(sessionId)
+  notifyDiff(sessionId)
+}
+
+/**
+ * 读取指定会话的最新上下文。
+ * @author ddj 2026年08月26号
+ * @param sessionId 会话 id
+ * @returns 最新上下文或 null
+ */
+export function readDiffDock(sessionId?: string): DiffDockSnapshot | null {
+  if (!sessionId) return null
+  return values.get(sessionId) ?? null
+}
+
+/**
+ * 订阅指定会话的上下文变化。
+ * @author ddj 2026年08月26号
+ * @param sessionId 会话 id
+ * @param listener 变化回调
+ * @returns 取消订阅函数
+ */
+export function subscribeDiffDock(sessionId: string, listener: DiffDockListener): () => void {
+  let bucket = listeners.get(sessionId)
+  if (!bucket) {
+    bucket = new Set()
+    listeners.set(sessionId, bucket)
+  }
+  bucket.add(listener)
+  return () => {
+    bucket!.delete(listener)
+    if (!bucket!.size) listeners.delete(sessionId)
+  }
+}

package/src/client/editorLayout.ts

@@ -0,0 +1,19 @@
+/**
+ * dsh-vscode-mode client — 编辑区与原生 composer 的几何边界计算。
+ * @author ddj 2026年08月26号
+ */
+
+/**
+ * 计算编辑根节点在当前会话滚动区内、composer 上方可使用的高度。
+ * @author ddj 2026年08月26号
+ * @param rootTop 编辑根节点顶边
+ * @param scrollBottom 会话滚动区可视底边
+ * @param composerTop composer 顶边；缺失时回退滚动区底边
+ * @returns 非负可用高度
+ */
+export function editorHeight(rootTop: number, scrollBottom: number, composerTop?: number): number {
+  const root = Number.isFinite(rootTop) ? rootTop : 0
+  const scroll = Number.isFinite(scrollBottom) ? scrollBottom : root
+  const composer = Number.isFinite(composerTop) ? composerTop as number : scroll
+  return Math.max(0, Math.min(scroll, composer) - root)
+}

package/src/client/events.ts

@@ -5,18 +5,43 @@
  */
 
 /**
- * 打开中央「文件编辑」页签：点击 shell 会话头部的视图页签（DOM 级，无需 store actions）。
- * @author ddj 2026年08月20号
- * @param path 要打开的路径（可空）
+ * 选择中央「文件编辑」页签（DOM 级，无需 store actions）。
+ * @author ddj 2026年08月26号
  */
-export function openEditorView(path: string | null): void {
+function selectEditorTab(): void {
   const tabs = Array.from(document.querySelectorAll('div[role="tablist"] button[role="tab"]'))
-  for (const b of tabs) {
-    if (b.textContent && b.textContent.includes('文件编辑')) { (b as HTMLButtonElement).click(); break }
+  for (const tab of tabs) {
+    if (tab.textContent && tab.textContent.includes('文件编辑')) {
+      (tab as HTMLButtonElement).click()
+      break
+    }
   }
-  const p = path ?? null
+}
+
+/**
+ * 打开中央「文件编辑」页签。
+ * @author ddj 2026年08月26号
+ * @param path 要打开的路径（可空）
+ */
+export function openEditorView(path: string | null): void {
+  selectEditorTab()
+  const target = path ?? null
   setTimeout(() => {
-    window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: { path: p } }))
+    window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: { path: target } }))
+  }, 80)
+}
+
+/**
+ * 打开文件编辑页并聚焦指定文件的首个差异。
+ * @author ddj 2026年08月26号
+ * @param path 待聚焦的差异文件路径
+ */
+export function openDiffView(path: string): void {
+  selectEditorTab()
+  setTimeout(() => {
+    window.dispatchEvent(new CustomEvent('edrv:open-editor', {
+      detail: { path, focusDiff: true },
+    }))
   }, 80)
 }
 
@@ -30,7 +55,11 @@ export function emitOpenEditor(path: string): void {
   window.dispatchEvent(new CustomEvent('edrv:open-editor', { detail: { path } }))
 }
 
-/** 拉起 DiffLauncher。 */
-export function emitShowLauncher(): void {
-  window.dispatchEvent(new CustomEvent('edrv:show-launcher'))
+/**
+ * 拉起 DiffLauncher。
+ * @author ddj 2026年08月26号
+ * @param tab 可选的目标页签
+ */
+export function emitShowLauncher(tab?: 'pending' | 'archive'): void {
+  window.dispatchEvent(new CustomEvent('edrv:show-launcher', { detail: { tab } }))
 }

package/src/client/index.ts

@@ -1,6 +1,6 @@
 /**
  * dsh-vscode-mode client — 浏览器半入口：slot 注册 + 装配。
- * 挂点：conversation.view「文件编辑」页签（中央 Monaco 编辑器）+ header 差异角标。
+ * 挂点：conversation.view「文件编辑」页签（中央 Monaco 编辑器）+ conversation.input.dock 差异条 + header 差异角标。
  * 与 Host 通信：同源 fetch('/edrv/rpc')（shared/rpc 契约）。
  *
  * ⚠️ 跨版本 slot 装配（2026-08-21）：新版 DSH 的 slots 系统要求 slot 必须由父 entry
@@ -8,23 +8,29 @@
  * 声明未就绪时抛 `slot ... is not declared (a parent entry's children table must declare it)`。
  * 正确写法 = `ctx.slots.inject(name, () => ctx.slots.register(...))`：声明存在时同步
  * 执行，否则等待声明（官方 ui-conversation 自身即此模式）；旧版（rc.8 及更早）同样支持，
- * 故跨版本兼容。slot 名未变：conversation.view / conversation.session.header.utilities。
+ * 故跨版本兼容。slot 名：conversation.view / conversation.session.header.utilities /
+ * conversation.input.dock。
  * 作者 ddj 2026-08-20
  */
 import React from 'react'
 import './styles/editor.css'
 import { EditorView } from './ui/EditorView.js'
 import { DiffBadge } from './ui/DiffBadge.js'
+import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
 import { rpc } from './rpc.js'
+import { loadMonaco } from './monaco/loader.js'
 import { createFileOpenerRegistry, scanSidebar, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
 import { SettingsContext } from './settingsContext.js'
 import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat.js'
+import { createAddToConversation } from './addToConversation.js'
+import { createSidebarPanelRegistry } from './sidebar/registry.js'
+import { createFilePanel } from './sidebar/panels/index.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
-export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'settingsScope', 'webUiSettings']
+export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation', 'settingsScope', 'webUiSettings']
 
 /**
  * 装配客户端：注册中央编辑区视图与 header 差异角标。
@@ -34,13 +40,36 @@ export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'work
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function apply(ctx: any): void {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
+
   const registry: FileOpenerRegistry = createFileOpenerRegistry()
   const workspaces = ctx.get('workspaces')
   const sessions = ctx.get('sessions')
+
+  // Monaco 加载时机：不再 DSH 启动即预热，改为进入会话界面（sessions.list.current 出现）后再后台加载，
+  // 用户点开「文件编辑」页签即用；空闲时仍由 EditorView 挂载兜底加载。
+  // 模块级 promise 去重，重复触发只首次真正加载；requestIdleCallback 让出会话首屏带宽，缺省回退延时调度；
+  // 预热失败静默吞掉（loader 失败会重置 promise，页签打开时仍走原有加载/重试路径）。
+  const monacoList = sessions?.list
+  if (typeof window !== 'undefined' && monacoList && typeof monacoList.subscribe === 'function') {
+    const list = monacoList as { getSnapshot: () => { current?: unknown }; subscribe: (listener: () => void) => () => void }
+    const schedulePreload = () => {
+      const preload = () => loadMonaco(() => {}).catch(() => {})
+      if (typeof window.requestIdleCallback === 'function') window.requestIdleCallback(preload, { timeout: 2000 })
+      else schedule(preload, 300)
+    }
+    const onSessionEnter = () => {
+      if (!list.getSnapshot()?.current) return
+      schedulePreload()
+    }
+    ctx.effect(() => list.subscribe(onSessionEnter), 'vscode-mode: monaco session trigger')
+    onSessionEnter()
+  }
   const originalOpenPath = workspaces?.openPath
   const binder = pickSettingsBinder(ctx)
   const settings = binder.scope
   let selected = autoValue('auto')
+  /** 「添加到对话」动作集：编辑区/Tab 右键菜单注入文件引用与代码块（conversation 服务缺失时各动作安全降级）。 */
+  const addToConversation = createAddToConversation(ctx)
 
   /** 客户端侧兼容摘要（与 host 报告合并展示；惰性求值保证 HMR 后仍新鲜）。 */
   const compatSummary = (): CompatAdapter[] => [
@@ -51,6 +80,11 @@ export function apply(ctx: any): void {
 
   ctx.provide('fileOpeners', registry)
   ctx.effect(() => registry.register(vscodeOpener()), 'vscode-mode: file opener')
+
+  // 侧边栏面板注册表（对外 provide，供本插件/第三方注册面板；文件管理为面板 #1）
+  const sidebarPanels = createSidebarPanelRegistry()
+  ctx.provide('edrvSidebarPanels', sidebarPanels)
+  ctx.effect(() => sidebarPanels.register(createFilePanel()), 'vscode-mode: sidebar panel')
   ctx.effect(() => registry.register({
     id: 'system', label: '系统默认应用', priority: 0,
     open: (path: string) => originalOpenPath.call(workspaces, path),
@@ -85,14 +119,23 @@ export function apply(ctx: any): void {
     }), 'vscode-mode: file link routing')
   }
 
-  // 中央「文件编辑」页签：类 VSCode 编辑器（顶部=文件页签+搜索框，差异 UI=文件底部圆角悬浮框）
+  // 中央「文件编辑」页签：类 VSCode 编辑器（顶部=文件页签+搜索框，左侧=侧边栏，差异 UI=文件底部圆角悬浮框）
   registerSlotSafely(ctx, {
     name: 'conversation.view',
     id: 'edrv-editor',
     order: 5,
     label: '文件编辑',
     inject: (sessionId: string) => ({ sessionId }),
-  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule })))
+  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels })))
+
+  // 对话输入框上方差异 dock：普通对话显示单文案按钮，文件编辑页由 EditorView 隐藏
+  registerSlotSafely(ctx, {
+    name: 'conversation.input.dock',
+    id: 'edrv-diff-dock',
+    order: 30,
+    label: '差异',
+    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: '差异' },

package/src/client/sidebar/SidebarView.ts

@@ -0,0 +1,73 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 侧边栏容器（活动栏 + 面板区 + 拖拽调宽）。
+ * 面板列表来自注册表（活动栏图标/徽标/激活态），渲染当前激活面板的 render(ctx)；
+ * 右侧手柄拖拽调宽（clamp 180–560），底部按钮收起侧边栏。
+ * 作者 ddj 2026-08-26
+ */
+import React from 'react'
+import type { SidebarCtx } from './types.js'
+
+const W_MIN = 180
+const W_MAX = 560
+
+/**
+ * 侧边栏容器。
+ * @param props.registry 面板注册表（list() 提供面板顺序）
+ * @param props.ctx 面板共享上下文
+ * @param props.activePanel 当前激活面板 id
+ * @param props.onActive 激活面板变化回调
+ * @param props.width 面板区宽度
+ * @param props.onWidth 宽度变化回调
+ * @param props.onHide 收起侧边栏回调
+ */
+export function SidebarView(props) {
+  const panels = props.registry?.list?.() ?? []
+  const ctx = props.ctx
+  const activePanel = props.activePanel
+  const onActive = props.onActive
+  const width = props.width
+  const onWidth = props.onWidth
+  const onHide = props.onHide
+
+  const active = panels.find((p) => p.id === activePanel) || panels[0]
+
+  const onPointerDown = (e) => {
+    e.preventDefault()
+    const startX = e.clientX
+    const startW = width
+    const onMove = (ev) => {
+      const w = Math.max(W_MIN, Math.min(W_MAX, startW + (ev.clientX - startX)))
+      onWidth(w)
+    }
+    const onUp = () => {
+      window.removeEventListener('pointermove', onMove)
+      window.removeEventListener('pointerup', onUp)
+    }
+    window.addEventListener('pointermove', onMove)
+    window.addEventListener('pointerup', onUp)
+  }
+
+  const rail = React.createElement('div', { className: 'edrv-rail' },
+    React.createElement('div', { style: { flex: 1, display: 'flex', flexDirection: 'column', gap: 2 } },
+      panels.map((p) => {
+        const count = typeof p.badge === 'function' ? p.badge(ctx) : null
+        return React.createElement('button', {
+          key: p.id,
+          className: 'edrv-rail-btn' + (active && p.id === active.id ? ' edrv-rail-on' : ''),
+          title: p.title,
+          onClick: () => onActive(p.id),
+        },
+          React.createElement('span', { className: 'edrv-rail-icon' }, p.icon),
+          count > 0
+            ? React.createElement('span', { className: 'edrv-rail-badge' }, String(count))
+            : null)
+      })),
+    React.createElement('button', { className: 'edrv-rail-btn', title: '隐藏侧边栏 (Ctrl+B)', onClick: onHide }, '◀'))
+
+  return React.createElement('div', { className: 'edrv-sidebar', style: { width } },
+    rail,
+    React.createElement('div', { className: 'edrv-side-body' },
+      active ? active.render(ctx) : null),
+    React.createElement('div', { className: 'edrv-side-resize', onPointerDown: onPointerDown }))
+}