dsh-tiddlywiki 0.28.11 → 0.28.13

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

package/src/client/note-widget.ts

@@ -513,18 +513,18 @@ export function createNoteWidget(): NoteWidgetHandle {
         if (!targetPicked) targetWiki = resolveFocusWiki(roster, defaultId)
       }
       followFocus()
+      // 「默认库」不再作为选项出现（作者 2026-09-29 报障）：那个位置就是**被设为默认的那个
+      // 库本身**，用它自己的显示名，只加「（默认）」作为身份标记。原来那个 `value=''` 的
+      // 占位项其实是多余的 —— 清单里本来就有这个库，选中它写进去的就是它。
       wikiSelect.replaceChildren(
         ...roster.map((item) => {
           const option = document.createElement('option')
           option.value = item.id
-          option.textContent = item.running ? item.label : `${item.label}（未运行）`
+          const mark = item.id === defaultId ? '（默认）' : ''
+          option.textContent = item.running ? `${item.label}${mark}` : `${item.label}${mark}（未运行）`
           return option
         }),
       )
-      const fallback = document.createElement('option')
-      fallback.value = ''
-      fallback.textContent = '默认库'
-      wikiSelect.append(fallback)
       wikiSelect.value = targetWiki ?? ''
       wikiField.hidden = false
       markStopped()

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

@@ -338,31 +338,46 @@ export function renderConfigSection(body: HTMLElement, config: Record<string, un
   textField('bridge.tag', '剪藏笔记默认 tag', typeof bridge.tag === 'string' && bridge.tag.trim().length > 0 ? bridge.tag.trim() : 'clip')
   // 剪藏目标库（v0.28.8）：剪藏桥自建 loopback 服务，请求走不到宿主的 `?wiki=` 解析，
   // 所以多库下**必须**在这里显式选一次，否则永远剪进默认库。选项要等 /admin/wikis
-  // 回来才知道，所以先渲染一个只有「默认库」的 select，拿到列表后再补全；用户已选的值
-  // 若不在列表里（库被移出清单）也保留一行，免得下拉把它静默抹掉。
-  const clipWiki = selectField('bridge.wiki', '剪藏写入的知识库（默认库=不指定；多库时可指定某个库）', typeof bridge.wiki === 'string' ? bridge.wiki.trim() : '', [{ value: '', label: '默认库' }])
+  // 回来才知道，所以先渲染一个占位 select，拿到列表后补全；用户已选的值若不在列表里
+  // （库被移出清单）也保留一行。
+  //
+  // 空值 = 「不指定，写进默认的那个库」，但这一项的**名字**不再是「默认库」（v0.28.12，
+  // 作者 2026-09-29 要求：设置过默认库之后，界面上不该再出现「默认库」这个字样，应当
+  // 直接给出真实库名）——清单回来后把这一项就地改名成默认库自己的显示名 +「（默认）」，
+  // 并且**跳过**它自己那一行，免得同一个库在下拉里出现两次。
+  const clipWiki = selectField('bridge.wiki', '剪藏写入的知识库（不指定 = 写进知识库列表里带 ★ 的那个库；多库时可指定具体的库）', typeof bridge.wiki === 'string' ? bridge.wiki.trim() : '', [{ value: '', label: '（跟随默认的那个库）' }])
   void (async () => {
     try {
       const view = await fetchJson<WikisView>(WIKI_LIST_ENDPOINT)
       if (isDisposed()) return
       const items = Array.isArray(view.wikis) ? view.wikis : []
       const current = clipWiki.value
+      const defaultEntry = items.find((wiki) => wiki.id === view.defaultId)
+      const defaultLabel = defaultEntry?.label ?? undefined
+      // 空值那一项的**名字**：默认库的显示名 + 身份标记。读不到清单/没有默认库时保持
+      // 中性说法（绝不退回「默认库」这三个字）。
+      const placeholder = clipWiki.options.item(0)
+      if (placeholder !== null && defaultLabel !== undefined) placeholder.textContent = `${defaultLabel}（默认）`
       for (const wiki of items) {
+        // 默认库由空值那一项代表；再列一遍就是同一个库出现两次。
+        if (wiki.id === view.defaultId) continue
         const option = document.createElement('option')
         option.value = wiki.id
         option.textContent = `${wiki.label}（${wiki.id}）${wiki.running ? '' : ' · 未运行'}`
         clipWiki.append(option)
       }
-      // 当前值不在清单里（已移出）：补一行，避免下拉静默把它抹成默认库。
+      // 当前值不在清单里（已移出）：补一行，避免下拉静默把它抹成另一个库。
       if (current.length > 0 && !items.some((wiki) => wiki.id === current)) {
         const option = document.createElement('option')
         option.value = current
-        option.textContent = `${current}（不在清单里，保存后回落默认库）`
+        option.textContent = defaultLabel !== undefined
+          ? `${current}（不在清单里，保存后写进 ${defaultLabel}）`
+          : `${current}（不在清单里）`
         clipWiki.append(option)
       }
       clipWiki.value = current
     } catch {
-      /* 读不到清单：只有「默认库」一项，单库安装本来就是这种形态 */
+      /* 读不到清单：保留中性占位项（单库安装本来就是这种形态） */
     }
   })()
   // 界面语言在下方「语言管理」区块设置（config 的 uiLanguage 仅供启动时自动应用）。

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

@@ -122,9 +122,13 @@ export function renderWikiListSection(body: HTMLElement, isDisposed: () => boole
 
   const render = (view: WikisView): void => {
     status.textContent = view.error !== undefined && view.error.length > 0 ? `⚠️ ${view.error}` : ''
+    // 「默认库」这个字样不再出现在界面上（v0.28.12，作者 2026-09-29）：直接说**那个库的名字**，
+    // 读不到清单时用中性说法兜底，绝不退回「默认库」。
+    const defaultLabel = (view.wikis ?? []).find((wiki) => wiki.id === view.defaultId)?.label
+    const defaultName = defaultLabel !== undefined && defaultLabel.length > 0 ? defaultLabel : '默认的那个库'
     modeRow.replaceChildren(make('span', 'dsh-tw-settings-label', '运行模式：'))
     const modes: Array<[string, string]> = [
-      ['single', '单库（只跑默认库）'],
+      ['single', `单库（只跑 ${defaultName}）`],
       ['multi', '多库（清单里的库都可用）'],
     ]
     for (const [value, text] of modes) {
@@ -135,7 +139,7 @@ export function renderWikiListSection(body: HTMLElement, isDisposed: () => boole
       chip.addEventListener('click', () => {
         const ok = window.confirm(value === 'multi'
           ? '切换到多库模式：清单里标了「开局自启」的知识库都会启动（每个库一个 TW 子进程）。继续？'
-          : '切换到单库模式：除默认库外的知识库会被停掉（内容与清单都不受影响）。继续？')
+          : `切换到单库模式：除 ${defaultName} 外的知识库会被停掉（内容与清单都不受影响）。继续？`)
         if (ok) void post({ action: 'set-mode', mode: value }, '切换模式中…')
       })
       modeRow.append(chip)

package/src/client/sidebar-entry.ts

@@ -12,12 +12,41 @@
 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'
+import { resolveFocusWiki, setFocusWiki, subscribeFocusWiki, type FocusableWiki } from './wiki-focus.ts'
 import { applyWikiIcon } from './wiki-icon.ts'
 
 /** Stable data attribute identifying this entry row. */
 export const ENTRY_SELECTOR = '[data-dsh-tw-entry]'
 
+/** What a click on an entry row does — see {@link resolveEntryClick}. */
+export type EntryClickAction = 'open' | 'close' | 'switch'
+
+/**
+ * Decide what clicking an entry row should do (v0.28.13).
+ *
+ * 症状（作者 2026-09-29 报障）：「左侧多 wiki 入口，有时候要点击两次才能切换到对应的库」。
+ * 根因：点行**一律** `state.toggle()` —— 面板开着 A 时点 B，`setFocusWiki(B)` 确实把焦点
+ * 换过去了（内核也开始换库），但同一击里的 toggle 又把面板关掉；用户看到的只是"面板没了"，
+ * 得再点一次才看到 B。开着面板时点另一个库，用户要的是**切换**，不是"关面板"。
+ *
+ * 判定表：
+ *  - 面板关着            → `open`（点哪个库就开哪个库）；
+ *  - 面板开着 && 就是这个库 → `close`（入口同时也是开关，再点一次收起）；
+ *  - 面板开着 && 是别的库   → `switch`（只切焦点库，面板保持打开）；
+ *  - 单库那一行（`wikiId === undefined`）逐字保留原来的 toggle 语义。
+ */
+export function resolveEntryClick(input: {
+  open: boolean
+  /** 这一行绑定的库；`undefined` = 单库模式那唯一一行。 */
+  wikiId: string | undefined
+  /** 面板此刻**实际显示**的库（见 `mountSidebarEntry` 的 `shownWiki`）。 */
+  shown: string | undefined
+}): EntryClickAction {
+  if (!input.open) return 'open'
+  if (input.wikiId === undefined) return 'close'
+  return input.wikiId === input.shown ? 'close' : 'switch'
+}
+
 
 /** Family entries from sibling plugins, kept in a stable relative order. */
 const FAMILY_SELECTOR = '[data-dsh-tw-entry], [data-dsh-atb-entry], [data-dsh-taskboard-entry], [data-dsh-ssh-entry]'
@@ -47,15 +76,43 @@ function newSessionButton(root: HTMLElement): HTMLButtonElement | undefined {
   return buttons.find(button => !button.matches(ENTRY_SELECTOR) && /新会话|新建会话|new session/i.test(button.textContent ?? ''))
 }
 
+/** What a row needs from its owner: the shared panel state and "which wiki is on screen". */
+export interface EntryHooks {
+  state: PanelState
+  /** The wiki the panel is displaying right now (`resolveEntryClick` needs it). */
+  shownWiki: () => string | undefined
+}
+
+/**
+ * Run one entry-row click: decide, move the focus wiki, then open/close the panel.
+ *
+ * 顺序是本函数唯一容易写错的地方：`shownWiki()` 必须在 `setFocusWiki()` **之前**求值。
+ * 反过来的话，刚切过去的那个库会被 `resolveEntryClick` 当成"面板此刻显示的就是它"，
+ * 于是判成 `close` —— 又变回"点两次才能切库"。
+ *
+ * @returns the action that was taken (the guards assert on it).
+ */
+export function applyEntryClick(hooks: EntryHooks, wikiId: string | undefined): EntryClickAction {
+  const action = resolveEntryClick({ open: hooks.state.isOpen(), wikiId, shown: hooks.shownWiki() })
+  // 多库：先把这个库设为「焦点库」，面板随后加载它自己的 /tw/<id>/。
+  if (wikiId !== undefined) setFocusWiki(wikiId)
+  // 'open' 与 'switch' 都保持/变成打开：'switch' 时面板本来就开着，openPanel() 是空操作，
+  // 换库由焦点订阅驱动内核重载（tw-frame.ts），所以**绝不能**在这里 toggle —— 那正是
+  // 「点两次才能切库」的成因（v0.28.13）。
+  if (action === 'close') hooks.state.closePanel()
+  else hooks.state.openPanel()
+  return action
+}
+
 /**
  * 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
+ * that knowledge base before showing 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,
+  hooks: EntryHooks,
   label: string,
   wikiId?: string,
   icon?: string,
@@ -73,11 +130,7 @@ function createEntry(
   labelEl.className = 'dsh-tw-entry-label'
   labelEl.textContent = label
   entry.append(iconEl, labelEl)
-  entry.addEventListener('click', () => {
-    // 多库：先把这个库设为「焦点库」，面板随后加载它自己的 /tw/<id>/。
-    if (wikiId !== undefined) setFocusWiki(wikiId)
-    state.toggle()
-  })
+  entry.addEventListener('click', () => { applyEntryClick(hooks, wikiId) })
   return { entry, labelEl, iconEl }
 }
 
@@ -117,7 +170,19 @@ function placeEntry(root: HTMLElement, entry: HTMLButtonElement): boolean {
 export function mountSidebarEntry(state: PanelState): () => void {
   /** 多库：每个**在运行**的库一个入口行，用自己的显示名（作者 2026-09-28 要求）。 */
   const rows = new Map<string, { entry: HTMLButtonElement; labelEl: HTMLSpanElement; iconEl: HTMLSpanElement }>()
-  const { entry, labelEl, iconEl } = createEntry(state, 'TiddlyWiki')
+  /**
+   * `/status` 最近一次给出的「在运行库」与默认库（v0.28.13）。
+   *
+   * 点击一个入口行时要判断「面板此刻显示的是哪个库」，才能区分"切换"与"关面板"
+   * （见 `resolveEntryClick`）——判定必须与面板/内核用**同一套解析**：
+   * 记忆值 → 默认库 → 第一个可用库（`resolveFocusWiki`）。
+   */
+  let runningWikis: FocusableWiki[] = []
+  let defaultWikiId: string | undefined
+  /** 面板此刻显示的那个库。 */
+  const shownWiki = (): string | undefined => resolveFocusWiki(runningWikis, defaultWikiId)
+  const entryHooks: EntryHooks = { state, shownWiki }
+  const { entry, labelEl, iconEl } = createEntry(entryHooks, 'TiddlyWiki')
   rows.set('', { entry, labelEl, iconEl })
   let disposed = false
   /**
@@ -149,6 +214,9 @@ export function mountSidebarEntry(state: PanelState): () => void {
     if (disposed) return
     const list = Array.isArray(payload?.wikis) ? payload.wikis : []
     const running = list.filter((w) => w.running)
+    // 点击判定与高亮都要用同一份名册（v0.28.13）：存下来，`shownWiki()` 据此解析。
+    runningWikis = running
+    defaultWikiId = payload?.defaultId
     // 单库：不建额外行，标签仍归 ui.sidebarLabel 管。
     if (running.length <= 1) {
       for (const [key, row] of rows) {
@@ -172,15 +240,15 @@ export function mountSidebarEntry(state: PanelState): () => void {
     for (const w of running) {
       let row = rows.get(w.id)
       if (row === undefined) {
-        row = createEntry(state, w.label, w.id, w.icon)
+        row = createEntry(entryHooks, w.label, w.id, w.icon)
         rows.set(w.id, row)
       }
       row.labelEl.textContent = w.label
       // 图标每次同步（v0.28.4）：在设置页改完图标，10s 内的轮询就会把它换过来。
       applyWikiIcon(row.iconEl, w.icon)
       row.entry.setAttribute('aria-label', `TiddlyWiki 知识库：${w.label}`)
-      // 当前焦点库高亮
-      const focused = resolveFocusWiki(running, payload?.defaultId) === w.id
+      // 当前焦点库高亮（与点击判定同源：`shownWiki()`，不会出现"高亮的行点一下反而关掉面板"）
+      const focused = shownWiki() === w.id
       if (focused) row.entry.dataset.focus = 'true'
       else delete row.entry.dataset.focus
     }
@@ -273,12 +341,15 @@ export function mountSidebarEntry(state: PanelState): () => void {
    * wiki — the focused one. Highlighting every row made it look like all three
    * were open (作者报障). The row the user clicked becomes the focus, and that is
    * the row that lights up.
+   *
+   * v0.28.13: the resolver is the SAME one the click handler uses (`shownWiki`),
+   * so "which row is lit" and "which row closes the panel when clicked" can never
+   * disagree. The old call passed `undefined` as the default id, which made the
+   * highlight fall back to the FIRST running row instead of the actual default
+   * wiki whenever no focus had been stored yet.
    */
   const syncActive = (): void => {
-    const focus = resolveFocusWiki(
-      activeRows().map((el) => ({ id: el.dataset.wiki ?? '' })).filter((w) => w.id.length > 0),
-      undefined,
-    )
+    const focus = shownWiki()
     for (const el of activeRows()) {
       const id = el.dataset.wiki
       // 单库默认行没有 data-wiki：它就是唯一那个库，面板开着时它就该亮。

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

@@ -29,6 +29,21 @@ import { isBlankSeatMounted, subscribeBlankSeat } from './scope-seat.ts'
 
 interface WikiOption { id: string; label: string; running: boolean }
 
+/** `resolved` of `/session/wiki`: the wiki a session EFFECTIVELY uses. */
+interface ResolvedWiki { id: string; label: string }
+
+/**
+ * Read `{id,label}` out of a `/session/wiki` payload, tolerating every shape we
+ * may be handed (absent field, wrong types, id-only). `undefined` = unknown.
+ */
+function readResolvedWiki(value: unknown): ResolvedWiki | undefined {
+  if (typeof value !== 'object' || value === null) return undefined
+  const id = (value as { id?: unknown }).id
+  if (typeof id !== 'string' || id.length === 0) return undefined
+  const label = (value as { label?: unknown }).label
+  return { id, label: typeof label === 'string' && label.length > 0 ? label : id }
+}
+
 /** Props the shell passes to a `conversation.input.dock` entry (scope: session). */
 interface DockProps {
   sessionId?: string
@@ -107,6 +122,17 @@ export function createWikiScopeDock(options: WikiScopeDockOptions = {}): (props:
     const blankSeat = useBlankSeatMounted()
     const [wikis, setWikis] = React.useState<WikiOption[]>([])
     const [scope, setScope] = React.useState('')
+    /**
+     * The wiki this session effectively uses when no explicit scope is set —
+     * the host resolves it (registry default, or the first running visible one)
+     * and returns it as `resolved` (v0.28.12).
+     *
+     * WHY: the picker used to render a nameless 「默认库」 option. The author's
+     * 2026-09-29 report: with a default wiki configured, the UI should show
+     * THAT LIBRARY'S NAME everywhere (and a new session should already show it
+     * selected) — 「默认库」 as a name must not appear in the list at all.
+     */
+    const [defaultWiki, setDefaultWiki] = React.useState<ResolvedWiki | undefined>(undefined)
     const [note, setNote] = React.useState<string | undefined>(undefined)
     const [busy, setBusy] = React.useState(false)
     const wrapRef = React.useRef<HTMLDivElement | null>(null)
@@ -131,6 +157,7 @@ export function createWikiScopeDock(options: WikiScopeDockOptions = {}): (props:
         const visible = (status?.wikis ?? []).filter((wiki) => wiki.agentVisible)
         setWikis(visible.map((wiki) => ({ id: wiki.id, label: wiki.label, running: wiki.running })))
         setScope(typeof current?.scope === 'string' ? current.scope : '')
+        setDefaultWiki(readResolvedWiki(current?.resolved))
         setNote(typeof current?.reason === 'string' ? current.reason : undefined)
       })()
       return () => { alive = false }
@@ -146,7 +173,30 @@ export function createWikiScopeDock(options: WikiScopeDockOptions = {}): (props:
     // 空白会话里仍有唯一一个选择器。
     if (!blankOnly && blank && blankSeat) return null
 
+    // 「默认库」不再作为一个**名字**出现在这里（作者 2026-09-29 报障）：那个选项就是被设为
+    // 默认的那个库本身，用它自己的显示名，后缀「（默认）」标示身份。选中它 = 清空显式
+    // 作用域（仍然跟随默认），所以以后改了默认库，没动过选择器的会话会跟着走 —— 语义与
+    // 原来那行 `value=''` 完全一致，只是不再用无名占位符。
+    const defaultId = defaultWiki?.id ?? ''
+    const listed = (id: string): boolean => wikis.some((wiki) => wiki.id === id)
+    const selected = scope.length > 0 && listed(scope) ? scope : defaultId
+
+    const options: WikiOption[] = [...wikis]
+    if (defaultId.length > 0 && !listed(defaultId)) {
+      // 默认库不在可见清单里（例如它被设成「对 Agent 隐身」）时必须**补一行**：
+      // 否则下拉的 value 指向一个不存在的 option，界面直接显示成空白。
+      // `running: true` 表示不额外标「未运行」—— 我们在这里拿不到它的运行态，
+      // 而能被解析成"本会话实际使用"的库本来就一定是正在跑的那个。
+      options.push({ id: defaultId, label: defaultWiki?.label ?? defaultId, running: true })
+    }
+    // 默认库排在最前（原来是那个无名选项的位置），其余保持清单顺序。
+    const ordered = defaultId.length > 0 && listed(defaultId)
+      ? [...options.filter((wiki) => wiki.id === defaultId), ...options.filter((wiki) => wiki.id !== defaultId)]
+      : options
+
     const apply = (next: string): void => {
+      // 选中默认库那一项 = 清空显式作用域，仍然跟随默认（默认库改了也跟着改）。
+      const wanted = next === defaultId ? '' : next
       setBusy(true)
       void (async () => {
         try {
@@ -156,15 +206,16 @@ export function createWikiScopeDock(options: WikiScopeDockOptions = {}): (props:
             // A generous budget: selecting a wiki that is not running STARTS it
             // host-side (the tools resolve the scope synchronously and never start
             // anything themselves), and a cold child can take tens of seconds.
-            body: JSON.stringify({ session: sessionId, wiki: next.length > 0 ? next : null }),
+            body: JSON.stringify({ session: sessionId, wiki: wanted.length > 0 ? wanted : null }),
             signal: AbortSignal.timeout(120_000),
           })
-          const payload = (await res.json().catch(() => ({}))) as { ok?: boolean; scope?: string; reason?: string; error?: string }
+          const payload = (await res.json().catch(() => ({}))) as { ok?: boolean; scope?: string; resolved?: unknown; reason?: string; error?: string }
           if (!res.ok || payload.ok !== true) {
             setNote(payload.error ?? `切换失败（HTTP ${res.status}）`)
             return
           }
-          setScope(typeof payload.scope === 'string' ? payload.scope : next)
+          setScope(typeof payload.scope === 'string' ? payload.scope : wanted)
+          setDefaultWiki(readResolvedWiki(payload.resolved) ?? defaultWiki)
           setNote(typeof payload.reason === 'string' ? payload.reason : undefined)
           // 立即让工具卡/会话汇总重新解析作用域（v0.28.8）：它们按会话缓存 wiki id，
           // 不失效的话切库后已显示的卡片仍带着旧库的 ?wiki= 与库徽标。
@@ -185,17 +236,17 @@ export function createWikiScopeDock(options: WikiScopeDockOptions = {}): (props:
         'select',
         {
           className: 'dsh-tw-scope-select',
-          value: scope,
+          value: selected,
           disabled: busy,
           'aria-label': '本会话使用的知识库',
           title: '本会话的 tiddlywiki_* 工具与注入提示词都作用于这个知识库（下一个模型步骤生效）',
           onChange: (event: React.ChangeEvent<HTMLSelectElement>) => { apply(event.target.value) },
         },
-        React.createElement('option', { value: '' }, '默认库'),
-        ...wikis.map((wiki) => React.createElement(
+        ...ordered.map((wiki) => React.createElement(
           'option',
           { key: wiki.id, value: wiki.id },
-          `${wiki.label}${wiki.running ? '' : '（未运行，选中会启动）'}`,
+          // 「（默认）」是**身份标记**，不是库名：库名照旧是它自己的显示名。
+          `${wiki.label}${wiki.id === defaultId ? '（默认）' : ''}${wiki.running ? '' : '（未运行，选中会启动）'}`,
         )),
       ),
       note !== undefined ? React.createElement('span', { className: 'dsh-tw-scope-note' }, note) : null,

package/src/host/seed-notes.ts

@@ -81,7 +81,7 @@ const DOC_NOTE_TAIL = `* **TW 编辑器面板**：侧边栏「TiddlyWiki」按
 
 * **想继续用单库**：什么都不用做。设置页里「知识库位置（可切换）」只在单库模式出现，用法和以前一样。
 * **想开始用多库**：去设置页「知识库列表」添加第二个库，再把「运行模式」切到**多库**。此后清单里的库都会可用（标了「开局自启」的随 DSH 启动，其余在你打开或选中它时启动）。
-* **控制文件在哪**：\`$DSH_HOME/dsh-tiddlywiki/wikis.json\`（在每本 wiki **之外**，所以它不会随某个库被搬走）。模式、默认库、库清单都在里面；也可以在设置页里改，效果一样。
+* **控制文件在哪**：\`$DSH_HOME/dsh-tiddlywiki/wikis.json\`（在每本 wiki **之外**，所以它不会随某个库被搬走）。运行模式、库清单、以及哪个库是默认的，都在里面；也可以在设置页里改，效果一样。
 * **旧的「知识库位置」指针文件**（\`location.json\`）在单库模式下仍然是权威的——多库模式下它不再参与，改由清单决定。
 * **每个库要有自己的 \`tiddlywiki.info\`**：把一个大库拆成多个目录时，每个目录都要有一个（缺了 TW 认不出它是库）。从旧库整体搬过来的目录通常已经有了。
 * **拆分大库的注意**：书籍/语料这类只读内容建议**独立仓库 + 对 Agent 隐身**；工作与个人笔记可以共用一个仓库、按子目录划分。搬运用 \`git mv\` 保留历史，别用\"复制粘贴再删\"。

package/src/index-clip.ts

@@ -71,7 +71,7 @@ export function createClipSurface(deps: ClipDeps): ClipSurface {
   const warnClipFallbackOnce = (wanted: string): void => {
     if (clipFallbackWarned.has(wanted)) return
     clipFallbackWarned.add(wanted)
-    console.warn(`[dsh-tiddlywiki] clip bridge: 配置的 bridge.wiki「${wanted}」当前不在运行（或已移出清单），剪藏回落到默认库（设置页可改）`)
+    console.warn(`[dsh-tiddlywiki] clip bridge: 配置的 bridge.wiki「${wanted}」当前不在运行（或已移出清单），剪藏回落到默认的那个知识库（设置页可改）`)
   }
 
   const clipTarget = (): { runtime: WikiInstance; id: string } | undefined => {

package/src/index-git.ts

@@ -134,7 +134,7 @@ export function createGitLayer(deps: GitLayerDeps): GitLayer {
     if (members.length > 1) {
       const fingerprints = new Set(members.map((entry) => JSON.stringify(runtimeConfig(entry)?.git ?? {})))
       if (fingerprints.size > 1) {
-        console.warn(`[dsh-tiddlywiki] 知识库 ${members.map((entry) => entry.id).join('、')} 共用同一个仓库（${repoRoot}），但各自配了不同的 git.* —— 一个仓库只有一份 git 设置，本次以「${chosen?.id ?? '默认库'}」为准`)
+        console.warn(`[dsh-tiddlywiki] 知识库 ${members.map((entry) => entry.label ?? entry.id).join('、')} 共用同一个仓库（${repoRoot}），但各自配了不同的 git.* —— 一个仓库只有一份 git 设置，本次以「${chosen?.label ?? chosen?.id ?? '默认的那个库'}」为准`)
       }
     }
     const base = deps.gitConfig()