dsh-vscode-mode 0.1.62 → 0.1.63

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.62",
+  "version": "0.1.63",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/index.ts

@@ -22,6 +22,7 @@ import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
 import { rpc } from './rpc.js'
 import { loadMonaco } from './monaco/loader.js'
+import { observeScheme, schemeOfSnapshot } from './monaco/theme.js'
 import { createFileOpenerRegistry, scanSidebar, officialSidebarOpener, shouldClaimFiles, type FileOpenContext } from './fileOpeners.js'
 import type { FileOpenerRegistry } from './fileOpeners.js'
 import { installOpenPathRouter, vscodeOpener, autoValue } from './openPathRouter.js'
@@ -33,6 +34,7 @@ import { detectSidebarService, installSideEditor, setEnsureSideEditor, SIDEBAR_I
 import { detectOfficial, installOfficial, registerOfficialFileClaim, OFFICIAL_TAB_KIND, OFFICIAL_TAB_TITLE, isEditorTabActive, restoreEditorTab } from './officialSidebar.js'
 import { SideEditorTab } from './ui/SideEditorTab.js'
 import { OfficialSideTab } from './ui/OfficialSideTab.js'
+import { createClaimRouter } from './ui/ClaimRouter.js'
 import { createAddToConversation } from './addToConversation.js'
 import { createSidebarPanelRegistry } from './sidebar/registry.js'
 import { createFilePanel } from './sidebar/panels/index.js'
@@ -148,7 +150,7 @@ export function apply(ctx: any): void {
     { name: '侧边栏打开器（' + SIDEBAR_PLUGIN + '）', active: registry.get(SIDEBAR_PLUGIN) !== undefined, note: registry.get(SIDEBAR_PLUGIN) !== undefined ? '已注册（优先级 80）' : '未检测到侧边栏打开能力' },
     { name: '侧边栏编辑区（官方 Sidebar）', active: officialService !== undefined, note: officialService !== undefined ? '编辑区=官方右侧 Sidebar Tab（对话+编辑同屏，DSH 0.1.5+）' : '官方侧边栏服务未探测到（DSH < 0.1.5-alpha.1 时属预期）' },
     { name: '侧边栏编辑区（' + SIDEBAR_PLUGIN + '，归档）', active: sideService !== undefined, note: sideService !== undefined ? '编辑区=侧边栏 Tab（旧版 DSH 回退形态）' : '未检测到；DSH ≥ 0.1.5 优先官方侧边栏，旧版可安装（' + SIDEBAR_INSTALL_CMD + '）' },
-    { name: '文件链接官方认领（dsh-resource://file）', active: claimDisposer !== null, note: claimDisposer !== null ? '聊天文件链接由本插件编辑器接管（官方侧边栏内打开）' : '链接走官方查看器或旧版路由（未认领）' },
+    { name: '文件链接官方认领（dsh-resource://file）', active: claimDisposer !== null, note: claimDisposer !== null ? '聊天文件链接转发进单一编辑器页签（文件分页归编辑器自带页签栏）' : '链接走官方查看器或旧版路由（未认领）' },
   ]
 
   ctx.provide('fileOpeners', registry)
@@ -183,14 +185,16 @@ export function apply(ctx: any): void {
     const sidebar = scanSidebar(ctx)
     return sidebar ? registry.register(sidebar) : undefined
   }, 'vscode-mode: sidebar file opener')
-  // 官方侧边栏正文组件装配（页类型与 file 认领两类 Tab 共用同一 EditorView 形态）
+  // 官方侧边栏正文组件装配（页类型正文；兼作 file 认领转发失败时的兜底正文）
   const officialRenderTab = (props: Record<string, unknown>) => React.createElement(OfficialSideTab, Object.assign({}, props, { schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, sessions }))
-  /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（链接进本插件编辑器），其余交官方查看器。 */
+  /** 官方 file 地址认领同步：自动/VSCodeMode 档认领（转发进单一编辑器页签），其余交官方查看器。 */
   const syncFileClaim = (): void => {
     const official = officialService
     const want = official !== undefined && shouldClaimFiles(selected)
     if (want && claimDisposer === null && official) {
-      const disposer = registerOfficialFileClaim({ tabs: official.tabs, slots: ctx.slots, renderTab: officialRenderTab })
+      // 认领正文只做转发：文件分页收归编辑器自带页签栏，官方侧栏不再按文件分裂编辑器实例
+      const renderTab = createClaimRouter({ service: official.service, schedule, fallback: officialRenderTab })
+      const disposer = registerOfficialFileClaim({ tabs: official.tabs, slots: ctx.slots, renderTab })
       if (disposer !== null) claimDisposer = ctx.effect(() => disposer, 'vscode-mode: official file claim')
       return
     }
@@ -265,6 +269,21 @@ export function apply(ctx: any): void {
   }
   retryRemoteOpen()
 
+  // 官方主题跟随（DSH 0.1.5+）：ctx.theme 快照事件优先，其次明暗标记观察（observeScheme），
+  // 都不可用时 theme.ts 的 detectColorScheme 兜底；统一广播 edrv:theme-change 触发 Monaco 主题重刷。
+  const themeService = ctx.get('theme') as { getTheme?: () => unknown } | undefined
+  const emitTheme = (): void => {
+    const snapshot = typeof themeService?.getTheme === 'function' ? themeService.getTheme() : undefined
+    window.dispatchEvent(new CustomEvent('edrv:theme-change', { detail: { scheme: schemeOfSnapshot(snapshot) } }))
+  }
+  ctx.effect(() => {
+    if (!themeService || typeof ctx.on !== 'function') return undefined
+    const disposer = ctx.on('theme/change', emitTheme)
+    return typeof disposer === 'function' ? disposer : undefined
+  }, 'vscode-mode: official theme event')
+  ctx.effect(() => observeScheme(emitTheme), 'vscode-mode: theme attribute watch')
+  emitTheme()
+
   // 中央「文件编辑」页签（旧形态回退）：类 VSCode 编辑器；侧边栏形态（官方/better-sidebar）可用时
   // 编辑器住侧边栏 Tab，本页签不注册（避免双实例：Monaco×2 + diff dock 每会话单源抢占）。
   const registerLegacyTab = (): (() => void) | null => {

package/src/client/keybindings.ts

@@ -25,6 +25,8 @@ export const COMMANDS: Array<{ id: string; label: string }> = [
   { id: 'edrv.searchInFiles', label: '在工作区中搜索' },
   { id: 'edrv.navigateBack', label: '后退（导航历史）' },
   { id: 'edrv.navigateForward', label: '前进（导航历史）' },
+  { id: 'edrv.nextTab', label: '下一个页签' },
+  { id: 'edrv.prevTab', label: '上一个页签' },
 ]
 
 const MODIFIERS: Record<string, 'ctrl' | 'shift' | 'alt' | 'meta'> = {

package/src/client/monaco/loader.ts

@@ -4,7 +4,7 @@
  * 迁移自原 src/client/index.ts 的 MONACO_BASE/LANG_BY_EXT/langOf/loadMonaco，语义不改。
  * 作者 ddj 2026-08-20
  */
-import { applyTheme, registerThemes } from './theme.js'
+import { applyOfficial, registerThemes } from './theme.js'
 
 export const MONACO_BASE = '/edrv/vendor/monaco/vs'
 let monacoPromise = null
@@ -102,10 +102,10 @@ export function loadMonaco(onProgress) {
           publishStage('core', MONACO_STAGES.core.progress, MONACO_STAGES.core.message)
           window.require(['vs/editor/editor.main'], () => {
             publishStage('ready', MONACO_STAGES.ready.progress, MONACO_STAGES.ready.message)
-            // 分色主题注册 + 应用（rich token 配色，替掉内置基础 vs 的少层次着色）
+            // 主题：注册现役双套（幂等）+ 应用跟随官方的令牌主题（令牌缺失时回落现役）
             try {
               registerThemes(window.monaco)
-              applyTheme(window.monaco)
+              applyOfficial(window.monaco)
             } catch (error) { /* 主题失败不阻塞编辑器 */ }
             resolve(window.monaco)
           }, (err) => fail(new Error('Monaco 模块加载失败：' + String(err))))

package/src/client/monaco/theme.ts

@@ -1,10 +1,10 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — Monaco 语法分色主题（rich token 配色）。
- * 编辑器原先硬编码 'vs'（内置基础主题），token 分色层次少；
- * 这里定义 edrv-dark / edrv-light 两套完整 token 配色（对齐 VSCode Dark+ 语义分层），
- * 并随 DSH 明暗主题自动切换（跟随文档根 data 主题属性 / prefers-color-scheme）。
- * 作者 ddj 2026-08-28
+ * dsh-vscode-mode client — Monaco 主题：官方令牌跟随 + 现役双套回落。
+ * 优先级：官方代码/UI 令牌（--shiki-* / --dsw-alias-*，DSH 0.1.5+ 主题体系，
+ * 含第三方皮肤）→ edrv-dark / edrv-light 两套内置配色（旧版 DSH 或令牌缺失）。
+ * 明暗判定：body[data-ds-dark-theme]（官方）→ 根 data-theme（旧皮肤）→ prefers-color-scheme。
+ * 作者 ddj 2026-08-28 / 2026-09-10
  */
 
 export const EDRV_DARK = 'edrv-dark'
@@ -185,12 +185,14 @@ export function registerThemes(monaco) {
 }
 
 /**
- * 探测当前 DSH 明暗（文档根 data 主题属性 → prefers-color-scheme → 暗）。
- * @author ddj 2026年08月28号
+ * 探测当前 DSH 明暗（官方 data-ds-dark-theme → 旧皮肤 data-theme → prefers-color-scheme → 暗）。
+ * @author ddj 2026年08月28号 / 2026年09月10号
  * @returns 'dark' | 'light'
  */
 export function detectColorScheme() {
   try {
+    const official = document.body?.getAttribute?.('data-ds-dark-theme')
+    if (official !== null && official !== undefined && official !== 'false') return 'dark'
     const attr = document.documentElement?.getAttribute?.('data-theme')
       ?? document.body?.getAttribute?.('data-theme')
     const value = String(attr ?? '').toLowerCase()
@@ -227,3 +229,307 @@ export function applyTheme(monaco) {
     /* setTheme 失败忽略 */
   }
 }
+
+// --region 官方主题跟随（--shiki-* / --dsw-alias-* 令牌）
+
+/** 动态官方主题 id 前缀（每次应用带序号重建，保证 Monaco 感知重定义）。 */
+const EDRV_OFFICIAL = 'edrv-official'
+
+/** 官方代码配色令牌 → Monaco 规则 token 前缀（粗粒度；未覆盖的规则保留现役语义分层）。 */
+const RULE_TOKEN_MAP = [
+  ['--shiki-token-comment', ['comment']],
+  ['--shiki-token-keyword', ['keyword']],
+  ['--shiki-token-string', ['string']],
+  ['--shiki-token-string-expression', ['string.escape']],
+  ['--shiki-token-constant', ['number', 'constant']],
+  ['--shiki-token-function', ['function', 'method', 'member']],
+  ['--shiki-token-parameter', ['parameter', 'variable.parameter']],
+  ['--shiki-token-punctuation', ['delimiter', 'operator', 'punctuation']],
+  ['--shiki-token-link', ['annotation', 'metatag']],
+]
+
+/**
+ * 官方 UI 令牌 → Monaco 颜色键（每键给候选令牌，按序取首个可解析值）。
+ * 依据运行态实测：--dsw-alias-* 定义在 body 上；--shiki-background/-foreground 未定义，
+ * 故代码面底色用 markdown-code-block 近似；selection 不覆盖（沿用现役可见选框）。
+ */
+const COLOR_TOKEN_MAP = [
+  [['--dsw-alias-markdown-code-block', '--dsw-alias-bg-layer-2'], ['editor.background', 'editorGutter.background', 'minimap.background']],
+  [['--dsw-alias-label-primary', '--shiki-foreground'], ['editor.foreground']],
+  [['--dsw-alias-bg-layer-1', '--dsw-alias-bg-layer-3'], ['editorWidget.background', 'editorHoverWidget.background']],
+  [['--dsw-alias-label-tertiary'], ['editorLineNumber.foreground']],
+  [['--dsw-alias-label-secondary'], ['editorLineNumber.activeForeground']],
+  [['--dsw-alias-interactive-bg-hover'], ['editor.lineHighlightBackground', 'editor.inactiveSelectionBackground']],
+]
+
+/** 已应用的官方主题序号（模块级计数，保证主题 id 每次唯一）。 */
+let officialSeq = 0
+
+/**
+ * 读官方 CSS 变量（先 body 后文档根；未定义/空值/未解析 var() 返回 undefined）。
+ * 依据运行态实测：DSH 的 --dsw-alias-* 定义在 body 上，仅 --shiki-token-* 在根。
+ * @author ddj 2026年09月10号
+ * @param name CSS 变量名（含 -- 前缀）
+ * @returns 计算样式值，或 undefined
+ */
+export function readCssVar(name) {
+  try {
+    if (typeof window?.getComputedStyle !== 'function') return undefined
+    const hosts = [document?.body, document?.documentElement]
+    for (const host of hosts) {
+      if (!host) continue
+      const raw = window.getComputedStyle(host).getPropertyValue(name)
+      const value = String(raw ?? '').trim()
+      if (value && !value.startsWith('var(')) return value
+    }
+    return undefined
+  } catch (error) {
+    return undefined
+  }
+}
+
+/**
+ * 数值 → 两位十六进制（0-255 夹取）。
+ * @author ddj 2026年09月10号
+ * @param value 通道值
+ * @returns 两位小写十六进制
+ */
+function hex2(value) {
+  const text = Math.max(0, Math.min(255, Math.round(Number(value) || 0))).toString(16)
+  return text.length === 1 ? '0' + text : text
+}
+
+/**
+ * CSS 颜色归一为 Monaco 可用值（#rgb/#rrggbb/#rrggbbaa 原样，rgb()/hsl() 转 hex，其余 undefined）。
+ * @author ddj 2026年09月10号
+ * @param value CSS 计算样式颜色值
+ * @returns Monaco 颜色字符串，或 undefined（不可识别）
+ */
+export function toMonacoColor(value) {
+  const text = String(value ?? '').trim().toLowerCase()
+  if (!text || text.startsWith('var(')) return undefined
+  if (/^#[0-9a-f]{3}$/.test(text)) return '#' + text.slice(1).split('').map((c) => c + c).join('')
+  if (/^#[0-9a-f]{6}$/.test(text) || /^#[0-9a-f]{8}$/.test(text)) return text
+  return channelColor(text)
+}
+
+/**
+ * rgb()/rgba()/hsl()/hsla() → Monaco 颜色（兼容逗号与空格/斜杠两种参数语法）。
+ * @author ddj 2026年09月10号
+ * @param text 小写颜色文本
+ * @returns Monaco 颜色，或 undefined（不可识别）
+ */
+function channelColor(text) {
+  const body = /^(?:rgba?|hsla?)\(([^)]+)\)$/.exec(text)?.[1]
+  if (!body) return undefined
+  const parts = body.split(/[\s,/]+/).filter(Boolean)
+  if (parts.length < 3) return undefined
+  let channels
+  if (text.startsWith('hsl')) {
+    const h = Number(parts[0])
+    const s = percentOf(parts[1])
+    const l = percentOf(parts[2])
+    if (![h, s, l].every(Number.isFinite)) return undefined
+    channels = hslToRgb(h, s, l)
+  } else {
+    channels = parts.slice(0, 3).map(Number)
+  }
+  if (channels.some((n) => !Number.isFinite(n))) return undefined
+  const alpha = parts.length > 3 ? alphaOf(parts[3]) : 1
+  const tail = Number.isFinite(alpha) && alpha < 1 ? hex2(alpha * 255) : ''
+  return '#' + channels.map(hex2).join('') + tail
+}
+
+/**
+ * 百分数文本 → 数值（'5%' → 5，'0.5' → 0.5）。
+ * @author ddj 2026年09月10号
+ * @param value 参数文本
+ * @returns 数值（非数字为 NaN）
+ */
+function percentOf(value) {
+  const text = String(value ?? '')
+  return text.endsWith('%') ? Number(text.slice(0, -1)) : Number(text)
+}
+
+/**
+ * alpha 参数归一（'5%' → 0.05，'0.5' → 0.5）。
+ * @author ddj 2026年09月10号
+ * @param value 参数文本
+ * @returns 0-1 的 alpha（非数字为 NaN）
+ */
+function alphaOf(value) {
+  const text = String(value ?? '')
+  return text.endsWith('%') ? Number(text.slice(0, -1)) / 100 : Number(text)
+}
+
+/**
+ * HSL → RGB 通道（h 度、s/l 为 0-100 百分数）。
+ * @author ddj 2026年09月10号
+ * @param h 色相（度）
+ * @param s 饱和度（0-100）
+ * @param l 亮度（0-100）
+ * @returns [r, g, b]（0-255）
+ */
+function hslToRgb(h, s, l) {
+  const hue = ((h % 360) + 360) % 360
+  const sat = Math.max(0, Math.min(100, s)) / 100
+  const lum = Math.max(0, Math.min(100, l)) / 100
+  const c = (1 - Math.abs(2 * lum - 1)) * sat
+  const x = c * (1 - Math.abs(((hue / 60) % 2) - 1))
+  const m = lum - c / 2
+  const table = [[c, x, 0], [x, c, 0], [0, c, x], [0, x, c], [x, 0, c], [c, 0, x]]
+  return table[Math.min(5, Math.floor(hue / 60))].map((v) => (v + m) * 255)
+}
+
+/**
+ * 官方令牌 → Monaco 颜色键覆盖表（候选令牌按序取首个可解析值；全缺则不写入，保持现役回落）。
+ * @author ddj 2026年09月10号
+ * @returns 颜色键 → 颜色值
+ */
+function tokenColors() {
+  const out = {}
+  for (const entry of COLOR_TOKEN_MAP) {
+    const color = firstColor(entry[0])
+    if (color === undefined) continue
+    for (const key of entry[1]) out[key] = color
+  }
+  return out
+}
+
+/**
+ * 候选令牌中首个可解析为 Monaco 颜色的值。
+ * @author ddj 2026年09月10号
+ * @param names CSS 变量名候选（按优先级）
+ * @returns Monaco 颜色，或 undefined（全部缺失/不可解析）
+ */
+function firstColor(names) {
+  for (const name of names) {
+    const color = toMonacoColor(readCssVar(name))
+    if (color !== undefined) return color
+  }
+  return undefined
+}
+
+/**
+ * 官方令牌 → Monaco 规则前缀覆盖表（值去掉 # 前缀，Monaco rules 约定）。
+ * @author ddj 2026年09月10号
+ * @returns token 前缀 → 十六进制色（无 #）
+ */
+function tokenRules() {
+  const out = {}
+  for (const entry of RULE_TOKEN_MAP) {
+    const color = toMonacoColor(readCssVar(entry[0]))
+    if (color === undefined) continue
+    for (const prefix of entry[1]) out[prefix] = color.replace('#', '')
+  }
+  return out
+}
+
+/**
+ * 现役规则叠加令牌覆盖（前缀命中即换色，未命中保持语义分层）。
+ * @author ddj 2026年09月10号
+ * @param baseRules 现役规则表（edrv-dark / edrv-light）
+ * @param overrides token 前缀 → 颜色
+ * @returns 覆盖后的规则表（无覆盖时原样返回）
+ */
+function withOverrides(baseRules, overrides) {
+  const prefixes = Object.keys(overrides)
+  if (!prefixes.length) return baseRules
+  return baseRules.map((rule) => {
+    const hit = prefixes.find((p) => rule.token === p || rule.token.startsWith(p + '.'))
+    return hit === undefined ? rule : Object.assign({}, rule, { foreground: overrides[hit] })
+  })
+}
+
+/**
+ * 基础规则（token 为空串）前景色跟随官方 editor.foreground。
+ * Monaco 的 '' 规则匹配所有未被更具体规则命中的 token，不改它则内置 #1e1e1e 会盖住
+ * editor.foreground 令牌色（实测 .mtk1 仍为内置值的原因）。
+ * @author ddj 2026年09月10号
+ * @param rules 现役规则表
+ * @param color 已解析的 editor.foreground（含 #，缺省则不覆盖）
+ * @returns 基础规则换色后的规则表
+ */
+export function withBaseForeground(rules, color) {
+  if (!color) return rules
+  const foreground = String(color).replace('#', '')
+  return rules.map((rule) => (rule.token === '' ? Object.assign({}, rule, { foreground }) : rule))
+}
+
+/**
+ * 构建跟随官方的 Monaco 主题（令牌全缺时 hasTokens=false，调用方回落现役双套）。
+ * @author ddj 2026年09月10号
+ * @param scheme 明暗（'light' 之外一律按暗色）
+ * @returns 主题定义（base/rules/colors/hasTokens）
+ */
+export function officialThemeOf(scheme) {
+  const dark = scheme !== 'light'
+  const colors = tokenColors()
+  const rules = tokenRules()
+  const layered = withOverrides(dark ? DARK_RULES : LIGHT_RULES, rules)
+  return {
+    base: dark ? 'vs-dark' : 'vs',
+    rules: withBaseForeground(layered, colors['editor.foreground']),
+    colors: Object.assign({}, dark ? DARK_COLORS : LIGHT_COLORS, colors),
+    hasTokens: Object.keys(colors).length > 0 || Object.keys(rules).length > 0,
+  }
+}
+
+/**
+ * 应用跟随官方的主题；令牌读不到或定义失败时回落现役双套。
+ * @author ddj 2026年09月10号
+ * @param monaco Monaco 实例
+ * @returns 实际应用的 Monaco 主题 id
+ */
+export function applyOfficial(monaco) {
+  if (!monaco?.editor?.setTheme || !monaco?.editor?.defineTheme) return themeNameOf()
+  const theme = officialThemeOf(detectColorScheme())
+  if (!theme.hasTokens) {
+    applyTheme(monaco)
+    return themeNameOf()
+  }
+  officialSeq += 1
+  const id = EDRV_OFFICIAL + '-' + officialSeq
+  try {
+    monaco.editor.defineTheme(id, { base: theme.base, inherit: true, rules: theme.rules, colors: theme.colors })
+    monaco.editor.setTheme(id)
+    return id
+  } catch (error) {
+    applyTheme(monaco)
+    return themeNameOf()
+  }
+}
+
+/**
+ * 观察官方明暗标记变化（body / 根节点的 data-ds-dark-theme 与 data-theme）。
+ * @author ddj 2026年09月10号
+ * @param onChange 标记变化回调
+ * @returns 停止观察函数（非浏览器环境返回空函数）
+ */
+export function observeScheme(onChange) {
+  try {
+    if (typeof MutationObserver !== 'function' || !document?.body) return () => {}
+    const observer = new MutationObserver(() => onChange())
+    const filter = ['data-ds-dark-theme', 'data-theme']
+    observer.observe(document.body, { attributes: true, attributeFilter: filter })
+    if (document.documentElement) {
+      observer.observe(document.documentElement, { attributes: true, attributeFilter: filter })
+    }
+    return () => observer.disconnect()
+  } catch (error) {
+    return () => {}
+  }
+}
+
+/**
+ * 官方主题快照 → 明暗（ThemeRuntime.getTheme() 快照；字段缺失/未知返回 undefined）。
+ * @author ddj 2026年09月10号
+ * @param snapshot 官方主题快照
+ * @returns 'light' | 'dark' | undefined
+ */
+export function schemeOfSnapshot(snapshot) {
+  const value = snapshot ?? {}
+  const scheme = value.active?.colorScheme ?? value.colorScheme
+  return scheme === 'light' || scheme === 'dark' ? scheme : undefined
+}
+// --endregion

package/src/client/officialSidebar.ts

@@ -37,6 +37,8 @@ export const OFFICIAL_FILE_KIND = 'edrvEditorFile'
 export interface OfficialTabParams {
   openPath?: string
   focusDiff?: boolean
+  /** 目标行号（行引用/工具行跳转透传；缺省仅打开文件）。 */
+  line?: number
 }
 
 /** sidebarRightTabs 服务的最小结构面（结构性探测，不 import 官方类型）。 */
@@ -97,6 +99,19 @@ export function resolveNavOpen(params: unknown): { path: string | null; focusDif
   return { path, focusDiff: value?.focusDiff === true }
 }
 
+/**
+ * 从官方导航参数安全解析行号（缺字段/坏类型/非正数一律视为未指定）。
+ * @author ddj 2026年09月10号
+ * @param params openTab/openResource 传入的 params（正文经 navigation.params 读回）
+ * @returns 正整数行号，或 undefined
+ */
+export function resolveNavLine(params: unknown): number | undefined {
+  const value = (params ?? {}) as OfficialTabParams
+  const line = value?.line
+  if (typeof line !== 'number' || !Number.isFinite(line) || line <= 0) return undefined
+  return Math.floor(line)
+}
+
 /** 逐段 component 解码（失败返回 null，对齐官方 parseFileAddress 的容错语义）。 */
 function decodeSegment(raw: string | undefined): string | null {
   if (raw === undefined) return null
@@ -179,6 +194,36 @@ export function buildFileAddress(path: string, sessionId?: string): string {
   return OFFICIAL_FILE_PREFIX + 'session/' + encodeSegment(sessionId) + '/' + relative.split('/').map(encodeSegment).join('/')
 }
 
+// --region file 认领转发（文件分页收归编辑器自带页签栏）
+
+/**
+ * 把 file 打开请求转发进单一编辑器页签（文件分页由编辑器自带页签栏接管，
+ * 官方侧栏不再按文件分裂出多套编辑器实例）。
+ * @author ddj 2026年09月10号
+ * @param service 官方 sidebarRight 服务（缺失/缺 openTab 返回 false）
+ * @param path 目标文件路径（空值返回 false）
+ * @param line 可选行号（透传给编辑器页签导航参数）
+ * @returns 转发是否成功（openTab 抛错返回 false，由调用方决定重试或兜底）
+ */
+export function forwardToEditor(
+  service: SidebarRightServiceLike | undefined | null,
+  path: string | null,
+  line?: number,
+): boolean {
+  if (!service || typeof service.openTab !== 'function' || !path) return false
+  const params: OfficialTabParams = { openPath: path }
+  if (line !== undefined) params.line = line
+  try {
+    // 官方语义：页类型恒去重，故转发只会聚焦既有编辑器页签，不产生新实例
+    service.openTab(OFFICIAL_TAB_KIND, { params })
+    return true
+  } catch (error) {
+    log.warn('file 认领转发进编辑器页签失败（' + String(error) + '）')
+    return false
+  }
+}
+// --endregion
+
 /**
  * 注册官方 Tab 正文（keyed slot，key=定义 id；slots.inject 等待 rightbar seat 声明）。
  * @author ddj 2026年09月09号

package/src/client/outline/index.ts

@@ -5,19 +5,20 @@
  * 作者 ddj 2026-08-27
  */
 import React from 'react'
+import { IconCodeOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'
 import { OutlinePanel } from './OutlinePanel.js'
 import type { SidebarPanelDef, SidebarCtx } from '../sidebar/types.js'
 
 /**
  * 构造大纲面板定义。
- * @author ddj 2026年08月27号
- * @returns 面板定义（无徽标；活动栏图标 📜）
+ * @author ddj 2026年08月27号 / 2026年09月10号
+ * @returns 面板定义（无徽标；活动栏图标 = 官方 IconCodeOutline16）
  */
 export function createOutlinePanel(): SidebarPanelDef {
   return {
     id: 'outline',
     title: '大纲',
-    icon: '📜',
+    icon: IconCodeOutline16,
     order: 20,
     render: (ctx: SidebarCtx) => React.createElement(OutlinePanel, { ctx }),
   }

package/src/client/sidebar/SidebarView.ts

@@ -18,6 +18,21 @@ const SEAM_W = 5
 /** 隐藏态拖出面板区的触发阈值（px，拖过即展开并继续实时调宽）。 */
 const PULL_OUT_THRESHOLD = 12
 
+/**
+ * 活动栏图标内容：面板可给官方图标组件（跟随官方主题），也可给文本/emoji（回落）。
+ * @author ddj 2026年09月10号
+ * @param icon 面板定义的 icon 字段（组件或文本）
+ * @returns 图标元素或文本；组件渲染异常返回 null
+ */
+function railIconEl(icon) {
+  if (typeof icon !== 'function') return icon
+  try {
+    return React.createElement(icon, { size: 16 })
+  } catch (error) {
+    return null
+  }
+}
+
 /**
  * 侧边栏容器。
  * @param props.registry 面板注册表（list() 提供面板顺序）
@@ -112,7 +127,7 @@ export function SidebarView(props) {
             if (!visible && typeof onShow === 'function') onShow()
           },
         },
-          React.createElement('span', { className: 'edrv-rail-icon' }, p.icon),
+          React.createElement('span', { className: 'edrv-rail-icon' }, railIconEl(p.icon)),
           count > 0
             ? React.createElement('span', { className: 'edrv-rail-badge' }, String(count))
             : null)

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

@@ -5,10 +5,11 @@
  * host 树索引，命中近乎零成本）；挂载/切会话从缓存即时恢复展开树；⟳/edrv:refresh
  * 保留旧条目强制后台重列（force）；每次用户发起加载后预取 ≤4 个子目录（排除重型
  * 目录、缓存新鲜跳过、不级联）；10s 轻量跟随已展开目录（命中索引，RPC 近零成本）。
- * 差异角标/右键菜单/展开状态持久化行为不变。
- * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31
+ * 差异角标/右键菜单/展开状态持久化行为不变；行图标用官方原语（文件夹图标 + 文件类型图标）。
+ * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10
  */
 import React from 'react'
+import { FileTypeIcon, IconFolderClose16, IconFolderOpen16, IconRefreshOutline16, classifyFileType } from '@deepseek-ai/dsh-client-ui-primitives'
 import { rpc } from '../../rpc.js'
 import { ContextMenu } from '../../ui/ContextMenu.js'
 import { buildTreeMenu } from '../contextMenu.js'
@@ -23,6 +24,58 @@ const FOLLOW_INTERVAL_MS = 10_000
 const PREFETCH_MAX = 4
 const PREFETCH_EXCLUDED = new Set(['node_modules', '.git', '.hg', '.svn', '.pnpm', '.pnpm-store'])
 
+// --region 行图标（官方原语：目录文件夹图标 + 文件类型图标；缺失时回落纯文本）
+
+/**
+ * 目录图标元素（官方 IconFolderOpen16/Close16）。
+ * @author ddj 2026年09月10号
+ * @param isOpen 目录是否展开
+ * @returns 图标元素；原语缺失返回 null
+ */
+function dirIconEl(isOpen) {
+  const Icon = isOpen ? IconFolderOpen16 : IconFolderClose16
+  if (typeof Icon !== 'function') return null
+  return React.createElement(Icon, { size: 16, className: 'edrv-tree-icon' })
+}
+
+/**
+ * 文件图标元素（官方 FileTypeIcon + classifyFileType 分类，未知类型为 other）。
+ * @author ddj 2026年09月10号
+ * @param name 文件名（含扩展名）
+ * @returns 图标元素；原语缺失或分类异常返回 null
+ */
+function fileIconEl(name) {
+  if (typeof FileTypeIcon !== 'function' || typeof classifyFileType !== 'function') return null
+  try {
+    return React.createElement(FileTypeIcon, { kind: classifyFileType(String(name ?? '')), size: 16, className: 'edrv-tree-icon' })
+  } catch (error) {
+    return null
+  }
+}
+
+/**
+ * 行图标分派：目录 → 文件夹图标，文件 → 官方类型图标。
+ * @author ddj 2026年09月10号
+ * @param e 目录条目（name/type）
+ * @param isDir 是否目录
+ * @param isOpen 目录是否展开
+ * @returns 图标元素或 null
+ */
+function rowIconEl(e, isDir, isOpen) {
+  return isDir ? dirIconEl(isOpen) : fileIconEl(e?.name)
+}
+
+/**
+ * 刷新按钮图标（官方 IconRefreshOutline16；原语缺失回落文本 ⟳）。
+ * @author ddj 2026年09月10号
+ * @returns 图标元素或回落文本
+ */
+function refreshIconEl() {
+  if (typeof IconRefreshOutline16 !== 'function') return '⟳'
+  return React.createElement(IconRefreshOutline16, { size: 14 })
+}
+// --endregion
+
 /**
  * 目录树面板主体（SWR：有缓存先渲染，无缓存才显示加载态；加载总在后台）。
  * @param props.ctx 面板共享上下文（sessionId/openFile/activePath/pendingByPath/fileMenuItems/notify）
@@ -227,8 +280,9 @@ export function FileExplorer(props) {
     },
       React.createElement('span', { className: 'edrv-tree-chev' },
         isDir ? (isOpen ? '▾' : '▸') : ''),
+      rowIconEl(e, isDir, isOpen),
       React.createElement('span', { className: 'edrv-tree-name' + (dim ? ' edrv-tree-dim' : '') },
-        isDir ? (isOpen ? '📂' : '📁') : '📄', ' ', e.name),
+        e.name),
       (pending > 0
         ? React.createElement('span', { className: 'edrv-tree-badge' }, String(pending))
         : null))
@@ -283,7 +337,7 @@ export function FileExplorer(props) {
       React.createElement('span', { className: 'edrv-side-title' }, '资源管理器'),
       React.createElement('span', { className: 'edrv-side-root', title: root || '' }, rootName),
       React.createElement('span', { style: { flex: 1 } }),
-      React.createElement('button', { className: 'edrv-side-btn', title: '刷新目录树', onClick: refresh }, '⟳')),
+      React.createElement('button', { className: 'edrv-side-btn', title: '刷新目录树', onClick: refresh }, refreshIconEl())),
     React.createElement('div', { className: 'edrv-tree' },
       (errorText
         ? React.createElement('div', { className: 'edrv-tree-error' },