dsh-tiddlywiki 0.1.2 → 0.2.0

package/README.md

@@ -24,7 +24,7 @@ TiddlyWiki 的特性正好合适：单文件、纯文本、wiki 语法、自带
 |---|---|
 | Agent 工具 | `tiddlywiki_search` / `get` / `put` / `delete` / `git_sync` |
 | 人编辑 | 侧边栏「TiddlyWiki」入口 → 中央列内嵌完整 TW 编辑器（iframe 直连 TW 服务） |
-| 快速笔记 | 聊天区右下角常驻悬浮控件（可折叠，标题/tag 可自定义，Ctrl+Enter 保存） |
+| 快速笔记 | 聊天区右下角常驻悬浮控件（可折叠，可多选/自动补全 tag，Ctrl+Enter 保存；设置页可整体隐藏） |
 | 零摩擦生命周期 | 随 dsh 自动启动/关闭；TW 子进程崩溃自动重启（退避）；端口/目录/首次 git init 全自动 |
 | 同步 | 单线程交替模型：开工 pull，收工 commit+push，自动 commit（60s 防抖，可关） |
 
@@ -43,13 +43,13 @@ dsh plugin --profile web add github:bbqisbbq/dsh-tiddlywiki
 dsh plugin --profile web add link:C:\Users\bbq\.dsh\plugins\dsh-tiddlywiki
 ```
 
-首次启动会向 wiki **幂等写入**一篇「dsh-tiddlywiki 插件说明」笔记（tag `docs`）。
+首次启动会向 wiki **写入一次**「dsh-tiddlywiki 插件说明」笔记（tag `docs`），并默认安装「侧边移到左侧.css」界面补丁（把 TW 右侧栏移到左边；被删除后，只要设置页「侧边栏移左 CSS」开关开着就会随启动补丁还原）。
 
 ## 发布 / 仓库
 
 - **GitHub（公开）**：https://github.com/bbqisbbq/dsh-tiddlywiki
 - **npm**：`dsh-tiddlywiki`（`npm i dsh-tiddlywiki`；https://www.npmjs.com/package/dsh-tiddlywiki ）
-- **说明笔记**：插件在首次启动时向 wiki **幂等写入**一篇「`dsh-tiddlywiki 插件说明`」笔记（tag `docs`）——不存在才写、手动编辑不被覆盖、删除后重启会重建；当前 live wiki 里已有一份。
+- **说明笔记**：插件在**首次启动**时向 wiki **写入一次**「`dsh-tiddlywiki 插件说明`」笔记（tag `docs`）——只写一次、手动编辑不被覆盖、**删除后重启不会自动恢复**（一次性标记；清空 wiki 重装会再写入）。当前 live wiki 里已有一份。
 
 ## 可被检索的标准字段
 
@@ -85,6 +85,9 @@ dsh plugin --profile web add link:C:\Users\bbq\.dsh\plugins\dsh-tiddlywiki
       branch: "main"
     note:
       tag: "inbox"
+    ui:
+      showQuickNote: true           # 是否显示右下角「快速笔记」按钮
+      sidebarLeftCss: true          # 是否启用「侧边移到左侧.css」补丁（被删后随启动还原）
     auth:
       username: ""                     # 默认 loopback 匿名；暴露到非 loopback 时才需要
       password: ""
@@ -95,7 +98,7 @@ dsh plugin --profile web add link:C:\Users\bbq\.dsh\plugins\dsh-tiddlywiki
 
 > 运行时配置：设置页（见「设置页」）写入的 `$:/plugins/dsh-tiddlywiki/config`
 > tiddler 是 `config:` 块之上的覆盖层（tiddler 优先、随 wiki 的 git 同步）。
-> 无需改动 cordis 也能改 note tag / git 开关等。
+> 无需改动 cordis 也能改 note tag / git 开关 / ui 开关等。
 
 ## 使用
 

package/lib/client.bundle.js

@@ -48,6 +48,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 {
@@ -163,6 +178,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;
@@ -847,14 +890,23 @@ function ensurePopup() {
 * collapsible, independent of any shell DOM. Lets the human jot drafts /
 * scratch notes while waiting for the AI or drafting the next prompt.
 *
-* Save posts to /dsh-tiddlywiki/note → an independent tiddler (title & tag
+* Save posts to /dsh-tiddlywiki/note → an independent tiddler (title & tags
 * editable; defaults: timestamp title + config tag, usually "inbox").
 *
+* ui.showQuickNote config: the widget is mounted async and stays hidden (and
+* never appended) when the option is off, so the toggle button can be disabled
+* from the settings page without touching the shell.
+*
+* Tag editor: multi-select chips + autocomplete from the wiki's existing tags
+* (GET /dsh-tiddlywiki/tags). Enter/`,` commits the typed value; Backspace on
+* an empty field removes the last chip; the dropdown filters on typing.
+*
 * @module dsh-tiddlywiki/client/note-widget
 */
 const NOTE_ENDPOINT = "/dsh-tiddlywiki/note";
 const EDIT_ENDPOINT = "/dsh-tiddlywiki/edit";
 const STATUS_ENDPOINT = "/dsh-tiddlywiki/status";
+const TAGS_ENDPOINT = "/dsh-tiddlywiki/tags";
 function pad(n) {
 	return n < 10 ? `0${n}` : String(n);
 }
@@ -862,16 +914,137 @@ function pad(n) {
 function timestampTitle(date = /* @__PURE__ */ new Date()) {
 	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
 }
-async function fetchDefaultTag() {
+async function fetchUiOptions() {
+	const fallback = {
+		showQuickNote: true,
+		defaultTag: "inbox"
+	};
 	try {
 		const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(5e3) });
-		if (!res.ok) return "inbox";
-		return (await res.json()).note?.tag ?? "inbox";
+		if (!res.ok) return fallback;
+		const payload = await res.json();
+		return {
+			showQuickNote: payload.ui?.showQuickNote !== false,
+			defaultTag: payload.note?.tag ?? "inbox"
+		};
 	} catch {
-		return "inbox";
+		return fallback;
 	}
 }
-function mountNoteWidget() {
+/** Multi-tag chip editor with autocomplete from the wiki's existing tags. */
+function buildTagEditor() {
+	const wrap = document.createElement("div");
+	wrap.className = "dsh-tw-note-tags";
+	const chipWrap = document.createElement("div");
+	chipWrap.className = "dsh-tw-note-chips";
+	const input = document.createElement("input");
+	input.className = "dsh-tw-note-taginput";
+	input.placeholder = "tag（可多选，自动补全）";
+	const suggest = document.createElement("div");
+	suggest.className = "dsh-tw-note-tagsuggest";
+	suggest.hidden = true;
+	wrap.append(chipWrap, input, suggest);
+	const chips = [];
+	const hideSuggest = () => {
+		suggest.hidden = true;
+	};
+	const renderChips = () => {
+		chipWrap.replaceChildren();
+		for (const tag of chips) {
+			const chip = document.createElement("span");
+			chip.className = "dsh-tw-note-tagchip";
+			chip.textContent = tag;
+			const x = document.createElement("span");
+			x.className = "dsh-tw-note-tagchip-x";
+			x.textContent = "×";
+			x.title = `移除 tag「${tag}」`;
+			x.addEventListener("click", (event) => {
+				event.stopPropagation();
+				const i = chips.indexOf(tag);
+				if (i >= 0) {
+					chips.splice(i, 1);
+					renderChips();
+				}
+			});
+			chip.append(x);
+			chipWrap.append(chip);
+		}
+	};
+	const addTag = (tag) => {
+		const t = tag.trim();
+		if (t.length === 0 || chips.includes(t)) return;
+		chips.push(t);
+		input.value = "";
+		renderChips();
+		hideSuggest();
+		input.focus();
+	};
+	const commitInput = () => {
+		for (const raw of input.value.split(/\s+/)) addTag(raw);
+	};
+	let knownTags = [];
+	let tagsPromise;
+	const ensureTags = () => {
+		tagsPromise ??= fetch(TAGS_ENDPOINT, { signal: AbortSignal.timeout(5e3) }).then((r) => r.ok ? r.json() : Promise.resolve({})).then((p) => [...p.tags ?? []].sort((a, b) => a.localeCompare(b, "zh"))).catch(() => []);
+		tagsPromise.then((list) => {
+			knownTags = list;
+		});
+		return tagsPromise;
+	};
+	const showSuggest = () => {
+		const q = input.value.trim().toLowerCase();
+		const matches = knownTags.filter((t) => !chips.includes(t) && (q.length === 0 || t.toLowerCase().includes(q))).slice(0, 8);
+		suggest.replaceChildren();
+		for (const tag of matches) {
+			const item = document.createElement("div");
+			item.className = "dsh-tw-note-tagsuggest-item";
+			item.textContent = tag;
+			item.addEventListener("mousedown", (event) => {
+				event.preventDefault();
+				addTag(tag);
+			});
+			suggest.append(item);
+		}
+		suggest.hidden = matches.length === 0;
+	};
+	input.addEventListener("focus", () => {
+		ensureTags().then(showSuggest);
+	});
+	input.addEventListener("input", () => {
+		if (knownTags.length === 0) ensureTags().then(showSuggest);
+		else showSuggest();
+	});
+	input.addEventListener("keydown", (event) => {
+		if (event.key === "Enter" || event.key === ",") {
+			event.preventDefault();
+			commitInput();
+		} else if (event.key === "Backspace" && input.value.length === 0 && chips.length > 0) {
+			chips.pop();
+			renderChips();
+		} else if (event.key === "Escape") hideSuggest();
+	});
+	document.addEventListener("click", (event) => {
+		if (!wrap.contains(event.target)) hideSuggest();
+	}, true);
+	return {
+		el: wrap,
+		getTags: () => {
+			commitInput();
+			return [...chips];
+		},
+		setDefault: (tag) => {
+			if (chips.length === 0) {
+				const t = tag.trim();
+				if (t.length > 0) {
+					chips.push(t);
+					renderChips();
+				}
+			}
+		}
+	};
+}
+/** Build the whole widget DOM and wire it up (returns the appended root). */
+function buildWidget() {
 	const root = document.createElement("div");
 	root.className = "dsh-tw-note";
 	const card = document.createElement("div");
@@ -893,10 +1066,8 @@ function mountNoteWidget() {
 	const titleInput = document.createElement("input");
 	titleInput.className = "dsh-tw-note-title";
 	titleInput.placeholder = "标题（默认时间戳）";
-	const tagInput = document.createElement("input");
-	tagInput.className = "dsh-tw-note-tag";
-	tagInput.placeholder = "tag（默认 inbox）";
-	fields.append(titleInput, tagInput);
+	const tagEditor = buildTagEditor();
+	fields.append(titleInput, tagEditor.el);
 	const textarea = document.createElement("textarea");
 	textarea.className = "dsh-tw-note-text";
 	textarea.placeholder = "写点东西…（Ctrl+Enter 保存）";
@@ -931,10 +1102,9 @@ function mountNoteWidget() {
 		card.hidden = false;
 		opened = true;
 		resetTitle();
-		if (tagInput.value.length === 0) tagInput.value = defaultTag;
 		textarea.focus();
-		defaultTag = await fetchDefaultTag();
-		if (tagInput.value.length === 0) tagInput.value = defaultTag;
+		defaultTag = (await fetchUiOptions()).defaultTag;
+		tagEditor.setDefault(defaultTag);
 	};
 	const close = () => {
 		card.hidden = true;
@@ -958,7 +1128,7 @@ function mountNoteWidget() {
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({
 					title: titleInput.value.trim(),
-					tag: tagInput.value.trim(),
+					tags: tagEditor.getTags(),
 					text
 				}),
 				signal: AbortSignal.timeout(1e4)
@@ -992,7 +1162,7 @@ function mountNoteWidget() {
 	const doEdit = async () => {
 		const title = titleInput.value.trim().length > 0 ? titleInput.value.trim() : timestampTitle();
 		const text = textarea.value;
-		const tag = tagInput.value.trim();
+		const tags = tagEditor.getTags();
 		edit.disabled = true;
 		edit.textContent = "打开中…";
 		try {
@@ -1001,7 +1171,7 @@ function mountNoteWidget() {
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({
 					title,
-					tag,
+					tags,
 					text
 				}),
 				signal: AbortSignal.timeout(1e4)
@@ -1027,10 +1197,27 @@ function mountNoteWidget() {
 	edit.addEventListener("click", () => {
 		doEdit();
 	});
-	return () => {
-		root.remove();
+	return root;
+}
+/**
+* Mount the floating quick-note widget. Fetches /status first: when
+* `ui.showQuickNote` is off the widget is never created (no DOM side effects).
+* Returns a disposer that removes it.
+*/
+function mountNoteWidget() {
+	let disposed = false;
+	let root;
+	const disposer = () => {
+		disposed = true;
+		root?.remove();
 		document.querySelector(".dsh-tw-toast")?.remove();
 	};
+	(async () => {
+		const ui = await fetchUiOptions();
+		if (disposed || !ui.showQuickNote) return;
+		root = buildWidget();
+	})();
+	return disposer;
 }
 //#endregion
 //#region src/client/settings-page.ts
@@ -1148,6 +1335,7 @@ function renderConfigSection(body, config, refresh) {
 	section.append(make("h3", "dsh-tw-settings-h", "常规配置"));
 	const note = config.note ?? {};
 	const git = config.git ?? {};
+	const ui = config.ui ?? {};
 	const fields = [];
 	const textField = (key, label, initial) => {
 		const input = make("input", "dsh-tw-settings-input");
@@ -1198,6 +1386,8 @@ function renderConfigSection(body, config, refresh) {
 	numField("git.debounceMs", "自动 commit 防抖(ms)", typeof git.debounceMs === "number" ? git.debounceMs : 6e4);
 	textField("git.remote", "git 远端（空=仅本地）", typeof git.remote === "string" ? git.remote : "");
 	textField("git.branch", "git 分支", typeof git.branch === "string" ? git.branch : "main");
+	checkField("ui.showQuickNote", "显示「快速笔记」悬浮按钮", ui.showQuickNote !== false);
+	checkField("ui.sidebarLeftCss", "侧边栏移左 CSS（随启动补丁还原被删除的样式）", ui.sidebarLeftCss !== false);
 	const save = make("button", "dsh-tw-settings-btn dsh-tw-settings-primary", "保存配置");
 	save.type = "button";
 	save.addEventListener("click", () => {

package/lib/client.js

@@ -54,6 +54,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 {
@@ -169,6 +184,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;
@@ -853,14 +896,23 @@ function ensurePopup() {
 * collapsible, independent of any shell DOM. Lets the human jot drafts /
 * scratch notes while waiting for the AI or drafting the next prompt.
 *
-* Save posts to /dsh-tiddlywiki/note → an independent tiddler (title & tag
+* Save posts to /dsh-tiddlywiki/note → an independent tiddler (title & tags
 * editable; defaults: timestamp title + config tag, usually "inbox").
 *
+* ui.showQuickNote config: the widget is mounted async and stays hidden (and
+* never appended) when the option is off, so the toggle button can be disabled
+* from the settings page without touching the shell.
+*
+* Tag editor: multi-select chips + autocomplete from the wiki's existing tags
+* (GET /dsh-tiddlywiki/tags). Enter/`,` commits the typed value; Backspace on
+* an empty field removes the last chip; the dropdown filters on typing.
+*
 * @module dsh-tiddlywiki/client/note-widget
 */
 const NOTE_ENDPOINT = "/dsh-tiddlywiki/note";
 const EDIT_ENDPOINT = "/dsh-tiddlywiki/edit";
 const STATUS_ENDPOINT = "/dsh-tiddlywiki/status";
+const TAGS_ENDPOINT = "/dsh-tiddlywiki/tags";
 function pad(n) {
 	return n < 10 ? `0${n}` : String(n);
 }
@@ -868,16 +920,137 @@ function pad(n) {
 function timestampTitle(date = /* @__PURE__ */ new Date()) {
 	return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
 }
-async function fetchDefaultTag() {
+async function fetchUiOptions() {
+	const fallback = {
+		showQuickNote: true,
+		defaultTag: "inbox"
+	};
 	try {
 		const res = await fetch(STATUS_ENDPOINT, { signal: AbortSignal.timeout(5e3) });
-		if (!res.ok) return "inbox";
-		return (await res.json()).note?.tag ?? "inbox";
+		if (!res.ok) return fallback;
+		const payload = await res.json();
+		return {
+			showQuickNote: payload.ui?.showQuickNote !== false,
+			defaultTag: payload.note?.tag ?? "inbox"
+		};
 	} catch {
-		return "inbox";
+		return fallback;
 	}
 }
-function mountNoteWidget() {
+/** Multi-tag chip editor with autocomplete from the wiki's existing tags. */
+function buildTagEditor() {
+	const wrap = document.createElement("div");
+	wrap.className = "dsh-tw-note-tags";
+	const chipWrap = document.createElement("div");
+	chipWrap.className = "dsh-tw-note-chips";
+	const input = document.createElement("input");
+	input.className = "dsh-tw-note-taginput";
+	input.placeholder = "tag（可多选，自动补全）";
+	const suggest = document.createElement("div");
+	suggest.className = "dsh-tw-note-tagsuggest";
+	suggest.hidden = true;
+	wrap.append(chipWrap, input, suggest);
+	const chips = [];
+	const hideSuggest = () => {
+		suggest.hidden = true;
+	};
+	const renderChips = () => {
+		chipWrap.replaceChildren();
+		for (const tag of chips) {
+			const chip = document.createElement("span");
+			chip.className = "dsh-tw-note-tagchip";
+			chip.textContent = tag;
+			const x = document.createElement("span");
+			x.className = "dsh-tw-note-tagchip-x";
+			x.textContent = "×";
+			x.title = `移除 tag「${tag}」`;
+			x.addEventListener("click", (event) => {
+				event.stopPropagation();
+				const i = chips.indexOf(tag);
+				if (i >= 0) {
+					chips.splice(i, 1);
+					renderChips();
+				}
+			});
+			chip.append(x);
+			chipWrap.append(chip);
+		}
+	};
+	const addTag = (tag) => {
+		const t = tag.trim();
+		if (t.length === 0 || chips.includes(t)) return;
+		chips.push(t);
+		input.value = "";
+		renderChips();
+		hideSuggest();
+		input.focus();
+	};
+	const commitInput = () => {
+		for (const raw of input.value.split(/\s+/)) addTag(raw);
+	};
+	let knownTags = [];
+	let tagsPromise;
+	const ensureTags = () => {
+		tagsPromise ??= fetch(TAGS_ENDPOINT, { signal: AbortSignal.timeout(5e3) }).then((r) => r.ok ? r.json() : Promise.resolve({})).then((p) => [...p.tags ?? []].sort((a, b) => a.localeCompare(b, "zh"))).catch(() => []);
+		tagsPromise.then((list) => {
+			knownTags = list;
+		});
+		return tagsPromise;
+	};
+	const showSuggest = () => {
+		const q = input.value.trim().toLowerCase();
+		const matches = knownTags.filter((t) => !chips.includes(t) && (q.length === 0 || t.toLowerCase().includes(q))).slice(0, 8);
+		suggest.replaceChildren();
+		for (const tag of matches) {
+			const item = document.createElement("div");
+			item.className = "dsh-tw-note-tagsuggest-item";
+			item.textContent = tag;
+			item.addEventListener("mousedown", (event) => {
+				event.preventDefault();
+				addTag(tag);
+			});
+			suggest.append(item);
+		}
+		suggest.hidden = matches.length === 0;
+	};
+	input.addEventListener("focus", () => {
+		ensureTags().then(showSuggest);
+	});
+	input.addEventListener("input", () => {
+		if (knownTags.length === 0) ensureTags().then(showSuggest);
+		else showSuggest();
+	});
+	input.addEventListener("keydown", (event) => {
+		if (event.key === "Enter" || event.key === ",") {
+			event.preventDefault();
+			commitInput();
+		} else if (event.key === "Backspace" && input.value.length === 0 && chips.length > 0) {
+			chips.pop();
+			renderChips();
+		} else if (event.key === "Escape") hideSuggest();
+	});
+	document.addEventListener("click", (event) => {
+		if (!wrap.contains(event.target)) hideSuggest();
+	}, true);
+	return {
+		el: wrap,
+		getTags: () => {
+			commitInput();
+			return [...chips];
+		},
+		setDefault: (tag) => {
+			if (chips.length === 0) {
+				const t = tag.trim();
+				if (t.length > 0) {
+					chips.push(t);
+					renderChips();
+				}
+			}
+		}
+	};
+}
+/** Build the whole widget DOM and wire it up (returns the appended root). */
+function buildWidget() {
 	const root = document.createElement("div");
 	root.className = "dsh-tw-note";
 	const card = document.createElement("div");
@@ -899,10 +1072,8 @@ function mountNoteWidget() {
 	const titleInput = document.createElement("input");
 	titleInput.className = "dsh-tw-note-title";
 	titleInput.placeholder = "标题（默认时间戳）";
-	const tagInput = document.createElement("input");
-	tagInput.className = "dsh-tw-note-tag";
-	tagInput.placeholder = "tag（默认 inbox）";
-	fields.append(titleInput, tagInput);
+	const tagEditor = buildTagEditor();
+	fields.append(titleInput, tagEditor.el);
 	const textarea = document.createElement("textarea");
 	textarea.className = "dsh-tw-note-text";
 	textarea.placeholder = "写点东西…（Ctrl+Enter 保存）";
@@ -937,10 +1108,9 @@ function mountNoteWidget() {
 		card.hidden = false;
 		opened = true;
 		resetTitle();
-		if (tagInput.value.length === 0) tagInput.value = defaultTag;
 		textarea.focus();
-		defaultTag = await fetchDefaultTag();
-		if (tagInput.value.length === 0) tagInput.value = defaultTag;
+		defaultTag = (await fetchUiOptions()).defaultTag;
+		tagEditor.setDefault(defaultTag);
 	};
 	const close = () => {
 		card.hidden = true;
@@ -964,7 +1134,7 @@ function mountNoteWidget() {
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({
 					title: titleInput.value.trim(),
-					tag: tagInput.value.trim(),
+					tags: tagEditor.getTags(),
 					text
 				}),
 				signal: AbortSignal.timeout(1e4)
@@ -998,7 +1168,7 @@ function mountNoteWidget() {
 	const doEdit = async () => {
 		const title = titleInput.value.trim().length > 0 ? titleInput.value.trim() : timestampTitle();
 		const text = textarea.value;
-		const tag = tagInput.value.trim();
+		const tags = tagEditor.getTags();
 		edit.disabled = true;
 		edit.textContent = "打开中…";
 		try {
@@ -1007,7 +1177,7 @@ function mountNoteWidget() {
 				headers: { "content-type": "application/json" },
 				body: JSON.stringify({
 					title,
-					tag,
+					tags,
 					text
 				}),
 				signal: AbortSignal.timeout(1e4)
@@ -1033,10 +1203,27 @@ function mountNoteWidget() {
 	edit.addEventListener("click", () => {
 		doEdit();
 	});
-	return () => {
-		root.remove();
+	return root;
+}
+/**
+* Mount the floating quick-note widget. Fetches /status first: when
+* `ui.showQuickNote` is off the widget is never created (no DOM side effects).
+* Returns a disposer that removes it.
+*/
+function mountNoteWidget() {
+	let disposed = false;
+	let root;
+	const disposer = () => {
+		disposed = true;
+		root?.remove();
 		document.querySelector(".dsh-tw-toast")?.remove();
 	};
+	(async () => {
+		const ui = await fetchUiOptions();
+		if (disposed || !ui.showQuickNote) return;
+		root = buildWidget();
+	})();
+	return disposer;
 }
 //#endregion
 //#region src/client/settings-page.ts
@@ -1154,6 +1341,7 @@ function renderConfigSection(body, config, refresh) {
 	section.append(make("h3", "dsh-tw-settings-h", "常规配置"));
 	const note = config.note ?? {};
 	const git = config.git ?? {};
+	const ui = config.ui ?? {};
 	const fields = [];
 	const textField = (key, label, initial) => {
 		const input = make("input", "dsh-tw-settings-input");
@@ -1204,6 +1392,8 @@ function renderConfigSection(body, config, refresh) {
 	numField("git.debounceMs", "自动 commit 防抖(ms)", typeof git.debounceMs === "number" ? git.debounceMs : 6e4);
 	textField("git.remote", "git 远端（空=仅本地）", typeof git.remote === "string" ? git.remote : "");
 	textField("git.branch", "git 分支", typeof git.branch === "string" ? git.branch : "main");
+	checkField("ui.showQuickNote", "显示「快速笔记」悬浮按钮", ui.showQuickNote !== false);
+	checkField("ui.sidebarLeftCss", "侧边栏移左 CSS（随启动补丁还原被删除的样式）", ui.sidebarLeftCss !== false);
 	const save = make("button", "dsh-tw-settings-btn dsh-tw-settings-primary", "保存配置");
 	save.type = "button";
 	save.addEventListener("click", () => {