dsh-tiddlywiki 0.28.13 → 0.29.0

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

package/src/client/knowledge-fab.ts

@@ -145,8 +145,40 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
     renderTip()
   }
 
+  /** Snapshot `build()` rendered from — lets the click path notice a stale menu. */
+  let currentFlags: UiFlags | undefined
+  let currentRoster: FabRoster | undefined
+
+  /** 名册是否变过（新增 / 移除 / 改名 / 启停库）。 */
+  const rosterChanged = (before: FabRoster, after: FabRoster): boolean => {
+    if (before.mode !== after.mode || before.defaultId !== after.defaultId) return true
+    if (before.wikis.length !== after.wikis.length) return true
+    return before.wikis.some((wiki, i) => {
+      const next = after.wikis[i]
+      return next === undefined || next.id !== wiki.id || next.label !== wiki.label || next.running !== wiki.running
+    })
+  }
+
+  /** 打开菜单 —— 点击路径与「名册变了，先重建再打开」共用这一份。 */
+  const openMenuNow = (): void => {
+    if (menu === undefined) return
+    menuOpen = true
+    menu.hidden = false
+    // 每次打开都重画一次选中标记（v0.28.3）：切库可能发生在菜单关着的时候
+    // （侧边栏入口、快速笔记卡片），不重画就会显示上一次的选中项。
+    repaintWikiMenu?.()
+    renderDot()
+    void refreshTwStatus()
+  }
+
   const build = (flags: UiFlags, roster: FabRoster): void => {
     if (disposed) return
+    currentFlags = flags
+    currentRoster = roster
+    // 重建路径会再次调用 build()：旧的 document 监听必须先摘掉（同一个函数引用，
+    // 重复 add 会让菜单外的每一次点击都多跑一遍处理器）。
+    document.removeEventListener('click', onDocumentClick, true)
+    root?.remove()
     root = document.createElement('div')
     root.className = 'dsh-tw-fab-wrap'
 
@@ -305,15 +337,21 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
     dot.dataset.state = sync.getState().state
     fabBtn.append(icon, dot)
     fabBtn.addEventListener('click', () => {
-      if (menu === undefined) return
       if (menuOpen) { closeMenu(); return }
-      menuOpen = true
-      menu.hidden = false
-      // 每次打开都重画一次选中标记（v0.28.3）：切库可能发生在菜单关着的时候
-      // （侧边栏入口、快速笔记卡片），不重画就会显示上一次的选中项。
-      repaintWikiMenu?.()
-      renderDot()
-      void refreshTwStatus()
+      // 名册可能在界面开着的时候变（新增 / 移除 / 改名 / 启停库）。
+      // v0.29.0：打开前对一次账，变了就整块重建 —— 此前只在挂载时读一次，
+      // 于是菜单里少一个库 / 高亮错行，点已移除的那一项还会把面板指到
+      // `/tw/<gone>/`（侧边栏入口是每 10s 重读 /status 的，只有这里不会）。
+      void (async () => {
+        const fresh = await fetchRoster().catch(() => undefined)
+        if (disposed) return
+        if (fresh !== undefined && currentRoster !== undefined && currentFlags !== undefined && rosterChanged(currentRoster, fresh)) {
+          build(currentFlags, fresh)
+          openMenuNow()
+          return
+        }
+        openMenuNow()
+      })()
     })
 
     root.append(menu, fabBtn)

package/src/client/note-widget.ts

@@ -119,9 +119,65 @@ export function createNoteWidget(): NoteWidgetHandle {
   let rosterMode = 'single'
   /** The knowledge-base roster (empty in single mode / before /status lands). */
   let roster: Array<{ id: string; label: string; running: boolean }> = []
+  /** The registry default (its display name carries the 「（默认）」 mark). */
+  let defaultWikiId: string | undefined
   /** 焦点库订阅（dispose 需回收）。 */
   let focusOff: (() => void) | undefined
   const wikiQuery = (url: string): string => withWikiQuery(url, targetWiki)
+  /**
+   * DOM half of `ensureTarget()`: repaint the 「写入」 selector from `roster`.
+   *
+   * A no-op until the Markdown card has been built — which is exactly why the
+   * roster resolution can live OUTSIDE `build()` (v0.29.0). The native path
+   * never builds the card, so it gets no selector but must still get the wiki.
+   */
+  let syncTargetDom: () => void = () => {}
+  /**
+   * Resolve WHICH knowledge base this card works on, ONCE, for BOTH entry paths.
+   *
+   * v0.29.0. This lookup used to live inside `build()`, so only the Markdown card
+   * (`open()`) ever learned the roster. The DEFAULT click path is `openNative()`
+   * (直达 TW 原生编辑器), which never builds the card — `targetWiki` therefore
+   * stayed undefined and `rosterMode` stayed `'single'`, and every quick note was
+   * written into the **default** wiki and opened in the default wiki's editor
+   * while the user was reading another one. The 「写入」 selector that was
+   * supposed to make that impossible never appeared either, because it is part of
+   * the card. Silent, and only reachable in a multi-wiki install.
+   */
+  let targetPromise: Promise<void> | undefined
+  const ensureTarget = (): Promise<void> => {
+    targetPromise ??= fetchStatus().then((payload) => {
+      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 }))
+      // 单库：`targetWiki` 保持 undefined = 逐字与升级前相同的行为。
+      if (roster.length <= 1) return
+      defaultWikiId = typeof payload?.defaultId === 'string' ? payload.defaultId : undefined
+      const followFocus = (): void => {
+        if (!targetPicked) targetWiki = resolveFocusWiki(roster, defaultWikiId)
+      }
+      followFocus()
+      // 未在本卡片里手动选过时，跟随 GUI 的焦点库（你在看哪个库，笔记就进哪个库）。
+      focusOff ??= subscribeFocusWiki(() => {
+        followFocus()
+        syncTargetDom()
+      })
+      syncTargetDom()
+    })
+    return targetPromise
+  }
+  /**
+   * The resolved target, when it is known AND not running.
+   *
+   * `/note` / `/edit` refuse a stopped wiki instead of writing into the default
+   * one (v0.29.0), so the honest answer is to say so BEFORE the user writes a
+   * paragraph — the card has `wikiHint` for that, the native path has only us.
+   */
+  const stoppedTarget = (): { id: string; label: string } | undefined => {
+    if (targetWiki === undefined) return undefined
+    const item = roster.find((entry) => entry.id === targetWiki)
+    return item !== undefined && !item.running ? item : undefined
+  }
   let draftTimer: number | undefined
   let recentOpen = false
   /**
@@ -448,7 +504,10 @@ export function createNoteWidget(): NoteWidgetHandle {
     titleInput.className = 'dsh-tw-note-title'
     titleInput.placeholder = '标题（默认时间戳）'
     titleInput.setAttribute('aria-label', '笔记标题（默认时间戳）')
-    const tagEditor = buildTagEditor({ onChange: scheduleDraft })
+    // 标签建议必须来自**同一张卡片写入的那个库**（v0.29.0）：helper 一直支持
+    // `wikiQuery`，但这里漏传了，于是多库下建议列表来自默认库——点一个建议就把
+    // 一个只存在于别处的标签写进目标库。上传那两处一直是传的（见下）。
+    const tagEditor = buildTagEditor({ onChange: scheduleDraft, wikiQuery })
     fields.append(titleInput, tagEditor.el)
 
     // ── 目标知识库（v0.28.0，R7）────────────────────────────────────────────
@@ -488,16 +547,12 @@ export function createNoteWidget(): NoteWidgetHandle {
     })
 
     /**
-     * Read the roster and decide the card's default target (v0.28.0).
-     *
-     * Before this resolves, `targetWiki` is undefined = the plain endpoints, and
-     * with `roster.length <= 1` it STAYS undefined — a single-wiki install keeps
-     * byte-identical behaviour and never sees the selector.
+     * Paint the selector (+ the "not running" hint) from the resolved roster.
+     * `ensureTarget()` may have resolved BEFORE this card existed (the native path
+     * resolves it too), in which case it already called the no-op stub — so build()
+     * calls it once more here to catch up.
      */
-    void fetchStatus().then((payload) => {
-      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 }))
+    syncTargetDom = (): void => {
       // 单库：连选择器都不该存在。这里**还有一个**兜底 —— 除 `hidden` 外把 select 禁用、
       // 标签也藏掉，因为"能看见一个没有选项的下拉"比"什么都不显示"糟得多（v0.28.1 修）。
       if (roster.length <= 1) {
@@ -508,11 +563,6 @@ export function createNoteWidget(): NoteWidgetHandle {
       }
       wikiField.style.display = ''
       wikiSelect.disabled = false
-      const defaultId = typeof payload?.defaultId === 'string' ? payload.defaultId : undefined
-      const followFocus = (): void => {
-        if (!targetPicked) targetWiki = resolveFocusWiki(roster, defaultId)
-      }
-      followFocus()
       // 「默认库」不再作为选项出现（作者 2026-09-29 报障）：那个位置就是**被设为默认的那个
       // 库本身**，用它自己的显示名，只加「（默认）」作为身份标记。原来那个 `value=''` 的
       // 占位项其实是多余的 —— 清单里本来就有这个库，选中它写进去的就是它。
@@ -520,7 +570,7 @@ export function createNoteWidget(): NoteWidgetHandle {
         ...roster.map((item) => {
           const option = document.createElement('option')
           option.value = item.id
-          const mark = item.id === defaultId ? '（默认）' : ''
+          const mark = item.id === defaultWikiId ? '（默认）' : ''
           option.textContent = item.running ? `${item.label}${mark}` : `${item.label}${mark}（未运行）`
           return option
         }),
@@ -528,13 +578,8 @@ export function createNoteWidget(): NoteWidgetHandle {
       wikiSelect.value = targetWiki ?? ''
       wikiField.hidden = false
       markStopped()
-      // 未在本卡片里手动选过时，跟随 GUI 的焦点库（你在看哪个库，笔记就进哪个库）。
-      focusOff = subscribeFocusWiki(() => {
-        followFocus()
-        wikiSelect.value = targetWiki ?? ''
-        markStopped()
-      })
-    })
+    }
+    void ensureTarget().then(() => syncTargetDom())
     titleInput.addEventListener('input', scheduleDraft)
 
     // Mod-Enter save routes through doSave, which is assigned below (the editor
@@ -675,6 +720,13 @@ export function createNoteWidget(): NoteWidgetHandle {
         toast('内容为空，未保存')
         return
       }
+      // 「写入」选中的那个库没在跑：host 现在会拒绝（而不是写进默认库），
+      // 所以先说清楚，别让用户写完一整段才发现（v0.29.0）。
+      const stopped = stoppedTarget()
+      if (stopped !== undefined) {
+        toast(`「${stopped.label}」当前没在运行：先在右下角「知识库」菜单里打开它，或改「写入」目标`)
+        return
+      }
       saving = true
       saveBtn.disabled = true
       saveBtn.textContent = '保存中…'
@@ -854,6 +906,14 @@ export function createNoteWidget(): NoteWidgetHandle {
       if (isEditorPopupOpen() && !isEditorPopupBlank()) return
       nativeOpening = true
       try {
+        // v0.29.0: 必须先解析目标库 —— 这条路径不建卡片，此前因此**永远**写进默认库。
+        await ensureTarget()
+        if (disposed) return
+        const stopped = stoppedTarget()
+        if (stopped !== undefined) {
+          toast(`「${stopped.label}」当前没在运行：先在右下角「知识库」菜单里打开它，再记这条笔记`)
+          return
+        }
         const hit = loadDraft()
         const hasDraft = hit !== null && (hit.draft.text.trim().length > 0 || hit.draft.title.trim().length > 0)
         const title = hasDraft && hit.draft.title.trim().length > 0 ? hit.draft.title.trim() : timestampTitle()

package/src/client/panel.ts

@@ -76,6 +76,7 @@ const PANEL_SKIN: TwFrameSkin = {
   frameWrapStyle: 'flex:1;min-height:0;display:flex;flex-direction:column',
   frame: 'dsh-tw-panel-frame',
   error: 'dsh-tw-panel-error',
+  loading: 'dsh-tw-loading',
 }
 
 /**

package/src/client/rightbar-tab.ts

@@ -87,6 +87,11 @@ function TwRightbarTabBody(props: RightbarTabBodyProps): React.ReactElement {
     if (host === null) return
     const controller = createTwFrameController(host, tab.signal)
     controllerRef.current = controller
+    // 创建即应用一次可见性（v0.29.0）：如果 tab 记录被换掉（id/signal 变）而
+    // `visible` 仍是 true，下面的 effect 不会再跑（依赖没变），新控制器就永远
+    // 停在 `started = false` / iframe 隐藏 —— 右侧栏那块 tab 是空白的，直到用户
+    // 手动收起再展开。这里同步应用一次，两个 effect 谁先跑都不影响结果。
+    controller.setVisible(tab.visible)
     return () => {
       controller.dispose()
       controllerRef.current = null

package/src/client/session-summary.ts

@@ -44,7 +44,7 @@ import { GET_ENDPOINT, SESSION_SUMMARY_ENDPOINT as SUMMARY_ENDPOINT, withWikiQue
 import { fetchRenderFragment } from './render-fetch.ts'
 // 本会话作用域的知识库（v0.28.8）：汇总必须落在同一个库，否则标题条目在库里、
 // 渲染却去默认库找 → 一直「条目不存在」（见 wiki-scope.ts）。
-import { resolveSessionWikiId } from './wiki-scope.ts'
+import { resolveSessionWikiId, subscribeSessionWikiId } from './wiki-scope.ts'
 import { getTabLabel, setTabLabel } from './tw-frame.ts'
 
 /** conversation.view 槽位注册 id（模块私有，v0.22.8：只有本文件的 mount 用）。 */
@@ -313,6 +313,24 @@ function SessionSummaryView(props: SessionSummaryViewProps): React.ReactElement
     }
   }, [summaryTitle, generate])
 
+  /**
+   * 会话作用域一变就重生成（v0.29.0）。
+   *
+   * 为什么必须订阅而不是等下一轮：汇总缓存的是**某个库**的成品，还有 3 分钟的按时间
+   * 刷新节拍；选择器切库时只清了 scope 缓存，所以此前切库后最多三分钟仍显示旧库的内容
+   * 与旧库链接（`data-dsh-tw-wiki` 也是旧的）——正是这个模块存在的理由的反面。
+   * 手动刷新会清零失败额度，这里同样清零：换了库就是一次全新的生成。
+   */
+  React.useEffect(() => {
+    return subscribeSessionWikiId((changed) => {
+      if (typeof sessionId !== 'string' || sessionId.length === 0) return
+      if (changed !== undefined && changed !== sessionId) return
+      failuresRef.current = 0
+      lastGeneratedRef.current = 0
+      void generate()
+    })
+  }, [sessionId, generate])
+
   // 一次性 focus 请求直接确认（本视图无可聚焦子目标，避免 shell 挂起）。
   React.useEffect(() => {
     if (viewRequest !== null && viewRequest !== undefined) completeViewRequest?.()

package/src/client/settings-page-config.ts

@@ -44,6 +44,15 @@ export interface ConfigField {
  *  inputs (and never discards the user's unsaved edits). */
 export interface ConfigRenderState {
   signature?: string
+  /**
+   * The knowledge base this form was built for (v0.29.0).
+   *
+   * `signature` alone was not enough: two wikis can hold IDENTICAL config JSON, so
+   * switching 「配置」 from one to the other looked like "nothing changed" and kept
+   * the previous wiki's form — including its unsaved edits — which the next 保存配置
+   * then wrote into the NEW wiki (with a misleading 「配置在别处被改动过」 banner).
+   */
+  wiki?: string
   host?: HTMLElement
   /**
    * 最近一次保存失败的文案。保存失败后要 refresh()（顶部可能因此出现 configError

package/src/client/settings-page-runtime.ts

@@ -110,14 +110,9 @@ export function setEditingWiki(id: string | undefined): void {
  */
 export type SettingsTab = 'overview' | 'library' | 'global'
 
-/** 当前 Tab。模块级（与 editingWiki 同级）：切换 Tab 不重建配置表单。 */
+/** 当前 Tab（模块级，与 editingWiki 同级）：切换 Tab 不重建配置表单。 */
 export let activeTab: SettingsTab = 'overview'
 
-/** Read the current tab (the scope bar / render order use it). */
-export function currentTab(): SettingsTab {
-  return activeTab
-}
-
 /** Switch the tab WITHOUT re-rendering (callers `refresh()` themselves). */
 export function setActiveTab(tab: SettingsTab): void {
   activeTab = tab

package/src/client/settings-page.ts

@@ -105,6 +105,14 @@ function mountSettingsPage(container: HTMLElement): () => void {
    * 守门：`scripts/verify-plugin-runtime.mjs` 的「未碰过 ≠ 空集合」一节。
    */
   const catalogPending: CatalogPending = {}
+  /**
+   * 这份「未应用勾选」属于哪个库（v0.29.0）。
+   *
+   * 它是**要写进那个库 `tiddlywiki.info` 的清单**，所以只在同一个库内有意义：
+   * 在 A 库勾了几个插件、再点 B 库的「配置」，此前会把 A 的期望集合显示成 B 的，
+   * 点「应用」就把 A 的插件清单写进 B（并重启 B）。切库即作废。
+   */
+  let catalogScope: string | undefined
   /** 首屏是否已成功渲染过内容：决定占位提示与失败时能不能清 body。 */
   let rendered = false
   /**
@@ -137,7 +145,16 @@ function mountSettingsPage(container: HTMLElement): () => void {
       loadError.hidden = true
       loadError.replaceChildren()
       renderStatus(statusRow, state, refresh)
-      renderMain(body, state, refresh, () => disposed, configState, catalogPending, rosterMode)
+      renderMain(body, state, refresh, () => disposed, configState, catalogPending, rosterMode, () => {
+        // 库作用域变了：上一个库的「未应用勾选」立刻作废（见 catalogScope）。
+        if (catalogScope !== editingWiki) {
+          delete catalogPending.plugins
+          delete catalogPending.themes
+          delete catalogPending.languages
+          delete catalogPending.themeActive
+          catalogScope = editingWiki
+        }
+      })
     } catch (err) {
       if (disposed) return
       // 不再 body.replaceChildren() / statusRow.replaceChildren()：那会把已经渲染出来的
@@ -190,7 +207,10 @@ function renderStatus(row: HTMLElement, state: AdminState, refresh: () => Promis
     sync.textContent = '同步中…'
     void (async () => {
       try {
-        const res = await fetch(SYNC_ENDPOINT, { method: 'POST', signal: AbortSignal.timeout(120_000) })
+        // ⚠️ 必须带作用域（v0.29.0）：这两个按钮在同一行显示的是**正在配置的那个库**
+        // 的 git 概览/TW 状态，却不带 `?wiki=` —— 于是作用域条写着「正在配置：books」，
+        // 点下去 pull/commit/push（或重启）的是**默认库**，而且看起来一切正常。
+        const res = await fetch(withWiki(SYNC_ENDPOINT), { method: 'POST', signal: AbortSignal.timeout(120_000) })
         const payload = (await res.json().catch(() => null)) as SyncResultPayload | null
         const result = describeSyncResult(payload, res.status)
         toast(result.ok ? `同步完成：${result.message}` : `同步失败：${result.message}`)
@@ -213,7 +233,7 @@ function renderStatus(row: HTMLElement, state: AdminState, refresh: () => Promis
         // 120s 是显式的：宿主 /admin/restart 会等 TW 就绪才回包，软窗口默认 60s
         // （大知识库冷启动更久，v0.22.5 记录过 44s+），而 fetchJson 默认只给 15s ——
         // 于是宿主重启成功、前端却报「重启失败」。同一原因也命中过知识库切换。
-        await fetchJson(RESTART_ENDPOINT, { method: 'POST', signal: AbortSignal.timeout(120_000) })
+        await fetchJson(withWiki(RESTART_ENDPOINT), { method: 'POST', signal: AbortSignal.timeout(120_000) })
         toast('TW 已重启')
       } catch (err) {
         toast(`重启失败：${err instanceof Error ? err.message : String(err)}`)
@@ -321,8 +341,11 @@ function renderPickLibraryHint(body: HTMLElement): void {
     '插件管理（自带官方插件）/ 主题管理 / 语言管理 / 初始化，都是**按知识库**生效的。请先在「总览」里点某个库的「配置」，这里才会显示它们。'))
 }
 
-function renderMain(body: HTMLElement, state: AdminState, refresh: () => Promise<void>, isDisposed: () => boolean, configState: ConfigRenderState, catalogPending: CatalogPending, rosterMode?: string): void {
+function renderMain(body: HTMLElement, state: AdminState, refresh: () => Promise<void>, isDisposed: () => boolean, configState: ConfigRenderState, catalogPending: CatalogPending, rosterMode?: string, dropCatalogPendingOnScopeChange?: () => void): void {
   body.replaceChildren()
+  // 库作用域变了 → 先作废上一个库的「未应用勾选」（v0.29.0），再渲染任何东西：
+  // 否则渲染出来的复选框是 A 库的期望集合，而页面说的是 B 库（点应用就写错库）。
+  dropCatalogPendingOnScopeChange?.()
   // Loud, above everything else: an unparseable config tiddler means the config
   // block below shows DEFAULTS that are not actually in effect, and saving is
   // refused until it is fixed (v0.23.4 — that is how a user's prompt.extra /
@@ -336,19 +359,28 @@ function renderMain(body: HTMLElement, state: AdminState, refresh: () => Promise
   // a field (v0.20.0). The host element is re-appended as-is, so its inputs and
   // their pending values survive.
   const signature = JSON.stringify(state.config ?? {})
-  const serverChanged = configState.host !== undefined && configState.signature !== signature
+  // 库作用域也是「要不要重建」的一部分（v0.29.0）：两个库的配置内容可能**逐字相同**，
+  // 只比 config 就会把上一个库的表单（连同它的未保存改动）留给新库，保存时写错库。
+  const scopeChanged = configState.wiki !== editingWiki
+  const serverChanged = configState.host !== undefined && (scopeChanged || configState.signature !== signature)
   // 有未保存改动时**不重建**（v0.25.0）：重建会静默丢掉用户刚敲的内容（典型触发
   // 路径：另一个标签页保存了配置，或语言管理顺带写 uiLanguage → 本页 refresh()）。
   // 保留旧表单 + 显式提示，用户可以选择保存（覆盖别处的改动）或自己改回来。
+  // 例外：切库（scopeChanged）时那条提示是错的 —— 用户要的就是另一个库的表单，
+  // 上一个库的脏值本来就不该带过去。
   const dirty = configState.isDirty?.() === true
-  if (serverChanged && dirty) {
+  if (serverChanged && dirty && !scopeChanged) {
     body.append(makeErrorBanner('⚠️ 服务器上的配置在别处被改动过（另一个标签页保存 / 语言管理等），当前表单仍是旧值：直接点「保存配置」会以本页内容覆盖那些改动。'))
   }
-  if (configState.host === undefined || (serverChanged && !dirty)) {
+  // 重建的三种情况（v0.29.0：把"切库"单独加进来，但**不能**顺手改掉 v0.25.0 的保护）：
+  //   ① 还没有表单；② 用户切了库（他就是要另一个库的表单，旧库的脏值不该带过去）；
+  //   ③ 服务器变了且表单没有未保存改动。离开 ③ 的后半句就会静默丢掉用户刚敲的内容。
+  if (configState.host === undefined || scopeChanged || (serverChanged && !dirty)) {
     const host = make('div', 'dsh-tw-settings-confighost')
     renderConfigSection(host, state.config ?? {}, refresh, configState, rosterMode, isDisposed)
     configState.host = host
     configState.signature = signature
+    configState.wiki = editingWiki
   }
   // Tab 栏 + 作用域条（v0.28.8）：多库时页面按「总览 / 本库配置 / 全局」分开，
   // 并在最上方 sticky 地说明正在配置哪个库、随时可以退出。单库两者都不渲染，

package/src/client/sidebar-entry.ts

@@ -177,10 +177,19 @@ export function mountSidebarEntry(state: PanelState): () => void {
    * （见 `resolveEntryClick`）——判定必须与面板/内核用**同一套解析**：
    * 记忆值 → 默认库 → 第一个可用库（`resolveFocusWiki`）。
    */
-  let runningWikis: FocusableWiki[] = []
+  /** 完整名册（含未运行的库）——只用于解析"面板此刻显示哪个库"（v0.29.0）。 */
+  let rosterAll: FocusableWiki[] = []
   let defaultWikiId: string | undefined
-  /** 面板此刻显示的那个库。 */
-  const shownWiki = (): string | undefined => resolveFocusWiki(runningWikis, defaultWikiId)
+  /**
+   * 面板此刻显示的那个库。
+   *
+   * v0.29.0：必须按**完整名册**（含未运行的库）解析，与面板/内核同源 —— 内核用的就是
+   * 记住的那个 id 本身（`panel.ts` 的 `getFocusWiki`），只有名册里真的没有它才回落。
+   * 此前用的是"在运行的那些"，于是焦点库只是**没在跑**（还没起来 / 刚被停）时这里会
+   * 回落到默认库：高亮的那一行 ≠ 面板显示的库，而点那一行会被判成"切换"而不是收起
+   * （v0.28.13 修的是"点两次"的主观感受，这条是同一判定链上的第二个来源）。
+   */
+  const shownWiki = (): string | undefined => resolveFocusWiki(rosterAll, defaultWikiId)
   const entryHooks: EntryHooks = { state, shownWiki }
   const { entry, labelEl, iconEl } = createEntry(entryHooks, 'TiddlyWiki')
   rows.set('', { entry, labelEl, iconEl })
@@ -215,7 +224,8 @@ export function mountSidebarEntry(state: PanelState): () => void {
     const list = Array.isArray(payload?.wikis) ? payload.wikis : []
     const running = list.filter((w) => w.running)
     // 点击判定与高亮都要用同一份名册（v0.28.13）：存下来，`shownWiki()` 据此解析。
-    runningWikis = running
+    // 行只给"在运行"的库建（见函数头），但"显示的是哪个库"要按完整名册判断（v0.29.0）。
+    rosterAll = list
     defaultWikiId = payload?.defaultId
     // 单库：不建额外行，标签仍归 ui.sidebarLabel 管。
     if (running.length <= 1) {
@@ -247,16 +257,30 @@ export function mountSidebarEntry(state: PanelState): () => void {
       // 图标每次同步（v0.28.4）：在设置页改完图标，10s 内的轮询就会把它换过来。
       applyWikiIcon(row.iconEl, w.icon)
       row.entry.setAttribute('aria-label', `TiddlyWiki 知识库：${w.label}`)
-      // 当前焦点库高亮（与点击判定同源：`shownWiki()`，不会出现"高亮的行点一下反而关掉面板"）
-      const focused = shownWiki() === w.id
-      if (focused) row.entry.dataset.focus = 'true'
-      else delete row.entry.dataset.focus
     }
+    // 当前焦点库高亮：与点击判定同源（`shownWiki()`），不会出现"高亮的行点一下反而关掉面板"
+    paintFocus()
     // 让放置逻辑把新行插进去（复用同一个 root）
     if (root !== undefined) { placed = false; tryPlace() }
   }
   void applyRoster()
-  const unsubscribeFocus = subscribeFocusWiki(() => { void applyRoster() })
+  /**
+   * 焦点变化只需要重画**高亮**（v0.28.14）。
+   *
+   * 旧实现是 `subscribeFocusWiki(() => { void applyRoster() })`：每切一次库都**再打一次
+   * `/status`**（host 处理一次要跑最多 5 个 git 进程、实测 300–400ms）并把所有行重建一遍、
+   * 重新走一次放置逻辑。可是名册并没有变 —— 变的只是"哪一行亮着"。而那次往返正是
+   * 「点下去要等一下界面才动」的一部分（见 tw-frame.ts 的 switchFrameNow）。
+   */
+  const paintFocus = (): void => {
+    const focus = shownWiki()
+    for (const [key, row] of rows) {
+      if (key === '') continue
+      if (key === focus) row.entry.dataset.focus = 'true'
+      else delete row.entry.dataset.focus
+    }
+  }
+  const unsubscribeFocus = subscribeFocusWiki(paintFocus)
   const rosterTimer = window.setInterval(() => { void applyRoster() }, 10_000)
   let root: HTMLElement | undefined
   let placed = false

package/src/client/styles.ts

@@ -88,6 +88,16 @@ 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; }
 
+/* 换库提示条（v0.28.14）：换一份 wiki 文档要重新下载 10–30MB 且 TW 回 no-store（缓存不了），
+   那 1–2 秒里界面什么都不动 —— 这条就是"正在发生什么"的唯一说明。两个 TW 界面共用它：
+   它是 view 的最后一个孩子，在 flex column 里天然落在底部。 */
+.dsh-tw-loading {
+  flex: 0 0 auto; padding: 6px 12px; font-size: 12px; text-align: center;
+  color: var(--dsw-alias-label-secondary, #666);
+  background: var(--dsw-alias-bg-layer-2, rgba(128,128,128,.08));
+  border-top: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,.18));
+}
+
 /* ── 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. */

package/src/client/tool-views.ts

@@ -592,7 +592,9 @@ function BatchCard(props: { toolName: string; args: Record<string, unknown> }):
     .filter((t): t is string => t !== null && t.length > 0)
     .map((title) => ({ title }))
   // 批量写入的标题在挂载时失效缓存（effect 阶段，见 useInvalidateBodies）。
-  useInvalidateBodies(rows.map((row) => row.title))
+  // wikiId 必须带上（v0.29.0）：缓存键是 `wikiId\0title`，只按标题清会留下
+  // `A\0X`，之后同一篇的读取卡还能拿回被覆盖前的旧正文。
+  useInvalidateBodies(rows.map((row) => row.title), useScopedWikiId())
   return React.createElement(ListCard, {
     toolName: props.toolName,
     title: '批量写入',
@@ -657,7 +659,8 @@ function GitCard(props: { toolName: string; text: string }): React.ReactElement
 
 function DeleteCard(props: { toolName: string; title: string; text: string }): React.ReactElement {
   // 删除后同标题的缓存必须失效，否则紧跟着的读取卡会拿旧正文（effect 阶段执行）。
-  useInvalidateBodies([props.title])
+  // 同样必须带 wikiId（v0.29.0，理由见 BatchCard）。
+  useInvalidateBodies([props.title], useScopedWikiId())
   const body = props.title.length > 0
     ? React.createElement('div', { className: 'dsh-tw-toolcard-empty' }, `已删除 tiddler「${props.title}」`)
     : React.createElement('pre', { className: 'dsh-tw-toolcard-fallback' }, props.text || '（已删除）')