dsh-dock 0.4.1 → 0.6.0

package/src/client.jsx

@@ -23,19 +23,16 @@ import { feature as fModelconfig } from "../features/modelconfig/view.js";
 import { feature as fHeartbeat } from "../features/heartbeat/view.js";
 import { feature as fTheme } from "../features/theme/view.js";
 import { feature as fBalance } from "../features/balance/view.js";
+import { feature as fAnimation } from "../features/animation/view.jsx";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.4.0";
+const DOCK_VERSION = "0.5.0";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
-const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance];
+const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation];
 // 规划占位（路线图）：接入后移除并建 features/<id>/ 模块
-const PLANNED_FEATURES = [
-	{ id: "animation", name: "任务动画", order: 130, accent: "#f472b6", planned: true, description: "接入路线图 0.5.0：任务进度动画与通知" },
-];
-const PLANNED_NOTES = {
-	animation: "待接入（路线图 0.5.0）：任务进度动画与完成通知。",
-};
+const PLANNED_FEATURES = [];
+const PLANNED_NOTES = {};
 
 // ---- 外部功能注册表（dockBridge 回装通道） ----
 const externalDefs = [];
@@ -45,7 +42,7 @@ function notifyExternal() {
 }
 /**
  * 外部功能桥：独立功能包经 require("dsh-dock").dockBridge 注册视图。
- * def: { id, name, order?, accent?, description?, css?, View, HomeStat?, package? }
+ * def: { id, name, order?, accent?, description?, css?, View, HomeStat?, Overlay?, package? }
  * 返回注销函数。重复 id 视为更新（HMR/重注册场景）。
  */
 const dockBridge = {
@@ -64,6 +61,7 @@ const dockBridge = {
 			css: typeof def.css === "string" ? def.css : "",
 			View: def.View,
 			HomeStat: typeof def.HomeStat === "function" ? def.HomeStat : null,
+			Overlay: typeof def.Overlay === "function" ? def.Overlay : null,
 			external: true,
 			package: typeof def.package === "string" ? def.package : "",
 		};
@@ -109,9 +107,13 @@ const SHELL_CSS = [
 	".dock-badge{flex:none;border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);border-radius:999px;padding:3px 10px;font-size:12px;}",
 	".dock-body{border-top:1px solid var(--dsw-alias-border-l1);padding-top:8px;color:var(--dsw-alias-label-secondary);display:flex;flex-direction:column;gap:4px;}",
 	// 侧栏入口按钮（docke2- 前缀）+ 功能坞弹出面板（dockm- 前缀，仿 dsh 设置的居中模态：遮罩 + 对话框，左导航 + 右内容）
-	".docke2-btn{box-sizing:border-box;cursor:pointer;display:inline-flex;align-items:center;gap:6px;border:none;background:transparent;color:var(--dsw-alias-label-secondary);border-radius:10px;height:32px;font-family:inherit;font-size:13px;line-height:32px;transition:background .15s var(--ds-ease-in-out),color .15s var(--ds-ease-in-out);}",
-	".docke2-btn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}",
+	// 侧栏入口按钮（docke2- 前缀）：与 dsh 设置按钮（.VOzbGW_trigger）几何逐条对齐——
+	// 宽栏同为整宽左对齐行按钮（高 42、margin 4/-2、padding 0 10px 0 8px、圆角 12），窄栏同为 36 圆钮居中，
+	// 使两按钮上下成列、左右边缘完全对齐（此前右对齐/叠放都会错位）。
+	".docke2-btn{box-sizing:border-box;cursor:pointer;display:flex;align-items:center;gap:8px;border:none;background:transparent;color:var(--dsw-alias-label-primary);border-radius:12px;width:calc(100% + 4px);height:42px;margin:4px -2px;padding:0 10px 0 8px;font-family:inherit;font-size:14px;line-height:22px;transition:background .15s var(--ds-ease-in-out),color .15s var(--ds-ease-in-out);}",
+	".docke2-btn:hover{background:var(--dsw-alias-interactive-bg-hover);}",
 	".docke2-btn.docke2-on{color:var(--dsw-alias-accent,#4d9fff);background:var(--dsw-alias-accent-soft,color-mix(in srgb,var(--dsw-alias-accent,#4d9fff) 12%,transparent));}",
+	".docke2-btn.docke2-rail{width:36px;height:36px;margin:8px 0 10px;padding:0;border-radius:50%;justify-content:center;gap:0;}",
 	".docke2-label{white-space:nowrap;overflow:hidden;}",
 	".dockm-backdrop{position:fixed;inset:0;z-index:80;display:flex;align-items:center;justify-content:center;background:color-mix(in srgb,var(--dsw-alias-bg-layer-1) 55%,transparent);backdrop-filter:blur(4px);pointer-events:auto;animation:dockm-fade .15s var(--ds-ease-in-out);}",
 	"@keyframes dockm-fade{from{opacity:0}to{opacity:1}}",
@@ -155,16 +157,36 @@ const SHELL_CSS = [
 	".dockh-card:hover,.dockh-card:focus-visible{border-color:var(--dsw-alias-accent,#4d9fff);outline:none;}",
 	".dockh-head{display:flex;align-items:center;gap:8px;}",
 	".dockh-name{font-weight:600;flex:none;}",
-	".dockh-badge{margin-left:auto;flex:none;font-size:11px;border-radius:999px;padding:0 8px;color:var(--dsw-alias-label-tertiary);border:1px solid var(--dsw-alias-border-l2);}",
-	".dockh-badge.on{color:var(--dsw-alias-state-success-primary);border-color:currentColor;}",
-	".dockh-badge.off{border-style:dashed;}",
+	".dockh-badge{flex:none;font-size:11px;border-radius:999px;padding:0 8px;color:var(--dsw-alias-label-tertiary);border:1px solid var(--dsw-alias-border-l2);}",
+	// 状态标识（非交互：圆点+文字，与可点的开关一眼区分）
+	".dockh-status{margin-left:auto;flex:none;display:inline-flex;align-items:center;gap:5px;font-size:11px;color:var(--dsw-alias-label-tertiary);white-space:nowrap;}",
+	".dockh-sdot{width:7px;height:7px;border-radius:50%;flex:none;background:var(--dsw-alias-state-success-primary,#34d399);box-shadow:0 0 4px color-mix(in srgb,var(--dsw-alias-state-success-primary,#34d399) 55%,transparent);}",
+	".dockh-status.off .dockh-sdot{background:transparent;border:1.5px solid var(--dsw-alias-label-tertiary);box-shadow:none;opacity:.75;}",
+	".dockh-status.plan .dockh-sdot{background:transparent;border:1.5px dashed var(--dsw-alias-label-tertiary);box-shadow:none;}",
+	// iOS 风滑动开关（首页卡片 / 弹层页脚 / 设置页共用的启停控件）
+	".dock-sw{flex:none;position:relative;width:34px;height:19px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);cursor:pointer;padding:0;transition:background .18s var(--ds-ease-in-out),border-color .18s var(--ds-ease-in-out);}",
+	".dock-sw::after{content:\"\";position:absolute;top:2px;left:2px;width:13px;height:13px;border-radius:50%;background:#fff;box-shadow:0 1px 2px rgb(0 0 0 / .35);transition:transform .18s var(--ds-ease-in-out);}",
+	".dock-sw:hover{border-color:var(--dsw-alias-accent,#4d9fff);}",
+	".dock-sw.on{background:var(--dsw-alias-state-success-primary,#34d399);border-color:transparent;}",
+	".dock-sw.on::after{transform:translateX(15px);}",
+	// 弹层页脚：文字标签 + 开关 成组
+	".dockm-foot-sw{margin-left:auto;flex:none;display:inline-flex;align-items:center;gap:8px;}",
+	".dockm-foot-swlabel{font-size:11px;color:var(--dsw-alias-label-tertiary);}",
+	".dockm-foot-swlabel.on{color:var(--dsw-alias-state-success-primary);}",
 	".dockh-desc{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.5;}",
 	".dockh-stat{color:var(--dsw-alias-label-tertiary);font-size:12px;border-top:1px solid var(--dsw-alias-border-l1);padding-top:6px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}",
 	".dockh-foot{display:flex;align-items:center;gap:8px;}",
 	".dockh-go{color:var(--dsw-alias-label-tertiary);font-size:11px;}",
 	// 会话输入区工具行 chips（dockchip- 前缀）：余额/用量随身小控件，挂在模型选择器左侧
-	".dockchip-row{display:inline-flex;align-items:center;gap:4px;min-width:0;}",
-	".dockchip{display:inline-flex;align-items:center;gap:5px;cursor:pointer;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);border-radius:8px;padding:2px 8px;font-family:inherit;font-size:11px;line-height:18px;white-space:nowrap;transition:background .15s var(--ds-ease-in-out),color .15s var(--ds-ease-in-out);}",
+	// 溢出兼容（两层防护，缺一不可）：
+	//  1) 宽度上限：宿主 .row 是 flex-wrap:wrap 且换行优先于收缩，chips 一长 tools 整行变宽，
+	//     右侧模型选择器/发送键被挤到第二行（左右错位）。宿主 .row 带 container-type:inline-size，
+	//     用容器单位 cqw 让上限随输入卡宽度自适应（窄卡少占、宽卡多占）；不支持 cqw 的老内核退回固定 280px。
+	//  2) 截断：超限部分用省略号截断（完整数值在 title 悬浮提示里），防 chips 凸出输入卡圆角（悬空）。
+	".dockchip-row{display:inline-flex;align-items:center;gap:4px;min-width:0;flex:0 1 auto;overflow:hidden;max-width:280px;}",
+	"@supports (width:1cqw){.dockchip-row{max-width:min(280px,36cqw);}}",
+	".dockchip{display:inline-flex;align-items:center;gap:5px;cursor:pointer;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);border-radius:8px;padding:2px 8px;font-family:inherit;font-size:11px;line-height:18px;white-space:nowrap;min-width:0;overflow:hidden;transition:background .15s var(--ds-ease-in-out),color .15s var(--ds-ease-in-out);}",
+	".dockchip > span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;}",
 	".dockchip:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}",
 	".dockchip .dockchip-dot{width:6px;height:6px;border-radius:50%;flex:none;}",
 	".dockchip.err{color:var(--dsw-alias-state-error-primary);}"
@@ -210,8 +232,9 @@ function useExternalVersion() {
 // ---- 弹层窗口几何记忆（页面生命周期内）：拖动/缩放后记住位置与尺寸，重开还原 ----
 let lastGeom = { x: null, y: null, w: null, h: null };
 
-function DockIcon() {
-	return react.createElement("svg", { width: 16, height: 16, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.3, "aria-hidden": true },
+function DockIcon(props) {
+	const size = (props && props.size) || 16;
+	return react.createElement("svg", { width: size, height: size, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: 1.3, "aria-hidden": true },
 		react.createElement("rect", { x: 2.5, y: 2.5, width: 4.4, height: 4.4, rx: 1.2 }),
 		react.createElement("rect", { x: 9, y: 2.5, width: 4.4, height: 4.4, rx: 1.2 }),
 		react.createElement("rect", { x: 2.5, y: 9, width: 4.4, height: 4.4, rx: 1.2 }),
@@ -224,18 +247,12 @@ function DockEntry(props) {
 	react.useEffect(() => subscribePanel(() => setOpen(panelNav.open)), []);
 	return react.createElement("button", {
 		type: "button",
-		className: "docke2-btn" + (open ? " docke2-on" : ""),
-		style: wide
-			// 与设置按钮精确同框：设置 trigger 宽栏 = 42px 高、margin-top 4 → 下移 46px、高度同为 42，
-			// 使本按钮的四条边与设置按钮完全重合（同一水平线）；rail = 36px、margin-top 8 → 下移 44px、高 36 亦然。
-			// zIndex 保证盖在满宽设置按钮之上（其右侧为空白区，不遮齿轮图标）
-			? { marginLeft: "auto", transform: "translateY(46px)", zIndex: 1, height: 42, lineHeight: "42px", padding: "0 12px" }
-			: { transform: "translateY(44px)", zIndex: 1, width: 36, height: 36, justifyContent: "center", padding: 0 },
+		className: "docke2-btn" + (open ? " docke2-on" : "") + (wide ? "" : " docke2-rail"),
 		title: "功能坞",
 		"aria-label": "功能坞",
 		"aria-expanded": open,
 		onClick: () => setPanelOpen(!open)
-	}, react.createElement(DockIcon, null), wide ? react.createElement("span", { className: "docke2-label" }, "功能坞") : null);
+	}, react.createElement(DockIcon, { size: wide ? 16 : 18 }), wide ? react.createElement("span", { className: "docke2-label" }, "功能坞") : null);
 }
 
 // ---- 功能坞弹出面板：shell.overlay（仿 dsh 设置：居中模态 = 遮罩 + 对话框） ----
@@ -379,34 +396,46 @@ function DockModal() {
 							? react.createElement("div", { className: "dockm-note" }, PLANNED_NOTES[mod.id] || "待接入：见 README 路线图")
 							: st && st.enabled && viewNode
 								? viewNode
-								: st && st.error
-									? react.createElement("div", { className: "dockm-note dockm-err" }, "功能出错：" + st.error)
-									: react.createElement("div", { className: "dockm-note" }, "该功能当前为停用状态（记忆态随页面生命周期，0.5.0 起持久化）"),
+						: st && st.error
+							? react.createElement("div", { className: "dockm-note dockm-err" }, "功能出错：" + st.error)
+							: react.createElement("div", { className: "dockm-note" }, "该功能当前为停用状态（开关已持久化，重启后保持）"),
 					react.createElement("div", { className: "dockm-foot" },
 						react.createElement("span", null, isHome
 							? "功能坞 v" + DOCK_VERSION + " · 共 " + MODULES.length + " 个功能模块，" + enabledCount + " 个已启用"
 							: "功能坞 v" + DOCK_VERSION + " · 新功能按路线图追加"),
-					!isHome && mod && !mod.planned && st
-						? react.createElement("button", {
-							type: "button",
-							className: "dockm-switch" + (st.enabled ? " on" : ""),
-							onClick: () => { toggleFeature(mod.id); force(); }
-						}, st.enabled ? "已启用（点击停用）" : "已停用（点击启用）")
-						: null,
-					!isHome && mod && typeof mod.Chip === "function"
-						? react.createElement("button", {
-							type: "button",
-							className: "dockm-switch" + (chipShown(mod.id) ? " on" : ""),
-							title: "控制会话输入区（模型选择器左侧）是否显示本功能的随身小控件",
-							onClick: () => { setChipShown(mod.id, !chipShown(mod.id)); force(); }
-						}, chipShown(mod.id) ? "会话页显示中" : "会话页已隐藏")
-						: null))),
+						!isHome && mod && !mod.planned && st
+							? react.createElement("span", { className: "dockm-foot-sw" },
+								react.createElement("span", { className: "dockm-foot-swlabel" + (st.enabled ? " on" : "") }, st.enabled ? "已启用" : "已停用"),
+								react.createElement("button", {
+									type: "button",
+									className: "dock-sw" + (st.enabled ? " on" : ""),
+									role: "switch",
+									"aria-checked": !!st.enabled,
+									"aria-label": (st.enabled ? "停用" : "启用") + mod.name,
+									title: st.enabled ? "停用「" + mod.name + "」" : "启用「" + mod.name + "」",
+									onClick: () => { toggleFeature(mod.id); force(); }
+								}))
+							: null,
+						!isHome && mod && typeof mod.Chip === "function"
+							? react.createElement("span", { className: "dockm-foot-sw" },
+								react.createElement("span", { className: "dockm-foot-swlabel" + (chipShown(mod.id) ? " on" : "") }, "会话页小控件"),
+								react.createElement("button", {
+									type: "button",
+									className: "dock-sw" + (chipShown(mod.id) ? " on" : ""),
+									role: "switch",
+									"aria-checked": chipShown(mod.id),
+									"aria-label": (chipShown(mod.id) ? "隐藏" : "显示") + mod.name + "的会话页小控件",
+									title: "控制会话输入区（模型选择器左侧）是否显示本功能的随身小控件",
+									onClick: () => { setChipShown(mod.id, !chipShown(mod.id)); force(); }
+								}))
+							: null))),
 			win.mode === "normal"
 				? react.createElement("div", { className: "dockm-resize", onPointerDown: (e) => beginDrag(e, "size") })
 				: null));
 }
 
-// ---- 首页总揽：每个功能模块一张卡片（状态徽章 + 运行概要 + 快捷开关），点击进入对应功能 ----
+// ---- 首页总揽：每个功能模块一张卡片（状态标识 + 运行概要 + 启停开关），点卡片进对应功能 ----
+// 交互约定：状态是「圆点+文字」纯标识（不可点）；启停是 iOS 滑动开关（明显可点）；点卡片其余区域跳详情页。
 function HomeView(props) {
 	const ctx = props && props.ctx;
 	const [, force] = react.useReducer((n) => n + 1, 0);
@@ -435,15 +464,18 @@ function HomeView(props) {
 					react.createElement("span", { className: "dockm-dot", style: { background: m.accent } }),
 					react.createElement("span", { className: "dockh-name" }, m.name),
 					m.external ? react.createElement("span", { className: "dockh-badge", title: m.package || undefined }, "外部") : null,
-					react.createElement("span", { className: "dockh-badge" + (m.planned ? "" : enabled ? " on" : " off") },
-						m.planned ? "规划中" : enabled ? "已启用" : "已停用")),
-				react.createElement("div", { className: "dockh-desc" }, m.description),
-				react.createElement("div", { className: "dockh-stat" }, statNode),
-				react.createElement("div", { className: "dockh-foot" },
-					react.createElement("span", { className: "dockh-go" }, "查看详情 →"),
+					// 状态标识：圆点 + 文字（纯展示，与开关视觉区分）
+					react.createElement("span", { className: "dockh-status" + (m.planned ? " plan" : enabled ? "" : " off") },
+						react.createElement("span", { className: "dockh-sdot" }),
+						react.createElement("span", null, m.planned ? "规划中" : enabled ? "运行中" : "已停用")),
+					// 启停开关（规划中的功能不显示）
 					m.planned ? null : react.createElement("button", {
 						type: "button",
-						className: "dockm-switch" + (enabled ? " on" : ""),
+						className: "dock-sw" + (enabled ? " on" : ""),
+						role: "switch",
+						"aria-checked": enabled,
+						"aria-label": (enabled ? "停用" : "启用") + m.name,
+						title: enabled ? "停用「" + m.name + "」" : "启用「" + m.name + "」",
 						onClick: (e) => {
 							e.stopPropagation();
 							toggleFeature(m.id);
@@ -451,7 +483,11 @@ function HomeView(props) {
 							if (props && typeof props.onToggle === "function") props.onToggle();
 							force();
 						}
-					}, enabled ? "停用" : "启用")));
+					})),
+				react.createElement("div", { className: "dockh-desc" }, m.description),
+				react.createElement("div", { className: "dockh-stat" }, statNode),
+				react.createElement("div", { className: "dockh-foot" },
+					react.createElement("span", { className: "dockh-go" }, "查看详情 →")));
 		}));
 }
 
@@ -484,16 +520,27 @@ function DockPanel() {
 				f.planned
 					? react.createElement("span", { className: "dock-badge" }, "规划中")
 					: react.createElement("button", {
-						className: "dock-switch" + (st.enabled ? " on" : ""),
+						type: "button",
+						className: "dock-sw" + (st.enabled ? " on" : ""),
+						role: "switch",
+						"aria-checked": st.enabled,
+						"aria-label": (st.enabled ? "停用" : "启用") + f.name,
+						title: st.enabled ? "停用「" + f.name + "」" : "启用「" + f.name + "」",
 						onClick: () => toggle(f.id)
-					}, st.enabled ? "已启用" : "已停用"),
-				!f.planned && typeof f.Chip === "function"
-					? react.createElement("button", {
-						className: "dock-switch" + (chipShown(f.id) ? " on" : ""),
-						title: "控制会话输入区（模型选择器左侧）是否显示本功能的随身小控件",
-						onClick: () => { setChipShown(f.id, !chipShown(f.id)); force(); }
-					}, chipShown(f.id) ? "会话页显示" : "会话页隐藏")
-					: null),
+					}),
+					!f.planned && typeof f.Chip === "function"
+						? react.createElement("span", { className: "dockm-foot-sw" },
+							react.createElement("span", { className: "dockm-foot-swlabel" + (chipShown(f.id) ? " on" : "") }, "会话页小控件"),
+							react.createElement("button", {
+								type: "button",
+								className: "dock-sw" + (chipShown(f.id) ? " on" : ""),
+								role: "switch",
+								"aria-checked": chipShown(f.id),
+								"aria-label": (chipShown(f.id) ? "隐藏" : "显示") + f.name + "的会话页小控件",
+								title: "控制会话输入区（模型选择器左侧）是否显示本功能的随身小控件",
+								onClick: () => { setChipShown(f.id, !chipShown(f.id)); force(); }
+							}))
+						: null),
 				f.planned
 					? react.createElement("div", { className: "dock-body" }, PLANNED_NOTES[f.id] || "待接入：见 README 路线图")
 					: st.error ? react.createElement("div", { className: "dock-body dockm-err" }, "功能出错：" + st.error) : null,
@@ -519,6 +566,23 @@ function DockChips(props) {
 	return react.createElement("div", { className: "dockchip-row" }, items);
 }
 
+// ---- 功能全局浮层：模块可在描述符上挂 Overlay 组件（props: { ctx, feature }） ----
+// 与 Chip（会话输入区小控件）不同，Overlay 是常驻整页挂载的全局 UI（如任务动画的动效与通知栈），
+// 只要所属功能启用就渲染（功能停用即卸载，浮层自身负责按数据状态决定显示什么）。
+function FeatureOverlays() {
+	const [, force] = react.useReducer((n) => n + 1, 0);
+	useExternalVersion();
+	react.useEffect(() => subscribeFeatureState(() => force()), []);
+	const items = [];
+	for (const f of allModules()) {
+		if (f.planned || !stateOf(f.id).enabled || typeof f.Overlay !== "function") continue;
+		items.push(react.createElement(FeatureBoundary, { key: f.id },
+			react.createElement(f.Overlay, { ctx: ctxRef.current, feature: f })));
+	}
+	if (items.length === 0) return null;
+	return react.createElement(react.Fragment, null, items);
+}
+
 // ---- 插件应用：注册四处 UI（入口按钮 / 弹层 / 设置页 / 会话区 chips），注入样式 ----
 // ctx 以 ref 供视图组件使用（timer/theme 等服务按需自取；重装/HMR 时更新）
 const ctxRef = { current: null };
@@ -536,6 +600,10 @@ export function apply(ctx) {
 	slots.inject("shell.overlay", () => slots.register(
 		{ name: "shell.overlay", id: "dsh-dock-panel", order: 21, label: "功能坞面板" },
 		() => react.createElement(DockModal, null)));
+	// 功能全局浮层（任务动画的动效与通知等）：已启用功能的 Overlay 常驻挂载
+	slots.inject("shell.overlay", () => slots.register(
+		{ name: "shell.overlay", id: "dsh-dock-feature-overlays", order: 22, label: "功能坞全局浮层" },
+		() => react.createElement(FeatureOverlays, null)));
 	slots.inject("settings.section", () => slots.register(
 		{ name: "settings.section", id: "dsh-dock", order: 90, label: "功能坞" },
 		() => react.createElement(DockPanel, null)));

package/src/host-core.js

@@ -5,15 +5,45 @@ import z from '@deepseek-ai/schemastery'
 /** dsh-dock 自有 settings 命名空间（插件级配置，如图片理解代理）。 */
 export const DOCK_NS = 'dsh-dock'
 
-/** 自有命名空间的 schema（当前仅图片理解代理配置）。 */
+/** 自有命名空间的 schema（图片理解代理 + 任务动画配置）。 */
 export const DockConfig = z.object({
   visionProxy: z.object({
     enabled: z.boolean().default(false),
     provider: z.string().default(''),
     model: z.string().default(''),
   }).default({}),
+  animation: z.object({
+    // 动画与通知两个独立开关（可只开其一）
+    animationEnabled: z.boolean().default(true),
+    effectMode: z.string().default('flow'),
+    // 桌面伙伴场景缩放（0.85~2.2；浮层右下角也可直接拖动缩放）
+    robotScale: z.number().default(1.35),
+    notifyEnabled: z.boolean().default(true),
+    notifyOnComplete: z.boolean().default(true),
+    notifyOnError: z.boolean().default(true),
+    // 通知停留毫秒数（0 = 常驻直到手动关闭）
+    notifyStayMs: z.number().default(8000),
+    // 浏览器系统通知（页面后台时推送）
+    systemNotify: z.boolean().default(false),
+    // 任务结束提示音（WebAudio 合成，macOS/Windows 通用，无音频文件依赖）
+    soundNotify: z.boolean().default(true),
+    // 提示音音效（完成场景音名；异常音由音效包内配套）
+    soundEffect: z.string().default('chime'),
+    // 钉钉群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
+    dingtalkEnabled: z.boolean().default(false),
+    dingtalkWebhook: z.string().default(''),
+    // 飞书群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
+    feishuEnabled: z.boolean().default(false),
+    feishuWebhook: z.string().default(''),
+  }).default({}),
 })
 
+/** 任务动画 effectMode 合法值（客户端动画模式）。 */
+export const ANIMATION_MODES = ['flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora']
+
+/** 提示音 soundEffect 合法值（客户端音效库键名）。 */
+export const SOUND_EFFECTS = ['chime', 'ding', 'coin', 'bell', 'pulse', 'arp']
+
 /** 沿 settingsPath 走一层对象（user/base/value 都可用）。 */
 export function walkPath(node, path) {
   for (const key of path || []) {

package/src/shared.js

@@ -23,16 +23,35 @@ export class FeatureBoundary extends react.Component {
 	}
 }
 
-// ---- 功能开关状态（外壳面板与会话区 chips 共用；浏览器内存态，随页面生命周期） ----
+// ---- 功能开关状态（外壳面板与会话区 chips 共用；每功能开关 localStorage 持久化，重启后保持） ----
 const featureState = new Map();
 const stateListeners = new Set();
 function notifyState() {
 	for (const fn of stateListeners) fn();
 }
-/** 外壳 apply 时初始化内置功能的默认开关。 */
+// 开关持久化（dsh-dock/features/v1）：id -> boolean；未记录过的功能用模块默认值
+const FEATURE_STORE_KEY = "dsh-dock/features/v1";
+const featurePersist = { map: {} };
+try {
+	if (typeof localStorage !== "undefined") {
+		const raw = localStorage.getItem(FEATURE_STORE_KEY);
+		const obj = raw ? JSON.parse(raw) : null;
+		if (obj && typeof obj === "object") featurePersist.map = obj;
+	}
+} catch { /* localStorage 不可用时用默认值 */ }
+function persistFeatureEnabled() {
+	try {
+		if (typeof localStorage !== "undefined") localStorage.setItem(FEATURE_STORE_KEY, JSON.stringify(featurePersist.map));
+	} catch { /* 持久化失败静默 */ }
+}
+/** 外壳 apply 时初始化内置功能的默认开关（持久化过的值优先于模块默认）。 */
 export function initFeatureState(defs) {
 	for (const f of defs) {
-		if (!featureState.has(f.id)) featureState.set(f.id, { enabled: !f.planned && f.defaultEnabled !== false, error: null });
+		if (featureState.has(f.id)) continue;
+		let enabled = !f.planned && f.defaultEnabled !== false;
+		const saved = featurePersist.map[f.id];
+		if (typeof saved === "boolean") enabled = saved;
+		featureState.set(f.id, { enabled, error: null });
 	}
 }
 /** 取功能开关（外部功能默认启用；未登记的 id 惰性建项）。 */
@@ -44,6 +63,8 @@ export function stateOf(id) {
 export function toggleFeature(id) {
 	const st = stateOf(id);
 	st.enabled = !st.enabled;
+	featurePersist.map[id] = st.enabled;
+	persistFeatureEnabled();
 	notifyState();
 }
 export function subscribeFeatureState(fn) {