dsh-vscode-mode 0.1.20 → 0.1.22

package/package.json

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

package/src/client/fileReveal.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — 「在文件浏览器中打开」RPC 包装（树菜单与 Monaco 右键共用）。
+ * 归一化为 { ok, error? }，不抛异常；无会话/异常降级返回错误文案。
+ * 作者 ddj 2026-08-27
+ */
+import { rpc } from './rpc.js'
+
+export interface RevealOutcome {
+  ok: boolean
+  error?: string
+}
+
+/**
+ * 请求 host 在 OS 文件浏览器中打开/定位路径。
+ * @author ddj 2026年08月27号
+ * @param sessionId 会话 id（可空）
+ * @param path 工作区相对路径（'' = 根目录）
+ * @returns 成功或失败原因
+ */
+export async function revealInExplorer(sessionId: string | undefined, path: string): Promise<RevealOutcome> {
+  if (!sessionId) return { ok: false, error: '无活动会话' }
+  try {
+    const res = await rpc('edrv.revealInExplorer', { sessionId, path })
+    return res.ok ? { ok: true } : { ok: false, error: res.error }
+  } catch (error) {
+    return { ok: false, error: '打开异常:' + String(error) }
+  }
+}

package/src/client/index.ts

@@ -28,6 +28,10 @@ import { SIDEBAR_PLUGIN, pickSettingsBinder, registerSlotSafely } from './compat
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
+import { createTreeMenuRegistry } from './sidebar/contextMenu.js'
+import { createDefaultFileMenuItems } from './sidebar/menuItems.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']
@@ -85,6 +89,17 @@ export function apply(ctx: any): void {
   const sidebarPanels = createSidebarPanelRegistry()
   ctx.provide('edrvSidebarPanels', sidebarPanels)
   ctx.effect(() => sidebarPanels.register(createFilePanel()), 'vscode-mode: sidebar panel')
+  // 文件右键菜单项注册表（对外 provide，供本插件/第三方注册；内置「在文件浏览器中打开」）
+  const fileMenuItems = createTreeMenuRegistry()
+  ctx.provide('edrvFileContextMenuItems', fileMenuItems)
+  for (const item of createDefaultFileMenuItems()) {
+    ctx.effect(() => fileMenuItems.register(item), 'vscode-mode: file context menu item ' + item.id)
+  }
+  // 大纲源注册表（公开预留口）：第三方语言插件（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),
@@ -126,7 +141,7 @@ export function apply(ctx: any): void {
     order: 5,
     label: '文件编辑',
     inject: (sessionId: string) => ({ sessionId }),
-  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels })))
+  }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems })))
 
   // 对话输入框上方差异 dock：普通对话显示单文案按钮，文件编辑页由 EditorView 隐藏
   registerSlotSafely(ctx, {

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 }),
+  }
+}

package/src/client/outline/parse.ts

@@ -0,0 +1,271 @@
+/**
+ * dsh-vscode-mode client — 大纲兜底解析器（纯函数，无 DOM/Monaco 依赖，node 可测）。
+ * 覆盖无内置 document symbol provider 的语言：markdown/mdx、python、shell、powershell、
+ * lua、go、rust、yaml、ini(toml)、花括号语言（c/cpp/csharp/java/php/ruby/kotlin/swift/dart）。
+ * TS/JS/JSON/CSS/HTML 有 Monaco 原生 provider，不走这里。
+ * 作者 ddj 2026-08-27
+ */
+import type { OutlineSymbol } from './types.js'
+
+/** monaco SymbolKind 数值常量（与 LSP SymbolKind 一致，面板渲染按此分组）。 */
+export const SK = {
+  File: 0, Module: 1, Namespace: 2, Package: 3, Class: 4, Method: 5,
+  Property: 6, Field: 7, Constructor: 8, Enum: 9, Interface: 10,
+  Function: 11, Variable: 12, Constant: 13, String: 14, Number: 15,
+  Boolean: 16, Array: 17, Object: 18, Key: 19, Null: 20, EnumMember: 21,
+  Struct: 22, Event: 23, Operator: 24, TypeParameter: 25,
+} as const
+
+/** 花括号语言的泛型函数名排除集（避免误把控制流/关键字当符号）。 */
+const BRACE_KW = new Set([
+  'if', 'for', 'while', 'switch', 'catch', 'foreach', 'using', 'with', 'when',
+  'match', 'return', 'new', 'in', 'of', 'do', 'else', 'elif', 'then', 'yield',
+  'await', 'typeof', 'instanceof', 'case', 'default', 'try', 'finally', 'throw',
+])
+
+/** 花括号语言的类型关键字 → SymbolKind。 */
+const BRACE_TYPE_KIND: Record<string, number> = {
+  class: SK.Class, struct: SK.Struct, interface: SK.Interface, enum: SK.Enum,
+  namespace: SK.Namespace, module: SK.Module, trait: SK.Interface, record: SK.Class,
+}
+
+/** 按文档序（先序）补齐每个符号的 endLine：叶子取“下一个符号起行 - 1”，容器取末子 endLine。 */
+function computeEnds(symbols: OutlineSymbol[], lastLine: number): void {
+  const order: OutlineSymbol[] = []
+  const collect = (list: OutlineSymbol[]): void => {
+    for (const s of list) {
+      order.push(s)
+      if (s.children && s.children.length) collect(s.children)
+    }
+  }
+  collect(symbols)
+  for (let i = order.length - 1; i >= 0; i--) {
+    const s = order[i]
+    const kids = s.children ?? []
+    if (kids.length) {
+      s.endLine = Math.max(s.startLine, kids[kids.length - 1].endLine)
+    } else {
+      const next = order[i + 1]
+      const end = next ? Math.max(s.startLine, next.startLine - 1) : lastLine
+      s.endLine = Math.max(s.startLine, Math.min(end, lastLine))
+    }
+  }
+}
+
+/** 构造单行符号（起始行=跳转行=所在行；detail 为截断后的声明文本）。 */
+function mk(lineIndex: number, name: string, kind: number, raw: string): OutlineSymbol {
+  const detail = raw.trim().replace(/\s+/g, ' ').slice(0, 80)
+  const line = lineIndex + 1
+  const out: OutlineSymbol = { name, kind, startLine: line, endLine: line, selectLine: line }
+  if (detail && detail !== name) out.detail = detail
+  return out
+}
+
+/** Markdown/mdx：`#` 级标题，层级嵌套。 */
+function parseMarkdown(text: string): OutlineSymbol[] {
+  const roots: OutlineSymbol[] = []
+  const stack: Array<{ level: number; item: OutlineSymbol }> = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const m = /^(\#{1,6})\s+(.+?)\s*#*\s*$/.exec(lines[i])
+    if (!m) continue
+    const item: OutlineSymbol = {
+      name: m[2].trim(), kind: SK.Namespace,
+      startLine: i + 1, endLine: i + 1, selectLine: i + 1, children: [],
+    }
+    while (stack.length && stack[stack.length - 1].level >= m[1].length) stack.pop()
+    const parent = stack.length ? stack[stack.length - 1].item : null
+    ;(parent ? parent.children : roots)!.push(item)
+    stack.push({ level: m[1].length, item })
+  }
+  computeEnds(roots, lines.length)
+  return roots
+}
+
+/** Python：def/class 按缩进栈嵌套。 */
+function parsePython(text: string): OutlineSymbol[] {
+  const roots: OutlineSymbol[] = []
+  const stack: Array<{ indent: number; item: OutlineSymbol }> = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const m = /^([ \t]*)(?:class|def)\s+([A-Za-z_]\w*)\s*[(:]/.exec(lines[i])
+    if (!m) continue
+    const indent = m[1].replace(/\t/g, '  ').length
+    const isClass = /class\s/.test(lines[i])
+    const item: OutlineSymbol = {
+      name: m[2], kind: isClass ? SK.Class : SK.Function,
+      startLine: i + 1, endLine: i + 1, selectLine: i + 1, children: [],
+    }
+    while (stack.length && stack[stack.length - 1].indent >= indent) stack.pop()
+    const parent = stack.length ? stack[stack.length - 1].item : null
+    ;(parent ? parent.children : roots)!.push(item)
+    stack.push({ indent, item })
+  }
+  computeEnds(roots, lines.length)
+  return roots
+}
+
+/** Shell：`name() {` 函数。 */
+function parseShell(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const m = /^[ \t]*([A-Za-z_][A-Za-z0-9_]*)[ \t]*\(\)[ \t]*\{/.exec(lines[i])
+    if (m) out.push(mk(i, m[1], SK.Function, lines[i]))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** PowerShell：`function Name {` / `filter Name {`。 */
+function parsePwsh(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const m = /^[ \t]*(?:function|filter)[ \t]+([\w.-]+)/.exec(lines[i])
+    if (m) out.push(mk(i, m[1], SK.Function, lines[i]))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** Lua：`function Foo:bar` / `M.bar = class|function`。 */
+function parseLua(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    if (/^\s*--/.test(line)) continue
+    const fm = /^[ \t]*(?:local[ \t]+)?function[ \t]+([A-Za-z_][\w.:]*)/.exec(line)
+    if (fm) { out.push(mk(i, fm[1], SK.Function, line)); continue }
+    const cm = /^[ \t]*([A-Za-z_][\w.]*)[ \t]*=[ \t]*(?:class|function)\b/.exec(line)
+    if (cm) out.push(mk(i, cm[1], /class\b/.test(line) ? SK.Class : SK.Function, line))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** Go：func（含 receiver）/ type。 */
+function parseGo(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const fm = /^[ \t]*func[ \t]+(?:\([^)]*\)[ \t]*)?([A-Za-z_]\w*)/.exec(lines[i])
+    if (fm) { out.push(mk(i, fm[1], SK.Function, lines[i])); continue }
+    const tm = /^[ \t]*type[ \t]+([A-Za-z_]\w*)/.exec(lines[i])
+    if (tm) out.push(mk(i, tm[1], SK.Struct, lines[i]))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** Rust：fn/struct/enum/trait/impl/mod/type。 */
+function parseRust(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  const kindOf: Record<string, number> = {
+    fn: SK.Function, struct: SK.Struct, enum: SK.Enum, trait: SK.Interface,
+    impl: SK.Module, mod: SK.Module, type: SK.TypeParameter,
+  }
+  for (let i = 0; i < lines.length; i++) {
+    const m = /^[ \t]*(?:pub(?:\([^)]*\))?[ \t]+)?(fn|struct|enum|trait|impl|mod|type)[ \t]+([A-Za-z_]\w*)/.exec(lines[i])
+    if (m && kindOf[m[1]]) out.push(mk(i, m[2], kindOf[m[1]], lines[i]))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** YAML：仅顶层键。 */
+function parseYaml(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    if (!line.trim() || /^\s/.test(line) || /^\s*[#-]/.test(line)) continue
+    const m = /^([A-Za-z0-9_.\-]+)\s*:/.exec(line)
+    if (m) out.push(mk(i, m[1], SK.Key, line))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** INI/TOML：`[section]` + `key=value`。 */
+function parseIni(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    if (!line.trim() || /^\s*[;#]/.test(line)) continue
+    const sm = /^\[([^\]]+)\]/.exec(line)
+    if (sm) { out.push(mk(i, sm[1], SK.Namespace, line)); continue }
+    const km = /^([A-Za-z0-9_.\-]+)\s*[=:]/.exec(line.trim())
+    if (km) out.push(mk(i, km[1], SK.Key, line))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/** 花括号语言（C 族/JVM/.NET）：类型声明 + 泛型函数扫描（扁平，best-effort）。 */
+function parseBrace(text: string): OutlineSymbol[] {
+  const out: OutlineSymbol[] = []
+  const lines = text.split('\n')
+  const typeRe = /^[ \t]*(?:(?:public|private|protected|internal|static|final|abstract|sealed|readonly|export|declare|async|open|extern|virtual|override|const|global|pub|local)\s+)*(class|struct|interface|enum|namespace|module|trait|record)\s+([A-Za-z_]\w*)/
+  // 泛型函数：允许任意“字词型”返回类型/修饰符前缀（含 :: 限定名），名字后跟 ( 且不以 ; 结尾
+  const funcRe = /^[ \t]*(?:[\w<>,*&\[\].:]+\s+)*([A-Za-z_]\w*)\s*(?:<[^>]*>)?\s*\(/
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i]
+    const t = line.trim()
+    if (!t || /^\s*\*/.test(line)) continue
+    const tm = typeRe.exec(line)
+    if (tm) { out.push(mk(i, tm[2], BRACE_TYPE_KIND[tm[1]] ?? SK.Class, line)); continue }
+    const fm = funcRe.exec(line)
+    if (!fm) continue
+    if (BRACE_KW.has(fm[1]) || /;\s*$/.test(t)) continue
+    out.push(mk(i, fm[1], SK.Function, line))
+  }
+  computeEnds(out, lines.length)
+  return out
+}
+
+/**
+ * 按 Monaco languageId 解析大纲符号（纯函数）。
+ * @author ddj 2026年08月27号
+ * @param languageId Monaco 语言 id
+ * @param text 文件全文
+ * @returns 归一化大纲符号树
+ */
+export function parseOutline(languageId: string, text: string): OutlineSymbol[] {
+  switch (languageId) {
+    case 'markdown':
+    case 'mdx':
+      return parseMarkdown(text)
+    case 'python':
+      return parsePython(text)
+    case 'shell':
+      return parseShell(text)
+    case 'powershell':
+      return parsePwsh(text)
+    case 'lua':
+      return parseLua(text)
+    case 'go':
+      return parseGo(text)
+    case 'rust':
+      return parseRust(text)
+    case 'yaml':
+      return parseYaml(text)
+    case 'ini':
+      return parseIni(text)
+    case 'c':
+    case 'cpp':
+    case 'csharp':
+    case 'java':
+    case 'php':
+    case 'ruby':
+    case 'kotlin':
+    case 'swift':
+    case 'dart':
+      return parseBrace(text)
+    default:
+      return []
+  }
+}