dsh-tiddlywiki 0.28.2 → 0.28.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-tiddlywiki",
   "description": "把 TiddlyWiki 5 变成你和 Agent 共用的本地文档中心（纯文本 + git）：你在 DSH 界面里阅读、写作、记日记，Agent 用 15 个 tiddlywiki_* 工具读写同一批笔记；每条笔记都是你能读、能改、能审计、能随时带走的文件——不是自动记忆插件，不做后台抓取。可选一键发布到微信公众号草稿箱。 Turn TiddlyWiki 5 into a document center you and your agent share, in plain text under git — a knowledge base you can read, edit, audit and take with you, not an auto-memory plugin. Mounts via the official dsh plugin system; no DSH source changes.",
-  "version": "0.28.2",
+  "version": "0.28.3",
   "type": "module",
   "keywords": [
     "dsh",

package/src/client/dock-align.ts

@@ -0,0 +1,121 @@
+/**
+ * Align a `conversation.input.dock` entry with the composer input card.
+ *
+ * WHY THIS EXISTS (v0.28.2)
+ * -------------------------
+ * The dock slot renders entries as a full-width flex column that is a SIBLING of
+ * the composer, not inside it. The composer's input card is centred and has its
+ * own max-width, so an entry's right edge sits far to the right of the input box
+ * — visibly misaligned.
+ *
+ * The fix is to measure the composer card and pad the entry's right side by the
+ * difference. That measurement used to live only inside `quick-note-dock.ts`, so
+ * the moment a SECOND dock entry was added (the per-session knowledge-base
+ * selector) it simply did not align — nobody had published the rule. This module
+ * is that rule, written once.
+ *
+ * HOW IT FINDS THE CARD
+ * ---------------------
+ * Climb from the entry until an ancestor's subtree contains a wide text field
+ * (>300px — the composer input; dock entries' own inputs are small), then take
+ * the widest box between that field and its containing column (the visible card).
+ *
+ * WHEN IT RE-MEASURES
+ * -------------------
+ * ResizeObserver on the whole ancestor chain up to the conversation root
+ * (`[data-phase]`), plus `resize` / `visibilitychange`, plus a short self-healing
+ * interval that stops once the layout has measured cleanly three times (or after
+ * 20 tries, so a shell we cannot understand never leaks a timer).
+ *
+ * @module dsh-tiddlywiki/client/dock-align
+ */
+
+/** The measurement/padding key, exported so the gate can assert on it. */
+export const DOCK_ALIGN_MIN_INPUT_WIDTH = 300
+
+/**
+ * Start aligning `wrap` with the composer input card. Returns the disposer; call
+ * it from the component's effect cleanup.
+ *
+ * A React ref is intentionally NOT taken: the caller passes its own element, so
+ * this works for any dock entry regardless of how it renders.
+ */
+export function alignDockEntry(wrap: HTMLElement): () => void {
+  /** Find the composer input CARD (see the module doc for the algorithm). */
+  const findCard = (): HTMLElement | null => {
+    let input: Element | null = null
+    let column: HTMLElement | null = null
+    let node: HTMLElement | null = wrap
+    while (node !== null && node !== document.documentElement) {
+      node = node.parentElement
+      if (node === null) break
+      for (const el of node.querySelectorAll('textarea, [contenteditable]:not([contenteditable="false"]), [role="textbox"]')) {
+        if (el.getBoundingClientRect().width > DOCK_ALIGN_MIN_INPUT_WIDTH) { input = el; column = node; break }
+      }
+      if (column !== null) break
+    }
+    if (input === null || column === null) return null
+    const colW = column.getBoundingClientRect().width
+    let cur: HTMLElement | null = input as HTMLElement
+    let card: HTMLElement | null = null
+    let cardW = 0
+    while (cur !== null && cur !== column) {
+      const w = cur.getBoundingClientRect().width
+      if (w > 0 && w < colW - 8 && w >= cardW) { cardW = w; card = cur }
+      cur = cur.parentElement
+    }
+    return card
+  }
+
+  /** Measure once; returns true when the composer card was found (valid measure). */
+  const align = (): boolean => {
+    const wrapRect = wrap.getBoundingClientRect()
+    const card = findCard()
+    const right = card !== null ? card.getBoundingClientRect().right : wrapRect.right
+    const pad = Math.max(0, wrapRect.right - right)
+    if (wrap.style.paddingRight !== `${pad}px`) wrap.style.paddingRight = `${pad}px`
+    return card !== null
+  }
+
+  align()
+  // A sidebar toggle changes the conversation column width → the centred,
+  // max-width composer card moves → the padding must be re-measured. Observing
+  // only the dock container misses that (it may not resize at all), so observe
+  // the whole ancestor chain up to the conversation root.
+  const ro = new ResizeObserver(() => { align() })
+  let node: Element | null = wrap
+  while (node !== null && node !== document.documentElement) {
+    ro.observe(node)
+    if (node instanceof HTMLElement && node.hasAttribute('data-phase')) break
+    node = node.parentElement
+  }
+  window.addEventListener('resize', align)
+  document.addEventListener('visibilitychange', align)
+
+  // Self-healing fallback for layout changes we cannot observe. Each tick is a
+  // few getBoundingClientRect reads. It stops after 3 clean measurements, and
+  // gives up after 20 tries so an unrecognisable shell cannot leak a timer.
+  let guardHits = 0
+  let guardTicks = 0
+  const guard = window.setInterval(() => {
+    guardTicks++
+    if (!align()) {
+      if (guardTicks >= 20) window.clearInterval(guard)
+      return
+    }
+    guardHits++
+    if (guardHits >= 3) window.clearInterval(guard)
+  }, 1500)
+  // The composer card may mount slightly later; re-measure a couple of times.
+  const t1 = window.setTimeout(align, 120)
+  const t2 = window.setTimeout(align, 600)
+
+  return () => {
+    ro.disconnect()
+    window.removeEventListener('resize', align)
+    document.removeEventListener('visibilitychange', align)
+    window.clearInterval(guard)
+    window.clearTimeout(t1)
+    window.clearTimeout(t2)
+  }
+}

package/src/client/note-widget.ts

@@ -835,7 +835,16 @@ export function createNoteWidget(): NoteWidgetHandle {
       if (disposed) return
       rosterMode = typeof payload?.mode === 'string' ? payload.mode : 'single'
       roster = (Array.isArray(payload?.wikis) ? payload.wikis : []).map((item) => ({ id: item.id, label: item.label, running: item.running }))
-      if (roster.length <= 1) return
+      // 单库：连选择器都不该存在。这里**还有一个**兜底 —— 除 `hidden` 外把 select 禁用、
+      // 标签也藏掉，因为"能看见一个没有选项的下拉"比"什么都不显示"糟得多（v0.28.1 修）。
+      if (roster.length <= 1) {
+        wikiField.hidden = true
+        wikiField.style.display = 'none'
+        wikiSelect.disabled = true
+        return
+      }
+      wikiField.style.display = ''
+      wikiSelect.disabled = false
       const defaultId = typeof payload?.defaultId === 'string' ? payload.defaultId : undefined
       const followFocus = (): void => {
         if (!targetPicked) targetWiki = resolveFocusWiki(roster, defaultId)

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

@@ -17,6 +17,7 @@
 import * as React from 'react'
 import { NOTE_STATE_EVENT, type NoteWidgetHandle } from './note-widget.ts'
 import { fetchUiConfig } from './ui-config.ts'
+import { alignDockEntry } from './dock-align.ts'
 import { isEditorPopupOpen, isEditorPopupBlank, closeEditorPopup } from './editor-popup.ts'
 
 /**
@@ -54,89 +55,13 @@ export function createQuickNoteDock(note: NoteWidgetHandle): () => React.ReactEl
         window.removeEventListener(NOTE_STATE_EVENT, onState)
       }
     }, [])
+    // 与 composer 输入框右缘对齐：测量逻辑已抽到 client/dock-align.ts（v0.28.2），
+    // 因为第二个 dock 条目（会话级知识库选择器）加进来时它没有对齐 —— 规则只写在
+    // 这里，别人看不见。
     React.useLayoutEffect(() => {
       const wrap = wrapRef.current
       if (wrap === null) return
-      /**
-       * Find the composer input CARD: climb from the dock entry until an
-       * ancestor's subtree contains a wide text field (>300px — the composer
-       * input; dock entries' own inputs are small), then take the widest box
-       * between that field and its containing column (the visible card).
-       */
-      const findCard = (): HTMLElement | null => {
-        let input: Element | null = null
-        let column: HTMLElement | null = null
-        let node: HTMLElement | null = wrap
-        while (node !== null && node !== document.documentElement) {
-          node = node.parentElement
-          if (node === null) break
-          for (const el of node.querySelectorAll('textarea, [contenteditable]:not([contenteditable="false"]), [role="textbox"]')) {
-            if (el.getBoundingClientRect().width > 300) { input = el; column = node; break }
-          }
-          if (column !== null) break
-        }
-        if (input === null || column === null) return null
-        const colW = column.getBoundingClientRect().width
-        let cur: HTMLElement | null = input as HTMLElement
-        let card: HTMLElement | null = null
-        let cardW = 0
-        while (cur !== null && cur !== column) {
-          const w = cur.getBoundingClientRect().width
-          if (w > 0 && w < colW - 8 && w >= cardW) { cardW = w; card = cur }
-          cur = cur.parentElement
-        }
-        return card
-      }
-      /** 测量一次对齐；返回 true = 找到了 composer 输入卡片（测量有效）。 */
-      const align = (): boolean => {
-        const wrapRect = wrap.getBoundingClientRect()
-        const card = findCard()
-        const right = card !== null ? card.getBoundingClientRect().right : wrapRect.right
-        const pad = Math.max(0, wrapRect.right - right)
-        if (wrap.style.paddingRight !== `${pad}px`) wrap.style.paddingRight = `${pad}px`
-        return card !== null
-      }
-      align()
-      // 侧边栏开/关会改变对话列宽度 → composer 输入卡片（居中、有 max-width）的
-      // 右缘随之移动。旧实现只观察了 dock 容器，侧边栏变化时它不一定触发 resize，
-      // 导致按钮停在上次的位置、不再对齐。这里观察「从 dock 条目一直到对话根节点
-      // （带 data-phase）的整条祖先链」，任一祖先尺寸变化都会重测对齐。
-      const ro = new ResizeObserver(align)
-      let node: Element | null = wrap
-      while (node !== null && node !== document.documentElement) {
-        ro.observe(node)
-        if (node instanceof HTMLElement && node.hasAttribute('data-phase')) break
-        node = node.parentElement
-      }
-      window.addEventListener('resize', align)
-      document.addEventListener('visibilitychange', align)
-      // 自愈兜底：任何未观测到的布局变化（侧边栏切换、插件重渲染等）也会在
-      // 1.5s 内被纠正；每帧只是几次 getBoundingClientRect 读取，开销可忽略。
-      // 但常驻定时器没有必要：连续 3 次测量成功（找到 composer 输入卡片）即认为
-      // 布局已稳定，清掉 interval；即使一直测不到（异常 shell），也在 20 次后
-      // 强制收手，之后由 ResizeObserver + resize + visibilitychange 覆盖。
-      let guardHits = 0
-      let guardTicks = 0
-      const guard = window.setInterval(() => {
-        guardTicks++
-        if (!align()) {
-          if (guardTicks >= 20) window.clearInterval(guard)
-          return
-        }
-        guardHits++
-        if (guardHits >= 3) window.clearInterval(guard)
-      }, 1500)
-      // The composer card may mount slightly later; re-measure a couple of times.
-      const t1 = window.setTimeout(align, 120)
-      const t2 = window.setTimeout(align, 600)
-      return () => {
-        ro.disconnect()
-        window.removeEventListener('resize', align)
-        document.removeEventListener('visibilitychange', align)
-        window.clearInterval(guard)
-        window.clearTimeout(t1)
-        window.clearTimeout(t2)
-      }
+      return alignDockEntry(wrap)
     }, [])
     const native = mode === 'native'
     const label = native ? '快速笔记' : (open ? '快速笔记（已打开）' : '快速笔记')

package/src/client/sidebar-entry.ts

@@ -11,6 +11,8 @@
  */
 import type { PanelState } from './state.ts'
 import { fetchUiConfig, subscribeUiConfig } from './ui-config.ts'
+import { fetchStatus } from './status-cache.ts'
+import { resolveFocusWiki, setFocusWiki, subscribeFocusWiki } from './wiki-focus.ts'
 
 /** Stable data attribute identifying this entry row. */
 export const ENTRY_SELECTOR = '[data-dsh-tw-entry]'
@@ -46,13 +48,24 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
   return buttons.find(button => !button.matches(ENTRY_SELECTOR) && /新会话|新建会话|new session/i.test(button.textContent ?? ''))
 }
 
-/** Build the entry row (a detached button; insert once the shell is up). */
-function createEntry(state: PanelState, label: string): { entry: HTMLButtonElement; labelEl: HTMLSpanElement } {
+/**
+ * Build one entry row (a detached button; inserted once the shell is up).
+ *
+ * `wikiId` is optional and only used in multi-wiki mode: clicking the row focuses
+ * that knowledge base before toggling the panel, so the row a user clicks is the
+ * wiki they get. Single-wiki installs pass nothing and behave exactly as before.
+ */
+function createEntry(
+  state: PanelState,
+  label: string,
+  wikiId?: 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 知识库')
+  if (wikiId !== undefined) entry.dataset.wiki = wikiId
+  entry.setAttribute('aria-label', `TiddlyWiki 知识库：${label}`)
   const icon = document.createElement('span')
   icon.className = 'dsh-tw-entry-icon'
   icon.innerHTML = ICON
@@ -60,7 +73,11 @@ function createEntry(state: PanelState, label: string): { entry: HTMLButtonEleme
   labelEl.className = 'dsh-tw-entry-label'
   labelEl.textContent = label
   entry.append(icon, labelEl)
-  entry.addEventListener('click', () => { state.toggle() })
+  entry.addEventListener('click', () => {
+    // 多库：先把这个库设为「焦点库」，面板随后加载它自己的 /tw/<id>/。
+    if (wikiId !== undefined) setFocusWiki(wikiId)
+    state.toggle()
+  })
   return { entry, labelEl }
 }
 
@@ -98,7 +115,10 @@ function placeEntry(root: HTMLElement, entry: HTMLButtonElement): boolean {
  * @returns disposer removing the entry and its observers.
  */
 export function mountSidebarEntry(state: PanelState): () => void {
+  /** 多库：每个**在运行**的库一个入口行，用自己的显示名（作者 2026-09-28 要求）。 */
+  const rows = new Map<string, { entry: HTMLButtonElement; labelEl: HTMLSpanElement }>()
   const { entry, labelEl } = createEntry(state, 'TiddlyWiki')
+  rows.set('', { entry, labelEl })
   let disposed = false
   /**
    * 自定义显示名：/status 返回 ui.sidebarLabel（设置页「侧边栏入口显示名称」）。
@@ -114,6 +134,60 @@ export function mountSidebarEntry(state: PanelState): () => void {
   }
   void applyLabel()
   const unsubscribeLabel = subscribeUiConfig(() => { void applyLabel() })
+
+  /**
+   * 多库：给**每个在运行**的库挂一个入口行（v0.28.2，作者要求"有多少个 wiki 启动了就按
+   * 各自的展示名称显示入口"）。
+   *
+   * 为什么只列「在运行」的：一个入口行点了就该能打开那个库；没在跑的库点开会先卡在启动
+   * 上。没在跑的库仍可从右下角「知识库」菜单启动（那里会把它们列全，并标注"未运行"）。
+   *
+   * 单库模式（名册 ≤1）：沿用**原来那一个**行与 ui.sidebarLabel —— 行为逐字不变。
+   */
+  const applyRoster = async (): Promise<void> => {
+    const payload = await fetchStatus()
+    if (disposed) return
+    const list = Array.isArray(payload?.wikis) ? payload.wikis : []
+    const running = list.filter((w) => w.running)
+    // 单库：不建额外行，标签仍归 ui.sidebarLabel 管。
+    if (running.length <= 1) {
+      for (const [key, row] of rows) {
+        if (key === '') continue
+        row.entry.remove()
+        rows.delete(key)
+      }
+      entry.hidden = false
+      return
+    }
+    // 多库：默认那行让位给每个库自己的行（否则会出现一个没有库名的第 4 行）。
+    entry.hidden = true
+    const wanted = new Set(running.map((w) => w.id))
+    // 移除已不在运行/已删除的库
+    for (const [key, row] of rows) {
+      if (key === '' || wanted.has(key)) continue
+      row.entry.remove()
+      rows.delete(key)
+    }
+    // 新增/更新
+    for (const w of running) {
+      let row = rows.get(w.id)
+      if (row === undefined) {
+        row = createEntry(state, w.label, w.id)
+        rows.set(w.id, row)
+      }
+      row.labelEl.textContent = w.label
+      row.entry.setAttribute('aria-label', `TiddlyWiki 知识库：${w.label}`)
+      // 当前焦点库高亮
+      const focused = resolveFocusWiki(running, payload?.defaultId) === w.id
+      if (focused) row.entry.dataset.focus = 'true'
+      else delete row.entry.dataset.focus
+    }
+    // 让放置逻辑把新行插进去（复用同一个 root）
+    if (root !== undefined) { placed = false; tryPlace() }
+  }
+  void applyRoster()
+  const unsubscribeFocus = subscribeFocusWiki(() => { void applyRoster() })
+  const rosterTimer = window.setInterval(() => { void applyRoster() }, 10_000)
   let root: HTMLElement | undefined
   let placed = false
   /** 兜底轮询定时器：只在「尚未放置」或「shell 重建了 root」时运行。 */
@@ -135,6 +209,10 @@ export function mountSidebarEntry(state: PanelState): () => void {
     }, 2_000)
   }
 
+  /** 当前应该出现在侧边栏里的行（隐藏的默认行不算）。 */
+  const activeRows = (): HTMLButtonElement[] =>
+    [...rows.values()].map((r) => r.entry).filter((el) => !el.hidden)
+
   const tryPlace = (): void => {
     if (root !== undefined && !root.isConnected) {
       rootObserver.disconnect()
@@ -144,7 +222,7 @@ export function mountSidebarEntry(state: PanelState): () => void {
       startRetry()
     }
     if (placed) {
-      if (document.body.contains(entry)) return
+      if (activeRows().every((el) => document.body.contains(el))) return
       rootObserver.disconnect()
       root = undefined
       placed = false
@@ -152,7 +230,12 @@ export function mountSidebarEntry(state: PanelState): () => void {
     }
     root ??= sidebarRoot()
     if (root === undefined) return
-    placed = placeEntry(root, entry)
+    // 逐行放置：多库时每一行都要插进侧边栏（顺序按 rows 的插入序）。
+    let any = false
+    for (const el of activeRows()) {
+      if (placeEntry(root, el)) any = true
+    }
+    placed = any
     if (placed) {
       // 放置成功即停掉兜底轮询：后续自愈由 rootObserver/waitObserver 负责。
       stopRetry()
@@ -164,7 +247,7 @@ export function mountSidebarEntry(state: PanelState): () => void {
   const waitObserver = new MutationObserver(() => { tryPlace() })
   waitObserver.observe(document.body, { childList: true, subtree: true })
 
-  // Self-heal: re-insert in the same frame when a re-render displaces the row.
+  // Self-heal: re-insert in the same frame when a re-render displaces the rows.
   const rootObserver = new MutationObserver(() => {
     if (root === undefined || !root.isConnected) {
       placed = false
@@ -172,7 +255,9 @@ export function mountSidebarEntry(state: PanelState): () => void {
       tryPlace()
       return
     }
-    if (!root.contains(entry)) placed = placeEntry(root, entry)
+    for (const el of activeRows()) {
+      if (!root.contains(el)) placeEntry(root, el)
+    }
   })
 
   // Belt-and-braces: a late shell mount with no further mutations still heals.
@@ -180,8 +265,11 @@ export function mountSidebarEntry(state: PanelState): () => void {
   startRetry()
 
   const syncActive = (): void => {
-    if (state.isOpen()) entry.dataset.active = 'true'
-    else delete entry.dataset.active
+    // 面板是共享的：所有行一起高亮/取消，用户看到的"打开中"状态才一致。
+    for (const el of activeRows()) {
+      if (state.isOpen()) el.dataset.active = 'true'
+      else delete el.dataset.active
+    }
   }
   const unsubscribe = state.subscribe(syncActive)
   syncActive()
@@ -190,10 +278,13 @@ export function mountSidebarEntry(state: PanelState): () => void {
   return () => {
     disposed = true
     clearInterval(retry)
+    window.clearInterval(rosterTimer)
     waitObserver.disconnect()
     rootObserver.disconnect()
     unsubscribe()
     unsubscribeLabel()
-    entry.remove()
+    unsubscribeFocus()
+    for (const row of rows.values()) row.entry.remove()
+    rows.clear()
   }
 }

package/src/client/styles.ts

@@ -24,6 +24,9 @@ const CSS_TEXT = `
 }
 .dsh-tw-entry:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); color: var(--dsw-alias-label-primary, inherit); }
 .dsh-tw-entry[data-active="true"] { background: var(--dsw-alias-interactive-bg-active, rgba(128,128,128,.18)); color: var(--dsw-alias-label-primary, inherit); font-weight: 500; }
+/* 多库（v0.28.2）：每库一个入口行，当前焦点库加一条左侧标线，和「面板正打开哪个库」区分开
+   —— 面板是同一个，但焦点库决定它加载谁。 */
+.dsh-tw-entry[data-focus="true"] { box-shadow: inset 2px 0 0 0 var(--dsw-alias-brand-primary, #3e63dd); }
 .dsh-tw-entry svg { flex: none; }
 .dsh-tw-entry .dsh-tw-entry-label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 /* Collapsed rail: the shell narrows the sidebar to a 56px icon rail (dual
@@ -501,8 +504,13 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 /* ── 会话级知识库选择器（v0.28.0，同一个 conversation.input.dock 槽位）──
    与快速笔记按钮同区、纵向 flex 排列；只在"多于一个可见库"时渲染（组件自己返回
    null），所以单库安装这一整块都不存在。 */
+/* ── 会话级知识库选择器（v0.28.0，同一个 conversation.input.dock 槽位）──
+   与快速笔记按钮同区、纵向 flex 排列；只在"多于一个可见库"时渲染（组件自己返回
+   null），所以单库安装这一整块都不存在。
+   justify-content: flex-end 与 JS 测得的 paddingRight 一起把右缘对齐 composer
+   输入框（见 client/dock-align.ts）—— 与 .dsh-tw-dock-note 同一套做法。 */
 .dsh-tw-scope-dock {
-  display: flex; align-items: center; gap: 8px; flex-wrap: wrap;
+  display: flex; align-items: center; justify-content: flex-end; gap: 8px; flex-wrap: wrap;
   padding: 4px 8px 0; box-sizing: border-box; width: 100%; font-size: 12px;
 }
 .dsh-tw-scope-label { opacity: .7; }
@@ -515,6 +523,11 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 .dsh-tw-scope-note { opacity: .75; }
 /* 快速笔记卡片的目标库选择（v0.28.0，R7）：只在多库时出现。 */
 .dsh-tw-note-wiki { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; }
+/* ⚠️ hidden 属性在 CSS 里只是 display:none，**任何显式 display 都能盖掉它** ——
+   上面那条 display:inline-flex 就盖掉了，于是单库模式下这个空下拉照样显示出来
+   （作者 2026-09-28 报障："有个写入下拉，但是没有选项"）。显式尊重 hidden，
+   并把这一条写在后面（同优先级靠后者生效）。 */
+.dsh-tw-note-wiki[hidden] { display: none; }
 .dsh-tw-note-wiki-label { opacity: .7; }
 .dsh-tw-note-wiki-select {
   border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
@@ -522,6 +535,7 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
   padding: 2px 6px; border-radius: 999px; max-width: 220px;
 }
 .dsh-tw-note-wiki-hint { font-size: 12px; opacity: .75; }
+.dsh-tw-note-wiki-hint[hidden] { display: none; }
 
 /* ── input-dock quick-note button（聊天输入框上方，conversation.input.dock）──
    该槽位渲染为「输入框上方的全宽条目」纵向 flex 排列（todo/cost-meter/goal/

package/src/client/wiki-scope-dock.ts

@@ -21,6 +21,7 @@
  */
 import * as React from 'react'
 import { fetchStatus } from './status-cache.ts'
+import { alignDockEntry } from './dock-align.ts'
 import { SESSION_WIKI_ENDPOINT } from './endpoints.ts'
 
 interface WikiOption { id: string; label: string; running: boolean }
@@ -39,6 +40,16 @@ export function createWikiScopeDock(): (props: DockProps) => React.ReactElement
     const [scope, setScope] = React.useState('')
     const [note, setNote] = React.useState<string | undefined>(undefined)
     const [busy, setBusy] = React.useState(false)
+    const wrapRef = React.useRef<HTMLDivElement | null>(null)
+
+    // 与 composer 输入框右缘对齐（v0.28.2）：dock 槽位渲染成输入框的**兄弟节点**，
+    // 不做这一步这一行就悬在整列最右端（作者报障："没有和输入框对齐"）。测量逻辑
+    // 与快速笔记共用一份 —— client/dock-align.ts。
+    React.useLayoutEffect(() => {
+      const wrap = wrapRef.current
+      if (wrap === null) return
+      return alignDockEntry(wrap)
+    }, [])
 
     React.useEffect(() => {
       if (sessionId === undefined) return
@@ -91,7 +102,7 @@ export function createWikiScopeDock(): (props: DockProps) => React.ReactElement
 
     return React.createElement(
       'div',
-      { className: 'dsh-tw-scope-dock' },
+      { ref: wrapRef, className: 'dsh-tw-scope-dock' },
       React.createElement('span', { className: 'dsh-tw-scope-label' }, '知识库'),
       React.createElement(
         'select',

package/src/host/seed-notes.ts

@@ -64,6 +64,28 @@ const DOC_NOTE_TAIL = `* **TW 编辑器面板**：侧边栏「TiddlyWiki」按
 * **设置页**：DSH 设置 → 「TiddlyWiki 知识库」管理插件/主题/语言与运行配置（含「知识库」按钮相关显示开关）。
 * **注入给 Agent 的提示词可配置**（设置页「系统提示词」区块）：默认**精简版**只约定同步纪律/标签/链接格式（工具参数由工具 schema 提供，不重复）；可切完整版（附参数索引）、追加自定义规范（\`extra\`）、整段替换（\`override\`）或整体停用。保存即生效，无需重启 dsh web；点「查看当前注入文本」可预览下一步实际注入的全文。
 
+!! 多知识库（v0.28.0 起）
+
+同一个 dsh web 里可以**同时跑多个知识库**，每个库独立配置、独立 git，各自一个 TW 子进程。
+
+* **现在有几个库？**右下角「知识库」按钮的菜单会列出全部（● 是当前打开的那个）；输入框上方也会有「知识库」下拉，用来选**本会话**让 Agent 用哪个库（单选，选择会被记住）。
+* **加一个库**：DSH 设置 → 「TiddlyWiki 知识库」→ **知识库列表** → 填根目录 + 文件夹名 →「添加知识库」。目录不存在会自动初始化一个全新库；已存在的目录直接接管。
+* **让某个库对 Agent 隐身**：知识库列表里点该行「对 Agent 隐身」。隐身 = Agent 永远碰不到它（不进检索、不进工具、不进会话选择器），**你自己照常用**——适合只读语料、书籍扫描、导入归档。
+* **每个库一套设置**：笔记标签、语言、主题、提示词都在该库自己的配置里。设置页顶部会显示「**配置作用域**：…」，点某一行「配置」即可切换在编辑哪个库。
+* **git 按仓库生效**：多个库可以共用一个仓库（例如两个库是同一仓库下的两个子目录），也可以各自独立仓库。共用仓库时只有一个自动提交者，pull 后只重启内容真的变了的库。
+* **想拆分现有的大库**：见设置页文档或仓库里的 \`docs/wiki-split.md\`——那里有一段可以直接复制给 Agent 的话，它会先只读体检、再问你几个问题、出方案等你确认后才动手。
+
+!! 从旧版本升级上来（重要）
+
+**升级后不会自动变成多库**，仍然是单库模式（\`mode: single\`），行为与升级前完全一致。
+
+* **想继续用单库**：什么都不用做。设置页里「知识库位置（可切换）」只在单库模式出现，用法和以前一样。
+* **想开始用多库**：去设置页「知识库列表」添加第二个库，再把「运行模式」切到**多库**。此后清单里的库都会可用（标了「开局自启」的随 DSH 启动，其余在你打开或选中它时启动）。
+* **控制文件在哪**：\`$DSH_HOME/dsh-tiddlywiki/wikis.json\`（在每本 wiki **之外**，所以它不会随某个库被搬走）。模式、默认库、库清单都在里面；也可以在设置页里改，效果一样。
+* **旧的「知识库位置」指针文件**（\`location.json\`）在单库模式下仍然是权威的——多库模式下它不再参与，改由清单决定。
+* **每个库要有自己的 \`tiddlywiki.info\`**：把一个大库拆成多个目录时，每个目录都要有一个（缺了 TW 认不出它是库）。从旧库整体搬过来的目录通常已经有了。
+* **拆分大库的注意**：书籍/语料这类只读内容建议**独立仓库 + 对 Agent 隐身**；工作与个人笔记可以共用一个仓库、按子目录划分。搬运用 \`git mv\` 保留历史，别用\"复制粘贴再删\"。
+
 !! 知识库纪律（四条）
 
 1. 开工先 \`tiddlywiki_git_sync action=pull\`（rebase + autostash，真冲突会自动 abort 并报文件）。