dsh-tiddlywiki 0.16.2 → 0.16.4

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.2",
+  "version": "0.16.4",
   "type": "module",
   "keywords": [
     "dsh",

package/src/client/index.ts

@@ -18,6 +18,8 @@ import { mountPanel } from './panel.ts'
 import { createNoteWidget } from './note-widget.ts'
 import { createSyncController } from './sync-button.ts'
 import { mountKnowledgeFab } from './knowledge-fab.ts'
+import { createQuickNoteDock } from './quick-note-dock.ts'
+import { fetchUiConfig } from './ui-config.ts'
 import { disposeEditorPopup } from './editor-popup.ts'
 import { SettingsSection } from './settings-page.ts'
 import { registerToolViews, installWikiLinkInterceptor } from './tool-views.ts'
@@ -49,6 +51,7 @@ export function apply(ctx: ClientContextFace): void {
     injectStyles()
     const state = new PanelState()
     const disposers: Array<() => void> = []
+    let clientDisposed = false
     try {
       // v0.5: the quick-note card and the sync logic are owned by controllers;
       // the single "知识库" FAB drives them (three old floating controls merged).
@@ -60,6 +63,22 @@ export function apply(ctx: ClientContextFace): void {
       disposers.push(mountPanel(state))
       disposers.push(mountKnowledgeFab(state, note, sync))
       disposers.push(disposeEditorPopup)
+      // 输入框上方「快速笔记」快捷按钮（conversation.input.dock 槽位）。该槽位
+      // 是官方为「输入框上方的全宽条目」预留的挂载点，todo/cost-meter/goal/
+      // queue/git-graph 等插件内容都渲染在这里、按纵向 flex 排列，天然不重叠。
+      // 由 ui.showQuickNoteDock 配置控制（默认开）。
+      if (ctx.slots !== undefined) {
+        void fetchUiConfig().then((cfg) => {
+          if (clientDisposed || !cfg.showQuickNoteDock) return
+          const removeDock = ctx.slots?.inject('conversation.input.dock', () =>
+            ctx.slots?.register(
+              { name: 'conversation.input.dock', id: 'quick-note', order: 8, label: '快速笔记' },
+              createQuickNoteDock(note),
+            ),
+          )
+          if (removeDock !== undefined) disposers.push(removeDock)
+        })
+      }
     } catch (error) {
       // DOM failures degrade the plugin, never the GUI.
       console.error('[dsh-tiddlywiki] mount failed:', error)
@@ -90,6 +109,7 @@ export function apply(ctx: ClientContextFace): void {
       console.error('[dsh-tiddlywiki] settings section failed:', error)
     }
     ctx.effect?.(() => () => {
+      clientDisposed = true
       for (const dispose of disposers.splice(0)) dispose()
     }, 'dsh-tiddlywiki: client mount')
   } catch (error) {

package/src/client/knowledge-fab.ts

@@ -5,11 +5,13 @@
  *
  * - The FAB carries a live git status dot (from SyncController).
  * - The menu (opens upward) exposes, gated by the same ui.* settings:
- *     · TW service status line + git status line
+ *     · TW 服务状态行（一行；悬停弹出详细状态 tip，含 git 状态与最近日志）
  *     · 📝 快速笔记   (if ui.showQuickNote)  → opens the note card
  *     · 🖥 打开/收起 TW 面板 (if ui.showPanelStatus) → toggles the center panel
  *     · 🔄 重载 TW 面板 (if ui.showPanelStatus) → reloads the panel iframe
  *     · 🔁 同步       (if ui.showSyncButton)  → pull→commit→push
+ * - 旧版菜单里的第二行（git/知识库状态行）已去掉：git 状态由 FAB 上的状态点
+ *   展示，详细内容并入 TW 状态行的悬停 tip。
  * - When ALL three ui flags are off, no DOM is created.
  *
  * @module dsh-tiddlywiki/client/knowledge-fab
@@ -40,17 +42,21 @@ async function fetchUiFlags(): Promise<UiFlags> {
   }
 }
 
-/** Fetch the TW service health for the menu's status line. */
-async function fetchTwStatus(): Promise<{ state: string; text: string }> {
+/** TW service health snapshot for the menu's status line + hover tip. */
+interface TwHealth { state: string; text: string; logs: string[] }
+
+/** Fetch the TW service health (state line text + recent logs for the tip). */
+async function fetchTwHealth(): Promise<TwHealth> {
   try {
     const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(8_000) })
-    if (!res.ok) return { state: 'failed', text: '状态不可达' }
-    const p = (await res.json()) as { status?: string; url?: string; error?: string }
-    if (p.status === 'running') return { state: 'running', text: `TW 在线 · ${p.url ?? ''}` }
-    if (p.status === 'starting') return { state: 'starting', text: 'TW 启动中…' }
-    return { state: 'failed', text: p.error ?? `TW 状态：${p.status ?? '?'}` }
+    if (!res.ok) return { state: 'failed', text: '状态不可达', logs: [] }
+    const p = (await res.json()) as { status?: string; url?: string; error?: string; logs?: string[] }
+    const logs = Array.isArray(p.logs) ? p.logs.filter((l): l is string => typeof l === 'string') : []
+    if (p.status === 'running') return { state: 'running', text: `TW 在线 · ${p.url ?? ''}`, logs }
+    if (p.status === 'starting') return { state: 'starting', text: 'TW 启动中…', logs }
+    return { state: 'failed', text: p.error ?? `TW 状态：${p.status ?? '?'}`, logs }
   } catch {
-    return { state: 'failed', text: '状态不可达' }
+    return { state: 'failed', text: '状态不可达', logs: [] }
   }
 }
 
@@ -66,31 +72,45 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
   let menu: HTMLDivElement | undefined
   let twStatusEl: HTMLSpanElement | undefined
   let twDot: HTMLSpanElement | undefined
+  let tip: HTMLDivElement | undefined
   let panelLabel: HTMLSpanElement | undefined
   let menuOpen = false
-  let gitRowDot: HTMLSpanElement | undefined
-  let gitRowText: HTMLSpanElement | undefined
+  /** Latest TW health snapshot, merged into the hover tip. */
+  let twHealth: TwHealth = { state: 'unknown', text: 'TiddlyWiki 服务…', logs: [] }
 
   const closeMenu = (): void => {
     menuOpen = false
     if (menu !== undefined) menu.hidden = true
+    if (tip !== undefined) tip.hidden = true
+  }
+
+  /** Rebuild the TW status row's hover tip (TW 服务 + git 状态 + 最近日志). */
+  const renderTip = (): void => {
+    if (tip === undefined) return
+    const lines: string[] = [`TiddlyWiki 服务：${twHealth.text}`]
+    lines.push(`知识库同步：${sync.getState().tooltip}`)
+    if (twHealth.logs.length > 0) {
+      lines.push('最近日志：')
+      lines.push(...twHealth.logs.slice(-3))
+    }
+    tip.textContent = lines.join('\n')
   }
 
-  /** Refresh the git dot + tooltip from the controller (FAB dot + menu row). */
+  /** Refresh the FAB git dot + its title tooltip (and the menu tip's git line). */
   const renderDot = (): void => {
     const s = sync.getState()
     if (dot !== undefined) dot.dataset.state = s.state
     if (fabBtn !== undefined) fabBtn.title = `知识库 · ${s.tooltip}`
-    if (gitRowDot !== undefined) gitRowDot.dataset.state = s.state
-    if (gitRowText !== undefined) gitRowText.textContent = s.tooltip
+    renderTip()
   }
 
   /** Refresh the TW service status line in the menu. */
   const refreshTwStatus = async (): Promise<void> => {
-    const info = await fetchTwStatus()
+    twHealth = await fetchTwHealth()
     if (disposed) return
-    if (twStatusEl !== undefined) twStatusEl.textContent = info.text
-    if (twDot !== undefined) twDot.dataset.state = info.state
+    if (twStatusEl !== undefined) twStatusEl.textContent = twHealth.text
+    if (twDot !== undefined) twDot.dataset.state = twHealth.state
+    renderTip()
   }
 
   const build = (flags: UiFlags): void => {
@@ -102,10 +122,11 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
     menu.className = 'dsh-tw-fab-menu'
     menu.hidden = true
 
-    // Status section (TW service + git).
+    // 状态区：仅保留一行 TW 服务状态（第二行 git 状态行已去掉，git 详情并入
+    // 这一行的悬停 tip；FAB 上的状态点仍展示 git 颜色）。
     if (flags.showPanelStatus) {
       const twRow = document.createElement('div')
-      twRow.className = 'dsh-tw-fab-status'
+      twRow.className = 'dsh-tw-fab-status dsh-tw-fab-status-tiprow'
       twDot = document.createElement('span')
       twDot.className = 'dsh-tw-fab-status-dot'
       twDot.dataset.state = 'unknown'
@@ -113,20 +134,20 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
       twStatusEl.className = 'dsh-tw-fab-status-text'
       twStatusEl.textContent = 'TiddlyWiki 服务…'
       twRow.append(twDot, twStatusEl)
+      // 悬停详细状态 tip（TW 服务 + git + 最近日志）。
+      tip = document.createElement('div')
+      tip.className = 'dsh-tw-fab-tip'
+      tip.hidden = true
+      twRow.append(tip)
+      twRow.addEventListener('mouseenter', () => {
+        renderTip()
+        if (tip !== undefined) tip.hidden = false
+      })
+      twRow.addEventListener('mouseleave', () => {
+        if (tip !== undefined) tip.hidden = true
+      })
       menu.append(twRow)
     }
-    if (flags.showSyncButton) {
-      const gitRow = document.createElement('div')
-      gitRow.className = 'dsh-tw-fab-status'
-      gitRowDot = document.createElement('span')
-      gitRowDot.className = 'dsh-tw-fab-status-dot'
-      gitRowDot.dataset.state = sync.getState().state
-      gitRowText = document.createElement('span')
-      gitRowText.className = 'dsh-tw-fab-status-text'
-      gitRowText.textContent = sync.getState().tooltip
-      gitRow.append(gitRowDot, gitRowText)
-      menu.append(gitRow)
-    }
 
     if (flags.showQuickNote) {
       const item = document.createElement('button')
@@ -135,7 +156,8 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
       item.textContent = '📝 快速笔记'
       item.addEventListener('click', () => {
         closeMenu()
-        void note.toggle()
+        // open-only：弹窗只能由卡片上的 ✕ 关闭，触发按钮不负责收起。
+        void note.open()
       })
       menu.append(item)
     }

package/src/client/note-widget.ts

@@ -324,6 +324,17 @@ export function createNoteWidget(): NoteWidgetHandle {
   let draftTimer: number | undefined
   let recentOpen = false
 
+  /**
+   * Broadcast the card's open/close state to the rest of the page (the input-
+   * dock quick-note button highlights while the card is open). Plain DOM
+   * CustomEvent — no shared service needed.
+   */
+  const emitState = (open: boolean): void => {
+    try {
+      window.dispatchEvent(new CustomEvent('dsh-tw-note-state', { detail: { open } }))
+    } catch { /* event dispatch is best-effort */ }
+  }
+
   const resetTitle = (): void => {
     if (ui !== undefined) ui.titleInput.value = timestampTitle()
   }
@@ -564,6 +575,7 @@ export function createNoteWidget(): NoteWidgetHandle {
       opened = false
       root.hidden = true
       closeRecent()
+      emitState(false)
     }
 
     const saveDone = (): void => {
@@ -651,14 +663,9 @@ export function createNoteWidget(): NoteWidgetHandle {
     editBtn.addEventListener('click', () => { void doEdit() })
     closeBtn.addEventListener('click', close)
 
-    // Clicking outside the card collapses it (but keeps the draft).
-    document.addEventListener('click', (event) => {
-      if (!opened) return
-      const target = event.target as Node
-      if (root.contains(target)) return
-      if (recentWrap.contains(target)) return
-      close()
-    }, true)
+    // 快速笔记弹窗只允许「手动点关闭按钮（✕）」关闭：刻意移除「点击卡片外部
+    // 即收起」的监听（用户反馈会误关、丢失正在编辑的内容）。草稿仍会防抖
+    // 自动保存，重开时原样恢复。
 
     // Discard draft (banner button).
     discardBtn.addEventListener('click', () => {
@@ -679,6 +686,7 @@ export function createNoteWidget(): NoteWidgetHandle {
       if (ui === undefined || opened) return
       opened = true
       ui.root.hidden = false
+      emitState(true)
       const draft = loadDraft()
       if (draft !== null && (draft.text.trim().length > 0 || draft.title.trim().length > 0)) {
         // Restore the autosaved draft (survives reload / accidental close).
@@ -698,6 +706,7 @@ export function createNoteWidget(): NoteWidgetHandle {
       opened = false
       ui.root.hidden = true
       closeRecent()
+      emitState(false)
     },
     async toggle() {
       if (opened) this.close()

package/src/client/quick-note-dock.ts

@@ -0,0 +1,54 @@
+/**
+ * Quick-note button above the chat input box (需求: 输入框上方快速笔记按钮).
+ *
+ * Registers into the shell's `conversation.input.dock` slot — the sanctioned
+ * "Full-width entries above the composer card" seat that sibling plugins
+ * (todo / cost-meter / goal / queue / git-graph) already use. Entries render as
+ * a flex column, so this strip stacks with theirs and can never overlap or
+ * occlude anything. Gated by `ui.showQuickNoteDock` (default on), honored at
+ * registration time in client/index.ts.
+ *
+ * Clicking opens the floating quick-note card (open-only; the card itself can
+ * only be dismissed with its ✕ button). While the card is open the button
+ * highlights, driven by the card's `dsh-tw-note-state` CustomEvent.
+ *
+ * @module dsh-tiddlywiki/client/quick-note-dock
+ */
+import * as React from 'react'
+import type { NoteWidgetHandle } from './note-widget.ts'
+
+/** Event name the note card dispatches on open/close (detail: { open }). */
+export const NOTE_STATE_EVENT = 'dsh-tw-note-state'
+
+/**
+ * Build the dock entry component bound to one note-widget handle. Called once
+ * per client mount; the returned component is what the slot renders.
+ */
+export function createQuickNoteDock(note: NoteWidgetHandle): () => React.ReactElement {
+  return function QuickNoteDock() {
+    const [open, setOpen] = React.useState(false)
+    React.useEffect(() => {
+      const onState = (event: Event): void => {
+        const detail = (event as CustomEvent<{ open?: boolean }>).detail
+        setOpen(detail?.open === true)
+      }
+      window.addEventListener(NOTE_STATE_EVENT, onState)
+      return () => window.removeEventListener(NOTE_STATE_EVENT, onState)
+    }, [])
+    return React.createElement(
+      'div',
+      { className: 'dsh-tw-dock-note' },
+      React.createElement(
+        'button',
+        {
+          type: 'button',
+          className: open ? 'dsh-tw-dock-note-btn dsh-tw-dock-note-btn-active' : 'dsh-tw-dock-note-btn',
+          title: open ? '快速笔记已打开（点卡片右上角 ✕ 收起）' : '打开快速笔记（草稿自动保存，点别处不会关闭）',
+          onClick: () => { void note.open() },
+        },
+        React.createElement('span', { className: 'dsh-tw-dock-note-icon', 'aria-hidden': 'true' }, '📝'),
+        React.createElement('span', { className: 'dsh-tw-dock-note-label' }, open ? '快速笔记（已打开）' : '快速笔记'),
+      ),
+    )
+  }
+}

package/src/client/settings-page.ts

@@ -227,6 +227,8 @@ function renderConfigSection(body: HTMLElement, config: Record<string, unknown>,
   textField('git.remote', 'git 远端（空=仅本地）', typeof git.remote === 'string' ? git.remote : '')
   textField('git.branch', 'git 分支', typeof git.branch === 'string' ? git.branch : 'main')
   checkField('ui.showQuickNote', '显示「知识库」按钮里的「快速笔记」入口', ui.showQuickNote !== false)
+  checkField('ui.showQuickNoteDock', '显示聊天输入框上方的「快速笔记」快捷按钮', ui.showQuickNoteDock !== false)
+  textField('ui.sidebarLabel', '侧边栏 TW 入口显示名称', typeof ui.sidebarLabel === 'string' && ui.sidebarLabel.trim().length > 0 ? ui.sidebarLabel.trim() : 'TiddlyWiki')
   checkField('ui.showPanelStatus', '显示「知识库」按钮里的 TW 面板/重载入口与状态行', ui.showPanelStatus !== false)
   checkField('ui.showSyncButton', '显示「知识库」按钮里的「同步」入口与 git 状态点', ui.showSyncButton !== false)
   checkField('ui.followDshTheme', '嵌入式 TW 跟随 DSH 深浅主题（暗色时自动切深色 palette，不写回 wiki）', ui.followDshTheme !== false)

package/src/client/sidebar-entry.ts

@@ -46,15 +46,21 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
 }
 
 /** Build the entry row (a detached button; insert once the shell is up). */
-function createEntry(state: PanelState): HTMLButtonElement {
+function createEntry(state: PanelState, label: string): { entry: HTMLButtonElement; labelEl: HTMLSpanElement } {
   const entry = document.createElement('button')
   entry.type = 'button'
   entry.dataset.dshTwEntry = ''
   entry.className = 'dsh-tw-entry'
   entry.setAttribute('aria-label', 'TiddlyWiki 知识库')
-  entry.innerHTML = `<span class="dsh-tw-entry-icon">${ICON}</span><span class="dsh-tw-entry-label">TiddlyWiki</span>`
+  const icon = document.createElement('span')
+  icon.className = 'dsh-tw-entry-icon'
+  icon.innerHTML = ICON
+  const labelEl = document.createElement('span')
+  labelEl.className = 'dsh-tw-entry-label'
+  labelEl.textContent = label
+  entry.append(icon, labelEl)
   entry.addEventListener('click', () => { state.toggle() })
-  return entry
+  return { entry, labelEl }
 }
 
 /** Re-insert the entry before the whole family block (stable ordering). */
@@ -78,12 +84,28 @@ interface TwDebug { attempts: number; found: boolean; placed: boolean }
 
 /**
  * Mount the sidebar entry, waiting for the shell and self-healing on later
- * re-renders.
+ * re-renders. The row label starts at `initialLabel` and is refreshed from the
+ * live config (`ui.sidebarLabel`) as soon as /status answers.
  * @param state - the shared panel state the entry toggles.
+ * @param initialLabel - default display name before config loads.
  * @returns disposer removing the entry and its observers.
  */
-export function mountSidebarEntry(state: PanelState): () => void {
-  const entry = createEntry(state)
+export function mountSidebarEntry(state: PanelState, initialLabel = 'TiddlyWiki'): () => void {
+  const { entry, labelEl } = createEntry(state, initialLabel)
+  // 自定义显示名：/status 返回 ui.sidebarLabel（设置页「侧边栏入口显示名称」），
+  // 异步到达后原地更新，无需重建 DOM（旧 host 无该字段时保持默认名）。
+  void (async () => {
+    try {
+      const res = await fetch('/dsh-tiddlywiki/status', { signal: AbortSignal.timeout(5_000) })
+      if (!res.ok) return
+      const p = (await res.json()) as { ui?: { sidebarLabel?: string } }
+      const label = p.ui?.sidebarLabel
+      if (typeof label === 'string' && label.trim().length > 0) {
+        labelEl.textContent = label.trim()
+        entry.setAttribute('aria-label', label.trim())
+      }
+    } catch { /* keep the initial label */ }
+  })()
   const debug: TwDebug = { attempts: 0, found: false, placed: false }
   const host = globalThis.location?.hostname
   if (host === 'localhost' || host === '127.0.0.1') {

package/src/client/styles.ts

@@ -427,8 +427,29 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
   border-bottom: 1px solid var(--dsw-alias-border-l1, rgba(0,0,0,.08));
   margin-bottom: 4px;
 }
-.dsh-tw-fab-status + .dsh-tw-fab-status { border-bottom: 0; margin-bottom: 4px; }
+/* 状态行是悬停 tip 的定位锚点（菜单里只剩这一行状态）。 */
+.dsh-tw-fab-status-tiprow { position: relative; }
 .dsh-tw-fab-status-text { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* 详细状态 tip：悬停第一行（TW 服务状态）时弹出，显示 TW 服务 + git 状态 +
+   最近日志，取代旧版菜单里的第二行 git 状态行。 */
+.dsh-tw-fab-tip {
+  position: absolute; right: 0; bottom: calc(100% + 8px);
+  z-index: 70; max-width: 300px; min-width: 200px;
+  padding: 8px 10px; border-radius: 10px;
+  background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
+  border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.15));
+  box-shadow: var(--dsw-shadow-lv3, 0 8px 30px rgba(0,0,0,.22));
+  font-size: 11px; line-height: 1.6; white-space: pre-line; word-break: break-word;
+  text-align: left;
+}
+.dsh-tw-fab-tip[hidden] { display: none; }
+.dsh-tw-fab-tip::after {
+  content: ''; position: absolute; right: 16px; bottom: -5px;
+  width: 10px; height: 10px; transform: rotate(45deg);
+  background: var(--dsw-alias-bg-layer-2, #fff);
+  border-right: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.15));
+  border-bottom: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.15));
+}
 .dsh-tw-fab-status-dot { width: 8px; height: 8px; border-radius: 50%; background: #999; flex: none; }
 .dsh-tw-fab-status-dot[data-state="running"] { background: var(--dsw-alias-state-success-primary, #3eaa5f); }
 .dsh-tw-fab-status-dot[data-state="starting"] { background: var(--dsw-alias-state-warning-primary, #d9822b); }
@@ -445,6 +466,30 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 .dsh-tw-fab-item:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); }
 .dsh-tw-fab-item:active { background: var(--dsw-alias-interactive-bg-active, rgba(128,128,128,.18)); }
 
+/* ── input-dock quick-note button（聊天输入框上方，conversation.input.dock）──
+   该槽位渲染为「输入框上方的全宽条目」纵向 flex 排列（todo/cost-meter/goal/
+   queue/git-graph 等插件同区），此按钮以紧凑小胶囊呈现，不与其他条目重叠。 */
+.dsh-tw-dock-note {
+  display: flex; align-items: center; gap: 8px;
+  padding: 4px 6px 0; box-sizing: border-box; width: 100%;
+}
+.dsh-tw-dock-note-btn {
+  display: inline-flex; align-items: center; gap: 6px;
+  border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
+  background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
+  font: inherit; font-size: 12px; padding: 5px 12px; border-radius: 999px;
+  cursor: pointer; box-shadow: 0 1px 2px rgba(0,0,0,.06);
+  transition: background-color 120ms ease, border-color 120ms ease;
+}
+.dsh-tw-dock-note-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.1)); }
+.dsh-tw-dock-note-btn-active {
+  border-color: color-mix(in srgb, var(--dsw-alias-brand-primary, #3e63dd) 45%, transparent);
+  color: var(--dsw-alias-brand-primary, #3e63dd);
+  background: color-mix(in srgb, var(--dsw-alias-brand-primary, #3e63dd) 8%, var(--dsw-alias-bg-layer-2, #fff));
+}
+.dsh-tw-dock-note-icon { display: inline-flex; flex: none; }
+.dsh-tw-dock-note-label { white-space: nowrap; }
+
 /* ── quick-note restored-draft banner ─────────────────────────────────────── */
 .dsh-tw-note-draft {
   display: flex; align-items: center; justify-content: space-between; gap: 8px;

package/src/client/ui-config.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared client-side read of the effective UI config (mirrors UiDefaultsPublic
+ * on the host). Used by the input-dock quick-note button and any other client
+ * mount that needs a config value before building DOM.
+ *
+ * @module dsh-tiddlywiki/client/ui-config
+ */
+
+const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+
+export interface UiConfig {
+  /** 聊天输入框上方的「快速笔记」快捷按钮是否显示（默认 true）。 */
+  showQuickNoteDock: boolean
+  /** 左侧侧边栏 TW 入口的显示名称（默认「TiddlyWiki」）。 */
+  sidebarLabel: string
+}
+
+const FALLBACK: UiConfig = { showQuickNoteDock: true, sidebarLabel: 'TiddlyWiki' }
+
+/** Fetch /status once and read the ui.* fields (backward compatible: a host
+ *  that predates a field simply falls back to the default). */
+export async function fetchUiConfig(): Promise<UiConfig> {
+  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; sidebarLabel?: string } }
+    return {
+      showQuickNoteDock: p.ui?.showQuickNoteDock !== false,
+      sidebarLabel: typeof p.ui?.sidebarLabel === 'string' && p.ui.sidebarLabel.trim().length > 0
+        ? p.ui.sidebarLabel.trim()
+        : 'TiddlyWiki',
+    }
+  } catch {
+    return FALLBACK
+  }
+}

package/src/host/config.ts

@@ -35,6 +35,14 @@ export interface PluginConfigShape {
   ui?: {
     /** 是否在界面右下角显示「快速笔记」悬浮按钮（默认 true）。 */
     showQuickNote?: boolean
+    /**
+     * 是否在聊天输入框上方（conversation.input.dock 槽位）显示「快速笔记」
+     * 快捷按钮（默认 true）。与其它插件（todo/cost-meter/goal/queue/git-graph
+     * 等）注入的内容同处一个纵向排列的 dock 区，天然不重叠。
+     */
+    showQuickNoteDock?: boolean
+    /** 左侧侧边栏 TW 入口的显示名称（默认「TiddlyWiki」，可自定义）。 */
+    sidebarLabel?: string
     /** 是否显示 TW 面板右下角的「状态/重载」悬浮按钮（默认 true）。 */
     showPanelStatus?: boolean
     /** 是否在界面右下角显示「同步」悬浮按钮（默认 true）。 */

package/src/host/routes.ts

@@ -139,6 +139,10 @@ export interface SessionsFace {
 /** Effective UI flags returned by /status (mirror index.ts). */
 export interface UiDefaultsPublic {
   showQuickNote: boolean
+  /** 聊天输入框上方的「快速笔记」快捷按钮（conversation.input.dock 槽位）。 */
+  showQuickNoteDock: boolean
+  /** 左侧侧边栏 TW 入口的显示名称。 */
+  sidebarLabel: string
   showPanelStatus: boolean
   showSyncButton: boolean
   /** 嵌入式 TW 是否跟随 DSH 深浅主题（false 时客户端停止 palette 同步）。 */