dsh-dock 0.4.1 → 0.5.0

package/features/balance/view.js

@@ -90,8 +90,11 @@ function BalanceView(props) {
 	} else if (providers.length === 0) {
 		body.push(react.createElement("div", { key: "empty", className: "dkb-note" }, "没有找到已配置的模型 Provider"));
 	} else {
+		// Provider 分组：可查余额的排前面（不可查/需登录的往后）
+		const rank = (p) => (p.balance && p.balance.status === "ok" ? 0 : p.balance && p.balance.status === "login-required" ? 1 : 2);
+		const sorted = providers.slice().sort((a, b) => rank(a) - rank(b));
 		body.push(react.createElement("div", { key: "rows", className: "dkb-rows" },
-			providers.map((p) => {
+			sorted.map((p) => {
 				const accent = accentOf(p.id);
 				const b = p.balance;
 				let badge = ["未知", ""];
@@ -102,51 +105,57 @@ function BalanceView(props) {
 					else if (b.status === "login-required") badge = ["需登录", "warn"];
 					else badge = ["查询失败", "err"];
 				}
-				const sub = ["ID: " + p.id, p.api ? "api: " + p.api : null, p.baseURL ? p.baseURL : null].filter(Boolean).join(" · ");
-				const cells = [];
+				// 主体内容按状态分三型：余额（数字大卡）/ 登录跳转 / 说明
 				let balBody = null;
 				if (b && b.status === "ok" && b.kind === "quota") {
-					cells.push(react.createElement("div", { key: "q", className: "dkb-bal" },
-						react.createElement("span", { className: "dkb-cur", style: { color: accent } }, "总额度"),
-						react.createElement("span", { className: "dkb-total", style: { color: C_TOTAL } }, "剩余 " + fmt(b.remaining) + (b.unit ? " " + b.unit : "")),
-						react.createElement("span", { className: "dkb-part" }, "已用 " + fmt(b.used) + " / 总 " + fmt(b.limit)),
-						b.resetTime
-							? react.createElement("span", { className: "dkb-part" }, "重置 " + String(b.resetTime).slice(0, 16))
-							: null));
-					(Array.isArray(b.dims) ? b.dims : []).forEach((d, i) => {
-						cells.push(react.createElement("div", { key: "d" + i, className: "dkb-bal" },
-							react.createElement("span", { className: "dkb-cur", style: { color: accent } }, d.window === "weekly" ? "周额度" : "小时额度"),
-							react.createElement("span", { className: "dkb-total", style: { color: C_TOTAL } }, "剩余 " + fmt(d.remaining)),
-							react.createElement("span", { className: "dkb-part" }, "已用 " + fmt(d.used) + " / " + fmt(d.limit)),
-							d.resetTime
-								? react.createElement("span", { className: "dkb-part" }, "重置 " + String(d.resetTime).slice(0, 16))
-								: null));
-					});
+					const dims = Array.isArray(b.dims) ? b.dims : [];
+					balBody = react.createElement(react.Fragment, null,
+						react.createElement("div", { className: "dkb-main" },
+							react.createElement("span", { className: "dkb-main-label" }, "剩余额度"),
+							react.createElement("span", { className: "dkb-main-value" }, fmt(b.remaining) + (b.unit ? " " + b.unit : "")),
+							react.createElement("span", { className: "dkb-main-part" }, "已用 " + fmt(b.used) + " / 总 " + fmt(b.limit),
+								b.resetTime ? react.createElement("span", null, " · 重置 " + String(b.resetTime).slice(0, 10)) : null)),
+						dims.map((d, i) => react.createElement("div", { key: "d" + i, className: "dkb-dim" },
+							react.createElement("span", { className: "dkb-dim-label" }, d.window === "weekly" ? "周额度" : "小时额度"),
+							react.createElement("span", { className: "dkb-dim-bar" },
+								react.createElement("span", { className: "dkb-dim-fill", style: { width: (d.limit > 0 ? Math.min(100, Math.round((d.remaining / d.limit) * 100)) : 0) + "%" } })),
+							react.createElement("span", { className: "dkb-dim-text" }, "剩 " + fmt(d.remaining) + " / " + fmt(d.limit)))));
 				} else if (b && b.status === "ok") {
 					const infos = Array.isArray(b.infos) ? b.infos : [];
-					cells.push(infos.map((i, idx) =>
-						react.createElement("div", { key: idx, className: "dkb-bal" },
-							react.createElement("span", { className: "dkb-cur", style: { color: accent } }, i.currency),
-							react.createElement("span", { className: "dkb-total", style: { color: C_TOTAL } }, "总额 " + fmt(i.totalBalance)),
-							i.grantedBalance != null
-								? react.createElement("span", { className: "dkb-part", style: { color: C_GRANTED } }, "赠送 " + fmt(i.grantedBalance))
-								: null,
-							i.toppedUpBalance != null
-								? react.createElement("span", { className: "dkb-part", style: { color: C_TOPUP } }, "充值 " + fmt(i.toppedUpBalance))
-								: null)));
+					balBody = react.createElement("div", { className: "dkb-mains" },
+						infos.map((i, idx) => react.createElement("div", { key: idx, className: "dkb-main" },
+							react.createElement("span", { className: "dkb-main-label", style: { color: accent } }, i.currency),
+							react.createElement("span", { className: "dkb-main-value" }, fmt(i.totalBalance)),
+							react.createElement("span", { className: "dkb-main-parts" },
+								i.grantedBalance != null ? react.createElement("span", { className: "dkb-main-part", style: { color: C_GRANTED } }, "赠送 " + fmt(i.grantedBalance)) : null,
+								i.toppedUpBalance != null ? react.createElement("span", { className: "dkb-main-part", style: { color: C_TOPUP } }, "充值 " + fmt(i.toppedUpBalance)) : null))));
 				} else if (b && b.status === "login-required" && b.consoleUrl) {
-					balBody = react.createElement("div", { className: "dkb-bal" },
+					balBody = react.createElement("div", { className: "dkb-main" },
 						react.createElement("a", { href: b.consoleUrl, target: "_blank", rel: "noreferrer", className: "dkb-link", style: { color: accent } }, "去控制台查看余额 →"));
 				} else {
-					balBody = react.createElement("div", { className: "dkb-note" }, (b && b.message) || "未知状态");
+					balBody = b && b.message
+						? react.createElement("div", { className: "dkb-note" }, b.message)
+						: react.createElement("div", { className: "dkb-note" }, "该 Provider 没有已知的余额查询接口");
 				}
-				if (cells.length > 0) balBody = react.createElement("div", { className: "dkb-rows" }, cells);
+				// 长连接信息弱化成单行小字（ID · api · baseURL），模型 chips 收敛到折叠区
+				const sub = ["ID " + p.id, p.api, p.baseURL ? p.baseURL.replace(/^https?:\/\//, "") : null].filter(Boolean).join(" · ");
 				return react.createElement("div", { key: p.id, className: "dkb-row", "data-dock-provider": p.id },
 					react.createElement("div", { className: "dkb-row-head" },
 						react.createElement("span", { className: "dkb-dot", style: { background: accent } }),
 						react.createElement("span", { className: "dkb-name", style: { color: accent } }, p.displayName),
 						def === p.id ? react.createElement("span", { className: "dkb-default" }, "默认") : null,
-						react.createElement("span", { className: "dkb-badge" + (badge[1] ? " " + badge[1] : ""), style: badge[1] === "err" ? { color: C_ERR, borderColor: C_ERR } : null }, badge[0])),
+						react.createElement("span", { className: "dkb-badge" + (badge[1] ? " " + badge[1] : ""), style: badge[1] === "err" ? { color: C_ERR, borderColor: C_ERR } : null }, badge[0]),
+						// 模型数折叠提示（点开展开 chips）
+						p.models && p.models.length > 0
+							? react.createElement("button", {
+								type: "button", className: "dkb-models-toggle",
+								title: p.models.join(", "),
+								onClick: (e) => {
+									const row = e.currentTarget.closest(".dkb-row");
+									if (row) row.classList.toggle("dkb-models-open");
+								}
+							}, p.models.length + " 个模型 ▾")
+							: null),
 					sub ? react.createElement("div", { className: "dkb-sub" }, sub) : null,
 					p.apiKeyEnv
 						? react.createElement("div", { className: "dkb-sub" }, "密钥: " + p.apiKeyEnv + (p.credentialConfigured ? " ✓" : " ✗"))
@@ -165,7 +174,7 @@ function BalanceView(props) {
 	return react.createElement("div", { className: "dkb-rows" },
 		react.createElement("div", { className: "dkb-note" },
 			data && !snap.error && providers.length > 0
-				? okCount + "/" + providers.length + " 个 Provider 可查余额"
+				? okCount + "/" + providers.length + " 个 Provider 可查余额（可查的排前面）"
 				: "模型余额 · Host 半部实时拉取"),
 		body,
 		react.createElement("div", { className: "dkb-foot" },
@@ -271,8 +280,9 @@ export const feature = {
 	css: [
 		".dkb-note{color:var(--dsw-alias-label-secondary);font-size:12px;}",
 		".dkb-error{color:var(--dsw-alias-state-error-primary);}",
-		".dkb-rows{display:flex;flex-direction:column;gap:8px;}",
-		".dkb-row{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:8px 10px;display:flex;flex-direction:column;gap:5px;}",
+		".dkb-rows{display:flex;flex-direction:column;gap:10px;}",
+		// Provider 卡片：行距收窄、留白分层
+		".dkb-row{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:10px 14px 12px;display:flex;flex-direction:column;gap:6px;}",
 		".dkb-row-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}",
 		".dkb-dot{width:8px;height:8px;border-radius:50%;flex:none;}",
 		".dkb-name{font-weight:600;font-size:13px;color:var(--dsw-alias-label-primary);}",
@@ -281,13 +291,28 @@ export const feature = {
 		".dkb-badge.ok{color:var(--dsw-alias-state-success-primary);border-color:currentColor;}",
 		".dkb-badge.warn{color:var(--dsw-alias-state-warning-primary);border-color:currentColor;}",
 		".dkb-badge.err{color:var(--dsw-alias-state-error-primary);border-color:currentColor;}",
+		// 模型数折叠开关（点行头右侧"N 个模型 ▾"展开/收起 chips）
+		".dkb-models-toggle{margin-left:auto;cursor:pointer;border:none;background:transparent;color:var(--dsw-alias-label-tertiary);font-family:inherit;font-size:11px;padding:1px 6px;border-radius:6px;white-space:nowrap;}",
+		".dkb-models-toggle:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-primary);}",
+		".dkb-row:not(.dkb-models-open) .dkb-chips{display:none;}",
+		".dkb-row.dkb-models-open .dkb-models-toggle::after{content:\"\";}",
+		// 连接信息弱化单行（省略 URL 协议头、超出省略号）
 		".dkb-sub{color:var(--dsw-alias-label-tertiary);font-size:11px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}",
-		".dkb-chips{display:flex;flex-wrap:wrap;gap:4px;}",
+		".dkb-chips{display:flex;flex-wrap:wrap;gap:4px;padding:2px 0 4px;}",
 		".dkb-chip{font-size:10px;border-radius:6px;padding:1px 6px;}",
-		".dkb-bal{display:flex;gap:10px;flex-wrap:wrap;font-size:12px;color:var(--dsw-alias-label-primary);align-items:baseline;}",
-		".dkb-cur{font-weight:600;min-width:48px;}",
-		".dkb-total{font-weight:600;}",
-		".dkb-part{font-size:11px;color:var(--dsw-alias-label-tertiary);}",
+		// 余额主数字卡（大号数字 + 小字辅助信息；多币种横排多卡）
+		".dkb-mains{display:flex;gap:12px;flex-wrap:wrap;}",
+		".dkb-main{display:flex;flex-direction:column;gap:2px;padding:8px 12px;border-radius:8px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);min-width:150px;}",
+		".dkb-main-label{font-size:11px;color:var(--dsw-alias-label-tertiary);}",
+		".dkb-main-value{font-size:20px;font-weight:700;color:var(--dsw-alias-state-success-primary);font-variant-numeric:tabular-nums;line-height:1.2;}",
+		".dkb-main-parts{display:flex;gap:10px;flex-wrap:wrap;}",
+		".dkb-main-part{font-size:11px;color:var(--dsw-alias-label-tertiary);}",
+		// 配额维度条（周/小时额度：进度条 + 剩余/总量）
+		".dkb-dim{display:flex;align-items:center;gap:10px;font-size:11px;color:var(--dsw-alias-label-secondary);}",
+		".dkb-dim-label{flex:none;min-width:44px;color:var(--dsw-alias-label-tertiary);}",
+		".dkb-dim-bar{flex:1;max-width:220px;height:5px;border-radius:3px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);overflow:hidden;}",
+		".dkb-dim-fill{display:block;height:100%;border-radius:3px;background:linear-gradient(90deg,var(--dsw-alias-state-success-primary),color-mix(in srgb,var(--dsw-alias-state-success-primary) 60%,#fff));}",
+		".dkb-dim-text{flex:none;color:var(--dsw-alias-label-tertiary);font-variant-numeric:tabular-nums;}",
 		".dkb-link{font-size:12px;text-decoration:none;}",
 		".dkb-link:hover{text-decoration:underline;}",
 		".dkb-foot{display:flex;align-items:center;justify-content:space-between;gap:8px;color:var(--dsw-alias-label-tertiary);font-size:12px;}",

package/features/modelconfig/view.js

@@ -280,10 +280,12 @@ function ModelsView() {
 		const vpKey = vpDraft.provider + "/" + vpDraft.model;
 		const vpKnown = vpCandidates.some((c) => c.key === vpKey);
 		body.push(react.createElement("div", { key: "visionproxy", className: "dkm-prov" },
-			react.createElement("div", { className: "dkm-prov-head" },
-				react.createElement("span", { className: "dkm-name" }, "图片理解代理"),
-				react.createElement("span", { className: "dkm-badge" }, vpDraft.enabled ? "已启用" : "已停用"),
-				react.createElement("span", { className: "dkm-sub" }, "纯文本模型收到图片时自动调用所选视觉模型识别，识别文本替换图片；多模态模型原样自识别")),
+				react.createElement("div", { className: "dkm-prov-head" },
+					react.createElement("span", { className: "dkm-name" }, "图片理解代理"),
+					react.createElement("span", { className: "dkm-badge" }, vpDraft.enabled ? "已启用" : "已停用"),
+					react.createElement("span", { className: "dkm-sub" }, "纯文本模型收到图片时自动调用所选视觉模型识别，识别文本替换图片；多模态模型原样自识别")),
+				react.createElement("div", { className: "dkm-note dkm-warn" },
+					"⚠ 本功能会调用视觉模型识别图片，消耗 token（每次识图按视觉模型计费）。默认关闭；不开启则插件其余功能均不消耗任何 token。"),
 			react.createElement("div", { className: "dkm-checks" },
 				react.createElement("label", { className: "dkm-check" },
 					react.createElement("input", {
@@ -401,6 +403,7 @@ export const feature = {
 	description: "编辑各 Provider 模型目录：输入类型（文本/图片 + 标注）与思考强度档位；写回官方配置热生效，会话模型选择器即时可选",
 	css: [
 		".dkm-note{color:var(--dsw-alias-label-secondary);font-size:12px;}",
+		".dkm-warn{color:var(--dsw-alias-state-warning-primary);}",
 		".dkm-error{color:var(--dsw-alias-state-error-primary);font-size:12px;}",
 		".dkm-chips{display:flex;flex-wrap:wrap;gap:6px;}",
 		".dkm-chip{cursor:pointer;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-secondary);border-radius:999px;padding:3px 12px;font-family:inherit;font-size:12px;}",

package/index.js

@@ -12,12 +12,13 @@
 //   - visionproxy 图片理解代理（v0.3.1）：纯文本模型收图自动走视觉模型识别
 //   - balance     模型余额（v0.2.0）：各 Provider 账户余额/配额
 //   - tokenlog    用量记录（v0.4.0）：LLM 调用记账与统计（移植自 @wycto/dsh-token-usage）
-//   - animation   任务动画（路线图 0.5.0 占位）
+//   - animation   任务动画（v0.5.0）：会话任务追踪 + 动效/通知配置持久化（参照 @wycto/dsh-task-pulse）
 import { DOCK_NS, DockConfig } from './src/host-core.js'
 import { feature as fModels } from './features/modelconfig/host.js'
 import { feature as fVisionProxy } from './features/visionproxy/host.js'
 import { feature as fBalance } from './features/balance/host.js'
 import { feature as fTokenlog } from './features/tokenlog/host.js'
+import { feature as fAnimation } from './features/animation/host.js'
 
 export const name = 'dsh-dock'
 
@@ -36,12 +37,7 @@ export function apply(ctx) {
     fVisionProxy,
     fBalance,
     fTokenlog,
-    {
-      id: 'animation',
-      name: '任务动画',
-      roadmap: '0.5.0',
-      description: '任务进度动画与通知',
-    },
+    fAnimation,
   ]
 
   const state = new Map()
@@ -80,8 +76,8 @@ export function apply(ctx) {
   }
 
   // 默认启用已实现的功能（与 Client 半部 defaultEnabled 对齐）。
-  // 目前 Host↔Client 的开关同步在 0.5.0（持久化 + 双侧注册表打通）落地，
-  // 在此之前 Host 侧开关以本处 defaultEnabled 为准。
+  // Client 侧功能开关已 localStorage 持久化（v0.5.0）；Host↔Client 的开关双向同步仍未打通，
+  // 在此之前 Host 侧开关以本处 defaultEnabled 为准（面板停用某功能只影响浏览器侧 UI）。
   for (const f of FEATURES) {
     if (f.defaultEnabled) setEnabled(f.id, true)
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-dock",
-  "version": "0.4.1",
-  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
+  "version": "0.5.0",
+  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额、任务动画（8 种氛围动效 + 桌面伙伴 3D 场景、完成通知与提示音、钉钉推送，开关独立、配置持久化）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
   "files": [

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 : "",
 		};
@@ -155,9 +153,22 @@ 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;}",
@@ -379,34 +390,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 +458,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 +477,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 +514,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 +560,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 +594,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,42 @@ 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(''),
+  }).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) {