dsh-vscode-mode 0.1.19 → 0.1.21

package/package.json

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

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,13 +8,15 @@
  * 声明未就绪时抛 `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'
@@ -24,6 +26,10 @@ import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter
 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 { createOutlinePanel } from './outline/index.js'
+import { createOutlineSourceRegistry, registerBuiltinOutlineSources } from './outline/sources.js'
 import type { CompatAdapter } from '../shared/compat.js'
 
 export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'workspaces', 'sessions', 'conversation', 'settingsScope', 'webUiSettings']
@@ -37,18 +43,29 @@ export const inject = ['slots', 'timer', 'locale', 'connection', 'remote', 'work
 export function apply(ctx: any): void {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
 
-  // Monaco 预热：DSH 启动后后台加载编辑器核心（模块级 promise 去重），用户点开「文件编辑」页签即用，
-  // 不再等页签挂载后才首次拉取 /edrv/vendor/*。requestIdleCallback 让出首屏带宽，缺省回退延时调度；
-  // 预热失败静默吞掉（loader 失败会重置 promise，页签打开时仍走原有加载/重试路径）。
-  if (typeof window !== 'undefined') {
-    const preloadMonaco = () => loadMonaco(() => {}).catch(() => {})
-    if (typeof window.requestIdleCallback === 'function') window.requestIdleCallback(preloadMonaco, { timeout: 2000 })
-    else schedule(preloadMonaco, 300)
-  }
-
   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
@@ -65,6 +82,16 @@ 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')
+  // 大纲源注册表（公开预留口）：第三方语言插件（LSP/VSIX 等）注册更高优先级源即可覆盖兜底
+  const outlineSources = createOutlineSourceRegistry()
+  ctx.provide('edrvOutlineSources', outlineSources)
+  ctx.effect(() => registerBuiltinOutlineSources(outlineSources), 'vscode-mode: outline sources')
+  ctx.effect(() => sidebarPanels.register(createOutlinePanel()), 'vscode-mode: sidebar panel outline')
   ctx.effect(() => registry.register({
     id: 'system', label: '系统默认应用', priority: 0,
     open: (path: string) => originalOpenPath.call(workspaces, path),
@@ -99,14 +126,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, addToConversation })))
+  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources })))
+
+  // 对话输入框上方差异 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/outline/OutlinePanel.tsx

@@ -0,0 +1,213 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 侧边栏「大纲」面板。
+ * 数据源经 resolveOutline（源注册表，优先级降序、首个非空生效）解析当前活动文件符号：
+ * monaco 源吃原生 document symbol provider，fallback 源兜底无内置提供方的语言。
+ * 交互：点击符号跳转编辑器、▸/▾ 折叠、光标所在符号高亮、空/加载/错误态。
+ * 作者 ddj 2026-08-27
+ */
+import React from 'react'
+import { resolveOutline } from './sources.js'
+import type { SidebarCtx } from '../sidebar/types.js'
+
+/** 渲染符号数上限（防超大文件卡顿，超出显示截断提示）。 */
+const RENDER_CAP = 800
+
+/** kind 分组元信息（字形 + 样式类）。 */
+const KIND_GROUPS = {
+  func: { glyph: 'ƒ', cls: 'edrv-ol-func' },
+  type: { glyph: 'C', cls: 'edrv-ol-type' },
+  data: { glyph: '•', cls: 'edrv-ol-data' },
+  ns: { glyph: '▤', cls: 'edrv-ol-ns' },
+  key: { glyph: '·', cls: 'edrv-ol-key' },
+}
+
+/** SymbolKind 数值 → 分组（File0..Package3=ns；Class4/Enum9/Interface10/Struct22/TypeParameter25=type；Method5/Constructor8/Function11=func；Key19/EnumMember21=key）。 */
+function kindMeta(kind) {
+  const k = kind | 0
+  if (k <= 3) return KIND_GROUPS.ns
+  if (k === 4 || k === 9 || k === 10 || k === 22 || k === 25) return KIND_GROUPS.type
+  if (k === 5 || k === 8 || k === 11) return KIND_GROUPS.func
+  if (k === 19 || k === 21) return KIND_GROUPS.key
+  return KIND_GROUPS.data
+}
+
+/**
+ * 大纲面板主体。
+ * @param props.ctx 面板共享上下文（editor/outlineSources/activePath）
+ */
+export function OutlinePanel(props) {
+  const ctx = props?.ctx
+  const activePath = ctx?.activePath ?? null
+  const [symbols, setSymbols] = React.useState(null)
+  const [error, setError] = React.useState(null)
+  const [collapsed, setCollapsed] = React.useState({})
+  const [cursorLine, setCursorLine] = React.useState(null)
+  const seqRef = React.useRef(0)
+  // ref 镜像：refresh 稳定（[]），监听器只挂一次，避免 EditorView 每渲染重建 ctx 造成抖动
+  const ctxRef = React.useRef(ctx)
+  ctxRef.current = ctx
+  const activeRef = React.useRef(activePath)
+  activeRef.current = activePath
+  const sourcesRef = React.useRef(ctx?.outlineSources)
+  sourcesRef.current = ctx?.outlineSources
+
+  const refresh = React.useCallback(() => {
+    const c = ctxRef.current
+    const ed = c?.editor?.()
+    const model = ed?.getModel?.()
+    const seq = ++seqRef.current
+    if (!ed || !model) { setSymbols(null); setError(null); return }
+    const uriPath = model?.uri?.path
+    const modelPath = uriPath ? decodeURIComponent(String(uriPath).replace(/^\//, '')) : null
+    const active = activeRef.current
+    if (active && modelPath !== active) { setSymbols(null); setError(null); return }
+    const sources = sourcesRef.current
+    if (!sources) { setSymbols([]); setError(null); return }
+    setError(null)
+    resolveOutline(sources, { languageId: model.getLanguageId(), model, editor: ed, monaco: window.monaco })
+      .then((list) => { if (seq === seqRef.current) setSymbols(list || []) })
+      .catch((e) => { if (seq === seqRef.current) { setError(String(e?.message ?? e)); setSymbols(null) } })
+  }, [])
+
+  // 编辑器监听：模型切换/内容编辑（防抖）/光标移动 + edrv:refresh；
+  // 编辑器未就绪时轮询等待（避免面板先于 Monaco 挂载后永久停在加载态）
+  React.useEffect(() => {
+    const disposers = []
+    let debounceTimer = null
+    let waitTimer = null
+    const attach = () => {
+      const ed = ctxRef.current?.editor?.()
+      if (!ed) return false
+      let contentDisposable = null
+      const subContent = (model) => {
+        if (contentDisposable) { contentDisposable.dispose(); contentDisposable = null }
+        contentDisposable = model?.onDidChangeContent?.(() => {
+          if (debounceTimer) clearTimeout(debounceTimer)
+          debounceTimer = setTimeout(() => { debounceTimer = null; refresh() }, 300)
+        }) ?? null
+      }
+      const onModel = () => { subContent(ed.getModel?.()); refresh() }
+      const onCursor = (e) => setCursorLine(e?.position?.lineNumber ?? null)
+      subContent(ed.getModel?.())
+      const subs = [
+        ed.onDidChangeModel?.(onModel),
+        ed.onDidChangeCursorPosition?.(onCursor),
+        { dispose: () => { if (contentDisposable) contentDisposable.dispose() } },
+      ]
+      for (const s of subs) if (s) disposers.push(s)
+      refresh()
+      return true
+    }
+    const onRefresh = () => refresh()
+    window.addEventListener('edrv:refresh', onRefresh)
+    if (!attach()) {
+      waitTimer = setInterval(() => { if (attach()) { clearInterval(waitTimer); waitTimer = null } }, 400)
+    }
+    return () => {
+      if (debounceTimer) clearTimeout(debounceTimer)
+      if (waitTimer) clearInterval(waitTimer)
+      for (const d of disposers) if (d?.dispose) d.dispose()
+      window.removeEventListener('edrv:refresh', onRefresh)
+    }
+  }, [refresh])
+
+  // 活动文件变化 → 重拉
+  React.useEffect(() => { refresh() }, [refresh, activePath])
+
+  const jump = (sym) => {
+    const ed = ctxRef.current?.editor?.()
+    if (!ed) return
+    const line = Math.max(1, sym?.selectLine ?? sym?.startLine ?? 1)
+    ed.revealLineInCenter(line)
+    ed.setPosition({ lineNumber: line, column: 1 })
+    ed.focus()
+  }
+
+  const toggleCollapse = (key) => {
+    setCollapsed((prev) => Object.assign({}, prev, { [key]: prev[key] === true ? false : true }))
+  }
+
+  const allKeys = React.useMemo(() => {
+    const keys = []
+    const walk = (list, prefix) => {
+      for (let i = 0; i < list.length; i++) {
+        const key = prefix ? prefix + '/' + i : String(i)
+        const sym = list[i]
+        if (sym.children && sym.children.length) { keys.push(key); walk(sym.children, key) }
+      }
+    }
+    walk(symbols || [], '')
+    return keys
+  }, [symbols])
+
+  const setAll = (value) => {
+    const next = {}
+    for (const key of allKeys) next[key] = value
+    setCollapsed(next)
+  }
+
+  const renderTree = (list, depth, prefix) => {
+    const rows = []
+    const cap = Math.min(list.length, RENDER_CAP)
+    for (let i = 0; i < cap; i++) {
+      const sym = list[i]
+      const key = prefix ? prefix + '/' + i : String(i)
+      const kids = sym.children && sym.children.length ? sym.children : null
+      const isCollapsed = collapsed[key] === true
+      const meta = kindMeta(sym.kind)
+      const active = cursorLine != null && sym.startLine <= cursorLine && cursorLine <= sym.endLine
+      rows.push(React.createElement('div', {
+        key,
+        className: 'edrv-tree-row' + (active ? ' edrv-tree-active' : ''),
+        title: sym.detail || sym.name,
+        style: { paddingLeft: 6 + depth * 14 },
+        onClick: () => jump(sym),
+      },
+        React.createElement('span', {
+          className: 'edrv-tree-chev',
+          onClick: (e) => { e.stopPropagation(); toggleCollapse(key) },
+        }, kids ? (isCollapsed ? '▸' : '▾') : ''),
+        React.createElement('span', { className: 'edrv-outline-kind ' + meta.cls }, meta.glyph),
+        React.createElement('span', { className: 'edrv-tree-name' }, sym.name),
+        (sym.detail ? React.createElement('span', { className: 'edrv-outline-detail' }, sym.detail) : null),
+        React.createElement('span', { className: 'edrv-outline-ln' }, String(sym.selectLine ?? sym.startLine ?? ''))))
+      if (kids && !isCollapsed) rows.push(...renderTree(kids, depth + 1, key))
+    }
+    if (list.length > RENDER_CAP) {
+      rows.push(React.createElement('div', { key: 'cap', className: 'edrv-tree-loading' }, '符号过多，仅显示前 ' + RENDER_CAP + ' 个'))
+    }
+    return rows
+  }
+
+  const basename = activePath ? String(activePath).split(/[\\/]/).pop() || activePath : ''
+
+  let body
+  if (error) {
+    body = React.createElement('div', { className: 'edrv-tree' },
+      React.createElement('div', { className: 'edrv-tree-error' },
+        React.createElement('span', null, String(error)),
+        React.createElement('button', { className: 'edrv-side-btn', onClick: refresh }, '重试')))
+  } else if (!activePath) {
+    body = React.createElement('div', { className: 'edrv-tree' },
+      React.createElement('div', { className: 'edrv-tree-loading' }, '未打开文件'))
+  } else if (symbols === null) {
+    body = React.createElement('div', { className: 'edrv-tree' },
+      React.createElement('div', { className: 'edrv-tree-loading' }, '加载中…'))
+  } else if (symbols.length === 0) {
+    body = React.createElement('div', { className: 'edrv-tree' },
+      React.createElement('div', { className: 'edrv-tree-loading' }, '该语言暂不支持大纲或文件无符号'))
+  } else {
+    body = React.createElement('div', { className: 'edrv-tree' }, ...renderTree(symbols, 0, ''))
+  }
+
+  return React.createElement('div', { className: 'edrv-side-panel' },
+    React.createElement('div', { className: 'edrv-side-head' },
+      React.createElement('span', { className: 'edrv-side-title' }, '大纲'),
+      React.createElement('span', { className: 'edrv-side-root', title: activePath || '' }, basename),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', { className: 'edrv-side-btn', title: '折叠全部', disabled: !(symbols && symbols.length), onClick: () => setAll(true) }, '−'),
+      React.createElement('button', { className: 'edrv-side-btn', title: '展开全部', disabled: !(symbols && symbols.length), onClick: () => setAll(false) }, '+'),
+      React.createElement('button', { className: 'edrv-side-btn', title: '刷新大纲', onClick: refresh }, '⟳')),
+    body)
+}

package/src/client/outline/index.ts

@@ -0,0 +1,24 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 「大纲」面板定义（注册表一项）。
+ * 数据源解析复用 outline/sources 的源注册表（ctx.outlineSources 注入）。
+ * 作者 ddj 2026-08-27
+ */
+import React from 'react'
+import { OutlinePanel } from './OutlinePanel.js'
+import type { SidebarPanelDef, SidebarCtx } from '../sidebar/types.js'
+
+/**
+ * 构造大纲面板定义。
+ * @author ddj 2026年08月27号
+ * @returns 面板定义（无徽标；活动栏图标 📜）
+ */
+export function createOutlinePanel(): SidebarPanelDef {
+  return {
+    id: 'outline',
+    title: '大纲',
+    icon: '📜',
+    order: 20,
+    render: (ctx: SidebarCtx) => React.createElement(OutlinePanel, { ctx }),
+  }
+}