dsh-tiddlywiki 0.16.11 → 0.16.13

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

package/src/client/editor-popup.ts

@@ -76,15 +76,19 @@ function ensurePopup(): void {
   })
 
   // Drag by the title bar (un-center by setting explicit left/top + margin 0).
-  bar.addEventListener('mousedown', (event) => {
+  // Pointer Events + setPointerCapture: the pointer is captured by the bar, so
+  // pointermove/pointerup keep firing on it even over the iframe or outside the
+  // window — no window-level listeners, hence nothing to leak on a lost mouseup.
+  bar.addEventListener('pointerdown', (event) => {
     if (event.button !== 0 || root === undefined) return
     event.preventDefault()
+    bar.setPointerCapture(event.pointerId)
     const rect = root.getBoundingClientRect()
     const startX = event.clientX
     const startY = event.clientY
     const baseLeft = rect.left
     const baseTop = rect.top
-    const onMove = (ev: MouseEvent): void => {
+    const onMove = (ev: PointerEvent): void => {
       if (root === undefined) return
       root.style.left = `${baseLeft + ev.clientX - startX}px`
       root.style.top = `${baseTop + ev.clientY - startY}px`
@@ -93,24 +97,27 @@ function ensurePopup(): void {
       root.style.bottom = 'auto'
     }
     const onUp = (): void => {
-      window.removeEventListener('mousemove', onMove)
-      window.removeEventListener('mouseup', onUp)
+      bar.removeEventListener('pointermove', onMove)
+      bar.removeEventListener('pointerup', onUp)
+      bar.removeEventListener('pointercancel', onUp)
     }
-    window.addEventListener('mousemove', onMove)
-    window.addEventListener('mouseup', onUp)
+    bar.addEventListener('pointermove', onMove)
+    bar.addEventListener('pointerup', onUp)
+    bar.addEventListener('pointercancel', onUp)
   })
 
   // Resize from the bottom-right corner.
-  resize.addEventListener('mousedown', (event) => {
+  resize.addEventListener('pointerdown', (event) => {
     if (event.button !== 0 || root === undefined) return
     event.preventDefault()
     event.stopPropagation()
+    resize.setPointerCapture(event.pointerId)
     const rect = root.getBoundingClientRect()
     const startX = event.clientX
     const startY = event.clientY
     const baseW = rect.width
     const baseH = rect.height
-    const onMove = (ev: MouseEvent): void => {
+    const onMove = (ev: PointerEvent): void => {
       if (root === undefined) return
       root.style.width = `${Math.max(360, baseW + ev.clientX - startX)}px`
       root.style.height = `${Math.max(260, baseH + ev.clientY - startY)}px`
@@ -118,10 +125,12 @@ function ensurePopup(): void {
       root.style.bottom = 'auto'
     }
     const onUp = (): void => {
-      window.removeEventListener('mousemove', onMove)
-      window.removeEventListener('mouseup', onUp)
+      resize.removeEventListener('pointermove', onMove)
+      resize.removeEventListener('pointerup', onUp)
+      resize.removeEventListener('pointercancel', onUp)
     }
-    window.addEventListener('mousemove', onMove)
-    window.addEventListener('mouseup', onUp)
+    resize.addEventListener('pointermove', onMove)
+    resize.addEventListener('pointerup', onUp)
+    resize.addEventListener('pointercancel', onUp)
   })
 }

package/src/client/endpoints.ts

@@ -0,0 +1,10 @@
+/**
+ * Same-origin DSH endpoints the client calls. The authoritative route table
+ * lives in src/host/routes.ts (see AGENTS.md §1「DSH 路由」) — this is just the
+ * client-side mirror, so the path string exists once per endpoint instead of
+ * being re-typed in every widget.
+ *
+ * @module dsh-tiddlywiki/client/endpoints
+ */
+export const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+export const GET_ENDPOINT = '/dsh-tiddlywiki/get'

package/src/client/index.ts

@@ -71,10 +71,6 @@ export function apply(ctx: ClientContextFace): void {
       if (ctx.slots !== undefined) {
         void fetchUiConfig().then((cfg) => {
           if (clientDisposed) return
-          // 输入框上方「快速笔记」快捷按钮（conversation.input.dock 槽位）。该槽位
-          // 是官方为「输入框上方的全宽条目」预留的挂载点，todo/cost-meter/goal/
-          // queue/git-graph 等插件内容都渲染在这里、按纵向 flex 排列，天然不重叠。
-          // 由 ui.showQuickNoteDock 配置控制（默认开）。
           if (cfg.showQuickNoteDock) {
             const removeDock = ctx.slots?.inject('conversation.input.dock', () =>
               ctx.slots?.register(

package/src/client/knowledge-fab.ts

@@ -19,8 +19,9 @@
 import type { PanelState } from './state.ts'
 import type { NoteWidgetHandle } from './note-widget.ts'
 import type { SyncController } from './sync-button.ts'
+import { PANEL_RELOAD_EVENT } from './panel.ts'
 
-const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 
 /** Book icon (same visual family as the sidebar entry). */
 const BOOK_ICON = '<svg viewBox="0 0 16 16" width="17" height="17" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><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"/><path d="M6 6h4M6 8.5h2.5"/></svg>'
@@ -84,6 +85,15 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
     if (tip !== undefined) tip.hidden = true
   }
 
+  /** Capture-phase outside-click handler (closes the open menu); must be
+   *  removable so unmount does not leak the document listener. */
+  const onDocumentClick = (event: Event): void => {
+    if (!menuOpen) return
+    const target = event.target as Node
+    if (root !== undefined && root.contains(target)) return
+    closeMenu()
+  }
+
   /** Rebuild the TW status row's hover tip (TW 服务 + git 状态 + 最近日志). */
   const renderTip = (): void => {
     if (tip === undefined) return
@@ -181,7 +191,7 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
       reload.textContent = '🔄 重载 TW 面板'
       reload.addEventListener('click', () => {
         closeMenu()
-        document.dispatchEvent(new CustomEvent('dsh-tw-panel-reload'))
+        document.dispatchEvent(new CustomEvent(PANEL_RELOAD_EVENT))
         void refreshTwStatus()
       })
       menu.append(reload)
@@ -224,12 +234,7 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
     renderDot()
 
     // Outside click closes the menu.
-    document.addEventListener('click', (event) => {
-      if (!menuOpen) return
-      const target = event.target as Node
-      if (root !== undefined && root.contains(target)) return
-      closeMenu()
-    }, true)
+    document.addEventListener('click', onDocumentClick, true)
   }
 
   // Reflect panel open/close in the menu label.
@@ -247,6 +252,7 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
 
   return () => {
     disposed = true
+    document.removeEventListener('click', onDocumentClick, true)
     unsubPanel()
     unsubSync()
     root?.remove()

package/src/client/note-widget.ts

@@ -32,13 +32,19 @@ import { buildMarkdownEditor, type MarkdownEditor } from './markdown-editor.ts'
 
 const NOTE_ENDPOINT = '/dsh-tiddlywiki/note'
 const EDIT_ENDPOINT = '/dsh-tiddlywiki/edit'
-const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 const TAGS_ENDPOINT = '/dsh-tiddlywiki/tags'
 const RECENT_ENDPOINT = '/dsh-tiddlywiki/recent'
 const GET_ENDPOINT = '/dsh-tiddlywiki/get'
 const UPLOAD_ENDPOINT = '/dsh-tiddlywiki/upload'
 const MAX_UPLOAD_BYTES = 64 * 1024 * 1024
 
+/**
+ * Broadcast by the card on open/close (detail: { open }). The input-dock quick-
+ * note button (quick-note-dock.ts) listens to highlight while the card is open.
+ */
+export const NOTE_STATE_EVENT = 'dsh-tw-note-state'
+
 /** localStorage key for the autosaved quick-note draft. */
 const DRAFT_KEY = 'dsh-tw-note-draft-v1'
 /** Draft auto-save debounce. */
@@ -119,6 +125,8 @@ function buildTagEditor(opts: { onChange?: () => void } = {}): {
   getTags: () => string[]
   setDefault: (tag: string) => void
   setTags: (tags: string[]) => void
+  /** Remove the document-level outside-click listener (unmount must not leak). */
+  dispose: () => void
 } {
   const wrap = document.createElement('div')
   wrap.className = 'dsh-tw-note-tags'
@@ -225,9 +233,10 @@ function buildTagEditor(opts: { onChange?: () => void } = {}): {
       hideSuggest()
     }
   })
-  document.addEventListener('click', (event) => {
+  const onDocClick = (event: Event): void => {
     if (!wrap.contains(event.target as Node)) hideSuggest()
-  }, true)
+  }
+  document.addEventListener('click', onDocClick, true)
 
   return {
     el: wrap,
@@ -255,6 +264,7 @@ function buildTagEditor(opts: { onChange?: () => void } = {}): {
       renderChips()
       hideSuggest()
     },
+    dispose: () => document.removeEventListener('click', onDocClick, true),
   }
 }
 
@@ -341,7 +351,7 @@ export function createNoteWidget(): NoteWidgetHandle {
    */
   const emitState = (open: boolean): void => {
     try {
-      window.dispatchEvent(new CustomEvent('dsh-tw-note-state', { detail: { open } }))
+      window.dispatchEvent(new CustomEvent(NOTE_STATE_EVENT, { detail: { open } }))
     } catch { /* event dispatch is best-effort */ }
   }
 
@@ -630,12 +640,18 @@ export function createNoteWidget(): NoteWidgetHandle {
       close()
     }
 
+    // In-flight guard: the save button is disabled while saving, but Ctrl+Enter
+    // from the editor keymap is not — a second POST within the same second
+    // would carry the same timestamp title and silently overwrite the first.
+    let saving = false
     doSave = async (): Promise<void> => {
+      if (saving) return
       const text = editor.getValue().trim()
       if (text.length === 0) {
         toast('内容为空，未保存')
         return
       }
+      saving = true
       saveBtn.disabled = true
       saveBtn.textContent = '保存中…'
       try {
@@ -655,6 +671,7 @@ export function createNoteWidget(): NoteWidgetHandle {
       } catch (err) {
         toast(`保存失败：${err instanceof Error ? err.message : String(err)}`)
       } finally {
+        saving = false
         saveBtn.disabled = false
         saveBtn.textContent = '保存'
       }
@@ -785,8 +802,12 @@ export function createNoteWidget(): NoteWidgetHandle {
       } else {
         resetTitle()
         defaultTag = (await fetchUiOptions()).defaultTag
+        // dispose() may have run while awaiting (sets ui = undefined); a live
+        // `ui` reference must be re-read under the same guard as above.
+        if (disposed || ui === undefined) return
         ui.tagEditor.setDefault(defaultTag)
       }
+      if (ui === undefined) return
       ui.editor.focus()
     },
     close() {
@@ -806,6 +827,7 @@ export function createNoteWidget(): NoteWidgetHandle {
     dispose() {
       disposed = true
       if (draftTimer !== undefined) { clearTimeout(draftTimer); draftTimer = undefined }
+      ui?.tagEditor.dispose()
       ui?.editor.view.destroy()
       ui?.root.remove()
       const toastEl = document.querySelector<HTMLElement>('.dsh-tw-toast')
@@ -815,8 +837,5 @@ export function createNoteWidget(): NoteWidgetHandle {
   }
 }
 
-/** Legacy compatibility export: the FAB owns the trigger in v0.5. */
-export function mountNoteWidget(): () => void {
-  const handle = createNoteWidget()
-  return () => handle.dispose()
-}
+// (The FAB owns the trigger since v0.5 — there is deliberately no standalone
+// mount export here; index.ts wires createNoteWidget into mountKnowledgeFab.)

package/src/client/panel.ts

@@ -24,7 +24,7 @@ import type { PanelState } from './state.ts'
 import { ENTRY_SELECTOR } from './sidebar-entry.ts'
 import { attachThemeSync, setThemeSyncConfig } from './theme-sync.ts'
 
-export const PANEL_VIEW_SELECTOR = '[data-dsh-tw-view]'
+export const PANEL_RELOAD_EVENT = 'dsh-tw-panel-reload'
 
 /**
  * Center-column targets, most-specific shell generation first. The official
@@ -57,7 +57,7 @@ const APP_OVERLAY_Z_INDEX = 20
 /** Safety re-measure cadence for shell layout changes CSS can't see. */
 const SYNC_INTERVAL_MS = 2_000
 
-const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 const RESTART_ENDPOINT = '/dsh-tiddlywiki/restart'
 
 /**
@@ -100,7 +100,7 @@ interface StatusPayload {
   wikiPath?: string
   error?: string
   note?: { tag?: string }
-  ui?: { showPanelStatus?: boolean; followDshTheme?: boolean; darkPalette?: string }
+  ui?: { followDshTheme?: boolean; darkPalette?: string }
 }
 
 function conversationColumn(): HTMLElement | undefined {
@@ -143,6 +143,8 @@ export function mountPanel(state: PanelState): () => void {
   let frameLoaded = false
   /** A tiddler-hash open request waiting for the frame to become ready. */
   let pendingHash: string | null = null
+  /** Set by the disposer: no timers/observers may touch DOM or the iframe after. */
+  let disposed = false
 
   const build = (): HTMLDivElement => {
     const view = document.createElement('div')
@@ -281,6 +283,7 @@ export function mountPanel(state: PanelState): () => void {
       return
     }
     const tryOnce = (attempt: number): void => {
+      if (disposed) return // unmounted: do not keep waiting or touch the iframe
       if (pendingHash !== hash) return // superseded by a newer request
       const frameTw = win as { $tw?: unknown }
       if (typeof frameTw.$tw !== 'object' || frameTw.$tw === null) {
@@ -303,7 +306,7 @@ export function mountPanel(state: PanelState): () => void {
   }
 
   const fallbackLoad = (hash: string): void => {
-    if (iframe === undefined) return
+    if (disposed || iframe === undefined) return // never drive a detached frame
     if (pendingHash === hash) pendingHash = null
     const base = iframe.src.split('#')[0]
     if (iframe.src !== `${base}${hash}`) iframe.src = `${base}${hash}`
@@ -324,6 +327,7 @@ export function mountPanel(state: PanelState): () => void {
       refreshTimer = undefined
     }
     const payload = await fetchStatus()
+    if (disposed) return // unmounted while fetching: stop, don't touch DOM
     if (payload === null) {
       showError('无法访问 /dsh-tiddlywiki/status')
       return
@@ -413,10 +417,11 @@ export function mountPanel(state: PanelState): () => void {
   const onReloadRequest = (): void => {
     if (iframe !== undefined && !iframe.hidden) iframe.src = iframe.src
   }
-  document.addEventListener('dsh-tw-panel-reload', onReloadRequest)
+  document.addEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
   document.addEventListener(OPEN_TIDDLER_EVENT, onOpenTiddler)
 
   return () => {
+    disposed = true
     if (refreshTimer !== undefined) window.clearTimeout(refreshTimer)
     window.clearInterval(syncInterval)
     window.removeEventListener('resize', onWindowResize)
@@ -424,7 +429,7 @@ export function mountPanel(state: PanelState): () => void {
     resizeObserver.disconnect()
     document.removeEventListener('click', onClickSidebarRow, true)
     document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
-    document.removeEventListener('dsh-tw-panel-reload', onReloadRequest)
+    document.removeEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
     document.removeEventListener(OPEN_TIDDLER_EVENT, onOpenTiddler)
     waitObserver.disconnect()
     unsubscribe()

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

@@ -15,10 +15,7 @@
  * @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'
+import { NOTE_STATE_EVENT, type NoteWidgetHandle } from './note-widget.ts'
 
 /**
  * Build the dock entry component bound to one note-widget handle. Called once

package/src/client/session-summary.ts

@@ -18,12 +18,13 @@
  */
 import * as React from 'react'
 import { attachThemeSync } from './theme-sync.ts'
+import { GET_ENDPOINT } from './endpoints.ts'
 
 export const SESSION_SUMMARY_VIEW_ID = 'dsh-tiddlywiki-summary'
 const SUMMARY_ENDPOINT = '/dsh-tiddlywiki/session/summary'
 /** Same-origin TW proxy base（与 host TW_PROXY_PATH 一致，client 不能 import 它）。 */
 const TW_PROXY_BASE = '/dsh-tiddlywiki/tw/'
-export const SESSION_SUMMARY_LABEL_DEFAULT = '知识库'
+const SESSION_SUMMARY_LABEL_DEFAULT = '知识库'
 
 /** Tab 显示名缓存：客户端从 /status 读到 `ui.tabLabel` 后更新；默认「知识库」。 */
 let tabLabel = SESSION_SUMMARY_LABEL_DEFAULT
@@ -49,6 +50,7 @@ function SessionSummaryView(props: SessionSummaryViewProps): React.ReactElement
   const { sessionId, viewRequest, completeViewRequest } = props
   const [phase, setPhase] = React.useState<'loading' | 'ready' | 'error'>('loading')
   const [twUrl, setTwUrl] = React.useState<string | null>(null)
+  const [summaryTitle, setSummaryTitle] = React.useState<string | null>(null)
   const [error, setError] = React.useState('')
   const [frameNonce, setFrameNonce] = React.useState(0)
   const genRef = React.useRef(0)
@@ -77,6 +79,7 @@ function SessionSummaryView(props: SessionSummaryViewProps): React.ReactElement
         return
       }
       if (typeof data.title === 'string' && data.title.length > 0) {
+        setSummaryTitle(data.title)
         setTwUrl(new URL(TW_PROXY_BASE, window.location.origin).href + '#' + encodeURIComponent(data.title))
         // 新 nonce 强制 iframe 重挂载 → 用最新汇总重新加载（含刷新场景）。
         setFrameNonce((n) => n + 1)
@@ -94,6 +97,31 @@ function SessionSummaryView(props: SessionSummaryViewProps): React.ReactElement
     void generate()
   }, [generate])
 
+  // 自愈：汇总条目是 volatile 的 `$:/temp`，TW 重启即消失；若 iframe 已就绪但条目
+  // 被清掉（/get 404），自动重新生成，避免停在 TW 的「佚失条目」页。连续 3 次仍
+  // 缺失（例如服务端写不进去）就停止自动重试，交还手动「🔄 刷新」。
+  React.useEffect(() => {
+    if (phase !== 'ready' || summaryTitle === null) return
+    let misses = 0
+    const timer = window.setInterval(() => {
+      void (async () => {
+        try {
+          const res = await fetch(`${GET_ENDPOINT}?title=${encodeURIComponent(summaryTitle)}`, { signal: AbortSignal.timeout(8_000) })
+          const data = (await res.json().catch(() => null)) as { notFound?: boolean } | null
+          if (res.status === 404 || data?.notFound === true) {
+            misses++
+            if (misses < 3) void generate()
+          } else {
+            misses = 0
+          }
+        } catch {
+          /* 检查失败保持现状，下个周期再试 */
+        }
+      })()
+    }, 30_000)
+    return () => window.clearInterval(timer)
+  }, [phase, summaryTitle, generate])
+
   // 一次性 focus 请求直接确认（本视图无可聚焦子目标，避免 shell 挂起）。
   React.useEffect(() => {
     if (viewRequest !== null && viewRequest !== undefined) completeViewRequest?.()

package/src/client/settings-page.ts

@@ -12,7 +12,8 @@
  *
  * Sections:
  *   1. 状态/重启      TW 运行状态 + git 概览 + 重启按钮
- *   2. 常规配置       note.tag / git.* / uiLanguage（改了什么保存什么）
+ *   2. 常规配置       note.tag / git.* / ui.*（含会话「知识库」Tab 名称、sendToAgent
+ *                     开关/token/endpoint；改了什么保存什么）
  *   3. 插件管理       自带官方插件勾选（可搜索）→ 应用并重启 TW
  *   4. 主题管理       自带主题单选 → 应用并重启 TW
  *   5. 初始化         一次性预置（doc-note/send-to-agent/home-index/all-articles/menubar-theme/tw-web-host）
@@ -232,9 +233,13 @@ function renderConfigSection(body: HTMLElement, config: Record<string, unknown>,
   checkField('ui.showPanelStatus', '显示「知识库」按钮里的 TW 面板/重载入口与状态行', ui.showPanelStatus !== false)
   checkField('ui.showSyncButton', '显示「知识库」按钮里的「同步」入口与 git 状态点', ui.showSyncButton !== false)
   checkField('ui.followDshTheme', '嵌入式 TW 跟随 DSH 深浅主题（暗色时自动切深色 palette，不写回 wiki）', ui.followDshTheme !== false)
-  textField('ui.darkPalette', '暗色时 TW palette（tiddler 标题）', typeof ui.darkPalette === 'string' && ui.darkPalette.length > 0 ? ui.darkPalette : '$:/palettes/CupertinoDark')
+  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)
+  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 : '')
+  textField('ui.sendToAgent.token', '共享 token（非空时路由校验 x-send-to-agent-token 头）', typeof sendToAgent.token === 'string' ? sendToAgent.token : '')
   const allArticles = (ui.allArticles ?? {}) as Record<string, unknown>
   numField('ui.allArticles.pageSize', '「所有文章」每页条数', typeof allArticles.pageSize === 'number' ? allArticles.pageSize : 10)
   // 界面语言在下方「语言管理」区块设置（config 的 uiLanguage 仅供启动时自动应用）。

package/src/client/sidebar-entry.ts

@@ -10,6 +10,7 @@
  * @module dsh-tiddlywiki/client/sidebar-entry
  */
 import type { PanelState } from './state.ts'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 
 /** Stable data attribute identifying this entry row. */
 export const ENTRY_SELECTOR = '[data-dsh-tw-entry]'
@@ -96,7 +97,7 @@ export function mountSidebarEntry(state: PanelState, initialLabel = 'TiddlyWiki'
   // 异步到达后原地更新，无需重建 DOM（旧 host 无该字段时保持默认名）。
   void (async () => {
     try {
-      const res = await fetch('/dsh-tiddlywiki/status', { signal: AbortSignal.timeout(5_000) })
+      const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(5_000) })
       if (!res.ok) return
       const p = (await res.json()) as { ui?: { sidebarLabel?: string } }
       const label = p.ui?.sidebarLabel

package/src/client/styles.ts

@@ -51,32 +51,6 @@ html[data-dsh-tw-active] [data-pane="conversation"] > :not([data-dsh-tw-view]),
 html[data-dsh-tw-active] [class*="centerCol"] > :not([data-dsh-tw-view]),
 html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view]) { display: none !important; }
 
-/* ── bottom-right status / reload floating buttons ───────────────────
-   The top panel bar (title + status + reload row) is gone so TW's menubar
-   reaches the panel top; status/reload now live here as floating buttons,
-   same visual language as the quick-note toggle. The ui.showPanelStatus
-   setting controls whether they mount at all. */
-.dsh-tw-panel-status {
-  /* 状态/重载悬浮按钮：右对齐到与快速笔记按钮同一条竖线（right:24），
-     垂直排在「同步」按钮（bottom:140）上方；
-     两个按钮竖直依次排列（状态在上、重载在下），与其他插件按钮列对齐、不堆叠。 */
-  position: fixed; right: 24px; bottom: 192px; z-index: 950;
-  display: flex; flex-direction: column; align-items: flex-end; gap: 8px;
-}
-.dsh-tw-panel-status-btn {
-  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: 7px 12px; border-radius: 999px;
-  box-shadow: var(--dsw-shadow-lv3, 0 4px 16px rgba(0,0,0,.16)); cursor: pointer;
-  display: inline-flex; align-items: center; gap: 6px;
-  transition: background-color 120ms ease;
-}
-.dsh-tw-panel-status-btn:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.1)); }
-.dsh-tw-status-dot { width: 8px; height: 8px; border-radius: 50%; background: #999; flex: none; }
-.dsh-tw-status-dot[data-state="running"] { background: var(--dsw-alias-state-success-primary, #3eaa5f); }
-.dsh-tw-status-dot[data-state="starting"] { background: var(--dsw-alias-state-warning-primary, #d9822b); }
-.dsh-tw-status-dot[data-state="failed"], .dsh-tw-status-dot[data-state="stopped"] { background: var(--dsw-alias-state-error-primary, #d13b3b); }
-
 /* The iframe background follows the DSH theme so a blank/preload frame never
    flashes pure white in dark mode (TW paints its own palette once loaded). */
 .dsh-tw-panel-frame { flex: 1; min-height: 0; border: 0; width: 100%; display: block; background: var(--dsw-alias-bg-layer-1, #fff); }
@@ -264,38 +238,6 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 .dsh-tw-editor-close:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); color: var(--dsw-alias-label-primary, #222); }
 .dsh-tw-editor-frame { flex: 1; min-height: 0; width: 100%; border: 0; background: var(--dsw-alias-bg-layer-1, #fff); }
 .dsh-tw-editor-resize { position: absolute; right: 0; bottom: 0; width: 16px; height: 16px; cursor: nwse-resize; }
-.dsh-tw-note-toggle {
-  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: 13px; padding: 9px 16px; border-radius: 999px;
-  box-shadow: var(--dsw-shadow-lv3, 0 4px 16px rgba(0,0,0,.16)); cursor: pointer;
-  display: inline-flex; align-items: center; gap: 6px;
-  transition: background-color 120ms ease;
-}
-.dsh-tw-note-toggle:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.1)); }
-
-/* ── floating sync button (bottom-right) ───────────────────────
-   Pill FAB between the quick-note toggle (bottom:88) and the TW panel
-   status/reload floaters (bottom:192); dot reflects git state. */
-.dsh-tw-sync {
-  position: fixed; right: 24px; bottom: 140px; z-index: 950;
-  display: inline-flex; align-items: center; gap: 7px;
-  padding: 9px 14px; border-radius: 999px;
-  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: 13px; box-shadow: var(--dsw-shadow-lv3, 0 4px 16px rgba(0,0,0,.16));
-  cursor: pointer; transition: background-color 120ms ease;
-}
-.dsh-tw-sync:hover:not(:disabled) { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.1)); }
-.dsh-tw-sync:disabled { opacity: .65; cursor: default; }
-.dsh-tw-sync-icon { display: inline-flex; flex: none; }
-.dsh-tw-sync-spin .dsh-tw-sync-icon svg { animation: dsh-tw-spin 1s linear infinite; transform-origin: center; }
-@keyframes dsh-tw-spin { to { transform: rotate(360deg); } }
-.dsh-tw-sync-dot { width: 8px; height: 8px; border-radius: 50%; background: #999; flex: none; }
-.dsh-tw-sync-dot[data-state="clean"] { background: var(--dsw-alias-state-success-primary, #3eaa5f); }
-.dsh-tw-sync-dot[data-state="dirty"] { background: var(--dsw-alias-state-warning-primary, #d9822b); }
-.dsh-tw-sync-dot[data-state="behind"] { background: var(--dsw-alias-state-error-primary, #d13b3b); }
-.dsh-tw-sync-dot[data-state="syncing"] { background: var(--dsw-alias-brand-primary, #3e63dd); }
 
 /* ── toast ──────────────────────────────────────────────────── */
 .dsh-tw-toast {

package/src/client/sync-button.ts

@@ -18,7 +18,7 @@
  */
 import { toast } from './toast.ts'
 
-const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 const SYNC_ENDPOINT = '/dsh-tiddlywiki/sync'
 const POLL_MS = 30_000
 
@@ -38,7 +38,6 @@ interface StatusPayload {
   ok?: boolean
   status?: string
   git?: GitView | null
-  ui?: { showSyncButton?: boolean }
 }
 
 export interface SyncStateView {
@@ -121,6 +120,7 @@ export function createSyncController(): SyncController {
   let lastSync: Date | undefined
   let timer: number | undefined
   let syncing = false
+  let disposed = false
   const listeners = new Set<() => void>()
 
   const emit = (): void => {
@@ -136,11 +136,12 @@ export function createSyncController(): SyncController {
   }
 
   const poll = async (): Promise<void> => {
+    if (disposed) return // unmounted: no further fetches or state churn
     applyStatus(await fetchStatus())
   }
 
   const doSync = async (): Promise<SyncStateView> => {
-    if (syncing) return state
+    if (disposed || syncing) return state
     syncing = true
     state = { ...state, state: 'syncing', label: '同步中…' }
     emit()
@@ -184,6 +185,7 @@ export function createSyncController(): SyncController {
       return () => { listeners.delete(cb) }
     },
     dispose() {
+      disposed = true
       if (timer !== undefined) { clearInterval(timer); timer = undefined }
       listeners.clear()
     },

package/src/client/ui-config.ts

@@ -6,7 +6,7 @@
  * @module dsh-tiddlywiki/client/ui-config
  */
 
-const STATUS_ENDPOINT = '/dsh-tiddlywiki/status'
+import { STATUS_ENDPOINT } from './endpoints.ts'
 
 export interface UiConfig {
   /** 聊天输入框上方的「快速笔记」快捷按钮是否显示（默认 true）。 */

package/src/host/admin.ts

@@ -24,6 +24,8 @@ import type { TiddlyWebClient } from './tw-api.ts'
 import type { WikiServer } from './wiki.ts'
 import { ROUTE_PREFIX, type WebServerFace } from './routes.ts'
 import { CONFIG_TIDDLER, type ConfigStore, type PluginConfigShape } from './config.ts'
+import { readBody, json } from './http.ts'
+import { GitFace } from './git.ts'
 
 /** One bundled plugin/theme from the catalog. */
 export interface CatalogEntry {
@@ -219,29 +221,6 @@ export async function ensureLanguage(wikiPath: string, twRoot: string, lang: str
   return true
 }
 
-function json(res: ServerResponse, payload: unknown, status = 200): void {
-  res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
-  res.end(JSON.stringify(payload))
-}
-
-async function readBody(req: IncomingMessage, limit = 1024 * 1024): Promise<string> {
-  return new Promise((resolveP, rejectP) => {
-    let size = 0
-    const chunks: Buffer[] = []
-    req.on('data', (chunk: Buffer) => {
-      size += chunk.length
-      if (size > limit) {
-        rejectP(new Error('body too large'))
-        req.destroy()
-        return
-      }
-      chunks.push(chunk)
-    })
-    req.on('end', () => resolveP(Buffer.concat(chunks).toString('utf8')))
-    req.on('error', rejectP)
-  })
-}
-
 export interface AdminDeps {
   server: WikiServer
   getClient: () => TiddlyWebClient | undefined
@@ -264,7 +243,6 @@ export function registerAdminRoutes(ctx: { webServer: WebServerFace }, deps: Adm
       const [info, catalog] = await Promise.all([readWikiInfo(wikiPath), bundledCatalog(deps.twRoot())])
       let git: unknown = null
       try {
-        const { GitFace } = await import('./git.ts')
         git = await new GitFace().status(wikiPath)
       } catch {
         git = null