dsh-notify-yimit 0.2.0 → 0.2.2

package/README.en.md

@@ -17,7 +17,7 @@
 A notification plugin for DeepSeek Harness: alerts you on **task completed / task failed / running (live activity) / awaiting approval / awaiting answer**.
 
 - **Two notification styles**, switchable in Settings: **Windows system notifications** (native browser notifications) or **custom in-app notifications** (a toast at the bottom-right of the desktop, independent of the browser page); or turn everything **off** (default).
-- **The notification title is the conversation title** (updated in place once the LLM generates it; the workspace directory name is never used). Toasts offer **Ignore**, and on the web also **Jump to session** (see below).
+- **The notification title is the conversation title** (updated in place once the LLM generates it; the workspace directory name is never used). Toasts offer **Ignore**, on the web also **Jump to session**, and on the desktop also **Go to app** (see below).
 - **One codebase for desktop and web**: the host detects its platform from the runtime and hides only browser-facing entry points — notification behavior is identical.
 - **Settings-page integration**: DSH Settings → "Notifications" section with a master switch, notification style, toast count/duration, and per-type background/text colors (done = green, failed = red, running = blue, approval = yellow, question = purple).
 
@@ -38,11 +38,12 @@ A notification plugin for DeepSeek Harness: alerts you on **task completed / tas
   - Custom notifications: **max simultaneously visible**, **display duration**, and a **per-type background/text color** list
     (done = green, failed = red, running = blue, approval = yellow, question = purple; each customizable);
   - The custom-settings block animates open/closed; system notifications offer one-click permission request.
-- **Custom notification = desktop toast (independent of the browser)**: the host plugin spawns a **resident PowerShell + WPF host process** that pops borderless, always-on-top toasts at the **bottom-right** of the screen (multiple toasts stack upward without overlapping). Each toast has a title, body, and an **Ignore** button (**web only: plus a "Jump to session" button**; 10px rounded-rect buttons), colored per type from the config. Done/failed toasts auto-dismiss after the display duration; **running/approval/question toasts stay until their state ends** (turn end / decision made / answer given). Running content is **updated in place** (400ms throttle — no re-spawn, no flicker); approval/question are stateful and **not debounced** (multiple approvals/questions within 2s are never swallowed). Whether the browser page is open or minimized does not matter. Until the session title arrives (LLM-generated asynchronously — first-turn events precede the title event), toasts show a localized placeholder ("(Unnamed session)"); when the `session/title` event lands, **the titles of already-shown toasts are updated in place** — the workspace directory name is never used.
+- **Custom notification = desktop toast (independent of the browser)**: the host plugin spawns a **resident PowerShell + WPF host process** that pops borderless, always-on-top toasts at the **bottom-right** of the screen (multiple toasts stack upward without overlapping). Each toast has a title, body, and an **Ignore** button (**web only: plus a "Jump to session" button**; **desktop only: plus a "Go to app" button**; 10px rounded-rect buttons), colored per type from the config. Done/failed toasts auto-dismiss after the display duration; **running/approval/question toasts stay until their state ends** (turn end / decision made / answer given). Running content is **updated in place** (400ms throttle — no re-spawn, no flicker); approval/question are stateful and **not debounced** (multiple approvals/questions within 2s are never swallowed). Whether the browser page is open or minimized does not matter. Until the session title arrives (LLM-generated asynchronously — first-turn events precede the title event), toasts show a localized placeholder ("(Unnamed session)"); when the `session/title` event lands, **the titles of already-shown toasts are updated in place** — the workspace directory name is never used.
 - **Resident host architecture**: the plugin starts one `powershell` host process (`toast-host.ps1`) on load; WPF is loaded only once and every toast is created inside that process — toast creation latency drops from ~1s cold start to ~10ms. The host receives one JSON command per line on **stdin** (`show`/`text`/`title`/`move`/`close`/`shutdown`) and reports `pos`/`exit` on **stdout**; no per-toast process spawn and no ctl/pos file polling.
 - **Jump to session (web only)**: clicking a system notification or the toast's "Jump to session" button opens the browser and navigates to the session (via the URL hash convention `#dsh-notify-yimit/session=<id>`, listened to by the client; optionally with a specific browser). **The desktop app does not show that button** — opening a browser from inside the desktop app is redundant.
+- **Go to app (desktop only)**: the "Go to app" button (right of "Ignore") brings the running desktop window to the foreground. The **host process enumerates windows and activates it itself** (locating PIDs by the app executable path, picking that process's top-level window, then `ShowWindow(SW_RESTORE)` + `SetForegroundWindow`). It deliberately does **not** use the app's registered `dsh://open` protocol: the app only handles that URL in its **macOS `open-url`** event, while on Windows a protocol URL arrives as an argv argument and the app's `second-instance` handler neither reads argv nor checks the URL — that path is dead code on Windows. Window selection is tiered (visible + titled + unowned → titled + unowned → titled), so it still finds the main window when the app is **minimized to tray or covered**. The host is the foreground process at click time, so the "only the foreground process may steal focus" restriction does not apply. **Clicking it does not dismiss the toast** (unlike the other buttons); if no window can be located it silently does nothing.
 - **Runtime-aware UI**: the host detects its platform from the runtime (Electron runtime = desktop, plain Node = web) and adapts the UI:
-  - desktop: toasts omit the "Jump to session" button; the settings page hides the jump browser picker and the "system notifications come from the browser / custom toasts sit at the bottom-right" explainer;
+  - desktop: toasts omit the "Jump to session" button and show "Go to app" instead; the settings page hides the jump browser picker and the "system notifications come from the browser / custom toasts sit at the bottom-right" explainer;
   - web: everything stays visible.
 - **System notifications**: native browser notifications; clicking one focuses the window and opens the session.
 - **Requirements**: Windows (PowerShell 5.1+, built-in); custom desktop toasts need no extra dependencies.

package/README.md

@@ -45,7 +45,8 @@ DeepSeek Harness 通知插件:在 **任务完成 / 任务出错 / 运行中(实
   - 自定义设置区块显隐带过渡动画;系统通知可一键申请浏览器通知权限。
 - **自定义通知 = 桌面浮窗(不依赖浏览器)**:宿主插件通过**常驻 PowerShell + WPF 宿主进程**
   在屏幕**右下角**弹出无边框置顶浮窗(多浮窗自动向上堆叠不重叠),标题、内容、**忽略**按钮
-  (**web 端另有「跳转会话」按钮**,按钮为圆角矩形 10px);按通知类型使用对应配置的背景/文字色。完成/出错
+  (**web 端另有「跳转会话」按钮**,**桌面端另有「返回应用」按钮**,按钮为圆角矩形 10px);
+  按通知类型使用对应配置的背景/文字色。完成/出错
   按显示时长后自动消失;**运行中/待审批/待回答在状态结束前不会消失**(任务结束/审批决定/
   回答完成后自动关闭)。运行中内容**原地更新文本**(400ms 节流,不重弹、不闪烁);
   待审批/待回答为状态性通知,**不做防抖**(2s 内多条审批/提问不会被吞)。浏览器页面是否
@@ -59,9 +60,18 @@ DeepSeek Harness 通知插件:在 **任务完成 / 任务出错 / 运行中(实
 - **跳转会话(仅 web 端)**:系统通知点击 / 自定义浮窗「跳转会话」按钮 → **打开浏览器**并定位到该会话
   (通过 URL hash 约定 `#dsh-notify-yimit/session=<id>`,客户端监听后切换;可用所选浏览器打开)。
   **桌面端(App)不显示该按钮**——在桌面应用里再打开浏览器属于多余动作。
+- **返回应用(仅桌面端)**:浮窗「忽略」右侧的「返回应用」按钮把已运行的桌面窗口切到前台。
+  实现是**宿主进程自己枚举窗口并激活**(按应用可执行文件路径定位 PID,再挑出该进程的顶层窗口,
+  `ShowWindow(SW_RESTORE)` + `SetForegroundWindow`)。之所以不用应用已注册的 `dsh://open` 协议:
+  应用只在 **macOS 的 `open-url` 事件**里处理该 URL,Windows 上协议 URL 是作为 argv 交给新进程的,
+  而它的 `second-instance` 处理器不读 argv、也不校验 URL —— 那条路在 Windows 上是死代码。
+  窗口挑选分三级(可见+有标题+非 owner → 有标题+非 owner → 有标题),因此**最小化到托盘、
+  被其他窗口遮挡**时同样能找到主窗口。宿主被点击的那一刻本就是前台进程,所以不受
+  "仅前台进程可抢占前台"的限制。**点击后不关闭该通知**,浮窗保留(与其他按钮不同);
+  定位不到窗口时静默无动作。
 - **运行环境自适应**:宿主按运行时自动判定平台(Electron 运行时 = 桌面端,普通 Node = web 端),
   并据此调整界面:
-  - 桌面端:浮窗隐藏「跳转会话」按钮;设置页隐藏「跳转浏览器选择器」与"系统通知由浏览器弹出/
+  - 桌面端:浮窗隐藏「跳转会话」按钮、改为显示「返回应用」按钮;设置页隐藏「跳转浏览器选择器」与"系统通知由浏览器弹出/
     自定义为桌面右下角浮窗"那段说明;
   - web 端:全部保留。
 - **系统通知**:浏览器原生通知,点击通知即聚焦窗口并打开对应会话。

package/lib/index.js

@@ -96,11 +96,13 @@ const TOAST_LABELS = {
 	zh: {
 		ignore: '忽略',
 		jump: '跳转会话',
+		activate: '返回应用',
 		unnamed: '(未命名会话)'
 	},
 	en: {
 		ignore: 'Ignore',
 		jump: 'Open',
+		activate: 'Go to app',
 		unnamed: '(Unnamed session)'
 	}
 }
@@ -114,6 +116,12 @@ const EDIT_TITLES = {
 	en: 'Notification preview'
 }
 
+/** 编辑模式基准线说明(中/英):基准线下方画 ↑,表示通知从该位置往上堆叠。 */
+const EDIT_ANCHOR_LABELS = {
+	zh: '通知以该位置为基准,均在此线上方',
+	en: 'Toasts anchor here and stack upward'
+}
+
 const HEX_RE = /^#[0-9a-fA-F]{3,8}$/
 const isHex = (v) => typeof v === 'string' && HEX_RE.test(v)
 
@@ -154,6 +162,14 @@ function normalizeConfig(input) {
 			left: Math.round(pos.left),
 			top: Math.round(pos.top)
 		}
+		// 兼容旧版已保存的坐标。旧版语义混乱:position.top 被当作"样板窗窗口顶边",
+		// 而通知也按"窗口顶边 = pos.top"落位;新版统一为"可见卡片底边 = pos.top"。
+		// 两者相差(卡片高 + GLOW),故对没有新标记的旧数据整体下移这么多。
+		// (此处拿不到真实卡片高,用默认值估;用户重新拖动一次即精确。)
+		if (srcToast.posAtBaseline !== true) {
+			out.toast.position.top = Math.round(out.toast.position.top + DEFAULT_WINDOW_H - TOAST_BOTTOM_GAP)
+		}
+		out.toast.posAtBaseline = true
 	}
 
 	const srcColors = src.colors !== null && typeof src.colors === 'object' && !Array.isArray(src.colors) ? src.colors :
@@ -287,8 +303,45 @@ function openConfig() {
 const MAX_QUEUE = 500
 const RUNNING_THROTTLE_MS = 400
 const KIND_DEBOUNCE_MS = 2000
-/** 通知间距默认值(px);实际使用 config.toast.gap(0–60,可调)。 */
+/** 通知间距默认值(px,指"可见卡片边到边"的间距);实际使用 config.toast.gap(0–60,可调)。 */
 const TOAST_GAP = 12
+/**
+ * 每个通知窗口四周的透明辉光边距(px),必须与 toast-host.ps1 里
+ * New-ToastWindow 的 `$border.Margin = Thickness(12)` 保持一致。
+ *
+ * 实测(两条通知同锚点堆叠):卡片可见矩形 = 窗口内缩 GLOW,
+ * 即 窗口高 = 可见卡片高 + 2×GLOW。因此
+ *   · 某条的"可见卡片高" = 窗口高 − 2×GLOW;
+ *   · 堆叠间距直接用用户设置的 gap 即可 —— 因为相邻两条的"窗口间距离"
+ *     里已经含了 2×GLOW 的透明边距,而它们是被计入 offsetY 的可见高度吸收的。
+ * 关键是 gap 绝不能再减去 2×GLOW:那样 gap ≤ 24 时会算出 0 间距,
+ * 用户看到的默认 12px 就变成"卡片贴在一起"(实测复现过)。
+ */
+const TOAST_GLOW = 12
+/** 默认右下角排布时,最新那条"可见卡片底边"距工作区底边的留白(px);须与宿主一致。 */
+const TOAST_EDGE_PAD = 20
+/**
+ * 通知窗口内"可见卡片底边"到**窗口底边**的距离(px),须与 toast-host.ps1 的
+ * $script:TOAST_BOTTOM_GAP 一致(实测 = 12,即窗口四周的辉光边距)。
+ * 底部锚定公式(注意含"窗口高",不能用固定值):
+ *     窗口顶边 = 锚点Y − (窗口高 − TOAST_BOTTOM_GAP) − offsetY
+ * ⇒ 卡片可见底边 = 锚点Y − offsetY,与内容高度无关。
+ */
+const TOAST_BOTTOM_GAP = 12
+/**
+ * 迁移旧配置时估算用的"通知窗口总高"(px),≈ 卡片高 110 + 2×辉光 24。
+ * 真实高度由宿主回传,这里只在读旧配置时用作回落值。
+ */
+const DEFAULT_WINDOW_H = 134
+/**
+ * 堆叠时相邻两条之间的"窗口间"间距。
+ *
+ * 直接用用户设置的 gap —— 不要再减去 2×TOAST_GLOW:
+ * offsetY 累加的是"可见卡片高 + 间距",可见卡片高已经把两侧透明辉光吸收掉了,
+ * 所以 gap 就是肉眼看到的卡片间距。若在此处再减 2×GLOW,gap ≤ 24 时会被夹成 0,
+ * 默认的 12px 就变成"卡片严丝合缝贴在一起"(实测复现过)。
+ */
+const stackGap = (gap) => Math.max(0, gap)
 const TEXT_MAX = 300
 
 function clip(text) {
@@ -532,12 +585,21 @@ export function apply(ctx) {
 				} else if (msg.type === 'geometry' && typeof msg.left === 'number' && typeof msg.top ===
 					'number') {
 					// 编辑模式:样板窗拖拽/缩放结束 → 写回配置,并应用到在屏浮窗。
+					//
+					// 坐标口径:宿主回传的 msg.top 就是"基准线(卡片可见底边)的屏幕 Y"。
+					// 宿主定位时用的是同一个口径($win.Top = pos.top − lineInWin),
+					// 所以"存下的值"与"重开时的落点"必然一致,不会漂移。
+					// 注意不要再自己加 msg.baselineTop:那是"基准线从窗口顶边算起的偏移",
+					// 只为调试/换算提供,加进去会重复计入一个卡片高。
 					const width = Math.max(260, Math.min(520, Math.round(Number(msg.width) || 340)))
 					const left = Math.round(Number(msg.left))
+					// position.top 一律存"基准线的屏幕 Y";posAtBaseline 标记供
+					// normalizeConfig 区分新旧坐标(旧数据语义不同,需迁移)。
 					const top = Math.round(Number(msg.top))
 					store.set({
 						toast: {
 							width,
+							posAtBaseline: true,
 							position: {
 								left,
 								top
@@ -617,19 +679,27 @@ export function apply(ctx) {
 		const cfg = store.get()
 		const pos = cfg.toast?.position ?? null
 		const gap = typeof cfg.toast?.gap === 'number' ? cfg.toast.gap : TOAST_GAP
+		// 窗口排布间距:扣除两侧透明辉光边距,使"可见卡片间距"真正等于用户设置的 gap。
+		const boxGap = stackGap(gap)
 		if (pos !== null) {
-			// 自定义位置:position.top 是"第一个(最新,最底部)浮窗的顶边",向上堆叠。
-			// 与宿主 Loaded 的 targetTop = pos.top - offsetY 语义一致,否则重排会把
-			// 浮窗再上移一个自身高度(先正确、随即上移的 bug)。横向同步 position.left,
-			// 编辑调整位置后,在屏浮窗立即左右移动到位。
-			let prevTop = pos.top
-			let first = true
+			// 自定义位置:锚点(pos.top,即编辑模式那条基准线)对应"最新那条的可见卡片底边"。
+			// 这是底部锚定 —— 无论通知内容多长、卡片多高,底边都恒定落在基准线上,
+			// 只有顶边随内容浮动。
+			//
+			// 定位公式必须与宿主 New-ToastWindow 的 Loaded 完全一致,否则宿主先落位、
+			// 这里再校正,两者会互相打架(表现为浮窗抖动或被推错位):
+			//     窗口顶边 = pos.top − (窗口高 − TOAST_BOTTOM_GAP) − offsetY
+			// "窗口高"用每条自己回传的 meta.height —— 卡片高度随内容变化,写死会让
+			// 长内容的底边偏离锚点。offsetY = 该条之上已叠的高度(第 0 位为 0)。
+			// 横向同步 position.left,编辑调整位置后,在屏浮窗立即左右移动到位。
+			let offset = 0
 			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 height = rec.meta?.height ?? DEFAULT_WINDOW_H
+				const newTop = Math.round(pos.top - (height - TOAST_BOTTOM_GAP) - offset)
+				// 累积"本条之上"的高度:可见卡片高(= 窗口高 − 2×辉光)+ gap
+				offset += Math.max(0, height - 2 * TOAST_GLOW) + boxGap
 				const needsTop = rec.meta !== null && newTop !== rec.meta.top
 				const needsLeft = rec.meta !== null && rec.meta.left !== pos.left
 				if (needsTop || needsLeft) {
@@ -645,19 +715,19 @@ export function apply(ctx) {
 					}
 					sendCmd(move)
 				}
-				prevTop = newTop
 			}
 			return
 		}
-		// 默认右下:底边对齐(工作区底边 - 20),向上堆叠;横向回默认贴边(left 'default'),
-		// 覆盖"恢复默认位置/改宽度后需回到右下角"的场景。
+		// 默认右下:最新那条的"可见卡片底边"距工作区底边 TOAST_EDGE_PAD,向上堆叠;
+		// 横向回默认贴边(left 'default'),覆盖"恢复默认位置/改宽度后需回到右下角"的场景。
+		// 与宿主默认分支同式:窗口顶边 = 工作区底边 − TOAST_EDGE_PAD − (窗口高 − TOAST_BOTTOM_GAP) − offsetY。
 		if (globalWorkBottom === null) return
-		let cursor = globalWorkBottom - 20
+		let offset = 0
 		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(cursor - height)
+			const height = rec.meta?.height ?? DEFAULT_WINDOW_H
+			const newTop = Math.round(globalWorkBottom - TOAST_EDGE_PAD - (height - TOAST_BOTTOM_GAP) - offset)
 			if (rec.meta !== null && newTop !== rec.meta.top) {
 				rec.meta.top = newTop
 				sendCmd({
@@ -667,7 +737,7 @@ export function apply(ctx) {
 					left: 'default'
 				})
 			}
-			cursor = newTop - gap
+			offset += Math.max(0, height - 2 * TOAST_GLOW) + boxGap
 		}
 	}
 
@@ -745,10 +815,18 @@ export function apply(ctx) {
 		}
 		const insertIndex = replaceIndex !== -1 ? replaceIndex : 0
 		const gap = typeof cfg.toast?.gap === 'number' ? cfg.toast.gap : TOAST_GAP
+		const boxGap = stackGap(gap)
+		// 宿主首帧落位用的偏移量,语义 = "该条之上已经叠了多少高度(px)"。
+		// 宿主按底部锚定定位:窗口顶边 = 锚点Y − 卡片可见高 − offsetY,
+		// 于是该条"可见卡片底边 = 锚点Y − offsetY"。所以:
+		//   · 第 0 位(最下方那条)上方没有任何东西 → offsetY 必须为 0;
+		//   · 其余位置 = Σ(上方各条的可见卡片高 + gap)。
+		// 每条只吃自己的高度,永远不需要预测新条自己的高度。
 		let offsetY = 0
 		for (let i = 0; i < insertIndex; i += 1) {
 			const r = activeToasts.get(toastOrder[i])
-			offsetY += (r?.meta?.height ?? 130) + gap
+			// 上方每一条贡献"可见卡片高 + gap";可见卡片高 = 窗口高 − 2×辉光。
+			offsetY += Math.max(0, (r?.meta?.height ?? 130) - 2 * TOAST_GLOW) + boxGap
 		}
 
 		const lang = cfg.locale === 'zh' ? 'zh' : 'en'
@@ -774,6 +852,13 @@ export function apply(ctx) {
 			jumpLabel: l.jump,
 			// 桌面端隐藏「跳转会话」按钮(该按钮会打开浏览器,在桌面端内多余)
 			jumpEnabled: isDesktopRuntime !== true,
+			// 「返回应用」只在桌面端有意义:把已在运行的桌面窗口切到前台。
+			// 实现是宿主侧枚举窗口 + SetForegroundWindow —— 不能用 dsh://open:
+			// 应用只在 macOS 的 open-url 事件里处理该 URL,Windows 上协议 URL 是以
+			// argv 交给新进程的,而 second-instance 处理器不读 argv,那条路是死代码。
+			// 因此把应用可执行文件路径一并下发,供宿主按进程定位窗口。
+			activateLabel: isDesktopRuntime === true ? l.activate : '',
+			appPath: isDesktopRuntime === true ? String(process.execPath ?? '') : '',
 			unnamedLabel: l.unnamed,
 			// 通知窗口样式:宽度 + 自定义位置(null = 默认右下贴边)
 			width: cfg.toast?.width ?? 340,
@@ -1162,6 +1247,8 @@ export function apply(ctx) {
 			sendCmd({
 				cmd: 'edit',
 				title: EDIT_TITLES[lang],
+				// 基准线提示文案:告诉用户"通知以该位置为基准、均在此线上方"
+				anchorLabel: EDIT_ANCHOR_LABELS[lang],
 				width: cfg.toast?.width ?? 340,
 				position: cfg.toast?.position ?? null,
 				// 新增：类型色卡数组，样板窗内做预览

package/lib/toast-host.ps1

@@ -59,23 +59,169 @@ function Add-GridRow($grid) {
 }
 
 # 编辑模式几何回传:样板窗当前 left/top/width/height(工作区相对坐标)。
+# 样板窗额外回传 baselineTop = 基准线(卡片可见底边)在窗口内的 Y 偏移,
+# 供前端把它换算成屏幕坐标存进配置。
 function Send-Geometry($w) {
     try {
         $work = [System.Windows.SystemParameters]::WorkArea
-        Send-Report @{
-            type   = 'geometry'
-            left   = [Math]::Round($w.Left - $work.Left)
-            top    = [Math]::Round($w.Top - $work.Top)
-            width  = [Math]::Round($w.ActualWidth)
-            height = [Math]::Round($w.ActualHeight)
+        $lineInWin = 0.0
+        if ($w.Tag -is [hashtable] -and $null -ne $w.Tag.lineInWin) {
+            $lineInWin = [double]$w.Tag.lineInWin
         }
+        # ── 坐标口径必须与"重开时的定位口径"完全一致 ──
+        # 定位时:$win.Top = $pos.top − lineInWin(即 $pos.top 是基准线的屏幕 Y)。
+        # 因此这里回传的 top 也必须是**基准线的屏幕 Y**,而不是窗口顶边:
+        #     top = 窗口顶边 + lineInWin
+        # 若回传窗口顶边,index.js 再把它当基准线存下来,就会出现
+        # "每进一次编辑模式基准线就往下漂一个带高"的问题(实测复现过)。
+        # baselineTop 仍回传"基准线从窗口顶边算起的偏移",供前端换算/调试。
+        $msg = @{
+            type        = 'geometry'
+            left        = [Math]::Round($w.Left - $work.Left)
+            top         = [Math]::Round($w.Top - $work.Top + $lineInWin)
+            width       = [Math]::Round($w.ActualWidth)
+            height      = [Math]::Round($w.ActualHeight)
+            baselineTop = [Math]::Round($lineInWin)
+        }
+        Send-Report $msg
     } catch { }
 }
 
 # ───────────────────────── 编辑模式样板窗 ─────────────────────────
 
+# 基准线指示带固定高度(px):横线(2) + 3px 间距 + 箭头(19) + 2px 余量。
+# 固定值而非 Auto:基准线到窗口底边的距离必须可预测,否则回传的基准线位置
+# 会随字体度量浮动、与实际画的那条线对不上(编辑模式靠它反推窗口落点)。
+$script:ANCHOR_BAND_H = 26
+
+# 通知窗口内"可见卡片底边"到**窗口底边**的距离(px)。
+# 实测地推:卡片底边 = 窗口顶边 + (窗口高 − 12);该 12 即 $border.Margin 的辉光边距。
+# 注意它是"到窗口底边"的距离,不是"到窗口顶边"的偏移 —— 因此底部锚定的抬升量
+# 必须写成 (窗口高 − TOAST_BOTTOM_GAP),随卡片高度自适应,绝不能写成固定值:
+#     窗口顶边 = 锚点Y − (窗口高 − TOAST_BOTTOM_GAP) − offsetY
+# 这样"卡片可见底边 = 锚点Y − offsetY",内容多长底边都钉在锚点上。
+$script:TOAST_BOTTOM_GAP = 12
+
+# 箭头用矢量多边形而非字体字形绘制:字形自带行距死区(上/下各数 px),
+# 会把箭头推离横线、甚至溢出窗口被裁切;矢量图形能精确对齐到横线。
+$script:ANCHOR_ARROW_W = 14
+$script:ANCHOR_ARROW_H = 19
+$script:ANCHOR_ARROW_GAP = 3
+
+# 构造向上的空心箭头(chevron)多边形:顶点在正上方,两翼向下张开。
+# 返回 PointCollection,坐标系原点在箭头外接框左上角。
+function New-AnchorArrowPoints([double]$w, [double]$h) {
+    $hw = $w / 2.0
+    $th = [Math]::Max(2.0, $h * 0.45)          # 两翼的竖直厚度
+    $tip = $hw * 0.62                           # 翼尖相对中轴的横向偏移
+    $notch = $h * 0.42                          # 内凹点深度(形成空心)
+    # 注意:PowerShell 中 `-` 与 `*` 的优先级容易误读,复合运算一律加括号。
+    $pts = New-Object System.Windows.Media.PointCollection
+    $pts.Add((New-Object System.Windows.Point($hw, 0)))                        # 顶点(贴住横线)
+    $pts.Add((New-Object System.Windows.Point($w, $th)))                       # 右翼外侧
+    $pts.Add((New-Object System.Windows.Point(($w - ($hw - $tip)), ($th + $tip))))  # 右翼尖端
+    $pts.Add((New-Object System.Windows.Point($hw, $notch)))                   # 内凹点
+    $pts.Add((New-Object System.Windows.Point(($hw - $tip), ($th + $tip))))    # 左翼尖端
+    $pts.Add((New-Object System.Windows.Point(0, $th)))                        # 左翼外侧
+    # 逗号运算符:PointCollection 实现了 IEnumerable,直接 return 会被 PowerShell
+    # 展开成 Object[],导致赋值给 Polygon.Points 失败。
+    return , $pts
+}
+
+# 基准线指示带(仅编辑模式):一条横线 + 居中 ↑,紧贴在卡片"可见底边"正下方,
+# 用来告诉用户"通知以该位置为基准,自定义通知均在此线上方"。
+#
+# 几何约定(方案 A,务必与 New-EditSample 的边距算式保持一致):
+#   · 横线位于网格第 0 行,即带的顶边;↑ 叠放在同一格内(线画在箭头之上)。
+#   · 带高固定(常量 $script:ANCHOR_BAND_H):固定值而非 Auto,基准线到窗口底边
+#     的距离才可预测,回传的基准线位置才不会与实际画的线不一致。
+function New-AnchorBand([System.Windows.Media.Color]$accent, [string]$label, [double]$maxLabelWidth) {
+    $grid = New-Object System.Windows.Controls.Grid
+    $grid.Height = $script:ANCHOR_BAND_H
+    $grid.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Stretch
+    # 必须 Top:若用 Center/Stretch 居中,线会被推到格子中间,离卡片底边多出一段距离。
+    $grid.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+
+    # ① 横线:强调色实线 + 辉光,两端小圆点形成"标尺"感
+    $line = New-Object System.Windows.Controls.Grid
+    $line.Height = 2
+    $line.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+    $line.Background = New-Object System.Windows.Media.SolidColorBrush($accent)
+    $line.Effect = New-GlowEffect $accent 0.55
+    foreach ($side in @('Left', 'Right')) {
+        $dot = New-Object System.Windows.Shapes.Ellipse
+        $dot.Width = 6
+        $dot.Height = 6
+        $dot.Fill = New-Object System.Windows.Media.SolidColorBrush($accent)
+        # 竖直居中于 2px 线上,视觉上成为线段两端的端点。
+        # 注意:枚举成员不能用 ::$side 这种写法展开(PowerShell 会当成属性访问而报错),
+        # 必须显式分支赋值。
+        if ($side -eq 'Left') {
+            $dot.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Left
+        } else {
+            $dot.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Right
+        }
+        $dot.Margin = New-Object System.Windows.Thickness(0, -2, 0, -2)
+        $line.Children.Add($dot) | Out-Null
+    }
+    $grid.Children.Add($line) | Out-Null
+
+    # ② ↑ + 可选文字:叠放在线之下(同一格)。
+    #    三列等分(各 1*):中列 = ↑,天然落在整条带的正中点;右列 = 文字。
+    #    这样"文字不会把 ↑ 推偏",且文字过宽时由自身的 TextTrimming 处理。
+    $cap = New-Object System.Windows.Controls.Grid
+    $cap.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Stretch
+    $cap.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+    $cap.Margin = New-Object System.Windows.Thickness(0, 3, 0, 0)
+    foreach ($i in 1..3) {
+        $col = New-Object System.Windows.Controls.ColumnDefinition
+        $col.Width = New-Object System.Windows.GridLength(1, [System.Windows.GridUnitType]::Star)
+        $cap.ColumnDefinitions.Add($col) | Out-Null
+    }
+
+    $arrow = New-Object System.Windows.Shapes.Polygon
+    $arrow.Points = New-AnchorArrowPoints $script:ANCHOR_ARROW_W $script:ANCHOR_ARROW_H
+    $arrow.Fill = New-Object System.Windows.Media.SolidColorBrush($accent)
+    $arrow.Width = $script:ANCHOR_ARROW_W
+    $arrow.Height = $script:ANCHOR_ARROW_H
+    $arrow.Stretch = [System.Windows.Media.Stretch]::Fill
+    $arrow.Effect = New-GlowEffect $accent 0.45
+    # 顶点贴住横线,只留 $script:ANCHOR_ARROW_GAP 的呼吸量(矢量图形无字形死区)。
+    $arrow.Margin = New-Object System.Windows.Thickness(0, $script:ANCHOR_ARROW_GAP, 0, 0)
+    $arrow.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+    # 用一个撑满中列的容器来居中箭头:不依赖"列宽 = 箭头宽"这一巧合,
+    # 否则同列的文字一变宽,箭头就会被带偏。
+    $arrowBox = New-Object System.Windows.Controls.Border
+    $arrowBox.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Stretch
+    $arrowBox.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+    $arrowBox.Child = $arrow
+    [System.Windows.Controls.Grid]::SetColumn($arrowBox, 1)
+    $cap.Children.Add($arrowBox) | Out-Null
+
+    if (-not [string]::IsNullOrEmpty($label)) {
+        $txt = New-Object System.Windows.Controls.TextBlock
+        $txt.Text = $label
+        $txt.Foreground = New-Object System.Windows.Media.SolidColorBrush($accent)
+        $txt.FontFamily = New-Object System.Windows.Media.FontFamily("Segoe UI, Microsoft YaHei UI")
+        $txt.FontSize = 11
+        $txt.Opacity = 0.92
+        $txt.VerticalAlignment = [System.Windows.VerticalAlignment]::Top
+        $txt.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Left
+        $txt.Margin = New-Object System.Windows.Thickness(10, 1, 0, 0)
+        # 限宽 + 省略号:文案过长时按字符截断,不挤压 ↑、也不超出窗口。
+        $txt.TextTrimming = [System.Windows.TextTrimming]::CharacterEllipsis
+        $txt.MaxWidth = [Math]::Max(80, $maxLabelWidth)
+        [System.Windows.Controls.Grid]::SetColumn($txt, 2)
+        $cap.Children.Add($txt) | Out-Null
+    }
+
+    $grid.Children.Add($cap) | Out-Null
+    return $grid
+}
+
 # 编辑模式样板窗:拖拽移动 + 左右边缘圆点把手缩放;拖拽/缩放结束后回传 geometry。
-# 强调色描边 + 辉光;内嵌 5 类型实时色卡预览(chips);多语言提示。
+# 强调色描边 + 辉光;内嵌 5 类型实时色卡预览(chips);多语言提示;
+# 卡片下方带"基准线 + ↑"指示带(方案 A)。
 function New-EditSample($cmd) {
     $bg = Parse-Color ([string]$cmd.bg) "#203a5c"
     $fg = Parse-Color ([string]$cmd.fg) "#e8f0fb"
@@ -84,6 +230,25 @@ function New-EditSample($cmd) {
     $fgBrush = New-Object System.Windows.Media.SolidColorBrush($fg)
     $accentBrush = New-Object System.Windows.Media.SolidColorBrush($accent)
 
+    # ── 几何总纲(务必与手柄、带行的算式保持一致) ──
+    # $glowMargin 同时是:左右辉光呼吸量、卡片左/右/上边距、左右缩放把手的边距。
+    #   · 卡片:左/右边距相等 → 始终居中;卡宽 = 窗口宽 − 2×$glowMargin。
+    #   · 手柄:左右边距同样为 $glowMargin(宽 8px)→ 左右手柄"内沿"之间
+    #     = 窗口宽 − 2×$glowMargin = 卡宽,即手柄与卡片严格等宽、等左右沿。
+    #   · 下边距必须为 0:卡片因此一直铺到第 0 行的底边,而第 1 行(带行)紧随其后,
+    #     所以横线正好压在卡片可见底边上;卡片高度 = 行高 = 手柄高度。
+    #     若在这里留边距,卡片会在自己所在行内被顶上去,横线就会离开卡片底边。
+    #   · 底部呼吸量由带行自身(透明)提供,无需再留边距。
+    $glowMargin = 8
+    $bandHeight = [double]$script:ANCHOR_BAND_H
+    $bottomMargin = 0
+    # 基准线(卡片可见底边)到**窗口底边**的距离 = 卡片下边距 + 带高。
+    # 实测:带(含自身下边距)紧贴第 0 行底部,故卡片可见底边 = 窗口高 − 该值,
+    # 也就是横线自身的 Y。这是"从底部算"的量。
+    # 注意:真正用于定位/回传的是"从窗口顶边算"的 lineInWin(在 Loaded 里实测),
+    # 两者基准不同,不可混用 —— 混用会导致每次重开编辑模式基准线漂移一个带高。
+    $baselineFromBottom = $bottomMargin + $bandHeight
+
     $win = New-Object System.Windows.Window
     $win.WindowStyle = [System.Windows.WindowStyle]::None
     $win.AllowsTransparency = $true
@@ -99,7 +264,7 @@ function New-EditSample($cmd) {
     $border.BorderBrush = $accentBrush
     $border.BorderThickness = New-Object System.Windows.Thickness(1)
     $border.CornerRadius = New-Object System.Windows.CornerRadius(14)
-    $border.Margin = New-Object System.Windows.Thickness(12)
+    $border.Margin = New-Object System.Windows.Thickness($glowMargin, $glowMargin, $glowMargin, $bottomMargin)
 
     $root = New-Object System.Windows.Controls.StackPanel
     $root.Margin = New-Object System.Windows.Thickness(16, 14, 16, 14)
@@ -175,6 +340,8 @@ function New-EditSample($cmd) {
     $leftStrip.Cursor = [System.Windows.Input.Cursors]::SizeWE
     $leftStrip.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Left
     $leftStrip.VerticalAlignment = [System.Windows.VerticalAlignment]::Stretch
+    # 把手竖直范围 = 卡片可见上下沿(下边距用带高,故把手不会压到基准线指示带上)。
+    $leftStrip.Margin = New-Object System.Windows.Thickness(0, $glowMargin, 0, $bottomMargin)
     $leftStrip.Background = $edgeBrush
     $leftStrip.CornerRadius = New-Object System.Windows.CornerRadius(14, 0, 0, 14)
     $rightStrip = New-Object System.Windows.Controls.Border
@@ -182,6 +349,7 @@ function New-EditSample($cmd) {
     $rightStrip.Cursor = [System.Windows.Input.Cursors]::SizeWE
     $rightStrip.HorizontalAlignment = [System.Windows.HorizontalAlignment]::Right
     $rightStrip.VerticalAlignment = [System.Windows.VerticalAlignment]::Stretch
+    $rightStrip.Margin = New-Object System.Windows.Thickness(0, $glowMargin, 0, $bottomMargin)
     $rightStrip.Background = $edgeBrush
     $rightStrip.CornerRadius = New-Object System.Windows.CornerRadius(0, 14, 14, 0)
 
@@ -206,24 +374,62 @@ function New-EditSample($cmd) {
     Add-GripDots $leftStrip $fg
     Add-GripDots $rightStrip $fg
 
-    # 外层 Grid:边框 + 左右缩放把手叠放(把手覆盖窗口左右边缘)
+    # 外层 Grid:边框 + 基准线指示带 + 左右缩放把手叠放(把手覆盖窗口左右边缘)
     $outer = New-Object System.Windows.Controls.Grid
+    # 两条等分行:第 0 行卡片(占满剩余高度),第 1 行 = 基准线指示带。
+    $rowCard = New-Object System.Windows.Controls.RowDefinition
+    $rowCard.Height = New-Object System.Windows.GridLength(1, [System.Windows.GridUnitType]::Star)
+    $rowBand = New-Object System.Windows.Controls.RowDefinition
+    $rowBand.Height = [System.Windows.GridLength]::Auto
+    $outer.RowDefinitions.Add($rowCard) | Out-Null
+    $outer.RowDefinitions.Add($rowBand) | Out-Null
+
+    # 文案限宽:窗口宽度的一半多一点,过长按字符省略。
+    $band = New-AnchorBand $accent ([string]$cmd.anchorLabel) ([Math]::Max(80, $win.Width * 0.55))
+    [System.Windows.Controls.Grid]::SetRow($band, 1)
     $outer.Children.Add($border) | Out-Null
+    $outer.Children.Add($band) | Out-Null
     $outer.Children.Add($leftStrip) | Out-Null
     $outer.Children.Add($rightStrip) | Out-Null
 
     # 共享拖拽/缩放状态(事件回调看不到函数局部变量,放 Tag)
-    $win.Tag = @{ resizing = $false; startX = 0.0; startWidth = 0.0; startLeft = 0.0; edge = 'right' }
+    # lineInWin:基准线(卡片可见底边)从**窗口顶边**量起的 Y 偏移。
+    #   定位与回传都用它,保证"存下的坐标"与"重开时的落点"是同一个量。
+    $win.Tag = @{
+        resizing = $false
+        startX = 0.0
+        startWidth = 0.0
+        startLeft = 0.0
+        edge = 'right'
+        lineInWin = 0.0
+    }
 
     $win.Add_Loaded({
         $work = [System.Windows.SystemParameters]::WorkArea
         $pos = $cmd.position
+        # ── 基准线自测(消除"从顶部算/从底部算"的混用) ──
+        # 先把窗口顶边临时归零,等布局落定后量出基准线在窗口内的真实 Y(从窗口顶边算起)。
+        # 之后定位与 Send-Geometry 回传都用这同一个量,于是"存下的坐标"与"重开的落点"
+        # 必然一致,不会再出现每进一次编辑模式就漂移一截的问题。
+        $win.Top = 0
+        $win.UpdateLayout()
+        $lineInWin = $border.TranslatePoint(
+            (New-Object System.Windows.Point(0, $border.ActualHeight)), $win).Y
+        if ($lineInWin -le 0) {
+            # 兜底:布局尚未就绪时用"窗口高 − 从底部算的距离"估算。
+            $lineInWin = $win.ActualHeight - $bottomMargin - $bandHeight
+        }
+        $win.Tag.lineInWin = $lineInWin
         if ($null -ne $pos -and $null -ne $pos.left -and $null -ne $pos.top) {
             $win.Left = [double]$pos.left + $work.Left
-            $win.Top = [double]$pos.top + $work.Top
+            $win.Top = [double]$pos.top + $work.Top - $lineInWin
         } else {
-            $win.Left = $work.Right - $win.ActualWidth - 20
-            $win.Top = $work.Bottom - $win.ActualHeight - 20
+            # 编辑模式的样板窗贴住工作区右下角:窗口底边 = 工作区底边。
+            # (此处不加 20px 呼吸量 —— 用户明确要求样板窗能贴到屏幕最底部;
+            #  窗口底边即"基准线 + ↑"指示带所在行,基准线因此落在离屏幕底
+            #  一个带高的位置,通知向上堆叠时正好从屏幕底部往上排。)
+            $win.Left = $work.Right - $win.ActualWidth
+            $win.Top = $work.Bottom - $win.ActualHeight
         }
         Send-Geometry $win
     }.GetNewClosure()) | Out-Null
@@ -313,6 +519,222 @@ $downI = New-Object System.Windows.Media.SolidColorBrush([System.Windows.Media.C
 $hoverP = New-Object System.Windows.Media.SolidColorBrush([System.Windows.Media.Color]::FromRgb(196, 202, 208))
 $hoverI = New-Object System.Windows.Media.SolidColorBrush([System.Windows.Media.Color]::FromRgb(44, 52, 62))
 
+# 「返回应用」:把已在运行的 DeepSeek Harness 桌面窗口切到前台。
+#
+# 为什么不能靠 dsh://open:应用只在 macOS 的 `open-url` 事件里处理 `dsh://open`
+# (Windows 上协议 URL 是作为 argv 交给新进程的,而它的 `second-instance` 处理器
+# 不读 argv、也不校验 URL),所以那条路在 Windows 上是死代码。
+#
+# 因此改为直接枚举窗口并激活。合法性:用户点按钮的那一刻,前台窗口就是这个 WPF
+# 浮窗(属于本宿主进程),所以宿主调用 SetForegroundWindow 不会被
+# "只有前台进程才能抢占前台"的系统限制挡住。
+$script:ToastWin32Ready = $false
+try {
+    if (-not ('ToastWin32' -as [type])) {
+        Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+
+public class ToastWin32 {
+    public delegate bool EnumProc(IntPtr hWnd, IntPtr lParam);
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct RECT { public int Left, Top, Right, Bottom; }
+
+    [DllImport("user32.dll")] public static extern bool EnumWindows(EnumProc cb, IntPtr p);
+    [DllImport("user32.dll")] public static extern bool IsWindowVisible(IntPtr h);
+    [DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr h, out uint pid);
+    [DllImport("user32.dll", CharSet = CharSet.Unicode)] public static extern int GetWindowTextLength(IntPtr h);
+    [DllImport("user32.dll")] public static extern IntPtr GetShellWindow();
+    [DllImport("user32.dll")] public static extern IntPtr GetWindow(IntPtr h, uint cmd);
+    [DllImport("user32.dll")] public static extern bool GetWindowRect(IntPtr h, out RECT r);
+    [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr h, int cmd);
+    [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr h);
+    [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+    [DllImport("user32.dll")] public static extern bool AttachThreadInput(uint a, uint b, bool f);
+    [DllImport("user32.dll")] public static extern bool GetWindowPlacement(IntPtr h, ref WINDOWPLACEMENT wp);
+    [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr h);
+    [DllImport("user32.dll")] public static extern bool IsZoomed(IntPtr h);
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct POINT { public int X, Y; }
+
+    [StructLayout(LayoutKind.Sequential)]
+    public struct WINDOWPLACEMENT {
+        public int length;
+        public int flags;
+        public int showCmd;
+        public POINT ptMinPosition;
+        public POINT ptMaxPosition;
+        public RECT rcNormalPosition;
+    }
+
+    private const uint GW_OWNER = 4;
+    private const int SW_SHOWNORMAL = 1;
+    private const int SW_SHOWMINIMIZED = 2;
+    private const int SW_SHOWMAXIMIZED = 3;
+    private const int SW_SHOW = 5;
+    private const int SW_RESTORE = 9;
+    /// WPF_RESTORETOMAXIMIZED:最小化前是最大化状态
+    private const int WPF_RESTORETOMAXIMIZED = 0x0002;
+
+    /// 找出 pid 名下最可能是"主窗口"的顶层窗口。
+    ///
+    /// 实测要点(这台机器上枚举到 280 个窗口、其中 20 个可见):
+    /// 应用最小化到托盘 / 被隐藏时,它的主窗口会变成 **不可见**,甚至带上 owner
+    /// 关系。若像最初那样要求"可见 + 非 owner",这两条会把主窗口全部滤掉,
+    /// 结果就是"点了返回应用没反应"。因此这里分级挑选:
+    ///   1) 可见 + 有标题 + 非 owner(正常情况,最可靠)
+    ///   2) 有标题 + 非 owner(隐藏/托盘态)
+    ///   3) 有标题(连 owner 关系都能容忍)
+    /// 每级内部取面积最大者,Electron 的辅助窗口通常面积很小或没有标题。
+    public static IntPtr FindMainWindow(uint pid) {
+        IntPtr shell = GetShellWindow();
+        IntPtr[] best = new IntPtr[3];
+        long[] bestArea = new long[3] { -1, -1, -1 };
+        EnumWindows(delegate(IntPtr h, IntPtr p) {
+            uint wpid = 0;
+            GetWindowThreadProcessId(h, out wpid);
+            if (wpid != pid) return true;
+            if (h == shell) return true;
+            if (GetWindowTextLength(h) <= 0) return true;
+
+            bool visible = IsWindowVisible(h);
+            bool owned = GetWindow(h, GW_OWNER) != IntPtr.Zero;
+            RECT r;
+            if (!GetWindowRect(h, out r)) return true;
+            long area = (long)(r.Right - r.Left) * (long)(r.Bottom - r.Top);
+
+            int tier;
+            if (visible && !owned) tier = 0;
+            else if (!owned) tier = 1;
+            else tier = 2;
+
+            if (area > bestArea[tier]) { bestArea[tier] = area; best[tier] = h; }
+            return true;
+        }, IntPtr.Zero);
+
+        for (int i = 0; i < 3; i++) { if (best[i] != IntPtr.Zero) return best[i]; }
+        return IntPtr.Zero;
+    }
+
+    /// 把 hWnd 提到前台,并**保持窗口原有的尺寸/最大化状态**。
+    ///
+    /// 关键:`ShowWindow(h, SW_RESTORE)` 会把"最小化**或**最大化"的窗口还原成
+    /// 原始(默认)尺寸 —— 这正是"窗口本来最大化、只是不在最上层,点返回应用后
+    /// 变成默认大小"的原因。所以这里必须先查询显示状态:
+    ///   · 最小化 → SW_RESTORE(恢复原尺寸,若原先最大化会恢复成最大化)
+    ///   · 最大化 → SW_SHOWMAXIMIZED
+    ///   · 普通   → SW_SHOW(只显示/置顶,**不改尺寸**)
+    /// SetForegroundWindow 受"仅前台进程可抢占前台"限制,失败时按通行做法
+    /// 附加到当前前台线程的输入队列后重试一次。
+    public static bool Activate(IntPtr h) {
+        if (h == IntPtr.Zero) return false;
+
+        WINDOWPLACEMENT wp = new WINDOWPLACEMENT();
+        wp.length = Marshal.SizeOf(typeof(WINDOWPLACEMENT));
+        int show = SW_SHOW;
+        if (GetWindowPlacement(h, ref wp)) {
+            int cur = wp.showCmd;
+            if (cur == SW_SHOWMINIMIZED) {
+                show = (wp.flags & WPF_RESTORETOMAXIMIZED) != 0 ? SW_SHOWMAXIMIZED : SW_RESTORE;
+            } else if (cur == SW_SHOWMAXIMIZED) {
+                show = SW_SHOWMAXIMIZED;
+            }
+        }
+        ShowWindow(h, show);
+
+        if (SetForegroundWindow(h)) return true;
+        IntPtr fg = GetForegroundWindow();
+        uint dummy = 0;
+        uint tidFg = fg == IntPtr.Zero ? 0u : GetWindowThreadProcessId(fg, out dummy);
+        uint tidMe = GetWindowThreadProcessId(GetShellWindow(), out dummy);
+        if (tidFg != 0u && tidFg != tidMe) {
+            if (AttachThreadInput(tidMe, tidFg, true)) {
+                bool ok = SetForegroundWindow(h);
+                AttachThreadInput(tidMe, tidFg, false);
+                if (ok) return true;
+            }
+        }
+        return SetForegroundWindow(h);
+    }
+}
+'@ -ErrorAction Stop
+    }
+    $script:ToastWin32Ready = $true
+} catch {
+    # Win32 互操作不可用(极少见):activateLabel 会因此不下发,按钮不出现。
+    $script:ToastWin32Ready = $false
+}
+
+function Write-ActLog([string]$msg) {
+    # 诊断日志:激活这一步涉及"按 exe 路径找进程 + 枚举窗口"两处环境相关行为,
+    # 出问题时按钮只会静默无反应,没有日志无法定位。
+    # 落点优先级:脚本所在目录(真实宿主 = lib/)→ DSH_HOME。
+    try {
+        $line = "$(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')  $msg`r`n"
+        $enc = New-Object System.Text.UTF8Encoding($false)
+        $dirs = @()
+        if (-not [string]::IsNullOrEmpty($PSScriptRoot)) { $dirs += $PSScriptRoot }
+        if (-not [string]::IsNullOrEmpty($env:DSH_HOME)) { $dirs += $env:DSH_HOME }
+        foreach ($d in $dirs) {
+            try {
+                [System.IO.File]::AppendAllText((Join-Path $d 'activate-debug.log'), $line, $enc)
+                return
+            } catch { }
+        }
+    } catch { }
+}
+
+# 启动探针:宿主每次加载(含插件重载)都记一行门控状态。
+# 必须放在 Write-ActLog 定义之后,否则这个调用会因函数未定义而静默失效。
+try {
+    $probe = "boot: Win32Ready=$script:ToastWin32Ready"
+    try { $probe += " selfExe='$((Get-Process -Id $PID).Path)'" } catch { $probe += " selfExe=<取不到>" }
+    try { $probe += " DSH_HOME='$env:DSH_HOME'" } catch { }
+    try { $probe += " PSScriptRoot='$PSScriptRoot'" } catch { }
+    Write-ActLog $probe
+} catch { }
+
+function Invoke-ToastActivateApp([string]$appPath) {
+    try {
+        Write-ActLog "--- click ---"
+        Write-ActLog "Win32Ready=$script:ToastWin32Ready appPath='$appPath'"
+        if (-not $script:ToastWin32Ready) { Write-ActLog "中止: Win32 助手不可用"; return }
+        if ([string]::IsNullOrEmpty($appPath)) { Write-ActLog "中止: appPath 为空"; return }
+        $full = $null
+        try { $full = [System.IO.Path]::GetFullPath($appPath) } catch { Write-ActLog "中止: GetFullPath 失败"; return }
+        Write-ActLog "full='$full' exists=$(Test-Path -LiteralPath $full)"
+        if (-not (Test-Path -LiteralPath $full)) { Write-ActLog "中止: exe 路径不存在"; return }
+
+        # Electron 的主进程与各渲染进程都是同一个 exe,窗口可能挂在其中任意一个 PID 上,
+        # 所以把全部同 exe 的进程当作一组来挑窗口,而不是"谁先回答就用谁"。
+        $procs = @()
+        foreach ($p in (Get-Process -ErrorAction SilentlyContinue)) {
+            try { if ($p.Path -eq $full) { $procs += $p } } catch { }
+        }
+        Write-ActLog "按 exe 匹配=$($procs.Count) pids=$(($procs | ForEach-Object { $_.Id }) -join ',')"
+        if ($procs.Count -eq 0) {
+            # 兜底:按进程名匹配(某些情况下 Path 取不到)。
+            $nm = [System.IO.Path]::GetFileNameWithoutExtension($full)
+            $procs = @(Get-Process -Name $nm -ErrorAction SilentlyContinue)
+            Write-ActLog "按名 '$nm' 兜底=$($procs.Count) pids=$(($procs | ForEach-Object { $_.Id }) -join ',')"
+        }
+        foreach ($p in $procs) {
+            $h = [ToastWin32]::FindMainWindow([uint32]$p.Id)
+            Write-ActLog "  pid=$($p.Id) hwnd=$h"
+            if ($h -ne [IntPtr]::Zero) {
+                $ok = [ToastWin32]::Activate($h)
+                Write-ActLog "  Activate=$ok fg=$([ToastWin32]::GetForegroundWindow())"
+                if ($ok) { return }
+            }
+        }
+        Write-ActLog "结束: 未找到可激活窗口"
+    } catch {
+        Write-ActLog "异常: $($_.Exception.GetType().Name) :: $($_.Exception.Message)"
+    }
+}
+
 # 浮窗按钮:primary 时传入强调色画刷,hover/按压基于该色自动提亮/压暗;
 # secondary 保持描边透明底样式。
 function New-ToastButton([string]$label, [scriptblock]$onClick, [bool]$primary, [System.Windows.Media.SolidColorBrush]$fg, [System.Windows.Media.SolidColorBrush]$bg) {
@@ -500,6 +922,19 @@ function New-ToastWindow($cmd) {
     $ignoreLabel = if ([string]::IsNullOrEmpty([string]$cmd.ignoreLabel)) { "Ignore" } else { [string]$cmd.ignoreLabel }
     $ignoreBtn = New-ToastButton $ignoreLabel ({ Close-WithFade $win }.GetNewClosure()) $false $fgBrush $bgBrush
     $btnRow.Children.Add($ignoreBtn) | Out-Null
+    # 「返回应用」:位于「忽略」右侧;仅桌面端出现(由 index.js 按 isDesktopRuntime 下发
+    # activateLabel)。点击后把应用窗口切到前台,但**不**关闭本条通知。
+    # 另外要求 Win32 互操作可用(否则无法激活窗口,宁可不显示这个按钮)。
+    $activateLabel = [string]$cmd.activateLabel
+    $appPath = [string]$cmd.appPath
+    if ($script:ToastWin32Ready -and -not [string]::IsNullOrEmpty($activateLabel) -and
+        -not [string]::IsNullOrEmpty($appPath)) {
+        $activateBtn = New-ToastButton $activateLabel ({
+            Invoke-ToastActivateApp $appPath
+            # 按要求保留通知,不做 Close-WithFade。
+        }.GetNewClosure()) $false $fgBrush $bgBrush
+        $btnRow.Children.Add($activateBtn) | Out-Null
+    }
     # 缺省 true = 保留「跳转会话」;桌面端宿主会显式传 jumpEnabled=false 来隐藏它。
     $jumpEnabled = $true
     if ($cmd.PSObject.Properties.Name -contains 'jumpEnabled') { $jumpEnabled = [bool]$cmd.jumpEnabled }
@@ -555,12 +990,32 @@ function New-ToastWindow($cmd) {
     $win.Add_Loaded({
         $work = [System.Windows.SystemParameters]::WorkArea
         $pos =$cmd.position
+        # ── 底部锚定定位 ──
+        # 目标:本条通知"可见卡片底边"落在锚点上(卡片多高都只影响顶边)。
+        #
+        # 抬升量由布局实测得出,而不是靠写死的常量:
+        #   $border 就是那张可见卡片,先把窗口顶边临时放到 0,量出它相对窗口的下边缘
+        #   ($borderBottomInWin),于是
+        #       窗口顶边 = 锚点Y − $borderBottomInWin − offsetY
+        #   其中 offsetY = 该条之上已叠的高度(首条为 0)。
+        # 先前用固定常量推算,卡片高度随内容变化时底边会偏离锚点(实测可差 12px 以上),
+        # 所以这里改成"用布局真实值",与卡片高度彻底解耦。
+        # 另:也不能写成 "$pos.top − offsetY"(那是把 pos.top 当窗口顶边的顶边锚定)。
+        $win.Top = 0
+        $win.UpdateLayout()
+        $borderBottomInWin = $border.TranslatePoint(
+            (New-Object System.Windows.Point(0, $border.ActualHeight)), $win).Y
+        if ($borderBottomInWin -le 0) {
+            # 兜底:布局尚未就绪时退回到"窗口高 − 常量"的估算。
+            $borderBottomInWin = $win.ActualHeight - $script:TOAST_BOTTOM_GAP
+        }
         if ($null -ne$pos -and $null -ne$pos.left -and $null -ne$pos.top) {
             $targetLeft = [double]$pos.left + $work.Left
-            $targetTop = [double]$pos.top + $work.Top - [int]$cmd.offsetY
+            $targetTop = [double]$pos.top + $work.Top - $borderBottomInWin - [int]$cmd.offsetY
         } else {
+            # 默认右下:可见卡片底边距工作区底边 20px(与 index.js 的 TOAST_EDGE_PAD 一致)。
             $targetLeft =$work.Right - $win.ActualWidth - 20
-            $targetTop =$work.Bottom - $win.ActualHeight - 20 - [int]$cmd.offsetY
+            $targetTop =$work.Bottom - 20 - $borderBottomInWin - [int]$cmd.offsetY
         }
         $win.Left =$targetLeft
         $win.Top =$targetTop + 36

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "dsh-notify-yimit",
-	"version": "0.2.0",
+	"version": "0.2.2",
 	"description": "DeepSeek Harness 通知插件:任务完成 / 任务出错 / 运行中(实时活动)/ 等待审批 / 等待回答 时,通过 Windows 系统通知或插件自定义样式通知提醒用户,支持点击跳转到对应会话;设置页集成在 DSH 设置界面。",
 	"type": "module",
 	"main": "lib/index.js",