dsh-tiddlywiki 0.16.20 → 0.16.21

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-tiddlywiki",
   "description": "TiddlyWiki 5 as the DSH persistent knowledge base: tiddlywiki_* agent tools (search with filters/recent/tags/batch/rename + git sync & conflict resolve), a full TiddlyWiki editor embedded in the GUI center column (same-origin proxy, works over Tailscale/LAN/domain), a quick-note card with draft auto-save & recent-notes picker behind a single knowledge FAB, and git-based sync with auto-commit. Mounts via the official dsh plugin system — no DSH source changes.",
-  "version": "0.16.20",
+  "version": "0.16.21",
   "type": "module",
   "keywords": [
     "dsh",

package/src/client/index.ts

@@ -24,6 +24,7 @@ import { mountSessionSummaryView } from './session-summary.ts'
 import { disposeEditorPopup } from './editor-popup.ts'
 import { SettingsSection } from './settings-page.ts'
 import { registerToolViews, installWikiLinkInterceptor } from './tool-views.ts'
+import { mountRightbarTab, type RightbarSlotsFace } from './rightbar-tab.ts'
 
 /** Client plugin name. */
 export const name = 'dsh-tiddlywiki/client'
@@ -40,9 +41,16 @@ interface ClientContextFace {
       component: unknown,
     ): () => void
   }
+  /** Optional service read without the inject requirement (cordis ctx.get). */
+  get?: (name: string) => unknown
   effect?(fn: () => unknown, label?: string): void
 }
 
+/** Structural face over the rightbar tab registry (dsh-client-ui-sidebar-right). */
+interface SidebarRightTabsFace {
+  register(definition: unknown): () => void
+}
+
 /**
  * Client entry: installs styles and mounts the DOM seats + settings page.
  * @param ctx - the cordis client context.
@@ -91,6 +99,34 @@ export function apply(ctx: ClientContextFace): void {
       // DOM failures degrade the plugin, never the GUI.
       console.error('[dsh-tiddlywiki] mount failed:', error)
     }
+    try {
+      // 右侧边栏（DSH new rightbar）集成：可选挂载——仅当
+      // dsh-client-ui-sidebar-right 提供了 sidebarRightTabs 服务时才启用
+      // （老版本 DSH / 无右侧栏时静默跳过，插件其余功能不受影响）。注册 TW
+      // tab 类型 + guide 首页入口盒；由 ui.showRightbarTab 控制（默认开）。
+      let retryTimer: number | undefined
+      const tryMountRightbar = (attempt: number): void => {
+        const tabs = ctx.get?.('sidebarRightTabs') as SidebarRightTabsFace | undefined
+        if (tabs === undefined) {
+          // rightbar 插件可能在本次 apply 之后才就绪：有限重试几次即可。
+          if (attempt < 6 && !clientDisposed) {
+            retryTimer = window.setTimeout(() => tryMountRightbar(attempt + 1), 500 * (attempt + 1))
+          }
+          return
+        }
+        void fetchUiConfig().then((cfg) => {
+          if (clientDisposed) return
+          if (!cfg.showRightbarTab) return
+          const removeRightbar = mountRightbarTab(tabs, ctx.slots as unknown as RightbarSlotsFace)
+          if (removeRightbar !== undefined) disposers.push(removeRightbar)
+        })
+      }
+      tryMountRightbar(0)
+      disposers.push(() => { if (retryTimer !== undefined) window.clearTimeout(retryTimer) })
+    } catch (error) {
+      // 右侧栏集成失败只影响该功能本身，绝不让整个插件挂掉。
+      console.error('[dsh-tiddlywiki] rightbar mount failed:', error)
+    }
     try {
       // Reply-stream native tool cards: keyed `tool.call.toolview` slots for
       // every tiddlywiki_* tool (additive — our keys are unclaimed).

package/src/client/panel.ts

@@ -23,6 +23,7 @@
 import type { PanelState } from './state.ts'
 import { ENTRY_SELECTOR } from './sidebar-entry.ts'
 import { attachThemeSync, setThemeSyncConfig } from './theme-sync.ts'
+import { openTiddlerInRightbar } from './rightbar-tab.ts'
 
 export const PANEL_RELOAD_EVENT = 'dsh-tw-panel-reload'
 
@@ -316,6 +317,9 @@ export function mountPanel(state: PanelState): () => void {
     const detail = (event as CustomEvent).detail as { title?: unknown } | undefined
     const title = typeof detail?.title === 'string' && detail.title.length > 0 ? detail.title : ''
     if (title.length === 0) return
+    // 右侧栏的 TW tab 可见时，链接直接在那里打开（与聊天并排）；否则退回
+    // 中央面板。互斥由 rightbar-tab 的 dsh-panel-activate 协议保证。
+    if (openTiddlerInRightbar(title)) return
     pendingHash = `#${encodeURIComponent(title)}`
     state.openPanel()
     applyPendingHash()

package/src/client/rightbar-tab.ts

@@ -0,0 +1,440 @@
+/**
+ * Right-Sidebar TiddlyWiki tab type (v0.17.0).
+ *
+ * DSH's new right column (dsh-client-ui-sidebar-right) lets plugins register
+ * "tab types": stage 1 registers the type into `ctx.sidebarRightTabs` — a
+ * guide entry box on the rightbar's home page is the entry point — and stage 2
+ * registers the tab's React body into the keyed `sidebar.right.pane.tab` seat
+ * under the definition's id. This module does both, guarded at the call site:
+ * the whole integration is optional (older DSH / rightbar absent → no-op).
+ *
+ * The body embeds the SAME-ORIGIN TW proxy (`/dsh-tiddlywiki/tw/`) in an
+ * iframe, exactly like the center-column panel. One TW client at a time is
+ * enforced: when this tab becomes visible the center overlay (and any sibling
+ * overlay panel) closes via the existing `dsh-panel-activate` protocol, and
+ * when another panel activates this tab closes itself. Wiki links in the reply
+ * stream route here while the tab is visible (see panel.ts openTiddler).
+ *
+ * The tab body is React only because the slot runtime renders React: the frame
+ * is plain DOM built inside a ref host, mirroring the plugin's DOM style.
+ *
+ * @module dsh-tiddlywiki/client/rightbar-tab
+ */
+import * as React from 'react'
+import { STATUS_ENDPOINT } from './endpoints.ts'
+import { attachThemeSync, setThemeSyncConfig } from './theme-sync.ts'
+
+/** The tab kind this package owns; what `openTab` names and the guide entry opens. */
+export const TW_RIGHTBAR_KIND = 'dsh-tiddlywiki'
+/** This implementation's identity in the tab system: the key its body registers under. */
+export const TW_RIGHTBAR_ID = 'dsh-tiddlywiki'
+/** Activation-event name for THIS tab (distinct from the center panel's 'dsh-tiddlywiki'). */
+const RIGHTBAR_PANEL_NAME = 'dsh-tiddlywiki/rightbar'
+/** Cross-plugin activation event; detail is the activating panel name. */
+const ACTIVATE_EVENT = 'dsh-panel-activate'
+/** The "知识库" FAB's reload event; the rightbar frame reloads with the center one. */
+const PANEL_RELOAD_EVENT = 'dsh-tw-panel-reload'
+
+const RESTART_ENDPOINT = '/dsh-tiddlywiki/restart'
+
+/** Tab chip / guide copy default (label refreshed from `/status` ui.tabLabel). */
+let rightbarLabel = '知识库'
+
+/** Update the tab chip label from the live config (ui.tabLabel). */
+function setLabel(label: string): void {
+  const trimmed = typeof label === 'string' ? label.trim() : ''
+  if (trimmed.length > 0) rightbarLabel = trimmed
+}
+
+/* ── structural faces over the rightbar contract (no @deepseek-ai imports) ── */
+
+interface RightbarTabInfo {
+  sidebar: { expanded: boolean; fullscreen: boolean }
+  panel: { id: string }
+  tab: {
+    id: string
+    contentId: string
+    visible: boolean
+    navigation: { address: string; params?: unknown; revision: number }
+    signal: AbortSignal
+    actions: { close(): void; openTab?(kind: string, options?: unknown): void }
+  }
+}
+
+type UseRightbarTabInfo = () => RightbarTabInfo
+
+export interface RightbarTabBodyProps {
+  useTabInfo: UseRightbarTabInfo
+  sessionId?: string
+}
+
+/** The slot-registry face this module needs (keyed seats register by `key`). */
+export interface RightbarSlotsFace {
+  inject(name: string, callback: () => unknown): (() => void) | undefined
+  register(
+    opts: { name: string; key?: string; id?: string; order?: number; label?: string | (() => string) },
+    component: unknown,
+  ): () => void
+}
+
+interface StatusPayload {
+  ok?: boolean
+  status: string
+  url?: string
+  /** Same-origin TW proxy path (e.g. /dsh-tiddlywiki/tw/); the iframe base. */
+  twProxy?: string
+  wikiPath?: string
+  error?: string
+  ui?: { followDshTheme?: boolean; darkPalette?: string; tabLabel?: string }
+}
+
+async function fetchStatus(): Promise<StatusPayload | null> {
+  try {
+    const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(8_000) })
+    if (!res.ok) return null
+    return (await res.json()) as StatusPayload
+  } catch {
+    return null
+  }
+}
+
+async function requestRestart(): Promise<boolean> {
+  try {
+    const res = await fetch(RESTART_ENDPOINT, { method: 'POST', signal: AbortSignal.timeout(8_000) })
+    return res.ok
+  } catch {
+    return false
+  }
+}
+
+/** Guide entry glyph: a wiki page with a TiddlyWiki-style "T" (same as the entry). */
+function GuideIcon({ size = 16, className }: { size?: number; className?: string }): React.ReactElement {
+  return React.createElement(
+    'svg',
+    { width: size, height: size, className, viewBox: '0 0 16 16', fill: 'none', stroke: 'currentColor', strokeWidth: 1.3, strokeLinecap: 'round', strokeLinejoin: 'round', 'aria-hidden': true },
+    React.createElement('path', { d: 'M4 2.5h8a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-9a1 1 0 0 1 1-1z' }),
+    React.createElement('path', { d: 'M6 6h4M6 8.5h2.5' }),
+  )
+}
+
+/** The plain-DOM TW frame controller owned by the React body. */
+interface FrameController {
+  /** Reflect the tab's visibility; loads lazily on the first show. */
+  setVisible(visible: boolean): void
+  isVisible(): boolean
+  /** Open a tiddler by title; false when this controller cannot serve it. */
+  openTiddler(title: string): boolean
+  dispose(): void
+}
+
+/** Live controller handle for center-panel link routing (openTiddlerInRightbar). */
+let liveFrame: FrameController | undefined
+
+/**
+ * Ask the live rightbar TW tab to open a tiddler. False when no visible tab
+ * is there, so the center panel handles the request as before.
+ */
+export function openTiddlerInRightbar(title: string): boolean {
+  if (liveFrame === undefined) return false
+  return liveFrame.openTiddler(title)
+}
+
+function createFrameController(host: HTMLElement, signal: AbortSignal): FrameController {
+  let visible = false
+  let started = false
+  let disposed = false
+  let refreshTimer: number | undefined
+  let refreshAttempts = 0
+  let frameLoaded = false
+  let pendingHash: string | null = null
+  let themeSyncDispose: (() => void) | undefined
+
+  const view = document.createElement('div')
+  view.className = 'dsh-tw-rightbar-view'
+
+  const frameArea = document.createElement('div')
+  frameArea.className = 'dsh-tw-rightbar-frame-wrap'
+  const frame = document.createElement('iframe')
+  frame.className = 'dsh-tw-rightbar-frame'
+  frame.title = 'TiddlyWiki'
+  frame.hidden = true
+  frameArea.append(frame)
+
+  const errorArea = document.createElement('div')
+  errorArea.className = 'dsh-tw-rightbar-error'
+  errorArea.hidden = true
+
+  view.append(frameArea, errorArea)
+  host.append(view)
+
+  frame.addEventListener('load', () => {
+    frameLoaded = true
+    applyPendingHash()
+  })
+  themeSyncDispose = attachThemeSync(frame)
+
+  const showError = (message: string): void => {
+    frame.hidden = true
+    errorArea.hidden = false
+    errorArea.replaceChildren()
+    const p = document.createElement('div')
+    p.textContent = 'TiddlyWiki 服务不可用'
+    const code = document.createElement('code')
+    code.textContent = message
+    const retry = document.createElement('button')
+    retry.type = 'button'
+    retry.textContent = '重试'
+    retry.addEventListener('click', () => {
+      retry.disabled = true
+      retry.textContent = '重启中…'
+      void requestRestart().finally(() => { void doRefresh() })
+    })
+    errorArea.append(p, code, retry)
+  }
+
+  const showStarting = (): void => {
+    frame.hidden = true
+    errorArea.hidden = false
+    errorArea.replaceChildren()
+    const p = document.createElement('div')
+    p.textContent = 'TiddlyWiki 服务正在启动…'
+    errorArea.append(p)
+  }
+
+  const showFrame = (url: string): void => {
+    errorArea.hidden = true
+    // Only reveal the frame while the tab is on screen.
+    frame.hidden = !visible
+    // Set the src only when the url changed, so an editor never loses unsaved
+    // state on a status refresh.
+    if (frame.dataset.loaded !== url) {
+      frame.dataset.loaded = url
+      frameLoaded = false
+      frame.src = url
+    }
+  }
+
+  /** Apply a pending tiddler-hash once the frame is ready (see panel.ts). */
+  const applyPendingHash = (): void => {
+    if (pendingHash === null || !frameLoaded) return
+    const hash = pendingHash
+    const win = frame.contentWindow
+    if (win === null) {
+      fallbackLoad(hash)
+      return
+    }
+    const tryOnce = (attempt: number): void => {
+      if (disposed) return
+      if (pendingHash !== hash) return
+      const frameTw = win as { $tw?: unknown }
+      if (typeof frameTw.$tw !== 'object' || frameTw.$tw === null) {
+        if (attempt < 40) {
+          window.setTimeout(() => tryOnce(attempt + 1), 150)
+          return
+        }
+        fallbackLoad(hash)
+        return
+      }
+      pendingHash = null
+      try {
+        if (win.location.hash !== hash) win.location.hash = hash
+      } catch {
+        fallbackLoad(hash)
+      }
+    }
+    tryOnce(0)
+  }
+
+  const fallbackLoad = (hash: string): void => {
+    if (disposed) return
+    if (pendingHash === hash) pendingHash = null
+    const base = frame.src.split('#')[0]
+    if (frame.src !== `${base}${hash}`) frame.src = `${base}${hash}`
+  }
+
+  const doRefresh = async (): Promise<void> => {
+    if (refreshTimer !== undefined) {
+      window.clearTimeout(refreshTimer)
+      refreshTimer = undefined
+    }
+    const payload = await fetchStatus()
+    if (disposed) return
+    if (payload === null) {
+      showError('无法访问 /dsh-tiddlywiki/status')
+      return
+    }
+    if (payload.ui !== undefined) {
+      setLabel(payload.ui.tabLabel ?? rightbarLabel)
+      setThemeSyncConfig({
+        enabled: payload.ui.followDshTheme !== false,
+        darkPalette: payload.ui.darkPalette,
+      })
+    }
+    if (payload.status === 'running') {
+      refreshAttempts = 0
+      if (typeof payload.twProxy === 'string') {
+        showFrame(new URL(payload.twProxy, window.location.origin).href)
+      } else if (typeof payload.url === 'string') {
+        showFrame(payload.url)
+      } else {
+        showError('服务未返回编辑器地址')
+      }
+      return
+    }
+    if (payload.status === 'starting') {
+      showStarting()
+      if (refreshAttempts < 30) {
+        refreshAttempts++
+        refreshTimer = window.setTimeout(() => { void doRefresh() }, 1_500)
+      }
+      return
+    }
+    refreshAttempts = 0
+    showError(payload.error ?? `服务状态：${payload.status}`)
+  }
+
+  const onReloadRequest = (): void => {
+    if (!frame.hidden) frame.src = frame.src
+  }
+  document.addEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
+
+  const onAbort = (): void => controller.dispose()
+  signal.addEventListener('abort', onAbort, { once: true })
+
+  const controller: FrameController = {
+    setVisible(next: boolean): void {
+      visible = next
+      if (!started) {
+        // Nothing loaded yet: stay hidden until the first show kicks the load.
+        frame.hidden = true
+        view.dataset.visible = next ? '1' : '0'
+        if (next) {
+          started = true
+          void doRefresh()
+        }
+        return
+      }
+      frame.hidden = !next
+      view.dataset.visible = next ? '1' : '0'
+    },
+    isVisible(): boolean {
+      return visible
+    },
+    openTiddler(title: string): boolean {
+      if (disposed || !visible) return false
+      pendingHash = `#${encodeURIComponent(title)}`
+      if (!started) {
+        started = true
+        void doRefresh()
+      } else {
+        applyPendingHash()
+      }
+      return true
+    },
+    dispose(): void {
+      if (disposed) return
+      disposed = true
+      if (liveFrame === controller) liveFrame = undefined
+      document.removeEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
+      signal.removeEventListener('abort', onAbort)
+      if (refreshTimer !== undefined) window.clearTimeout(refreshTimer)
+      themeSyncDispose?.()
+      view.remove()
+    },
+  }
+  return controller
+}
+
+/**
+ * The tab body (stage 2): a thin React wrapper that mounts the TW iframe into
+ * a plain-DOM host. One mount per tab record; mutual exclusion rides the
+ * `dsh-panel-activate` protocol both ways.
+ */
+export function TwRightbarTabBody(props: RightbarTabBodyProps): React.ReactElement {
+  const { useTabInfo } = props
+  const info = useTabInfo()
+  const tab = info.tab
+  const hostRef = React.useRef<HTMLDivElement | null>(null)
+  const controllerRef = React.useRef<FrameController | null>(null)
+
+  React.useEffect(() => {
+    const host = hostRef.current
+    if (host === null) return
+    const controller = createFrameController(host, tab.signal)
+    controllerRef.current = controller
+    liveFrame = controller
+    return () => {
+      controller.dispose()
+      controllerRef.current = null
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- one controller per tab record (id + signal are stable per occurrence).
+  }, [tab.id, tab.signal])
+
+  React.useEffect(() => {
+    controllerRef.current?.setVisible(tab.visible)
+  }, [tab.visible])
+
+  // When this tab becomes visible, close the center overlay / sibling panels.
+  // When any OTHER panel activates, close this tab (symmetry → one TW client).
+  const visible = tab.visible
+  const close = tab.actions.close
+  React.useEffect(() => {
+    if (!visible) return
+    document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: RIGHTBAR_PANEL_NAME }))
+    const onActivate = (event: Event): void => {
+      const detail = (event as CustomEvent).detail
+      if (detail !== RIGHTBAR_PANEL_NAME) close()
+    }
+    document.addEventListener(ACTIVATE_EVENT, onActivate)
+    return () => document.removeEventListener(ACTIVATE_EVENT, onActivate)
+  }, [visible, close])
+
+  return React.createElement('div', { ref: hostRef, className: 'dsh-tw-rightbar-tab', 'data-dsh-tw-rightbar': '' })
+}
+
+/** The tab definition (stage 1): a page type opened by kind, with a guide entry box. */
+export function rightbarDefinition(): Record<string, unknown> {
+  return {
+    id: TW_RIGHTBAR_ID,
+    kind: TW_RIGHTBAR_KIND,
+    title: (): string => rightbarLabel,
+    guide: [
+      {
+        order: 10,
+        title: (): string => 'TiddlyWiki 知识库',
+        description: (): string => '在右侧边栏打开 TiddlyWiki 编辑器（与聊天并排）',
+        icon: GuideIcon,
+      },
+    ],
+  }
+}
+
+/**
+ * Mount the rightbar integration for the caller's lifetime: register the type
+ * and the body seat. Call only when `sidebarRightTabs` is actually available.
+ */
+export function mountRightbarTab(
+  tabs: { register(definition: unknown): () => void },
+  slots: RightbarSlotsFace,
+): (() => void) | undefined {
+  const disposers: Array<() => void> = []
+  try {
+    disposers.push(tabs.register(rightbarDefinition()))
+    const removeBody = slots.inject('sidebar.right.pane.tab', () =>
+      slots.register({ name: 'sidebar.right.pane.tab', key: TW_RIGHTBAR_ID }, TwRightbarTabBody),
+    )
+    if (removeBody !== undefined) disposers.push(removeBody)
+  } catch (error) {
+    for (const dispose of disposers.splice(0)) dispose()
+    console.error('[dsh-tiddlywiki] rightbar tab mount failed:', error)
+    return undefined
+  }
+  // Warm the chip label from the live config (ui.tabLabel) so the first open
+  // already shows the right name; the frame refreshes it on every status call.
+  void fetchStatus().then((payload) => {
+    if (payload?.ui !== undefined) setLabel(payload.ui.tabLabel ?? rightbarLabel)
+  })
+  return () => {
+    for (const dispose of disposers.splice(0)) dispose()
+  }
+}

package/src/client/settings-page.ts

@@ -254,6 +254,7 @@ function renderConfigSection(body: HTMLElement, config: Record<string, unknown>,
   textField('ui.darkPalette', '暗色时 TW palette（tiddler 标题）', typeof ui.darkPalette === 'string' && ui.darkPalette.trim().length > 0 ? ui.darkPalette.trim() : '$:/palettes/CupertinoDark')
   textField('ui.tabLabel', '会话顶部「知识库」Tab 名称', typeof ui.tabLabel === 'string' && ui.tabLabel.trim().length > 0 ? ui.tabLabel.trim() : '知识库')
   checkField('ui.showSessionTab', '显示会话顶部「知识库」Tab（本会话相关 wiki 笔记汇总）', ui.showSessionTab !== false)
+  checkField('ui.showRightbarTab', '在 DSH 右侧边栏提供 TiddlyWiki 入口/Tab（与聊天并排）', ui.showRightbarTab !== false)
   const sendToAgent = (ui.sendToAgent ?? {}) as Record<string, unknown>
   checkField('ui.sendToAgent.enabled', '启用「发送给 Agent」（TW 笔记 → DSH 会话注入）', sendToAgent.enabled !== false)
   textField('ui.sendToAgent.endpoint', 'TW 端请求基址（空=自动取当前 DSH origin）', typeof sendToAgent.endpoint === 'string' ? sendToAgent.endpoint : '')

package/src/client/styles.ts

@@ -69,6 +69,33 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 .dsh-tw-panel-error button:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); }
 .dsh-tw-panel-error code { font-size: 11px; opacity: .8; max-width: 80%; overflow-wrap: anywhere; }
 
+/* ── right-sidebar tab (DSH new rightbar) ──────────────────────
+   The React body host fills the rightbar pane; the TW iframe lives inside
+   it and follows the DSH theme like the center-column panel. */
+.dsh-tw-rightbar-tab {
+  position: relative; display: flex; flex-direction: column;
+  width: 100%; height: 100%; min-height: 0; box-sizing: border-box;
+  background: var(--dsw-alias-bg-layer-1, var(--dsw-bg, #fff));
+}
+.dsh-tw-rightbar-view { flex: 1; min-height: 0; display: flex; flex-direction: column; }
+.dsh-tw-rightbar-frame-wrap { flex: 1; min-height: 0; display: flex; flex-direction: column; }
+.dsh-tw-rightbar-frame {
+  flex: 1; min-height: 0; border: 0; width: 100%; display: block;
+  background: var(--dsw-alias-bg-layer-1, #fff);
+}
+.dsh-tw-rightbar-frame[hidden],
+.dsh-tw-rightbar-error[hidden] { display: none !important; }
+.dsh-tw-rightbar-error {
+  flex: 1; display: flex; flex-direction: column; align-items: center; justify-content: center;
+  gap: 10px; color: var(--dsw-alias-label-secondary, #666); font-size: 13px; text-align: center; padding: 20px;
+}
+.dsh-tw-rightbar-error button {
+  border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,.25)); background: transparent;
+  color: inherit; font: inherit; padding: 6px 14px; border-radius: 8px; cursor: pointer;
+}
+.dsh-tw-rightbar-error button:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); }
+.dsh-tw-rightbar-error code { font-size: 11px; opacity: .8; max-width: 80%; overflow-wrap: anywhere; }
+
 /* ── floating quick-note widget ────────────────────────────────
    Positioned ABOVE the shutdown launcher FAB (fixed right:24 bottom:24,
    z-index 900, 46px) and BELOW its confirm overlay (z-index 1000).

package/src/client/ui-config.ts

@@ -24,9 +24,11 @@ export interface UiConfig {
   tabLabel: string
   /** 是否在会话顶部显示「知识库」Tab（会话相关 wiki 汇总，默认 true）。 */
   showSessionTab: boolean
+  /** 是否在 DSH 右侧边栏提供 TiddlyWiki 入口/Tab（默认 true）。 */
+  showRightbarTab: boolean
 }
 
-const FALLBACK: UiConfig = { showQuickNoteDock: true, quickNoteMode: 'native', sidebarLabel: 'TiddlyWiki', tabLabel: '知识库', showSessionTab: true }
+const FALLBACK: UiConfig = { showQuickNoteDock: true, quickNoteMode: 'native', sidebarLabel: 'TiddlyWiki', tabLabel: '知识库', showSessionTab: true, showRightbarTab: true }
 
 const CACHE_TTL_MS = 15_000
 let cache: { at: number; value: UiConfig } | undefined
@@ -41,7 +43,7 @@ export async function fetchUiConfig(opts: { force?: boolean } = {}): Promise<UiC
   try {
     const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(5_000) })
     if (!res.ok) return FALLBACK
-    const p = (await res.json()) as { ui?: { showQuickNoteDock?: boolean; quickNoteMode?: 'native' | 'card'; sidebarLabel?: string; tabLabel?: string; showSessionTab?: boolean } }
+    const p = (await res.json()) as { ui?: { showQuickNoteDock?: boolean; quickNoteMode?: 'native' | 'card'; sidebarLabel?: string; tabLabel?: string; showSessionTab?: boolean; showRightbarTab?: boolean } }
     const value: UiConfig = {
       showQuickNoteDock: p.ui?.showQuickNoteDock !== false,
       quickNoteMode: p.ui?.quickNoteMode === 'card' ? 'card' : 'native',
@@ -52,6 +54,7 @@ export async function fetchUiConfig(opts: { force?: boolean } = {}): Promise<UiC
         ? p.ui.tabLabel.trim()
         : '知识库',
       showSessionTab: p.ui?.showSessionTab !== false,
+      showRightbarTab: p.ui?.showRightbarTab !== false,
     }
     cache = { at: Date.now(), value }
     return value

package/src/host/config.ts

@@ -81,6 +81,13 @@ export interface PluginConfigShape {
     tabLabel?: string
     /** 是否在会话顶部显示「知识库」Tab（会话相关 wiki 汇总，默认 true）。 */
     showSessionTab?: boolean
+    /**
+     * 是否在 DSH 右侧边栏（new rightbar）提供 TiddlyWiki 入口/Tab（默认
+     * true）：在 rightbar 首页（guide 页）注册「TiddlyWiki 知识库」入口盒，
+     * 点击即在右侧栏以 tab 形式打开完整 TW 编辑器（与聊天并排）。老版本
+     * DSH 无 rightbar 时该配置不生效（客户端自动跳过）。
+     */
+    showRightbarTab?: boolean
   }
   uiLanguage?: string
   [key: string]: unknown

package/src/host/routes.ts

@@ -151,6 +151,8 @@ export interface UiDefaultsPublic {
   tabLabel: string
   /** 是否在会话顶部显示「知识库」Tab（会话相关 wiki 汇总，默认 true）。 */
   showSessionTab: boolean
+  /** 是否在 DSH 右侧边栏提供 TiddlyWiki 入口/Tab（默认 true）。 */
+  showRightbarTab: boolean
 }
 
 export interface RouteDeps {

package/src/index.ts

@@ -66,7 +66,7 @@ export interface TiddlywikiConfig {
   port?: number
   git?: { autoCommit?: boolean; debounceMs?: number; remote?: string; branch?: string }
   note?: { tag?: string }
-  ui?: { showQuickNote?: boolean; showQuickNoteDock?: boolean; quickNoteMode?: 'native' | 'card'; sidebarLabel?: string; showPanelStatus?: boolean; showSyncButton?: boolean; followDshTheme?: boolean; darkPalette?: string; tabLabel?: string; showSessionTab?: boolean; sendToAgent?: { enabled?: boolean; endpoint?: string; token?: string }; allArticles?: { pageSize?: number } }
+  ui?: { showQuickNote?: boolean; showQuickNoteDock?: boolean; quickNoteMode?: 'native' | 'card'; sidebarLabel?: string; showPanelStatus?: boolean; showSyncButton?: boolean; followDshTheme?: boolean; darkPalette?: string; tabLabel?: string; showSessionTab?: boolean; showRightbarTab?: boolean; sendToAgent?: { enabled?: boolean; endpoint?: string; token?: string }; allArticles?: { pageSize?: number } }
   /** 启动时自动启用的 TW 语言代码（如 "zh-Hans"），也受配置 tiddler 覆盖。 */
   uiLanguage?: string
   auth?: { username?: string; password?: string }
@@ -89,7 +89,7 @@ interface ResolvedConfig {
   port: number
   git: { autoCommit: boolean; debounceMs: number; remote: string; branch: string }
   note: { tag: string }
-  ui: { showQuickNote: boolean; showQuickNoteDock: boolean; quickNoteMode: 'native' | 'card'; sidebarLabel: string; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string; tabLabel: string; showSessionTab: boolean; sendToAgent: { enabled: boolean; endpoint?: string; token?: string }; allArticles: { pageSize: number } }
+  ui: { showQuickNote: boolean; showQuickNoteDock: boolean; quickNoteMode: 'native' | 'card'; sidebarLabel: string; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string; tabLabel: string; showSessionTab: boolean; showRightbarTab: boolean; sendToAgent: { enabled: boolean; endpoint?: string; token?: string }; allArticles: { pageSize: number } }
   uiLanguage: string
   auth: { username?: string; password?: string }
 }
@@ -100,7 +100,7 @@ const DEFAULTS: ResolvedConfig = {
   port: 0,
   git: { autoCommit: true, debounceMs: 60_000, remote: '', branch: 'main' },
   note: { tag: 'inbox' },
-  ui: { showQuickNote: true, showQuickNoteDock: true, quickNoteMode: 'native', sidebarLabel: 'TiddlyWiki', showPanelStatus: true, showSyncButton: true, followDshTheme: true, darkPalette: DARK_PALETTE_DEFAULT, tabLabel: '知识库', showSessionTab: true, sendToAgent: { enabled: true }, allArticles: { pageSize: 10 } },
+  ui: { showQuickNote: true, showQuickNoteDock: true, quickNoteMode: 'native', sidebarLabel: 'TiddlyWiki', showPanelStatus: true, showSyncButton: true, followDshTheme: true, darkPalette: DARK_PALETTE_DEFAULT, tabLabel: '知识库', showSessionTab: true, showRightbarTab: true, sendToAgent: { enabled: true }, allArticles: { pageSize: 10 } },
   uiLanguage: '',
   auth: { username: '', password: '' },
 }
@@ -259,7 +259,7 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
     const tag = eff().note?.tag
     return typeof tag === 'string' && tag.trim().length > 0 ? tag : config.note.tag
   }
-  const effectiveUi = (): { showQuickNote: boolean; showQuickNoteDock: boolean; quickNoteMode: 'native' | 'card'; sidebarLabel: string; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string; tabLabel: string; showSessionTab: boolean } => {
+  const effectiveUi = (): { showQuickNote: boolean; showQuickNoteDock: boolean; quickNoteMode: 'native' | 'card'; sidebarLabel: string; showPanelStatus: boolean; showSyncButton: boolean; followDshTheme: boolean; darkPalette: string; tabLabel: string; showSessionTab: boolean; showRightbarTab: boolean } => {
     const ui = eff().ui ?? {}
     const palette = typeof ui.darkPalette === 'string' && ui.darkPalette.trim().length > 0 ? ui.darkPalette.trim() : DARK_PALETTE_DEFAULT
     const label = typeof ui.sidebarLabel === 'string' && ui.sidebarLabel.trim().length > 0 ? ui.sidebarLabel.trim() : config.ui.sidebarLabel
@@ -276,6 +276,7 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
       darkPalette: palette,
       tabLabel,
       showSessionTab: ui.showSessionTab !== false,
+      showRightbarTab: ui.showRightbarTab !== false,
     }
   }