dsh-dock 0.9.8 → 0.10.0

package/features/runstate/host.js

@@ -0,0 +1,64 @@
+// dsh-dock · 功能模块【运行状态】· 宿主半部
+//
+// 职责：把会话级任务追踪的快照下发给客户端。追踪本身在 src/task-track.js
+// （与【任务动画】【任务通知】共用一份数据，引用计数共享）；本模块只读——
+// 没有自己的 settings 配置段，也不写盘（启停由功能坞的 features.runstate 开关负责）。
+//
+// RPC（webServer HTTP 路由，前缀 /dsh-dock/runstate/）：
+//   POST /status —— 活跃任务 + 最近完成（客户端据此渲染运行状态页与首页概要）
+//
+// 数据形状由客户端消费，字段改动要同时看：features/runstate/view.jsx、
+// features/animation/view.jsx、features/notify/view.jsx。
+import { sendJson, readBody } from '../../src/host-core.js'
+import { acquireTaskTracker } from '../../src/task-track.js'
+
+export const feature = {
+  id: 'runstate',
+  name: '运行状态',
+  description: '任务运行状态一览：进行中任务（阶段 / 耗时 / 回合 / Token / 等待确认）与最近完成',
+  defaultEnabled: false,
+  setup(ctx) {
+    const disposers = []
+    const dispose = () => {
+      while (disposers.length > 0) {
+        const fn = disposers.pop()
+        try { if (typeof fn === 'function') fn() } catch { /* 停用清理失败不阻断 */ }
+      }
+    }
+
+    // 会话级任务追踪（与【任务动画】【任务通知】共享一份；三个功能都停用后自动退订会话事件）
+    const lease = acquireTaskTracker(ctx)
+    disposers.push(() => lease.release())
+    const tracker = lease.tracker
+
+    // ===== RPC 路由 =====
+    disposers.push(ctx.inject(['webServer'], (wsCtx) => {
+      wsCtx.effect(() => wsCtx.webServer.register({
+        kind: 'prefix',
+        path: '/dsh-dock/runstate',
+        async handler(req, res) {
+          try {
+            const url = new URL(req.url || '/', 'http://dsh.internal')
+            const method = url.pathname.replace(/^\/dsh-dock\/runstate\/?/, '').split('/')[0] || ''
+            await readBody(req) // 读空请求体，避免连接上残留未消费数据
+
+            if (method === 'status') {
+              return sendJson(res, 200, { ok: true, data: tracker.snapshot(Date.now()) })
+            }
+
+            return sendJson(res, 404, { ok: false, error: { code: 'method-not-found', message: 'unknown method: ' + method } })
+          } catch (e) {
+            const status = e && e.statusCode ? e.statusCode : 500
+            console.error('[dsh-dock] runstate HTTP error:', status, e && e.message)
+            return sendJson(res, status, {
+              ok: false,
+              error: { code: status >= 500 ? 'internal' : 'bad-request', message: (e && e.message) || String(e) },
+            })
+          }
+        },
+      }), 'dsh-dock runstate: /dsh-dock/runstate HTTP route')
+    }))
+
+    return dispose
+  },
+}

package/features/runstate/view.jsx

@@ -0,0 +1,269 @@
+// dsh-dock · 功能模块【运行状态】· 客户端视图
+//
+// 两部分：
+//  1. View     —— 功能坞面板页：进行中任务（阶段 / 耗时 / 回合 / 工具 / Token / 等待确认）与最近完成一览；
+//  2. HomeStat —— 首页总揽概要（N 个任务进行中 / 等待确认 / 空闲 · 最近完成…）。
+//
+// 只读页面：数据全部来自宿主侧会话级任务追踪（src/task-track.js，与【任务动画】【任务通知】
+// 共用同一份实例），本模块不写任何配置——动效在 features/animation/、结束与确认提醒在
+// features/notify/。没有全局浮层，因此只在面板打开时轮询，关闭面板即零开销。
+//
+// Host 通信：fetch('/dsh-dock/runstate/status')（见 features/runstate/host.js）。
+import { useState, useEffect } from "react";
+
+// ---------- Host RPC 桥接 ----------
+function rpcCall(method, args) {
+	return fetch("/dsh-dock/runstate/" + method, {
+		method: "POST",
+		headers: { "content-type": "application/json" },
+		body: JSON.stringify(args === undefined ? {} : args),
+	})
+		.then(async (res) => {
+			const data = await res.json().catch(() => ({}));
+			if (res.ok && data && data.ok === true) return data.data;
+			// 宿主侧没有运行状态路由（405/404）：宿主进程可能是旧版本，或本功能在宿主侧未 setup
+			if (res.status === 405 || res.status === 404) {
+				throw new Error("宿主侧没有「运行状态」接口：宿主进程可能是旧版本，或该功能在宿主侧未启用（重启 dsh web，或把功能坞里的开关关掉再打开）");
+			}
+			if (data && data.ok === false) throw new Error((data.error && data.error.message) || ("HTTP " + res.status));
+			throw new Error("HTTP " + res.status + (data && data.error && data.error.message ? ": " + data.error.message : ""));
+		});
+}
+
+// ---------- 结束原因 / 阶段（与宿主追踪的字段一一对应） ----------
+const END_LABELS = {
+	completed: { label: "完成", cls: "ok" },
+	error: { label: "出错", cls: "err" },
+	aborted: { label: "已中止", cls: "warn" },
+	blocked: { label: "受阻", cls: "warn" },
+	"max-tokens": { label: "达输出上限", cls: "warn" },
+	interrupted: { label: "中断", cls: "warn" },
+};
+function endInfo(reason) {
+	return END_LABELS[reason] || END_LABELS.completed;
+}
+const PHASE_LABELS = { think: "思考中", write: "输出中", code: "编写代码", search: "查资料" };
+function phaseLabel(p) { return PHASE_LABELS[p] || "工作中"; }
+// 阶段配色（与任务动画的徽标同源，便于一眼对上）
+const PHASE_COLORS = { think: "#2f6fed", write: "#0d9488", code: "#b45309", search: "#0e7490" };
+function phaseColor(p) { return PHASE_COLORS[p] || "#2f6fed"; }
+
+// ---------- 格式化 ----------
+function fmtCompact(n) {
+	n = Number(n) || 0;
+	if (n >= 1e6) return (n / 1e6).toFixed(2) + "M";
+	if (n >= 1e3) return (n / 1e3).toFixed(1) + "K";
+	return String(Math.round(n));
+}
+// 毫秒 → "3分21秒" / "1小时2分"
+function fmtDur(ms) {
+	const s = Math.max(0, Math.round((ms || 0) / 1000));
+	const h = Math.floor(s / 3600), m = Math.floor((s % 3600) / 60), sec = s % 60;
+	if (h > 0) return h + "小时" + m + "分" + sec + "秒";
+	if (m > 0) return m + "分" + sec + "秒";
+	return sec + "秒";
+}
+// 毫秒 → "12:34" / "1:02:11"（进行中任务的计时）
+function fmtClock(ms) {
+	const s = Math.max(0, Math.floor((ms || 0) / 1000));
+	const h = Math.floor(s / 3600), m = Math.floor((s % 3600) / 60), sec = s % 60;
+	const p = (x) => String(x).padStart(2, "0");
+	return h > 0 ? h + ":" + p(m) + ":" + p(sec) : p(m) + ":" + p(sec);
+}
+function fmtTime(ts) {
+	if (!ts) return "";
+	const d = new Date(ts);
+	const p = (x) => String(x).padStart(2, "0");
+	return p(d.getHours()) + ":" + p(d.getMinutes()) + ":" + p(d.getSeconds());
+}
+function truncate(str, max) {
+	if (!str) return "";
+	return String(str).length > max ? String(str).slice(0, max) + "…" : str;
+}
+
+// ---------- 共享快照：面板页与首页概要共用一份数据 ----------
+const runStateStore = {
+	snap: { status: null, loading: false, error: null },
+	listeners: new Set(),
+	subscribe(fn) { this.listeners.add(fn); return () => { this.listeners.delete(fn); }; },
+	emit() { for (const fn of this.listeners) fn(); },
+	refresh() {
+		if (this.snap.loading) return Promise.resolve();
+		this.snap = Object.assign({}, this.snap, { loading: true });
+		this.emit();
+		return rpcCall("status")
+			.then((data) => {
+				this.snap = { status: data, loading: false, error: null };
+				this.emit();
+			})
+			.catch((e) => {
+				this.snap = Object.assign({}, this.snap, { loading: false, error: (e && e.message) || String(e) });
+				this.emit();
+			});
+	},
+};
+function useRunState() {
+	const [snap, setSnap] = useState(runStateStore.snap);
+	useEffect(() => runStateStore.subscribe(() => setSnap(runStateStore.snap)), []);
+	return snap;
+}
+
+// 等待确认的审批项总数（标题、横幅与首页概要共用；任何分支之外都能引用）
+function waitingOf(active) {
+	return (active || []).reduce((n, t) => n + (Array.isArray(t.approvals) ? t.approvals.length : 0), 0);
+}
+
+// ---------- 任务卡 ----------
+function TaskCard(props) {
+	const t = props.t;
+	const info = endInfo(t.endReason);
+	const waiting = !props.done && Array.isArray(t.approvals) && t.approvals.length > 0;
+	return (
+		<div className="dkrs-task">
+			<div className="dkrs-task-head">
+				<span className="dkrs-task-title" title={t.title}>{t.title || "(无标题)"}</span>
+				{props.done ? <span className={"dkrs-tag " + info.cls}>{info.label}</span>
+					: waiting ? <span className="dkrs-tag warn">等待确认</span>
+						: <span className="dkrs-tag on">{phaseLabel(t.phase)}</span>}
+			</div>
+			<div className="dkrs-task-meta">
+				<span>{(t.models && t.models.length ? t.models.join(", ") : "未知") + (t.provider ? "（" + t.provider + "）" : "")}</span>
+				<span>{props.done ? fmtDur(t.duration) : fmtClock(t.elapsed)}</span>
+				{"turns" in t ? <span>{"回合 " + (t.turns || 0) + " · 步骤 " + (t.steps || 0) + (t.toolCalls ? " · 工具 " + t.toolCalls : "")}</span> : null}
+				{t.totalTokens ? <span>{"↧" + fmtCompact(t.inputTokens) + " ↥" + fmtCompact(t.outputTokens)}</span> : null}
+				{props.done && t.endTime ? <span>{fmtTime(t.endTime)}</span> : null}
+			</div>
+			{waiting ? (
+				<div className="dkrs-task-wait">
+					{t.approvals.map((a, i) => (a && a.toolName ? a.toolName : "未知工具") + (a && a.reason ? "：" + truncate(a.reason, 80) : "")).join("；")}
+				</div>
+			) : null}
+			{props.done && t.errorMessage ? <div className="dkrs-task-err">{truncate(t.errorMessage, 120)}</div> : null}
+		</div>
+	);
+}
+
+// ---------- 面板页 ----------
+function RunStateView() {
+	const snap = useRunState();
+	const st = snap.status;
+	const active = st && st.active ? st.active : [];
+	const recent = st && st.recent ? st.recent.slice(0, 10) : [];
+	const waitingCount = waitingOf(active);
+	// 面板打开期间自动刷新：有任务 2s（阶段/耗时/待确认跟得上），空闲 8s，出错 15s。
+	// 本模块没有常驻浮层，所以关掉面板即停止轮询。
+	useEffect(() => {
+		let stopped = false;
+		let timer = null;
+		const loop = async () => {
+			await runStateStore.refresh();
+			if (stopped) return;
+			const s = runStateStore.snap;
+			timer = setTimeout(loop, s.error ? 15000 : (s.status && s.status.active && s.status.active.length > 0 ? 2000 : 8000));
+		};
+		loop();
+		return () => { stopped = true; if (timer) clearTimeout(timer); };
+	}, []);
+
+	const sub = snap.error ? "状态拉取失败：" + snap.error
+		: !st ? (snap.loading ? "正在拉取任务状态…" : "等待任务状态")
+			: waitingCount > 0 ? waitingCount + " 项等待确认 · " + active.length + " 个任务进行中"
+				: active.length > 0 ? active.length + " 个任务进行中"
+					: recent.length > 0 ? "空闲 · 显示最近完成" : "空闲 · 暂无任务记录";
+
+	return (
+		<div className="dkrs-root">
+			<div className="dkrs-sec">
+				<div className="dkrs-sec-head">
+					<span className="dkrs-sec-title">运行状态</span>
+					<span className="dkrs-sec-sub">{sub}</span>
+					<button type="button" className="dkrs-refresh" onClick={() => runStateStore.refresh()}>
+						{snap.loading ? "刷新中…" : "刷新"}
+					</button>
+				</div>
+				{waitingCount > 0 ? (
+					<div className="dkrs-waitbanner">✋ {waitingCount} 项等待确认：任务停在需要你批准的步骤上，请在会话里处理后继续。</div>
+				) : null}
+				{active.length > 0 ? (
+					<div className="dkrs-tasks">{active.map((t) => <TaskCard key={t.sessionId} t={t} />)}</div>
+				) : null}
+				{!snap.error && active.length === 0 && recent.length === 0
+					? <div className="dkrs-note">发起新会话任务后，这里会显示进行中与最近完成的任务（动效见左侧「任务动画」，提醒见「任务通知」）。</div> : null}
+				{active.length === 0 && recent.length > 0 ? <div className="dkrs-note">当前没有进行中的任务。</div> : null}
+				{recent.length > 0 ? (
+					<>
+						<div className="dkrs-done-title">最近完成</div>
+						<div className="dkrs-tasks dkrs-tasks-done">
+							{recent.map((t) => <TaskCard key={t.sessionId + ":" + t.endTime} t={t} done />)}
+						</div>
+					</>
+				) : null}
+				<div className="dkrs-note dkrs-foot">
+					本页只读：数据来自宿主侧会话级任务追踪，与「任务动画」「任务通知」共用同一份（三个功能可各自启停）。
+					动效在「任务动画」，结束 / 需确认提醒在「任务通知」。
+				</div>
+			</div>
+		</div>
+	);
+}
+
+// ---------- 首页总揽概要 ----------
+function RunStateStat(props) {
+	const snap = useRunState();
+	// 首页卡片没有常驻轮询（本模块无浮层）：首次进入拉一次，之后随面板页刷新。
+	useEffect(() => { if (!runStateStore.snap.status) runStateStore.refresh(); }, []);
+	const st = snap.status;
+	if (snap.error) return <span className="dkrs-err">运行状态不可用（宿主需重启加载运行状态路由）</span>;
+	if (!st) return <span>等待任务状态…</span>;
+	const active = st.active || [];
+	const waiting = waitingOf(active);
+	if (waiting > 0) return <span className="dkrs-warn">✋ {waiting} 项等待确认 · {active.length} 个任务进行中</span>;
+	if (active.length > 0) {
+		return <span>{active.length + " 个任务进行中 · " + fmtDur(Math.max(...active.map((x) => x.elapsed || 0)))}</span>;
+	}
+	const last = (st.recent || [])[0];
+	return <span>{last ? "空闲 · 最近完成 " + truncate(last.title, 24) : "空闲 · 暂无任务记录"}</span>;
+}
+
+// ---------- 样式（dkrs- 前缀；全部走主题变量，暗/亮色自适应） ----------
+const css = [
+	".dkrs-root{display:flex;flex-direction:column;gap:10px;}",
+	".dkrs-note{color:var(--dsw-alias-label-secondary);font-size:12px;line-height:1.6;}",
+	".dkrs-err{color:var(--dsw-alias-state-error-primary);}",
+	".dkrs-warn{color:var(--dk-warn);}",
+	".dkrs-foot{border-top:1px solid var(--dsw-alias-border-l1);padding-top:8px;font-size:11px;}",
+	".dkrs-sec{border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-1);border-radius:10px;padding:10px 12px;display:flex;flex-direction:column;gap:8px;}",
+	".dkrs-sec-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;}",
+	".dkrs-sec-title{font-weight:600;font-size:13px;color:var(--dsw-alias-label-primary);flex:none;}",
+	".dkrs-sec-sub{font-size:11px;color:var(--dsw-alias-label-tertiary);flex:1;min-width:120px;}",
+	".dkrs-refresh{cursor:pointer;flex:none;color:var(--dsw-alias-label-primary);background:transparent;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:2px 10px;font-family:inherit;font-size:12px;}",
+	".dkrs-refresh:hover{background:var(--dsw-alias-interactive-bg-hover);}",
+	// 等待确认横幅：琥珀描边，常驻在列表上方（任务卡各自也带「等待确认」标签）
+	".dkrs-waitbanner{border:1px solid color-mix(in srgb,var(--dk-warn) 45%,transparent);background:color-mix(in srgb,var(--dk-warn) 10%,transparent);color:var(--dk-warn);border-radius:8px;padding:6px 10px;font-size:12px;line-height:1.6;}",
+	".dkrs-done-title{font-size:12px;font-weight:600;color:var(--dsw-alias-label-secondary);}",
+	// 任务列表
+	".dkrs-tasks{display:flex;flex-direction:column;gap:6px;}",
+	".dkrs-tasks-done{border-top:1px dashed var(--dsw-alias-border-l2);padding-top:6px;}",
+	".dkrs-task{border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:6px 10px;display:flex;flex-direction:column;gap:3px;}",
+	".dkrs-task-head{display:flex;align-items:center;gap:8px;min-width:0;}",
+	".dkrs-task-title{font-size:12px;font-weight:600;color:var(--dsw-alias-label-primary);flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}",
+	".dkrs-task-meta{display:flex;gap:10px;flex-wrap:wrap;font-size:11px;color:var(--dsw-alias-label-tertiary);}",
+	".dkrs-task-wait{font-size:11px;color:var(--dk-warn);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}",
+	".dkrs-task-err{font-size:11px;color:var(--dsw-alias-state-error-primary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;}",
+	".dkrs-tag{flex:none;font-size:10px;border-radius:999px;padding:0 8px;color:var(--dsw-alias-label-tertiary);border:1px solid var(--dsw-alias-border-l2);}",
+	".dkrs-tag.on{color:var(--dk-accent);border-color:currentColor;}",
+	".dkrs-tag.ok{color:var(--dsw-alias-state-success-primary);border-color:currentColor;}",
+	".dkrs-tag.err{color:var(--dsw-alias-state-error-primary);border-color:currentColor;}",
+	".dkrs-tag.warn{color:var(--dk-warn);border-color:currentColor;}",
+].join("\n");
+
+export const feature = {
+	id: "runstate",
+	name: "运行状态",
+	order: 150,
+	accent: "#38bdf8",
+	description: "任务运行状态一览：进行中任务的阶段 / 耗时 / Token / 等待确认与最近完成记录（只读）",
+	css,
+	View: RunStateView,
+	HomeStat: RunStateStat,
+};

package/index.js

@@ -8,18 +8,22 @@
 //     不含任何具体功能逻辑。
 //
 // 功能清单（宿主半部；客户端菜单次序由 view 模块的 order 字段决定）：
-//   - models      模型设置（v0.3.0）：模型目录读 + 官方配置写
+//   - modelconfig 模型设置（v0.3.0）：模型目录读 + 官方配置写
 //   - visionproxy 图片理解代理（v0.3.1）：纯文本模型收图自动走视觉模型识别
 //   - balance     模型余额（v0.2.0）：各 Provider 账户余额/配额
 //   - tokenlog    用量记录（v0.4.0）：LLM 调用记账与统计（移植自 @wycto/dsh-token-usage）
-//   - animation   任务动画（v0.5.0）：会话任务追踪 + 动效/通知配置持久化（参照 @wycto/dsh-task-pulse）
+//   - animation   任务动画（v0.5.0）：会话任务追踪 + 动效配置持久化（参照 @wycto/dsh-task-pulse）
+//   - notify      任务通知：完成/异常/需确认通知 + 提示音/系统通知/钉钉飞书推送（从任务动画拆出）
+//   - runstate    运行状态：进行中任务与最近完成一览（从任务动画拆出；只读，无配置段）
 //   - mobile-relay 手机接力（未发布）：扫码反向代理接力 + 局域网电脑直连（0.0.0.0）
-import { DOCK_NS, DockConfig, sendJson, readBody } from './src/host-core.js'
+import { DOCK_NS, DockConfig, sendJson, readBody, migrateNotifyConfig, migrateModelsFeatureId } 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'
+import { feature as fNotify } from './features/notify/host.js'
+import { feature as fRunState } from './features/runstate/host.js'
 import { feature as fMobileRelay } from './features/mobile-relay/host.js'
 
 export const name = 'dsh-dock'
@@ -56,18 +60,29 @@ export function apply(ctx) {
     fBalance,
     fTokenlog,
     fAnimation,
+    fNotify,
+    fRunState,
     fMobileRelay,
   ]
 
   const state = new Map()
   for (const f of FEATURES) state.set(f.id, { enabled: false, dispose: null, error: null })
 
-  /** 读宿主侧功能开关表（settings 持久化；settings 未挂载时回退 defaultEnabled）。 */
+  /** 读宿主侧功能开关表（settings 持久化；settings 未挂载时回退 defaultEnabled）。
+   *  兼容别名：宿主侧【模型设置】功能 id 曾叫 models（与客户端 modelconfig 对不上，
+   *  开关永远推不到宿主）；迁移落盘前（异步）在这里读时兜底换算，保证启动开关表
+   *  与 /dsh-dock/features 响应第一时间就是新口径。 */
   function persistedFeatureMap() {
     try {
       const settings = ctx.get('settings')
       const v = settings && typeof settings.get === 'function' ? settings.get(DOCK_NS) : null
-      if (v && typeof v === 'object' && v.features && typeof v.features === 'object') return v.features
+      if (v && typeof v === 'object' && v.features && typeof v.features === 'object') {
+        const map = v.features
+        if (typeof map.models === 'boolean' && typeof map.modelconfig !== 'boolean') {
+          return Object.assign({}, map, { modelconfig: map.models })
+        }
+        return map
+      }
     } catch {
       // settings 未挂载
     }
@@ -107,6 +122,11 @@ export function apply(ctx) {
   let initialTogglesApplied = false
   ctx.inject(['settings'], (sctx) => {
     sctx.settings.register(DOCK_NS, DockConfig, {})
+    // 一次性迁移：通知配置从 animation 段搬到 notify 段（【任务通知】独立成模块）。
+    // 必须在任何面板保存动作之前跑——animation 模块保存时整段写回，旧字段会被覆盖丢失。
+    migrateNotifyConfig(sctx)
+    // 一次性迁移：宿主侧【模型设置】功能 id models → modelconfig（开关表键名对齐客户端）。
+    migrateModelsFeatureId(sctx)
     if (initialTogglesApplied) return
     initialTogglesApplied = true
     const persisted = persistedFeatureMap()

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-dock",
-  "version": "0.9.8",
-  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景、完成/需确认通知与提示音、钉钉/飞书推送，开关独立、配置持久化）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
+  "version": "0.10.0",
+  "description": "DeepSeek Harness 功能坞插件（dsh-dock）：模块化功能中枢——每个功能一个 features/ 模块（可单独提取成包发布，又可经 dockBridge 装回面板）。含用量记录（LLM 调用记账/费用统计）、模型设置、图片理解代理、模型余额、任务动画（19 种运行动画 + 桌面伙伴 3D 场景）、任务通知（完成/异常/需确认通知、提示音、系统通知、钉钉/飞书推送）、运行状态（进行中任务与最近完成一览）；侧栏入口 + 可拖拽弹窗（最大化/最小化/缩放）。",
   "type": "module",
   "main": "index.js",
   "files": [
@@ -40,6 +40,11 @@
   ],
   "author": "wycto",
   "license": "MIT",
+  "scripts": {
+    "build:client": "node scripts/build-client.mjs",
+    "test:client": "node scripts/test-client-views.mjs",
+    "test:host": "node scripts/test-task-host.mjs"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wycto/dsh-dock.git"

package/src/client.jsx

@@ -24,14 +24,16 @@ 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";
+import { feature as fNotify } from "../features/notify/view.jsx";
+import { feature as fRunState } from "../features/runstate/view.jsx";
 import { feature as fGames } from "../features/games/view.jsx";
 import { feature as fMobileRelay } from "../features/mobile-relay/view.jsx";
 
 const name = "dsh-dock";
-const DOCK_VERSION = "0.9.7";
+const DOCK_VERSION = "0.10.0";
 
 // ---- 内置功能注册表：新功能 = features/<id>/ 加模块 + 这里 import 一行 ----
-const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fGames, fMobileRelay];
+const BUILTIN_FEATURES = [fTokenlog, fModelconfig, fHeartbeat, fTheme, fBalance, fAnimation, fNotify, fRunState, fGames, fMobileRelay];
 // 规划占位（路线图）：接入后移除并建 features/<id>/ 模块
 const PLANNED_FEATURES = [];
 const PLANNED_NOTES = {};
@@ -357,12 +359,14 @@ function DockModal() {
 	const isHome = active === "home";
 	const mod = isHome ? null : (MODULES.find((m) => m.id === active) || MODULES[0]);
 	const st = mod ? stateOf(mod.id) : null;
-	// 外部包视图包错误边界；视图统一收到 { ctx, feature, params } props
+	// 视图统一收到 { ctx, feature, params } props
 	//（params 来自导航总线：如 { provider } 高亮余额行、{ sessionId } 按会话筛选用量）
 	const View = mod ? mod.View : null;
+	// 所有视图都包错误边界（含内置）：视图抛错只降级为一行提示，不能把整块面板打没。
+	// key 用 mod.id：切换功能时重建边界，避免上一个功能的错误态留在新页面上。
 	const viewNode = mod && View
 		? react.createElement("div", { className: "dockm-view" },
-			react.createElement(mod.external ? FeatureBoundary : react.Fragment, null,
+			react.createElement(FeatureBoundary, { key: mod.id, label: mod.name },
 				react.createElement(View, { ctx: ctxRef.current, feature: mod, params: navParams })))
 		: null;
 	const enabledCount = MODULES.filter((m) => { const s = stateOf(m.id); return !!(s && s.enabled); }).length;
@@ -500,7 +504,7 @@ function HomeView(props) {
 			const statNode = m.planned
 				? react.createElement("span", null, PLANNED_NOTES[m.id] || "待接入：见 README 路线图")
 				: enabled && Stat
-					? react.createElement(m.external ? FeatureBoundary : react.Fragment, null,
+					? react.createElement(FeatureBoundary, { key: m.id, label: m.name },
 						react.createElement(Stat, { ctx: ctx }))
 					: react.createElement("span", null, "已停用，启用后在此展示运行概要");
 			return react.createElement("div", {
@@ -560,7 +564,7 @@ function DockPanel() {
 			const View = f.View;
 			const viewNode = (!f.planned && st.enabled && View)
 				? react.createElement("div", { className: "dock-body" },
-					react.createElement(f.external ? FeatureBoundary : react.Fragment, null,
+					react.createElement(FeatureBoundary, { key: f.id, label: f.name },
 						react.createElement(View, { ctx: ctx, feature: f })))
 				: null;
 			return react.createElement("div", { className: "dock-card", key: f.id },
@@ -608,17 +612,18 @@ function DockChips(props) {
 	const items = [];
 	for (const f of allModules()) {
 		if (f.planned || !stateOf(f.id).enabled || !chipShown(f.id) || typeof f.Chip !== "function") continue;
-		items.push(react.createElement(f.Chip, {
-			key: f.id, ctx: props.ctx, feature: f,
-			session: props.session, sessionId: props.sessionId, input: props.input,
-		}));
+		items.push(react.createElement(FeatureBoundary, { key: f.id, label: f.name },
+			react.createElement(f.Chip, {
+				ctx: props.ctx, feature: f,
+				session: props.session, sessionId: props.sessionId, input: props.input,
+			})));
 	}
 	if (items.length === 0) return null;
 	return react.createElement("div", { className: "dockchip-row" }, items);
 }
 
 // ---- 功能全局浮层：模块可在描述符上挂 Overlay 组件（props: { ctx, feature }） ----
-// 与 Chip（会话输入区小控件）不同，Overlay 是常驻整页挂载的全局 UI（如任务动画的动效与通知栈），
+// 与 Chip（会话输入区小控件）不同，Overlay 是常驻整页挂载的全局 UI（如任务动画的动效、任务通知的卡片栈），
 // 只要所属功能启用就渲染（功能停用即卸载，浮层自身负责按数据状态决定显示什么）。
 function FeatureOverlays() {
 	const [, force] = react.useReducer((n) => n + 1, 0);
@@ -627,7 +632,7 @@ function FeatureOverlays() {
 	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 },
+		items.push(react.createElement(FeatureBoundary, { key: f.id, label: f.name },
 			react.createElement(f.Overlay, { ctx: ctxRef.current, feature: f })));
 	}
 	if (items.length === 0) return null;

package/src/host-core.js

@@ -5,7 +5,8 @@ import z from '@deepseek-ai/schemastery'
 /** dsh-dock 自有 settings 命名空间（插件级配置，如图片理解代理）。 */
 export const DOCK_NS = 'dsh-dock'
 
-/** 自有命名空间的 schema（功能开关 + 图片理解代理 + 任务动画配置 + 远程访问账号）。 */
+/** 自有命名空间的 schema（功能开关 + 图片理解代理 + 任务动画/任务通知配置 + 远程访问账号）。
+ *  运行状态模块只读共享追踪、不写配置，因此没有自己的段。 */
 export const DockConfig = z.object({
   // 宿主侧功能开关（id -> boolean）：客户端面板 toggle 即时同步过来，
   // 重启 dsh 后按此表决定宿主半部 setup 哪些功能（路由注册、事件订阅等）。
@@ -21,13 +22,18 @@ export const DockConfig = z.object({
     provider: z.string().default(''),
     model: z.string().default(''),
   }).default({}),
+  // 【任务动画】模块：只放动画本身（动效开关/模式/桌面伙伴大小）。
+  // 通知相关的字段已全部迁往下面的 notify 段（见 migrateNotifyConfig）；
+  // 旧值不在 schema 里也会被 schemastery 原样保留，迁移读得到。
   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),
+  }).default({}),
+  // 【任务通知】模块：页内卡片 / 提示音 / 浏览器系统通知 / 群机器人推送。
+  // 模块自身的启停由 features.notify 开关负责（独立菜单项），这里只放通知行为配置。
+  notify: z.object({
     notifyOnComplete: z.boolean().default(true),
     notifyOnError: z.boolean().default(true),
     // 工具等待用户确认/批准时提醒（dsh 会话流 approval/asked → decided）
@@ -46,9 +52,74 @@ export const DockConfig = z.object({
     // 飞书群机器人推送（宿主侧直发，浏览器关着也能推；事件跟随 notifyOnComplete/notifyOnError）
     feishuEnabled: z.boolean().default(false),
     feishuWebhook: z.string().default(''),
+    // 一次性迁移标记：animation 段的旧通知配置已搬到本段（搬完置 true，避免每次启动重复写）
+    migratedFromAnimation: z.boolean().default(false),
   }).default({}),
 })
 
+/** 通知配置字段清单（schema、迁移、客户端默认值三处共用同一份键名）。 */
+export const NOTIFY_FIELDS = [
+  'notifyOnComplete', 'notifyOnError', 'notifyOnConfirm', 'notifyStayMs',
+  'systemNotify', 'soundNotify', 'soundEffect',
+  'dingtalkEnabled', 'dingtalkWebhook', 'feishuEnabled', 'feishuWebhook',
+]
+
+/**
+ * 一次性迁移：通知配置从 settings 的 animation 段搬到 notify 段
+ * （【任务通知】独立成功能模块，配置也该由它自己拥有）。
+ *
+ * 为什么必须搬：animation 模块保存配置时整段写回，旧字段会被覆盖丢失；
+ * 迁移在插件加载时（settings 注册回调里）先跑，早于任何面板保存动作。
+ * 取值规则：animation 段的旧值优先（拆分前它就是用户的真实选择），notify 段保留其余键。
+ */
+export async function migrateNotifyConfig(ctx) {
+  try {
+    const settings = ctx.get('settings')
+    if (!settings || typeof settings.get !== 'function' || typeof settings.mutate !== 'function') return
+    const root = settings.get(DOCK_NS)
+    const notify = root && typeof root === 'object' && root.notify && typeof root.notify === 'object' ? root.notify : null
+    if (notify && notify.migratedFromAnimation === true) return
+    const animation = root && typeof root === 'object' && root.animation && typeof root.animation === 'object' ? root.animation : null
+    const legacy = {}
+    let copied = 0
+    for (const key of NOTIFY_FIELDS) {
+      if (animation && animation[key] !== undefined) { legacy[key] = animation[key]; copied++ }
+    }
+    // 没有可搬的旧字段（全新安装 / 已搬完）就不写盘，也不置标记——
+    // 避免 settings 命名空间尚未生效时误把「空迁移」当完成（那会丢掉旧配置）。
+    if (copied === 0) return
+    const next = Object.assign({}, notify || {}, legacy, { migratedFromAnimation: true })
+    await settings.mutate(DOCK_NS, [{ op: 'set', path: ['notify'], value: next }])
+    console.log('[dsh-dock] notify config migrated from animation section; fields copied:', copied)
+  } catch (e) {
+    console.warn('[dsh-dock] notify config migration skipped:', (e && e.message) || String(e))
+  }
+}
+
+/**
+ * 一次性迁移：宿主侧【模型设置】功能 id 从 models 改为 modelconfig（与客户端视图 id 对齐）。
+ *
+ * 为什么必须迁：面板开关按客户端 id（modelconfig）POST /dsh-dock/features，
+ * 旧宿主 id 叫 models → 永远「未知功能」404（客户端静默吞掉），开关表里因此
+ * 只可能出现 API 手工写入的 models 键。新键未落盘时继承旧值并删掉旧键；
+ * 判断条件本身幂等（迁完后 models 键不存在，直接早退），无需额外标记位。
+ */
+export async function migrateModelsFeatureId(ctx) {
+  try {
+    const settings = ctx.get('settings')
+    if (!settings || typeof settings.get !== 'function' || typeof settings.mutate !== 'function') return
+    const root = settings.get(DOCK_NS)
+    const features = root && typeof root === 'object' && root.features && typeof root.features === 'object' ? root.features : null
+    if (!features || typeof features.models !== 'boolean' || typeof features.modelconfig === 'boolean') return
+    const next = Object.assign({}, features, { modelconfig: features.models })
+    delete next.models
+    await settings.mutate(DOCK_NS, [{ op: 'set', path: ['features'], value: next }])
+    console.log('[dsh-dock] feature id migrated: features.models -> features.modelconfig =', features.models)
+  } catch (e) {
+    console.warn('[dsh-dock] models feature id migration skipped:', (e && e.message) || String(e))
+  }
+}
+
 /** 任务动画 effectMode 合法值（客户端动画模式）。 */
 export const ANIMATION_MODES = [
   'flow', 'breathe', 'ring', 'orbit', 'robot', 'matrix', 'stars', 'aurora', 'space',