dsh-coding-sidebar 1.0.3 → 1.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-coding-sidebar",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "DSH web plugin: a VSCode-like right sidebar (explorer / editor / terminal / git / browser), isolated per conversation session. Exposes the betterSidebar service for other plugins to register sidebar tabs and file viewers. KCoder-maintained fork of DSH-better-sidebar 0.17.2 (bottom panel removed, upstream-decoupled release line).",
   "type": "module",
   "repository": {
@@ -61,7 +61,6 @@
     "lib/client-registry.js",
     "lib/client-terminal.js",
     "lib/client-editor.js",
-    "lib/client-mermaid.js",
     "lib/types/**/*.d.ts",
     "src",
     "scripts/install.sh",
@@ -85,18 +84,18 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.2",
     "@huanlin/dsh-plugin-better-locale": "^0.1.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
@@ -130,8 +129,6 @@
     "@codemirror/view": "^6.43.8",
     "@lezer/highlight": "^1.2.3",
     "clsx": "^2.1.1",
-    "dompurify": "^3.4.14",
-    "mermaid": "^11.16.1",
     "node-pty": "^1.1.0",
     "react-icons": "5.7.0",
     "rxjs": "^7.8.2",
@@ -139,20 +136,20 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-invariants": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2",
     "@cordisjs/plugin-loader": "^1.0.0-rc.5",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-subagent": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-subagent": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
     "@huanlin/dsh-plugin-better-locale": "^0.1.0",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",

package/src/bundle-route.ts

@@ -19,7 +19,7 @@ import { fileURLToPath } from 'node:url'
 import type { Context, SidebarHttpRequest, SidebarHttpResponse } from './context-types.ts'
 
 /** The chunk names the client may request (mirror of src/client/chunk-loader.ts). */
-export const CHUNK_NAMES = ['terminal', 'editor', 'mermaid'] as const
+export const CHUNK_NAMES = ['terminal', 'editor'] as const
 export type ChunkName = (typeof CHUNK_NAMES)[number]
 
 /** Directory of this host-half module (lib/ — the chunk scripts live next to it). */

package/src/client/EditorHost.tsx

@@ -1,10 +1,11 @@
 /**
- * The editor tab host: the single FILES WINDOW. It resolves a file's
- * previewer through the sidebar registry (`matchFileViewer`), fetches bytes
- * per the matched viewer's fetch strategy, and renders its component — or
- * the shared download pane when nothing can render the file. A tab without
- * a path (the seeded "Files" home) renders an empty-state hint instead of
- * the viewer loading flow; that path-less window IS the file explorer.
+ * The editor tab host: the single FILES WINDOW. It fetches a file's text
+ * through the host fs.read — text renders in the (chunk-lazy) sidebar text
+ * editor, a binary file renders the shared download pane. (v1.0.4: the
+ * file-viewer registry/matching was retired — file preview is the host's
+ * job now, the sidebar edits text only.) A tab without a path (the seeded
+ * "Files" home) renders an empty-state hint instead of the loading flow;
+ * that path-less window IS the file explorer.
  *
  * The chrome depends on the `editorExplorer` mode (read reactively so
  * toggling it re-renders without a reload):
@@ -18,18 +19,14 @@
  * The tree's context menu offers the explicit escapes in both modes: open
  * in a new tab (per-path dedupe) or to the side (a fresh tab in a fresh
  * rightward split of the current pane).
- *
- * The strategy dispatch is pure (planFirstMatch / planFsReadOutcome in
- * editor-load.ts); this component only wires it to the host APIs.
  */
 import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react'
-import { createElement } from 'react'
+import type { ComponentType } from 'react'
 import clsx from 'clsx'
 import { IconCheckOutline16, IconFolderOpen16, IconRefreshOutline14 } from '@deepseek-ai/dsh-client-ui-primitives'
 import type { Context } from '../context-types.ts'
-import { api, mediaUrl, type SessionScope } from './api.ts'
+import { api, type SessionScope } from './api.ts'
 import { BinaryDownload } from './binary-download.tsx'
-import { planFirstMatch, planFsReadOutcome, type EditorLoadAction } from './editor-load.ts'
 import { baseName } from './FileTree.tsx'
 import { createFrameBatcher } from './frame-batcher.ts'
 import { openSidebarFile } from './intercept.tsx'
@@ -39,16 +36,27 @@ import { TreePanel } from './TreePanel.tsx'
 import { t } from './locales.ts'
 import { relativeTo } from './paths.ts'
 import { resolveSidebarPath } from './produced-files.ts'
-import type { EditorToolbarControls, EditorToolbarState, FileViewerDescriptor } from './service.ts'
+import type { EditorToolbarControls, EditorToolbarState } from './service.ts'
+import { lazyChunkComponent } from './lazy-chunk.tsx'
+import type { TextEditorProps } from './TextEditor.tsx'
 import { firstLeaf, insertLeafAt, leafWithTab, mintTabId, treeOf, type SidebarStore, type SidebarTab } from './state.ts'
 import css from './sidebar.module.css'
 
 type EditorLoad =
   | { status: 'loading' }
   | { status: 'error'; message: string }
-  | { status: 'ready'; viewer: FileViewerDescriptor; content?: string; truncated?: boolean; mediaUrl?: string; customData?: unknown }
+  | { status: 'ready'; content: string; truncated: boolean }
   | { status: 'binary' }
 
+/**
+ * Lazy wrapper over the chunk-resident text editor: CodeMirror and the
+ * language packs are fetched only when a file tab first renders (see
+ * chunk-loader.ts). The `pick` function is module-level (stable identity —
+ * the wrapper effect depends on it); the cast bridges the chunk exports
+ * record to the prop shape.
+ */
+const LazyTextEditor = lazyChunkComponent<TextEditorProps>('editor', (mod) => mod.TextEditor as ComponentType<TextEditorProps> | undefined)
+
 /** The docked tree panel's width bounds (drag-resize clamps into them). */
 const TREE_WIDTH_DEFAULT = 240
 const TREE_WIDTH_MIN = 160
@@ -103,11 +111,10 @@ export function EditorHost(props: {
 }) {
   const { ctx, store, scope, tab, expanded, revealed, onToggleDir, onReferenceFile } = props
   const path = tab.path ?? ''
-  const title = tab.title
   // A folder window: the model's `sidebar_open` (or any caller) opens a
   // directory as an editor tab carrying `meta.dir: true` with the directory
   // as its path. It renders the file tree rooted at that folder instead of
-  // the viewer loading flow (a directory is not a file).
+  // the file loading flow (a directory is not a file).
   const isDir = metaOf(tab).dir === true
   const [load, setLoad] = useState<EditorLoad>({ status: 'loading' })
   // Manual refresh (issue #167): bumping the sequence re-runs the load effect
@@ -223,9 +230,8 @@ export function EditorHost(props: {
     })
   }
 
-  // The viewer's toolbar, hoisted into THIS header: the text editor reports
-  // its state and registers its commands (both null/absent for viewers
-  // without a toolbar — image, pdf, binary download).
+  // The editor's toolbar, hoisted into THIS header: the text editor reports
+  // its state and registers its commands (null while nothing is loaded).
   const [toolbar, setToolbar] = useState<EditorToolbarState | null>(null)
   const controlsRef = useRef<EditorToolbarControls | null>(null)
   const onToolbarState = useCallback((next: EditorToolbarState) => {
@@ -279,77 +285,27 @@ export function EditorHost(props: {
 
   useEffect(() => {
     // A (re)load or a path-less tab clears any hoisted toolbar state — the
-    // fresh viewer re-registers its own.
+    // fresh editor re-registers its own.
     setToolbar(null)
-    // The seeded home tab (no path) never loads a viewer — the empty-state
+    // The seeded home tab (no path) never loads a file — the empty-state
     // hint renders until the user picks a file. A folder tab never loads a
-    // viewer either — its tree is rooted at the folder.
+    // file either — its tree is rooted at the folder.
     if (showEmpty || isDir) return
     let cancelled = false
-    // Aborts the matched viewer's `load` when the editor tears down (tab
-    // closed, path changed, session switched) or re-matches the viewer.
-    const controller = new AbortController()
     setLoad({ status: 'loading' })
-    const mediaUrlOf = (): string => mediaUrl(scope, path)
-    const apply = (action: EditorLoadAction): void => {
+    api.fsRead(scope, path).then((result) => {
       if (cancelled) return
-      switch (action.kind) {
-        case 'binary':
-          setLoad({ status: 'binary' })
-          return
-        case 'render':
-          setLoad({
-            status: 'ready',
-            viewer: action.viewer,
-            content: action.content,
-            truncated: action.truncated,
-            mediaUrl: action.mediaUrl,
-            customData: action.customData,
-          })
-          return
-        case 'customLoad':
-          void action.viewer.load?.(path, scope, controller.signal).then((data) => {
-            if (cancelled) return
-            setLoad({ status: 'ready', viewer: action.viewer, customData: data })
-          }).catch((error: unknown) => {
-            if (cancelled) return
-            setLoad({ status: 'error', message: error instanceof Error ? error.message : String(error) })
-          })
-          return
-        case 'fetchFsRead':
-          api.fsRead(scope, path).then((result) => {
-            if (cancelled) return
-            // Binary reads carry the head bytes for the detect re-match.
-            const outcome = planFsReadOutcome(action.viewer, {
-              binary: result.kind === 'binary',
-              content: result.kind === 'text' ? result.content : '',
-              truncated: result.truncated,
-              head: result.kind === 'binary' ? result.head : undefined,
-            }, (head) => ctx.get('betterSidebar')?.matchFileViewer(path, head), mediaUrlOf)
-            apply(outcome)
-          }).catch((error: unknown) => {
-            if (cancelled) return
-            setLoad({ status: 'error', message: error instanceof Error ? error.message : String(error) })
-          })
-          return
+      if (result.kind === 'binary') {
+        setLoad({ status: 'binary' })
+        return
       }
-    }
-    apply(planFirstMatch(ctx.get('betterSidebar')?.matchFileViewer(path), mediaUrlOf))
-    return () => { cancelled = true; controller.abort() }
-  }, [scope.sessionId, scope.cwd, path, ctx, showEmpty, isDir, reloadSeq])
-
-  // Save-then-refresh in preview mode (issue #167 part C): the edge into
-  // 'saved' (never a lingering 'saved' state) triggers exactly one reload, so
-  // a preview-mode Ctrl+S shows the fresh content immediately. Edit mode is
-  // left alone — reloading would remount the editor and drop the caret.
-  const prevSaveState = useRef<EditorToolbarState['saveState'] | undefined>(undefined)
-  useEffect(() => {
-    const current = toolbar?.saveState
-    if (prevSaveState.current !== 'saved' && current === 'saved' && toolbar?.mode === 'preview') {
-      setReloadSeq(sequence => sequence + 1)
-    }
-    prevSaveState.current = current
-  }, [toolbar?.saveState, toolbar?.mode])
+      setLoad({ status: 'ready', content: result.content, truncated: result.truncated })
+    }).catch((error: unknown) => {
+      if (cancelled) return
+      setLoad({ status: 'error', message: error instanceof Error ? error.message : String(error) })
+    })
+    return () => { cancelled = true }
+  }, [scope.sessionId, scope.cwd, path, showEmpty, isDir, reloadSeq])
 
   const treeOpen = treeOpenOf(tab)
   /** Persist the panel flag on the tab (survives reloads with the layout). */
@@ -392,33 +348,6 @@ export function EditorHost(props: {
     <div className={css.editor}>
       <div className={css.editorHeader}>
         <EditorPathInput key={path} path={path} cwd={scope.cwd} onOpen={openFile} />
-        {toolbar?.modes === true && (
-          <div className={css.editorModeToggle}>
-            <button
-              type="button"
-              className={clsx(css.editorModeButton, toolbar.mode === 'preview' && css.editorModeActive)}
-              onClick={() => {
-                // Issue #167 part B: returning from edit to preview reloads so
-                // the preview renders the just-saved content. A dirty draft
-                // (or a failed save) suppresses the reload — the draft only
-                // lives in the editor instance and a remount would drop it.
-                if (toolbar.mode === 'edit' && toolbar.dirty !== true && toolbar.saveState !== 'failed') {
-                  setReloadSeq(sequence => sequence + 1)
-                }
-                controlsRef.current?.setMode('preview')
-              }}
-            >
-              {t('preview')}
-            </button>
-            <button
-              type="button"
-              className={clsx(css.editorModeButton, toolbar.mode === 'edit' && css.editorModeActive)}
-              onClick={() => { controlsRef.current?.setMode('edit') }}
-            >
-              {t('edit')}
-            </button>
-          </div>
-        )}
         {toolbar?.dirty === true && <span className={css.dirtyDot} title={t('unsaved')} />}
         {toolbar?.editable === true && (
           <button
@@ -462,18 +391,19 @@ export function EditorHost(props: {
           {!showEmpty && load.status === 'loading' && <div className={css.editorPlaceholder}>{t('loading')}</div>}
           {!showEmpty && load.status === 'error' && <div className={css.editorError}>{load.message}</div>}
           {!showEmpty && load.status === 'binary' && <BinaryDownload scope={scope} path={path} />}
-          {!showEmpty && load.status === 'ready' && createElement(load.viewer.component, {
-            ctx, store, scope, path, title,
-            viewerId: load.viewer.id,
-            content: load.content,
-            truncated: load.truncated,
-            mediaUrl: load.mediaUrl,
-            customData: load.customData,
-            // The viewer's toolbar always hoists into this host's header.
-            toolbar: 'host',
-            onToolbarState,
-            onToolbarControls,
-          })}
+          {!showEmpty && load.status === 'ready' && (
+            <LazyTextEditor
+              ctx={ctx}
+              store={store}
+              scope={scope}
+              path={path}
+              content={load.content}
+              truncated={load.truncated}
+              toolbar="host"
+              onToolbarState={onToolbarState}
+              onToolbarControls={onToolbarControls}
+            />
+          )}
         </div>
         {treeOpen && (
           <div className={css.editorTreeDock} style={{ width: treeWidth }}>

package/src/client/SandboxStatusBar.tsx

@@ -1,15 +1,18 @@
 /**
- * The live sandbox status row of the two built-in web surfaces (HTML
- * preview and the browser tab): a green "sandbox on" state with a one-tap
- * TEMPORARY unlock, or a RED "sandbox off" state (global setting or the
- * temporary unlock) with a restore action.
+ * The live sandbox status row of the built-in browser tab: a green
+ * "sandbox on" state with a one-tap TEMPORARY unlock, or a RED "sandbox
+ * off" state (global setting or the temporary unlock) with a restore
+ * action.
  *
  * The temporary unlock is component state only — it never writes the
- * global side card setting (`htmlViewerNoSandbox` / `browserNoSandbox`);
- * it lasts until the surface unmounts (tab switch / file switch) or the
- * user restores the sandbox from the row. When the global setting already
- * drops the sandbox, no unlock/restore action is offered (changing the
- * global setting is the settings page's job) — the red warning stands.
+ * global side card setting (`browserNoSandbox`); it lasts until the
+ * surface unmounts (tab switch) or the user restores the sandbox from the
+ * row. When the global setting already drops the sandbox, no
+ * unlock/restore action is offered (changing the global setting is the
+ * settings page's job) — the red warning stands.
+ *
+ * (v1.0.4: the HTML preview surface was retired with the file-viewer line;
+ * this row now serves the browser tab only.)
  */
 import clsx from 'clsx'
 import { t } from './locales.ts'

package/src/client/SideCardSection.tsx

@@ -12,8 +12,9 @@
  *    external plugins alike), laid out in a responsive grid that wraps
  *    several cards per row — icon chip + title + type id, clicked to toggle
  *    the switch persisted in `prefs.tabsEnabled[id]`.
- *  - 文件预览: one SMALL CARD per REGISTERED file viewer — icon chip + title
- *    + the extensions it covers, clicked to toggle `prefs.viewersEnabled[id]`.
+ *
+ * (v1.0.4: the 文件预览 viewer inventory was retired with the file-viewer
+ * registry — file preview is the host's job now.)
  *
  * Every group lives in a container card (the DSH PluginCard recipe: l2
  * hairline, 16px radius, layer-3 fill) with a heading and an inventory count
@@ -64,14 +65,13 @@ import {
 } from '../prefs-shared.ts'
 import { api } from './api.ts'
 import { parsePrefs } from './prefs.ts'
-import { AddPluginModal, type PluginKind } from './add-plugin-modal.tsx'
+import { AddPluginModal } from './add-plugin-modal.tsx'
 import { t } from './locales.ts'
 import { parseDesktopEnv } from './desktop-env.ts'
 import { getShellPreset, getShellPresets } from './shell-presets.ts'
 import type { SidebarStore } from './state.ts'
 import type {
   BetterSidebarService,
-  FileViewerDescriptor,
   SidebarSettingsRenderProps,
   SidebarSettingToggle,
   TabDescriptor,
@@ -124,13 +124,8 @@ function titleBarSchemeValue(prefs: SidebarPrefs): string {
   return preset !== undefined ? `preset:${preset.id}` : 'auto'
 }
 
-/** Viewer inventory order: priority desc (the catch-all `code` comes last). */
-function viewerOrder(a: FileViewerDescriptor, b: FileViewerDescriptor): number {
-  return (b.priority ?? 0) - (a.priority ?? 0)
-}
-
 /** Whether a feature declares any secondary settings (gear button shows). */
-function hasSettings(feature: TabDescriptor | FileViewerDescriptor): boolean {
+function hasSettings(feature: TabDescriptor): boolean {
   const settings = feature.settings
   return settings !== undefined && (
     (settings.toggles?.length ?? 0) > 0
@@ -139,9 +134,9 @@ function hasSettings(feature: TabDescriptor | FileViewerDescriptor): boolean {
   )
 }
 
-/** A feature's display name (viewers fall back to their id). */
-function featureNameOf(feature: TabDescriptor | FileViewerDescriptor): string {
-  return textOf('title' in feature ? feature.title : undefined) || feature.id
+/** A feature's display name. */
+function featureNameOf(feature: TabDescriptor): string {
+  return textOf(feature.title) || feature.id
 }
 
 /**
@@ -491,7 +486,7 @@ function SelectRow(props: {
 }
 
 /**
- * The secondary settings popup body of one feature (tab or viewer):
+ * The secondary settings popup body of one registered tab:
  * - the host-prefs `toggles` rows, then the plugin-owned `pluginToggles`
  *   rows (their values live in `pluginSettings[feature.id]`, projected onto
  *   the prefs face so the shared row renderer reads them);
@@ -501,7 +496,7 @@ function SelectRow(props: {
  *   open-behavior picker) and still ship a custom configuration area.
  */
 export function SettingsBody(props: {
-  feature: TabDescriptor | FileViewerDescriptor
+  feature: TabDescriptor
   prefs: SidebarPrefs
   store: SidebarStore
   service: BetterSidebarService
@@ -576,19 +571,18 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
   const [widthDraft, setWidthDraft] = useState<string>(String(store.getPrefs().defaultWidthPercent))
   const [error, setError] = useState<string | null>(null)
   // Which feature's secondary settings popup is open (null = closed).
-  const [settingsFor, setSettingsFor] = useState<TabDescriptor | FileViewerDescriptor | null>(null)
+  const [settingsFor, setSettingsFor] = useState<TabDescriptor | null>(null)
   // Whether the position-compat strip popup (the gear on the 常规 row) is open.
   const [stripSettingsOpen, setStripSettingsOpen] = useState(false)
   // The parsed desktop environment (URL stamps — see desktop-env.ts). Used
   // ONLY to badge matching presets in the scheme dropdown ("已检测");
   // nothing is auto-applied.
   const detectedEnv = useMemo(() => parseDesktopEnv(), [])
-  // Whether the "add plugin" modal (a dashed card at the end of the
-  // 侧边栏内容 / 文件预览 grids) is open, and for which extension point
-  // (null = closed).
-  const [addPluginsOpen, setAddPluginsOpen] = useState<PluginKind | null>(null)
+  // Whether the "add plugin" modal (the dashed card at the end of the
+  // 侧边栏内容 grid) is open.
+  const [addPluginsOpen, setAddPluginsOpen] = useState(false)
   // The LATEST optimistic prefs, kept in sync with the state. Nested-map
-  // merges (tabsEnabled / viewersEnabled / pluginSettings) MUST build from
+  // merges (tabsEnabled / pluginSettings) MUST build from
   // this ref, not from the render-time `prefs`: two same-tick writes (e.g.
   // a settings panel updating several plugin keys at once) would otherwise
   // both spread the stale map and the later patch would drop the earlier
@@ -596,14 +590,12 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
   const optimisticRef = useRef(prefs)
   useEffect(() => { optimisticRef.current = prefs }, [prefs])
 
-  // The declarative inventory: the registered tab types and file viewers.
-  // Local state + service.subscribe (registry changes are rare — plugin
-  // load/unload — so a plain effect is enough; no external-store ceremony).
+  // The declarative inventory: the registered tab types. Local state +
+  // service.subscribe (registry changes are rare — plugin load/unload — so
+  // a plain effect is enough; no external-store ceremony).
   const [tabs, setTabs] = useState<TabDescriptor[]>(() => [...service.getTabs()].sort(tabOrder))
-  const [viewers, setViewers] = useState<FileViewerDescriptor[]>(() => [...service.getFileViewers()].sort(viewerOrder))
   useEffect(() => service.subscribe(() => {
     setTabs([...service.getTabs()].sort(tabOrder))
-    setViewers([...service.getFileViewers()].sort(viewerOrder))
   }), [service])
 
   // The settings document revision (guards concurrent writes). A ref: commits
@@ -682,11 +674,6 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
     applyPref({ tabsEnabled: { ...optimisticRef.current.tabsEnabled, [id]: next } })
   }
 
-  /** Flip one per-viewer enable switch (merge into the viewersEnabled map). */
-  const onToggleViewer = (id: string, next: boolean): void => {
-    applyPref({ viewersEnabled: { ...optimisticRef.current.viewersEnabled, [id]: next } })
-  }
-
   /** Flip one declaratively-declared toggle (a SidebarPrefs boolean field). */
   const onToggleSetting = (toggle: SidebarSettingToggle, next: boolean): void => {
     applyPref({ [toggle.key]: next })
@@ -1001,7 +988,7 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
           <button
             type="button"
             className={clsx(css.card, css.addCard)}
-            onClick={() => { setAddPluginsOpen('tab') }}
+            onClick={() => { setAddPluginsOpen(true) }}
           >
             <span className={css.cardTop}>
               <span className={css.cardIconChip}>
@@ -1014,45 +1001,6 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
         </div>
       </div>
 
-      {/* 文件预览: one small card per registered file viewer. */}
-      <div className={css.group}>
-        <div className={css.groupHeading}>
-          <span>{t('settingsViewersTitle')}</span>
-          <span className={css.count}>{viewers.length}</span>
-        </div>
-        <div className={css.grid}>
-          {viewers.map(viewer => (
-            <Fragment key={viewer.id}>
-              {renderCard({
-                title: textOf(viewer.title) || viewer.id,
-                desc: viewer.exts.length === 0 ? t('settingsViewerCatchAll') : viewer.exts.join(' · '),
-                icon: iconOf(viewer.icon, 16),
-                enabled: prefs.viewersEnabled[viewer.id] !== false,
-                onToggle: (next) => { onToggleViewer(viewer.id, next) },
-                onOpenSettings: prefs.viewersEnabled[viewer.id] !== false && hasSettings(viewer)
-                  ? () => { setSettingsFor(viewer) }
-                  : undefined,
-              })}
-            </Fragment>
-          ))}
-          {/* The "add preview plugin" entry: dashed card opening the
-              FILE-PREVIEWER registration modal. */}
-          <button
-            type="button"
-            className={clsx(css.card, css.addCard)}
-            onClick={() => { setAddPluginsOpen('viewer') }}
-          >
-            <span className={css.cardTop}>
-              <span className={css.cardIconChip}>
-                <IconPlusOutline16 size={16} />
-              </span>
-              <span className={css.cardTitle}>{t('addPluginsViewerCard')}</span>
-            </span>
-            <span className={css.cardDesc}>{t('addPluginsViewerCardDesc')}</span>
-          </button>
-        </div>
-      </div>
-
       {/* The secondary settings popup: a feature's declared related settings
           as title/desc + switch rows in a wider-than-default Modal with a
           Done footer (Modal chrome is the app's own). Mounted only while a
@@ -1138,18 +1086,17 @@ export function SideCardSection({ store, service }: SideCardSectionProps) {
         </Modal>
       )}
 
-      {/* The "add plugin" modal (opened by the dashed cards above): declares
-          the extension point of the clicked kind, opens the GitHub topic,
-          and lists the matching recommended plugin catalog with per-entry
-          install buttons (the install flow opens a ~/.dsh terminal with
-          the command pre-typed; failures render inline here, in settings
-          only). Mounted only while open (Modal runs hooks unconditionally
-          — same SSR rule as the settings popup above). */}
-      {addPluginsOpen !== null && (
+      {/* The "add plugin" modal (opened by the dashed card above): declares
+          the tab extension point, opens the GitHub topic, and lists the
+          recommended plugin catalog with per-entry install buttons (the
+          install flow opens a ~/.dsh terminal with the command pre-typed;
+          failures render inline here, in settings only). Mounted only while
+          open (Modal runs hooks unconditionally — same SSR rule as the
+          settings popup above). */}
+      {addPluginsOpen && (
         <AddPluginModal
           service={service}
-          onClose={() => { setAddPluginsOpen(null) }}
-          kind={addPluginsOpen}
+          onClose={() => { setAddPluginsOpen(false) }}
         />
       )}