dsh-tiddlywiki 0.1.2 → 0.2.0

package/src/client/styles.ts

@@ -24,6 +24,21 @@ const CSS_TEXT = `
 .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; }
 .dsh-tw-entry svg { flex: none; }
 .dsh-tw-entry .dsh-tw-entry-label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+/* Collapsed rail: the shell narrows the sidebar to a 56px icon rail (dual
+   signals — the frame's data-sidebar-collapsed + the sidebar root's hashed
+   *_collapsed class, same doctrine as dsh-taskboard 0.4.3). Mirror the
+   native 36×36 icon-button geometry: center the icon, hide the label, and
+   scale it up to match the shell's 18px rail icons. */
+[data-sidebar-collapsed] [data-dsh-tw-entry],
+[class*="_collapsed"] [data-dsh-tw-entry] {
+  width: 36px; height: 36px; min-width: 36px;
+  margin: 0 0 12px; padding: 0;
+  justify-content: center; gap: 0; text-align: center;
+}
+[data-sidebar-collapsed] [data-dsh-tw-entry] .dsh-tw-entry-label,
+[class*="_collapsed"] [data-dsh-tw-entry] .dsh-tw-entry-label { display: none; }
+[data-sidebar-collapsed] [data-dsh-tw-entry] svg,
+[class*="_collapsed"] [data-dsh-tw-entry] svg { width: 18px; height: 18px; }
 
 /* ── center-column panel (fixed overlay, JS-pinned to the column rect) ── */
 .dsh-tw-view {
@@ -139,6 +154,34 @@ html[data-dsh-tw-active] .dshDesktopConversationSurface > :not([data-dsh-tw-view
 }
 .dsh-tw-note-edit:hover:not(:disabled) { filter: brightness(.96); }
 .dsh-tw-note-edit:disabled { opacity: .55; cursor: default; }
+/* ── Multi-tag chip editor (quick-note tags) ─────────────────────────────── */
+.dsh-tw-note-tags { position: relative; flex: 1; min-width: 0; display: flex; flex-direction: column; gap: 4px; }
+.dsh-tw-note-chips { display: flex; flex-wrap: wrap; gap: 4px; }
+.dsh-tw-note-tagchip {
+  display: inline-flex; align-items: center; gap: 4px;
+  padding: 2px 6px 2px 8px; border-radius: 999px; font-size: 11px; line-height: 1.4;
+  background: color-mix(in srgb, var(--dsw-alias-brand-primary, #3e63dd) 10%, var(--dsw-alias-bg-layer-1, #fff));
+  border: 1px solid color-mix(in srgb, var(--dsw-alias-brand-primary, #3e63dd) 30%, transparent);
+  color: var(--dsw-alias-label-primary, #222);
+}
+.dsh-tw-note-tagchip-x {
+  cursor: pointer; font-size: 12px; line-height: 1; padding: 0 2px; border-radius: 50%;
+  color: var(--dsw-alias-label-secondary, #888);
+}
+.dsh-tw-note-tagchip-x:hover { color: var(--dsw-alias-state-error-primary, #d13b3b); }
+.dsh-tw-note-taginput { width: 100%; box-sizing: border-box; }
+.dsh-tw-note-tagsuggest {
+  position: absolute; left: 0; right: 0; top: calc(100% + 2px); z-index: 60;
+  max-height: 168px; overflow-y: auto; border-radius: 8px; padding: 4px;
+  background: var(--dsw-alias-bg-layer-2, #fff); color: var(--dsw-alias-label-primary, #222);
+  border: 1px solid var(--dsw-alias-border-l2, rgba(0,0,0,.18));
+  box-shadow: var(--dsw-shadow-lv2, 0 4px 16px rgba(0,0,0,.16));
+  font-size: 12px;
+}
+.dsh-tw-note-tagsuggest-item {
+  padding: 6px 9px; border-radius: 6px; cursor: pointer; white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+}
+.dsh-tw-note-tagsuggest-item:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(128,128,128,.12)); }
 /* ── Native-editor popup iframe (quick-note "在 TW 中编辑") ──────────────── */
 .dsh-tw-editor-popup {
   position: fixed; left: 0; right: 0; top: 0; bottom: 0; margin: auto;

package/src/host/config.ts

@@ -20,6 +20,12 @@ export const CONFIG_TIDDLER = '$:/plugins/dsh-tiddlywiki/config'
 export interface PluginConfigShape {
   note?: { tag?: string }
   git?: { autoCommit?: boolean; debounceMs?: number; remote?: string; branch?: string }
+  ui?: {
+    /** 是否在界面右下角显示「快速笔记」悬浮按钮（默认 true）。 */
+    showQuickNote?: boolean
+    /** 是否启用「侧边移到左侧.css」默认 CSS；被删除后随启动补丁还原（默认 true）。 */
+    sidebarLeftCss?: boolean
+  }
   uiLanguage?: string
   [key: string]: unknown
 }

package/src/host/routes.ts

@@ -39,6 +39,7 @@ export interface RouteDeps {
   git: GitFace
   autoCommit: () => void
   noteDefaults: () => { tag: string }
+  uiDefaults: () => { showQuickNote: boolean }
   getWikiPath: () => string
 }
 
@@ -86,10 +87,10 @@ export async function openInTwEditor(
   client: TiddlyWebClient,
   title: string,
   text: string,
-  tag: string,
+  tags: string[],
 ): Promise<{ title: string; draftTitle: string }> {
   if (text.trim().length > 0) {
-    await client.put({ title, text, tags: [tag] })
+    await client.put({ title, text, tags })
   }
   // Draft content: the provided text, else the existing tiddler's content.
   let draftText = text
@@ -115,6 +116,22 @@ export async function openInTwEditor(
   return { title, draftTitle }
 }
 
+/** Resolve note tags from the request body: `tags` array wins, then the
+ *  legacy single `tag` string, then the configured default tag. */
+function resolveTags(
+  body: { tag?: unknown; tags?: unknown },
+  defaultTag: string,
+): string[] {
+  if (Array.isArray(body.tags)) {
+    const tags = body.tags.filter((t): t is string => typeof t === 'string' && t.trim().length > 0).map((t) => t.trim())
+    if (tags.length > 0) return tags
+  }
+  if (typeof body.tag === 'string' && body.tag.trim().length > 0) {
+    return body.tag.trim().split(/\s+/).filter(Boolean)
+  }
+  return [defaultTag]
+}
+
 export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDeps): () => void {
   const handleStatus = async (_req: IncomingMessage, res: ServerResponse): Promise<void> => {
     const view = deps.server.status()
@@ -124,12 +141,12 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
     } catch {
       gitSummary = null
     }
-    json(res, { ok: true, ...view, git: gitSummary, note: { tag: deps.noteDefaults().tag } })
+    json(res, { ok: true, ...view, git: gitSummary, note: { tag: deps.noteDefaults().tag }, ui: deps.uiDefaults() })
   }
 
   const handleNote = async (req: IncomingMessage, res: ServerResponse): Promise<void> => {
     try {
-      const body = JSON.parse(await readBody(req)) as { title?: unknown; tag?: unknown; text?: unknown }
+      const body = JSON.parse(await readBody(req)) as { title?: unknown; tag?: unknown; tags?: unknown; text?: unknown }
       const text = typeof body.text === 'string' && body.text.trim().length > 0 ? body.text.trim() : null
       if (text === null) {
         json(res, { ok: false, error: 'text is required' }, 400)
@@ -141,10 +158,10 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
         return
       }
       const title = typeof body.title === 'string' && body.title.trim().length > 0 ? body.title.trim() : timestampTitle()
-      const tag = typeof body.tag === 'string' && body.tag.trim().length > 0 ? body.tag.trim() : deps.noteDefaults().tag
-      await client.put({ title, text, tags: [tag] })
+      const tags = resolveTags(body, deps.noteDefaults().tag)
+      await client.put({ title, text, tags })
       deps.autoCommit()
-      json(res, { ok: true, title, tag, text })
+      json(res, { ok: true, title, tag: tags.join(' '), tags, text })
     } catch (err) {
       json(res, { ok: false, error: err instanceof Error ? err.message : String(err) }, 500)
     }
@@ -152,16 +169,16 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
 
   const handleEdit = async (req: IncomingMessage, res: ServerResponse): Promise<void> => {
     try {
-      const body = JSON.parse(await readBody(req)) as { title?: unknown; tag?: unknown; text?: unknown }
+      const body = JSON.parse(await readBody(req)) as { title?: unknown; tag?: unknown; tags?: unknown; text?: unknown }
       const client = deps.getClient()
       if (client === undefined) {
         json(res, { ok: false, error: 'wiki service is not running' }, 503)
         return
       }
       const title = typeof body.title === 'string' && body.title.trim().length > 0 ? body.title.trim() : timestampTitle()
-      const tag = typeof body.tag === 'string' && body.tag.trim().length > 0 ? body.tag.trim() : deps.noteDefaults().tag
+      const tags = resolveTags(body, deps.noteDefaults().tag)
       const text = typeof body.text === 'string' ? body.text : ''
-      const result = await openInTwEditor(client, title, text, tag)
+      const result = await openInTwEditor(client, title, text, tags)
       deps.autoCommit()
       json(res, { ok: true, ...result, twUrl: deps.server.url })
     } catch (err) {
@@ -169,6 +186,27 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
     }
   }
 
+  /** Distinct non-system tags for the quick-note tag autocomplete. */
+  const handleTags = async (_req: IncomingMessage, res: ServerResponse): Promise<void> => {
+    const client = deps.getClient()
+    if (client === undefined) {
+      json(res, { ok: false, error: 'wiki service is not running' }, 503)
+      return
+    }
+    try {
+      const items = await client.list(undefined, false)
+      const tags = new Set<string>()
+      for (const item of items) {
+        for (const tag of item.tags ?? []) {
+          if (tag.length > 0 && !tag.startsWith('$:/')) tags.add(tag)
+        }
+      }
+      json(res, { ok: true, tags: [...tags].sort((a, b) => a.localeCompare(b, 'zh')) })
+    } catch (err) {
+      json(res, { ok: false, error: err instanceof Error ? err.message : String(err) }, 500)
+    }
+  }
+
   const handleRestart = async (_req: IncomingMessage, res: ServerResponse): Promise<void> => {
     try {
       await deps.server.restart()
@@ -212,6 +250,7 @@ export function registerRoutes(ctx: { webServer: WebServerFace }, deps: RouteDep
     ctx.webServer.register({ kind: 'exact', path: `${ROUTE_PREFIX}/status`, handler: (req, res) => { void handleStatus(req, res) } }),
     ctx.webServer.register({ kind: 'exact', path: `${ROUTE_PREFIX}/note`, handler: (req, res) => { void handleNote(req, res) } }),
     ctx.webServer.register({ kind: 'exact', path: `${ROUTE_PREFIX}/edit`, handler: (req, res) => { void handleEdit(req, res) } }),
+    ctx.webServer.register({ kind: 'exact', path: `${ROUTE_PREFIX}/tags`, handler: (req, res) => { void handleTags(req, res) } }),
     ctx.webServer.register({ kind: 'exact', path: `${ROUTE_PREFIX}/restart`, handler: (req, res) => { void handleRestart(req, res) } }),
     ctx.webServer.register({ kind: 'prefix', path: `${ROUTE_PREFIX}/api`, handler: (req, res) => { void handleApiProxy(req, res) } }),
   ]

package/src/host/seed-notes.ts

@@ -1,10 +1,16 @@
 /**
- * Built-in doc note for the plugin (design doc §14): a short user-facing
- * "how to use dsh-tiddlywiki" note that is seeded into the wiki on first run.
+ * Built-in doc note + optional UI-patch seeds for the plugin (design doc §14).
  *
- * Idempotent seed (create-if-missing): on every plugin start we check whether
- * the note tiddler exists and only write it when it is absent — deleting it
- * and restarting dsh web recreates it, but editing it never gets overwritten.
+ * Two seeds, deliberately different lifetimes:
+ *
+ * 1. DOC NOTE (`dsh-tiddlywiki 插件说明`) — ONE-SHOT: seeded only the first
+ *    time this plugin runs on a wiki (guarded by a `seed-doc-note` marker
+ *    tiddler). After that the note is the user's own content: deleting it and
+ *    restarting dsh web does NOT recreate it.
+ * 2. SIDEBAR-LEFT CSS (`侧边移到左侧.css`) — PATCH-REPAIR: written whenever
+ *    the wiki lacks it while the `ui.sidebarLeftCss` option is enabled
+ *    (default on). The user may delete it; a restart with the option still on
+ *    re-seeds it (the "补丁选项"). Turning the option off stops re-seeding.
  *
  * @module dsh-tiddlywiki/host/seed-notes
  */
@@ -16,6 +22,9 @@ export const DOC_NOTE_TITLE = 'dsh-tiddlywiki 插件说明'
 /** Tag that makes the note easy to find via `tiddlywiki_search tag=docs`. */
 export const DOC_NOTE_TAG = 'docs'
 
+/** One-time marker: its presence means "the note was offered once — hands off". */
+export const SEED_MARKER_TITLE = '$:/plugins/dsh-tiddlywiki/seed-doc-note'
+
 /** The note body, TiddlyWiki wiki-text. */
 export const DOC_NOTE_TEXT = `! dsh-tiddlywiki 插件说明
 
@@ -25,9 +34,9 @@ export const DOC_NOTE_TEXT = `! dsh-tiddlywiki 插件说明
 
 * **5 个 agent 工具**：\`tiddlywiki_search\`（检索）/ \`tiddlywiki_get\`（读）/ \`tiddlywiki_put\`（写）/ \`tiddlywiki_delete\`（删）/ \`tiddlywiki_git_sync\`（git 同步）。
 * **TW 编辑器面板**：侧边栏「TiddlyWiki」按钮 → 在界面中央打开完整版 TW 编辑器。
-* **快速笔记**：右下角悬浮「📝 快速笔记」写随手记，\`Ctrl+Enter\` 保存；点「✏️ 在 TW 中编辑」会弹出独立小窗用 TW 原生编辑器编辑。
+* **快速笔记**：右下角悬浮「📝 快速笔记」写随手记（可多选/自动补全 tag），\`Ctrl+Enter\` 保存；点「✏️ 在 TW 中编辑」会弹出独立小窗用 TW 原生编辑器编辑。
 * **git 同步**：写入自动防抖 commit（默认 60 秒）；手动 \`tiddlywiki_git_sync action=sync\` 做 pull → commit → push。
-* **设置页**：DSH 设置 → 「TiddlyWiki 知识库」管理插件/主题/语言与运行配置。
+* **设置页**：DSH 设置 → 「TiddlyWiki 知识库」管理插件/主题/语言与运行配置（含「快速笔记」显示开关、侧边栏移左 CSS 补丁开关）。
 
 !! 知识库纪律（三条）
 
@@ -42,21 +51,72 @@ export const DOC_NOTE_TEXT = `! dsh-tiddlywiki 插件说明
 
 !! 说明
 
-* 本笔记由插件在首次启动时自动写入 wiki（幂等：不存在才写）。删除后重启 dsh web 会重建；手动编辑过的内容不会被覆盖。
+* 本笔记由插件在**首次启动**时自动写入（一次性：只写一次）。删除后重启 dsh web **不会自动恢复**——它从此归你所有。
+* 「\`侧边移到左侧.css\`」是插件默认安装的界面补丁（把 TW 右侧栏移到左边）；可在设置页关闭「侧边栏移左 CSS」开关来停用补丁还原。
 * 更多细节见插件仓库 README。`
 
 /**
- * Seed the doc note when it is absent. Returns whether a note was written.
- * Never throws (missing wiki or note already present → no-op / false).
+ * Seed the doc note exactly once per wiki. A marker tiddler records that the
+ * note has been offered; from then on the note is user-owned and is never
+ * re-created (deleting it survives restarts). Returns whether a note was
+ * written this call. Never throws.
  */
 export async function seedDocNote(client: TiddlyWebClient): Promise<boolean> {
+  const marker = await client.get(SEED_MARKER_TITLE).catch(() => undefined)
+  if (marker !== undefined) return false
   const existing = await client.get(DOC_NOTE_TITLE).catch(() => undefined)
+  let wrote = false
+  if (existing === undefined) {
+    await client.put({
+      title: DOC_NOTE_TITLE,
+      text: DOC_NOTE_TEXT,
+      type: 'text/vnd.tiddlywiki',
+      tags: [DOC_NOTE_TAG],
+    })
+    wrote = true
+  }
+  // Record the offer regardless, so an existing note (upgrade from an older
+  // create-if-missing version) also becomes user-owned from here on.
+  await client
+    .put({ title: SEED_MARKER_TITLE, text: 'seeded-once', type: 'text/plain', tags: [] })
+    .catch(() => undefined)
+  return wrote
+}
+
+/** Sidebar-left CSS tiddler: moves TW's sidebar to the LEFT (mirror of the
+ *  `centralised` default), so dsh-better-sidebar's top-right toggle cluster
+ *  no longer sits over TW's own right sidebar. A normal tiddler (tag
+ *  `$:/tags/Stylesheet`, type text/css) — same pattern as hand-made
+ *  `编辑界面微调：小标题·大编辑器.css`, easy to find and delete. */
+export const SIDEBAR_LEFT_CSS_TITLE = '侧边移到左侧.css'
+
+/** The stylesheet body. Hardcoded 960px breakpoint (vanilla default
+ *  sidebarbreakpoint) — plain text/css tiddlers don't process `{{...}}`. */
+export const SIDEBAR_LEFT_CSS = `/* 由 dsh-tiddlywiki 插件默认安装：把 TW 右侧栏镜像到左侧（与 centralised 主题默认对称）。
+   删除后，只要设置页「侧边栏移左 CSS」补丁开关开着，插件会在下次启动时重建本 tiddler。 */
+@media (min-width: 960px) {
+  html .tc-sidebar-scrollable {
+    left: 0 !important;
+    right: 50% !important;
+    margin-left: 0 !important;
+    margin-right: 343px !important;
+  }
+}`
+
+/**
+ * Patch-repair the sidebar-left CSS while the option is enabled: write it
+ * whenever it is missing (fresh installs and deleted-by-user both re-seed).
+ * Returns whether it was written. Never throws.
+ */
+export async function seedSidebarLeftCss(client: TiddlyWebClient, enabled: boolean): Promise<boolean> {
+  if (!enabled) return false
+  const existing = await client.get(SIDEBAR_LEFT_CSS_TITLE).catch(() => undefined)
   if (existing !== undefined) return false
   await client.put({
-    title: DOC_NOTE_TITLE,
-    text: DOC_NOTE_TEXT,
-    type: 'text/vnd.tiddlywiki',
-    tags: [DOC_NOTE_TAG],
+    title: SIDEBAR_LEFT_CSS_TITLE,
+    text: SIDEBAR_LEFT_CSS,
+    type: 'text/css',
+    tags: ['$:/tags/Stylesheet'],
   })
   return true
 }

package/src/index.ts

@@ -25,7 +25,7 @@ import { AutoCommitter, GitFace } from './host/git.ts'
 import { registerRoutes, type WebServerFace } from './host/routes.ts'
 import { ConfigStore, deepMerge, type PluginConfigShape } from './host/config.ts'
 import { registerAdminRoutes, ensureLanguage, resolveTwRoot, type AdminDeps } from './host/admin.ts'
-import { seedDocNote, DOC_NOTE_TITLE } from './host/seed-notes.ts'
+import { seedDocNote, seedSidebarLeftCss, DOC_NOTE_TITLE } from './host/seed-notes.ts'
 import { TiddlyWebClient } from './host/tw-api.ts'
 import { registerTiddlywikiTools, type ToolsDeps } from './host/tools.ts'
 import { PATH_PREFIX, WikiServer, type WikiServerOptions } from './host/wiki.ts'
@@ -42,7 +42,7 @@ export { AutoCommitter, GitFace, PATH_PREFIX, TiddlyWebClient, WikiServer, dshHo
 export { ConfigStore, deepMerge } from './host/config.ts'
 export { openInTwEditor } from './host/routes.ts'
 export { registerAdminRoutes, resolveTwRoot, readWikiInfo, writeWikiInfo, bundledCatalog, ensureLanguage, normalizeThemes } from './host/admin.ts'
-export { seedDocNote, DOC_NOTE_TITLE, DOC_NOTE_TAG, DOC_NOTE_TEXT } from './host/seed-notes.ts'
+export { seedDocNote, seedSidebarLeftCss, DOC_NOTE_TITLE, DOC_NOTE_TAG, DOC_NOTE_TEXT, SIDEBAR_LEFT_CSS_TITLE, SIDEBAR_LEFT_CSS } from './host/seed-notes.ts'
 export type { PluginConfigShape } from './host/config.ts'
 export type { GitStatusView } from './host/git.ts'
 export type { Tiddler } from './host/tw-api.ts'
@@ -55,6 +55,7 @@ export interface TiddlywikiConfig {
   port?: number
   git?: { autoCommit?: boolean; debounceMs?: number; remote?: string; branch?: string }
   note?: { tag?: string }
+  ui?: { showQuickNote?: boolean; sidebarLeftCss?: boolean }
   auth?: { username?: string; password?: string }
 }
 
@@ -75,6 +76,7 @@ interface ResolvedConfig {
   port: number
   git: { autoCommit: boolean; debounceMs: number; remote: string; branch: string }
   note: { tag: string }
+  ui: { showQuickNote: boolean; sidebarLeftCss: boolean }
   auth: { username?: string; password?: string }
 }
 
@@ -84,6 +86,7 @@ const DEFAULTS: ResolvedConfig = {
   port: 0,
   git: { autoCommit: true, debounceMs: 60_000, remote: '', branch: 'main' },
   note: { tag: 'inbox' },
+  ui: { showQuickNote: true, sidebarLeftCss: true },
   auth: { username: '', password: '' },
 }
 
@@ -163,6 +166,7 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
     port: rawConfig.port ?? DEFAULTS.port,
     git: { ...DEFAULTS.git, ...(rawConfig.git ?? {}) },
     note: { ...DEFAULTS.note, ...(rawConfig.note ?? {}) },
+    ui: { ...DEFAULTS.ui, ...(rawConfig.ui ?? {}) },
     auth: { ...DEFAULTS.auth, ...(rawConfig.auth ?? {}) },
   }
   const wikiPath = join(config.wikiRoot, config.wiki)
@@ -171,12 +175,16 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
   // Runtime-editable config (settings page): the cordis `config:` block is the
   // BASE; a config tiddler ($:/plugins/dsh-tiddlywiki/config) written by the
   // settings page overlays it. Effective values come from configStore.get().
-  const configStore = new ConfigStore({ note: config.note, git: config.git } satisfies PluginConfigShape)
+  const configStore = new ConfigStore({ note: config.note, git: config.git, ui: config.ui } satisfies PluginConfigShape)
   const eff = (): PluginConfigShape => configStore.get()
   const effectiveNoteTag = (): string => {
     const tag = eff().note?.tag
     return typeof tag === 'string' && tag.trim().length > 0 ? tag : config.note.tag
   }
+  const effectiveUi = (): { showQuickNote: boolean; sidebarLeftCss: boolean } => ({
+    showQuickNote: eff().ui?.showQuickNote !== false,
+    sidebarLeftCss: eff().ui?.sidebarLeftCss !== false,
+  })
 
   const disposers: Array<() => void> = []
   const disposeAll = (): void => {
@@ -265,13 +273,19 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
     try {
       await server.start()
       await configStore.load(client())
-      // Seed the built-in doc note (idempotent, create-if-missing) so a fresh
-      // wiki gets the plugin guide by default.
+      // Seeds (run after the effective config is loaded):
+      //  - doc note: ONE-SHOT — a fresh wiki gets the plugin guide; deleting
+      //    it afterwards survives restarts (see seedDocNote).
+      //  - sidebar-left CSS: PATCH-REPAIR while ui.sidebarLeftCss is on —
+      //    re-seeds when missing (fresh install OR user deleted it).
       try {
         const seedClient = client()
-        if (seedClient !== undefined) await seedDocNote(seedClient)
+        if (seedClient !== undefined) {
+          await seedDocNote(seedClient)
+          await seedSidebarLeftCss(seedClient, effectiveUi().sidebarLeftCss)
+        }
       } catch (err) {
-        console.warn('[dsh-tiddlywiki] seeding doc note:', err)
+        console.warn('[dsh-tiddlywiki] seeding doc note / css:', err)
       }
       // Apply the configured UI language (e.g. "zh-Hans"): enable the bundled
       // language plugin in tiddlywiki.info.languages + restart once so TW loads
@@ -307,6 +321,7 @@ export function apply(ctx: HostCtx, rawConfig: TiddlywikiConfig = {}): void {
       git,
       autoCommit: () => committer?.touch(),
       noteDefaults: () => ({ tag: effectiveNoteTag() }),
+      uiDefaults: () => effectiveUi(),
       getWikiPath: () => wikiPath,
     })
     const adminDeps: AdminDeps = {