dsh-vscode-mode 0.1.62 → 0.1.63

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

@@ -1,9 +1,11 @@
 // @ts-nocheck
 /**
  * dsh-vscode-mode client — 侧边栏面板定义（文件管理 + 搜索 + 规则）。
- * 作者 ddj 2026-08-26 / 2026-09-03
+ * 活动栏图标用官方 UI 原语（跟随 DSH 主题与皮肤）；原语缺失时由 SidebarView 回落文本渲染。
+ * 作者 ddj 2026-08-26 / 2026-09-03 / 2026-09-10
  */
 import React from 'react'
+import { IconFolderOpenOutline16, IconListPenOutline16, IconSearchOutline16 } from '@deepseek-ai/dsh-client-ui-primitives'
 import { FileExplorer } from './FileExplorer.js'
 import { SearchPanel } from './SearchPanel.js'
 import { RulesPanel } from './RulesPanel.js'
@@ -11,14 +13,14 @@ import type { SidebarPanelDef, SidebarCtx } from '../types.js'
 
 /**
  * 构造文件管理面板定义。
- * @author ddj 2026年08月26号
- * @returns 面板定义（含活动栏徽标 = 差异文件总数）
+ * @author ddj 2026年08月26号 / 2026年09月10号
+ * @returns 面板定义（含活动栏徽标 = 差异文件总数；图标 = 官方 IconFolderOpenOutline16）
  */
 export function createFilePanel(): SidebarPanelDef {
   return {
     id: 'explorer',
     title: '文件管理',
-    icon: '📁',
+    icon: IconFolderOpenOutline16,
     order: 10,
     badge: (ctx: SidebarCtx) => (ctx.sum && ctx.sum.totalFiles > 0 ? ctx.sum.totalFiles : null),
     render: (ctx: SidebarCtx) => React.createElement(FileExplorer, { ctx }),
@@ -27,14 +29,14 @@ export function createFilePanel(): SidebarPanelDef {
 
 /**
  * 构造搜索面板定义。
- * @author ddj 2026年08月30号
- * @returns 面板定义（无徽标；活动栏图标 🔍）
+ * @author ddj 2026年08月30号 / 2026年09月10号
+ * @returns 面板定义（无徽标；图标 = 官方 IconSearchOutline16）
  */
 export function createSearchPanel(): SidebarPanelDef {
   return {
     id: 'search',
     title: '搜索',
-    icon: '🔍',
+    icon: IconSearchOutline16,
     order: 15,
     render: (ctx: SidebarCtx) => React.createElement(SearchPanel, { ctx }),
   }
@@ -42,14 +44,14 @@ export function createSearchPanel(): SidebarPanelDef {
 
 /**
  * 构造规则管理面板定义（Codebuddy 规则形态：用户规则/项目规则双 Tab + 开关）。
- * @author ddj 2026年09月03号
- * @returns 面板定义（无徽标；活动栏图标 📏，与大纲 📜 区分）
+ * @author ddj 2026年09月03号 / 2026年09月10号
+ * @returns 面板定义（无徽标；图标 = 官方 IconListPenOutline16）
  */
 export function createRulesPanel(): SidebarPanelDef {
   return {
     id: 'rules',
     title: '规则',
-    icon: '📏',
+    icon: IconListPenOutline16,
     order: 20,
     render: (ctx: SidebarCtx) => React.createElement(RulesPanel, { ctx }),
   }

package/src/client/sidebar/types.ts

@@ -40,8 +40,8 @@ export interface SidebarCtx {
 export interface SidebarPanelDef {
   id: string
   title: string
-  /** 活动栏图标（文本/SVG 均可，横向居中显示）。 */
-  icon: string
+  /** 活动栏图标：官方图标组件（跟随官方主题）或文本/emoji（回落），横向居中显示。 */
+  icon: string | ((props: { size?: number }) => unknown)
   order?: number
   /** 活动栏徽标：返回数字/null；缺省不显示。 */
   badge?: (ctx: SidebarCtx) => number | null

package/src/client/styles/editor.css

@@ -1,7 +1,9 @@
 /* dsh-vscode-mode 编辑区样式（原 ensureEdrvStyles 字符串，落盘为真 .css，由 tsdown CSS-inline 注入） */
-/* 浅色主题（对齐参考图：#f8f8f8 近白底 + 薄荷绿药丸 + 青绿文字 + 三文鱼 undo + 浅灰边框）：
-   在 [data-edrv-view] 作用域内重定义 --dsw-alias-*，级联命中组件内联样式与 CSS。 */
-[data-edrv-view] { box-sizing: border-box; --edrv-tab-h: 34px; --dsw-alias-bg-base: #f8f8f8; --dsw-alias-bg-layer-1: #ffffff; --dsw-alias-bg-layer-2: #f0f4f4; --dsw-alias-bg-overlay: #ffffff; --dsw-alias-label-primary: #1f2933; --dsw-alias-label-secondary: #52606d; --dsw-alias-label-tertiary: #9aa5b1; --dsw-alias-border-l1: #e0e6e8; --dsw-alias-border-l2: #cbd2d9; --dsw-alias-brand-primary: #0f9d58; --dsw-alias-state-success-primary: #0f9d58; --dsw-alias-state-error-primary: #d9534f; --dsw-alias-state-warn-primary: #d97706; --dsw-alias-interactive-bg-hover: rgba(15,157,88,.08); }
+/* 主题：跟随官方 --dsw-alias-* 令牌（DSH 明暗与第三方皮肤生效）。
+   本作用域不再重定义官方令牌（旧实现曾在此硬覆盖浅色盘，导致插件不跟随 DSH 主题）；
+   旧环境/缺令牌场景由每条声明的 var(--dsw-alias-*, 回落值) 兜底。
+   @author ddj 2026-09-10 */
+[data-edrv-view] { box-sizing: border-box; --edrv-tab-h: 34px; }
 
 [data-edrv-view] .edrv-tabs { display: flex; align-items: center; gap: 2px; padding: 2px 8px 0; background: var(--dsw-alias-bg-layer-1, transparent); overflow-x: auto; scrollbar-width: thin; flex-shrink: 0; }
 [data-edrv-view] .edrv-tab { display: inline-flex; align-items: center; gap: 6px; height: 28px; padding: 0 8px 0 12px; border: none; border-radius: 6px 6px 0 0; background: transparent; color: var(--dsw-alias-label-secondary, #aaa); font-size: 12px; cursor: pointer; white-space: nowrap; flex-shrink: 0; }
@@ -9,7 +11,7 @@
 [data-edrv-view] .edrv-tab.edrv-tab-active { background: var(--dsw-alias-bg-base, #111); color: var(--dsw-alias-label-primary, #eee); box-shadow: inset 0 -2px 0 var(--dsw-alias-brand-primary, #4f8cff); }
 [data-edrv-view] .edrv-tab .edrv-tab-star { color: var(--dsw-alias-brand-primary, #4f8cff); font-size: 13px; font-weight: 700; line-height: 1; flex-shrink: 0; } /* 未保存修改星号 @author ddj 2026年09月09号 */
 [data-edrv-view] .edrv-tab .edrv-tab-x { display: inline-flex; align-items: center; justify-content: center; width: 16px; height: 16px; border-radius: 4px; color: var(--dsw-alias-label-tertiary, #888); font-size: 11px; }
-[data-edrv-view] .edrv-tab .edrv-tab-x:hover { background: rgba(255,255,255,.12); color: var(--dsw-alias-label-primary, #eee); }
+[data-edrv-view] .edrv-tab .edrv-tab-x:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.12)); color: var(--dsw-alias-label-primary, #eee); }
 [data-edrv-view] .edrv-tab-add { display: inline-flex; align-items: center; justify-content: center; width: 24px; height: 24px; margin-left: 2px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-secondary, #aaa); font-size: 14px; cursor: pointer; flex-shrink: 0; }
 [data-edrv-view] .edrv-tab-add:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.06)); }
 [data-edrv-view] .edrv-pathbar { display: flex; align-items: center; gap: 8px; height: 26px; padding: 0 10px; background: var(--dsw-alias-bg-layer-1, #ffffff); border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); font-size: 12px; flex-shrink: 0; overflow: hidden; }
@@ -27,7 +29,7 @@
 [data-edrv-view] .edrv-search-item .n { color: var(--dsw-alias-label-primary, #eee); font-size: 12px; word-break: break-all; }
 [data-edrv-view] .edrv-search-item .d { color: var(--dsw-alias-label-tertiary, #888); font-size: 11px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 [data-edrv-view] .edrv-search-empty { padding: 8px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #888); }
-[data-edrv-view] .edrv-btn-mini { font-size: 11px; padding: 2px 9px; border: none; border-radius: 999px; cursor: pointer; color: #fff; font-weight: 600; white-space: nowrap; }
+[data-edrv-view] .edrv-btn-mini { font-size: 11px; padding: 2px 9px; border: none; border-radius: 999px; cursor: pointer; color: var(--dsw-alias-label-primary-inverted, #fff); font-weight: 600; white-space: nowrap; }
 [data-edrv-view] .edrv-btn-keep { background: var(--dsw-alias-state-success-primary, #2e9e44); }
 [data-edrv-view] .edrv-btn-undo { background: var(--dsw-alias-state-warn-primary, #d97706); }
 [data-edrv-view] .edrv-btn-mini:disabled { opacity: .45; cursor: default; }
@@ -47,15 +49,15 @@
 [data-edrv-view] .edrv-chip-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.06)); }
 [data-edrv-view] .edrv-chip-btn:disabled { opacity: .35; cursor: default; }
 [data-edrv-view] .edrv-chip-btn:disabled:hover { background: transparent; }
-[data-edrv-view] .edrv-mn-add-line { background: rgba(15,157,88,.10); }
-[data-edrv-view] .edrv-mn-gutter-add { color: #0f9d58 !important; font-weight: 700; display: flex !important; align-items: center; justify-content: center; }
+[data-edrv-view] .edrv-mn-add-line { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.10)); }
+[data-edrv-view] .edrv-mn-gutter-add { color: var(--dsw-alias-state-success-primary, #0f9d58) !important; font-weight: 700; display: flex !important; align-items: center; justify-content: center; }
 [data-edrv-view] .edrv-mn-gutter-add::before { content: "+"; }
-[data-edrv-view] .edrv-del-zone { background: #fdeaea; border-top: 1px solid rgba(217,83,79,.35); border-bottom: 1px solid rgba(217,83,79,.35); box-shadow: inset 0 0 0 1px rgba(217,83,79,.12); }
-[data-edrv-view] .edrv-del-row { white-space: pre; font-family: var(--ds-font-family-code, ui-monospace, monospace); font-size: 12.5px; line-height: 20px; color: #c0392b; }
+[data-edrv-view] .edrv-del-zone { background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.14)); border-top: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.35)); border-bottom: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.35)); box-shadow: inset 0 0 0 1px var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.12)); }
+[data-edrv-view] .edrv-del-row { white-space: pre; font-family: var(--ds-font-family-code, ui-monospace, monospace); font-size: 12.5px; line-height: 20px; color: var(--dsw-alias-state-error-primary, #c0392b); }
 [data-edrv-view] .edrv-del-text { display: inline-block; white-space: pre; }
 [data-edrv-view] .edrv-minus-overlay { position: absolute; left: 0; top: 0; width: 100%; height: 100%; max-width: 100%; overflow: visible; pointer-events: none; z-index: 6; }
 [data-edrv-view] .edrv-minus-item { position: absolute; box-sizing: border-box; max-width: 100%; overflow: hidden; }
-[data-edrv-view] .edrv-minus-item::before { content: ''; position: absolute; left: 4px; top: 50%; width: 8px; height: 2px; transform: translateY(-50%); border-radius: 2px; background: #d9534f; }
+[data-edrv-view] .edrv-minus-item::before { content: ''; position: absolute; left: 4px; top: 50%; width: 8px; height: 2px; transform: translateY(-50%); border-radius: 2px; background: var(--dsw-alias-state-error-primary, #d9534f); }
 [data-edrv-view] .edrv-monaco-host { flex: 1 1 auto; min-width: 0; min-height: 0; position: relative; overflow: hidden; }
 [data-edrv-view] .edrv-monaco-host > div { position: absolute; inset: 0; min-width: 0; min-height: 0; }
 [data-edrv-view] .edrv-imgview { flex: 1 1 auto; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
@@ -83,9 +85,9 @@
 [data-edrv-view] .edrv-diffbar-count.edrv-count-file { min-width: 64px; cursor: default; }
 [data-edrv-view] .edrv-diffbar-file { flex: 1; min-width: 0; font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 [data-edrv-view] .edrv-pill { font-size: 11px; padding: 3px 10px; border: none; border-radius: 999px; cursor: pointer; white-space: nowrap; font-weight: 600; }
-[data-edrv-view] .edrv-pill-keep { background: #e8f8e8; color: #0f7a45; border: 1px solid rgba(15,157,88,.4); }
-[data-edrv-view] .edrv-pill-undo { background: #fdeaea; color: #c0392b; border: 1px solid rgba(217,83,79,.4); }
-[data-edrv-view] .edrv-pill-ghost { background: #ffffff; color: var(--dsw-alias-label-secondary, #52606d); border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
+[data-edrv-view] .edrv-pill-keep { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.14)); color: var(--dsw-alias-state-success-primary, #0f7a45); border: 1px solid var(--dsw-alias-state-success-primary, rgba(15,157,88,.4)); }
+[data-edrv-view] .edrv-pill-undo { background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.14)); color: var(--dsw-alias-state-error-primary, #c0392b); border: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.4)); }
+[data-edrv-view] .edrv-pill-ghost { background: var(--dsw-alias-bg-layer-1, #ffffff); color: var(--dsw-alias-label-secondary, #52606d); border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); }
 [data-edrv-view] .edrv-pill:disabled { opacity: .45; cursor: default; }
 [data-edrv-view] .edrv-diffbar-menu { position: absolute; right: 8px; bottom: calc(100% + 6px); z-index: 45; min-width: 160px; border-radius: 10px; background: var(--dsw-alias-bg-overlay, #ffffff); border: 1px solid var(--dsw-alias-border-l2, #cbd2d9); box-shadow: 0 6px 20px rgba(31,41,51,.16); padding: 4px; display: flex; flex-direction: column; gap: 2px; }
 [data-edrv-view] .edrv-diffmenu-item { display: flex; align-items: center; gap: 8px; font-size: 12px; padding: 6px 10px; border: none; border-radius: 6px; background: transparent; color: var(--dsw-alias-label-primary, #1f2933); cursor: pointer; text-align: left; }
@@ -107,7 +109,7 @@
 [data-edrv-view] .edrv-diffrow-o { font-size: 11px; color: var(--dsw-alias-state-error-primary, #d9534f); font-family: var(--ds-font-family-code, ui-monospace, monospace); }
 [data-edrv-view] .edrv-diffrow-n { font-size: 11px; color: var(--dsw-alias-state-success-primary, #0f9d58); font-family: var(--ds-font-family-code, ui-monospace, monospace); }
 [data-edrv-view] .edrv-diffrow-tag { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
-[data-edrv-view] .edrv-diffrow-stale { border-color: rgba(217,119,6,.5); cursor: default; }
+[data-edrv-view] .edrv-diffrow-stale { border-color: var(--dsw-alias-state-warn-primary, rgba(217,119,6,.5)); cursor: default; }
 [data-edrv-view] .edrv-diffbox-others { display: flex; align-items: center; gap: 6px; flex-wrap: wrap; padding: 4px 2px 0; border-top: 1px solid var(--dsw-alias-border-l1, #e0e6e8); margin-top: 2px; }
 [data-edrv-view] .edrv-diffrow-file { font-size: 11px; padding: 2px 10px; border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); border-radius: 999px; background: var(--dsw-alias-bg-layer-2, #f0f4f4); color: var(--dsw-alias-label-secondary, #52606d); cursor: pointer; white-space: nowrap; max-width: 200px; overflow: hidden; text-overflow: ellipsis; }
 [data-edrv-view] .edrv-diffrow-file:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); color: var(--dsw-alias-label-primary, #1f2933); }
@@ -228,8 +230,11 @@
 [data-edrv-view] .edrv-rail-btn { position: relative; display: inline-flex; align-items: center; justify-content: center; width: 32px; height: 32px; border: none; border-radius: 8px; background: transparent; color: var(--dsw-alias-label-secondary, #52606d); cursor: pointer; flex-shrink: 0; }
 [data-edrv-view] .edrv-rail-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-rail-btn.edrv-rail-on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); color: var(--dsw-alias-label-primary, #1f2933); box-shadow: inset 2px 0 0 var(--dsw-alias-brand-primary, #0f9d58); }
-[data-edrv-view] .edrv-rail-icon { font-size: 15px; line-height: 1; }
-[data-edrv-view] .edrv-rail-badge { position: absolute; top: 2px; right: 2px; min-width: 14px; height: 14px; padding: 0 3px; border-radius: 999px; background: var(--dsw-alias-brand-primary, #0f9d58); color: #fff; font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; }
+[data-edrv-view] .edrv-rail-icon { font-size: 15px; line-height: 1; display: inline-flex; align-items: center; justify-content: center; }
+/* 树行图标：官方原语（文件夹/文件类型），尺寸与行高对齐 @author ddj 2026-09-10 */
+[data-edrv-view] .edrv-tree-icon { flex-shrink: 0; display: inline-flex; align-items: center; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
+[data-edrv-view] .edrv-tree-row.edrv-tree-active .edrv-tree-icon { color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-rail-badge { position: absolute; top: 2px; right: 2px; min-width: 14px; height: 14px; padding: 0 3px; border-radius: 999px; background: var(--dsw-alias-brand-primary, #0f9d58); color: var(--dsw-alias-label-primary-inverted, #fff); font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; }
 [data-edrv-view] .edrv-side-body { flex: 1; min-width: 0; min-height: 0; display: flex; overflow: hidden; }
 [data-edrv-view] .edrv-side-panel { flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; position: relative; }
 [data-edrv-view] .edrv-side-head { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px 0 12px; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); flex-shrink: 0; }
@@ -245,9 +250,9 @@
 [data-edrv-view] .edrv-tree-chev { width: 12px; flex-shrink: 0; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 10px; text-align: center; }
 [data-edrv-view] .edrv-tree-name { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
 [data-edrv-view] .edrv-tree-name.edrv-tree-dim { color: var(--dsw-alias-label-tertiary, #9aa5b1); }
-[data-edrv-view] .edrv-tree-badge { min-width: 14px; height: 14px; padding: 0 4px; border-radius: 999px; background: var(--dsw-alias-state-warn-primary, #d97706); color: #fff; font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; flex-shrink: 0; }
+[data-edrv-view] .edrv-tree-badge { min-width: 14px; height: 14px; padding: 0 4px; border-radius: 999px; background: var(--dsw-alias-state-warn-primary, #d97706); color: var(--dsw-alias-label-primary-inverted, #fff); font-size: 9px; font-weight: 600; line-height: 14px; text-align: center; box-sizing: border-box; flex-shrink: 0; }
 [data-edrv-view] .edrv-tree-loading { height: 22px; line-height: 22px; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 11px; }
-[data-edrv-view] .edrv-tree-error { display: flex; align-items: center; gap: 8px; margin: 4px 2px 6px; padding: 6px 8px; border: 1px solid rgba(217,83,79,.4); border-radius: 6px; background: #fdeaea; color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; }
+[data-edrv-view] .edrv-tree-error { display: flex; align-items: center; gap: 8px; margin: 4px 2px 6px; padding: 6px 8px; border: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.4)); border-radius: 6px; background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.12)); color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; }
 /* 大纲面板：kind 字形 / detail / 行号 */
 [data-edrv-view] .edrv-outline-kind { display: inline-flex; align-items: center; justify-content: center; width: 14px; flex-shrink: 0; font-size: 12px; font-weight: 600; text-align: center; }
 [data-edrv-view] .edrv-outline-kind.edrv-ol-func { color: var(--dsw-alias-brand-primary, #0f9d58); }
@@ -295,10 +300,10 @@
 [data-edrv-view] .edrv-search-line:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
 [data-edrv-view] .edrv-search-ln { flex-shrink: 0; color: var(--dsw-alias-label-tertiary, #9aa5b1); font-size: 11px; min-width: 26px; text-align: right; user-select: none; }
 [data-edrv-view] .edrv-search-text { overflow: hidden; text-overflow: ellipsis; white-space: pre; font-family: var(--ds-font-family-code, ui-monospace, monospace); font-size: 11px; }
-[data-edrv-view] .edrv-search-hit { background: var(--dsw-alias-state-warn-primary, #e5b93f); color: #1f2933; border-radius: 2px; padding: 0 1px; }
+[data-edrv-view] .edrv-search-hit { background: var(--dsw-alias-state-warn-primary, #e5b93f); color: var(--dsw-alias-label-primary-inverted, #1f2933); border-radius: 2px; padding: 0 1px; }
 [data-edrv-view] .edrv-search-empty { padding: 8px 4px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #9aa5b1); }
-[data-edrv-view] .edrv-search-error { padding: 6px 8px; border: 1px solid rgba(217,83,79,.4); border-radius: 6px; background: #fdeaea; color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; }
-[data-edrv-view] .edrv-search-warn { padding: 6px 8px; border: 1px solid rgba(240,173,78,.45); border-radius: 6px; background: #fdf6e3; color: #b8860b; font-size: 11px; word-break: break-all; }
+[data-edrv-view] .edrv-search-error { padding: 6px 8px; border: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.4)); border-radius: 6px; background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.12)); color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; }
+[data-edrv-view] .edrv-search-warn { padding: 6px 8px; border: 1px solid var(--dsw-alias-state-warn-primary, rgba(240,173,78,.45)); border-radius: 6px; background: var(--dsw-alias-interactive-bg-hover, rgba(240,173,78,.12)); color: var(--dsw-alias-state-warn-primary, #b8860b); font-size: 11px; word-break: break-all; }
 
 /* include/exclude filter rows (collapsible) */
 [data-edrv-view] .edrv-search-rows { display: flex; flex-direction: column; gap: 4px; padding: 2px 0 4px; }
@@ -333,20 +338,20 @@
 [data-edrv-view] .edrv-rules-file { font-weight: 600; font-size: 12px; color: var(--dsw-alias-label-primary, #1f2933); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 [data-edrv-view] .edrv-rules-path { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 [data-edrv-view] .edrv-rules-type { flex-shrink: 0; height: 15px; padding: 0 5px; border-radius: 999px; font-size: 10px; line-height: 15px; }
-[data-edrv-view] .edrv-rules-type-always { background: rgba(15,157,88,.15); color: #0b7c46; }
-[data-edrv-view] .edrv-rules-type-auto { background: rgba(79,140,255,.16); color: #3367c9; }
+[data-edrv-view] .edrv-rules-type-always { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.15)); color: var(--dsw-alias-state-success-primary, #0b7c46); }
+[data-edrv-view] .edrv-rules-type-auto { background: var(--dsw-alias-interactive-bg-hover-accent, rgba(79,140,255,.16)); color: var(--dsw-alias-link, #3367c9); }
 [data-edrv-view] .edrv-rules-type-manual { background: var(--dsw-alias-bg-layer-2, #f0f4f4); color: var(--dsw-alias-label-secondary, #52606d); }
 [data-edrv-view] .edrv-rules-offtag { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); flex-shrink: 0; }
 [data-edrv-view] .edrv-rules-desc { font-size: 11px; color: var(--dsw-alias-label-secondary, #52606d); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; flex: 0 1 auto; }
 [data-edrv-view] .edrv-rules-actions { display: flex; align-items: center; gap: 2px; flex-shrink: 0; margin-left: auto; }
 [data-edrv-view] .edrv-rules-act { min-width: 22px; height: 22px; padding: 0 4px; border: none; border-radius: 5px; background: transparent; font-size: 12px; line-height: 1; cursor: pointer; color: var(--dsw-alias-label-secondary, #52606d); display: inline-flex; align-items: center; justify-content: center; }
 [data-edrv-view] .edrv-rules-act:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.08)); }
-[data-edrv-view] .edrv-rules-switch { position: relative; width: 30px; height: 16px; border-radius: 999px; border: none; background: #b9c4cc; cursor: pointer; transition: background .15s; flex-shrink: 0; padding: 0; }
-[data-edrv-view] .edrv-rules-switch.on { background: #7c5cff; }
-[data-edrv-view] .edrv-rules-knob { position: absolute; top: 2px; left: 2px; width: 12px; height: 12px; border-radius: 50%; background: #fff; transition: left .15s; }
+[data-edrv-view] .edrv-rules-switch { position: relative; width: 30px; height: 16px; border-radius: 999px; border: none; background: var(--dsw-alias-border-l2, #b9c4cc); cursor: pointer; transition: background .15s; flex-shrink: 0; padding: 0; }
+[data-edrv-view] .edrv-rules-switch.on { background: var(--dsw-alias-brand-primary, #7c5cff); }
+[data-edrv-view] .edrv-rules-knob { position: absolute; top: 2px; left: 2px; width: 12px; height: 12px; border-radius: 50%; background: var(--dsw-alias-bg-layer-1, #fff); transition: left .15s; }
 [data-edrv-view] .edrv-rules-switch.on .edrv-rules-knob { left: 16px; }
 [data-edrv-view] .edrv-rules-empty { padding: 10px 4px; font-size: 12px; color: var(--dsw-alias-label-tertiary, #9aa5b1); line-height: 1.6; }
-[data-edrv-view] .edrv-rules-err { padding: 6px 8px; border: 1px solid rgba(217,83,79,.4); border-radius: 6px; background: #fdeaea; color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; word-break: break-all; }
+[data-edrv-view] .edrv-rules-err { padding: 6px 8px; border: 1px solid var(--dsw-alias-state-error-primary, rgba(217,83,79,.4)); border-radius: 6px; background: var(--dsw-alias-interactive-bg-hover-danger, rgba(217,83,79,.12)); color: var(--dsw-alias-state-error-primary, #d9534f); font-size: 11px; word-break: break-all; }
 [data-edrv-view] .edrv-rules-editor { display: flex; flex-direction: column; min-height: 0; flex: 1; gap: 6px; }
 [data-edrv-view] .edrv-rules-editor-head { display: flex; align-items: center; justify-content: space-between; gap: 6px; font-size: 12px; font-weight: 600; color: var(--dsw-alias-label-primary, #1f2933); flex: 0 0 auto; }
 [data-edrv-view] .edrv-rules-crumb { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
@@ -361,7 +366,7 @@
 [data-edrv-view] .edrv-rules-body:focus { border-color: var(--dsw-alias-brand-primary, #4f8cff); }
 [data-edrv-view] .edrv-rules-editor-hint { font-size: 10px; color: var(--dsw-alias-label-tertiary, #9aa5b1); line-height: 1.5; flex: 0 0 auto; }
 [data-edrv-view] .edrv-rules-editor-foot { display: flex; justify-content: flex-end; flex: 0 0 auto; }
-[data-edrv-view] .edrv-rules-save { height: 24px; padding: 0 14px; border: none; border-radius: 6px; background: var(--dsw-alias-brand-primary, #0f9d58); color: #fff; font-size: 12px; cursor: pointer; }
+[data-edrv-view] .edrv-rules-save { height: 24px; padding: 0 14px; border: none; border-radius: 6px; background: var(--dsw-alias-brand-primary, #0f9d58); color: var(--dsw-alias-label-primary-inverted, #fff); font-size: 12px; cursor: pointer; }
 [data-edrv-view] .edrv-rules-save:disabled { opacity: .5; cursor: default; }
 
 

package/src/client/ui/ClaimRouter.ts

@@ -0,0 +1,96 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — ClaimRouter：官方 file 认领页签的中转正文。
+ * 官方为每个 `dsh-resource://file/**` 地址开一个认领页签；本组件只做转发：
+ * 解析地址 → 送进单一编辑器页签（文件分页由编辑器自带页签栏接管）→ 关闭本中转页签。
+ * 转发失败（seat 未就绪等瞬时态）按 3 次 ×150ms 重试；仍失败则就地渲染兜底正文
+ * （旧行为：每文件一套编辑器），保证退化路径不白屏。本组件自身不创建 Monaco 实例。
+ * 作者 ddj 2026年09月10号
+ */
+import React from 'react'
+import { forwardToEditor, parseOfficialFileAddress, resolveNavLine } from '../officialSidebar.js'
+import { log } from '../log.js'
+
+/** 转发尝试次数（含首次）与重试间隔。 */
+const FORWARD_ATTEMPTS = 3
+const FORWARD_DELAY_MS = 150
+
+/**
+ * 读 slot 框架注入的 tab 记录（hook 缺失或抛错时返回 undefined）。
+ * @author ddj 2026年09月10号
+ * @param props slot 框架注入的组件 props
+ * @returns tab 记录（含 navigation 与 actions），或 undefined
+ */
+function readTab(props) {
+  const useTabInfo = props?.useTabInfo
+  if (typeof useTabInfo !== 'function') return undefined
+  try {
+    return useTabInfo()?.tab
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * 关闭本中转页签（失败仅告警：目标文件已在编辑器打开，残留页签不阻塞功能）。
+ * @author ddj 2026年09月10号
+ * @param tab slot 框架注入的 tab 记录
+ */
+function closeTab(tab) {
+  try {
+    tab?.actions?.close?.()
+  } catch (error) {
+    log.warn('中转页签关闭失败（' + String(error) + '）')
+  }
+}
+
+/**
+ * 组装 file 认领转发正文。
+ * @author ddj 2026年09月10号
+ * @param spec 装配依赖（service 官方导航服务 / schedule 延时调度 / fallback 兜底正文）
+ * @returns 正文组件（注册进 keyed slot sidebar.right.pane.tab）
+ */
+export function createClaimRouter(spec) {
+  const service = spec?.service
+  const schedule = spec?.schedule
+  const fallback = spec?.fallback
+
+  /**
+   * 中转正文：转发成功即关闭自身；重试耗尽后渲染兜底正文。
+   * @param props slot 框架注入（useTabInfo）+ 装配依赖
+   * @returns 兜底正文元素，或 null（转发中 / 已转发）
+   */
+  function ClaimRouter(props) {
+    const tab = readTab(props)
+    const navigation = tab?.navigation
+    const revision = typeof navigation?.revision === 'number' ? navigation.revision : -1
+    const [failed, setFailed] = React.useState(false)
+    const doneRef = React.useRef(-1)
+
+    React.useEffect(() => {
+      if (revision === doneRef.current) return
+      doneRef.current = revision
+      const parsed = parseOfficialFileAddress(navigation?.address)
+      if (!parsed) {
+        setFailed(true)
+        return
+      }
+      const line = resolveNavLine(navigation?.params)
+      let left = FORWARD_ATTEMPTS
+      const attempt = () => {
+        if (forwardToEditor(service, parsed.path, line)) {
+          closeTab(tab)
+          return
+        }
+        left -= 1
+        if (left > 0 && typeof schedule === 'function') schedule(attempt, FORWARD_DELAY_MS)
+        else setFailed(true)
+      }
+      attempt()
+    }, [revision])
+
+    if (!failed || typeof fallback !== 'function') return null
+    return React.createElement(fallback, props)
+  }
+  return ClaimRouter
+}

package/src/client/ui/EditorView.ts

@@ -14,7 +14,7 @@ import { langOf, loadMonaco } from '../monaco/loader.js'
 import { dataUrlOf, isImagePath, isSvgPath } from '../imagePreview.js'
 import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
 import { createPdfPanel } from '../pdf/pdfPanel.js'
-import { applyTheme, registerThemes, themeNameOf } from '../monaco/theme.js'
+import { applyOfficial, registerThemes, themeNameOf } from '../monaco/theme.js'
 import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
@@ -130,6 +130,8 @@ export function EditorView(props) {
   const navCursorTimerRef = React.useRef(null) // 光标位置防抖记录计时器
   const navBackRef = React.useRef(null) // 后退动作最新闭包（窗口级键盘监听读取）
   const navForwardRef = React.useRef(null) // 前进动作最新闭包（窗口级键盘监听读取）
+  const cycleTabRef = React.useRef(null) // 页签循环动作最新闭包（Ctrl+Alt+←/→、Ctrl+PgUp/PgDn）
+  const tabsHostRef = React.useRef(null) // 页签栏容器（切换后把当前页签滚入可见区）
   const [navTick, setNavTick] = React.useState(0) // 历史可用性版本（按钮 disabled 重渲染）
   const hoverRegionsRef = React.useRef([]) // 当前 pending 区域镜像（稳定回调读取）
   const lineRegionMapRef = React.useRef(new Map()) // 行 → 区域 映射（hover 命中）
@@ -324,6 +326,23 @@ export function EditorView(props) {
     })
   }
 
+  /**
+   * 在已打开页签间循环切换（文件分页归编辑器自带页签栏）。
+   * @author ddj 2026年09月10号
+   * @param step 步进（+1 下一个 / -1 上一个）
+   */
+  const cycleTab = (step) => {
+    if (tabs.length < 2) return
+    const idx = tabs.findIndex((t) => t.path === active)
+    const next = tabs[(idx + step + tabs.length) % tabs.length]
+    if (!next || next.path === active) return
+    flushSave()
+    saveViewState(active)
+    recordNav()
+    setActive(next.path)
+  }
+  cycleTabRef.current = cycleTab
+
   /**
    * 轮询去重：前后记录内容一致时返回原引用，React 跳过重渲染，
    * 阻断 5s 轮询 → memo 链 → diff 重渲染/日志 的空转。
@@ -766,6 +785,33 @@ export function EditorView(props) {
     return () => window.removeEventListener('keydown', onKey, true)
   }, [])
 
+  // 页签循环切换：Ctrl+Alt+←/→（主候选，浏览器不占用）或 Ctrl+PgUp/PgDn（部分宿主可用）
+  React.useEffect(() => {
+    const onKey = (e) => {
+      const step = matchEvent(e, bindingsOf('edrv.nextTab')) ? 1
+        : matchEvent(e, bindingsOf('edrv.prevTab')) ? -1
+          : 0
+      if (step === 0) return
+      e.preventDefault(); e.stopPropagation()
+      if (cycleTabRef.current) cycleTabRef.current(step)
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, true)
+  }, [])
+
+  // 活动页签滚动可见（页签栏溢出时键盘切换/打开文件后把当前页签带回视野）：
+  // 只调整页签栏自身 scrollLeft，不触发页面滚动。
+  React.useEffect(() => {
+    const host = tabsHostRef.current
+    if (!host) return
+    const el = host.querySelector?.('.edrv-tab-active')
+    if (!el) return
+    const left = el.offsetLeft
+    const right = left + el.offsetWidth
+    if (left < host.scrollLeft) host.scrollLeft = left
+    else if (right > host.scrollLeft + host.clientWidth) host.scrollLeft = right - host.clientWidth
+  }, [active, tabs.length])
+
   // 鼠标侧键后退/前进：Logitech 官方默认「后退/前进」= XButton 鼠标事件（button 3/4），不产生键盘事件。
   // pointerdown 触发导航（preventDefault 后兼容 mousedown 可能不再触发，避免双触发）；
   // mousedown 兜底仅取消浏览器历史导航默认动作（MDN：preventDefault mousedown/pointerdown 可抑制）。
@@ -840,20 +886,25 @@ export function EditorView(props) {
     return () => { alive = false }
   }, [monaco, monacoErr])
 
-  // 分色主题：Monaco 就绪后注册（幂等）+ 应用；DSH 明暗切换时跟随重刷。
+  // 主题：Monaco 就绪后注册现役双套（幂等）+ 应用跟随官方的令牌主题；
+  // 官方主题事件（edrv:theme-change，经 ctx.theme/属性观察广播）与系统明暗切换时跟随重刷。
   React.useEffect(() => {
     if (!monaco) return
     registerThemes(monaco)
-    applyTheme(monaco)
-    if (typeof window.matchMedia !== 'function') return
-    const query = window.matchMedia('(prefers-color-scheme: dark)')
-    const onChange = () => applyTheme(monaco)
-    if (typeof query.addEventListener === 'function') {
-      query.addEventListener('change', onChange)
-      return () => query.removeEventListener('change', onChange)
+    const apply = () => applyOfficial(monaco)
+    apply()
+    window.addEventListener('edrv:theme-change', apply)
+    const query = typeof window.matchMedia === 'function' ? window.matchMedia('(prefers-color-scheme: dark)') : null
+    if (query) {
+      if (typeof query.addEventListener === 'function') query.addEventListener('change', apply)
+      else query.addListener(apply)
+    }
+    return () => {
+      window.removeEventListener('edrv:theme-change', apply)
+      if (!query) return
+      if (typeof query.removeEventListener === 'function') query.removeEventListener('change', apply)
+      else query.removeListener(apply)
     }
-    query.addListener(onChange)
-    return () => query.removeListener(onChange)
   }, [monaco])
 
   monacoRef.current = monaco
@@ -1470,7 +1521,7 @@ export function EditorView(props) {
     }).catch((e) => { setStatus('打开失败'); setError('打开异常:' + String(e)) })
   }
 
-  const tabsEl = React.createElement('div', { className: 'edrv-tabs', style: { flex: '1 1 auto', minWidth: 0 } },
+  const tabsEl = React.createElement('div', { className: 'edrv-tabs', ref: tabsHostRef, style: { flex: '1 1 auto', minWidth: 0 } },
     tabs.map((t) => React.createElement('div', {
       key: t.path,
       className: 'edrv-tab' + (t.path === active ? ' edrv-tab-active' : ''),

package/src/client/ui/OfficialSideTab.ts

@@ -1,17 +1,16 @@
 // @ts-nocheck
 /**
- * dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」Tab 正文包装。
- * 双用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff）打开；
- * file 资源类型 Tab（edrvEditorFile，认领 dsh-resource://file/**）经 navigation.address
- * 解码出真实路径并透传 params.line 行号定位。派发既有 edrv:open-editor 事件复用
- * EditorView 打开流；按会话 key 保证切会话干净重建。
+ * dsh-vscode-mode client — OfficialSideTab：DSH 官方右侧 Sidebar「文件编辑」页签正文包装。
+ * 用途：页类型 Tab（edrvEditor）经 navigation.params（openPath/focusDiff/line）打开；
+ * 兼作 file 认领转发（ClaimRouter）失败时的兜底正文（就地挂编辑器，旧行为）。
+ * 派发既有 edrv:open-editor 事件复用 EditorView 打开流；按会话 key 保证切会话干净重建。
  * Tab 正文切换后重挂载时按最新导航恢复打开（对齐 better-sidebar 形态的种子行为）。
- * 作者 ddj 2026年09月09号
+ * 作者 ddj 2026年09月09号 / 2026年09月10号
  */
 import React from 'react'
 import { EditorView } from './EditorView.js'
 import { setSideEditorMounted } from '../sidebarBridge.js'
-import { editorMountEpoch, markEditorMounted, parseOfficialFileAddress, resolveNavOpen } from '../officialSidebar.js'
+import { editorMountEpoch, markEditorMounted, parseOfficialFileAddress, resolveNavLine, resolveNavOpen } from '../officialSidebar.js'
 
 /**
  * 官方侧边栏 Tab 正文组件（keyed slot sidebar.right.pane.tab 装配）。
@@ -71,10 +70,10 @@ export function OfficialSideTab(props) {
       }))
       return
     }
-    // 页类型 Tab：params 携带打开请求
+    // 页类型 Tab：params 携带打开请求（line = 行引用/工具行跳转的行号定位）
     const request = resolveNavOpen(navigation?.params)
     window.dispatchEvent(new CustomEvent('edrv:open-editor', {
-      detail: { path: request.path, focusDiff: request.focusDiff },
+      detail: { path: request.path, focusDiff: request.focusDiff, line: resolveNavLine(navigation?.params) },
     }))
   })
 

package/src/client-primitives.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 官方 UI 原语虚拟模块的最小类型垫片（@deepseek-ai/dsh-client-ui-primitives）。
+ *
+ * 该模块由 DSH web 前端的 loader 在运行时提供（磁盘上没有对应包目录，官方 40+ 个
+ * 客户端包同样以 require 方式消费），本垫片只声明本插件用到的成员，供 tsc 类型检查；
+ * 运行时取值为 loader 注入实例。完整成员清单见官方前端产物导出表。
+ * 作者 ddj 2026-09-10
+ */
+declare module '@deepseek-ai/dsh-client-ui-primitives' {
+  /** 图标组件通用 props（官方 Icon* 组件与 FileTypeIcon 共用形状）。 */
+  export interface EdrvIconProps {
+    /** 图标边长（px）；省略时用图标自带尺寸。 */
+    size?: number
+    className?: string
+  }
+
+  /** 按文件名（或扩展名）分类的官方文件类型判别符（未知类型返回 'other'）。 */
+  export function classifyFileType(name: string): string
+
+  /** 官方文件类型图标：按 classifyFileType 的 kind 渲染（跟随官方主题配色）。 */
+  export const FileTypeIcon: (props: EdrvIconProps & { kind: string }) => unknown
+
+  /** 目录闭合图标（官方文件树同款）。 */
+  export const IconFolderClose16: (props: EdrvIconProps) => unknown
+  /** 目录展开图标（官方文件树同款）。 */
+  export const IconFolderOpen16: (props: EdrvIconProps) => unknown
+  /** 目录轮廓图标（活动栏「文件管理」）。 */
+  export const IconFolderOpenOutline16: (props: EdrvIconProps) => unknown
+  /** 刷新图标（面板工具条）。 */
+  export const IconRefreshOutline16: (props: EdrvIconProps) => unknown
+  /** 搜索图标（活动栏「搜索」）。 */
+  export const IconSearchOutline16: (props: EdrvIconProps) => unknown
+  /** 列表+笔图标（活动栏「规则」）。 */
+  export const IconListPenOutline16: (props: EdrvIconProps) => unknown
+  /** 代码图标（活动栏「大纲」）。 */
+  export const IconCodeOutline16: (props: EdrvIconProps) => unknown
+}

package/src/shared/keybindings.ts

@@ -14,6 +14,9 @@ export const KEYBINDING_DEFAULTS: Record<string, string> = {
   'edrv.searchInFiles': 'Ctrl+Shift+F',
   'edrv.navigateBack': 'Alt+ArrowLeft|Ctrl+Alt+-',
   'edrv.navigateForward': 'Alt+ArrowRight|Ctrl+Shift+-',
+  // 页签循环：主候选避开浏览器保留键（Ctrl+Tab / Ctrl+PgUp/PgDn 会被浏览器截获）
+  'edrv.nextTab': 'Ctrl+Alt+ArrowRight|Ctrl+PageDown',
+  'edrv.prevTab': 'Ctrl+Alt+ArrowLeft|Ctrl+PageUp',
 }
 
 /**