dsh-notify-yimit 0.1.3 → 0.1.4

package/lib/client.js

@@ -40,7 +40,10 @@ window.__ModuleLoader__.load({
 			'.dn-seg{display:flex;gap:2px;padding:2px;border-radius:10px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);max-width:520px}',
 			'.dn-seg-btn{flex:1;font:inherit;font-size:13px;color:var(--dsw-alias-label-secondary);border:0;border-radius:8px;padding:6px 10px;cursor:pointer;background:transparent;transition:background .15s ease,color .15s ease;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
 			'.dn-seg-btn:hover{color:var(--dsw-alias-label-primary);background:var(--dsw-alias-interactive-bg-hover)}',
-			'.dn-seg-btn[data-on="true"]{background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);box-shadow:var(--dsw-shadow-lv1)}',
+			// 选中态用主题主色 + 反色文字:浅色模式下与背景对比也足够清晰(此前浅色下
+			// 白底+深灰与容器太接近,深色正常)。
+			'.dn-seg-btn[data-on="true"]{background:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-primary-inverted);box-shadow:var(--dsw-shadow-lv1)}',
+			'.dn-seg-btn[data-on="true"]:hover{background:var(--dsw-alias-state-business-primary);color:var(--dsw-alias-label-primary-inverted)}',
 			'.dn-seg-btn:disabled{opacity:.45;cursor:not-allowed}',
 			'.dn-seg-btn:disabled:hover{background:transparent;color:var(--dsw-alias-label-secondary)}',
 			'.dn-collapse{display:grid;grid-template-rows:1fr;opacity:1;transition:grid-template-rows .24s ease,opacity .2s ease}',
@@ -49,14 +52,28 @@ window.__ModuleLoader__.load({
 			'.dn-collapse>.dn-collapse-body>.dn-block{min-width:0}',
 			'.dn-kind-list{display:flex;flex-direction:column;gap:8px}',
 			'.dn-kind-row{display:flex;align-items:center;gap:12px;padding:8px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-1)}',
-			'.dn-kind-swatch{flex:none;width:20px;height:20px;border-radius:6px;border:1px solid var(--dsw-alias-border-l2);box-shadow:inset 0 0 0 1px rgba(0,0,0,.12)}',
-			'.dn-kind-name{flex:1;font-size:13px;font-weight:600;min-width:0}',
+			// 每类型的背景/文字/开关项右对齐(预览块留在左侧)
+			'.dn-kind-row>.dn-kind-field:first-of-type{margin-left:auto}',
+			// 样式预览:纯色块内嵌类型文字,始终用配置的背景/文字色(内联样式,不受主题影响)
+			'.dn-kind-preview{flex:none;min-width:72px;text-align:center;font-size:12px;font-weight:600;line-height:22px;padding:2px 10px;border-radius:6px;white-space:nowrap;box-shadow:inset 0 0 0 1px rgba(0,0,0,.08)}',
 			'.dn-kind-field{display:flex;align-items:center;gap:6px;font-size:12px;color:var(--dsw-alias-label-tertiary);flex:none}',
 			'.dn-input{font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:5px 10px;outline:none;max-width:120px}',
 			'.dn-input:focus{border-color:var(--dsw-alias-state-business-primary)}',
 			'.dn-input[type=color]{padding:2px 4px;width:48px;height:28px;cursor:pointer;max-width:none}',
 			'.dn-input:disabled{opacity:.45;cursor:not-allowed}',
-			'.dn-select{max-width:260px;cursor:pointer}',
+			// 浏览器选择器:原生 select 的展开列表为系统绘制、无法贴合主题,改为自绘下拉,
+			// 触发器与弹层都走 --dsw-* 变量,深浅色模式下与设置页风格一致。
+			'.dn-bselect{position:relative;width:280px;max-width:100%;flex:none}',
+			'.dn-bselect-trigger{display:flex;align-items:center;justify-content:space-between;gap:8px;width:100%;font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:5px 10px;cursor:pointer;outline:none}',
+			'.dn-bselect-trigger:hover:not(:disabled){border-color:var(--dsw-alias-border-l2)}',
+			'.dn-bselect-trigger.open{border-color:var(--dsw-alias-state-business-primary)}',
+			'.dn-bselect-trigger:disabled{opacity:.45;cursor:not-allowed}',
+			'.dn-bselect-value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+			'.dn-bselect-arrow{flex:none;font-size:10px;color:var(--dsw-alias-label-tertiary)}',
+			'.dn-bselect-pop{position:absolute;top:calc(100% + 4px);left:0;right:0;z-index:100;background:var(--dsw-alias-bg-base);border:1px solid var(--dsw-alias-border-l1);border-radius:10px;box-shadow:var(--dsw-shadow-lv3);padding:4px;max-height:240px;overflow:auto}',
+			'.dn-bselect-opt{display:block;width:100%;text-align:left;font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:transparent;border:0;border-radius:7px;padding:6px 10px;cursor:pointer;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+			'.dn-bselect-opt:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+			'.dn-bselect-opt.sel{color:var(--dsw-alias-state-business-primary);font-weight:600}',
 			'.dn-color-preview{font-size:12px;color:var(--dsw-alias-label-tertiary);font-family:var(--dsw-font-mono)}',
 			'.dn-btn{font:inherit;font-size:13px;color:var(--dsw-alias-label-primary);background:var(--dsw-alias-button-elevated-fill);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 14px;cursor:pointer}',
 			'.dn-btn:hover{background:var(--dsw-alias-interactive-bg-hover)}',
@@ -120,6 +137,12 @@ window.__ModuleLoader__.load({
 			permissionDefault: '系统通知需要浏览器通知权限',
 			requestPermission: '申请通知权限',
 			triggerNote: '触发场景:任务完成、任务出错、运行中(实时内容)、等待审批、等待回答。通知标题为对话标题;点击通知或跳转按钮可打开对应会话。',
+			toastStyleTitle: '通知窗口样式',
+			toastGapLabel: '通知间距(px)',
+			enterEdit: '进入编辑模式',
+			endEdit: '完成编辑',
+			editHint: '拖动样板窗调整位置;拖拽窗口边缘调整宽度;完成后点击「完成编辑」保存。',
+			resetPosition: '恢复默认位置',
 			saveHint: '所有设置修改后自动保存。',
 			saved: '已保存',
 			saveFailed: '保存失败:{message}',
@@ -160,6 +183,12 @@ window.__ModuleLoader__.load({
 			permissionDefault: 'System notifications need browser notification permission',
 			requestPermission: 'Request permission',
 			triggerNote: 'Triggers: task completed, task failed, running (live activity), awaiting approval, awaiting answer. The title is the conversation title; clicking the notification or the jump button opens the session.',
+			toastStyleTitle: 'Toast window style',
+			toastGapLabel: 'Toast gap (px)',
+			enterEdit: 'Enter edit mode',
+			endEdit: 'Finish editing',
+			editHint: 'Drag the sample window to reposition; drag its edges to resize the width; click "Finish editing" to save.',
+			resetPosition: 'Reset to default position',
 			saveHint: 'All settings changes are auto-saved.',
 			saved: 'Saved',
 			saveFailed: 'Save failed: {message}',
@@ -283,7 +312,8 @@ window.__ModuleLoader__.load({
 					.colors) ? v.colors[key] : undefined
 				return {
 					bg: typeof entry?.bg === 'string' ? entry.bg : fallbackBg,
-					fg: typeof entry?.fg === 'string' ? entry.fg : fallbackFg
+					fg: typeof entry?.fg === 'string' ? entry.fg : fallbackFg,
+					enabled: entry?.enabled !== false
 				}
 			}
 			const topBg = typeof v.bgColor === 'string' ? v.bgColor : '#20272f'
@@ -297,6 +327,15 @@ window.__ModuleLoader__.load({
 				bgColor: topBg,
 				textColor: topFg,
 				locale: v.locale === 'zh' || v.locale === 'en' ? v.locale : 'en',
+				toast: {
+					width: typeof v.toast?.width === 'number' ? v.toast.width : 340,
+					gap: typeof v.toast?.gap === 'number' ? v.toast.gap : 12,
+					position: v.toast !== null && typeof v.toast === 'object' && v.toast.position !== null &&
+						typeof v.toast.position === 'object' && !Array.isArray(v.toast.position) &&
+						typeof v.toast.position.left === 'number' && typeof v.toast.position.top === 'number'
+						? { left: v.toast.position.left, top: v.toast.position.top }
+						: null,
+				},
 				colors: {
 					completed: kindColors('completed', topBg, topFg),
 					error: kindColors('error', topBg, topFg),
@@ -433,6 +472,34 @@ window.__ModuleLoader__.load({
 					typeSymbol: 'dsh-notify-yimit#BrowserList',
 					schema: browsersCodec
 				}
+			}, {
+				id: 'dsh-notify-yimit#notify/startEditMode',
+				service: 'notify',
+				namespace: 'notify',
+				method: 'startEditMode',
+				invocation: {
+					kind: 'direct'
+				},
+				parameters: [],
+				result: {
+					mode: 'strict',
+					typeSymbol: 'dsh-notify-yimit#AckResult',
+					schema: ackCodec
+				}
+			}, {
+				id: 'dsh-notify-yimit#notify/endEditMode',
+				service: 'notify',
+				namespace: 'notify',
+				method: 'endEditMode',
+				invocation: {
+					kind: 'direct'
+				},
+				parameters: [],
+				result: {
+					mode: 'strict',
+					typeSymbol: 'dsh-notify-yimit#AckResult',
+					schema: ackCodec
+				}
 			}]
 		}
 
@@ -585,6 +652,81 @@ window.__ModuleLoader__.load({
 				}, entry[1])))
 		}
 
+		/** 跳转浏览器选择器:原生 select 的展开列表无法贴合主题,自绘下拉(触发器 + 弹层)。 */
+		function BrowserSelect(props) {
+			const {
+				value,
+				options,
+				disabled,
+				onChange,
+				t
+			} = props
+			const [open, setOpen] = useState(false)
+			const wrapRef = useRef(null)
+			// 点击外部 / Esc 关闭弹层。
+			useEffect(() => {
+				if (!open) return
+				const onDown = (e) => {
+					if (wrapRef.current !== null && !wrapRef.current.contains(e.target)) setOpen(false)
+				}
+				const onKey = (e) => {
+					if (e.key === 'Escape') setOpen(false)
+				}
+				document.addEventListener('mousedown', onDown)
+				document.addEventListener('keydown', onKey)
+				return () => {
+					document.removeEventListener('mousedown', onDown)
+					document.removeEventListener('keydown', onKey)
+				}
+			}, [open])
+
+			const current = options.find((b) => b.path === value)
+			const pick = (path) => {
+				onChange(path)
+				setOpen(false)
+			}
+			return el('div', {
+					className: 'dn-bselect',
+					ref: wrapRef
+				},
+				el('button', {
+					type: 'button',
+					className: 'dn-bselect-trigger' + (open ? ' open' : ''),
+					disabled: disabled === true,
+					'aria-haspopup': 'listbox',
+					'aria-expanded': String(open),
+					onClick: () => {
+						if (disabled !== true) setOpen(!open)
+					},
+				},
+					el('span', {
+						className: 'dn-bselect-value'
+					}, current !== undefined ? current.name : t('browserDefault')),
+					el('span', {
+						className: 'dn-bselect-arrow'
+					}, open ? '▴' : '▾')),
+				open ? el('div', {
+						className: 'dn-bselect-pop',
+						role: 'listbox'
+					},
+					el('button', {
+						type: 'button',
+						role: 'option',
+						'aria-selected': String(value === ''),
+						className: 'dn-bselect-opt' + (value === '' ? ' sel' : ''),
+						onClick: () => pick(''),
+					}, t('browserDefault')),
+					options.map((b) => el('button', {
+						type: 'button',
+						role: 'option',
+						key: b.id,
+						'aria-selected': String(value === b.path),
+						className: 'dn-bselect-opt' + (value === b.path ? ' sel' : ''),
+						onClick: () => pick(b.path),
+					}, b.name)))
+				: null)
+		}
+
 		const KIND_ORDER = ['completed', 'error', 'running', 'approval', 'question']
 
 		function NotifySection(props) {
@@ -599,6 +741,15 @@ window.__ModuleLoader__.load({
 			const [saving, setSaving] = useState(false)
 			const [permission, setPermission] = useState(typeof Notification !== 'undefined' ? Notification
 				.permission : 'unsupported')
+			// 通知窗口编辑模式(样板窗拖拽/缩放)
+			const [editing, setEditing] = useState(false)
+			// 最新值镜像:卸载清理时读取(避免空依赖闭包拿到陈旧值)。
+			const editingRef = useRef(false)
+			editingRef.current = editing
+			useEffect(() => () => {
+				// 离开通知设置页(组件卸载)时若仍在编辑模式,自动关闭样板窗。
+				if (editingRef.current) void api.endEditMode()
+			}, [])
 
 			const saveTimerRef = useRef(null)
 			const save = useCallback((patch) => {
@@ -653,18 +804,18 @@ window.__ModuleLoader__.load({
 				const entry = config.colors?. [kind] ?? {}
 				const bg = entry.bg || config.bgColor || '#20272f'
 				const fg = entry.fg || config.textColor || '#e6edf3'
+				const enabled = entry.enabled !== false
 				return el('div', {
 						key: kind,
 						className: 'dn-kind-row'
 					},
+					// 样式预览:类型文字显示在配置色的纯色块内(内联样式,不受深色模式影响)
 					el('span', {
-						className: 'dn-kind-swatch',
+						className: 'dn-kind-preview',
 						style: {
-							background: bg
+							background: bg,
+							color: fg
 						}
-					}),
-					el('span', {
-						className: 'dn-kind-name'
 					}, kindLabel(kind, t)),
 					el('label', {
 							className: 'dn-kind-field'
@@ -701,7 +852,28 @@ window.__ModuleLoader__.load({
 									}
 								}
 							})
-						}), t('colorFg')))
+						}), t('colorFg')),
+					// 每类型开关:控制该类型通知是否产生(默认全开)
+					el('label', {
+							className: 'dn-kind-field'
+						},
+						el('button', {
+							type: 'button',
+							role: 'switch',
+							'aria-checked': enabled,
+							'aria-label': kindLabel(kind, t),
+							className: 'dn-switch',
+							'data-on': String(enabled),
+							disabled: controlsDisabled,
+							onClick: () => save({
+								colors: {
+									[kind]: {
+										...entry,
+										enabled: !enabled
+									}
+								}
+							})
+						})))
 			})
 
 			const customOpen = config.mode === 'custom'
@@ -764,21 +936,15 @@ window.__ModuleLoader__.load({
 						el('span', {
 							className: 'dn-label'
 						}, t('browserLabel')),
-						el('select', {
-								className: 'dn-input dn-select',
-								value: config.browser || '',
-								disabled: controlsDisabled,
-								onChange: (e) => save({
-									browser: e.target.value
-								})
-							},
-							el('option', {
-								value: ''
-							}, t('browserDefault')),
-							(state?.browsers ?? []).map((b) => el('option', {
-								key: b.id,
-								value: b.path
-							}, b.name)))),
+						el(BrowserSelect, {
+							value: config.browser || '',
+							options: state?.browsers ?? [],
+							disabled: controlsDisabled,
+							onChange: (path) => save({
+								browser: path
+							}),
+							t
+						})),
 					el('p', {
 						className: 'dn-note'
 					}, t('browserNote'))
@@ -868,7 +1034,70 @@ window.__ModuleLoader__.load({
 							}, t('colorsTitle')),
 							el('div', {
 								className: 'dn-kind-list'
-							}, kindRows))
+							}, kindRows),
+							el('div', {
+								className: 'dn-divider'
+							}),
+							el('p', {
+								className: 'dn-title'
+							}, t('toastStyleTitle')),
+							el('div', {
+									className: 'dn-row'
+								},
+								el('span', {
+									className: 'dn-label'
+								}, t('toastGapLabel')),
+								el('input', {
+									type: 'number',
+									min: 0,
+									max: 60,
+									className: 'dn-input',
+									value: config.toast?.gap ?? 12,
+									disabled: controlsDisabled,
+									onChange: (e) => {
+										const g = Math.max(0, Math.min(60, Math.floor(Number(e
+											.target.value) || 0)))
+										save({
+											toast: {
+												...(config.toast ?? {}),
+												gap: g
+											}
+										})
+									}
+								})),
+							el('div', {
+									className: 'dn-row'
+								},
+								el('button', {
+									className: 'dn-btn primary',
+									disabled: controlsDisabled,
+									onClick: () => {
+										if (editing) {
+											void api.endEditMode()
+											setEditing(false)
+										} else {
+											setEditing(true)
+											void api.startEditMode()
+										}
+									}
+								}, editing ? t('endEdit') : t('enterEdit')),
+								el('button', {
+									className: 'dn-btn',
+									disabled: controlsDisabled || !config.toast?.position,
+									onClick: () => {
+										save({
+											toast: {
+												...(config.toast ?? {}),
+												position: null
+											}
+										})
+										// 编辑模式下:重开样板窗,让其在默认位置(右下)刷新显示。
+										if (editing) void api.startEditMode()
+									}
+								}, t('resetPosition'))),
+							el('p', {
+								className: 'dn-note'
+							}, t('editHint')))
 					)),
 				el('div', {
 					className: 'dn-divider'
@@ -965,6 +1194,18 @@ window.__ModuleLoader__.load({
 					} catch {
 						/* 静默 */ }
 				},
+				startEditMode: async () => {
+					try {
+						await notify.startEditMode()
+					} catch {
+						/* 静默 */ }
+				},
+				endEditMode: async () => {
+					try {
+						await notify.endEditMode()
+					} catch {
+						/* 静默 */ }
+				},
 			}
 
 			// ===== 现在设置 __localeService 并使用 api =====
@@ -1125,4 +1366,4 @@ window.__ModuleLoader__.load({
 		exports.inject = inject
 		return module.exports
 	},
-})
+})

package/lib/index.js

@@ -30,26 +30,38 @@ const DEFAULT_CONFIG = Object.freeze({
 	bgColor: '#20272f',
 	textColor: '#e6edf3',
 	locale: 'en',
+	// 通知窗口样式:width 窗口宽度(编辑模式拖拽边缘调整);gap 通知间距(px);
+	// position = null 表示默认右下贴边,{left,top} 为任意屏幕位置(工作区相对坐标)。
+	toast: {
+		width: 340,
+		gap: 12,
+		position: null,
+	},
 	colors: {
 		completed: {
 			bg: '#1f5138',
-			fg: '#e6f4ec'
+			fg: '#e6f4ec',
+			enabled: true
 		},
 		error: {
 			bg: '#5c1f24',
-			fg: '#fbe9ea'
+			fg: '#fbe9ea',
+			enabled: true
 		},
 		running: {
 			bg: '#203a5c',
-			fg: '#e8f0fb'
+			fg: '#e8f0fb',
+			enabled: true
 		},
 		approval: {
 			bg: '#4a3a12',
-			fg: '#f7efd8'
+			fg: '#f7efd8',
+			enabled: true
 		},
 		question: {
 			bg: '#3d2a55',
-			fg: '#f0e8fa'
+			fg: '#f0e8fa',
+			enabled: true
 		},
 	},
 })
@@ -99,6 +111,12 @@ const TOAST_LABELS = {
 /** 标题未生成时的占位文本(中/英):session/title 到达后原地替换。 */
 const UNTITLED_NAMES = new Set([TOAST_LABELS.zh.unnamed, TOAST_LABELS.en.unnamed])
 
+/** 编辑模式样板窗标题(中/英)。 */
+const EDIT_TITLES = {
+	zh: '通知样式预览',
+	en: 'Notification preview'
+}
+
 const HEX_RE = /^#[0-9a-fA-F]{3,8}$/
 const isHex = (v) => typeof v === 'string' && HEX_RE.test(v)
 
@@ -118,6 +136,22 @@ function normalizeConfig(input) {
 	if (isHex(src.textColor)) out.textColor = src.textColor
 	if (src.locale === 'zh' || src.locale === 'en') out.locale = src.locale
 
+	// 通知窗口样式:width 260–520;gap 0–60;position 缺省 null(默认右下贴边),合法 {left,top} 才采纳。
+	out.toast = { width: 340, gap: 12, position: null }
+	const srcToast = src.toast !== null && typeof src.toast === 'object' && !Array.isArray(src.toast) ? src.toast : {}
+	if (typeof srcToast.width === 'number' && Number.isFinite(srcToast.width)) {
+		out.toast.width = Math.max(260, Math.min(520, Math.round(srcToast.width)))
+	}
+	if (typeof srcToast.gap === 'number' && Number.isFinite(srcToast.gap)) {
+		out.toast.gap = Math.max(0, Math.min(60, Math.round(srcToast.gap)))
+	}
+	const pos = srcToast.position
+	if (pos !== null && typeof pos === 'object' && !Array.isArray(pos) &&
+		typeof pos.left === 'number' && Number.isFinite(pos.left) &&
+		typeof pos.top === 'number' && Number.isFinite(pos.top)) {
+		out.toast.position = { left: Math.round(pos.left), top: Math.round(pos.top) }
+	}
+
 	const srcColors = src.colors !== null && typeof src.colors === 'object' && !Array.isArray(src.colors) ? src.colors :
 	{}
 	out.colors = {}
@@ -127,6 +161,7 @@ function normalizeConfig(input) {
 		out.colors[kind] = {
 			bg: isHex(entry?.bg) ? entry.bg : def.bg,
 			fg: isHex(entry?.fg) ? entry.fg : def.fg,
+			enabled: entry?.enabled !== false,
 		}
 	}
 	return out
@@ -139,7 +174,8 @@ function migrateLegacyColors(input) {
 	const colors = {}
 	for (const kind of KIND_KEYS) colors[kind] = {
 		bg: input.bgColor,
-		fg: input.textColor
+		fg: input.textColor,
+		enabled: true
 	}
 	return {
 		...input,
@@ -162,6 +198,13 @@ function mergeConfigPatch(base, patch) {
 		}
 		out.colors = next
 	}
+	if (patch !== null && typeof patch === 'object' && patch.toast !== null && typeof patch.toast === 'object' && !
+		Array.isArray(patch.toast)) {
+		out.toast = {
+			...(base.toast !== null && typeof base.toast === 'object' && !Array.isArray(base.toast) ? base.toast : {}),
+			...patch.toast
+		}
+	}
 	return out
 }
 
@@ -223,6 +266,7 @@ function openConfig() {
 const MAX_QUEUE = 500
 const RUNNING_THROTTLE_MS = 400
 const KIND_DEBOUNCE_MS = 2000
+/** 通知间距默认值(px);实际使用 config.toast.gap(0–60,可调)。 */
 const TOAST_GAP = 12
 const TEXT_MAX = 300
 
@@ -445,6 +489,21 @@ export function apply(ctx) {
 						if (idx !== -1) toastOrder.splice(idx, 1)
 						reflowToasts()
 					}
+				} else if (msg.type === 'geometry' && typeof msg.left === 'number' && typeof msg.top === 'number') {
+					// 编辑模式:样板窗拖拽/缩放结束 → 写回配置,并应用到在屏浮窗。
+					const width = Math.max(260, Math.min(520, Math.round(Number(msg.width) || 340)))
+					const left = Math.round(Number(msg.left))
+					const top = Math.round(Number(msg.top))
+					store.set({
+						toast: {
+							width,
+							position: { left, top }
+						}
+					})
+					for (const rec of activeToasts.values()) {
+						sendCmd({ cmd: 'size', key: rec.key, width })
+					}
+					reflowToasts()
 				}
 			}
 		})
@@ -507,22 +566,53 @@ export function apply(ctx) {
 	}
 
 	function reflowToasts() {
+		const cfg = store.get()
+		const pos = cfg.toast?.position ?? null
+		const gap = typeof cfg.toast?.gap === 'number' ? cfg.toast.gap : TOAST_GAP
+		if (pos !== null) {
+			// 自定义位置:position.top 是"第一个(最新,最底部)浮窗的顶边",向上堆叠。
+			// 与宿主 Loaded 的 targetTop = pos.top - offsetY 语义一致,否则重排会把
+			// 浮窗再上移一个自身高度(先正确、随即上移的 bug)。横向同步 position.left,
+			// 编辑调整位置后,在屏浮窗立即左右移动到位。
+			let prevTop = pos.top
+			let first = true
+			for (let i = 0; i < toastOrder.length; i += 1) {
+				const rec = activeToasts.get(toastOrder[i])
+				if (rec === undefined) continue
+				const height = rec.meta?.height ?? 130
+				const newTop = first ? prevTop : Math.round(prevTop - gap - height)
+				first = false
+				const needsTop = rec.meta !== null && newTop !== rec.meta.top
+				const needsLeft = rec.meta !== null && rec.meta.left !== pos.left
+				if (needsTop || needsLeft) {
+					const move = { cmd: 'move', key: rec.key, top: newTop }
+					if (needsTop) rec.meta.top = newTop
+					if (needsLeft) { move.left = pos.left; rec.meta.left = pos.left }
+					sendCmd(move)
+				}
+				prevTop = newTop
+			}
+			return
+		}
+		// 默认右下:底边对齐(工作区底边 - 20),向上堆叠;横向回默认贴边(left 'default'),
+		// 覆盖"恢复默认位置/改宽度后需回到右下角"的场景。
 		if (globalWorkBottom === null) return
-		let anchor = globalWorkBottom - 20
+		let cursor = globalWorkBottom - 20
 		for (let i = 0; i < toastOrder.length; i += 1) {
 			const rec = activeToasts.get(toastOrder[i])
 			if (rec === undefined) continue
 			const height = rec.meta?.height ?? 130
-			const newTop = Math.round(anchor - height)
+			const newTop = Math.round(cursor - height)
 			if (rec.meta !== null && newTop !== rec.meta.top) {
 				rec.meta.top = newTop
 				sendCmd({
 					cmd: 'move',
 					key: rec.key,
-					top: newTop
+					top: newTop,
+					left: 'default'
 				})
 			}
-			anchor = newTop - TOAST_GAP
+			cursor = newTop - gap
 		}
 	}
 
@@ -582,10 +672,11 @@ export function apply(ctx) {
 			toastOrder.splice(replaceIndex, 0, key)
 		}
 		const insertIndex = replaceIndex !== -1 ? replaceIndex : 0
+		const gap = typeof cfg.toast?.gap === 'number' ? cfg.toast.gap : TOAST_GAP
 		let offsetY = 0
 		for (let i = 0; i < insertIndex; i += 1) {
 			const r = activeToasts.get(toastOrder[i])
-			offsetY += (r?.meta?.height ?? 130) + TOAST_GAP
+			offsetY += (r?.meta?.height ?? 130) + gap
 		}
 
 		const lang = cfg.locale === 'zh' ? 'zh' : 'en'
@@ -608,6 +699,9 @@ export function apply(ctx) {
 			ignoreLabel: l.ignore,
 			jumpLabel: l.jump,
 			unnamedLabel: l.unnamed,
+			// 通知窗口样式:宽度 + 自定义位置(null = 默认右下贴边)
+			width: cfg.toast?.width ?? 340,
+			position: cfg.toast?.position ?? null,
 		}
 		if (typeof cfg.browser === 'string' && cfg.browser.length > 0) payload.browserPath = cfg.browser
 
@@ -673,6 +767,8 @@ export function apply(ctx) {
 		if (st === undefined) return
 		const at = Date.now()
 		const cfg = store.get()
+		// 每类型开关:该类型被关闭时完全不产生通知(桌面浮窗与系统通知都不发)。
+		if (cfg.colors?.[kind]?.enabled === false) return
 		const desktop = cfg.enabled === true && cfg.mode === 'custom'
 		const lang = cfg.locale === 'zh' ? 'zh' : 'en'
 		const l = TOAST_LABELS[lang]
@@ -933,7 +1029,19 @@ export function apply(ctx) {
 			}
 		},
 		updateConfig(patch) {
-			return store.set(patch)
+			const prev = store.get()
+			const next = store.set(patch)
+			// toast 几何(位置/宽度/间距)变更:立即应用到在屏浮窗,无需等待下一个浮窗。
+			const pToast = patch !== null && typeof patch === 'object' && !Array.isArray(patch) ? patch.toast : undefined
+			if (pToast !== null && typeof pToast === 'object' && !Array.isArray(pToast)) {
+				if (typeof pToast.width === 'number' && pToast.width !== prev.toast?.width) {
+					for (const rec of activeToasts.values()) {
+						sendCmd({ cmd: 'size', key: rec.key, width: next.toast.width })
+					}
+				}
+				reflowToasts()
+			}
+			return next
 		},
 		ackEvents(ids) {
 			if (Array.isArray(ids)) {
@@ -955,6 +1063,23 @@ export function apply(ctx) {
 				browsers: detectBrowsers()
 			}
 		},
+		/** 进入通知窗口编辑模式:宿主弹样板窗(可拖拽/缩放),几何回传后写回配置。 */
+		startEditMode() {
+			const cfg = store.get()
+			const lang = cfg.locale === 'zh' ? 'zh' : 'en'
+			sendCmd({
+				cmd: 'edit',
+				title: EDIT_TITLES[lang],
+				width: cfg.toast?.width ?? 340,
+				position: cfg.toast?.position ?? null,
+			})
+			return { ok: true }
+		},
+		/** 退出编辑模式:样板窗淡出消失。 */
+		endEditMode() {
+			sendCmd({ cmd: 'edit-end' })
+			return { ok: true }
+		},
 	}
 
 	Object.defineProperty(service, 'typertRemote', {