dsh-tiddlywiki 0.27.2 → 0.28.0

package/src/client/settings-page.ts

@@ -36,6 +36,7 @@ import {
   ADMIN_WIKI_LOCATION_ENDPOINT as WIKI_LOCATION_ENDPOINT,
   ADMIN_WIKI_RESET_ENDPOINT as WIKI_RESET_ENDPOINT,
   ADMIN_WIKI_SWITCH_ENDPOINT as WIKI_SWITCH_ENDPOINT,
+  ADMIN_WIKIS_ENDPOINT as WIKI_LIST_ENDPOINT,
   SYNC_ENDPOINT,
   describeSyncResult,
   type SyncResultPayload,
@@ -189,7 +190,7 @@ function mountSettingsPage(container: HTMLElement): () => void {
     // 首屏先给占位（v0.24.x）：以前 await 期间什么都不画，整块白屏看起来像插件坏了。
     if (!rendered) body.replaceChildren(make('div', 'dsh-tw-settings-muted', '加载中…'))
     try {
-      const state = await fetchJson<AdminState>(STATE_ENDPOINT)
+      const state = await fetchJson<AdminState>(withWiki(STATE_ENDPOINT))
       if (disposed) return
       rendered = true
       loadError.hidden = true
@@ -520,7 +521,7 @@ function renderConfigSection(body: HTMLElement, config: Record<string, unknown>,
         // Send the DRAFT (v0.22.7): the host builds the text from these values
         // without saving them, so the preview follows the dropdown immediately
         // instead of showing the still-saved mode until 保存配置 is clicked.
-        const data = await fetchJson<{ ok?: boolean; draft?: boolean; enabled?: boolean; mode?: string; length?: number; text?: string; error?: string }>(PROMPT_ENDPOINT, {
+        const data = await fetchJson<{ ok?: boolean; draft?: boolean; enabled?: boolean; mode?: string; length?: number; text?: string; error?: string }>(withWiki(PROMPT_ENDPOINT), {
           method: 'POST',
           headers: { 'content-type': 'application/json' },
           body: JSON.stringify({
@@ -604,7 +605,7 @@ function renderConfigSection(body: HTMLElement, config: Record<string, unknown>,
         return
       }
       try {
-        await fetchJson(CONFIG_ENDPOINT, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(patch) })
+        await fetchJson(withWiki(CONFIG_ENDPOINT), { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(patch) })
         // ui.* 已落盘：清掉客户端缓存，下一次读取立即拿到新值（否则最长 15s 才生效）。
         invalidateUiConfig()
         configState.saveError = undefined
@@ -931,6 +932,213 @@ function renderCatalogSection(
  * stops and restarts the TW child in place — a few seconds, and it can fail
  * (in which case the host rolls back and says so).
  */
+/** One knowledge base as `GET /admin/wikis` reports it (v0.28.0). */
+interface WikiListItemView {
+  id: string
+  label: string
+  root: string
+  name: string
+  path: string
+  agentVisible: boolean
+  autostart: boolean
+  running: boolean
+  status: string
+}
+
+/** `GET`/`POST /dsh-tiddlywiki/admin/wikis` payload (v0.28.0). */
+interface WikisView {
+  ok?: boolean
+  error?: string
+  mode?: string
+  defaultId?: string
+  source?: string
+  registryFile?: string
+  warnings?: string[]
+  wikis?: WikiListItemView[]
+  change?: { started?: string[]; stopped?: string[]; updated?: string[]; errors?: Array<{ id: string; message: string }> }
+}
+
+/**
+ * 知识库列表（v0.28.0）—— 设置页的**第一块**。
+ *
+ * 为什么排在最前：多库的其余一切都要先有第二个库才能用，而在此之前多库模式只能靠
+ * 手写 `$DSH_HOME/dsh-tiddlywiki/wikis.json` 打开。
+ *
+ * 它显示的是**控制文件**（用户编辑的那份），与"现在跑着什么"是两件事：single 模式下
+ * farm 跑的是从旧指针合成的单条清单，而文件里可能已经列了好几个候选。所以每行同时给出
+ * 「在不在清单里」与「现在跑没跑」。
+ *
+ * 关于「编辑哪个库的配置」：常规配置区作用于**默认库**（★ 那一行）——多库时这是刻意的
+ * 简化，`git.*` 实际按仓库生效（见下），其余字段各库自己一份。
+ */
+function renderWikiListSection(body: HTMLElement, isDisposed: () => boolean, refresh: () => Promise<void>): void {
+  const section = make('section', 'dsh-tw-settings-section')
+  section.append(make('h3', 'dsh-tw-settings-h', '知识库列表'))
+  const status = make('div', 'dsh-tw-settings-muted', '读取中…')
+  const modeRow = make('div', 'dsh-tw-settings-row')
+  const list = make('div')
+  const addRoot = make('input', 'dsh-tw-settings-input')
+  addRoot.placeholder = '根目录（绝对路径，如 D:\\notes）'
+  const addName = make('input', 'dsh-tw-settings-input')
+  addName.placeholder = '文件夹名（如 books）'
+  const addLabel = make('input', 'dsh-tw-settings-input')
+  addLabel.placeholder = '显示名（留空用文件夹名）'
+  const addBtn = make('button', 'dsh-tw-settings-btn dsh-tw-settings-primary', '添加知识库')
+  addBtn.type = 'button'
+  const addRow = make('div', 'dsh-tw-settings-row dsh-tw-settings-field')
+  addRow.append(addRoot, addName, addLabel, addBtn)
+  const hint = make('div', 'dsh-tw-settings-muted', '多库模式下每个知识库是一个独立的 TW 子进程（约 150MB）：标了「开局自启」的随 DSH 一起起，其余在你打开或选中它时启动。对 Agent 隐身的库不进会话选择器，检索/工具也永远不碰它。')
+  section.append(status, modeRow, list, addRow, hint)
+  body.append(section)
+
+  /** One action, then re-read (the response already carries the new state). */
+  const post = async (payload: Record<string, unknown>, busyLabel: string): Promise<void> => {
+    status.textContent = busyLabel
+    try {
+      const data = await fetchJson<WikisView>(WIKI_LIST_ENDPOINT, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify(payload),
+        // 新增/启动一个库可能要 `--init server` 并冷启动 TW（实测大库 40s+）。
+        signal: AbortSignal.timeout(180_000),
+      })
+      if (isDisposed()) return
+      const failures = data.change?.errors ?? []
+      if (failures.length > 0) toast(`部分操作失败：${failures.map((item) => `${item.id}：${item.message}`).join('；')}`)
+      render(data)
+      await refresh()
+    } catch (err) {
+      if (isDisposed()) return
+      toast(`操作失败：${err instanceof Error ? err.message : String(err)}`)
+      await load()
+    }
+  }
+
+  const render = (view: WikisView): void => {
+    status.textContent = view.error !== undefined && view.error.length > 0 ? `⚠️ ${view.error}` : ''
+    modeRow.replaceChildren(make('span', 'dsh-tw-settings-label', '运行模式：'))
+    const modes: Array<[string, string]> = [
+      ['single', '单库（只跑默认库）'],
+      ['multi', '多库（清单里的库都可用）'],
+    ]
+    for (const [value, text] of modes) {
+      const active = view.mode === value
+      const chip = make('button', `dsh-tw-settings-btn dsh-tw-settings-chipbtn${active ? ' dsh-tw-settings-primary' : ''}`, text)
+      chip.type = 'button'
+      chip.disabled = active
+      chip.addEventListener('click', () => {
+        const ok = window.confirm(value === 'multi'
+          ? '切换到多库模式：清单里标了「开局自启」的知识库都会启动（每个库一个 TW 子进程）。继续？'
+          : '切换到单库模式：除默认库外的知识库会被停掉（内容与清单都不受影响）。继续？')
+        if (ok) void post({ action: 'set-mode', mode: value }, '切换模式中…')
+      })
+      modeRow.append(chip)
+    }
+
+    list.replaceChildren()
+    const wikis = view.wikis ?? []
+    for (const wiki of wikis) {
+      const row = make('div', 'dsh-tw-settings-kbrow')
+      const isDefault = wiki.id === view.defaultId
+      row.append(make('div', 'dsh-tw-settings-label', `${isDefault ? '★ ' : ''}${wiki.label}（${wiki.id}）`))
+      row.append(make('div', 'dsh-tw-settings-muted', [
+        wiki.running ? '运行中' : '未运行',
+        wiki.agentVisible ? 'Agent 可见' : 'Agent 隐身',
+        wiki.autostart ? '开局自启' : '按需启动',
+        wiki.path,
+      ].join(' · ')))
+
+      const actions = make('div', 'dsh-tw-settings-row')
+      // 「配置」把常规配置区切到这个库（每个库的配置存在它自己的 config tiddler 里，
+      // 不说清楚就会出现"改了但不生效"）。
+      const configuring = editingWiki === wiki.id
+      const configure = make('button', `dsh-tw-settings-btn dsh-tw-settings-chipbtn${configuring ? ' dsh-tw-settings-primary' : ''}`, configuring ? '正在配置' : '配置')
+      configure.type = 'button'
+      configure.disabled = configuring
+      configure.addEventListener('click', () => {
+        editingWiki = wiki.id
+        void refresh()
+      })
+      const power = make('button', 'dsh-tw-settings-btn dsh-tw-settings-chipbtn', wiki.running ? '停止' : '启动')
+      power.type = 'button'
+      power.addEventListener('click', () => {
+        void post({ action: wiki.running ? 'stop' : 'start', id: wiki.id }, wiki.running ? '停止中…' : '启动中…')
+      })
+      const makeDefault = make('button', 'dsh-tw-settings-btn dsh-tw-settings-chipbtn', '设为默认')
+      makeDefault.type = 'button'
+      makeDefault.disabled = isDefault
+      makeDefault.addEventListener('click', () => { void post({ action: 'set-default', id: wiki.id }, '保存中…') })
+      const visibility = make('button', 'dsh-tw-settings-btn dsh-tw-settings-chipbtn', wiki.agentVisible ? '对 Agent 隐身' : '对 Agent 可见')
+      visibility.type = 'button'
+      visibility.addEventListener('click', () => {
+        void post({ action: 'update', wiki: { ...wiki, agentVisible: !wiki.agentVisible } }, '保存中…')
+      })
+      const autostart = make('button', 'dsh-tw-settings-btn dsh-tw-settings-chipbtn', wiki.autostart ? '取消开局自启' : '开局自启')
+      autostart.type = 'button'
+      autostart.addEventListener('click', () => {
+        void post({ action: 'update', wiki: { ...wiki, autostart: !wiki.autostart } }, '保存中…')
+      })
+      const remove = make('button', 'dsh-tw-settings-btn dsh-tw-settings-chipbtn', '移出列表')
+      remove.type = 'button'
+      remove.disabled = wikis.length <= 1
+      remove.addEventListener('click', () => {
+        const ok = window.confirm(`把「${wiki.label}」移出清单？\n\n**目录与内容不会被删除**（仍在 ${wiki.path}），只是插件不再管理它。`)
+        if (ok) void post({ action: 'remove', id: wiki.id }, '移出中…')
+      })
+      actions.append(configure, power, makeDefault, visibility, autostart, remove)
+      row.append(actions)
+      list.append(row)
+    }
+    // 新增时默认沿用第一个库的根目录（多数情况就是同一个父目录）。
+    if (addRoot.value.length === 0 && typeof wikis[0]?.root === 'string') addRoot.value = wikis[0].root
+  }
+
+  addBtn.addEventListener('click', () => {
+    const root = addRoot.value.trim()
+    const name = addName.value.trim()
+    if (root.length === 0 || name.length === 0) {
+      toast('请填写根目录与文件夹名')
+      return
+    }
+    const wiki: Record<string, unknown> = { root, name }
+    const label = addLabel.value.trim()
+    if (label.length > 0) wiki.label = label
+    void post({ action: 'add', wiki }, '添加中（新库需要初始化与冷启动，请稍候）…')
+  })
+
+  const load = async (): Promise<void> => {
+    if (isDisposed()) return
+    try {
+      const view = await fetchJson<WikisView>(WIKI_LIST_ENDPOINT)
+      if (isDisposed()) return
+      render(view)
+    } catch (err) {
+      if (isDisposed()) return
+      status.textContent = `读取知识库列表失败：${err instanceof Error ? err.message : String(err)}`
+    }
+  }
+  void load()
+}
+
+/**
+ * WHICH knowledge base the config block is editing (v0.28.0).
+ *
+ * Every per-wiki setting lives in that wiki's OWN
+ * `$:/plugins/dsh-tiddlywiki/config` tiddler, so `/admin/state`, `/admin/config`
+ * and `/admin/prompt` must be told which one. Without this, configuring the books
+ * wiki would silently edit the DEFAULT wiki — a user would set `git.remote`, see
+ * it saved, and never learn why pushes still went to the other repository.
+ *
+ * `undefined` = the default wiki, which is exactly what every route did before
+ * this existed (and what a single-wiki install always gets).
+ */
+let editingWiki: string | undefined
+
+/** Append the editing scope to a per-wiki admin URL. */
+function withWiki(url: string): string {
+  return editingWiki === undefined ? url : `${url}?wiki=${encodeURIComponent(editingWiki)}`
+}
+
 function renderWikiLocationSection(body: HTMLElement, isDisposed: () => boolean, refresh: () => Promise<void>): void {
   const section = make('section', 'dsh-tw-settings-section')
   section.append(make('h3', 'dsh-tw-settings-h', '知识库位置（可切换）'))
@@ -1322,7 +1530,13 @@ function renderMain(body: HTMLElement, state: AdminState, refresh: () => Promise
     configState.host = host
     configState.signature = signature
   }
+  // 配置作用域（v0.28.0）：每个库的配置存在它自己的 config tiddler 里，含糊其辞就会
+  // 出现"改了但不生效"——所以这一行必须说清下面的表单在编辑哪个库。
+  body.append(make('div', 'dsh-tw-settings-muted', editingWiki === undefined
+    ? '配置作用域：默认知识库（在「知识库列表」里点某行的「配置」可切到那个库）'
+    : `配置作用域：${editingWiki}（在「知识库列表」里改；编辑的是该库自己的配置 tiddler）`))
   body.append(configState.host)
+  renderWikiListSection(body, isDisposed, refresh)
   renderWikiLocationSection(body, isDisposed, refresh)
   renderCatalogSection(body, state.info, state.catalog, state.runtimePlugins, refresh, catalogPending)
   renderSeedsSection(body, isDisposed)

package/src/client/state.ts

@@ -1,39 +1,39 @@
-/**
- * Tiny pub/sub panel state shared by the sidebar entry and the center panel.
- *
- * @module dsh-tiddlywiki/client/state
- */
-
-export type PanelListener = (open: boolean) => void
-
-export class PanelState {
-  private open = false
-  private readonly listeners = new Set<PanelListener>()
-
-  isOpen(): boolean {
-    return this.open
-  }
-
-  toggle(): void {
-    this.set(!this.open)
-  }
-
-  openPanel(): void {
-    this.set(true)
-  }
-
-  closePanel(): void {
-    this.set(false)
-  }
-
-  set(value: boolean): void {
-    if (this.open === value) return
-    this.open = value
-    for (const listener of [...this.listeners]) listener(value)
-  }
-
-  subscribe(listener: PanelListener): () => void {
-    this.listeners.add(listener)
-    return () => { this.listeners.delete(listener) }
-  }
-}
+/**
+ * Tiny pub/sub panel state shared by the sidebar entry and the center panel.
+ *
+ * @module dsh-tiddlywiki/client/state
+ */
+
+export type PanelListener = (open: boolean) => void
+
+export class PanelState {
+  private open = false
+  private readonly listeners = new Set<PanelListener>()
+
+  isOpen(): boolean {
+    return this.open
+  }
+
+  toggle(): void {
+    this.set(!this.open)
+  }
+
+  openPanel(): void {
+    this.set(true)
+  }
+
+  closePanel(): void {
+    this.set(false)
+  }
+
+  set(value: boolean): void {
+    if (this.open === value) return
+    this.open = value
+    for (const listener of [...this.listeners]) listener(value)
+  }
+
+  subscribe(listener: PanelListener): () => void {
+    this.listeners.add(listener)
+    return () => { this.listeners.delete(listener) }
+  }
+}

package/src/client/status-cache.ts

@@ -43,6 +43,23 @@ export interface StatusPayload {
     behind?: number
   }
   note?: { tag?: string }
+  /**
+   * The knowledge-base roster (v0.28.0). `mode` decides whether per-wiki paths
+   * are used at all; `defaultId` is what the agent falls back to. Deliberately
+   * WITHOUT per-wiki git status — that would spawn up to five git processes per
+   * wiki on every poll.
+   */
+  mode?: string
+  defaultId?: string
+  wikis?: Array<{
+    id: string
+    label: string
+    status: string
+    agentVisible: boolean
+    autostart: boolean
+    running: boolean
+    path: string
+  }>
   ui?: {
     showQuickNote?: boolean
     showQuickNoteDock?: boolean

package/src/client/styles.ts

@@ -299,6 +299,12 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 /* ── settings page (config panel §13) ────────────────────────── */
 .dsh-tw-settings { display: flex; flex-direction: column; gap: 10px; padding: 12px 16px; min-width: 0; }
 .dsh-tw-settings-row { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
+/* 知识库列表里的一行（v0.28.0）：卡片式，便于扫读"哪个库、在哪、在不在跑"。 */
+.dsh-tw-settings-kbrow {
+  display: flex; flex-direction: column; gap: 4px;
+  border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.12)); border-radius: 8px;
+  padding: 8px 10px; margin: 0 0 8px;
+}
 .dsh-tw-settings-chip {
   font-size: 12px; padding: 2px 10px; border-radius: 999px;
   border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,.25));
@@ -486,6 +492,27 @@ 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)); }
+/* 多知识库切换分组（v0.28.0）：一行小标题 + 每库一行；当前焦点用 ● 标记。 */
+.dsh-tw-fab-group {
+  font-size: 11px; opacity: .6; padding: 6px 9px 2px; letter-spacing: .04em;
+}
+.dsh-tw-fab-item[data-current="1"] { font-weight: 600; }
+
+/* ── 会话级知识库选择器（v0.28.0，同一个 conversation.input.dock 槽位）──
+   与快速笔记按钮同区、纵向 flex 排列；只在"多于一个可见库"时渲染（组件自己返回
+   null），所以单库安装这一整块都不存在。 */
+.dsh-tw-scope-dock {
+  display: flex; align-items: center; gap: 8px; flex-wrap: wrap;
+  padding: 4px 8px 0; box-sizing: border-box; width: 100%; font-size: 12px;
+}
+.dsh-tw-scope-label { opacity: .7; }
+.dsh-tw-scope-select {
+  border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
+  background: var(--dsw-alias-bg-layer-2, #fff); color: inherit; font: inherit; font-size: 12px;
+  padding: 3px 8px; border-radius: 999px; max-width: 260px;
+}
+.dsh-tw-scope-select:disabled { opacity: .6; }
+.dsh-tw-scope-note { opacity: .75; }
 
 /* ── input-dock quick-note button（聊天输入框上方，conversation.input.dock）──
    该槽位渲染为「输入框上方的全宽条目」纵向 flex 排列（todo/cost-meter/goal/

package/src/client/toast.ts

@@ -1,22 +1,22 @@
-/**
- * One-shot transient toast, shared by the quick-note widget and the settings
- * page. Reuses a single body-level element (`.dsh-tw-toast`) with a show
- * class; the element is created lazily and styled by styles.ts.
- *
- * @module dsh-tiddlywiki/client/toast
- */
-
-export function toast(message: string): void {
-  let el = document.querySelector<HTMLElement>('.dsh-tw-toast')
-  if (el === null) {
-    el = document.createElement('div')
-    el.className = 'dsh-tw-toast'
-    document.body.append(el)
-  }
-  el.textContent = message
-  el.classList.add('dsh-tw-toast-show')
-  clearTimeout((el as HTMLElement & { __twToastTimer?: number }).__twToastTimer)
-  ;(el as HTMLElement & { __twToastTimer?: number }).__twToastTimer = window.setTimeout(() => {
-    el?.classList.remove('dsh-tw-toast-show')
-  }, 2_500)
-}
+/**
+ * One-shot transient toast, shared by the quick-note widget and the settings
+ * page. Reuses a single body-level element (`.dsh-tw-toast`) with a show
+ * class; the element is created lazily and styled by styles.ts.
+ *
+ * @module dsh-tiddlywiki/client/toast
+ */
+
+export function toast(message: string): void {
+  let el = document.querySelector<HTMLElement>('.dsh-tw-toast')
+  if (el === null) {
+    el = document.createElement('div')
+    el.className = 'dsh-tw-toast'
+    document.body.append(el)
+  }
+  el.textContent = message
+  el.classList.add('dsh-tw-toast-show')
+  clearTimeout((el as HTMLElement & { __twToastTimer?: number }).__twToastTimer)
+  ;(el as HTMLElement & { __twToastTimer?: number }).__twToastTimer = window.setTimeout(() => {
+    el?.classList.remove('dsh-tw-toast-show')
+  }, 2_500)
+}

package/src/client/tw-frame.ts

@@ -27,8 +27,9 @@
  * @module dsh-tiddlywiki/client/tw-frame
  */
 import * as React from 'react'
-import { RESTART_ENDPOINT, resolveTwUrl } from './endpoints.ts'
+import { RESTART_ENDPOINT, resolveTwUrl, twProxyFor } from './endpoints.ts'
 import { fetchStatus } from './status-cache.ts'
+import { getFocusWiki, subscribeFocusWiki } from './wiki-focus.ts'
 import { attachThemeSync, setThemeSyncConfig } from './theme-sync.ts'
 
 /** Cross-plugin activation event; detail is the activating panel name. */
@@ -140,7 +141,16 @@ export interface TwFrameSurface {
  * (starting / error / running, iframe URL, theme config, shared chip label)
  * and every tiddler-hash navigation is implemented here ONCE.
  */
-export function createTwFrameSurface(skin: TwFrameSkin): TwFrameSurface {
+/**
+ * Per-surface hooks (v0.28.0). `wikiId` answers "which knowledge base should
+ * this surface embed?" — the center panel and the rightbar tab both embed the
+ * wiki the user focused, and reload when that choice changes.
+ */
+export interface TwFrameHooks {
+  wikiId?: () => string | undefined
+}
+
+export function createTwFrameSurface(skin: TwFrameSkin, hooks: TwFrameHooks = {}): TwFrameSurface {
   let visible = false
   let started = false
   let disposed = false
@@ -318,7 +328,10 @@ export function createTwFrameSurface(skin: TwFrameSkin): TwFrameSurface {
         // resolveTwUrl prefers the host's ABSOLUTE loopback base when THIS page
         // is not on http(s) (the DSH desktop app's `dsh-app:` renderer), because
         // TW refuses to load its sync adaptor anywhere else — see resolveTwUrl.
-        showFrame(resolveTwUrl(payload.twProxy, payload.twProxyAbsolute))
+        // WHICH knowledge base (v0.28.0): the focused one in multi mode, else the
+        // bare path (= the default wiki, exactly as before).
+        const bases = twProxyFor(payload.mode, hooks.wikiId?.(), payload.twProxy, payload.twProxyAbsolute)
+        showFrame(resolveTwUrl(bases.relative, bases.absolute))
       } else if (typeof payload.url === 'string') {
         showFrame(payload.url)
       } else {
@@ -355,6 +368,16 @@ export function createTwFrameSurface(skin: TwFrameSkin): TwFrameSurface {
   }
   document.addEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
 
+  /**
+   * Switching the focused knowledge base needs a different proxy path, so the
+   * frame reloads (v0.28.0). TW reloads inside the iframe — one iframe cannot
+   * host two editors, and silently keeping the old wiki's data while the UI says
+   * otherwise is exactly the confusion this feature must not create.
+   */
+  const unsubscribeFocus = subscribeFocusWiki(() => {
+    if (!disposed && visible) void doRefresh()
+  })
+
   const build = (): HTMLDivElement => {
     if (view !== undefined) return view
     const viewEl = document.createElement('div')
@@ -429,6 +452,7 @@ export function createTwFrameSurface(skin: TwFrameSkin): TwFrameSurface {
       if (disposed) return
       disposed = true
       document.removeEventListener(PANEL_RELOAD_EVENT, onReloadRequest)
+      unsubscribeFocus()
       clearRetry()
       for (const timer of hashWaitTimers) window.clearTimeout(timer)
       hashWaitTimers.clear()
@@ -505,7 +529,7 @@ export function createTwFrameController(host: HTMLElement, signal: AbortSignal):
   // liveFrames forever. Hand back a no-op controller and build nothing.
   if (signal.aborted) return disposedController()
 
-  const surface = createTwFrameSurface(RIGHTBAR_SKIN)
+  const surface = createTwFrameSurface(RIGHTBAR_SKIN, { wikiId: getFocusWiki })
   host.append(surface.build())
 
   let disposed = false

package/src/client/wiki-focus.ts

@@ -0,0 +1,70 @@
+/**
+ * Which knowledge base the GUI is currently working in (v0.28.0).
+ *
+ * The GUI is single-focus by design: the center panel and the rightbar tab each
+ * embed ONE wiki's editor at a time (`/tw/<id>/…`), and the FAB lists the others.
+ * The choice is remembered PER BROWSER (localStorage) rather than per session —
+ * it is a viewing preference, and reopening the GUI should land where you left
+ * off.
+ *
+ * A remembered id is only a HINT: `resolveFocusWiki()` validates it against the
+ * live roster from `/status` and falls back to the registry's default, so
+ * removing or renaming a wiki can never strand the panel on a 404.
+ *
+ * @module dsh-tiddlywiki/client/wiki-focus
+ */
+
+/** localStorage key holding the focused wiki id. */
+const STORAGE_KEY = 'dsh-tiddlywiki.focusWiki'
+
+function readStored(): string | undefined {
+  try {
+    const raw = window.localStorage.getItem(STORAGE_KEY)
+    return raw !== null && raw.length > 0 ? raw : undefined
+  } catch {
+    // Private mode / storage disabled: the focus simply is not remembered.
+    return undefined
+  }
+}
+
+let focusId: string | undefined = readStored()
+const listeners = new Set<(id: string | undefined) => void>()
+
+/** The remembered wiki id (may not exist any more — use `resolveFocusWiki`). */
+export function getFocusWiki(): string | undefined {
+  return focusId
+}
+
+/** Remember a new focused wiki (and notify every surface). */
+export function setFocusWiki(id: string | undefined): void {
+  if (id === focusId) return
+  focusId = id
+  try {
+    if (id === undefined) window.localStorage.removeItem(STORAGE_KEY)
+    else window.localStorage.setItem(STORAGE_KEY, id)
+  } catch {
+    /* a preference that cannot be persisted is still honoured for this page */
+  }
+  for (const listener of [...listeners]) listener(id)
+}
+
+/** Subscribe to focus changes; returns the unsubscribe function. */
+export function subscribeFocusWiki(listener: (id: string | undefined) => void): () => void {
+  listeners.add(listener)
+  return () => { listeners.delete(listener) }
+}
+
+/** The minimum a roster entry must expose to be focusable. */
+export interface FocusableWiki { id: string }
+
+/**
+ * The wiki the GUI should actually show: the remembered one when it still
+ * exists, else the registry default, else the first entry. `undefined` only when
+ * there is nothing to show at all.
+ */
+export function resolveFocusWiki(roster: readonly FocusableWiki[], defaultId: string | undefined): string | undefined {
+  if (roster.length === 0) return focusId
+  if (focusId !== undefined && roster.some((entry) => entry.id === focusId)) return focusId
+  if (defaultId !== undefined && roster.some((entry) => entry.id === defaultId)) return defaultId
+  return roster[0]?.id
+}