dsh-tiddlywiki 0.28.3 → 0.28.4

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

package/src/client/knowledge-fab.ts

@@ -21,7 +21,7 @@ import type { NoteWidgetHandle } from './note-widget.ts'
 import type { SyncController } from './sync-button.ts'
 import { PANEL_RELOAD_EVENT } from './tw-frame.ts'
 import { ROUTE_PREFIX } from './endpoints.ts'
-import { resolveFocusWiki, setFocusWiki } from './wiki-focus.ts'
+import { resolveFocusWiki, setFocusWiki, subscribeFocusWiki } from './wiki-focus.ts'
 
 import { fetchStatus } from './status-cache.ts'
 import { fetchUiConfig } from './ui-config.ts'
@@ -91,6 +91,13 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
   let tip: HTMLDivElement | undefined
   let panelLabel: HTMLSpanElement | undefined
   let menuOpen = false
+  /** 焦点库订阅（多库菜单需要，dispose 时回收）。 */
+  let focusOff: (() => void) | undefined
+  /**
+   * 重画"知识库"分组的选中标记。打开菜单前调用一次 —— 订阅负责切库时即时重画，
+   * 这里负责兜住"订阅建立之前的窗口"与外部改动（v0.28.3）。
+   */
+  let repaintWikiMenu: (() => void) | undefined
   /** Latest TW health snapshot, merged into the hover tip. */
   let twHealth: TwHealth = { state: 'unknown', text: 'TiddlyWiki 服务…', logs: [] }
 
@@ -196,17 +203,33 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
       // 多知识库切换（v0.28.0）：只有多于一个库时才长出这一段，单库安装的菜单不变。
       // 点一下 = 把"焦点库"切过去并打开面板——面板会加载那个库自己的 /tw/<id>/。
       if (roster.wikis.length > 1) {
-        const focus = resolveFocusWiki(roster.wikis, roster.defaultId)
         const heading = document.createElement('div')
         heading.className = 'dsh-tw-fab-group'
         heading.textContent = '知识库'
         menu.append(heading)
+        /** 每个库的菜单项，便于焦点变化时就地刷新选中标记。 */
+        const wikiItems = new Map<string, HTMLButtonElement>()
+        /**
+         * 重画选中标记（v0.28.3）。
+         *
+         * 原来的实现只在**菜单构建时**算一次 focus，之后无论怎么切都不再更新 ——
+         * 于是"切了库、选中项还停在上一个"（作者报障）。这里改成从当前焦点重算，
+         * 并在 setFocusWiki 的订阅里重画；菜单关闭时也重画，保证下次打开是对的。
+         */
+        const paint = (): void => {
+          const current = resolveFocusWiki(roster.wikis, roster.defaultId)
+          for (const [id, el] of wikiItems) {
+            const isCurrent = id === current
+            el.dataset.current = isCurrent ? '1' : '0'
+            const wiki = roster.wikis.find((w) => w.id === id)
+            el.textContent = `${isCurrent ? '●' : '○'} ${wiki?.label ?? id}`
+          }
+        }
         for (const wiki of roster.wikis) {
           const item = document.createElement('button')
           item.type = 'button'
           item.className = 'dsh-tw-fab-item'
-          item.dataset.current = wiki.id === focus ? '1' : '0'
-          item.textContent = `${wiki.id === focus ? '●' : '○'} ${wiki.label}`
+          item.dataset.current = '0'
           item.title = `${wiki.path}${wiki.running ? '' : '（未运行，打开会启动）'}`
           item.addEventListener('click', () => {
             closeMenu()
@@ -224,8 +247,14 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
             }
             state.openPanel()
           })
+          wikiItems.set(wiki.id, item)
           menu.append(item)
         }
+        paint()
+        // 焦点变化（可能来自别的入口：侧边栏某一行、快速笔记卡片）也要跟上。
+        focusOff = subscribeFocusWiki(() => { paint() })
+        // 每次打开菜单前重画一次，避免因为订阅时机错过而显示旧值。
+        repaintWikiMenu = paint
       }
 
       panelLabel = document.createElement('span')
@@ -280,6 +309,9 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
       if (menuOpen) { closeMenu(); return }
       menuOpen = true
       menu.hidden = false
+      // 每次打开都重画一次选中标记（v0.28.3）：切库可能发生在菜单关着的时候
+      // （侧边栏入口、快速笔记卡片），不重画就会显示上一次的选中项。
+      repaintWikiMenu?.()
       renderDot()
       void refreshTwStatus()
     })
@@ -307,6 +339,8 @@ export function mountKnowledgeFab(state: PanelState, note: NoteWidgetHandle, syn
 
   return () => {
     disposed = true
+    focusOff?.()
+    focusOff = undefined
     document.removeEventListener('click', onDocumentClick, true)
     unsubPanel()
     unsubSync()

package/src/client/settings-page.ts

@@ -24,6 +24,7 @@
 import * as React from 'react'
 import { toast } from './toast.ts'
 import { invalidateUiConfig } from './ui-config.ts'
+import { ICON_NAMES } from './wiki-icon.ts'
 import {
   ADMIN_CONFIG_ENDPOINT as CONFIG_ENDPOINT,
   ADMIN_INFO_ENDPOINT as INFO_ENDPOINT,
@@ -943,8 +944,28 @@ interface WikiListItemView {
   autostart: boolean
   running: boolean
   status: string
+  /** Per-wiki entry icon (v0.28.4): a curated name or a short emoji. */
+  icon?: string
 }
 
+/**
+ * Icon picker labels (v0.28.4). The NAMES come from `wiki-icon.ts`, so the set
+ * the picker offers is exactly the set the sidebar can render.
+ */
+const ICON_LABELS: Record<string, string> = {
+  book: '📖 书（book）',
+  briefcase: '💼 公文包（briefcase）',
+  home: '🏠 房子（home）',
+  notebook: '📓 笔记本（notebook）',
+  flask: '🧪 实验（flask）',
+  globe: '🌐 地球（globe）',
+  star: '⭐ 星标（star）',
+  archive: '🗄 归档（archive）',
+}
+
+/** A few emoji that read well at sidebar size and are easy to tell apart. */
+const EMOJI_CHOICES = ['📚', '💼', '🏠', '✍️', '🧪', '🌱', '🎯', '🗂️']
+
 /** `GET`/`POST /dsh-tiddlywiki/admin/wikis` payload (v0.28.0). */
 interface WikisView {
   ok?: boolean
@@ -1111,6 +1132,29 @@ function renderWikiListSection(body: HTMLElement, isDisposed: () => boolean, ref
         const ok = window.confirm(`把「${wiki.label}」移出清单？\n\n**目录与内容不会被删除**（仍在 ${wiki.path}），只是插件不再管理它。`)
         if (ok) void post({ action: 'remove', id: wiki.id }, '移出中…')
       })
+      // 图标选择（v0.28.4）：下拉里是内置图形 + 一组常用 emoji；选「默认」即清除自定义。
+      // 它和 label 一样属于"库的身份"，所以在列表里改，而不是塞进常规配置区。
+      const iconPicker = make('select', 'dsh-tw-settings-icon-select')
+      iconPicker.setAttribute('aria-label', `「${wiki.label}」的入口图标`)
+      const currentIcon = typeof wiki.icon === 'string' ? wiki.icon : ''
+      const options: Array<[string, string]> = [['', '默认图标']]
+      for (const name of ICON_NAMES) options.push([name, ICON_LABELS[name] ?? name])
+      for (const emoji of EMOJI_CHOICES) options.push([emoji, emoji])
+      // 当前值不在候选里（用户填了自己的 emoji）：保留它，别让下拉把它抹掉。
+      if (currentIcon.length > 0 && !options.some(([v]) => v === currentIcon)) options.push([currentIcon, currentIcon])
+      for (const [value, text] of options) {
+        const opt = document.createElement('option')
+        opt.value = value
+        opt.textContent = text
+        iconPicker.append(opt)
+      }
+      iconPicker.value = currentIcon
+      iconPicker.addEventListener('change', () => {
+        const next = iconPicker.value
+        void post(next.length > 0
+          ? { action: 'update', wiki: { ...wiki, icon: next } }
+          : { action: 'update', wiki: { ...wiki, icon: '' } }, '保存中…')
+      })
       // 「改目录」只在多库模式出现（v0.28.1）：单库模式下这件事由「知识库位置」负责
       // （它写 wiki 之外的指针文件），两处并存会让用户不知道以哪个为准。
       if (view.mode === 'multi') {
@@ -1132,7 +1176,7 @@ function renderWikiListSection(body: HTMLElement, isDisposed: () => boolean, ref
         })
         actions.append(move)
       }
-      actions.append(configure, power, makeDefault, visibility, autostart, remove)
+      actions.append(configure, power, makeDefault, visibility, autostart, iconPicker, remove)
       row.append(actions)
       list.append(row)
     }

package/src/client/sidebar-entry.ts

@@ -13,12 +13,11 @@ 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 { applyWikiIcon } from './wiki-icon.ts'
 
 /** Stable data attribute identifying this entry row. */
 export const ENTRY_SELECTOR = '[data-dsh-tw-entry]'
 
-/** Inline icon: a wiki page with a TiddlyWiki-style "T" (nav-icon look). */
-const ICON = '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 2.5h8a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-9a1 1 0 0 1 1-1z"/><path d="M6 6h4M6 8.5h2.5"/></svg>'
 
 /** 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]'
@@ -59,26 +58,27 @@ function createEntry(
   state: PanelState,
   label: string,
   wikiId?: string,
-): { entry: HTMLButtonElement; labelEl: HTMLSpanElement } {
+  icon?: string,
+): { entry: HTMLButtonElement; labelEl: HTMLSpanElement; iconEl: HTMLSpanElement } {
   const entry = document.createElement('button')
   entry.type = 'button'
   entry.dataset.dshTwEntry = ''
   entry.className = 'dsh-tw-entry'
   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
+  const iconEl = document.createElement('span')
+  iconEl.className = 'dsh-tw-entry-icon'
+  applyWikiIcon(iconEl, icon)
   const labelEl = document.createElement('span')
   labelEl.className = 'dsh-tw-entry-label'
   labelEl.textContent = label
-  entry.append(icon, labelEl)
+  entry.append(iconEl, labelEl)
   entry.addEventListener('click', () => {
     // 多库：先把这个库设为「焦点库」，面板随后加载它自己的 /tw/<id>/。
     if (wikiId !== undefined) setFocusWiki(wikiId)
     state.toggle()
   })
-  return { entry, labelEl }
+  return { entry, labelEl, iconEl }
 }
 
 /** Re-insert the entry before the whole family block (stable ordering). */
@@ -116,9 +116,9 @@ 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 }>()
-  const { entry, labelEl } = createEntry(state, 'TiddlyWiki')
-  rows.set('', { entry, labelEl })
+  const rows = new Map<string, { entry: HTMLButtonElement; labelEl: HTMLSpanElement; iconEl: HTMLSpanElement }>()
+  const { entry, labelEl, iconEl } = createEntry(state, 'TiddlyWiki')
+  rows.set('', { entry, labelEl, iconEl })
   let disposed = false
   /**
    * 自定义显示名：/status 返回 ui.sidebarLabel（设置页「侧边栏入口显示名称」）。
@@ -172,10 +172,12 @@ 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)
+        row = createEntry(state, 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

package/src/client/status-cache.ts

@@ -59,6 +59,8 @@ export interface StatusPayload {
     autostart: boolean
     running: boolean
     path: string
+    /** Per-wiki entry icon (v0.28.4): a curated name or a short emoji. */
+    icon?: string
   }>
   ui?: {
     showQuickNote?: boolean

package/src/client/styles.ts

@@ -23,6 +23,16 @@ const CSS_TEXT = `
   cursor: pointer; text-align: left;
 }
 .dsh-tw-entry:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); color: var(--dsw-alias-label-primary, inherit); }
+/* 每库自定义图标（v0.28.4）：emoji 走 textContent，尺寸与 SVG 图标对齐。 */
+.dsh-tw-entry-icon.dsh-tw-entry-emoji {
+  display: inline-flex; align-items: center; justify-content: center;
+  width: 14px; height: 14px; font-size: 13px; line-height: 1;
+}
+.dsh-tw-settings-icon-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: 180px;
+}
 .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）：每库一个入口行，当前焦点库加一条左侧标线，和「面板正打开哪个库」区分开
    —— 面板是同一个，但焦点库决定它加载谁。 */

package/src/client/wiki-icon.ts

@@ -0,0 +1,65 @@
+/**
+ * Per-wiki entry icons (v0.28.4).
+ *
+ * A wiki's icon is part of its identity, stored next to `label` in the control
+ * file (`wikis.json`). A value is either one of {@link ICON_SVG}'s names — a
+ * curated set of hand-written 16×16 stroke SVGs that inherit `currentColor`, so
+ * they look right in both DSH themes with no assets to ship — or a short emoji
+ * literal (📚 / 💼 / 🏠), which costs nothing and tells four wikis apart at a
+ * glance.
+ *
+ * The host validates the same shape (`normalizeWikiIcon`); this module is only
+ * the rendering side, and it must never throw on a value it does not recognise —
+ * an unknown string falls back to the default icon rather than breaking the row.
+ *
+ * @module dsh-tiddlywiki/client/wiki-icon
+ */
+
+/** The default icon: a wiki page with a TiddlyWiki-style "T". */
+export const DEFAULT_ICON_SVG =
+  '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 2.5h8a1 1 0 0 1 1 1v9a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-9a1 1 0 0 1 1-1z"/><path d="M6 6h4M6 8.5h2.5"/></svg>'
+
+/** The curated name → SVG map. Names match `WIKI_ICON_NAMES` on the host. */
+export const ICON_SVG: Record<string, string> = {
+  book: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3.5 3h9v10h-9z"/><path d="M6.5 3v10"/><path d="M8.5 6h2.5M8.5 8.5h2"/></svg>',
+  briefcase: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 5.5h11v7h-11z"/><path d="M6 5.5V4a1 1 0 0 1 1-1h2a1 1 0 0 1 1 1v1.5"/><path d="M2.5 8.5h11"/></svg>',
+  home: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 7.5 8 3l5.5 4.5"/><path d="M4 7v6h8V7"/></svg>',
+  notebook: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 2.5h7.5v11H4z"/><path d="M6 2.5v11"/><path d="M8 6h2M8 8.5h2"/></svg>',
+  flask: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M6.5 2.5v4L3.5 12a1 1 0 0 0 .9 1.5h7.2A1 1 0 0 0 12.5 12L9.5 6.5v-4"/><path d="M5.5 2.5h5"/><path d="M4.8 10h6.4"/></svg>',
+  globe: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="8" cy="8" r="5.5"/><path d="M2.5 8h11"/><path d="M8 2.5c1.6 1.6 2.4 3.5 2.4 5.5S9.6 12 8 13.5C6.4 12 5.6 10 5.6 8s.8-3.9 2.4-5.5z"/></svg>',
+  star: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m8 2.5 1.7 3.6 3.8.5-2.8 2.7.7 3.9L8 11.4l-3.4 1.8.7-3.9-2.8-2.7 3.8-.5z"/></svg>',
+  archive: '<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 3.5h11v3h-11z"/><path d="M3.5 6.5v6h9v-6"/><path d="M6.5 9h3"/></svg>',
+}
+
+/** The curated names, in picker order (mirrors the host's `WIKI_ICON_NAMES`). */
+export const ICON_NAMES: readonly string[] = Object.keys(ICON_SVG)
+
+/**
+ * Is this value a name we ship an SVG for? Anything else is treated as an emoji
+ * literal by {@link applyWikiIcon}.
+ */
+export function isIconName(value: string): boolean {
+  return Object.prototype.hasOwnProperty.call(ICON_SVG, value)
+}
+
+/**
+ * Put `icon` into `el` (an `.dsh-tw-entry-icon` span), falling back to the
+ * default. A name sets innerHTML to our own SVG; anything else is set as TEXT
+ * content, never HTML — the value comes from a file a user can edit, so it must
+ * not be able to inject markup into the sidebar.
+ */
+export function applyWikiIcon(el: HTMLElement, icon: string | undefined): void {
+  if (icon !== undefined && isIconName(icon)) {
+    el.innerHTML = ICON_SVG[icon] ?? DEFAULT_ICON_SVG
+    el.classList.remove('dsh-tw-entry-emoji')
+    return
+  }
+  if (icon !== undefined && icon.trim().length > 0) {
+    // textContent, deliberately: a control-file string must never be markup.
+    el.textContent = icon.trim()
+    el.classList.add('dsh-tw-entry-emoji')
+    return
+  }
+  el.innerHTML = DEFAULT_ICON_SVG
+  el.classList.remove('dsh-tw-entry-emoji')
+}

package/src/host/wiki-registry.ts

@@ -108,6 +108,50 @@ export interface WikiEntry {
   agentVisible: boolean
   /** Start its TW child process at boot (default false; the default wiki is true). */
   autostart: boolean
+  /**
+   * Sidebar/entry icon (v0.28.4). Either a NAME from {@link WIKI_ICON_NAMES}
+   * (a curated set of built-in SVGs) or a short EMOJI literal.
+   *
+   * Why free-form-but-tiny instead of a fixed enum: a curated set covers the
+   * common cases without shipping a picker that needs its own assets, while an
+   * emoji lets someone tell four wikis apart at a glance (📚 / 💼 / 🏠) with
+   * nothing to download or maintain.
+   *
+   * It lives in the control file next to `label` because it is part of a wiki's
+   * IDENTITY — the same reason `label` is here and not in a tiddler. Absent =
+   * the built-in default icon (so upgrades see no change).
+   */
+  icon?: string
+}
+
+/**
+ * Built-in icon names (the picker's curated set). Deliberately small: each is a
+ * hand-written 16×16 stroke SVG inheriting `currentColor`, so it renders in both
+ * DSH themes with no asset pipeline.
+ */
+export const WIKI_ICON_NAMES = ['book', 'briefcase', 'home', 'notebook', 'flask', 'globe', 'star', 'archive'] as const
+
+/**
+ * Normalise an icon value: a known name, or a SHORT emoji-ish string, else
+ * undefined (= use the default).
+ *
+ * The length cap matters: the value can end up as text content in the sidebar,
+ * and an unbounded string would let a control file wreck the layout. Emoji are
+ * 1–2 code points; 8 UTF-16 units fits a ZWJ cluster without being a place to
+ * hide a paragraph.
+ */
+export function normalizeWikiIcon(value: unknown): string | undefined {
+  if (typeof value !== 'string') return undefined
+  const trimmed = value.trim()
+  if (trimmed.length === 0) return undefined
+  if ((WIKI_ICON_NAMES as readonly string[]).includes(trimmed)) return trimmed
+  if (trimmed.length > 8) return undefined
+  // A control character would be invisible or break the row.
+  for (const ch of trimmed) {
+    const code = ch.codePointAt(0) ?? 0
+    if (code < 0x20 || code === 0x7f) return undefined
+  }
+  return trimmed
 }
 
 /** The whole registry: the mode, a non-empty list, and the default-wiki pointer. */
@@ -268,6 +312,9 @@ export function normalizeEntry(input: unknown): { entry?: WikiEntry; error?: str
       name: normalized.location.name,
       agentVisible: input.agentVisible !== false,
       autostart: input.autostart === true,
+      // 图标可选：只在给了合法值时才带上，这样"没设过"的库在 JSON 里保持干净
+      // （也保证既有清单重新序列化后逐字不变）。
+      ...(normalizeWikiIcon(input.icon) !== undefined ? { icon: normalizeWikiIcon(input.icon) } : {}),
     },
   }
 }

package/src/index.ts

@@ -187,12 +187,14 @@ export {
   findEntry,
   findPathConflicts,
   normalizeEntry,
+  normalizeWikiIcon,
   normalizeWikiId,
   readRegistry,
   removeWiki,
   singleEntryRegistry,
   upsertWiki,
   validateRegistry,
+  WIKI_ICON_NAMES,
   writeRegistry,
   type RegistryReadResult,
   type RegistryValidation,
@@ -1133,6 +1135,8 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
               autostart: entry.autostart,
               running: runtime !== undefined,
               path: entryPath(entry),
+              // 每库图标（v0.28.4）：侧边栏入口与设置页选择器共用这个来源。
+              icon: entry.icon,
             }
           }),
         }